Installation Guide for Cisco Prime Unified Operations Manager 9.0
Chapter 2: Installing, Upgrading, and Uninstalling Cisco Unified Operations Manager
Downloads: This chapterpdf (PDF - 434.0KB) The complete bookPDF (PDF - 1.14MB) | Feedback

Table of Contents

Installing, Upgrading, and Uninstalling Cisco Prime Unified Operations Manager

Preparing to Install Prime UOM

Preparing the Prime UOM Serve

Server Preparation Checklist for New Installation and Upgrades

Preparing a Server Where Provisioning Manager Has Already Been Installed

Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM

Enabling the Full 4 GB of RAM

Preparing Devices for Addition to Prime UOM Inventory

Device-Specific Configurations

Actions to Take Before Adding Devices

Verifying TCP and UDP Ports that Prime UOM Uses

Gathering Information to Provide During Installation

Performing a New Installation

Installation Checklist

Installing Prime UOM—New

Installing Prime UOM in Silent Mode

Upgrading to Prime UOM 9.0 from 8.7 and 8.6

Upgrade Paths

Upgrading to Prime UOM 9.0

Upgrading from Prime UOM Releases Earlier than 8.0 to Prime UOM 9.0

Upgarding the Operating System

Verifying the Installation

Backing Up Prime UOM Data

Backing Up Detailed Device View Configurations Using Prime UOM Utilities

Backing Up Prime UOM and CiscoWorks/Common Services Databases and Files

Preparing Service Monitor for Data Migration

Planning for and Running Service Monitor Call Data Migration

Backing Up the Service Monitor Database Manually

Removing Cisco 1040 Configuration Files from TFTP Servers

Restoring Prime UOM and CiscoWorks/Common Services Databases and Files

Reintegrating Service Statistics Manager with Prime UOM

Reconfiguring Cisco 1040s After a Service Monitor Upgrade

Installing NBI API on Unified Operations Manager

Post-Installation Tasks

Configuring Your System for SNMP Queries

NTP Configuration Notes

Manually Clearing Unified CM Obsolete Events

Troubleshooting the Installation

Increase Size of the Virtual Memory Paging File

InstallShield Engine Cannot Be Installed

Installation Exits with Unsupported Locale Error

Uninstalling Prime UOM

Reinstalling Prime UOM

Installing, Upgrading, and Uninstalling Cisco Prime Unified Operations Manager

This chapter describes installing, upgrading, and uninstalling Cisco Prime Unified Operations Manager (with Cisco Prime Unified Service Monitor) on a Windows system.


Note Service Monitor is a separately licensed product. To use Service Monitor, you must install a Service Monitor license after the Prime UOM installation completes. See Licensing Process.


This chapter includes the following:

Preparing to Install Prime UOM

This section helps you to deploy Cisco Prime Unified Operations Manager (Prime UOM) in your network. Do the following before you install Prime UOM:

To disable the NBAPI:


Step 1 Open the command prompt and go to Directory <NMSROOT>\bin\footprint

Step 2 Enter the command given below:

perl DisableNBI.pl NMSROOT
 

where, NMSROOT is your default install directory. Usually it is C:\PROGRA~1\CSCOpx\

Server Preparation Checklist for New Installation and Upgrades

Before you install or upgrade to Prime UOM 9.0, do the following tasks:

  • If you are installing Prime UOM on a VMware, you must configure the virtual machine with a static MAC address. The license file can only be used with the MAC address that you supply. The static MAC address must be within the following range: 00:50:56:00:00:00 to 00:50:56:3F:FF:FF.
  • You should be a Windows built-in Administrator to install Prime UOMor Prime USM 9.0 (on Windows 2008 (or later) that supports UAC functionality, or any server). Any other users, even those with Administrator privileges cannot install Prime UOM. In such cases, Prime UOM and Prime USM will not work as expected, even when the access permission is provided.
  • Disable the virus scan software on your system. After the installation is complete, we recommend you exclude the NMSROOT directory from virus scanning. Problems can arise when Prime UOM files are locked because of virus scanning.
  • Disable Windows Data Execution Protection (DEP). DEP should remain off (that is, set to only protect critical Windows system files) as long as Prime UOM is installed on the server.

To set DEP for Windows 2003 and 2008:


Step 1 Choose Control Panel > System > Advanced.

If you are prompted for an administrator password or confirmation, enter the password or provide confirmation.

Step 2 From the Performance tab, click Settings.

Step 3 From the Data Execution Prevention tab, select Turn on DEP and then click OK to save the changes.

To enable Prime UOM to manage itself, install and configure SNMP on a local server. We recommend that you install Windows SNMP service before you install Prime UOM.


 

  • Set up the correct date and time on the system. Changing the date and time after installation can cause Prime UOM not to work, because it is perceived as a license violation. Also, the self-signed certificates that are generated during installation, become invalid.
  • Set your system’s IP address and hostname. It may be difficult to change them after you complete the installation.
  • Verify that the fully qualified domain name of the system on which Prime UOM is installed, is Domain Name System (DNS) resolvable. The IP address must be resolvable to the DNS, and the DNS must be resolvable to the IP address (forward and reverse lookup, in DNS terms).

To check name resolution on the Prime UOM server, in a command prompt, run the command NMSROOT \bin>smNameRes.exe .

NMSROOT is the directory where Prime UOM is installed on your system. If you selected the default directory during installation, it is C:\PROGRA~1\CSCOpx.

  • Verify that the drive that you choose to install Prime UOM on is an NTFS file system.

Note To install Prime UOMon VMware, ensure that you install it on a VMFS file system.


  • If you are using an IBM server with IBM Director installed, stop the IBM Director WMI CIM server and change the service to manual, or disable it. If you do not, the Service Level View in Prime UOM will not work.
  • Prime UOM uses ICMP ping to determine the reachability of all devices. Some security applications may detect a burst of ICMP pings as being caused by a malicious application. The security application may then block the ping requests. This can cause Prime UOM to generate a flood of false unreachable events.

To avoid this situation, you should configure security applications so they do not block bursts of ICMP pings from the Prime UOM server.

  • Clean the temp directory. You can open the temp directory by typing %temp% in a Windows Explorer window.
  • On Windows 2008, you must configure these PAGE FILE settings for Prime UOM to work:

In System Properties > Advanced > Performance Advanced > Virtual Memory change Page file from Automatically manage paging file size to a specific fixed size. We recommend the Initial and Maximum size be set to the same value. For detailed steps, see Increasing the Paging File Size.

  • On 4-GB system, Microsoft Windows detects only 3.5 GB of RAM, although your system may have 4 GB installed. To enable all 4 GB of RAM on the system, see Enabling the Full 4 GB of RAM.

Caution If the system memory is less than the minimum required to deploy both Prime UOM and Service Monitor, a message prompts you to upgrade your memory for better performance. If the system memory is less than the minimum required, an error appears and the installation cannot continue. You must upgrade the system memory to at least 4 GB before you continue with the installation.

  • Verify that the Primary and Active regional settings are set to either US English or Japanese. Other options are not supported by Prime UOM.

You can set the Active regional settings in Control Panel > Regional and Language Options > Regional Options .

  • You can install Prime UOM on a system with Terminal Services enabled in Remote Administration mode. However, installing Prime UOM on a system with Terminal Services enabled in Application mode, is not supported.

If you have enabled Terminal Server in Application mode, disable the Terminal Server, reboot the system, and start the installation again. See Terminal Server Support for Windows 2003 and 2008.

  • If Internet Information Services (IIS) is detected on your system and if you have continued the installation with IIS services, you cannot use port number 443 for HTTPS. Instead, you must use port numbers ranging from 1026 to 65535 for HTTPS to avoid this conflict.

