Upgrading SPO Operating Plant - SmartPlant Enterprise for Owner Operators - Installation & Upgrade - Hexagon PPM

SPO Operating Plant Installation and Configuration

Language
English
Product
SmartPlant Enterprise for Owner Operators
Subproduct
SPOOP
Search by Category
Installation & Upgrade
SmartPlant Foundation / SDx Version
10

The tasks in this section must be performed before you begin your upgrade process from previous versions to SPO OP 2019 Update 5.

  • We recommend that you back up the following prior to upgrade:

    • SPO_SCHEMA.cfg

    • Document Generator

      For more information about its location, see Document Generator.

    • List of files specified in the SPO_SCHEMA.cfg.

  • You must manually add the upgrade instructions available at <Installationdirectory>:\Program Files (x86)\SmartPlant\SPX\OP\STs\Operating Plant\SPOUpgrade\Operating Plant\Upgrade to the server manager upgrade instructions available at <Installationdirectory>:\Program Files (x86)\SmartPlant\Foundation\SPFServerManager\Upgrade.

    While upgrading, ensure that the Ready to Upgrade page displays the applicable upgrade instructions of the software. The upgrade is successful only when the applicable software upgrade instructions are processed.

  • You must include the file contents of UpgradeControl.xml file available at <Installationdirectory>:\Program Files (x86)\SmartPlant\SPX\Operating Plant\STs\SPO Operating Plant\SPOUpgrade\Operating Plant to the UpgradeControl.xml file available at <Installationdirectory>:\Program Files (x86)\SmartPlant\Foundation\SPFServerManager\UpgradeControls.xml.

    Make sure the UpgradeControl.xml and upgrade instructions available in the server manager are the latest files delivered with the software each time you try to upgrade the operating plant site.

  • When SmartPlant Foundation is uninstalled, you must manually cleanup the previously updated upgrade instructions.

  • SPO Operating Plant upgrade is only supported from version 2.2 onwards. Contact the SPO Operating Plant support team to upgrade from older versions of SPO Operating Plant.

  • If you are upgrading from SPO 2.4.2 to SPO 2.4.3/2.4.4/3.0, then you must install the SPF4.4.2 HF4 hotfix prior to upgrading SPO Operating Plant. For more information, please contact your Hexagon PPM account representative or browse to the Smart Support website.

  • Upgrade instructions are not available for SPO Operating Plant to upgrade from 5.0 to 5.1, since there are no schema/configuration changes.

The SmartPlant Foundation Server Manager Upgrade Wizard allows you to upgrade the database. You can also create a backup of the database before the upgrade begins.

  • The Upgrade Wizard compiles a list of available upgrade paths based on the version of SmartPlant Foundation and SPO Operating Plant that is consistent with the data in the selected site. When you start the Upgrade Wizard, the software reads a control file that defines the available upgrades. The control file, UpgradeControls.xml, and Upgrade folder are delivered to the SPFServerManager subfolder of the product installation folder. For example, [drive]:\Program Files (x86)\SmartPlant\Foundation\SPFServerManager\SPOUpgrade\Operating Plant.

  1. In Server Manager, right-click a site and click Tools > Upgrade Wizard from the quick menu.

  2. In the Upgrade Path window, select your upgrade path from the list of available upgrades and click Next.

  3. In the Upgrade Options window, select the actions you would like the Upgrade Wizard to perform and click Next.

    • To upgrade and transform your data, click Upgrade data in the database.

    • To back up your database, click Backup database before upgrade and enter or browse to the location where you want the backup files to be saved.

  4. In the Ready to Upgrade window, review the scripts that the Upgrade Wizard is preparing to execute and click Next to begin the upgrade.

    • If the wizard runs a procedural SQL script (PL/SQL for Oracle or T-SQL for SQL Server), the tracing output for the script is saved to the Server Manager temp directory under the default root path in a separate log file, UpgradeWizardPLSQLOutput.log or UpgradeWizardTSQLOutput.log, depending on the type of script that was run. The script results are also written to the main log file, UpgradeWizardlog.xml.

    • Critical errors cause the upgrade to stop. Click Back to make changes to your upgrade selections.

    • Non-critical errors are logged, but the upgrade continues.

  5. In the Upgrade Results window, click Finish to view the log file.

    Server Manager logs every action it performs in a log file called UpgradeWizardlog[date]-[time].xml saved in the temp directory under the default root path (for example, C:\SmartPlant Foundation Server Files\Temp\ServerManager).