Guest

CiscoWorks Network Compliance Manager

Upgrade Guide for CiscoWorks Network Compliance Manager 1.4.02

  • Viewing Options

  • PDF (191.0 KB)
  • Feedback
CiscoWorks Network Compliance Manager, 1.4.02 Upgrade Guide

Table Of Contents

CiscoWorks Network Compliance Manager, 1.4.02 Upgrade Guide

Contents

CiscoWorks NCM Core Linux, Solaris, or Windows Installation Overview

High Availability Distributed System Upgrade Installation Overview

Backing Up the CiscoWorks NCM Database

MS-SQL Server Backup Instructions

MySQL Backup and Restore Instructions

Oracle Backup Instructions

Device Software Image and CiscoWorks NCM Files Backup

Installing CiscoWorks NCM 1.4.02 on a Windows Server

Installing CiscoWorks NCM 1.4.02 on a Linux Server

Installing CiscoWorks NCM 1.4.02 on a Solaris Server

Upgrading Additional CiscoWorks NCM Components

CiscoWorks NCM Satellites

CiscoWorks NCM AAA Log Reader

CiscoWorks NCM Syslog Reader

CiscoWorks NCM Drivers

Troubleshooting

Accessing the CiscoWorks NCM Documentation Set

Obtaining Documentation, Obtaining Support, and Security Guidelines


CiscoWorks Network Compliance Manager, 1.4.02 Upgrade Guide


Published: May, 2009, OL-19758-01

This document includes important information on upgrading to CiscoWorks Network Compliance Manager (NCM), Release 1.4.02. CiscoWorks NCM 1.4.02 may only be installed on any CiscoWorks NCM 1.4 release.


Note All documentation, including this document and any or all of the parts of the CiscoWorks NCM documentation set, might be upgraded over time. Therefore, we recommend you access the CiscoWorks NCM documentation set using the Cisco.com URL: http://www.cisco.com/en/US/products/ps6923/tsd_products_support_series_home.html


The Docs tab visible from within CiscoWorks NCM might not include links to the latest documents.

Contents

This document contains the following sections:

CiscoWorks NCM Core Linux, Solaris, or Windows Installation Overview

Backing Up the CiscoWorks NCM Database

Device Software Image and CiscoWorks NCM Files Backup

Installing CiscoWorks NCM 1.4.02 on a Windows Server

Installing CiscoWorks NCM 1.4.02 on a Linux Server

Installing CiscoWorks NCM 1.4.02 on a Solaris Server

Upgrading Additional CiscoWorks NCM Components

Troubleshooting

Accessing the CiscoWorks NCM Documentation Set

Obtaining Documentation, Obtaining Support, and Security Guidelines

CiscoWorks NCM Core Linux, Solaris, or Windows Installation Overview

