cc/td/doc/product/dsl_prod/6700
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Installing EMS

Installing EMS

This section provides instructions for installing the element management system (EMS) software on a user workstation.

The following three components make up EMS:


Note   You must close any open applications on the workstation before installing EMS. Cisco Systems recommends that you reboot the workstation before installing EMS.

System Requirements

The EMS workstation must have an Ethernet port to communicate with the NE. lists the minimum system requirements for each supported operating system:
Table 2-1:
Operating System Platform RAM Disk Space

Windows 951

166 MHz Pentium-class CPU

32 MB (64 MB recommended)

100 MB (1 GB recommended)

Windows NT (with Service Pack 3)

233 MHz Pentium-class CPU

128 MB

1 GB

UNIX (Solaris 2.5 or 2.6)

Ultra 5 or greater

128 MB

1 GB

1Windows 95 workstation must use EMS Lite, which does not offer alarm server or network configuration server applications.
s

Installing EMS for Windows NT

To install EMS on a Windows NT workstation:


Step 1   Close all applications and reboot the workstation.

Step 2   Insert the EMS CD into your CD-ROM drive.

Step 3   Locate the EMS-nt.exe icon on the CD and double-click it.

Step 4   Follow the prompts to install EMS.

Step 5   When prompted for the alarm server IP address, enter the IP address of the EMS alarm server. Contact your EMS administrator for the correct IP address.

Step 6   When prompted for the network configuration server IP address, enter the IP address of the EMS network configuration server, or leave this field blank if you will not use the network configuration server. Contact your EMS administrator for the correct IP address.


Note   If you are upgrading EMS from a previous version, EMS will provide the alarm server and network configuration server IP addresses from the previous EMS installation.

After the installation has finished, EMS places the following icons on your desktop:


Installing EMS for Windows 95

To install EMS on a Windows 95 workstation, complete the following steps:


Step 1   Close all applications and reboot the workstation.

Step 2   Insert the EMS CD into your CD-ROM drive.

Step 3   Locate the EMS-lite.exe icon on the CD and double-click it.

Step 4   Follow the prompts to install EMS.

Step 5   After installing EMS, you must restart your workstation.

After the workstation is restarted, EMS places the Cisco 6700 Series EMS NetView icon on your desktop.


Installing EMS for UNIX

The install script creates two scripts—ems.csh and ems.ksh—in the EMS installation directory. If you are upgrading or reinstalling EMS on the workstation, the script files, network configuration, and alarm information will all be retained from the previous installation.

EMS may be installed in any directory in which the user has write privileges (root directory). The EMS distribution package for UNIX (ems_unix) contains three files:

To install EMS on a UNIX workstation:


Step 1   Close all applications and reboot the workstation.

Step 2   Choose whether you want to install directly from the CD-ROM or first copy the distribution package files into a user account. If installing directly from the CD-ROM, go to Step 3. Otherwise, enter the following commands:

# cp * <user directory>
# cd <user directory>
 

Step 3   Add execute rights to the install script:

# chmod +x emsinstall

 

Step 4   Execute the install script:

# ./emsinstall

 
                              EMS Unix Installation
                              ---------------------
 

Step 5   Press Return to select the default file name and location, ./ems.tar.

Enter tar file name [./ems.tar]: 
 
Setting up installation...done.
 

Step 6   Enter a fully-qualified path name for the EMS installation directory. If the B10EMS_HOME environment variable has already been set from a previous installation, the script permits the user to use that value.

Where would you like to install the EMS?
Enter fully qualified path name: /export/home0/ems

 
Creating /export/home0/ems...done.
 
Extracting EMS files...
...
Placing EMS files in /export/home0/ems...done.
 

Step 7   Enter y to install the network configuration server or, if the server is already installed or if you do not wish to install it, enter n.

Will this installation use the network configuration server (y/n)? [n]: y

 
Generating script files with environment variables...done.
Files /export/home0/ems/ems.csh
and /export/home0/ems/ems.ksh
have been created. Set the value of B10EMS_SERVER and
c6700NET_SERVER if necessary in the appropriate file and source it before running the EMS.
Hit Enter to complete the installation...
 
Completing installation...
 
EMS installation is complete. The EMS includes the 'nmtrapd' program which requires root 
permissions. Please get root permissions and type >> ./emsinstall root << to install it.
 

Step 8   If you do not want to install the alarm server, go to Step 12.

To install the alarm server, obtain the root password for your workstation, then perform the following steps:

Step 9   Set user to root:

# su

 

Step 10   Execute the emsinstall script with root privileges:

# ./emsinstall root

 