Note Any time you change the HTTPS port that Prime UOM uses, see Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM.


  • Close all open or active programs. Do not run other programs during the installation process.
  • If you have the Cisco Security Agent installed on your system and it is running, shut it down. If you do not do so, you may receive a confirmation message during installation, requesting permission to continue. Click Yes and proceed.

To disable the Cisco Security Agent, right-click the Cisco Security Agent icon and choose Security Level > Off .

  • Prime UOM is installed in the default directory: SystemDrive :\Program Files\CSCOpx

Where SystemDrive is the drive on which the Windows operating system is installed.

If you select another directory during installation, the application is installed in that directory.

The destination folder should not contain any of the following special characters:

! @ # $ % ^ & * ( ) + | } { " [ ] ; ' / ? < > , . ` =

  • After you click the Install button, you can click Cancel at any time to end the installation or reinstallation. However, any changes to your system will not be undone.

For example, if any new files were installed or if any changes were made to the system files, you need to manually clean up the installation directories.


Note We recommend that you do not terminate the installation while it is running.


Preparing a Server Where Provisioning Manager Has Already Been Installed

To install Prime UOM and Provisioning Manager on the same server, we recommend that you install Prime UOM first. However, if Provisioning Manager is already installed and running in Secure mode, to install Prime UOM you must prevent SSL-related conflicts. Ensure that:

  • Win32 OpenSSL v0.9.8j Light library files are installed correctly.
  • Prime UOM will not use port 443. (Provisioning Manager uses port 443 for SSL.)

Note Any time that you change the HTTPS port that Prime UOM uses, see Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM.


This section contains:

Ensuring that There Is No Conflict over OpenSSL Library Files

To ensure no conflict, look for these library files in the Windows system directory:

    • ssleay32.dll
    • libeay32.dll

The Windows system directory might be C:\WINDOWS and is defined by the %WINDIR% system environment variable. If the files are in the Windows system directory, do the following:


Step 1 Uninstall Win32 OpenSSL v0.9.8j Light.

You can use Add or Remove Programs from the Control Panel; you can find the program by looking for OpenSSL.

To install Win32 OpenSSL v0.9.8j Light using the instructions provided in Step 2, download it from this URL: http://www.slproweb.com/products/Win32OpenSSL.html .

Step 2 Install Win32 OpenSSL v0.9.8j Light:

