Cisco Media Gateway Control Node Manager Installation Guide, 2.6.1 - Installing Cisco MGC Node Manager [Cisco Media Gateway Controller Node Manager]

Table Of Contents

Installing Cisco MGC Node Manager

Performing a New Installation of the Cisco MNM

Task 1: Gather Installation Software and Required Information

Installation Software

Required Information

Task 2: Ensure That Network Devices Have the Correct Software

Task 3: Plan and Execute Hard Drive Partitioning

Task 4: Ensure That the Sun Solaris 8 Operating System Is Installed

Task 5: Obtain a Cisco EMF License

Task 6: Make System Modifications

Setting Up IP and Remote User Access Information

Task 7: Install CiscoView 5.4

Task 8: Install Cisco EMF 3.2

Installing Cisco EMF Patches

Installing the Cisco EMF SSH Add-On Package

Starting Cisco EMF

Task 9: Install Cisco MGC Node Manager 2.6(1) and Verify the Installation

Installing Cisco MGC Node Manager

Verifying the Installation

Verifying Element Managers

Verifying the Installation of CiscoView 5.4

Starting Cisco MGC Node Manager

Getting Started with Secure Communications on Cisco MGC Node Manager

Task 10. Install the CiscoView Security Module

Task 11: Set Up the X Terminal Workstations for Remote Access

Creating an XDMCP Connection

Creating a Workstation Connection

Fixing the Insufficient Colors Problem

Task 12. Synchronize Time

Task 13: Configure Network Devices to Forward Alarms

Upgrading from Previous Cisco MGC Node Manager Versions

Backing Up Your Databases

Uninstalling the Cisco MGC Node Manager Software

Verifying Uninstallation of Cisco MGC Node Manager

Displaying Current CMNM Packages

Viewing Help for CMNM Install Scripts

Uninstalling Cisco EMF

Troubleshooting Common Installation Problems

Installing Cisco MGC Node Manager

This chapter provides detailed instructions for these installation tasks:

•Performing a New Installation of the Cisco MNM

•Upgrading from Previous Cisco MGC Node Manager Versions

•Uninstalling the Cisco MGC Node Manager Software

•Uninstalling Cisco EMF

•Troubleshooting Common Installation Problems

Before you begin

•Read the Installation Overview

•Determine Your Hardware Requirements

•Print the Installation Checklist and use it to guide your installation.

Performing a New Installation of the Cisco MNM

Task 1: Gather Installation Software and Required Information

This section describes the software and information you should have on hand before you begin installation.

Installation Software

Cisco MGC Node Manager and Provisioning Tool Software

Your order of Cisco MGC Node Manager includes this software:

•Cisco MGC Node Manager 2.6(1), including:

–The Cisco MGC Node Manager element managers that work with Cisco EMF

•Cisco Element Management Framework (Cisco EMF) 3.2. The software includes ObjectStore 5.1 Service Pack 7 and 7.1, which provides database management.

–Go to http://www.cisco.com/pcgi-bin/tablebuild.pl/cemf-sp32-sp1 for the latest Cisco EMF 3.2 software (at least Service Pack 7) and the patch Release Note (an Acrobat PDF file such as CEMF3.2P7DepRelNote.pdf). For overall version 3.2 Release Notes, go to http://www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/cemf/3_2sp7/notes/index.htm

–If you want to use SSH for secure communications with SSH-enabled network components, also download the cryptographic add-in package available from the network management download page http://www.cisco.com/public/sw-center/sw-netmgmt.shtml under Cisco Element Management Systems - CEMF Strong Cryptographic Software. Download both the CEMF Crypto Add-on Package Software and the CEMF Crypto Add-on Package Installation Guide. You must have authorization to download cryptographic software; if you do not, you are automatically redirected to an authorization request page.

•Cisco documentation, including:

–Netscape, for displaying Help for browser-based management

–Cisco MGC Node Manager User's Guide

–Cisco Documentation CD

•CiscoView 5.4 (unbundled from the Cisco MGC Node Manager installation). Install CiscoView if you want to manage Cisco SLTs or Cisco LAN switches (Cisco MGC Node Manager will use the CiscoView server as the management interface). CiscoView should be installed before installing Cisco EMF and Cisco MGC Node Manager.

•The Cisco MGC Node Manager Provisioning Tool (formerly the Voice Services Provisioning Tool). The Provisioning Tool version must match your version of the Cisco MGC software. If you are managing nodes with Cisco MGC hosts running different software versions, you can install multiple Provisioning Tool versions. Cisco MGC Node Manager automatically launches the correct version for the currently selected host.

For the latest VSPT patch, go to http://www.cisco.com/pcgi-bin/tablebuild.pl/mgc-nm.

For the Cisco MGC Node Manager Release Notes 2.6.1 , go to http://www.cisco.com/en/US/products/sw/netmgtsw/ps1912/prod_release_note09186a00802c8ce3.html

X Terminal Software

To access Cisco MGC Node Manager from a remote workstation, you should have Reflection 7.2 or above installed. See the "Task 11: Set Up the X Terminal Workstations for Remote Access" section for information about X terminal access.

