The following sections cover information about software patches as well as upgrading the Dashboard.
Operations Center sends software updates for the Dashboard in patch bundles, which must be installed on the Dashboard server. Before installing a patch, read all correspondence sent along with the patch, including a Readme file or e‑mail.
Patch files use the naming convention nnn‑yyyy-mm-ddCRiiiiii‑Rxxxxx-META-DASH.jar. Table 12-1 describes the components of the patch file name.
Table 12-1 Naming Conventions
|
Patch File Name Component |
Definition |
|---|---|
|
nnn |
Software version number (such as 500 for version 5.0.0). |
|
yyyy |
Current year. |
|
mm |
Current month (such as 03 for March). |
|
dd |
Current day (such as 01, 02, 03). |
|
iiiiii |
Issue number |
|
xxxxx |
Release number |
|
META |
If present, indicates the patch contains all interdependent patches. |
|
DASH |
Indicates that the patch is for the Dashboard. The name MO indicates that the patch is for Operations Center. For more information on installing this patch, see the Novell Operations Center 5.0 Server Installation Guide. |
The procedure for installing the patch is the same for UNIX and Windows. The type of file for a patch is .jar. If you receive the file with a different extension, rename it to .jar before installing it.
One or more patches can be applied at a time, but patches and rollbacks cannot be applied at the same time with the same command. When a patch has already been applied, but is a older version than what you are installing, it is necessary to rollback the patch before installing the newer version of the patch.
When a patch bundle is applied, all previously applied patches are removed before the patch is applied.
To install the patch:
Copy the patch bundle to the root of the Dashboard installation directory.
The installation directory in the file system should have a minimum free disk space of twice the size of the patch bundle file.
For example, if the .jar file is 50 MB, then the free disk space should be at least 100 MB.
At a command prompt, enter Java to verify that Java is installed.
Patch files are issued as .jar files. The patch bundle is a Java executable file so it is necessary to have Java (either 32‑bit or 64‑bit) running on the machine where the Dashboard is installed.
If you receive the patch file with a different extension than .jar, rename it to .jar before installing it.
At the command prompt in the Dashboard installation directory, enter java –jar and the file name of the patch bundle.
For example, if the Dashboard is installed in the C: directory and the name of the patch bundle is 500-20100328-DASH.jar, then the command is:
C:/OperationsCenter_Dashboard_install_path>java -jar 500-20100328-DASH.jar
For additional options when running the installation, enter:
java –jar patch_bundle_filename(s) --help
Where, patch_bundle_filename(s) is a list of one or more patch files separated by a space.
This displays the following options:
–describe: Prints patch manifest information.
–prompt: Displays the Operations Center Dashboard Configuration Manager after the patch is installed.
–verbose: Prints detailed information to the screen as the patch is installed.
‑-force: Forces a patch to install even if it has already been applied. Never use the force command unless instructed to by Novell Support.
Add one of these commands at the end of the java –jar patch_bundle_filename command when installing the patch bundle (for example, java -jar 500-20110328-DASH.jar --verbose).
If installing on Windows and User Access Control (UAC) is enabled, you must run the command prompt as the Administrator.
During installation, the following occurs:
A back up is automatically created for all files that are overwritten. For more information about rollback files, see Section 12.5.3, Rolling Back a Patch Installation.
Patches (of the same version) that have already been applied are skipped unless the --force option was set.
The Operations Center Configuration Manager always runs silently and applies the current settings.
The patch does not override the existing Operations Center Configuration Manager settings.
For more information regarding the Operations Center Configuration Manager, see the Novell Operations Center 5.0 Server Configuration Guide.
Review the following chapter to configure and start the Dashboard.
After the patch has been installed and a rollback file is created, the patch cannot be installed again. If you attempt to run the patch bundle .jar file again, the following error messages are displayed:
ERROR: Unable to continue since rollback jar already exists
ERROR: unable to create rollback jar
As part of the patch installation process, Operations Center automatically backs up all files that are overwritten and places them in a file called patch_filename-rollback.jar, such as 500-201180723-DASH-rollback.jar.
If you decide to remove the changes made by the patch to Operations Center, run this rollback JAR file from the Operations Center root installation directory. The command for running the rollback file is the same as when the patch is installed. For example:
C:/OperationsCenter_install_path>java -jar 500-20110723-DASH-rollback.jar
When multiple rollback patches are applied using the same command, they are applied in the reverse order.
The following notes apply when upgrading your version of the Dashboard:
The Dashboard_install_path/server/webapps/root/WEB-INF/portal-ext.xml file, which might have been customized for various property settings, is overwritten during the upgrade process. A copy is automatically saved as portal-ext.xml.previous in the same directory. If you had modified this file as part of your installation, you will need to restore these changes after the upgrade installation.
Custom theme content is not updated during upgrades and any static links to documentation must be changed manually.
For instructions on upgrading the dashboard:
Before upgrading to myMO v4.7, be sure to review the upgrade notes in myMO/Dashboard Upgrade Considerations
in Novell Operations Center 5.0 Release Notes.
Liferay 5.x introduced a Role Based Access Control (RBAC) algorithm that assigns permissions using Roles, and other user grouping objects (groups, organizations, permissions) are assigned to roles.
For additional information from Liferay about the new permission algorithm and why it was implemented, see http://www.liferay.com/web/raymond.auge/blog/-/blogs/1339340/maximized.
The permission algorithm is set in the property in the portal-ext.properties file. Because myMO v4.7 employs this new RBAC algorithm for assigning permissions, upgrading to myMO v4.7 requires additional steps to convert existing permissions from Algorithm 2 to the new Algorithm 5.
To upgrade to myMO 4.7:
Install myMO 4.7 over the existing myMO 4.6 directory.
Start the myMO service.
myMO runs with algorithm 2 for backwards compatibility with existing permissions.
For more information about starting the myMO service, see Section 2.3.1, Starting the Dashboard.
Login to the Operations Center Dashboard.
Click and select .
Under select .
Click the tab.
Click to start the permissions conversion process.
When the conversion process is complete, logout of myMO and stop the myMO service.
For more information about stopping the myMO service, see Section 2.3.2, Stopping the Dashboard.
Modify the myMO_install_path/server/webapps/ROOT/WEB-INF/classes/portal-ext.ccustom.properties file to set the following:
permissions.user.check.algorithm = 5
Restart the myMO service.
For more information about starting the myMO service, see Section 2.3.1, Starting the Dashboard.
myMO now uses the latest permission algorithm with roles that were created during the permission conversion process.
New roles, created from existing permissions by the conversion process, can be accessed from the page in the . Rename these auto-generated roles with meaningful names, so that it is easy to identify them.
Before upgrading to Operations Center 5.0, be sure to review the upgrade notes in Upgrades from Managed Objects to Operations Center v5.0
and myMO/Dashboard Upgrade Considerations
in Novell Operations Center 5.0 Release Notes.
To upgrade from myMO to Operations Center Dashboard 5.0:
Do one of the following:
If upgrading from myMO 4.6, follow the same steps as outlined in Upgrading to myMO 4.7, where you are installing Dashboard 5.0 over the existing myMO 4.6 directory.
If upgrading from myMO 4.7, install the Dashboard over the existing myMO 4.7 directory.
If running an existing myMO/Dashboard implementation, you must switch from using the default Hypersonic SQL embedded database to upgrade to an Oracle or SQL Server database. If you have been using myMO/Dashboard with the embedded database, it is possible to upgrade your database and preserve existing data.
See Supported Versions and Hardware Requirements
in the Novell Operations Center 5.0 Getting Started Guide for supported database versions.
You must be running v4.7 to use an Oracle or SQL Database. During the v4.7 and v5.0 installation, the upgrade process upgrades the Hypersonic SQL embedded database and stores the files in the new default location of Dashboard_install_path/data/hsql.
IMPORTANT:myMO/Dashboard must be started at least once using the Hypersonic SQL embedded database, so that it can run a critical database verification processes. If you are installing Dashboard for the first time or have just upgraded, you must start myMO/Dashboard once before implementing the following steps to migrate the database to Oracle or SQL Server.
To migrate myMO/Dashboard to use an Oracle or SQL Server database on an existing integration:
Stop myMO. See Section 2.3.2, Stopping the Dashboard.
Do one of the following to create the schema for the new database:
Oracle: Use the Oracle SQL*Plus Client to run the Dashboard_install_path/data/scripts/create-oracle.sql file against your Oracle database.Note that the schema creation script contains some PL/SQL code which other jdbc based clients cannot execute.
SQL Server: Run the Dashboard_install_path/data/scripts/create-sql-server.sql file against your SQL Server database.
Open the Dashboard_install_path/server/webapps/ROOT/WEB-INF/classes/portal-ext.custom.properties file and make the following changes in the section:
Comment out any lines for the Hypersonic SQL embedded database.
Copy and paste the lines for the desired database from the portal-ext.properties file in the same directory, and customize for your configuration. Note the following:
jdbc.default.driverClassName and hibernate.dialect property values should not be changed.
For the jdbc.default.url property, specify a valid url string for the given driver. jtds for sql server and oracle for oracle).
For jdbc.default.username and jdbc.default.password properties, specify the credentials of a user that has valid access writes to the database.
The jdbc.default.schema property is only specified for oracle and required only when running the dbmigrate script.
Be sure the lines for the Oracle or SQLdatabase are uncommented in the portal-ext.custom.properties file.
Optionally, you can encrypt the password. For more information about encrypting the database password, see Section 12.1, Encrypting the Dashboard Database Password.
If needed, install the appropriate database drivers. Prepackaged JDCB drivers are available as part of the installation in the Dashboard_install_path/server/lib/ext/ directory. Install one of the following drivers:
Oracle: ojdbc6.jar
SQL Server: jtds-1.2.2.jar
Using a command prompt, from Dashboard_install_path/bin/, do one of the following to migrate existing data from the database:
Windows: Run dbmigrate.bat
UNIX: Run dbmigrate.sh
The migration process copies all data from the Hypersonic SQL embedded database, located in the Dashboard_install_path/data/hsql directory, to the destination database as specified in step 3.
Restart myMO/Dashboard and verify that existing data is available. See Section 2.3.1, Starting the Dashboard.