Upgrading Netcool Configuration Manager to version 6.4.2.0

To upgrade from Netcool Configuration Manager version 6.4.1 to version 6.4.2.0, follow these instructions.

Before you begin

These instructions are for upgrading from a previous major version, for example V6.4.1.0, to V6.4.2.0. To apply fix packs, for example to move from V6.4.2.0 to V6.4.2.x, first upgrade to V6.4.2.0 and then apply the fix pack.

For instructions about installing fix packs, refer to the Release Notes for the fix pack you want to install, within the Release notes section.

If you have customized any entries in properties files, you might see validation messages about changes to default values in properties files during installation. Change the values as suggested by the message and retry. Do not skip the validation checks, because this can cause undesired functionality in your upgraded installation. Make a list of any customized values prior to performing the upgrade. Once the upgrade has been completed, you must manually make those changes again in the files. Properties files that are commonly modified include the /config/properties/rseries.properties and ITNCM.properties files.
Tip: When installing on the same server as an existing, older version of Netcool Configuration Manager, ensure that before installation you back up the properties files from the home directory to a different location. For example: 
cp $HOME/.rseries.properties $HOME/.rseries.properties_backup

About this task

If you are an Oracle database user and have commented out the HADRErrorCodes=-4498 key/value, (which is only needed by DB2 database users), the upgrade process will remove the '#', and it will no longer be commented out, which is the default for the rseries.property file. Therefore if you require that this value be commented out, you need to do so again after upgrading.

Restriction: You must install Netcool Configuration Manager in a different location to any previous versions.
Note: After upgrading to Netcool Configuration Manager V6.4.2, you must install the latest drivers, and also reconfigure or reinstall OOBC:
Drivers
As a default, and as previously, drivers are installed to the following location: <ncm install directory>/drivers
See the Drivers installation documentation for more information.
OOBC
Reinstall or reconfigure OOBC to point to the new Netcool Configuration Manager installation.

Procedure

  1. Update to supported database if necessary.
    Note: Supported database versions are DB2 10.1 and 10.5, and Oracle 11g and 12c.
  2. Ensure you have the IBM Installation Manager Version 1.8.2 (or newer) present on your system.
    • Install Installation Manager 1.8.2 using the group install script.
    • Upgrade your current Installation Manager to 1.8.2:
      1. In the Installation Manager UI, click File > Preferences > Updates.
      2. Select Search for Installation Manager updates.
      3. Click Apply, then OK.
      The update to the latest Installation Manager will occur on next usage.
  3. Set the IBM_JAVA_OPTIONS environment variable to include: 
    "-Dcom.ibm.tivoli.itncm.panels.utils.KeystoreManager=/installDir/config/properties"
    where /installDir/config/properties is the configuration directory from the previous installation. For example: 
    export IBM_JAVA_OPTIONS=”-Dcom.ibm.tivoli.itncm.panels.utils.KeystoreManager=
/opt/IBM/tivoli/netcool/ncm/config/properties
  4. Perform a new installation of Netcool Configuration Manager.
    Execute the IBM Installation Manager from $HOME/IBM/InstallationManager_Group/eclipse
    1. During the installation, point to the database updated in step one.
    2. Use the DASH credentials that were originally used when Netcool Configuration Manager was installed. The default username was Intelliden.
      Important: Do not accept the default username of smadmin. Your installation might continue, but fail later.
  5. Upgrade the database schema to the latest version on the main presentation server only, by running the following command: 
    install_dir/bin/utils/database/upgrade/upgradeDBSchema.sh version
    Where version is the older version of the product that you are upgrading from. For example: 
    /opt/IBM/tivoli/netcool/ncm/bin/utils/database/upgrade/upgradeDBSchema.sh 6.4.2.5
  6. Copy the .intelliden.keystore and .intelliden.user files from the previous version to the current version of installDir/config/properties.
  7. Copy the .itncm.cmkeystore and .itncm.cmusers files from the previous version to the current version of installDir/compliance/config/properties.

What to do next

Clear the browser cache
After upgrading, clear the cache on any browsers that you use to work with Netcool Configuration Manager.
Help
To access the Help documentation (or 'User Assistance'), you must modify the system property ITNCM Help URL:
  1. Select Systems Manager on the navigation tree.
  2. Click Tools > System Properties.
  3. Select ITNCM Help URL, and update the host and port number to the DASH installation.
Customizing the rseries.properties file
If you have customized your rseries.properties file, these will be overwritten during an upgrade. You must manually make those changes again.
Specifically, if you are an Oracle database user who requires that the HADRErrorCodes=-4498 key/value be commented out, you must again do so after upgrading.
Multiple presentation servers
If you have more than one presentation servers, you must edit the /opt/IBM/tivoli/netcool/ncm/eventpollers.xml file and change the 'pollerid' so that it matches all of the presentation servers.
For more details, see Configuration of eventpollers.xml file.
OOBC and Drivers
Install the latest Drivers.
Reconfigure or reinstall OOBC.