Solaris 8 Operating System

The machines that will run Cisco MGC Node Manager should have the Sun Solaris 8 operating system with Common Desktop Environment (CDE) 1.3 installed.

Caution The Solaris Language setting must be English and the Locale setting must be English (C-7 bit ASCII). Other Language and Locale choices are not supported.

Required Information

This chart lists information helpful to have before you begin installation. Complete the chart and have it available as you work through the installation tasks.

Table 2-1

Information

Where To Find It

Value

Superuser (su) password and privileges

Your UNIX system administrator

Host name and host ID of the machine where Cisco EMF will be installed (in a distributed configuration, the Management server)

On the machine, enter hostname at the command prompt. The host name displays.

At the command prompt, enter hostid. The host ID displays. This is a hexadecimal string that identifies the system, not the IP address.

Hostname:

Host ID:

Host IP address of that machine

At the command prompt, enter host.

If there are multiple interfaces, select the IP address of the interface where traps will be forwarded (as specified when you configure devices for network management; refer to the Cisco MGC Node Manager User's Guide at http://www.cisco.com/en/US/products/sw/netmgtsw/ps1912/products_user_guide_list.html, Chapter 3.

Product Authorization Key for Cisco EMF, to be used in Task 6

On the Cisco EMF product CD sleeve.

DNS Domain of the machine where Cisco EMF will be installed (in a distributed configuration, the Management server) if your network uses DNS

Your UNIX system administrator

IP address of CiscoView server, required when you install Cisco MGC Node Manager

IP address

Required Information

Task 2: Ensure That Network Devices Have the Correct Software

Cisco MGC Node Manager interacts with other software running on the various components of the Cisco MGC node. A potential cause of network management problems, such as failure to discover a device during deployment, is a mismatch between the software on the device and the version or patch compatible with Cisco MGC Node Manager. The software requirements for these components are described in Table 2-2.

Caution Upgrades are released frequently. To be sure that you have any necessary software patch, check the Web site for the latest bulletins and upgrades.

Table 2-2 Required Software Versions for Cisco MGC Node Devices

External Software

Version

Where To Check for Upgrades

Cisco MGC host software

7.4.12 and 9.x through 9.6(1)

For upgrades to the PGW 2200:
Go to the Software Center Voice Software download page at http://www.cisco.com/public/sw-center/sw-voice.shtml. (You will be asked to log in.) On that page, go to Cisco PGW 2200 Node Components - Cisco Media Gateway Controller and click on the desired version.

For installation documentation and release notes:

Version 9:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/

Version 7: http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel7/

Cisco SLT IOS SS7 image

12.1(x), 12.2(x)

For upgrades:
http://www.cisco.com/pcgi-bin/Support/PSP/psp_view.pl?p=Hardware:2600&s=Software_Installation#Software_Features_%26_Versions

For installation documentation and release notes:

http://www.cisco.com/univercd/cc/td/doc/product/access/sc/slt/index.htm

Cisco LAN Switch code

5.x or higher

For upgrades:
http://www.cisco.com/public/sw-center/sw-lan.shtml

BAMS

2.63, 2.64, 2.65, 2.67i, 2.68, 3.08, 3.10, 3.12, 3.13

For installation documentation and release notes:
http://www.cisco.com/en/US/products/sw/voicesw/ps522/prod_technical_documentation.html

HSI server

2.21 (backward compatible with 2.20)

For installation documentation:
http://www.cisco.com/en/US/products/sw/voicesw/ps1913/products_user_guide_book09186a0080116d4d.html

Cisco ITP IOS SS7 image

12.2(4)

For configuration documentation:
http://www.cisco.com/en/US/products/sw/iosswrel/ps5012/prod_ios_releases_home.html

Task 3: Plan and Execute Hard Drive Partitioning

By default, the Cisco EMF software is installed with the ObjectStore database configured for standard UNIX cooked partitions (partitions with readable directory structures). However, we recommend using raw partitions (partitions without a readable directory structure) for the database drives for larger networks because they offer these advantages over cooked partitions:

•The capability of having databases over 2 GB in size

•The ability to store database files across multiple drives

Refer to the Cisco Element Management Framework Installation and Configuration Guide for a description of raw versus cooked partitions and for instructions for partitioning your hard drives.

Task 4: Ensure That the Sun Solaris 8 Operating System Is Installed

Cisco MGC Node Manager machines should have the Sun Solaris 8 operating system with CDE 1.3 installed. The operating system installation script is provided by the hardware manufacturer.

If the Sun Solaris 8 operating system is not already installed, install it according to instructions provided by the manufacturer.

Install the latest J2SE Solaris 8 patch cluster, which can be found at the following URL:

http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

When the Solaris operating system is installed, go to Task 3: Plan and Execute Hard Drive Partitioning.

Note Please check that Solaris 8 is installed on your Sun hardware. Sun hardware is typically shipped with Solaris 2.7.

Task 5: Obtain a Cisco EMF License

You need a valid license key file available on the system to start Cisco EMF. In a distributed configuration, the license key is required on the Management server.

Refer to the Cisco EMF Installation and Configuration Guide at:
http://www.cisco.com/en/US/products/sw/netmgtsw/ps829/products_installation_and_configuration_guide_book09186a00801a8e04.html

Task 6: Make System Modifications

Two kinds of system modifications are necessary after you have installed the Solaris operating system and set up disk drives:

•Setting up IP and remote user access information, described below

•Checking and, if needed, configuring DNS. Refer the Cisco EMF Installation and Configuration Guide at: http://www.cisco.com/en/US/products/sw/netmgtsw/ps829/products_installation_and_configuration_guide_book09186a00801a8e04.html

Setting Up IP and Remote User Access Information

After you have installed Solaris and added all hard drives, you will need to edit some files on the Management server that contain data for IP networking and remote user access.

Table 2-3 IP Networking and Remote User Access Files

File

Modification

/etc/defaultrouter

Add the host name and IP address of the default gateway router that provides network access between remote users, network devices, and the standalone system or the Management server.

/etc/default/login

Add a # symbol at the front of the line that says CONSOLE = /dev/console to comment out the line. If you do not comment out this line, users will not be able to login to the machine remotely.

/etc/default/login

Add the login accounts for all users that will be accessing the server by Telnet.

/etc/hosts

Add the Presentation server's host information.

Task 7: Install CiscoView 5.4

CiscoView is a graphical device management tool based on the Simple Network Management Protocol (SNMP) that provides real-time views of networked Cisco devices. Cisco MGC Node Manager uses CiscoView to configure and monitor the Cisco SLT and the LAN switch (Cisco Catalyst 2900, 5500, and 6509) devices through a CiscoView server.

CiscoView is optional; install it only if you want to manage the Cisco SLT or LAN switches from Cisco MGC Node Manager.

You install CiscoView before installing Cisco MGC Node Manager 2.6(1) so that you can identify the CiscoView server IP address that must be entered when you install Cisco MGC Node Manager. CiscoView may be installed locally on the Cisco MGC Node Manager workstation, or on a remote server.

Step 1 Install CiscoView 5.4 from the Cisco MGC Node Manager fourth CD. For CiscoView installation details, refer to the CiscoView 5.4 Installation and Setup Guide at http://www.cisco.com/en/US/products/sw/cscowork/ps4565/products_installation_guide_book09186a00800e19f6.html.

Step 2 Write down the CiscoView server IP address, which will be needed in Task 9 when you install Cisco MGC Node Manager.

Note CiscoView must use the default port number, 1741. Do not modify this port number during installation.

Note If you are using CiscoView, also make sure to install the CiscoView security module, after installing Cisco MGC Node Manager. See the "Task 10. Install the CiscoView Security Module" section.

About Client Workstation Software

Client workstations must have Java 1.3 and Netscape 4.76 installed to use CiscoView as a client. (Other browsers may work but have not been verified.) Netscape 4.76 is installed with Cisco EMF. The correct version of Java 1.3 is packaged with CiscoView. When you launch the CiscoView server the first time, you will be prompted to download and install the Java 1.3.1 version bundled with the plugin-131-sparc.tar CiscoView server. Follow the instructions displayed to download and install this plugin.

To use the CiscoView server, we also recommend that you install the latest J2EE Solaris patch cluster which can be found at the following URL:

http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

Task 8: Install Cisco EMF 3.2

For basic installation, follow the procedure described in Chapter 2 of the Cisco EMF Installation and Configuration Guide at:

http://www.cisco.com/en/US/products/sw/netmgtsw/ps829/products_installation_and_configuration_guide_chapter09186a00801a8e14.html

For a management server, choose Server Installation. For a presentation server (a client), choose Remote Client Installation. You do not need a license on a client machine.

After installing the base 3.2 version, go on to "Installing Cisco EMF Patches" section. If you are using SSH for secure communications with SSH-enabled network components, continue with Installing SSH. Finally, start the Cisco EMF Server, as described in "Starting Cisco EMF" section.

Installing Cisco EMF Patches

Cisco MGC Node Manager requires Cisco EMF Service Pack 7 and 7.1. Refer to the Release Notes to check on any additional patches required.

To install Service Pack 7 and 7.1, follow these steps:

Step 1 Determine your current Cisco EMF version and patch level:

cemf install -show

Step 2 Go to the following URL:

http://www.cisco.com/pcgi-bin/tablebuild.pl/cemf-sp32-sp1

Step 3 Download CEMF 3.2 Service Pack 7 software, CEMF3.2P7.tar.Z, to a directory on your hard drive.

Step 4 Download and read the CEMF 3.2 Service Pack 7 Release Note, CEMF3.2P7DepRelNote.pdf.

Step 5 Download CEMF 3.2 Service Pack 7.1 software, CEMF3.2P71.tar.Z, to a directory on your hard drive.

Step 6 Download and read the CEMF 3.2 Service Pack 7.1 Release Note, CEMF3.2P71DepRelNote.pdf.

Step 7 Follow the patch installation instructions in the Release Note and in the Cisco EMF Installation and Configuration Guide at the following location:

http://www.cisco.com/en/US/products/sw/netmgtsw/ps829/products_installation_and_configuration_guide_book09186a00801a8e04.html

Installing the Cisco EMF SSH Add-On Package

To enable SSH support on Cisco MGC Node Manager, you install the CEMF strong cryptographic add-on package.

Note We recommend installing SSH on Cisco MGC Node Manager and Cisco VSPT before installing it on the Cisco PGW, so that you can use the element managers to monitor the installation process on the PGW and other managed components.

Step 1 Download the CEMF Crypto Add-on Package Software and the CEMF Crypto Add-on Package Installation Guide available from the network management download page http://www.cisco.com/public/sw-center/sw-netmgmt.shtml under Cisco Element Management Systems - CEMF Strong Cryptographic Software. You must have authorization to download cryptographic software; if you do not, you are automatically redirected to an authorization request page.

Step 2 Follow the installation instructions in the CEMF Crytpo Add-on Package Installation Guide.

Note Make sure the entry of SSH exits in the /etc/services (on the machine where the MNM is installed).

Caution Using # character in the /etc/motd banner may cause problems in the SSH connectivity as these #'s interfere in the expect scripts used in the MNM. In case you face problem using SSH with CEMF Crypto Add-on package installed and the SSH entry in the /etc/services file, please try removing your motd banner.

Starting Cisco EMF

Start Cisco EMF as described in the following procedure:

Step 1 Log in to the system where you installed Cisco EMF, and enter su - root to become the root user.

Step 2 Change the working directory to CEMF bin by entering:

cd <CEMF_ROOT>/bin

Where <CEMF_ROOT> is the directory where Cisco EMF is installed.

Step 3 If the Cisco EMF background processes are not already running, enter:

./cemf start

Note Depending on your server, it may take 10-30 minutes for the Cisco EMF startup processes to complete, with relatively longer startup if your database is new or has been reset.

Task 9: Install Cisco MGC Node Manager 2.6(1) and Verify the Installation

Follow these instructions to install Cisco MGC Node Manager. If you are upgrading from Version 1.5 or 2.x, see the "Upgrading from Previous Cisco MGC Node Manager Versions" section.

Identify any necessary patches by checking the location given in the "Installation Software" section.

Note You must install the Cisco MGC Node Manager software as root.

Follow the procedure below to install Cisco MGC Node Manager on a standalone system or on both machines (Management server and Presentation server) in a distributed configuration. The Cisco MGC Node Manager installation process automatically detects if the Cisco EMF complete software is installed, or only the Cisco EMF Client, and then installs the correct Cisco MGC Node Manager component.

Note If you are installing another element manager to run co-resident with Cisco MGC Node Manager, this is also the point in the installation sequence at which it should be installed. See the Release Notes for Co-Residence (of Cisco MGC Node Manager and another EMS) at http://www.cisco.com/en/US/products/sw/netmgtsw/ps1912/prod_release_notes_list.html.

Installing Cisco MGC Node Manager

Step 1 Make sure that Cisco EMF is running.

Step 2 Type cd <CEMF_ROOT>/bin, and enter the following command to verify that Cisco EMF is running:

>./cemf query

Cisco EMF should display the following message:
CEMF Manager 3.2 initialized
Step 3 If you are not already logged in as root, change the user to root user by entering su - root .

Step 4 Verify that the Volume Management daemon is running:

Enter the command ps -ef | grep vold. If the daemon is running, you see the following output:

root 363 1 0 May 23 ? 0:01 /usr/sbin/vold

If the daemon is running, go on to Step 5. If the daemon is not running, start the daemon using the following command:

/etc/init.d/volmgt start

Verify that the Volume Management daemon is running with the command provided above. If it is still not running, contact your system administrator.

Step 5 Place the Cisco MGC Node Manager installation media into the CD-ROM drive.

Step 6 Enter cd /cdrom/cscocmnm.

Step 7 Enter ./cmnminstall

The Install Package opens and displays the following options:
1)	CMNM    V.2.5.2 Package	
q)	Quit
Existing installations of any of the installation software are detected and are listed as "Already Installed".

