Encyclopedia Upgrade Paths – V3.X To V4.X (System Architect Version Constant, Upgraded ArchiMate (V3.X – V4.X))

IMPORTANT: If upgrading to Corso ArchiMate Plug-in v4.x you will need to be using Rational System Architect v11.4.3 or later
1. Open Rational System Architect
2. Open the encyclopedia

3. When the encyclopedia opens a dialog will be presented telling you that the version of ArchiMate installed is different to the version that the encyclopedia is configured for – Just a notification/suggestion that you should run the Configure option at some point

4. Go to Tools > Encyclopedia File Manager

5. Use the Export option and export a copy f the USRPROPS.TXT to an accessible location

6. Once the export is successful, delete the USRPROPS.txt file from the encyclopedia before upgrade
7. As we have installed a new ArchiMate version, we will need to re-configure the metamodel of the encyclopedia for the new ArchiMate configuration files to be applied
8. Go to Tools > ArchiMate > Configure Encyclopedia for ArchiMate

9. Select Yes

10. Select Yes
11. The encyclopedia will re-open

Important: Selecting Yes to this action in v4 of the plug-in will remove all of the wizard relations that apply to the method wizard and replace them with new versions that match the new metamodel
- Before completing this task, we suggest using the XML export feature to create a copy of any user created wizard relations that can be added back in after the upgrade and then updated by users to match the new metamodel where needed
12. Select Yes, this will import the definitions needed for the Method Wizard

– This can take a few minutes (this will depend on the size of the encyclopedia)
If you are using a workspaced encyclopedia, then you will be presented with an import option (as above)
13. Choose the option that suits your usage
Note: If you select No, then the import task needs to be performed the first time each of the other non-baselined workspaces are opened after upgrade

14. If the encyclopedia has Roadmapping enabled, you will also be asked to import the Roadmapping definitions, select Yes

If you are using a workspaced encyclopedia, then you will be presented with an import option (as above)
15. Choose the option that suits your usage
Note: If you select No, then the import task needs to be performed the first time each of the other non-baselined workspaces are opened after upgrade
16. You should then re-import your USRPROPS.txt file and re-open the encyclopedia
Once the encyclopedia has been upgraded to version 4 there is a transfer of relationships to the v4 metamodel

Please see the 'Migration after Encyclopedia Upgrade' section and 'Transferring Relationships' here.