|
|
Installing Network Management Software Applications
As described in the "Overview" chapter, two classes of software must be fully functional in an LS2020 networking environment to take full advantage of the capabilities of a LightStream 2020 multiservice ATM switch (LS2020 switch):
The StreamView software modules support the following functions:
The CiscoView-2020 software module supports the following functions:
Table 3-1 lists the facilities provided by the network management software applications and refers you to related LS2020 documents for more detailed information.
Table 3-1 : LS2020 Facilities and Related Documentation
| For Information about ... | See the ... |
|---|---|
| Running the StreamView LS-Configurator | LightStream 2020 Network Operations Guide |
| Running the CLI, CiscoView-2020, and the StreamView LS-Topology Map | LightStream 2020 Network Operations Guide |
| LynxOS commands | LightStream 2020 NP O/S Reference Manual |
| LS2020 SNMP management information base (MIB) | LightStream 2020 Network Operations Guide |
Installing Network Management Software to Run Under HP OpenView
The following procedures apply when you are installing either a new version or an upgrade of the network management software on an NMS running HP OpenView. These procedures assume that HP OpenView is already installed and operating properly on the Sun SPARCstation.
The network management software installation procedures involves three network management modules and associated facilities, as listed below:
The network management software installation procedure involves the use of the
ovinstall
command. This command is used to accomplish the following:
directory
directory and install it under HP OpenView
To install the StreamView and CiscoView network management software on an NMS that is running HP OpenView, perform the following steps:
To extract the StreamView LS-Configurator from tape:
Figure 3-1 : Screen Display During StreamView LS-Configurator Extraction
To extract the StreamView LS-Topology Map software from tape:
Figure 3-2 : Screen Display During StreamView LS-Topology Map Extraction
To extract the CiscoView-2020 monitor software from tape:
Figure 3-3 : Screen Display During CiscoView-2020 Monitor Extraction
The installation of the network management is now complete. The next section describes how to create a user environment for running network management software applications under HP OpenView.
Setting Up a User Environment Under HP OpenView
This section describes how to set up the StreamView and CiscoView applications to run under HP OpenView on the NMS. Each NMS user intending to run StreamView or CiscoView under HP OpenView must perform the procedures in this section.
These procedures assume that you have already installed the network management software applications on your NMS, as described in the preceding section, "Installing Network Management Software to Run Under HP OpenView.
This section provides instructions for setting up the user environment for the Bourne shell (sh and bash) and the C shell (csh). For clarity, the setup procedures for the Bourne shell and the C shell are discussed under separate headings below.
Other shells may differ in details; in the case of another shell, consult the applicable documentation for that shell.
In preparation for setting up the user environment under HP OpenView, determine the type of shell each user is using.
In an NFS environment that uses the Network Information Services (NIS) facility, enter the following command:
In an environment that does not use the NIS facility, enter the following command:
The shell can be identified from the last field of the password entry, as shown in the following example:
Setting Environment Variables for Bourne Shell and Derivatives
To set up the network management software to operate under HP OpenView and the Bourne shell, perform the following procedures:
Add the following lines to the end of the file:
The first time the StreamView LS-Configurator tool (cfg) is executed, the database is created automatically with the name specified by LSC_DATABASE, taking on the extensions .dir and .pag and the file permissions of the first user.
All users who will create or modify LS2020 node configurations must be in the same UNIX group. If they are not in the same group, such users will be limited to read-only access to the database and, therefore, will not be able to update LS2020 nodes with configuration information from the global database.
For example, if the operations group has read-only access to the global database, "user ID root" should issue the following commands to ensure that the operations group has required read/write access privileges to the file configure.netdb:
Setting Environment Variables for C Shell and Derivatives
To set up network management software to operate under HP OpenView and the C shell, perform the following steps:
The first time the StreamView LS-Configurator tool (cfg) is executed, the database is created automatically with the name specified by LSC_DATABASE. It has the extensions .dir and .pag and the file permissions of the first user.
All users who will create or modify LS2020 node configurations must be in the same UNIX group. If not, such users will be limited to read-only access to the database and, therefore, will not be able to update LS2020 nodes with configuration information from the global database.
For example, if the operations group has read-only access to the global database, "user ID root" should issue the following commands to ensure that the operations group has required read-write access privileges to the file configure.netdb:
Installing Network Management Software to Run Without HP OpenView
The following procedures apply when you are installing either a new version or an upgrade of the network management software on an NMS that is not running HP OpenView.
To install the StreamView or CiscoView network management software applications to operate stand-alone without HP OpenView, perform the following steps:
The installation of the network management software is now complete. The next section describes how to set up the NMS environment for using network management software in a non-HP OpenView environment.
Setting Up a User Environment Without HP OpenView
This section describes how to set up the StreamView and CiscoView applications to run on the NMS without HP OpenView. Each LS2020 user intending to run StreamView or CiscoView on the NMS without HP OpenView must complete the procedures in this section.
It is assumed that you have already installed the StreamView or CiscoView applications on your NMS to operate without HP OpenView, as described in the preceding section, "Installing Network Management Software to Run Without HP OpenView."
This section provides instructions for setting up the StreamView and CiscoView user environment for the Bourne shell (sh and bash) and the C shell (csh). For convenience and clarity, the setup procedures for these shells are described under separate headings below.
Note that other shells may differ in details; in the case of another shell, consult the appropriate shell documentation for additional information.
Setting Environment Variables for Bourne Shell and Derivatives
To set up the network management software applications to operate without HP OpenView under the Bourne shell, perform the following steps:
Note that the first time the StreamView LS-Configurator tool (cfg) is executed, the database is created automatically with the name specified by LSC_DATABASE, with the extensions .dir and .pag and the file permissions of the first user.
All users who will create or modify LS2020 node configurations must be in the same UNIX group. If they are not in the same group, users will be limited to read-only access to the database and, therefore, will not be able to update LS2020 nodes with configuration information from the global database.
For example, if the operations group has read-only access to the global database, "user ID root" should issue the following commands to ensure that the operations group has the required read/write access privileges to the file configure.netdb:
Setting Environment Variables for C Shell and Derivatives
To set up the network management software applications to operate without HP OpenView under the C shell, perform the following steps:
The first time the StreamView LS-Configurator tool (cfg) is executed, the database is created automatically with the name specified by LSC_DATABASE, taking on the extensions .dir and .pag and the file permissions of the first user.
All users who will create or modify LS2020 node configurations must be in the same UNIX group. If they are not, such users will be limited to read-only access to the database and, therefore, will not be able to update LS2020 nodes with configuration information from the global database.
For example, if the operations group has read-only access to the global database, "user ID root" should issue the following commands to ensure that the operations group has required read/write access privileges to the file configure.netdb:
Copyright 1988-1996 © Cisco Systems Inc.
su password:<root password>
directory is in your path (the installation procedure uses this directory). To display your path, issue the following command at the SunOS prompt:
echo $PATH
$
export PATH=$PATH:/usr/OV/bin
$
setenv PATH ${PATH}:/usr/OV/bin
cat /usr/OV/install/system/OVIC/ovindex
cid: ov1.4
" in this file.
ovinstall
command at the root prompt, as shown below.
#
ovinstall -r -p LS-CONFIGURE -- -d <tape-drive>
ovinstall
command to extract the StreamView LS-Configurator software from tape.
"ovinstall: cannot install product definition for LS-CONFIGURE"
ovinstall
command to extract and install the StreamView (LS-Configurator, and LS-Topology Map) and CiscoView (CiscoView-2020 monitor) network management modules, the
<tape-drive>
parameter may be any one of the following:
/dev/rst0
,
/dev/rst1
,
or
/dev/rst2
, depending on which port your tape drive uses. The command takes from 5 to 15 minutes to extract and install the network management software modules and associated files.
more /tmp/update.log
. An example of this file is provided in the appendix "StreamView Output Samples."
#
ovinstall -r -p LS-TOPOMAP -- -d <tape-drive>
ovinstall
command to extract the StreamView LS-Topology Map software from tape.
#
ovinstall -r -p CISCOVIEW-2020-- -d <tape-drive>
ovinstall
command to extract the CiscoView-2020 monitor software from tape.
# ovw -fields
#
ovw -verify
ovw -verify
command.
#
ovstatus
If the
ovstatus command returns the following message:
"ovstatus: ovspnd is not running; use ovstart to start ovspnd"
ovstart
command from "user ID root," as shown below:
#
ovstart
xnmsnmpconf
command at the shell prompt.
161
6.0
2
set
operations, as indicated below:
set community: write
set
operations from any community.
xnmsnmpconf
command.
file contains the following lines:
snmp 161/udp
snmp-trap 162/udp
#
vi /etc/services
snmp 161/udp and snmp-trap 162/udp
lines
in the appropriate location in the /etc/services file and close the file.
#
ypmatch <username> passwd
#
egrep <username> /etc/passwd
jjones:o@elQMkzZv7o F:10563:312:Jon Jones:/home/jjones:/bin/bash
PATH=$PATH:/usr/OV/bin/ls_bin
export LSC_DATABASE=/usr/OV/databases/ls/configure.netdb
export LSC_CFGLOGPATH=/usr/OV/log
export LSC_CFGTCPPORT=6789
export XKEYSYMDB=<pathname>/XKeysymDB
export NMSROOT=/usr/OV/bin/ls_bin
<pathname>
for
XKEYSYMDB
in the last line above, consult your Sun system administrator. The file
XKeysymDB
should be in the subdirectory
lib,
lib/X11,
or
/usr/openwin/lib
under the directory containing your X Windows executables. You can use the command
find / -name XKeysymDB -print
to search for the
XKeysymDB
file. However, the search process may be lengthy and may disclose multiple copies of the file. Also, note the upper- and lower-case conventions in the
XKeysymDB
filename; this case sensitivity is critical. If
XKEYSYMDB
is incorrectly defined when OpenView is started, that is, no file named
XKeySymDB
is found where
XKEYSYMDB
points, error output is directed to the standard error output device (STDERR). A sample of such output is shown in the "StreamView Output Samples" appendix under the heading "Error Output When XKEYSYMDB Is Undefined."
UIDPATH
variable is already set in your login environment by issuing the following command:
%
echo $UIDPATH
a search path in Step 2, add the following line to the end of the .profile file or the .bash_profile file:
export UIDPATH=$UIDPATH:/usr/OV/bin/ls_bin/%U
UIDPATH: unbound variable
" or displays no message, add the following line to the .profile file or the .bash_profile file:
export UIDPATH=/usr/OV/bin/ls_bin/%U
XFILESEARCHPATH
variable is already set in your login environment by issuing the following command:
%
echo $XFILESEARCHPATH
export XFILESEARCHPATH=$XFILESEARCHPATH:/usr/OV/%T/%N%S
"XFILESEARCHPATH: unbound variable"
or displays no message, check for the existence of the following directory:
%
ls /usr/openwin/lib/app-defaults/
export XFILESEARCHPATH=/usr/openwin/lib/%T/%N%S:\
/usr/OV/%T/%N%S
%
ls /usr/lib/X11/app-defaults/
export XFILESEARCHPATH=/usr/lib/X11/%T/%N%S:\
/usr/OV/%T/%N%S
export XFILESEARCHPATH=/usr/openwin/lib/%T/%N%S:\
/usr/lib/X11/%T/%N%S:\
/usr/OV/%T/%N%S
%
mv .Xdefaults Xdef.sav
%
cat Xdef.sav /usr/OV/newconfig/xdefaults > .Xdefaults
%
cp /usr/OV/newconfig/xdefaults .Xdefaults
%
ovw
ovw: cannot connect to database
" is returned, issue the following command:
%
ovstatus
"ovstatus: ovspnd is not running; use ovstart to start ovspnd"
ovstart
command from "user ID root," as shown below:
#
ovstart
%
ovw&
ovw
start command is issued. When the StreamView LS-Configurator is invoked under HP OpenView, the access permissions for the configuration database file created by this module correspond to the privileges of the user issuing the
ovw
command.
XFILESEARCHPATH
is not set correctly:
ovw: Xt Warning: Cannot convert string "helvr14" to type FontStruct
ovw: Xt Warning: Cannot convert string "helvr12" to type FontStruct
ovw: Xt Warning: Cannot convert string "helvr10" to type FontStruct
ovw: Xt Warning: Cannot convert string "helvr08" to type FontStruct
/usr/OV/%T/%N%S
" to the
XFILESEARCHPATH
. Continue from that point with Step 6 and Step 8 to restart HP OpenView.
su
cd /usr/OV/databases/ls
chgrp <ops-group> configure.netdb
setenv PATH ${PATH}:/usr/OV/bin/ls_bin
setenv LSC_DATABASE /usr/OV/databases/ls/configure.netdb
setenv LSC_CFGLOGPATH /usr/OV/log
setenv LSC_CFGTCPPORT 6789
setenv XKEYSYMDB <pathname>/XKeysymDB
setenv NMSROOT /usr/OV/bin/ls_bin
<pathname>
for
XKEYSYMDB
in the last line above, consult your Sun system administrator. The file
XKeysymDB
should be in the subdirectory
lib,
lib/X11,
or
/usr/openwin/lib
under the directory containing your X Windows executables. You can use the command
find / -name XKeysymDB -print
to search for the
XKeysymDB
file. However, be aware that the search process may be lengthy and find multiple copies of the file. Also, note the upper- and lower-case conventions in the
XKeysymDB
file name; this case sensitivity is critical. If
XKEYSYMDB
is incorrectly defined when OpenView is started, that is, no file named
XKeySymDB
is found where
XKEYSYMDB
points, error output is directed to the standard error output device (STDERR). A sample of such output is shown in the "StreamView Output Samples" appendix under the heading "Error Output When XKEYSYMDB Is Undefined."
UIDPATH
variable is already set in your login environment by issuing the following command:
%
echo $UIDPATH
setenv UIDPATH ${UIDPATH}:/usr/OV/bin/ls_bin/%U
UIDPATH: Undefined variable
" or displays no message, add the following line to the end of the .cshrc file:
setenv UIDPATH /usr/OV/bin/ls_bin/%U
XFILESEARCHPATH
variable is already set in your login environment by issuing the following command:
% echo $XFILESEARCHPATH
setenv XFILESEARCHPATH ${XFILESEARCHPATH}:/usr/OV/%T/%N%S
XFILESEARCHPATH: undefined variable
" or displays no message, check for the existence of the following directory:
% ls /usr/openwin/lib/app-defaults/
setenv XFILESEARCHPATH /usr/openwin/lib/%T/%N%S:/usr/OV/%T/%N%S
% ls /usr/lib/X11/app-defaults/
setenv XFILESEARCHPATH /usr/lib/X11/%T/%N%S:/usr/OV/%T/%N%S
setenv XFILESEARCHPATH /usr/openwin/lib/%T/%N%S:/usr/lib/X11/%T/%N%S:/usr/OV/%T/%N%S
%
mv .Xdefaults Xdef.sav
%
cat Xdef.sav /usr/OV/newconfig/xdefaults > .Xdefaults
%
cp /usr/OV/newconfig/xdefaults .Xdefaults
%
ovw
ovw: cannot connect to database
" is returned, issue the following command:
%
ovstatus
"ovstatus: ovspnd is not running; use ovstart to start ovspnd"
ovstart
command from "user ID root," as shown below:
#
ovstart
%
ovw&
ovw process is fully usable.
ovw
start command is issued. When the StreamView LS-Configurator is invoked under HP OpenView, the access permissions for the configuration database file created by this module correspond to the privileges of the user issuing the
ovw
command.
XFILESEARCHPATH
is not set correctly:
ovw: Xt Warning: Cannot convert string "helvr14" to type FontStruct
ovw: Xt Warning: Cannot convert string "helvr12" to type FontStruct
ovw: Xt Warning: Cannot convert string "helvr10" to type FontStruct
ovw: Xt Warning: Cannot convert string "helvr08" to type FontStruct
/usr/OV/%T/%N%S
" to the
XFILESEARCHPATH
. Continue from that point with Step 6 and Step 8 to restart HP OpenView.
su
cd /usr/OV/databases/ls
chgrp <ops-group> configure.netdb
#
cd /usr/LightStream-2.1/templates
#
cp -p ovsnmp.conf ovsnmp.conf.custom
#
cd /usr/LightStream-2.1.1/templates
#
cp -p ovsnmp.conf ovsnmp.conf.custom
ls
) command to display the existing configuration files, as shown below:
#
ls ovsnmp.conf*
ovsnmp.conf
ovsnmp.conf.custom
#
cd /
#
mt -f <tape-drive> rew
#
mt -f <tape-drive> fsf 4
#
tar xvpf <tape-drive>
<tape-drive>
parameter may be any one of the following, depending on which port your tape drive uses:
/dev/nrst0
,
/dev/nrst1
, or
/dev/nrst2
.
nrst0
for tape drive rst0). The letter n specifies "no rewind." If you omit this character, you will not be able to read the tape.
/usr/LightStream-2.2.1
/usr/LightStream-2.2.1/bin
/usr/LightStream-2.2.1/db
/usr/LightStream-2.2.1/etc
/usr/LightStream-2.2.1/hyperhelp
/usr/LightStream-2.2.1/lib
/usr/LightStream-2.2.1/log
/usr/LightStream-2.2.1/mib
/usr/LightStream-2.2.1/templates
#
cd /usr/LightStream-2.1/templates
#
diff ovsnmp.conf ovsnmp.conf.custom
#
cd /usr/LightStream-2.1.1/templates
#
diff ovsnmp.conf ovsnmp.conf.custom
#
mv ovsnmp.conf ovsnmp.conf.orig
#
cp ovsnmp.conf.custom ovsnmp.conf
vi /etc/services
snmp 161/udp
snmp-trap 162/udp
file, create the entry and close the file.
ypmatch <username> passwd
egrep <username> /etc/passwd
jjones:o@elQMkzZv7oF:10563:312:Jon Jones:/home/jjones:/bin/bash
<pathname>
for
XKEYSYMDB
shown in the Bourne shell procedures below, consult your Sun system administrator. The file
XKeysymDB
should be in the subdirectory
lib,
lib/X11,
or
/usr/openwin/lib
under the directory containing your X Windows executables. You can use the command
find / -name XKeysymDB -print
to search for the
XKeysymDB
file. However, be aware that the search process may be lengthy and may disclose multiple copies of the file. Also, note the upper- and lower-case conventions in the
XKeysymDB
filename; this case sensitivity is critical. If
XKEYSYMDB
is incorrectly defined when OpenView is started, that is, no file named
XKeySymDB
is found where
XKEYSYMDB
points, error output is directed to the standard error output device (STDERR). A sample of such output is shown in the "StreamView Output Samples" appendix under the heading "Error Output When XKEYSYMDB Is Undefined."
UIDPATH
variable is already set in your login environment by entering the following command:
%
echo $UIDPATH
PATH=$PATH:/usr/LightStream-2.2.1/bin
export UIDPATH=$UIDPATH:/usr/LightStream-2.2.1/bin/%U
export LSC_DATABASE=/usr/LightStream-2.2.1/db/configure.netdb
export LSC_CFGLOGPATH=/usr/LightStream-2.2.1/log
export LSC_CFGTCPPORT=6789
export OVSNMP_CONF_FILE=/usr/LightStream-2.2.1/templates/ovsnmp.conf
export XKEYSYMDB=<pathname>/XKeysymDB
export NMSROOT=/usr/LightStream-2.2.1
UIDPATH: unbound variable
or no message in response to the
echo $UIDPATH
command, add the following lines to the end of the .profile file or the .bash_profile file:
PATH=$PATH:/usr/LightStream-2.2.1/bin
export UIDPATH=/usr/LightStream-2.2.1/bin/%U
export LSC_DATABASE=/usr/LightStream-2.2.1/db/configure.netdb
export LSC_CFGLOGPATH=/usr/LightStream-2.2.1/log
export LSC_CFGTCPPORT=6789
export OVSNMP_CONF_FILE=/usr/LightStream-2.2.1/templates/ovsnmp.conf
export XKEYSYMDB=<pathname>/XKeysymDB
export NMSROOT=/usr/LightStream-2.2.1
%
mv .Xdefaults Xdef.sav
%
cat Xdef.sav /usr/LightStream-2.2.1/templates/xdefaults > .Xdefaults
%
cp /usr/LightStream-2.2.1/templates/xdefaults .Xdefaults
su
cd /usr/LightStream-2.2.1/db
chgrp <ops-group> configure.netdb
vi /etc/services
snmp 161/udp
snmp-trap 162/udp
file, create the entry and close the file.
ypmatch <username> passwd
egrep <username> /etc/passwd
jjones:o@elQMkzZv7oF:10563:312:Jon Jones:/home/jjones:/bin/csh
<pathname>
for
XKEYSYMDB
in the procedures below, consult your Sun system administrator. The file
XKeysymDB
should be in the subdirectory
lib,
lib/X11,
or
/usr/openwin/lib
under the directory containing your X Windows executables. You can use the command
find / -name XKeysymDB -print
to search for the
XKeysymDB
file. However, the search process may be lengthy and may disclose multiple copies of the file. Also, note the upper- and lower-case conventions in the
XKeysymDB
filename; this case sensitivity is critical. If
XKEYSYMDB
is incorrectly defined when OpenView is started, that is, no file named
XKeySymDB
is found where
XKEYSYMDB
points, error output is directed to the standard error output device (STDERR). A sample of such output is shown in the "StreamView Output Samples" appendix under the heading "Error Output When XKEYSYMDB Is Undefined."
UIDPATH
variable is already set in your login environment by entering the following command:
%
echo $UIDPATH
file:
setenv PATH ${PATH}:/usr/LightStream-2.2.1/bin
setenv UIDPATH ${UIDPATH}:/usr/LightStream-2.2.1/bin/%U
setenv LSC_DATABASE /usr/LightStream-2.2.1/db/configure.netdb
setenv LSC_CFGLOGPATH /usr/LightStream-2.2.1/log
setenv LSC_CFGTCPPORT 6789
setenv OVSNMP_CONF_FILE /usr/LightStream-2.2.1/templates/ovsnmp.conf
setenv XKEYSYMDB <pathname>/XKeysymDB
setenv NMSROOT /usr/LightStream-2.2.1
UIDPATH: Undefined variable
or no message in response to the
echo $UIDPATH
command, add the following lines to the end of the .cshrc file:
setenv PATH ${PATH}:/usr/LightStream-2.2.1/bin
setenv UIDPATH /usr/LightStream-2.2.1/bin/%U
setenv LSC_DATABASE /usr/LightStream-2.2.1/db/configure.netdb
setenv LSC_CFGLOGPATH /usr/LightStream-2.2.1/log
setenv LSC_CFGTCPPORT 6789
setenv OVSNMP_CONF_FILE /usr/LightStream-2.2.1/templates/ovsnmp.conf
setenv XKEYSYMDB <pathname>/XKeysymDB
setenv NMSROOT /usr/LightStream-2.2.1
%
mv .Xdefaults Xdef.sav
%
cat Xdef.sav /usr/LightStream-2.2.1/templates/xdefaults > .Xdefaults
%
cp /usr/LightStream-2.2.1/templates/xdefaults .Xdefaults
su
cd /usr/LightStream-2.2.1/db
chgrp <ops-group> configure.netdb
![]()
![]()
![]()
![]()
![]()
![]()
![]()