CiscoWorks NCM 1.4.02 is available from the CiscoWorks NCM Software Download page (http://www.cisco.com/cgi-bin/tablebuild.pl/cwncm-crypto) as a .ZIP package. CiscoWorks NCM 1.4.02 only upgrades from CiscoWorks NCM 1.4.


Note Once the CiscoWorks NCM 1.4.02 is installed, the CiscoWorks NCM installation and its database can not be reverted. Be sure to backup your database before you run this upgrade.


The following steps provide an outline for single CiscoWorks NCM Core upgrade. For detailed information on installing and configuring CiscoWorks NCM, refer to the CiscoWorks Network Compliance Manager Quick Start Guide.

Also refer to the Release Notes for CiscoWorks NCM 1.4.02 for late breaking information regarding upgrading and installing CiscoWorks NCM.

1. Stop all CiscoWorks NCM services. Refer to Chapter 2, "Configuring Administrative Settings" in the User Guide for Network Compliance Manager for information.

2. To ensure that no settings or files are lost during the upgrade, backup the entire CiscoWorks NCM directory to a safe location. For example, if you installed CiscoWorks NCM in c:\cisco\CWNCM, backup the entire directory to a safe location.

3. Be sure that you have backed up all of the data in the database. Refer to the "Backing Up the CiscoWorks NCM Database" section for information.

4. Follow the install instructions appropriate to your CiscoWorks NCM platform:

Installing CiscoWorks NCM 1.4.02 on a Windows Server

Installing CiscoWorks NCM 1.4.02 on a Linux Server

Installing CiscoWorks NCM 1.4.02 on a Solaris Server

High Availability Distributed System Upgrade Installation Overview

The following steps provide an outline for High Availability Distributed System upgrades.

For additional information on CiscoWorks NCM High Availability Distributed System, refer to the High Availability Distributed System on Microsoft SQL Server Configuration Guide for Network Compliance Manager or High Availability Distributed System on Oracle Server Configuration Guide for Network Compliance Manager available using the Cisco.com URL: http://www.cisco.com/en/US/products/ps6923/products_installation_and_configuration_guides_list.html


Note Once the CiscoWorks NCM 1.4.02 is installed, the CiscoWorks NCM installation and its database can not be reverted. Be sure to backup your database before you run this upgrade


1. Stop all CiscoWorks NCM services on all CiscoWorks NCM Cores.

2. To ensure that no settings or files are lost during the upgrade, backup the entire CiscoWorks NCM directory to a safe location. For example, if you installed CiscoWorks NCM in c:\cisco\CWNCM, backup the entire directory to a safe location.

3. Be sure that you have backed up all of the data in the database. Refer to your database documentation for instructions on backing up the database or contact your Database Administrator.

4. Wait for the Transaction queue to be empty before running the Service Pack Installer on each CiscoWorks NCM Core. Refer to your database documentation for information on how to check the Run the CiscoWorks NCM 1.4.02 Service Pack Installer on each CiscoWorks NCM Core in the system.

5. To verify the CiscoWorks NCM installation:

a. Edit an object on one CiscoWorks NCM server (for example, a Comments field for a device).

b. Wait a minute and then verify that the updated comment exists on the second CiscoWorks NCM server.

c. Check the status of the Oracle Distributed Monitor in the UI to ensure that no problems are being reported. Refer to the "Distributed Monitor Results Page" section in the High Availability Distributed System Configuration Guide for Network Compliance Manager for information.

For detailed information on upgrading a High Availability Distributed System, refer to Chapter 2: "Installation, Setup, and Upgrading," in the High Availability Distributed System Configuration Guide for Network Compliance Manager. Also refer to the CiscoWorks NCM 1.4.02 Release Notes for late breaking information regarding upgrading CiscoWorks NCM.

Backing Up the CiscoWorks NCM Database

Although your data should be safe during the upgrade process, be sure that you have backed up all of the data in the database.


Note Once the CiscoWorks NCM 1.4.02 is installed, the CiscoWorks NCM installation and its database can not be reverted.


For information on backing up your device software images and CiscoWorks NCM files, see the "Device Software Image and CiscoWorks NCM Files Backup" section.

When you enter a database name to identify the CiscoWorks NCM database, it must be in the identical case as the database name in the database application. For example, if you created your CiscoWorks NCM database as NCMdb, be sure to enter NCMdb when backing up and restoring the database.

MS-SQL Server Backup Instructions

To back up MS-SQL Server databases do the following:


Step 1 Start Enterprise Manager.

Step 2 Connect to the MS-SQL database server and navigate to your database.

Step 3 Right-click and select All Tasks > Backup Database.

Step 4 Under Destination, if there are any entries highlight them and click Remove.

Step 5 Under Destination, click Add.

Step 6 Open the file browser.

Step 7 Under File name, enter a filename for your backup. Be sure to provide a new filename or you will overwrite any existing backups.

Step 8 Click OK three times to start the backup procedure. Depending on the size of your database, this could take several minutes.


MySQL Backup and Restore Instructions

To back up MySQL databases used by CiscoWorks NCM do the following:


Step 1 From the command line prompt in the mysql\bin folder, enter the following command:

mysqldump -h<databaseserver> -u<username> -p<password> -r <YourFileName>.sql <DatabaseName>

where:

databaseserver = ipaddress/hostname where database is running

username is the username to connect to the database server

password is the password to connect to the database server

DatabaseName is the CiscoWorks NCM database name. This database name is given during the install of CiscoWorks NCM.

Example:

mysqldump -hNCMDBServer -utc -ptc -r NCM_Backup_04_30_04.sql NCM

Step 2 Copy (or move) the file to a backup location.

Step 3 Stop the MySQL service:

On a Windows platform, navigate My Computer > Control Panel > Administrative Tools > Services.

On a Linux or Solaris platform, enter the command /etc/init.d/mysql stop

Step 4 Locate the mysql\data folder. It should contain a large ibdata file. For a standard install, this file is located in c:\mysql\data. Copy that entire data folder to a backup location.

Step 5 Restart the MySQL service.


Note This operation can take ten minutes or more for large databases.



Oracle Backup Instructions

Please see your Oracle DBA for information on backing up the databases.

Device Software Image and CiscoWorks NCM Files Backup

In an enterprise environment, system administrators are usually required to periodically backup crucial software applications. CiscoWorks NCM's server state is maintained in several configuration files. Before installing the CiscoWorks NCM 1.4.02, create a full copy of your CiscoWorks NCM directory.

Installing CiscoWorks NCM 1.4.02 on a Windows Server

You can obtain the CiscoWorks NCM 1.4.02 file from the CiscoWorks NCM Software Download page on Cisco.com. You must have administrator access to run the Service Pack Installer.

Keep in mind that CiscoWorks NCM services must be stopped before running this upgrade process. Be sure to close Windows Explorer and all other applications before running the Service Pack Installer.


Note Once you run the Service Pack Installer, CiscoWorks NCM 1.4.02 cannot be uninstalled. As a result, you cannot return to the prior system after upgrading to CiscoWorks NCM 1.4.02.


To install CiscoWorks NCM 1.4.02 on a CiscoWorks NCM Windows server from the Software Download page, do the following:


Step 1 Navigate to http://www.cisco.com/cgi-bin/tablebuild.pl/cwncm-crypto to download the CiscoWorks NCM 1.4.02 package.

Step 2 Enter your www.cisco.com username and password to log in.

Step 3 Select CWNCM14_SP2_Windows-K9.zip.

Step 4 Verify that the software and image information are correct to continue the download process. Click Next.

Step 5 Read the Software Download Rules and click Accept.

Step 6 When prompted, save the .zip file to a temporary location on your local drive such as C:\temp.

Step 7 In the directory to which you downloaded the .zip file, unzip the file in the same directory. For example, C:\temp\CWNCM14SP2. Keep the subdirectory structure intact.

Step 8 Enter: <temporary directory where the contents are unzipped>\Windows_ServicePack_[BLDNUM]_setup.exe, where [BLDNUM] is the build number.

Step 9 Click OK.

Step 10 Follow the instructions on the screen.


Refer to the "Upgrading Additional CiscoWorks NCM Components" section for information on upgrading CiscoWorks NCM components, such as CiscoWorks NCM Satellites, the CiscoWorks NCM AAA Log Reader, and the CiscoWorks NCM Syslog Reader.

Installing CiscoWorks NCM 1.4.02 on a Linux Server

You can obtain the CiscoWorks NCM 1.4.02 file from the CiscoWorks NCM Software Download page on Cisco.com. You must have root access to run the Service Pack Installer.


Note When upgrading to CiscoWorks NCM 1.4.02 on a Linux platform, the Service Pack Installer modifies the file permissions on every sub-folder in the CiscoWorks NCM directory. As a result, if you have other applications installed within the CiscoWorks NCM directory, such as MySQL, the application's file permissions might change and this could cause it to be unusable.


Keep in mind that CiscoWorks NCM services must be stopped before running this upgrade process.


Note Once you run the Service Pack Installer, CiscoWorks NCM 1.4.02 cannot be uninstalled. As a result, you cannot return to the prior system after upgrading to CiscoWorks NCM 1.4.02.


To install CiscoWorks NCM 1.4.02 on a CiscoWorks NCM Linux server from the Software Download page, do the following:


Step 1 Navigate to http://www.cisco.com/cgi-bin/tablebuild.pl/cwncm-crypto to download the CiscoWorks NCM 1.4.02 package.

Step 2 Enter your www.cisco.com username and password to log in.

Step 3 Select CWNCM14_SP2_Linux-K9.zip.

Step 4 Verify that the software and image information are correct to continue the download process. Click Next.

Step 5 Read the Software Download Rules and click Accept.

Step 6 When prompted, save the .zip file to a temporary location.

Step 7 In the directory to which you downloaded the .zip file, unzip the file in the same directory. For example, /tmp/CWNCM14SP2. Keep the subdirectory structure intact.

Step 8 Navigate to the temporary directory which contains the unzipped files.For example:

cd /tmp/CWNCM14SP2

Step 9 Enter the following: sh Linux_ServicePack_[BLDNUM]_setup.bin, where [BLDNUM] is the build number.

Step 10 Follow the instructions on the screen.


Refer to the "Upgrading Additional CiscoWorks NCM Components" section for information on upgrading CiscoWorks NCM components, such as CiscoWorks NCM Satellites, the CiscoWorks NCM AAA Log Reader, and the CiscoWorks NCM Syslog Reader.

Installing CiscoWorks NCM 1.4.02 on a Solaris Server

You can obtain the CiscoWorks NCM 1.4.02 file from the CiscoWorks NCM Software Download page on Cisco.com. You must have root access to run the Service Pack Installer.


Note When upgrading to CiscoWorks NCM 1.4.02 on a Solaris platform, the Service Pack Installer modifies the file permissions on every sub-folder in the CiscoWorks NCM directory. As a result, if you have other applications installed within the CiscoWorks NCM directory, such as MySQL, the application's file permissions might change and this could cause it to be unusable.


Keep in mind that CiscoWorks NCM services must be stopped before running this upgrade process.


Note Once you run the Service Pack Installer, CiscoWorks NCM 1.4.02 cannot be uninstalled. As a result, you cannot return to the prior system after upgrading to CiscoWorks NCM 1.4.02.


To install CiscoWorks NCM 1.4.02 on a CiscoWorks NCM Solaris server from the Software Download page, do the following:


Step 1 Navigate to http://www.cisco.com/cgi-bin/tablebuild.pl/cwncm-crypto to download the CiscoWorks NCM 1.4.02 package.

Step 2 Enter your www.cisco.com username and password to log in.

Step 3 Select CWNCM14_SP2_Solaris-K9.zip.

Step 4 Verify that the software and image information are correct to continue the download process. Click Next.

Step 5 Read the Software Download Rules and click Accept.

Step 6 When prompted, save the .zip file to a temporary location.

Step 7 In the directory to which you downloaded the .zip file, unzip the file to the same directory. For example, /tmp/CWNCM14SP2. Keep the subdirectory structure intact.

Step 8 Navigate to the temporary directory which contains the unzipped files. For example:

cd /tmp/CWNCM14SP2

Step 9 Enter the following: sh Solaris_ServicePack_[BLDNUM]_setup.bin, where [BLDNUM] is the build number.

Step 10 Follow the instructions on the screen.


Refer to the "Upgrading Additional CiscoWorks NCM Components" section for information on upgrading CiscoWorks NCM components, such as CiscoWorks NCM Satellites, the CiscoWorks NCM AAA Log Reader, and the CiscoWorks NCM Syslog Reader.

Upgrading Additional CiscoWorks NCM Components

The following optional components must be upgraded when upgrading CiscoWorks NCM.

CiscoWorks NCM Satellites

If you are using CiscoWorks NCM Satellites, after CiscoWorks NCM 1.4.02 is installed, you must run the Deploy Remote Agent task to re-install the upgraded Satellite agent on all of the remote Gateways. Refer to the "Upgrading the Satellite" section in the Installation and Upgrade Guide for CiscoWorks NCM Gateway for detailed information.

CiscoWorks NCM AAA Log Reader

If you are running CiscoWorks NCM on a Windows platform and using the AAA Log Reader on your AAA server to provide real-time change detection, you will need to update the AAA Log Reader.

To update the AAA Log Reader, do the following:


Step 1 Backup the AAA Log Reader directory on your AAA server.

Step 2 Copy the truecontrol-client.jar file located in [install_directory]\NCM_Root\client to the AAA Log Reader directory. Overwrite the existing file.

Step 3 Change the following four options in the agent.rcx file for correct error logging to appear in the aaa_wrapper.log.

Change:

[option name="log/AAALogReader"]System.out[option]

[option name="log/AAALogReader/level"]0[option>

[option name="log/connect"]System.out[option]

[option name="log/connect/level"]75[option]

To:

[option name="log/External/AAALogReader"]System.out[option]

[option name="log/External/AAALogReader/level"]0[option]

[option name="log/System/Authenticate"]System.out[option]

[option name="log/System/Authenticate/level"]75[option] 4


CiscoWorks NCM Syslog Reader

CiscoWorks NCM uses Syslogs to detect device changes in real-time. Some environments require the use of a Syslog Reader to forward messages from the syslog server to CiscoWorks NCM. Typically, the Syslog Reader is only needed in rare cases.

If you are using the Syslog Reader, it needs to be upgraded. To upgrade the Syslog Reader, do the following:


Step 1 Go to /usr/local/rendition/syslogreader/probe.rcx.

Step 2 In the probe.rcx file, make a note of the following lines:

[option name="connect/AppServerURL"]SERVERNAME:1099[/option]

[option name="SyslogReader/LogFile/FileName"]SOMEPATH/FILE[/option]

Step 3 Stop the Syslog Reader.

Step 4 Run /etc/init.d/truecontrol.syslogreader stop.

Step 5 Remove the /usr/local/rendition directory.

Step 6 Follow the install instructions in the ReadMe.txt file. Be sure to include the correct values in the probe.rcx file from step 2.


CiscoWorks NCM Drivers

You must install the latest CiscoWorks NCM Driver Pack after you install CiscoWorks NCM 1.4.02, otherwise you could experience a regression in functionality. Go to the Software Download page at http://www.cisco.com/cgi-bin/tablebuild.pl/cwncm-crypto and download the latest CiscoWorks NCM Driver Pack. After CiscoWorks NCM 1.4.02 is installed, install the latest CiscoWorks NCM Driver Pack.

Troubleshooting

If the CiscoWorks NCM 1.4.02 upgrade failed, check the following files for detailed error messages:

1. [Install_Directory]/CWNCM_InstallLog.log

2. All files in [Install_Directory]/server/log

If the CiscoWorks NCM 1.4.02 upgrade is successful, but CiscoWorks NCM 1.4.02 does not run, check the following:

1. [Install_Directory]/CWNCM_InstallLog.log file

If this file is truncated, this indicates that CiscoWorks NCM 1.4.02 was not allocated enough disk space. Refer to Chapter 1, "Planning and Installation," in the User Guide for Network Compliance Manager.


Note NOTE: Please contact your System Administrator to resolve disk space or other hardware issues.


2. [Install_Diretory]/jre folder

If JRE is installed successfully, the folder should contain approximately 600 files. An installation failure will result in less than 100 files. This could occur if Windows Explorer was not closed or other applications were running during the upgrade. Be sure to close Windows Explorer and all other applications before running the Service Pack Installer.

If the upgrade appears to hang, running a multi-million record update can take a long time and you might think the upgrade has hung. This may not be the case. Before you cancel the upgrade installer, make sure to check the log files. The file is located in Installation Directory and is titled NCMInstallLog.log.


Note In the case of system failures, logging is the primary means of identifying what is going wrong and the means of troubleshooting the issue. Be sure to send all pertinent logs to Support, along with any error messages, even if the troubleshooting information is removed.


Accessing the CiscoWorks NCM Documentation Set

You can access the entire CiscoWorks Network Compliance Manager documentation set from the following Cisco.com URL:

http://www.cisco.com/en/US/products/ps6923/tsd_products_support_series_home.html

From here you can navigate to any documentation for CiscoWorks NCM 1.4.02 you will need.


Tip To cut and paste a two-line URL into the address field of your browser, you must cut and paste each line separately to get the entire URL without a break.



Note All documentation, including this document and any or all of the parts of the CiscoWorks NCM documentation set, might be upgraded over time. Therefore, we recommend you access the CiscoWorks NCM documentation set using the Cisco.com URL: http://www.cisco.com/en/US/products/ps6923/tsd_products_support_series_home.html


The Docs tab visible from within Network Compliance Manager might not include links to the latest documents.

Obtaining Documentation, Obtaining Support, and Security Guidelines

For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html