Applies To
Product(s):	OpenPlant Project Administrator
Version(s):	08.11.11.43 (SS6) | 08.11.11.223 (SS6 Refresh)
Environment:	Windows 7/8.1/10 (64 bit)
Area:	OpenPlant PID 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 PID workspace from 08.11.10.631 version to the latest version 08.11.11.223.

Before you begin

• Rename your workspace from old version.
  
  
• Install the latest versions of OpenPlant PID & OpenPlant Project Administrator.
  
  
• Add your workspace from old version into OpenPlant Project Administrator SS6/SS6R.
  
  

 Steps to Accomplish

For Local Project

1. Launch OpenPlant Project Administrator.
   
   
   
   
2. Select OPPID_Metric project from OpenPlant PID (SS5) Workspace.
   
   
   
   
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.10.641 base version should be 08.11.10.631 and for 08.11.11.55 select base version 08.11.11.43)
   
   
5. Click ‘Process Schemas for upgrade’ button to proceed further.
   
   
   
   
6. Below dialog will appear to locate missing reference schema. Select OpenPlant.01.06 schema. This is generally located in C:\ProgramData\Bentley\OpenPlantPID (SS5)\WorkSpace\OPPID\Schemas folder.
   
   
   
   
7. Same dialog will appear for locating the other referenced schema files.
   
   
   
   This dialog will repeat for couple of times for different schemas. Locate the missing schemas every time the dialog shows up for successful upgrade.
   
   
8. Once all the schemas are located and loaded, below message will appear. Click OK.
   
   
   
   
9. After clicking OK, you will be directed to Summary tab. Review the errors, if any, and resolve them before switching to User Configurations tab.
   
   
   
   
10. 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.
    
    
11. 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.
    
    
12. Click Upgrade to start the process of schema upgrade to merge all the changes into new schemas.
    
    
    
    
13. Once schemas are upgraded, below message will appear on the screen.
    
    
    
    Click OK and restart OpenPlant Project Administrator.
    
    
    
    
    
14. Navigate to the project folder and you will see that new schemas (01.07) have replaced the old schemas (01.06).
    
    

Additional Changes Required

1. Open the project PCF file, update Workspace OPPID schemas path and the versions of schemas.
2. Press Ctrl + H and replace OPPowerPID with OPPID
   
   
   
   
3. Press Ctrl + H and replace 01.06 with 01.07.
   
   
   
   
4. Mapping schema PlantProjectSchema.01.0x_Autoplant_PIW.01.0x.mapping.xml is not updated by schema upgrade tool and hence old version PlantProjectSchema.01.06_Autoplant_PIW.01.06.mapping.xml is left as is and default PlantProjectSchema.01.07_Autoplant_PIW.01.07.mapping.xml is added to the folder. You will need to update this schema manually by referring to the freeze memo document.
   
   
   
   
5. Upgrade these schemas (as highlighted in below picture) manually if you have made any changes to these schemas.
   
   

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.

See Also

communities.bentley.com/.../28270.how-to-upgrade-openplant-modeler-schemas-from-old-version-to-latest-version-using-schema-upgrade-tool

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!