If you receive an error message that Visual C++ 2008 Redistributables are missing, you must download and install the Visual C++ 2008 Redistributables before proceeding. It is available from this URL: ( http://www.slproweb.com/products/Win32OpenSSL.html ).

a. During the installation, the Copy OpenSSL DLLs to prompt appears and provides two options:

The Windows System directory

The OpenSSL binaries(/bin) directory

b. Select The OpenSSL binaries(/bin) directory.

c. After the installation, copy the ssleay32.dll and libeay32.dll files:

From the C:\OpenSSL\bin folder to the C:\CUPM\httpd\bin folder

where C:\CUPM is the location where Provisioning Manager is installed and C:\OpenSSL is the location where OpenSSL is installed.

Installing Win32 OpenSSL v0.9.8j Light is only the first step to enable SSL on Provisioning Manager.

Step 3 Finish enabling SSL on Provisioning Manager by generating the security certificate and ensuring that the Apache server is correctly configured.

For more information, see Installation Guide for Cisco Prime Unified Provisioning Manager.


 

Preventing Conflict over Port 443

When you install Prime UOM, select Custom Installation instead of Typical Installation. During the custom installation, enter an HTTPS port other than 443. If you use Service Statistics Manager, see Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM.

Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM


Note By default, the Prime UOM HTTPS port is 443. (The HTTPS port is also known as the web services port.)


Any time that you change the HTTPS port that Prime UOM uses, Service Statistics Manager integration with Prime UOM fails. To recover, you must reconfigure Service Statistics Manager and reintegrate it with Prime UOM.

For more information, see Configuring Service Statistics Manager to Connect with Prime UOM in User Guide for Cisco Unified Service Statistics Manager . For supported Service Statistics Manager product release version, see Supported Devices Table for Cisco Unified Operations Manager .

You might change the Prime UOM HTTPS port at these times:

  • Before you install Prime UOM—See Preparing a Server Where Provisioning Manager Has Already Been Installed.
  • During Prime UOM installation—If port 443 is in use, the installer can automatically assign 8443 as the HTTPS port or you might be prompted to enter a port.
  • During Prime UOM reinstallation—You might be prompted to enter a port.
  • Prime UOM should not use 443 if Service Statistics Manager, Provisioning Manager, or IIS is installed on the same server.

Enabling the Full 4 GB of RAM


Note If your operating system is Windows 2003 Server Enterprise Edition, /PAE is enabled by default and, therefore, you might not need to perform this procedure.


On a 4-GB system, Microsoft Windows detects only 3.5 GB of RAM although your system has 4 GB installed. If you want to choose the medium or large installation when installing or upgrading Prime UOM, you must first enable all 4 GB of RAM on the system.


Step 1 On the Prime UOM system, in Microsoft Windows, right-click My Computer.

Step 2 Select Properties.

Step 3 Select the Advanced tab.

Step 4 Under Startup and Recovery, click Settings.

Step 5 Click Edit.

The boot.ini file opens.

Step 6 In the file, add /PAE to the line that starts with “multi(0)disk(0)rdisk(0)partition(1)\WINDOWS=...”

Step 7 Restart the system.


 

Preparing Devices for Addition to Prime UOM Inventory

This section describes tasks that you must perform before adding devices to Prime UOM device inventory.

Before adding devices to Prime UOM, do the following:

Device-Specific Configurations

This section contains device-specific configurations for:

Cisco Unified Communications Manager

  • Make sure that SNMP read access is configured on the Cisco Unified Communications Manager system.
  • Provide the HTTP username and password for AXL access. This is the same username and password that is used for the Cisco Unified Communications Manager Administration page.
  • If the Cisco Unified Communications Manager Administration page has HTTPS enabled, make sure HTTPS is enabled on all AXL directories.
  • For all supported 5.x (and later) Cisco Unified Communications Managers, make sure that the SOAP-Performance Monitoring API is running on all nodes and that the AXL service is activated on the first node (Publisher).

Note For supported Cisco Unified Communications Managers release versions, see Supported Devices Table for Cisco Prime Unified Operations Manager.


  • For all supported 4.x Cisco Unified Communications Managers, make sure that the IIS service is enabled.

Cisco Prime Unified Contact Center and Cisco Unity

  • Make sure that SNMP read access is configured on the Cisco Prime Unified Contact Center and Cisco Unity systems. You may need to download the Remote Serviceability Kit for certain versions of Cisco Unity (see www.ciscounitytools.com ).
  • For Prime UOM to autodiscover Cisco Prime Unified Contact Center devices, each Cisco Prime Unified Contact Center device must be configured with the SNMP v1 read credential. (This may be in addition to the SNMP v2c read credentials).

IPSLA Devices

  • Make sure that SNMP read and write access is configured on the IPSLA device. The write community string is required to configure tests.
  • If the device is used as a target device for the jitter node-to-node test, make sure that the IPSLA responder is enabled.

All Other Devices

Make sure that SNMP read access is configured.

Actions to Take Before Adding Devices

Before adding devices to Prime UOM, do the following:

  • Run pdshow to make sure all processes are running except for the transient processes, such as the purge tasks.

To find the list the processes and their status, choose Administration > Server Administration (Common Services) > Reports > Process Status.

  • Run NMSROOT \objects\smarts\bin\brcontrol and make sure that you see the message stating that VHM and DFM servers are registered to the broker. If you do not see this message, you must start VHMServer or DFMServer manually.

NMSROOT is the directory where Prime UOM is installed on your system. If you selected the default directory during installation, it is C:\PROGRA~1\CSCOpx.

Verifying TCP and UDP Ports that Prime UOM Uses

Before installing Prime UOM, make sure that the ports that Prime UOM (and Service Monitor) uses are free. For the TCP and UDP ports that Prime UOM uses, see Table 2-1 ; for Service Monitor, see Table 2-2 .

If you plan to install additional supported products (see Coresidence Guidelines), make sure the ports they use are free. For ports used by:

After installation, see Firewall Updates to Avoid Denial of Service Attacks.

 

Table 2-1 Ports that Prime UOM Uses

Port Numbers
Service Name
Application

80

Used to reach phones for XML-based data collection of serial numbers and load ID fetched through discovery.

Prime UOM

161

Simple Network Management Protocol (SNMP)

CiscoWorks

162

Trap receiving (standard port)

CiscoWorks

514

Syslog

CiscoWorks

1024-4999

Ephemeral ports

Prime UOM

40000-41000

Used by Common Transport Mechanism for internal application messaging

Prime UOM

42344

Used by Synthetic Testing web service

Prime UOM

42350-42353

Used by messaging software

Prime UOM

43445

Used by Alert History database engine

Prime UOM

43446

Used by inventory service database engine

Prime UOM

43447

Used by event processing database engine

Prime UOM

43449

Used by IP Phone Information Facility database engine

Prime UOM

8080

Used to determine whether the Cisco Unified Communications Manager 5.0 web service is up

This port must be made available to Prime UOM.

Prime UOM

9000

Trap receiving CSListener (Prime UOM server if
port 162 is occupied)

Prime UOM

9002

DynamID authentication (Prime UOMBroker)

Prime UOM

9009

Default port number used by the IP telephony server for receiving traps from the device fault server

Prime UOM

 

Table 2-2 Ports that Service Monitor Uses

Port Numbers
Service Name

22

SFTP—Service Monitor uses SFTP to obtain data from Unified Communications Manager 5.x and later.

53

DNS.

67 and 68

DHCP.

2000

SCCP—Service Monitor uses SCCP to communicate with Cisco 1040s.

43459

QOVRdatabase.

5666

Syslog—Service Monitor receives syslog messages from Cisco 1040s.

5665-5680

Interprocess communication between user interface and back-end processes.

These ports must be free.

 

Table 2-3 Ports that Service Statistics Manager Uses

Port Numbers
Service Name

8007

Apache JServ

8008

Tunnel Proxy

8009

Tomcat

8093

JMS Server

9149

JServer Event

48099

Remote Method Invocation

To configure Service Statistics Manager to use a port other than 48099, see the Quick Start for Service Statistics Manager.

48100

JBOSS

To configure Service Statistics Manager to use a port other than 48100, see the Quick Start for Cisco Unified Service Statistics Manager.

48101

HTTP—Web server

48102

Database

12123

Agent Controller Listener

12124

Used by SSM Agent to listen to messages from the SSM server

12125

Database access port that interacts between the agent controller and the database.

12126

Agent controller callback—This port is used by remote SSM agents to send data back to the Service Statistics Manager server.

12130

Checkpoint monitor (for receiving log messages)

12140

CLServer

12141

Log Server

18000

Rate

40402

Licensing

45000

Message server

48443

HTTPS—Secure web server

Gathering Information to Provide During Installation

You might need to supply the following information while you are installing Prime UOM:


Note For information on creating passwords, see Password Information.


  • User Admin password
  • System Identity Account password
  • Casuser password (custom installation only)
  • Guest password (custom installation only)
  • CiscoWorks database password (custom installation only)
  • Mail Settings (custom installation and when configuring an HTTPS port other than 443)

If IIS runs on your server, you are prompted to configure an HTTPS port other than 443, during the installation to avoid port conflict. If you select OK, you will need to enter mail settings.

  • License information—Location of the license file. If you have already obtained a license file, provide the path. If not, be sure to obtain one. You can do so before or after you install Cisco Prime Unified Operations Manager; see Licensing Process.

You can determine the status of your license from the CiscoWorks Licensing Information page.

From the Prime UOM home page, click Administration > Server Administration > Administration > Licensing .

  • If you install Prime UOM for evaluation purposes, you need not provide a license file. For more information see:

Licensing Overview

Licensing Reminders


 

Performing a New Installation


Note If you are migrating to Prime UOM 9.0 from an earlier version, see Upgarding the Operating System first.


Prime UOM allows you to choose the method in which to install your software:

The installation process takes approximately 60 minutes to complete. Review the Installation Checklist before proceeding with your installation. After the installation, see Post-Installation Tasks to complete the process.

Installation Checklist

Follow these guidelines when installing Prime UOM:

  • Do not install Prime UOM 9.0 before creating a backup (if you are migrating from an earlier version).
  • Prime UOM requires a dedicated system; do not install it on a system with:

Third-party management software (such as HP OpenView or NetView).

Cisco Secure Access Control Server (ACS).

Any Cisco applications other than those that are documented to be able to coexist with Prime UOM.

  • The system where Prime UOM is to be installed, must be configured for DNS.
  • Do not install Prime UOM on:

A Primary Domain Controller (PDC) or Backup Domain Controller (BDC)

A FAT file system.

A Windows Advanced Server with Terminal Services enabled in application server mode.

A system that does not have name lookup.

An encrypted directory. Prime UOM does not support directory encryption.

A voice application server or Cisco Unified Communications Manager server.

  • Do not install any CiscoWorks service packs on Prime UOM.
  • Verify that the system date and time are set properly.
  • To speed up installation, disable all virus-scan software while installing. After installation is complete, we recommend that you exclude the NMSROOT directory from future virus scanning. Problems can arise when Operation Manager files are locked because of virus scanning.
  • Your system’s IP address and hostname should be set before installation.
  • If you plan to use Cisco Prime Unified Service Monitor (which is installed when you install Prime UOM), the clocks on Service Monitor and Cisco Unified Communications Manager servers must be synchronized. See NTP Configuration Notes.
  • Moving your Prime UOM server from Windows Workgroup to Domain is not supported.
  • If you want to install Prime UOM on a machine with an unsupported locale, see Troubleshooting the Installation for details on steps to take to resolve the problem.

Note If you have configured Prime UOM in a master-slave server setup, install the master server before installing the slave server.


Installing Prime UOM—New

To perform a new installation of Prime UOM:


Step 1 Make sure your system meets these prerequisites:

    • Required (or desired) operating system upgrades have been performed.
    • Required service packs are installed.

For system requirements, see Server Requirements.

Step 2 Close all open or active programs. Do not run other programs during the installation process.

Step 3 Disable all anti-virus and Data Execution Protection (DEP) software.

Anti-virus can be re-enabled after installation, but you should exclude the NMSROOT directory as long as Prime UOM is installed on the server. DEP should remain off (that is, set to only protect critical Windows system files) as long as Prime UOM is installed on the server.

For details on installation tips, see https://supportforums.cisco.com/docs/DOC-9132 .

Step 4 Download the zip file that contains the Cisco Prime Unified Operations Manager 9.0 software package to your PC.

Step 5 Unzip the file to your local disk.

Step 6 As the built-in administrator, log into the machine on which you will install the Prime UOM software, and double-click the Cisco Prime Unified Operations Manager installer (setup.exe) on your local disk to start the installation program.

The Cisco Prime Unified Prime UOM Setup Program window opens.

If you stopped the installation process to close programs or if Autostart is disabled, click Setup to restart the process.

Step 7 Read any messages and acknowledge them:

    • If Provisioning Manager is running in Secure mode on the system, messages appear, prompting you to resolve conflicts and to use a port other than 443 for HTTPS.

You will not be able to continue the installation. Exit the installation and perform tasks in Preparing a Server Where Provisioning Manager Has Already Been Installed.

    • If WMI Services are running on the system

A message is displayed stating that, for the installation to proceed, the script will stop WMI Services, complete the installation, and restart WMI Services. To continue, click OK .

    • If IIS is detected (even if it is disabled)

A message is displayed stating that to avoid a port conflict with IIS, you need to click Yes. In a later step, you will be prompted to select an HTTPS port other than 443.

The Welcome window appears.

Step 8 Click Next .

The Software License Agreement window appears.

Step 9 Select the I accept the terms of the license agreement radio button and click Next .

The Licensing Information window appears.

Step 10 Select one of the following, and then click Next :

    • License File Location—Browse to enter the location.
    • Evaluation Only—You can complete the migration and then register the license file later.

For instructions on obtaining a license file, see Licensing Process .

The Setup Type window appears.

Step 11 Select Typical if you want the system to automatically provide the following information to the installation process:

    • Guest password
    • CiscoWorks database password
    • Mail Settings (also appears if you need to configure an HTTPs port other than 443)

If you change the HTTPS port that Prime UOM uses, see Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM for details.

    • Self-signed certificate information

If you choose the Custom installation mode, you are prompted to enter this information during the installation process.

Step 12 Click Next .

The Choose Destination Folder window appears.

Step 13 Do one of the following:

    • Click Next to accept the default installation directory.
    • Browse to the folder where you would like to install Prime UOM, and click Next .

The installation program checks dependencies and system requirements.

If you are installing on a virtual machine with a dynamic MAC address:

The System Requirements window displays the results of the requirements check and prompts whether the installation can continue. One of the following might occur:

    • If there is not enough disk space for the installation, or if memory requirements are not met, the installation program displays an error message and stops. (See Server Requirements.)
    • If the minimum recommended requirements are not met, the installation program displays a warning message and continues installing.

Step 14 Select Enterprise Network Deployment or Multiple End-Customer Network Deployment to assign the network deployment that needs to be monitored and managed by Prime UOM.

Step 15 Click Next .

The Enter Admin Password window appears.

a. Enter a password, confirm it, and click Next .

Remember the password. You will need it to log into Prime UOM until you have configured security and created users in addition to admin.

The Enter System Identity Account Password window appears.

If you selected the Custom installation mode, during this part of the installation you are prompted to enter the information in Step 11.

b. Enter a System Identity Account password (and confirm), and click Next .

The Create Casuser dialog box appears.

c. Click Yes to continue with the installation.

If IIS is present on your server and you selected Yes (to avoid port conflict by reconfiguring the HTTPS port), the Mail Settings window appears. The range of ports that you can use for HTTPS is displayed. After entering data, click Next .

If you change the HTTPS port that Prime UOM uses, see Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM for details.

d. The Change casuser Password window appears. Do one of the following:

Click Next to automatically generate the password.

Enter a password and confirm it before clicking Next .

The Summary window appears, displaying the current settings.

Step 16 Click Install .

The installation proceeds.

Step 17 Click OK to confirm additional messages if they are displayed:


Caution Prime UOM requires only one NIC card and supports only one IP address. Prime UOM does not support two NIC cards with different IP addresses.

    • If Windows SNMP service is not installed on your system, a message appears indicating this.
    • If you did not supply a license file during the installation, a message about obtaining a license file is displayed.
    • After the installation is complete, the following message appears:
Before you reboot this system, configure automatic time synchronization on it using NTP. Configure this system to use the time server that is used by Cisco Unified Communications Managers in your network.

Caution This message may not appear in the foreground and may be minimized in the taskbar. You must click OK in this message or your installation time may be significantly impacted.

For more information, see NTP Configuration Notes.

A pop-up appears with the Yes, I want to restart my computer now radio button selected.

Step 18 Click Finish to reboot the machine.

Wait 30 minutes after the system reboots before starting Prime UOM. This gives all of the Prime UOM processes time to initialize.

Step 19 After the installation completes:

a. Verify that Prime UOM was installed correctly by starting the application. From the Windows desktop, choose Start > All Programs > Cisco Prime Unified Operations Manager > Cisco Prime Unified Operations Manager .

b. See Post-Installation Tasks.


 

If errors occur during installation, do the following:

    • Check the installation log file in the root directory on the drive where the operating system is installed. Each installation creates a new log file, such as this: C:\Ciscoworks_install_YYYYMMDD_hhmmss.log, where YYYYMMDD denotes the year, month and date of installation and hhmmss denotes the hours, minutes and seconds of installation; for example: C:\Ciscoworks_install_20100721_182205.log.
    • See Troubleshooting the Installation.

Installing Prime UOM in Silent Mode

Silent installation or unattended installation is supported in the Prime UOM single installer for both Enterprise Network and Multiple End-Customer Network. You can perform only a new installation of Prime UOM 9.0 in silent installation mode.

Silent install does not prompt you for inputs. It continues the installation based on the information provided in the installation response file. See User Input for a Silent Installation for more information.


Caution To migrate from a previous version of Prime UOM, you must first back up data and uninstall Prime UOM before you run a silent installation. See Upgarding the Operating System.

To perform a silent installation:


Step 1 Ensure you have created your installation response file with values to suit the desired configuration for your system. See User Input for a Silent Installation for details.


Note The installation response file must be named only as answerfile.txt.


Step 2 Download the zip file that contains the Prime UOM 9.0 software package to your PC.

Step 3 Unzip the file to your local disk.

Step 4 Copy the response file into the "install" folder, available in the location where you have unzipped the CUOM zip file.

Step 5 Goto the folder where the CUOM zip file is extracted and from the command line, enter this command:

setup.exe QUIET answerfile=<answer_file_name>

The installation starts.


Note Prime UOM supports only new installation and does not support migration, upgrades, uninstall or reinstall in silent mode.


Step 6 Restart your system after the installation is complete.


 

Upgrading to Prime UOM 9.0 from 8.7 and 8.6

This section covers the following topics:

Upgrade Paths

Prime UOM supports the two upgrade paths listed in Table 2-4.

 

Table 2-4 Upgrade Paths to Prime UOM 9.0

From This License
To This License
Upgrade to Prime UOM 9.0 Is Supported from These Operations Manager Releases

Purchased

Purchased

8.7 (Direct upgrade)

 
Upgradation to Operations Manager 9.0 MSP mode is supported

Purchased

Purchased

8.6 (Direct upgrade)

Evaluation

Evaluation

None


Caution There is no direct upgrade from Operations Manager releases earlier than 8.0.

For further information on how to migrate from other releases prior to Prime UOM 8.0, see http://www.cisco.com/en/US/products/ps6535/prod_installation_guides_list.html

Upgrading to Prime UOM 9.0

If you have configured Prime UOM in a master-slave server setup, upgrade the master server before upgrading the slave server.

When you migrate to Prime UOM 9.0 from 8.7 and 8.6, the co-resident Service Monitor upgrades to release 9.0.

To upgrade from Prime UOM 8.6 and 8.7 to Prime UOM 9.0:


Step 1 Make sure your system meets the prerequisites listed under Server Requirements.

Step 2 Close all open or active programs. Do not run other programs during the upgrade process.

Step 3 Disable all anti-virus and Data Execution Protection (DEP) software.

Anti-virus can be re-enabled after installation, but you should exclude the NMSROOT directory as long as Prime UOM is installed on the server. DEP should remain off. That is, set to only protect critical Windows system files, as long as Prime UOM is installed on the server.

For details on installation tips, see https://supportforums.cisco.com/docs/DOC-9132 .

Step 4 Ensure that you have completed a backup. (See Backing Up Prime UOM Data.)

If an inventorybackup.xml file already exists in CSCOpx\objects\vhm\utilities directory before the Prime UOM 9.0 upgrade, rename the inventorybackup.xml file before you perform the upgrade.

Step 5 Download the zip file that contains the Cisco Prime Unified Operations Manager 9.0 software package to your PC.

Step 6 Unzip the file to your local disk.

Step 7 As the local administrator, log into the machine on which you will install the Prime UOM software, and double-click the Cisco Prime Unified Operations Manager installer (setup.exe) on your local disk to start the installation program.

The Cisco Prime Unified Operations Manager Setup Program window opens.

If you stopped the installation process to close programs or if Autostart is disabled, click Setup to restart the process.

Step 8 Read any messages and acknowledge them:

    • If Provisioning Manager is running in Secure mode on the system, messages appear, prompting you to resolve conflicts and to use a port, other than 443 for HTTPS.

You will not be able to continue the installation Exit the installation and perform tasks in Preparing a Server Where Provisioning Manager Has Already Been Installed.

    • If Windows Management Instrumentation (WMI) Services are running on the system

A message is displayed stating that, for the installation to proceed, the script will stop WMI Services, complete the installation, and restart WMI Services. To continue, click OK .

    • If IIS is detected (even if it is disabled)

A message is displayed stating “to avoid a port conflict with IIS, click Yes”. In a later step, you will be prompted to select an HTTPS port, other than 443.

The Welcome window appears.

Step 9 Click Next .

To save any Service Monitor report data that you have (and, if you have not run the Call Migration Tool) click No , exit, and run the Call Migration Tool before you run the upgrade.

Otherwise, click Yes . See Planning for and Running Service Monitor Call Data Migration.

The Software License Agreement window appears.

Step 10 Select the I accept the terms of the license agreement radio button and click Next .

The Licensing Information window appears.

Step 11 Select one of the following, and then click Next :

    • License File Location—Browse to enter the location.
    • Evaluation Only—You can complete the migration and then register the license file later.

For instructions on obtaining a license file, see Licensing Process .

The Setup Type window appears.

Step 12 In the Setup Type window, choose Typical. The system automatically provides the following information to the installation process:

    • Guest password
    • CiscoWorks database password
    • Mail Settings (also appears if you need to configure an HTTPs port other than 443)

If you change the HTTPS port that Prime UOM uses, see Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM for details.

    • Self-signed certificate information

Step 13 Click Next .

The installation program checks dependencies and system requirements.

    • If you are upgrading on a virtual machine with a dynamic MAC address:

Another warning message will be displayed. Click Yes .

After the installation completes, you can run Prime UOM in the Evaluation mode without problems. If you are not in the Evaluation mode, you must configure a static MAC address to run Prime UOM. For more information, see Table 1-4 lists the minimum requirements for Prime UOM and Service Monitor coexistent installation. .)