Note To upgrade to the next version of MGC Node Manager, enter ./cmnminstall -u

Step 8 Enter 1 to install Cisco MGC Node Manager 2.6(1).

The installation process begins. During installation, you are asked for various kinds of input, summarized here:

•CiscoView Server IP address—Enter the IP address of the CiscoView server installed in Task 7. If you are not using CiscoView, just press Enter.

•Logfile directory location—Press Enter to accept the default location /var/tmp or type another location and press Enter.

•Logfile name—Press Enter to accept the default name CSCOcmnm.log, or type another name and press Enter.

After checking that disk space is sufficient, the Install Package asks if you want to continue with the installation.

Step 9 Enter y to proceed with installation. The process typically takes from 15-40 minutes depending on your system.

When installation is complete, this message appears:
Everything appears to be installed correctly.
Go on to verify the installation.

Note If installation is not successful, check the installation log which by default is /var/tmp/installCSCOcmnm.log.

Verifying the Installation

Verify that Cisco MGC Node Manager and CiscoView are installed properly before starting Cisco MGC Node Manager.

Verifying Element Managers

Step 1 Verify that the Cisco MGC Node Manager Package is installed using the following command:

pkginfo CSCOcmnm

The following message should appear:

application CSCOcmnm Cisco MGC-Node Manager(cmnm)2.6

