3.2 Local -> 3.3 Local

Follow the steps below to migrate your SysML model from Syndeia 3.2 to Syndeia 3.3. Do not install Syndeia 3.3 until specified in this process. 

1. Create a backup copy of the following 2 files before you start this process.

1. SysML model that you will be migrating
2. repos.info file in the .syndeia folder in your home directory, e.g. C:\Users\Username\.syndeia\repos.info on Windows or /Users/Username/.syndeia/repos.info on Mac OS X.

If you make a mistake during this process, you will be able to copy the backup files and start this process again. 

2. Open the MagicDraw SysML model that was used/created with Syndeia 3.2, and launch the Syndeia Dashboard. Go to the Connection Search tab and press the Get All button. Note the number of connections. In this case, we will be demonstrating the migration process on a model with 140 connections. After migration to Syndeia 3.3, you will need to verify the number of connections.

3. Close the Syndeia Dashboard, SysML model, and the MagicDraw application.

4. Follow the installation instructions here to install Syndeia 3.3 plugin for MagicDraw. Note that you will need a new license file for Syndeia 3.3. 

5. After installation, start MagicDraw, right-click on any element in the Containment tree and select Syndeia → Settings. Do not launch the Dashboard yet.

6. Check that the setting Select primary store is set to SYSML_MODEL as shown below. If not, change to SYSML_MODEL and click on the Apply button. Close the Settings window.

7. Right-click on the top-level model element in your model and select Syndeia → Dashboard. This will launch the Syndeia Dashboard. During the launch process, your repositories will be upgraded from Syndeia 3.2 to Syndeia 3.3 format. During this repository upgrade process, only repositories with unique host addresses will be retained. For example, if you had two GitHub repositories GitHub 1 and GitHub 2 with the same host URL, then only one of them will be retained and show up in the Repository Manager when the Dashboard launches, as shown below. The other one will be marked as a duplicate. 

8. Go to the Connection Search tab in the Syndeia Dashboard and click on the Get All button. You will see 0 connections. This is because the connections saved in the SysML model have not yet been upgraded from Syndeia 3.2 to Syndeia 3.3 yet. We will do that in the next step.

9. Go to the Repository Manager tab and click on each repository to connect. Provide your credentials during the connection process as shown below. You will need to connect to each repository before you can upgrade connections. Syndeia needs to reach out to the repositories to gather additional data for the sources and targets of the connections before they are upgraded.

8/ Upgrade to 3.3

Select to Upgrade Connections

5/ You will see upgrade of repositories and connections

6/ 

3/ 

Close Dashboard, save MD project, close, reopen, and check num connections, should see the same as above.

Users can upgrade Syndeia data created using Syndeia 3.1 to work with Syndeia 3.2. This Syndeia data primarily includes connections stored in SysML model and repositories stored in .syndeia folder. Follow the steps below to upgrade your models from Syndeia 3.1 to Syndeia 3.2.

(1) Open SysML project.

(2) Right click on any SysML element in the model tree and select Syndeia → Settings. Check that "Select primary store" is set to SYSML_MODEL.

(3) Launch Syndeia Dashboard - Right click on any SysML element in the model tree and select Syndeia → Dashboard. In the log window of the Syndeia Dashboard, you will see some stats. Syndeia will detect that the connections stored in the SysML model and repositories in the .syndeia folder are in an older format, and it will automatically upgrade connections to the 3.2 format. In this example, 173 connections were upgraded.

(4) Click on every repository listed in the Repository Manager to check that you can connect to it.

(5) Syndeia 3.2 needs more information from the connected models and repositories compared to Syndeia 3.1. Although all Syndeia information was upgraded to Syndeia 3.2 format (syntactic upgrade) in the previous step, we still to enrich that information. Right click on any element in the SysML model tree and select Syndeia → Utils → Upgrade Utils → Upgrade to 3.2, as shown below, to start the enrichment process..

(6) A new status dialog will pop up and show the running log as each connection is upgraded after fetching additional data from the connected models. After the process is over, you will see a summary of the upgrade in the Syndeia Dashboard, as shown below. The summary will show you the following stats:

• Total number of connections
• Number of connections that are upgraded, including connections that were already upgraded and those upgraded in this round
• Number of connections that could not be upgraded

If the source / target end of the connection is missing, then the connection cannot be upgraded. For example, in the above scenario, 1 connection could not be upgraded because the target end of the connection is a local folder which is not available at the specified location. If that folder is made available at the specified location and the upgrade process is run again (next round), then the connection can be fully upgraded.