How to Upgrade OpenPlant Modeler Schemas From Old Version to Latest Version


Applies To 
Product(s):OpenPlant Project Administrator
Version(s):08.11.11.87 (SS6) | 08.11.11.225 (SS6 Refresh)
Environment: Windows 7/8.1/10 (64 bit)
Area: OpenPlant Modeler Workspace
Subarea: Schema Upgrade
Original Author:Harpreet Singh, Bentley Product Advantage Group

Background

When users upgrade their OpenPlant versions then workspace and schema upgrades are required. With earlier versions this task was done manually through schema differencing tool in class editor. But with Schema Upgrade tool provided with OpenPlant Project Administrator (SS6), it is just a matter of few minutes and the whole process is automatic. It compares all the schemas and upgrades them to latest version.
In this example, we will upgrade a project in OpenPlant Modeler workspace from 08.11.09.568 version to the latest version 08.11.11.87 or higher.

Before you begin

Steps to Upgrade Schemas from Old Workspace to 08.11.11.87 (SS6)

For Local Project

  1. Launch OpenPlant Project Administrator.   
     

  2. Select OPM_Metric project from Workspace-568.

  3. On the Projects tab click Schema Upgrade icon in tool bar.

  4. Select the base version of your workspace in the next dialog.



    Note: In case you are using any priority build, pick the closest build (like for 08.11.09.447 base version should be 08.11.09.440 and for 08.11.09.581 select base version 08.11.09.564)

  5. Click ‘Process Schema’ button to proceed further.

  6. If there are any changes in the schema, below message will appear. Click OK.

  7. After clicking OK, you will be directed to Summary tab. Review the errors, if any, and resolve them before switching to User Configurations tab.

  8. Switch to User Configurations tab to see all the changes. By default all the changes are selected but you can de-select the changes that you don’t need to add in the upgraded schemas.



    In this dialog,

     Symbol denotes that a property, class or relationship has been added by user.

      Symbol denotes that property, class or relationship has been modified by user.

      Symbol denotes that property, class or relationship has been deleted by user.

  9. Switch to New Changes tab to see all the changes made to the default schemas.
     
    Note: This may take several minutes depending on the number of changes. However, this is an optional step. If you don’t wish to see the changes you can proceed to upgrade.

  10. Click Upgrade to start the process of schema upgrade to merge all the changes into new schemas.

  11. Once schemas are upgraded, below message will appear on the screen. Click OK and restart OpenPlant Project Administrator.



    After successful upgrade of schema files a log file is generated inside C:\ProgramData\Bentley\OpenPlantModeler V8i\WorkSpace-568\Projects\OPM_Metric\Dataset\schemas named as SchemaUpgrade.log.

  12. Navigate to the project folder and you will see that it creates a new folder ‘Upgraded_Schemas’ inside dataset folder which has the upgraded schemas.



    Location of the schema folders in PCF file is automatically updated with this information as shown below.




Additional Changes Required:

  1. Open the project PCF file and update the versions of schemas. Press Ctrl + H and replace 01.06 with 01.07.



  2. Add two schemas in the OPIM_SCHEMA_LIST as highlighted below.



For Managed Project

  1. Add your managed workspace in OpenPlant Project Administrator.



  2. Switch to Projects tab and add your project.



  3. Once the project is added, proceed with schema upgrade option by following the steps 3 to 12 as mentioned above.

    You will need to update configuration variable, as the changes mentioned above in additional changes section, in you project CSB in ProjectWise Administrator.

NOTE: This process only upgrades the schema files. Other changes in the workspace like isometric styles, PCF, Configuration files will have to be done manually like before.

Steps to Upgrade Schemas from Old Workspace to 08.11.11.225 (SS6 Refresh)

For Local Project

  1. Launch OpenPlant Project Administrator.



  2. Select OPM_Environment_568 project from Workspace_568.



  3. On the Projects tab click Schema Upgrade icon in tool bar.



  4. Select the base version of your workspace in the next dialog.



    Note: In case you are using any priority build, pick the closest build (like for 08.11.09.568 base version should be 08.11.09.564 and for 08.11.11.96 select base version 08.11.11.87)

  5. Click ‘Process Schemas for upgrade’ button to proceed further.



  6. If there are any changes in the schema, below message will appear. Click OK.



  7. After clicking OK, you will be directed to Summary tab. Review the errors, if any, and resolve them before switching to User Configurations tab.



  8. Switch to User Configurations tab to see all the changes. By default all the changes are selected but you can de-select the changes that you don’t need to add in the upgraded schemas.



    In this dialog,

     Symbol denotes that a property, class or relationship has been added by user.

      Symbol denotes that property, class or relationship has been modified by user.

      Symbol denotes that property, class or relationship has been deleted by user.

  9. Switch to New Changes tab to see all the changes made to the default schemas.

    Note: This may take several minutes depending on the number of changes. However, this is an optional step. If you don’t wish to see the changes you can proceed to upgrade.

  10. Click Upgrade to start the process of schema upgrade to merge all the changes into new schemas.

  11. Once schemas are upgraded, below message will appear on the screen. Click OK and restart OpenPlant Project Administrator.



    Note: This dialog does not come up for each case. It comes up only when there are some user changes that pose some issues. In all other cases the dialog saying schema successfully upgraded appears.

  12. After clicking OK, close the upgrade dialog and below message will appear. Close OPPA and launch again.

For Managed Project

  1. Add your managed workspace in OpenPlant Project Administrator.



  2. Switch to Projects tab and add your project.



  3. Once the project is added, proceed with schema upgrade option by following the steps 3 to 12 as mentioned above.

    You will need to update configuration variable, as the changes mentioned above in additional changes section, in you project CSB in ProjectWise Administrator.

  4. For managed workspace, original schemas are backed up in a different folder as shown below.

NOTE: This process only upgrades the schema files. Other changes in the workspace like isometric styles, PCF, Configuration files will have to be done manually like before.

Comments or Corrections?

Bentley's Product Advantage Group requests that you please confine any comments you have on this Wiki entry to this "Comments or Corrections?" section. THANK YOU!