|
This chapter describes how to install and configure CiscoWorks Blue Maps on AIX,
HP-UX, and Solaris workstations. It contains the following main sections:
This section describes how to upgrade to CiscoWorks Blue Maps Release 1.2.
| TimeSaver You can avoid having to discover the network from the network management database by creating a seed file or saving the seed file from a previous release of Maps. |
To create a seed file from the database of a previous release of CiscoWorks Blue Maps to be used in Release 1.2, do the following steps:
Step 1 Mount the CD-ROM. (If you do not know how to mount a CD-ROM drive from a local or remote system, see the appendix "Mounting a CD-ROM.")
Step 2 Enter one of the following commands.
On AIX:
/cdrom_dir/crseed -s destination_file
On HP-UX or Solaris:
/cdrom_dir/CreateSeedFile -s destination_file
Where:
cdrom_dir is the directory in which you mounted the CD-ROM.
destination_file is the name of the new seed file that you want to create.
Before installing CiscoWorks Blue Maps Release 1.2, you should deinstall the previous release of CiscoWorks Blue Maps, as described in the sections "Deinstalling CiscoWorks Blue Maps on AIX" and "Deinstalling CiscoWorks Blue Maps on HP-UX or Solaris." If the previous release of CiscoWorks Blue Maps does not deinstall cleanly, run the clean-up program provided with CiscoWorks Blue Maps Release 1.2.
To run the clean-up program, enter the following cleanup command at the system prompt:
/cdrom_dir/cleanup
You can now go to the section "Installing and Configuring CiscoWorks Blue Maps on AIX" or the section "Installing and Configuring CiscoWorks Blue Maps on HPUX or Solaris" to install Maps on your system.
You use the System Management Interface Tool (SMIT), an IBM AIX system administration facility, to install and configure CiscoWorks Blue Maps from a local or remote CD-ROM drive. The installation and configuration process described in this chapter uses the graphical user interface (GUI) version of SMIT; you can use the ASCII version called SMITTY, if you prefer. See your IBM documentation for more information about SMIT and SMITTY.
1. Use SMIT to mount the CiscoWorks Blue Maps CD-ROM on the local file system from a local or remote CD-ROM drive. (If you do not know how to mount a CD-ROM drive from a local or remote system, see the appendix "Mounting a CD-ROM.")
2. Use SMIT to install CiscoWorks Blue Maps from CD-ROM.
3. Use SMIT to configure the Sybase database on which all CiscoWorks Blue Maps applications depend.
4. Unmount the CD-ROM and remove the log files.
This section describes how to install Maps from the distribution medium to the AIX system.
CiscoWorks Blue Maps is installed in the /usr/cw-blue/ directory. If you create a file system, its mount point must be /usr/cw-blue.
To install CiscoWorks Blue Maps from a mounted CD-ROM drive, perform the following steps.
Step 1 Log in as the root user. For details, see the section "Becoming the Root User" in the "Preparing to Install CiscoWorks Blue Maps" chapter.
Step 2 Start SMIT by entering the smit command shown below:
# smit
Step 3 From the System Management menu, select Software Installation & Maintenance.
Step 4 Select Install/Update Software.
Step 5 Select Install and Update from the LATEST Available Software. The Install and Update from LATEST Available Software menu is displayed.
Step 6 In the Install and Update from LATEST Available Software menu, enter the name of the path to the installation image, such as /cdrom/cwbmaps.
Step 7 Click OK.
The Install and Update from LATEST Available Software menu displays additional fields, as shown in Figure 3-1.
Step 8 Click the List button next to the "SOFTWARE to install" field. After several seconds, the Multi-select List menu appears, as shown in Figure 3-2.
Step 9 Select any of the following choices.
Step 10 Click OK and then click OK in the confirmation window.
Step 11 In response to the "ARE YOU SURE?" prompt, click OK when you are sure that you want to install the modules that you just highlighted. An animated man appears on the screen.
While the animated man is running, SMIT is installing the selected modules in the installation directory (/usr/cw-blue). CiscoWorks Blue Maps modifies SMIT to allow subsequent configuration and deinstallation of CiscoWorks Blue Maps.
If the man raises his hands and SMIT displays OK, the process has succeeded.
If the man falls down, installation has failed. If the reason for the failure is not apparent, read the installation log file $HOME/smit.log or
/usr/cw-blue/install/cwb_install.log and supply it to a Cisco Technical Assistance Center (TAC) representative.
Step 12 Click Done.
Step 13 If Step 11 is successful, click the Return to: System Management button and go to the following section, "Configuring CiscoWorks Blue Maps on AIX" in this chapter.
If installation fails, terminate SMIT by pressing F12 or by clicking Exit SMIT on the Exit menu. Deinstall Maps as described in the section "Deinstalling CiscoWorks Blue Maps on AIX" and correct any problems before trying to install Maps again.
To configure CiscoWorks Blue Maps on AIX, you configure the Sybase database management system used by the CiscoWorks Blue Maps applications.
Step 1 If you have not already done so, start SMIT, as shown below:
# smit
Step 2 From the main SMIT menu, select Communications Applications and Services.
Step 3 Select Cisco Network Management Applications for AIX.
Step 4 Select CiscoWorks Blue Maps.
Step 5 From the CiscoWorks Blue Maps menu, select Configure.
Step 6 From the Configure menu, select Sybase-10.
The Sybase-10 menu appears, as shown in Figure 3-3.
Step 7 In the Sybase-10 menu, shown in Figure 3-3, either accept the default values or enter new values. You must provide a Sybase Server SA password. The fields in the Sybase-10 menu are described in Table 3-1.
Field | Purpose |
Path of the Sybase-10 database management system. | |
Name of the Sybase-10 server program. | |
Sybase-10 system administrator's password for access to the server. The installed default password is "sybasesa" when you use the Sybase installed by CiscoWorks. | |
CW Blue `SNA' database name | Name of the database in which CiscoWorks Blue Maps applications store data from network devices. |
CW Blue `SNA' database size | Size, in megabytes, of the Sybase database for CiscoWorks Blue Maps applications. |
CW Blue `SNA' database data device location | Specify a UNIX raw1 device name or directory name for the SNA database data. The default location is /usr/nms/sybase10/data. |
CW Blue `SNA' database log device location | Specify a UNIX raw1 device name or directory name for the SNA database log. The default location is /usr/nms/sybase10/data. |
1A raw device is a character device that is not formatted for a file system. If you are not sure what a raw device is, please contact your System Administrator. |
Step 8 Click Do and read the output.
Step 9 Click Done, and then click Cancel twice, on each of the next two menus.
Step 10 Terminate SMIT by pressing F12 or by selecting Exit SMIT on the Exit menu.
Step 11 You can use the more command to review the results of the installation in the file $HOME/smit.log.
# more $HOME/smit.log
This section describes several error conditions that can occur while you are installing and configuring Sybase for CiscoWorks Blue Maps.
During configuration, you might receive this SYBASE error message:
More vdevno's are needed. The CW_SYBASE server needs to be reconfigured.
Use following steps to reconfigure your dataserver:
Login to Sybase as 'sa' user
Then execute following commands:
> sp_configure
> go
> sp_configure "devices", 15
> go
> RECONFIGURE WITH OVERRIDE
> go
> shutdown
> go
Please contact your Sybase System Administrator
If this message appears, follow the displayed procedure or see the section "Sybase vdevnos Error Message" in the chapter "Troubleshooting CiscoWorks Blue Maps."
During Maps reinstallation, the following error message might appear if the Sybase server was not shut down prior to reinstalling Maps:
Building the SNA data device...
An error has occurred while building the SNA data device. Check the file /tmp/cwb_sqll.log for more info. Exiting.
If this error message appears, use the following procedure:
Step 1 Log in to Sybase using the following isql command:
sybase_dir/bin/isql -Usa -Psybasesa
Step 2 Shut down and restart Sybase:
> shutdown
> go
# cd sybase_dir/install
# startserver -f ./RUN_CW_SYBASE
# startserver -f ./RUN_CW_BACKUP_SERVER
After you have installed and configured CiscoWorks Blue Maps, you can unmount the CD----ROM and remove the log files, as described in the following subsections:
To unmount the CD-ROM, log in as the root user and enter the commands shown below at the local or remote workstation where the CD-ROM is mounted:
# cd /
# umount /cdrom
where /cdrom is the mount point.
AIX unmounts the CD-ROM device from the /cdrom directory. Remove the CD-ROM from the drive.
During installation and configuration, log files are created to track the installation process and provide diagnostic information if a problem arises. When you are satisfied that CiscoWorks Blue Maps is properly installed and operating, you can remove these files. To remove these files from your system, log in as the root user and enter the command shown below:
# rm /tmp/cwb*.*
Step 1 Log in as the root user. For details, see the section "Becoming the Root User" in the "Preparing to Install CiscoWorks Blue Maps" chapter.
Step 2 Set the following environment variables:
Step 3 Start SMIT by entering the smit command, as shown below:
# smit
Step 4 From the System Management menu, select Communications Applications and Services.
Step 5 Select Cisco Network-Management Applications for AIX.
Step 6 Select CiscoWorks Blue Maps.
Step 7 Select Deinstall CiscoWorks Blue Maps.
Step 8 In the Deinstall menu, click the "Deinstall" List button.
Step 9 In the Multi-select List dialog box, select all object names associated with the Maps applications you want to deinstall, or click CWBMaps.sybase.obj to deinstall the Sybase configuration tools and your Maps database, and then click OK.
Step 10 Click OK.
Step 11 In response to the "ARE YOU SURE?" prompt, click OK. An animated man appears on the screen.
While the animated man is running, SMIT is deinstalling all files related to the selected applications.
If the man raises his hands and SMIT displays OK, the deinstallation process has succeeded.
If the man falls down, deinstallation has failed. If the reason for the failure is not apparent, read the log file $HOME/smit.log and call the Cisco TAC.
Step 12 Terminate SMIT by pressing F12 or by clicking Exit SMIT on the Exit menu.
Step 13 Shut down and restart the Sybase server.
You can now reinstall the Maps software.
You can install and configure CiscoWorks Blue Maps from a local or remote CD-ROM drive. To install and configure Maps on HP-UX or Solaris, perform the following steps:
Step 1 If you are installing from a remote CD-ROM drive, insert the CD-ROM into the drive on a remote system and export the CD-ROM file system (make it available to an outside system). If you are installing from a local CD-ROM drive, insert the CD-ROM into the drive on the local system, then mount the CD-ROM file system on the local system. If you do not know how to mount a CD-ROM drive from a local or remote system, see the appendix "Mounting a CD-ROM."
Step 2 Install CiscoWorks Blue Maps, as described in the section "Installing CiscoWorks Blue Maps on HP-UX or Solaris."
Step 3 Configure CiscoWorks Blue Maps, as described in the section "Configuring CiscoWorks Blue Maps on HP-UX or Solaris."
Step 4 After successful configuration, remove the log file, as described in the section "Removing Log Files on HP-UX or Solaris."
If it is necessary to reinstall a CiscoWorks Blue product, deinstall the existing software using procedures in "Deinstalling CiscoWorks Blue Maps on HP-UX or Solaris," and then reinstall as if it were a new installation.
Use the following procedure to install the software on the host system. The default for each prompt is the value in brackets. To accept any default value, press Enter. To stop the installation script at any time, press Break or Ctrl-C.
Step 1 Start the interactive installation and configuration script by entering one of the following commands.
On Solaris:
# /cdrom/cdrom0/cwbinstall
On HP-UX:
# /cdrom/cwbinstall
Step 2 Next you will be prompted for the source of the software to be installed.
On Solaris, press Enter to accept the default directory:
Source Directory :[/cdrom/cdrom0]
On HP-UX, press Enter to accept the default directory.
Source Directory:[/cdrom/HPUX10]
Step 3 In response to the following prompt, press Enter to accept the default.
Where do you want to install the product :[/opt/CSCOcb]
Step 4 In response to the following prompt, press Enter to accept a full installation of the DLSw, RSRB, and APPN Maps applications.
What filesets do you want to install : [CWBLUE-RSRB CWBLUE-DLSW CWBLUE-APPN]
To install the RSRB and DLSw applications, enter this:
CWBLUE-RSRB CWBLUE-DLSW
Step 5 The installation program displays your responses to the previous questions and asks you this question:
Do you wish to continue? (y/n)[y]:
Press Enter to continue, or type n and press Enter to terminate the installation.
Step 6 The program installs the software from CD-ROM and reports on its progress.
Step 7 Use the more command to examine the installation log file for error messages. Use one of the following commands, depending on your operating system.
On Solaris:
# more /install_directory/log/cwb_install.log
Where install_directory is usually /opt/CSCOcb.
On HP-UX:
# more /var/adm/sw/swagent.log
Press the Spacebar to advance the display one screen at a time.
Installation is complete. Go to the section "Configuring CiscoWorks Blue Maps on HP-UX or Solaris." If it is necessary to deinstall any or all CiscoWorks Blue Maps applications, see the section "Deinstalling CiscoWorks Blue Maps on HP-UX or Solaris."
After you install Maps on an HP-UX or Solaris system, you then configure Maps using the following procedure. The default for each prompt is the value shown in brackets. To accept any default value, press Enter. (You can press Break or Ctrl------C to stop the configuration script at any time.)
Step 1 To start the interactive configuration script, enter the commands shown below:
# cd install_directory/install/bin
# ./cwbconfigure
Where:
install_directory is usually /usr/cw-blue for AIX or /opt/CSCOcb for HP-UX and Solaris.
Step 2 The following prompt appears. Press Enter to accept the default (the same directory in which you placed the software during installation), or enter an alternate directory name.
CiscoWorks Blue root directory (CWBROOT): [/opt/CSCOcb]
Step 3 In response to the following prompt, press Enter to accept the default Sybase home directory selected by the configuration program, or type another directory name and press Enter.
Sybase home directory (SYBASE): [/opt/CSCOsyb]
Step 4 In response to the following prompt, press Enter to accept the Sybase server name selected by the configuration program, or type another directory and press Enter.
Sybase Server Name (DSQUERY):[CW_SYBASE]
Step 5 In response to the following prompt, enter the Sybase system administrator's password and press Enter. The installed default password is sybasesa. (You will not see this message if you install only APPN.)
Sybase sa password:
Step 6 In response to the following prompt, press Enter to accept the creation of a Sybase database for CiscoWorks Blue Maps called SNA, or type a different name and press Enter.
CWBlue database name (DBNAME):[SNA]
Step 7 In response to the following prompt, press Enter to accept the default database size of 50 MB, or type another value and press Enter. (You will not see this message if you install only APPN.)
CWBlue database size :[50]
Step 8 In response to the following prompt, press Enter to accept the database data device location selected by the configuration program, or type another directory and press Enter. (You will not see this message if you install only APPN.) The device location can be a directory under the normal UNIX filesystem or a raw logical partition. (The raw device should be a character device. If you are not sure what a character device is, please contact your System Administrator.)
CWBlue database data device location: [ /opt/CSCOsyb/data ]
Step 9 In response to the following prompt, press Enter to accept the database log device location selected by the configuration program, or type another directory and press Enter. (You will not see this message if you install only APPN.) The device location can be a directory under the normal UNIX filesystem or a raw logical partition. (The raw device should be a character device. If you are not sure what a character device is, please contact your System Administrator.)
CWBlue database log device location: [ /opt/CSCOsyb/data ]
Step 10 The configuration program displays your responses to the previous questions:
The following settings will be used to configure Sybase.
CWBROOT is set to: /opt/CSCOcb
NMSROOT is set to: /opt/CSCOcwh
SYBASE Home Directory: /opt/CSCOsyb
SYBASE Server name: CW_SYBASE
CWBlue database name: SNA
CWBlue database size(in MB): 50
CWBlue database data device location: /opt/CSCOsyb/data
CWBlue database log device location: /opt/CSCOsyb/data
The configuration program asks the following question:
Do you wish to continue? (y/n)[y]:
Press Enter to continue, or type n and press Enter to terminate the configuration. The program performs the configuration and reports on its progress.
Step 11 The configuration program might display an error message like the following:
An error has occurred while building the SNA data device. Check
the file /tmp/cwb_sql1.log for more info. Exiting.
If so, go to the section "Errors When Configuring SYBASE." Otherwise, continue with the next step.
Step 12 Unmount the CD-ROM by entering the commands shown below:
# cd /
# umount /cdrom
Step 13 Eject the CD-ROM.
Step 14 On HP-UX systems, you can use the more command to review the results of the installation in the file /var/adm/sw/swagent.log.
# more /var/adm/sw/swagent.log
Configuration is complete. Go to "Removing Log Files on HP-UX or Solaris."
This section describes several error conditions that can occur while you are installing and configuring Sybase for CiscoWorks Blue Maps.
During configuration, you might receive this SYBASE error message:
More vdevno's are needed. The CW_SYBASE server needs to be reconfigured.
Use following steps to reconfigure your dataserver:
Login to Sybase as 'sa' user
Then execute following commands:
>sp_configure
>go
>sp_configure "devices", 15
>go
>RECONFIGURE WITH OVERRIDE
>go
>shutdown
>go
Please contact your Sybase System Administrator
If this message appears, follow the procedure displayed by the installation script or see the section "Sybase vdevnos Error Message" in the chapter "Troubleshooting CiscoWorks Blue Maps."
During Maps reinstallation, the following error message might appear if the Sybase server was not shut down prior to reinstalling Maps:
Building the SNA data device...
An error has occurred while building the SNA data device. Check the file /tmp/cwb_sqll.log for more info. Exiting.
If this error message appears, use the following procedure:
Step 1 Log in to Sybase using the isql command:
sybase_dir/bin/isql -Usa -Psybasesa
Where sybase_dir is the directory in which Sybase is installed, usually
/opt/CSCOsyb.
Step 2 Shut down and restart Sybase:
>shutdown
>go
#cd sybase_dir/install
#startserver -f ./RUN_CW_SYBASE
#startserver -f ./RUN_CW_BACKUP_SERVER
During installation and configuration, messages are recorded in a log file to provide diagnostic information in case a problem arises. To remove the log file, perform these commands on an HP-UX or Solaris system when you are satisfied that configuration of the software is complete.
On Solaris:
#
rm /tmp/cwb*.*
#
rm install_directory/log/cwb*.log
On HP-UX:
#
rm /tmp/cwb*.*
#
rm install_directory/log/cwb_install.log
Where install_directory is the directory in which Maps is installed,
usually /opt/CSCOcb.
If it is necessary to deinstall CiscoWorks Blue Maps, such as after a failed installation, use the following procedure. You can press Break or Ctrl-C to stop the deinstallation script at any time.
Step 1 Shut down all currently running CiscoWorks Blue Maps and SNA View applications and daemons.
Step 2 Log in as the root user. For details, see the section "Becoming the Root User" in the "Preparing to Install CiscoWorks Blue Maps" chapter.
Step 3 To start the interactive deinstallation script, enter the commands shown below:
# cd /install_directory/install/bin
# ./cwbdeinstall
Where install_directory is usually /opt/CSCOcb for HP-UX and Solaris.
The deinstallation script lists the Maps filesets that are installed (plus the CWBLUE-SNAVIEW file if CiscoWorks Blue SNA View is already installed).
Caution The CiscoWorks Blue Maps database will be removed if you delete the CWBIC fileset, which contains the Maps common services, in the next step.
Step 4 Press Enter to accept the default group of filesets to deinstall, or enter an alternate set of filesets and press Enter. To deinstall the RSRB and APPN applications only, enter the following when prompted by cwbdeinstall:
CWBLUE-RSRB CWBLUE-APPN
Step 5 In response to the following prompt, press Enter to begin the deinstallation of filesets, or enter n and press Enter to terminate deinstallation.
Do you wish to deinstall? (y/n)[y]:
Step 6 When the system prompt returns, use the more command to examine the deinstallation log file.
On Solaris:
#
more /tmp/cwb_sybase_deinstall.log
#
more /tmp/cwb_syb_deinstall
On HP-UX:
#
more /tmp/cwb_deinstall.log
Unless you see an error message in that file, deinstallation is complete
Step 7 Use the rm command to remove the deinstallation log file.
On Solaris:
#
rm /tmp/cwb_sybase_deinstall.log
#
rm /tmp/cwb_syb_deinstall
On HP-UX:
#
rm /tmp/cwb_deinstall.log
Step 8 Use the rmdir command to remove the home directory of the special maps user whose username is cwblue.
#
rmdir /users/cwblue
Step 9 Shut down and then restart the Sybase server.
> shutdown
> go
# cd sybase_dir/install
# startserver -f ./RUN_CW_SYBASE
# startserver -f ./RUN_CW_BACKUP_SERVER
After installation, you can modify the color scheme of the Maps application by copying the Color.schemename file in the install_directory/Xdefaults directory to the file named install_directory/Xdefaults/Color.
Here is an example:
# cd install_directory/Xdefaults
# cp Color.Rembrandt Color
Where install_directory is usually /usr/cw-blue for AIX or /opt/CSCOcb for HP-UX and Solaris.
A new color scheme takes effect the next time that you start a Maps application, but it does not affect the CiscoWorks Blue SNA View application.
After installation is complete, the installation process creates a sample user with the username cwblue. The username cwblue is created without a password. To start a Maps application from the command line, you can do one of the following:
# su - cwblue
Then you can start one of the Maps application by typing the runrsrb, rundlsw, or runappn command.
You can run more than one instance or session of any of the Maps applications simultaneously. To run more than one instance of any Maps application, start each instance under a different username.
This section lists the environment variables that are set automatically by the CiscoWorks Blue Maps scripts (rundlsw, runappn, and runrsrb). Table 3-2 lists the environment variables, used by each application, for technical reference only.
Variable | RSRB | DLSw | APPN | Use and Default Value |
---|---|---|---|---|
yes | yes | yes | CiscoWorks Blue Maps bitmap directory; the default is $CWBROOT/Xbm. | |
yes | yes | yes | Tells Maps application not to read the layout from a saved map file, which forces the application to create a new layout; by default it is not set. This variable is for use when you are instructed to do so by the Cisco TAC to solve a layout problem. | |
yes | yes | yes | CiscoWorks Blue Maps installation directory, set to the directory you specify during installation. On AIX: | |
yes | yes | yes | Used to set default layout of graphical maps; values can be c (circular) or h (hierarchical). Default is s (symmetrical). | |
yes | yes | yes | Specifies the name of the MIB file; defaults to | |
CWB_PROCESS_ | yes | yes | no | Specifies the refresh interval, in seconds, for the Update Process window. (The Update Process window is displayed when you select Admin>Process Control.) |
yes | yes | yes | Identifies the workstation on which the daemons run; defaults to hostname. | |
CWB_UPDATE_ | yes | yes | no | Defines an interval to control map refresh requests. During this period, map changes are recorded but not displayed. When the interval expires, the map is refreshed. Default value is 15 seconds. |
yes | yes | no | Identifies the workstation on which the cwbmonitord daemon runs; defaults to $CWB_SERVER. | |
yes | yes | no | The name of the CiscoWorks Blue Maps Sybase database, such as SNA. If you specify a database name other than the default SNA (such as SNA-2) during configuration of CiscoWorks Blue Maps, you must set this variable identically before starting one of the Maps applications. | |
yes | yes | yes | The name of the Sybase database server, such as CW_SYBASE. | |
yes | yes | yes | HyperHelp installation directory for CiscoWorks Blue Maps help; default is $CWBROOT/hyperhelp. | |
yes | yes | yes | Set runtime library search path; default is | |
yes | yes | yes | CiscoWorks installation directory: On AIX: On Solaris with SunNet Manager: On Solaris with HP OpenView: | |
yes | yes | yes | Default is none; if printing maps is desired, set this before starting any Maps application. | |
yes | yes | yes | CiscoWorks Blue SNA View installation directory; default is $CWBROOT/snaview. | |
yes | yes | yes
| Sybase installation directory: On AIX: $NMSROOT/sybase10 or $NMSROOT/sybase102 On HP-UX, Solaris: $NMSROOT/sybase | |
yes | yes | yes | CiscoWorks Blue Maps X resource directory; default is $CWBROOT/Xdefaults. |
Posted: Thu Aug 19 11:01:11 PDT 1999
Copyright 1989-1999©Cisco Systems Inc.