Step 2 Verify that the Cisco MGC Node Manager Element Managers have been installed. Run the following script to display the installed Cisco MGC Node Manager Element Managers and compare this with the list in the table below.

Cisco EMF Basedir/bin/cmnmversion -verbose
CSCOcmnm Tool Versions
                      Patch Build  Build
         Name Version Level  Num   Type
    ------------------------------------
     CSCOcmnm 2.6.1(1)    00  110204 DEV  
     CSCOcmcv  2.6.1                    
     CSCOcmhp  2.6.1    00              
     CSCOcemfm    3.2 Patch: 170007-06
                      Patch: 190701-05
     ------------------------------------
CSCOcmnm Element Manager Versions
                      Patch Build  Build
         Name Version Level  Num   Type
    ------------------------------------
       hostEMm 2.6.1    00   110204 DEV  
       mgcEMm 2.6.1    00   110204 DEV
    ------------------------------------
Note Specific information displayed from running this script varies according to the cmnm release and patch you are using.

Table 2-4 Element Managers

mgcEM

Common Element Manager for Cisco MGC node devices

hostEM

Element Manager for Cisco MGC host signaling, trunking, and dial plan components

Note If you suspect problems in installation, check the installation log file (which by default is /var/tmp/installCSCOcmnm.log) to determine specifics.