The System Requirements window displays the results of the requirements check and prompts whether the installation can continue. One of the following might occur:

    • If there is not enough disk space for the installation, or if memory requirements are not met, the installation program displays an error message and stops. (See Server Requirements.)
    • If the minimum recommended requirements are not met, the installation program displays a warning message and continues installing.

Step 14 Click Next .

The Enter Admin Password window appears.

a. Enter a password (and confirm), and click Next .

Remember the password. You will need it to log into Prime UOM until you have configured security and created users in addition to admin.

The Enter System Identity Account Password window appears.

If you selected the Custom installation mode, during this part of the installation you will be asked to enter all the information that is noted in Step 11.

b. Enter a System Identity Account password (and confirm), and click Next .

The Create Casuser dialog box appears.

c. Click Yes to continue with the installation.

If IIS is present on your server and you selected Yes (to avoid port conflict by reconfiguring the HTTPS port), the Mail Settings window appears. The range of ports that you can use for HTTPS is displayed. After entering data, click Next .

If you change the HTTPS port that Prime UOM uses, see Ensuring that Service Statistics Manager Uses the Correct HTTPS Port to Contact Prime UOM for details.

d. The Change casuser Password window appears. Do one of the following:

Click Next to automatically generate the password.

Enter a password and confirm it before clicking Next .

