4.3 Performing the Upgrade

Before performing any upgrades, consult the Release Notes for any technical considerations. To upgrade to version 5.7, you must be running version 5.6 with the 5.6 June 2016 Post Patch Bundle Release.

Perform the following steps to upgrade:

  1. Shut down the Operations Center server and the Dashboard.

  2. Install the Post Patch Bundle for the Operations Center server and the Dashboard.

  3. Complete the following steps to upgrade the Dashboard security model to security model 6:

    1. Back up the Dashboard database.

    2. Start the Dashboard and log in as the default administrator.

    3. Migrate the Dashboard database to an Oracle or SQL Server database. For more information about migrating the database, see Upgrading from the Dashboard Embedded Database to Oracle or SQL Server in the Operations Center Dashboard Guide.

    4. Verify that portal-ext.custom.properties (located at Dashboard_installation_path//server/webapps/ROOT/WEB-INF/classes) contains permissions.user.check.algorithm=6.

  4. Continue with Section 2.0, Operations Center Server Installation.

  5. Clean up the upgraded installation directory by removing the following files without causing harm to the system:

    • Client, Server, Experience Manager, and Event Manager (Eve) patch directories are renamed and retained upon upgrade.

      You can delete any of these renamed directories without affecting anything other than the ability to rollback to a prior version of Operations Center.

    • Files in the /database/notconverted directory.

      This directory exists after you start the Operations Center server the first time. Review these files before deleting them to ensure that everything that should have been converted during upgrade was converted cleanly.

  6. Manually edit the hierarchy XML files for existing Data Integrator adapter definitions or other adapters to point to the NetIQ DTD web site at http://www.netiq.com/dtds/hierarchy_2.0.dtd.

    • XML files for Data Integrator definitions are located in /OperationsCenter_installation_path/bdi/adapter_name/data/adapter_nameHierarchy.xml.

    • XML files for adapter definitions are located in /OperationsCenter_installation_path/database/examples. To verify the XML file used for an adapter, check the adapter’s property settings.

  7. (Optional) You may want to disable the Java version check on console launch. This will turn off the warning message to users that the version has changed. For instructions, see Section 3.3, Disabling Java Version Warnings on Console Launch.