Verifying the Installation of CiscoView 5.4

Verify the installation of CiscoView 5.4 by entering the following command:

./cmnmupdateCVip -s

•If the package is installed, you see the following:
Current Ciscoview IP Address: 10.10.10.10
where 10.10.10.10 is the server IP address.

•If the package is not installed, you see the following:
ERROR: information for "CSCOcmcv" was not found
CiscoView is designed to work with CiscoWorks 2000. When installing CiscoView packages outside this environment, certain functions are not supported. The following CiscoView buttons do not work in the Cisco MGC Node Manager environment:

•Telnet

•CCO connection

•Preferences

•About

•Help

Note When running xdsu, the following exception is generated and can be ignored:

ERROR: exception occurred while examining Integration Utility configuration: com.cisco.nm.nmim.nmic.IntgUtilCheckConfig

Changing the IP Address of the CiscoView Server If Needed

When you install Cisco MGC Node Manager, you fill in the IP address of the CiscoView server. If you need to change the IP address of the CiscoView server after Cisco MGC Node Manager is installed, enter the following command from the Cisco EMF base directory:

/cmnmupdateCVip -i <new CiscoView IP address>

Information similar to the following is displayed:
cmnm CiscoView Server IP Addresses changed
From: <old IP address>
To  : <new IP address>
Starting Cisco MGC Node Manager

Step 1 Have Cisco EMF running.

Step 2 Log in with your user ID.

Step 3 Change directory to the Cisco EMF directory. For example:

cd /opt/cemf/bin

Note An X-server must be running, and the DISPLAY environment variable must be properly configured. Use one of the following commands, depending on which shell you are using, to set the x-display variable.

In "csh" or "tcsh": setenv DISPLAY <hostname>:0
In "sh" or "ksh": DISPLAY=<hostname>:0;export $DISPLAY

Step 4 Enter:

./cemf session

Step 5 When prompted, enter your login name and password:

Note The default Cisco MGC Node Manager login and password are admin. Use the login and password configured for your system.

Refer to the Cisco MGC Node Manager User's Guide at http://www.cisco.com/en/US/products/sw/netmgtsw/ps1912/; Chapter 3, "Getting Started with Cisco MGC Node Manager" for help on navigation and basic operations.

If you are using SSH for secure communications with SSH-enabled network devices, go on to the next section, Getting Started with Secure Communications on Cisco MGC Node Manager.

Getting Started with Secure Communications on Cisco MGC Node Manager

This section describes how to enable secure communications on network devices managed with Cisco MGC Node Manager.