The Summary window appears, displaying the current settings.

Step 15 Click Install .

The installation proceeds.

Step 16 Click OK to confirm additional messages if they are displayed:


Caution Prime UOM requires only one NIC card and supports only one IP address. Prime UOM does not support two NIC cards with different IP addresses.

    • If Windows SNMP service is not installed on your system, a message appears indicating this.
    • If you did not supply a license file during the installation, a message about obtaining a license file is displayed.
    • After the installation is complete, the following message appears:
Before you reboot this system, configure automatic time synchronization on it using NTP. Configure this system to use the time server that is used by Cisco Unified Communications Managers in your network.

Caution This message may not appear in the foreground and may be minimized in the taskbar. You must click OK in this message or your installation time may be significantly impacted.

For more information, see NTP Configuration Notes.

A pop-up appears with the Yes, I want to restart my computer now radio button selected.

Step 17 Click Finish to reboot the machine.

Wait 30 minutes after the system reboots before starting Prime UOM. This gives all Prime UOM processes, time to initialize.

After the installation completes:


Step 1 Verify that Prime UOM was upgraded correctly by starting the application. From the Windows desktop, choose Start > All Programs > Cisco Prime Unified Operations Manager .

Step 2 To make sure all existing devices go to the Monitored state, you must configure Prime UOM to perform rediscovery after restart. Do the following:

a. In Prime UOM, choose Administration > Device Management > Device Configuration > Modify/Delete Devices .

b. In the device selector, select the All Devices check box.

c. Click Rediscover .

To restore the detailed device view configuration, run the restore utility after discovery is completed. See Reconfiguring Cisco 1040s After a Service Monitor Upgrade.


 

If errors occur during installation, do the following:

    • Check the installation log file in the root directory on the drive where the operating system is installed. Each installation creates a new log file, such as this:

C:\Ciscoworks_install_YYYYMMDD_hhmmss.log, where YYYYMMDD denotes the year, month and date of installation and hhmmss denotes the hours, minutes and seconds of installation; for example: C:\Ciscoworks_install_20100721_182205.log.

Upgrading from Prime UOM Releases Earlier than 8.0 to Prime UOM 9.0

You cannot upgrade directly from Operations Manager 2.x release to Prime Unified Operations Manager 9.0.

To upgrade to Prime UOM 9.0 from Operations Manager 2.3:


Step 1 Migrate to Operations Manager 8.0 or 8.5.

Step 2 Upgrade to Operations Manager 8.6 or Prime UOM 8.7.
See installation guides for the respective releases for migration procedures.

Step 3 Upgrade to Prime UOM 9.0.

You can access the installation guides from the following URL:

http://www.cisco.com/en/US/partner/products/ps6535/prod_installation_guides_list.html

For releases earlier than 2.3, see the migration process in http://www.cisco.com/en/US/partner/docs/net_mgmt/cisco_unified_operations_manager/2.3/installation/guide/InstallationGuideforCiscoUnifiedOperationsManager.html


 

Upgarding the Operating System

To know the list of supported operating systems, see Server Requirements.

If the HTTPS port for the backed up content is non-default and the restored server has a default HTTPS port and the SM cross launch is configured to use the non-default HTTPS port, then the Route Pattern Summary Portlet will not work. If you try to update the port using "changeport.exe" for SSL in the restored machine, the DCRServer hangs in waiting state.

To avoid this issue:

  • Reconfigure the SM cross launch page to use default HTTPS port, doing so the Route Pattern Summary Portlet will continue to work.
  • Use the same custom port that was used in backed up content while installing OM 9.0 for migration.

Note • All the Reports in File system must be manually backed up.

  • All the contents under NMSROOT/Importfiles folder must be manually backed up.


 

For more information on how to perform database maintenance (handle Sybase database issues, fix DB fragmentation, edit the Health Monitor configuration files, or view backed up process logs), see the Online help or User Guide for the Cisco Prime Unified Operations Manager .

Verifying the Installation

You can verify Prime UOM 9.0 installation using either of these procedures.

Procedure 1

    • Enter the command pdshow from NMSROOT /bin.

Where, NMSROOT is the CiscoWorks installation directory (by default, SystemDrive:\Program Files\CSCOpx and SystemDrive is the Windows operating system installed directory).

    • Select Administration > Server Administration > Process Management from the menu, to see various processes and their status. For example, see the processes list and check whether the PIFServer is there.

