|
|
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. |
The EMS workstation must have an Ethernet port to communicate with the NE. lists the minimum system requirements for each supported operating system:
| 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. |
To install EMS on a Windows NT 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:
To install EMS on a Windows 95 workstation, complete the following steps:
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.
The install script creates two scriptsems.csh and ems.kshin 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 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
EMS environment variables are specified in the ems.csh and ems.ksh files (see Table 2-1):
| 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 |
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,.)
The following section describes error messages, and their possible solutions, that might appear when you install EMS.
During the installation, you get an error similar to the following:
Warning: Batch file update failed. Please update file by hand.
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 2 Type edit autoexec.bat in the text window, and click OK to launch the MS-DOS editor. (See Figure 2-1.)

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:/EMSSET TCL_LIBRARY=C:/EMS/LIB/TCLSET TK_LIBRARY=C:/EMS/LIB/TKSET 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:

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.
![]()
![]()
![]()
![]()
![]()
![]()
![]()
Posted: Mon Sep 25 17:12:19 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.