Before you begin: You must have installed the Cisco EMF strong cryptographic add-on package in Task 8 and you must know the security policy for the elements you are enabling. (Secure communications are enabled on the network elements directly, not using Cisco MGC Node Manager. See the component SSH installation documentation, such as http://www.cisco.com/univercd/cc/td/doc/product/access/sc/rel9/mgcfm/ for the Cisco PGW 2200 Release 9.6(1).) You do not need to know the specific SSH version; Cisco MGC Node Manager automatically negotiates the correct SSH version, SSH 2 if available or SSH 1.x..

Do you have existing (already deployed in Cisco MGC Node Manager) network elements that are now SSH-enabled? See "To Update Existing SSH-Enabled Network Elements" section.

Do you want to deploy new network elements that are SSH-enabled? See "To Deploy New SSH-Enabled Elements" section.

To Update Existing SSH-Enabled Network Elements

Use this procedure to set SSH as the security policy for network elements that are already deployed and have SSH enabled.

Step 1 In the Map Viewer, select the SSH-enabled element you want to update.

Step 2 Right-click and choose Tools > Accounts. The Accounts dialog box appears.

Step 3 For Security Policy, select SSH. (None is the default.)

Step 4 Click Save.

Step 5 Repeat the above steps for the remaining SSH-enabled elements.

To Deploy New SSH-Enabled Elements

Use this procedure to deploy new elements that have been SSH-enabled.

Step 1 In the Deployment Wizard template, for Security Policy select SSH. Enter other information as usual.

Step 2 Click Finish.

Cisco MGC Node Manager discovers the element using the appropriate SSH protocol. Non-SNMP communication with the element will now use SSH secure utilities.

To Identify SSH-Enabled Elements

You can identify whether an element uses SSH by checking the Security Policy in its Accounts dialog box.

Task 10. Install the CiscoView Security Module

If you are using CiscoView, the CiscoView Security Module must be installed on the CiscoView server after CiscoView and Cisco MGC Node Manager have been installed.

Step 1 Determine the IP address Cisco MGC Node Manager is using for the CiscoView server. For example, if Cisco EMF is installed in /opt/cemf, enter:

- /opt/cemf/bin/cmnmupdateCVip -showip

Note An IP address of "0.0.0.0" is the local workstation.

Note If the address is not correct, see "Changing the IP Address of the CiscoView Server If Needed" section for how to change it.

Step 2 Locate the CSCOcvsec.pkg that is shipped with the Cisco MGC Node Manager software and resides in the ciscoviewsecurity directory:

- cd ciscoviewsecurity

If the CiscoView server is not installed on Cisco EMF server, go on to Step 3. If the CiscoView server is installed on the Cisco EMF server, skip to Step 4.

Step 3 Use ftp to copy the CSCOcvsec package to the CiscoView server using the CiscoView server IP address you determined with the cmnmupdateCVip command.

- ftp cvserverIPAddress

cd /tmp

binary

put CSCOcvsec.pkg /tmp/CSCOcvsec.pkg

Telnet (or SSH) to the CiscoView server:

- telnet cvserver

You are now ready to install the package.

Step 4 Change user to "root" user, (if not already "root"):

- su - root

Step 5 Install the package:

- /usr/sbin/pkgadd -d /tmp/CSCOcvsec.pkg

Note If you uninstall and reinstall Cisco MGC Node Manager, you must reinstall the security package.

Task 11: Set Up the X Terminal Workstations for Remote Access

You can access Cisco MGC Node Manager remotely from a workstation or PC. Cisco MGC Node Manager has been tested with the Reflection 7.20 X server software package.

Creating an XDMCP Connection

For Reflection software to display Cisco MGC Node Manager correctly, Reflection software must be run in XDMCP mode. For host name, use the name of the Presentation server (in a distributed configuration) or of the standalone system.

Step 1 Start Reflection.

Step 2 From the Connection menu, select New XDMCP Connection.

Step 3 From the Method pull-down menu, select Broadcast or Direct, and continue with one of the following set of steps:

For Broadcast method:

a. Click Connect.

b. Select the appropriate XDMCP computer. If you do not know which computer to select, contact your system administrator.

For Direct method:

a. In the Host Name field, enter the host name of an XDMCP computer.

b. Click Connect.

An X terminal window opens on the host machine. Start Cisco MGC Node Manager in the usual manner, as described in the "Starting Cisco MGC Node Manager" section.

Note If the Cisco EMF Launchpad displays but appears to be inactive, check for a message box behind the Launchpad reporting that there are insufficient colors available for Cisco EMF Manager. You can safely ignore the message (and close the message box), or remedy the problem as described in the next section.

Creating a Workstation Connection

Use the following procedure to connect to Cisco MGC Node Manager from a remote UNIX workstation:

Step 1 Open an X-terminal window.

Step 2 Use Telnet to connect to the Cisco MGC Node Manager host.

Step 3 Enter the following command to change to the Cisco MGC Node Manager directory:

#cd /opt/cemf/bin

Step 4 Enter the following command to launch Cisco MGC Node Manager:

#./cemf session

Fixing the Insufficient Colors Problem

To fix the "... insufficient colors available for Cisco EMF Manager" problem, refer to the procedure in "Configuring Reflection X Version 7.20 to Support Cisco EMF Color Usage" in the Cisco EMF Installation and Configuration Guide at: http://www.cisco.com/en/US/products/sw/netmgtsw/ps829/products_installation_and_configuration_guides_list.html

Task 12. Synchronize Time

After installing Cisco MGC Node Manager, you should synchronize the time configured for the Cisco MGC, Cisco MGC Node Manager, and the Billing and Measurement Server (BAMS). To ensure that Cisco MGC Node Manager records are correct, these components should all be configured to Greenwich Mean Time (GMT). Refer to the Cisco Media Gateway Controller Software Release 9 Software Installation Guide and the Billing and Measurement Server User's Guide for your BAMS server for information about setting the time for these components.

Task 13: Configure Network Devices to Forward Alarms

A final task in readying Cisco MGC Node Manager for network management is to configure the devices in the network so that they send alarm information to Cisco MGC Node Manager. For details, refer to Chapter 3 in the Cisco MGC Node Manager User's Guide at http://www.cisco.com/en/US/products/sw/netmgtsw/ps1912/products_user_guide_list.html.

Note Migration from Cisco MGC Node Manager Release 1.5 to Cisco MGC Node Manager Release 2.6(1) is not supported. Performance and alarm data cannot be migrated to Cisco MGC Node Manager Release 2.6(1). The only recommended alternative is to create a seed file, which can be used for manual discovery.

Upgrading from Previous Cisco MGC Node Manager Versions

If you are upgrading from a previous version of Cisco MGC Node Manager, the installation upgrade option installs Cisco MGC Node Manager Version 2.6(1) and leaves your data intact (for example, network data and user access settings). You do not need to uninstall your previous version before upgrading.

Note Cisco MGC Node Manager 1.5 uses Cisco EMF 3.1. Cisco MGC Node Manager 2.6(1) and previous 2.x versions use Cisco EMF 3.2.

Although the upgrade option preserves your data, we recommend that you perform a backup before upgrading, as described in the "Uninstalling the Cisco MGC Node Manager Software" section.

Perform the following steps to upgrade from a previous Cisco MGC Node Manager version:

Step 1 Check the "Installation Checklist" section to identify any other tasks needed for the upgrade.

Step 2 Have Cisco EMF and Cisco MGC Node Manager running. Change to the <cemf_root>/bin directory and enter ./cemf query to check the current version.

Step 3 If you are not already logged in as root, change user to root user by enter the following command
su - root

Step 4 Verify that the Volume Management daemon is running:

Enter the command ps -ef | grep vold. If the daemon is running, you see the following output:

root 363 1 0 May 23 ? 0:01 /usr/sbin/vold

If the daemon is running, go on to Step 5. If the daemon is not running, start the daemon using the following command:

/etc/init.d/volmgt start

Verify that the Volume Management daemon is running with the command provided above. If it is still not running, contact your system administrator.

Step 5 Place the Cisco MGC Node Manager installation CD into the CD-ROM drive and enter cd /cdrom/cscocmnm.

Step 6 Back up your database (see the "Uninstalling the Cisco MGC Node Manager Software" section).

Step 7 Start Cisco MGC Node Manager and in the Map Viewer remove the MGX objects in the MGX-8260-View (refer to the Cisco MGC Node Manager User's Guide, Chapter 5, "Modifying or Deleting Deployed Objects" at http://www.cisco.com/en/US/products/sw/netmgtsw/ps1912/products_user_guide_list.html).

Step 8 Close Cisco MGC Node Manager.

Step 9 Install CEMF 3.2 Patch 6 and any later patches specified in the Release Notes.

Step 10 Enter either of the following commands:

cmnminstall -u

Or

cmnminstall -upgrade

The installation begins. During installation, you are asked for various kinds of input, summarized here:

•Logfile directory location—Press Enter to accept the default location /var/tmp or type another location and press Enter.

•Logfile name—Press Enter to accept the default name CSCOcmnm.log, or type another name and press Enter.

Step 11 When the installation is complete, verify it according to the instructions in the "Verifying the Installation" section.

Step 12 After the upgrade completes, start Cisco MGC Node Manager and do the rediscover the following objects:

•All BAMS objects, using the Map Viewer BAMS-View

•All HSI objects, using the Map Viewer HSI-View

Note During the upgrade process, you may see error messages caused by Cisco EMF trying to create controllers that already exist. These messages may safely be ignored.

Backing Up Your Databases

If you are upgrading from Cisco MGC Node Manager 1.5, you must back up your databases. If you are upgrading from Cisco MGC Node Manager 2.x, the upgrade process retains your databases, but it is nonetheless good practice to back up your databases before upgrading. For more details, see the Cisco EMF Installation and Configuration Guide.

Uninstalling the Cisco MGC Node Manager Software

Cisco EMF must be running to uninstall Cisco MGC Node Manager. Use the following procedure to uninstall the Cisco MGC Node Manager software:

Step 1 If Cisco MGC Node Manager is open, close it. Do not stop Cisco EMF.

Step 2 Enter either of the following commands:

cmnminstall -r

Or

cmnminstall -remove

Information similar to the following will be displayed:

----------------------------------------------------------------------

Cisco MNM Uninstallation

Wed Dec 15 09:56:16 AM

----------------------------------------------------------------------

Step 3 When prompted, verify that you want to uninstall Cisco MGC Node Manager. The following message is displayed:

Have your databases been backed up [y/n]: [n] y

Step 4 Enter y. You cannot uninstall Cisco MGC Node Manager unless you answer y.

Step 5 When prompted, enter the log file directory location and the logfile name. The following message is displayed:

Continue with CSCOcmnm uninstall [y,n,?] y

Step 6 Enter y, and Cisco MGC Node Manager is uninstalled.

Verifying Uninstallation of Cisco MGC Node Manager

After uninstalling Cisco MGC Node Manager, you should verify the uninstallation. Use the following procedure to verify that the Cisco MGC Node Manager package is not installed:

Step 1 Enter pkginfo CSCOcmnm.

The following message should appear:

ERROR: information for "CSCOcmnm" was not found

Step 2 Enter pkginfo | grep EM to verify that no Cisco MGC Node Manager Element Managers are installed.

The following message should appear:

ERROR: information for "CSCOcmcv" was not found

Cisco MGC Node Manager is uninstalled.

Displaying Current CMNM Packages

For displaying the current CMNM Packages, do the following:

Step 1 Login as"root":

Step 2 Enter either cmnminstall -s or cmnminstall -show.

This command displays all the current CMNM Packages.

Viewing Help for CMNM Install Scripts

For viewing the help content for the current CMNM Packages, do the following:

Step 1 Login as"root":

Step 2 Enter either cmnminstall -h or cmnminstall -help.

This command displays all the current CMNM Packages.

Uninstalling Cisco EMF

You must uninstall Cisco MGC Node Manager before uninstalling Cisco EMF. When Cisco EMF is deinstalled, all Cisco EMF processes are automatically stopped. If ObjectStore was installed as part of the Cisco EMF installation, it is removed during uninstallation. If ObjectStore was installed as a separate package before the Cisco EMF installation, ObjectStore still remains installed after Cisco EMF is deinstalled.

Use the following procedure to uninstall Cisco EMF:

Step 1 As a superuser (su), log in to the machine where Cisco EMF is installed.

Step 2 Ensure that Cisco MGC Node Manager has been deinstalled.

Step 3 At the command line prompt, enter the following command to change to the Cisco EMF bin directory:

cd /opt/<CEMF_ROOT>/bin

Step 4 At the command line prompt, enter:

./cemfinstall -remove

Step 5 Choose an option from the menu.

For more details, see the Cisco Element Management Framework Installation and Configuration Guide at http://www.cisco.com/en/US/products/sw/netmgtsw/ps829/products_installation_and_configuration_guides_list.html.

Troubleshooting Common Installation Problems

Carefully following the "Installation Checklist" section, will avoid most installation pitfalls. If a problem does occur, check this section for troubleshooting guidelines.

Related Topics

Cisco MGC Node Manager User's Guide, Appendix C, "Troubleshooting Cisco MGC Node Manager".

"Problems Installing an Element Manager on Cisco EMF" in the Cisco Element Management Framework Installation and Configuration Guide.

Problem

Suggested Steps

You get the message, "Cannot connect to session" when you try to start a Cisco MGC Node Manager session.

Make sure that Cisco EMF is running.

•If Cisco EMF is not running, start it; then retry starting Cisco MGC Node Manager.

•If Cisco EMF is running, check to see if the IP address or host name of the Cisco MGC Node Manager server has changed since Cisco MGC Node Manager was installed. If so, follow the steps described for the next problem.

You get the message, "System IP address does not match databased address" when you try to start Cisco EMF.

This may be caused by a change in the IP address or host name of the Cisco MGC Node Manager server after Cisco MGC Node Manager was installed. To correct the problem:

1. Stop Cisco EMF:

/opt/cemf/bin/cemf stop

2. If needed, update the IP address in Cisco EMF:

/opt/cemf/bin/cemf updateIP -m

You are prompted for the new IP address. Enter the new IP address.

3. If needed, update the host name in Cisco EMF:

/opt/cemf/bin/cemf updateName -m

You are prompted for the new host name. Enter the new name.

4. Restart Cisco EMF.

/opt/cemf/bin/cemf start

Note If the Management server address or name has changed in a distributed configuration, make the necessary changes on both the Management server and the Presentation server. If the Presentation server address or name has changed, make the changes on the Presentation server only.

Password problems

Reset the password.

License challenges

Verify that:

•The license file has a .lic extension

•The license file is present in the /opt/CSCOcemf/license directory.

•The license has not expired. If it has, get a new license at http://cco.cisco.com/kobayashi/sw-center/sw-registration.shtml. For instructions, see Task 4: Ensure That the Sun Solaris 8 Operating System Is Installed.

•The license is a multi-user license.

•The license file was not issued for a different machine. The license is machine-specific; you cannot move a license file from one machine to another but must get a new license for your current machine.

Uninstallation problem

Make sure you are uninstalling in the correct sequence. Before uninstalling Cisco EMF, you must uninstall Cisco MGC Node Manager. Before uninstalling Cisco MGC Node Manager, make sure that Cisco EMF is running.

Troubleshooting Installation Problems