Procedure 2

You can verify the installation using Software Center.

Select Administration > Software Center (Common Services)> Software Update and the Software Updates page appears. You can verify the installation using the Products installed dialog box.

Backing Up Prime UOM Data


Note Backup and restore is supported only within the same version of Prime UOM. For example, you should backup your 8.7 or 8.6 data before upgrading to 9.0. You may use this backup only to restore to 8.7 or 8.6 if you have any problems in upgrading to 9.0.


Before backing up Prime UOM database, you might need to perform some database maintenance. To determine whether this is the case, see the Online help or User Guide for the Cisco Prime Unified Operations Manager .

To perform a complete backup of Prime UOM, do both of the following:


Caution If your database backup has a different admin password than the existing Prime UOM server, the admin password reverts to the restored admin password after the migration.

As an ongoing maintenance measure, scheduled backups should occur weekly or monthly; not daily. You must delete the old versions of the backed up files manually.

For details on known issues, see Release Notes for Cisco Prime Unified Operations Manager.

Backing Up Detailed Device View Configurations Using Prime UOM Utilities

The Prime UOM Inventory Backup utility backs up the states of all components of all types of monitored or partially monitored devices in the Detailed Device View (DDV). The inventory Backup utility does not cover suspended devices. Backup and Restore must be done on the same machine.

The inventory backup utility is separate from and must be used in addition to the database backup described in Backing Up Prime UOM and CiscoWorks/Common Services Databases and Files.


Caution Ensure that the daemon processes for this system are up and running to allow for data backup.

The restore utility restores the managed states of non- suspended devices in the Detailed Device View.

To run the backup utility:


Step 1 Open a DOS prompt and enter:

% PROGRA~1\CSCOpx\objects\vhm\utilities\inventoryBackup default

Where default saves the managed states of all monitored and partially monitored devices to the inventoryBackup file. No user input is needed while the script is running.


Caution Backup on a network drive is not supported. Although the CLI is functional, we recommend you do not use it because of network connectivity issues. As a result, the mapped network drive on the server will not be available for selection in the user interface.

If you prefer to enter a specific filename or a list specific device IP addresses, enter:

% PROGRA~1\CSCOpx\objects\vhm\utilities\inventoryBackup

The script prompts you to enter the filename and device information.


Caution After you migrate to Prime UOM 9.0, you can run the inventoryRestore script only after rediscovering all devices from the Prime UOM Device Management interface. During device rediscovery, the system may be under a heavy load, resulting in the user interface becoming unresponsive.
The dashboards may not refresh during this time. We recommend that you wait to perform any user interface actions until device discovery is complete.

Step 2 To run the restore utility, open a DOS prompt and enter:

% PROGRA~1\CSCOpx\objects\vhm\utilities\inventoryRestore default

Where default restores the data saved in the inventoryBackup.xml file. No user input is needed while the script is running.

If you want to input your own filename enter:

% PROGRA~1\CSCOpx\objects\vhm\utilities\inventoryRestore

The script prompts you to enter the filename you previously created using the backup utility.


 

Backing Up Prime UOM and CiscoWorks/Common Services Databases and Files

You must use the CiscoWorks Backup and Restore features during your migration to Prime UOM 9.0.

The CiscoWorks Backup feature backs up the Prime UOM and CiscoWorks databases, selected files, and all license files including those for Prime UOM and Service Monitor.

The CiscoWorks Backup feature does not back up the following: The state of components in the Detailed Device View (DDV); The database for Service Monitor; The call data from which reports are generated in Service Monitor. Therefore, additional procedures are provided to backup up each of them (elsewhere in this guide).

Backup and Restore is supported within 8.7 and 9.0 versions only. Backup and Restore must be done on the same machine. Backup from earlier versions of Prime UOM is not supported.


Caution Backup on a network drive is not supported. Although the CLI is functional, we recommend that you do not use it because of network connectivity issues. As a result, the mapped network drive on the server will not be seen from the user interface for drive selection.

Because Prime UOM supports the Device Credentials Repository (DCR), you should refer to the CiscoWorks Online help:

  • Effects of Backup-Restore on DCR
  • Master-Slave Configuration Prerequisites and Restore Operations

To access CiscoWorks Online help, select Administration and then select a topic under any heading that includes (CiscoWorks/Common Services). When the new window opens, click Help in it.

To run back up and restore the database:


Step 1 Choose Administration > Server Administration (Common Services) > Administration > Backup .

The Backup Job page appears.

Step 2 Click the Help button and follow the instructions for backing up and restoring data.


Note Print the restore instructions from the CiscoWorks help. When you restore, you will be prompted for whether you want to restore the license files; for the migration to succeed, enter Yes.



 

Database files are stored using the backup directory structure described in Table 2-5 .

  • Format—/generation_number/suite/directory/filename
  • Example—/1/itemFh/database/itemFh.db

 

Table 2-5 Prime UOM Backup Directory Structure

Option
Description
Usage Notes

generationNumber

Backup number

For example, 1, 2, and 3, with 3 being the latest database backup.

suite

Application, function, or module

When you perform a backup, data for all suites is backed up. The CiscoWorks/Common Services server suite is cmf. The Prime UOM application suites are:

  • dfm—Data collection and analysis for devices in IP infrastructure
  • itemEpm—Event promulgation
  • itemFh—Alert history
  • itemInv—Device inventory
  • itemIPIU—Phone information
  • qovr—Service quality
  • vhm—Data collection and analysis for voice-enabled devices
  • wpu—Node-to-node tests.

(The Service Monitor suite is qovr.)

directory

What is being stored

Each application or suite listed. Directories include database and any suite applications.

filename

File that has been backed up

Files include database (.db), log (.log), version (DbVersion.txt), manifest (.txt), tar (.tar), and data files (datafiles.txt).

Preparing Service Monitor for Data Migration

To prepare the Service Monitor for data migration:


Step 1 Change the database password of the Service Monitor system.

a. On the Service Monitor system, open a command prompt.

b. Stop all processes by entering:

net stop crmdmgtd
 

c. Change to the Installation Directory by entering:

cd NMSROOT\bin
 

(NMSROOT is the directory where Service Monitor is installed; its default location is C:\Program Files\CSCOpx.)

d. Run perl dbpasswd.pl dsn=qovr npwd=cisco . (Changes the password to cisco .)

e. Start all processes by entering:

net start crmdmgtd
 

Step 2 In a backup folder, make a copy of the NMSROOT\qovr\config\ptm\creds file.

If you want to migrate call data, see Planning for and Running Service Monitor Call Data Migration .

Step 3 Backup the Service Monitor database (see Backing Up the Service Monitor Database Manually).

If you have Cisco 1040 sensors, do the tasks in Removing Cisco 1040 Configuration Files from TFTP Servers.


 

Planning for and Running Service Monitor Call Data Migration

Call data is the data from which Service Monitor generates reports. Migrating call data is optional. However, to keep the data, you must migrate it before you start the upgrade to Service Monitor 8.7. You can find the call migration tool in the zip file that contains the Service Monitor product on Cisco.com.

The README_QOVR_CMT.TXT file that is included with the Call Migration Tool provides estimates of the time that data migration takes and the disk space it uses. It also explains the effect that running the tool, has on Prime UOM and Service Statistics Manager, if they are installed in your network.

If you plan to migrate your Service Monitor data, see Installation Guide for Cisco Prime Unified Service Monitor 9.0 .

Backing Up the Service Monitor Database Manually

You must back up the Service Monitor database manually to nonlocal storage. (The Service Monitor database can potentially grow to greater than 10 GB.). To do this:


Step 1 Log into the system where Service Monitor is installed.

Step 2 Stop the daemon manager using this command:

net stop crmdmgtd
 