The install script will prompt for the fully-qualified path name of the EMS installation directory, unless it is already defined in the environment.

Step 11   Exit from the root login:

# exit

 

Step 12   You must configure the IP addresses of the alarm server and network configuration server. Use vi (a standard text editor under UNIX) or another text editor to set the B10EMS_SERVER (alarm server) and C6700NET_SERVER (network configuration server) variables. Contact your network administrator for the correct IP addresses.

The following example uses vi to edit the ems.csh file:

# vi ems.csh

"ems.csh" 12 lines, 406 characters
setenv B10EMS_HOME /export/home0/ems
setenv B10EMS_SERVER
setenv C6700NET_SERVER
setenv TCL_LIBRARY $B10EMS_HOME/lib/tcl
setenv TK_LIBRARY $B10EMS_HOME/lib/tk
setenv TNM_LIBRARY $B10EMS_HOME/lib/tnm
setenv TNM_NMTRAPD $B10EMS_HOME/bin/nmtrapd
if (\Qsetenv | grep LD_LIBRARY_PATH\Q != "") then setenv LD_LIBRARY_PATH 
${LD_LIBRARY_PATH}:${B10EMS_HOME}/lib
else setenv LD_LIBRARY_PATH ${B10EMS_HOME}/lib
endif

Step 13   After editing the ems.csh or ems.ksh file, you must update the environment.

For C-Shell, enter source ems.csh. Alternatively, you can append the ems.csh file to the ~/.cshrc file, log out, and log in.

For Korn Shell, enter ems.ksh. Alternatively, you can append the ems.ksh file to the ~/.profile file, log out, and log in.

The following example uses source ems.csh to update the environment:

# source ems.csh

# env

...
B10EMS_HOME=/export/home0/ems
B10EMS_SERVER=171.68.205.106
C6700NET_SERVER=171.68.205.106
TCL_LIBRARY=/export/home0/ems/lib/tcl
TK_LIBRARY=/export/home0/ems/lib/tk
TNM_LIBRARY=/export/home0/ems/lib/tnm
TNM_NMTRAPD=/export/home0/ems/bin/nmtrapd
LD_LIBRARY_PATH=/export/home0/ems/lib
# exit

 

UNIX Environment Variables

EMS environment variables are specified in the ems.csh and ems.ksh files (see Table 2-1):
Table 2-2: EMS Environment Variables
Variable Description/Location

B10EMS_HOME

The EMS installation directory

B10EMS_SERVER

IP address of the computer running the alarm server

C6700NET_SERVER

IP address of the computer running the network configuration server

LD_LIBRARY_PATH

<EMS installation directory>/lib

TCL_LIBRARY

<EMS installation directory>/lib/tcl

TK_LIBRARY

<EMS installation directory>/lib/tk

TNM_LIBRARY

<EMS installation directory>/lib/tnm

TNM_NMTRAPD

<EMS installation directory>/bin/nmtrapd

Troubleshooting Your Installation

If you have problems installing EMS, the information in this section might be helpful. If you still have difficulty with your installation, contact a customer service representative. (See Obtaining Technical Assistance,.)

Error Messages and Solutions

The following section describes error messages, and their possible solutions, that might appear when you install EMS.

Error Message (Windows 95)

During the installation, you get an error similar to the following:

Warning: Batch file update failed. Please update file by hand.
 

Solution

This error indicates that the EMS install application was unable to edit the AUTOEXEC.BAT file on your workstation. To update the AUTOEXEC.BAT file on a workstation, complete the following steps:


Step 1   From the Start menu on your workstation, select Run.

Step 2   Type edit autoexec.bat in the text window, and click OK to launch the MS-DOS editor. (See Figure 2-1.)


Figure 2-1: Edit AUTOEXEC.BAT


Step 3   Use the down arrow key to scroll down past the last line of existing text, and enter the following lines of text exactly as shown:

SET B10EMS_HOME=C:/EMS

SET TCL_LIBRARY=C:/EMS/LIB/TCL

SET TK_LIBRARY=C:/EMS/LIB/TK

SET TNM_LIBRARY=C:/EMS/LIB/TNM


Note   You must use the forward slash character (/) when entering these variables. This procedure assumes that EMS was installed to the default folder, C/EMS.

Figure 2-3 shows the AUTOEXEC.BAT file with EMS System Variables correctly entered:


Figure 2-3: Enter EMS System Variables


Step 4   Select File > Save to save this configuration.

Step 5   Select File > Exit to close the editor.

Step 6   Close all applications and reboot the workstation to load the EMS system variables.



hometocprevnextglossaryfeedbacksearchhelp
Posted: Mon Sep 25 17:12:19 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.