Can the "upgrade prompt" be suppressed in IBM Rational System Architect (SA)?
You are opening an encyclopedia in a new version of SA but do not wish to upgrade the encyclopedia at this time and for subsequent attempts you do not want to have to answer the "upgrade prompt" again.
- For SA version 126.96.36.199 and older, the "upgrade prompt" is similar to the following:
The encyclopedia property file is configured for an earlier version of System Architect. Upgrading this encyclopedia with the latest properties file will affect all users who access it. Do you want to upgrade the Local Server <SERVER NAME> encyclopedia with the latest property file?
- For SA version 188.8.131.52 the "upgrade prompt" is the following:
The encyclopedia schema is configured for an earlier version of System Architect. In Order to open this encyclopedia with System Architect 184.108.40.206 the schema must be upgraded. Once the schema is upgraded user will only be able to access the encyclopedia with System Architect 220.127.116.11. Earlier versions of System Architect will not be able to access this encyclopedia.
Note that appropriate database rights are required to upgrade the encyclopedia schema. If you do not have the appropriate rights then the schema upgrade will fail, the upgrade process will be cancelled, and you will not be able to open this encyclopedia with System Architect 18.104.22.168
Click Yes to upgrade the encyclopedia schema to version 22.214.171.124. Click No if you do not want to upgrade the encyclopedia at this time.
The "upgrade prompt" cannot be suppressed in SA. When you open an encyclopedia in a later version, it is upgraded automatically, hence preventing it from opening in the previous version. The following explains the encyclopedia upgrade prompt sequences and how you have the opportunity to avoid opening the encyclopedia in the later version so the upgrade stops and it would still be able to open in the previous version.
For SA version 126.96.36.199 and older, if press "Yes" or "No" on the "upgrade prompt" the encyclopedia is opened and upgraded automatically. Subsequent attempts to open the encyclopedia in an older version will fail with a message similar to the following example in SA version 11.4.0:
The selected encyclopedia is 11.4.22069 Professional Version and cannot be opened in this version of SA.
or, for example SA version 188.8.131.52 versus SA version 184.108.40.206 (also read the notes at the end of the Answer):
The selected encyclopedia has been upgraded to System Architect version 220.127.116.11042 Enterprise but you are currently using System Architect version 11.4.33060. You must either upgrade the version of System Architect or contact support for further assistance.
For SA version 18.104.22.168 and later (including 11.4.3.x), If you press "Yes" on the upgrade prompt (as seen in the cause section), you will get the following message:
The default encyclopedia meta model is configured for an earlier version of System Architect. It is highly recommend that you upgrade the default meta model at this time. Not upgrading the default meta model may prevent new features from being available to all users of this encyclopedia.
Any custom extensions that you have made to the default met model will be left as is.
Click Yes to open the encyclopedia and upgrade the default meta model to the latest version. Click No to open the encyclopedia and continue to use the previous default meta model.
If you press Yes to this, the encyclopedia will be upgraded automatically and use the new meta model applied. It will open in the new version. Subsequent attempts to open the encyclopedia in an older version will fail with a message similar to either of the two, depending on version, described at the start of the Answer.
If you press No to this, the encyclopedia will will be upgraded automatically but use the old meta model. It will open in the new version but you may get additional warnings and error message. Subsequent attempts to open the encyclopedia in an older version will fail with a message similar to either of the two, depending on version, described at the start of the Answer.
If you press "No" on the "upgrade prompt" (as seen in the cause section) you will be presented with the following message:
The selected encyclopedia could not be opened because inconsistencies were found in the structure of the database.
If you press OK the encyclopedia will not open because it has given you a chance to stop the upgrade and the encyclopedia can be opened in an older version of SA.
- The enhanced text in the upgrade prompt messages in SA version 22.214.171.124 and later was in response to RFE 8986
- There is no encyclopedia downgrade tool
- You are recommended to make a backup of the encyclopedia before you upgrade in case you need to open the Encyclopedia again in the older version or you make any other modifications described later in the following points.
For information on how to make a backup of the encyclopedia please follow the instructions in the IBM Knowledge Center for Rational System Architect:
SA 11.4.2 Backup Database
SA 11.4.3 Backup Database
Similarly, to restore the old encyclopedia please follow the instructions in the IBM Knowledge Center:
SA 11.4.2 Restore from file
SA 11.4.3 Restore from file
If you must extract data from any SA version (and Encyclopedia version) and import into a different SA version (and Encyclopedia version) there are export and import methods in SA. Unfortunately, the results between versions are not guaranteed in either direction (from later to previous, or previous to latest). For instructions please see the IBM Knowledge Center for Rational System Architect:
SA 11.4.2 Importing and Exporting Information
SA 11.4.3 Importing and Exporting Information
After you update data, then if desired you can also search for updates as per the information in the rest of this point.
If you have used the Encyclopedia in the newer version already (for example you have modified Diagrams or Definitions). Then in SA, you can use on the tool-bar the Advanced Search button to find them that were updated since a certain date. Or, similarly, on the tool-bar, simply enter one or other of the following example queries into the Search field as suits you needs (the examples find updates made after 17th July 2015):
Class = Diagram, "Update Date" > 2150717
Class = Definition, "Update Date" > 2150717
Or, as mentioned, for the Advanced Search window, use the following procedure (and repeat if necessary, because a new window will open with the list of items you would have selected here in step 1), after which, you use it by whatever means of you choice, to know a set to work through:
1. Select either Diagrams or Definitions
2. Ensure that All types is selected (ticked)
3. Drop down Property
4. Select UpdateDate
5. Select the Comparison greater than sign >
6. Enter in Value (for example for the date 17th July 2015) 20150717
7. Press OK
Similarly, you could also add more fields to the above search or use the report generator (from the SA menu bar: Reports > Report Generator [then for example, use from it's menu bar: File > New Report File ]). Additionally, this can be used to directly output to files for you to use as per your desire. More information can be found in the IBM Knowledge Center for Rational System Architect:
11.4.2 Learn how to generate reports for the product
11.4.3 Learn how to generate reports for the product
Another way to find what Diagrams or Definitions have been modified by you, is the Entity_History table in SA or SAEM queries. More information can be found in these documents:
11.4.2 Searching Object Histories
11.4.3 Searching Object Histories
11.4.2 SAEM for SQL Query
11.4.2 SAEM for Oracle Query
11.4.3 SQL SAEM Query
How to run history queries in Encyclopedia Manager for Rational System Architect
Possible values for activity column in the Entity_History table
Example query in SAEM with the Encyclopedia selected:
select * from Entity where "UpdateDate" > '20150717'
or, in case Entity History is not enabled, you can look at more details on the records with the following example Query in SAEM with the Encyclopedia selected:
select * from Entity where "UpdateDate" > '20150717'
It is beyond the normal scope of Support to explain these SA database fields, or how to use SQL commands (queries), or how Microsoft SQL Server works, or how Oracle database Server works. IBM do not recommend you directly attempt to modify the Encyclopedia with SQL statements in SAEM or any other tool. However, if you want to learn more about SQL syntax, refer to the W3 Schools document: SQL Tutorial.
- For all versions of SA, the same answer applies to both Enterprise and Professional Encyclopedia
(Cataloged encyclopedias are identified as the type Enterprise ; non-cataloged as Professional as described in the Product Documentation)
- You are recommended to use the same version of SA for everyone in your company
- More information on the need to upgrade is in the IBM Knowledge Center for Rational System Architect:
SA 11.4.2 Upgrading and migrating>Converting encyclopedias to current version>Encyclopedia conversion overview
SA 11.4.3 Upgrading and migrating>Converting encyclopedias to current version>Encyclopedia conversion overview
- If you need further assistance please contact IBM Rational Technical Support
- If you wish to suggest an improvement to SA then please submit a Request for Enhancement (RFE) on the community