Step 3 From NMSROOT \databases\qovr, copy the files qovr.db and qovr.log to a tape, an external drive, or a network directory (not a local directory).

This ensures data integrity in case of hardware failure and ensures that backup data does not exhaust local disk space.

Step 4 Restart the daemon manager using the following command:

net start crmdmgtd


 

Removing Cisco 1040 Configuration Files from TFTP Servers

We recommend that you delete existing Cisco 1040 configuration files from your existing TFTP servers before you perform the migration. Delete one QOVDefault.CNF file and the QoV MACAddress .CNF file for each sensor.

Immediately after you complete the installation of Prime UOM (includes Service Monitor), Cisco 1040 sensors are unable register to Service Monitor until you perform post-migration configuration steps. For more information, see Reconfiguring Cisco 1040s After a Service Monitor Upgrade.

Restoring Prime UOM and CiscoWorks/Common Services Databases and Files

To complete the restoring process:


Step 1 Log into the Prime UOM server as an Administrator and stop the daemon manager using this

command:

net stop crmdmgtd

Step 2 To run the restore command, the command syntax is:

C:\PROGRA~1\CSCOpx\bin\perl C:\PROGRA~1\CSCOpx\bin\restorebackup.pl <-d BackupDirectory> [-gen GenerationNumber] [-t TempDirectory] [-help]
  • BackupDirectory—Directory where the backup archive is present
  • GenerationNumber—Generation to be restored
  • TempDirectory—Temporary directory for the restore program

Default TempDirectory for this restore program is:

C:\PROGRA~1\CSCOpx\tempBackupData

Use -t TempDirectory to define your own temp directory

Step 3 When prompted, you must agree to restore the license files; enter Yes.

Step 4 If you backed up the Service Monitor database and files before starting the migration, do the following:

a. Change the Service Monitor database password to the same password that you set in Service

Monitor 8.0.

b. Restore the Service Monitor database that you backed up earlier.

c. Copy the previously backed-up creds file to the new installation, in NMSROOT\qovr\config\ptm.

Step 5 Restart the daemon manager using the following command:

net start crmdmgtd

Step 6 Start rediscovery and allow it to complete.

Reintegrating Service Statistics Manager with Prime UOM

Service Statistics Manager stops collecting data from Prime UOM when you reinstall or migrate Prime UOM and change either of the following:

  • The password for the admin user.
  • The destination location (the directory in which Prime UOM is installed).

To re-enable data collection, perform the procedures given in Release Notes for Cisco Unified Service Statistics Manager.

Reconfiguring Cisco 1040s After a Service Monitor Upgrade

This section provides the minimum steps required to enable Cisco 1040 sensors to register with Service Monitor.

For complete configuration procedures, including how to add Unified Communications Managers and Network Analysis Modules (NAMs) to Service Monitor, see the configuration checklists in User Guide for Cisco Prime Unified Service Monitor.


Step 1 Start Service Monitor.

Step 2 Configure the default configuration file:

a. Choose Administration > Configuration > Cisco 1040 > Setup .

The Setup page appears.

b. Update the Default Configuration to TFTP Server fields:

Image Filename—Enter SvcMonAB2_102.img.

Primary Service Monitor—Enter an IP address or DNS name.

Secondary Service Monitor—(Optional) Enter an IP address or DNS name.


Note Occasionally, updated binary image files might be released. For the names of supported binary image files, see Cisco Prime Unified Service Monitor 9.0 Compliance Matrix.


c. Click OK .

Service Monitor stores the default configuration file locally and copies it to the TFTP servers that are configured in Service Monitor.

d. Copy the binary image file, SvcMonAB2_102.img, from NMSROOT \ImageDir on the Service Monitor server to the root location on the TFTP server.

NMSROOT is the directory where Service Monitor is installed; its default location is C:\Program Files\CSCOpx.

e. Verify that the newly created QOVDefault.CNF file is on the TFTP server.

If it is not, upload it to the root location on the TFTP server from the Service Monitor image file directory, NMSROOT\ImageDir. For examples of the configuration files, see “Sample Sensor Configuration Files” in the Installation Guide for Cisco Prime Unified Service Monitor on Cisco.com.

If you use Unified Communications Manager as a TFTP server, Service Monitor cannot copy configuration files to Unified Communications Manager because of security settings on the latter.

Manually upload the configuration file to the root location on the TFTP server from the Service Monitor image file directory, NMSROOT /ImageDir . After uploading the configuration file, reset the TFTP server on Unified Communications Manager.

For more information, see the Unified Communications Manager documentation.

Step 3 Wait for a few minutes and verify that the sensors have registered to Service Monitor.

If they have not, reset the sensors by disconnecting them from the power source and connecting them again.


Warning Before disconnecting a sensor, read the regulatory compliance and safety information in Quick Start Guide for Cisco 1040 Sensor.



 

Installing NBI API on Unified Operations Manager

To install NBI on Unified Operations Manager, please execute the following command:

perl.exe "<NMSROOT>\bin\footprint\enableNBI.pl" "<NMSROOT>"
 

Where NMSROOT is your default install directory. Usually it is C:\PROGRA~1\CSCOpx\

Post-Installation Tasks

You must complete the following post-installation tasks to ensure Prime UOM works properly.

 

Tasks
Refer to

To install or verify Windows SNMP service (if you use a third-party SNMP management tool to make SNMP queries to Prime UOM)

Configuring Your System for SNMP Queries

To synchronize the clocks on Service Monitor and Cisco Unified Communications Manager servers

NTP Configuration Notes

Exclude the NMSROOT directory from future virus scanning.

Problems can arise when Operation Manager files are locked because of virus scanning.

See your virus scanning help for instructions.

Clear the Unified Communications Manager events that are no longer used in Prime UOM.

To view the list of events, see Manually Clearing Unified CM Obsolete Events.

To block remote access to all TCP/UDP ports except for those required for external access by Prime UOM

Firewall Updates to Avoid Denial of Service Attacks

Configuring Your System for SNMP Queries

Prime UOM implements the system application MIB. If you want to use a third-party SNMP management tool to make SNMP queries against the server where Prime UOM is installed, Windows SNMP service must be installed.

To improve security, the SNMP set operation is not allowed on any object ID (OID) in the system application MIB. After installing Prime UOM, you should modify the credentials for Windows SNMP service so that it does not use a default or well-known community string.

To determine whether Windows SNMP service is installed.


Step 1 Verify that Windows SNMP service is installed on the server where you will install Prime UOM. To do so:

a. Open the Windows administrative tool Services window.

b. Verify the following:

SNMP Service is displayed on the Windows administrative tool Services window; if so, Windows SNMP service is installed.

SNMP service status is Started; if so, SNMP service is running.

Step 2 If Windows SNMP service is not installed, install it.

Windows online help provides instructions for adding and removing Windows components, such as Windows SNMP service. To locate the instructions, try selecting the Index tab in Windows online help and entering a keyword or phrase, such as install SNMP service .


 

NTP Configuration Notes

The clocks on Service Monitor and Cisco Unified Communications Manager servers must be synchronized for Service Monitor reports to include complete and up-to-date information and accurately reflect activity during a given time period. These notes offer a starting point and do not provide complete instructions for configuring NTP.

To get started:


Step 1 Discuss with your Cisco Unified Communications Manager administrators to determine the time server with which Service Monitor should synchronize.

For further details see Cisco IP Telephony Clock Synchronization: Best Practices , a white paper on Cisco.com.

Step 2 Use your system documentation to configure NTP on the Windows Server system where Service Monitor will be installed.

Step 3 Configure NTP with the time server being used by Cisco Unified Communications Managers in your network.

For further details see How to configure an authoritative time server in Windows Server 2003 , useful; look for it at this URL: http://support.microsoft.com/kb/816042 .


Note This website is Copyright © 2012, Microsoft Corporation.



 

Manually Clearing Unified CM Obsolete Events

The following Unified CM events are obsolete and should be manually cleared from the Fault Monitor after installation or migration.

  • cpuUtilizationExceeded
  • InsufficientFreeHardDisk
  • InsufficientFreeMemory
  • InsufficientFreeVirtualMemory
  • ServiceDown
  • IDS Replication Failure

Troubleshooting the Installation

Some issues may result during an installation. Use the following recommendations to resolve these installation issues:

If errors occur during installation, check the installation log file in the root directory on the drive where the operating system is installed. Each installation creates a new log file, such as this:

C:\Ciscoworks_install_YYYYMMDD_hhmmss.log, where YYYYMMDD denotes the year, month and date of installation and hhmmss denotes the hours, minutes and seconds of installation; for example: C:\Ciscoworks_install_20100721_182205.log.

Increase Size of the Virtual Memory Paging File

Symptom:

Windows Virtual Memory is too low. Event Viewer (System log) shows that the system is running out of virtual memory.

Message:

Application popup: Windows - Virtual Memory Minimum Too Low: Your system is low on virtual memory.

Cause:

Windows is increasing the size of your virtual memory paging file. During this process, memory requests for some applications may be denied.

Action:

To change the size of the virtual memory paging file on the Prime UOM server:


Step 1 From the Windows Start menu, click Start > Control Panel > System .

Step 2 Select the Advanced tab and under Performance, click Settings .

Step 3 Select the Advanced tab and under Virtual memory, click Change .

Step 4 Under Paging file size for the selected drive, click Custom size and type a new paging file size in megabytes in the Initial size (MB) and Maximum size (MB) boxes, and then click Set .

The virtual memory must be 1.5 times of RAM.

The Initial and Maximum size should be set to the same value.


 

InstallShield Engine Cannot Be Installed

Symptom:

During Prime UOM installation, the following error message appears:

Message:

“The InstallShield Engine(iKernel.exe) could not be installed. Ikernel.exe could not be copied to C:\Program Files\Common Files\InstallShield\Engine\6 \Intel 32.”

Cause:

Multiple instances of the Install Program are being run.

InstallShield (the install program for the Prime UOM) allows only one ikernel.exe running at a time.

Action:

Stop all install programs and run the Prime UOM installation program.

Installation Exits with Unsupported Locale Error

There are instances where the Prime UOM installation fails with the following error message (even if the regional language is set to English):

"You are trying to install Cisco Works on an unsupported locale. Cisco Works \
supports only US English or Japanese languages. The setup program will exit when \
you click OK. Please change the regional settings to either of these languages".
 

To configure the locale setting, and resolve this issue:


Step 1 Go to Control Panel > Regional and Language Option .

Step 2 From the Regional Option tab ensure the following are set:

    • In Standards and Formats, click Customize and select English (United States) or English (Japanese).
    • In Location, select United States or Japanese.

Step 3 From the Advanced tab in Language for non-Unicode Programs, select English (United States) or English (Japanese).

Step 4 Click Apply .

Check the registration entries and compare them with the values below. If the values are different from those shown below, change them to "00000409".

HKEY_USERS \\DEFAULT\\Control Panel\\International \\ locale \\00000409 \

HKEY_CURRENT_USER\\Control Panel\\International\\ locale \\00000409

If the International key is missing, make sure you have the required permission to create a key at the super group; for example, Control Panel.

To create a key do either of the following:

    • Export the same key from another machine to this machine. For example, export the HKEY_CURRENT_USER key to this machine.
    • Create this key and manually add all entries under this key.


 

Uninstalling Prime UOM

If you are migrating to Prime UOM 9.0 from an earlier version, you must back up your data before you uninstall Prime UOM; see Upgarding the Operating System,


Caution You must use the Prime UOM uninstallation program to remove Prime UOM from your system. If you try to remove the files and programs manually, you can seriously damage your system.

Before you uninstall Prime UOM, ensure that:

  • Remote desktop sessions are not connected to Prime UOM. Remote sessions can lock files; if Prime UOM processes are running, Prime UOM installation will stop.
  • You have deleted all phone status, node-to-node, and SRST tests from the application. If you do not delete these tests, they will continue to run on the router.

To delete these tests, use the respective configuration page for each test (see the Cisco Prime Unified Operations Manager Online help for information on deleting each test).


Step 1 As the local administrator, log into the system on which Cisco Prime Unified Operations Manager is installed.

Step 2 Choose Start > All Programs > Cisco Prime Unified Operations Manager > Uninstall Cisco Prime Unified Operations Manager .

If Windows Management Instrumentation (WMI) is running on the system, this message is displayed:

Windows Management Instrumentation (WMI) is running. This locks processes and impedes installation. To avoid WMI conflicts, this program will stop and immediately restart the WMI service.stating that WMI impedes the uninstallation and to prevent conflict, the script will stop WMI services and restart them.
 

Step 3 Click OK .

To cancel the uninstallation, you can click Cancel on the next window that appears.

An Uninstallation window appears, listing the components to uninstall. To continue, click Next ; otherwise click Cancel .

Messages showing the progress of the uninstallation appear.

The following message appears:

Uninstallation is complete. Before you install CW200 product, you must restart your computer and delete any residual files from C:\PROGRA~1\CSCOPX manually.
 

The Yes, I want to restart my computer no w radio button is selected by default. Alternatively, you can select the No, I will restart my computer later radio button.


Note You must restart your computer to finalize the uninstallation.


Step 4 Click Finish .


 

Reinstalling Prime UOM

To reinstall Prime UOM:


Step 1 Ensure that you have completed preparations to reinstall Prime UOM:

    • Backed up all the data that you want to migrate: the DDV, the Prime UOM database, and—if you need Service Monitor data—the Service Monitor database and optionally call data for Service Monitor reports.
    • Copied the Service Monitor creds file (if using Service Monitor)
    • Printed the instructions for restoring using the CiscoWorks restore feature; you will need them to restore the Prime UOM data.

Step 2 Uninstall Prime UOM:

a. Follow instructions in Uninstalling Prime UOM.

b. Delete the CSCOpx directory.

If you are upgrading your opererating system, do so now.

Step 3 Ensure that the Prime UOM server is prepared for reinstallation; see Preparing the Prime UOM Serve.

Step 4 Install Prime UOM 9.0:

a. See Installation Checklist

b. See Installing Prime UOM—New

Step 5 Immediately after completing the reinstallation, close all open or active programs. Do not run other programs during the reinstallation process.

Step 6 After the reinstallation completes, verify that Prime UOM was reinstalled correctly by starting the application. From the Windows desktop, choose Start > All Programs > Cisco Prime Unified Operations Manager > Cisco Prime Unified Operations Manager .

If errors occur during installation, do the following:

  • Check the installation log file in the root directory on the drive where the operating system is installed. Each installation creates a new log file, such as this:

C:\Ciscoworks_install_YYYYMMDD_hhmmss.log, where YYYYMMDD denotes the year, month and date of installation and hhmmss denotes the hours, minutes and seconds of installation; for example: C:\Ciscoworks_install_20100721_182205.log.

Step 7 Restore the backed up data. See Restoring Prime UOM and CiscoWorks/Common Services Databases and Files.

Step 8 Restart the Daemon Manager after restoring the data. Enter the following command in the Windows prompt:

net start CRMDMgtd

Note Wait for 30 minutes for Prime UOM to start.


Step 9 To make sure all existing devices go to the Monitored state, you must configure Prime UOM to perform rediscovery after restart. Do the following:

a. In Prime UOM, choose Administration > Device Management > Device Configuration > Modify/Delete Devices.

b. In the device selector, select the All Devices check box.

c. Click Rediscover. To restore the Detailed Device View configuration, run the restore utility after rediscovery completes. Be sure you have rediscovered your devices before completing this step.