|
|
This chapter describes how to install the IPM server and client software on a Sun Solaris system. It also provides information about verifying the installation and uninstalling and reinstalling IPM on Solaris.
This chapter includes the following sections:
To install the IPM software on a Sun Solaris system:
Step 2 Log in as the root user.
Step 3 Insert the IPM CD-ROM into the CD-ROM drive and, if necessary, mount the CD-ROM drive.
Step 4 Start the installation script by entering the following command:
# ./setup.sh
Step 5 Do one of the following when the IPM setup program menu appears:
The following message is displayed:
Enter full Netscape browser executable pathname: ? [/opt/netscape/netscape]
Step 6 If the IPM installation program determines that Netscape Communicator is installed in the default location, skip this step.
If you are prompted to specify the location of the Netscape Communicator executable file, you can accept the default path for Netscape Communicator by pressing Enter. If the Netscape Communicator executable file is located in a different directory than the default, type the full path (including file name) where the executable file is located.
The IPM installation program continues and determines whether or not your system meets the hardware and software requirements for running IPM.
Step 7 If your system meets the requirements for IPM, the following prompt is displayed:
Do you want the Express Install (y/n)? [Y]
Step 8 If your system does not meet all the requirements for IPM, then the installation program proceeds with the standard installation and you are prompted for information such as port numbers, product path, and filename.
Step 9 Verify that the installation was completed successfully by viewing the messages displayed at the end of the installation and by viewing the installation log. The installation log path is specified at the end of the installation script.
After IPM is successfully installed, the following IPM start-up menu is displayed.
********************************************************************** * * * Cisco Systems * * + + + + * * | | Internetwork | | * * +|+ +|+ Performance Monitor +|+ +|+ * * +|||||+ +|||||+ +|||||+ +|||||+ * * ++|||||||++++|||||||++ Startup Options ++|||||||++++|||||||++* * Empowering The =============== Internet Generation* * * ********************************************************************** 1) Start IPM Server and Client 2) Start IPM Server Only 3) Exit Setup Please choose an option ->
Step 10 Start IPM by typing 1 or 2 and pressing Enter.
This section describes the hardware and software requirements to run IPM on a Solaris system. It includes the following sections:
 |
Note Hardware and software version information is subject to change, based on enhancements to the product. For the most current version information, refer to the Release Notes for Cisco Internetwork Performance Monitor available on CCO. |
Your system must meet the following hardware requirements to run IPM:
Your system must meet the following software requirements to run IPM:
The IPM installation program automatically verifies your operating system version and checks for the required level of Solaris patches.
To obtain the patches, contact your Sun Microsystems representative, or download them from the Sun Web site.
The following minimum patch levels are required to run IPM on Solaris version 2.6:
The following minimum patch levels are required to run IPM on Solaris version 2.7:
|
Note Patch 107607-01 is required only if Patch 107607 has already been installed on your Solaris system. |
 |
Caution If you do not have the required patches installed, you can continue with the installation, but IPM might not operate as expected. |
|
Caution As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands you use. If you are a relatively inexperienced UNIX user, limit your activities as the root user to the tasks described in this manual. |
If you are not logged in, log in as the root user, as follows:
> login: root > Password: rootpassword
If you are already logged in, but not as the root user, use the su command to change your login to root:
# su
# Password: rootpassword
Step 2 Log in as the root user, as described in the "Becoming the Root User" section. The command prompt changes to the pound sign (#).
Step 3 If the /cdrom directory does not already exist, create it using the mkdir command:
# mkdir /cdrom
Step 4 Mount the CD-ROM drive.
|
Note The vold process manages the CD-ROM device and performs the mounting. The CD-ROM should mount automatically onto the /cdrom/cdrom0 directory. |
If you are running File Manager, a separate File Manager window displays the contents of the CD-ROM.
Step 5 If the /cdrom/cdrom0 directory is empty because the CD-ROM was not mounted, or if File Manager did not open a window displaying the contents of the CD-ROM, verify that the vold daemon is running by entering the following command:
# ps -e | grep vold | grep -v grep
Step 6 Do one of the following:
# /usr/sbin/vold &
#kill -15process_ID_number # /usr/sbin/vold &
|
Note To stop the vold process, you must know the process identification number. If you do not know the process identification number, run the ps command shown in Step 5. |
Step 7 If you have problems with the vold daemon, use the following mount command to mount the CD-ROM directly:
# mount -F hsfs -r ro /dev/dsk/device_filename /cdrom/cdrom0
Where:
-F indicates the type of file system (hsfs for the ISO 9660 standard).
-r ro mounts the CD-ROM in read-only mode.
device_filename is the name of the device, such as /dev/dsk/cxtyd0sz where x is the CD-ROM drive controller number, y is the CD-ROM drive SCSI ID number, and z is the slice partition on which the CD-ROM is located.
|
Caution The instructions for mounting an NFS-exported CD-ROM drive on a local system are for like systems. For example, the instructions are for exporting a CD-ROM file system from a Solaris system and mounting it on another Solaris system for installation, but not for cross-platform operation. For help with cross-platform operations, see your system administrator. |
The mounting instructions are presented in the following two sections:
On the remote system perform the following steps:
Step 2 If the /cdrom directory does not already exist, create it using the mkdir command:
# mkdir /cdrom
Step 3 Mount the CD-ROM drive.
|
Note The vold process manages the CD-ROM device and performs the mounting. The CD-ROM should mount automatically mount onto the /cdrom/cdrom0 directory. |
If you are running File Manager, a separate File Manager window displays the contents of the CD-ROM.
Step 4 If the /cdrom/cdrom0 directory is empty because the CD-ROM was not mounted, or if File Manager did not open a window displaying the contents of the CD-ROM, verify that the vold daemon is running by entering the following command:
# ps -e | grep vold | grep -v grep
Step 5 Do one of the following:
# /usr/sbin/vold &
#kill -15process_ID_number # /usr/sbin/vold &
|
Note To stop the vold process, you must know the process identification number. If you do not know the process identification number, run the ps command shown in Step 5. |
Step 6 If you have problems with the vold daemon, use the following mount command to mount the CD-ROM:
# mount -F hsfs -r ro /dev/dsk/device_filename /cdrom/cdrom0
Where:
-F indicates the type of file system (hsfs for the ISO 9660 standard).
-r ro mounts the CD-ROM in read-only mode.
device_filename is the name of the device, such as /dev/dsk/cxtyd0sz where x is the CD-ROM drive controller number, y is the CD-ROM drive SCSI ID number, and z is the slice partition on which the CD-ROM is located.
Step 7 Edit or create the /etc/dfs/dfstab file to include the following line, which sets the NFS attributes to read-only:
share -F nfs -o ro -d /cdrom/cdrom0
Where:
-F specifies the file system share type.
-o specifies the start of file system export options.
ro specifies read-only file system export option.
-d specifies that you want to share a directory.
/cdrom/cdrom0 is the name of the directory to be shared.
Step 8 Make sure your remote machine is enabled as an NFS server by entering the following command:
# ps -ef | grep nfs | grep -v grep
Verify that the /usr/lib/nfs/nfsd and /usr/lib/nfs/mountd daemons are running.
Step 9 If the daemons you verified in Step 8 are not running, enable your machine as an NFS server by entering the following command:
# /etc/init.d/nfs.server start
Step 10 When your machine is enabled as an NFS server, run either of the following commands:
# share # shareall
On the local system perform the following steps:
Step 2 Log in as the root user as described in the "Becoming the Root User" section.
Step 3 If the /cdrom directory does not already exist, create it using the mkdir command:
# mkdir -p /cdrom/ipm
Step 4 To mount a file system that is exported from a remote system, use the mount command, as shown below:
# /usr/sbin/mount -r remote_hostname:/cdrom/cdrom0 /cdrom/ipm
The remote CD-ROM is mounted and ready for software installation on the local system.
After you install IPM, you must unmount the CD-ROM drive as explained in the following sections:
To unmount a local CD-ROM drive:
Step 2 Run the following commands:
# cd # umount /cdrom/cdrom0
Step 3 Remove the CD-ROM and store it in a safe place.
To unmount a remote CD-ROM drive:
# umount /cdrom/ipm
Step 2 Log in as the root user on the remote machine and run the following command:
# umount /cdrom/cdrom0
Step 3 Remove the CD-ROM and store it in a safe place.
The IPM client software can either reside with the IPM server, or it can be installed on another system located on the same network as the IPM server. Also, the IPM server on Solaris can be accessed by IPM clients running on Windows 95, Windows 98, Windows NT, or Windows 2000 Professional systems.
You can install both the IPM server software and client software on a Solaris system using the following menu options provided by the setup program:
The IPM software consists of the following Solaris packages:
When you install both the IPM server and client software on the same system, all of the listed package components must be successfully installed. When you install only the IPM client, only the client component (CSCOipm-c) must be successfully installed.
|
Note Use the setup.sh program provided with the IPM software to install IPM on your Solaris system. |
Before you run the setup program on Solaris note the following information:
|
Note IPM can be run without Netscape, but Netscape is required to access the online help, to install the IPM client using the Web Server, to run the client software as an applet from the Web browser, and to access the IPM server home page and IPM Web reports. |
To begin the installation of the IPM software on Solaris:
Step 2 Mount the CD-ROM drive, as described in the "Mounting and Unmounting the CD-ROM Drive on Solaris" section.
Step 3 Change to the mounted directory using the cd command:
# cd /cdrom/cdrom0
Step 4 Start the installation script by entering the following command:
# ./setup.sh
The following IPM setup program menu appears:
********************************************************************** * * * Cisco Systems * * + + + + * * | | Internetwork | | * * +|+ +|+ Performance Monitor +|+ +|+ * * +|||||+ +|||||+ +|||||+ +|||||+ * * ++|||||||++++|||||||++ Setup Program ++|||||||++++|||||||++* * Empowering The ============== Internet Generation* * * ********************************************************************** 1) Review README File First (Recommended) 2) Install IPM Server and Client 3) Install IPM Client Only 4) Exit Setup Please choose an option ->
Step 5 Type the number of the desired installation option and press Enter. The IPM setup program verifies the system environment for installation of the software.
The following message is displayed:
Enter full Netscape browser executable pathname: ? [/opt/netscape/netscape]
Step 6 To accept the default path for Netscape Communicator, press Enter. If the Netscape Communicator executable file is located in a different directory than the default, type the full path (including file name) where the executable file is located.
The IPM installation program determines whether or not your system meets the hardware and software requirements for running IPM.
Step 7 If your system meets the requirements for IPM, the following prompt is displayed:
Do you want the Express Install (y/n)? [Y]
Step 8 If your system does not meet all the requirements for IPM, the installation program proceeds with the standard installation and you are prompted for information such as port numbers, product path, and filename.
Step 9 Verify that the installation was completed successfully by viewing the messages displayed at the end of the installation and by viewing the installation log. The installation log path is specified at the end of the installation script.
A successful installation is shown in the following example:
Installation of <CSCOipm-s> was successful. INFO: Checking Installation. INFO: Package CSCOcwbS installed OK. Verifying... OK. INFO: Package CSCOipm-s installed OK. Verifying... OK. Creating IPM Client Web Download Image... Finished creating IPM Client Web Download Image... To use this product, set your path to: /opt/CSCOipm/bin:$PATH To access the IPM Web Server use the URL: http://cwb-sun11:1744 in your web browser. Check the documentation for supported browsers and versions. ============================- Error Summary -========================= No Errors were encountered during installation. ====================================================================== Started : Mon Apr 24 13:36:17 EDT 2000 Finished: Mon Apr 24 15:03:31 EDT 2000 ====================================================================== ===================- IPM Server Install Tool Completed -============== ======================================================================
|
Note If you are planning to install the IPM client software using the Web interface on the IPM server, be sure to note the URL listed in the "To access the IPM Web Server" message when the IPM server installation is complete. |
Step 10 Depending on the installation option you selected, a menu appears with options to start the software or exit setup. If the installation was successful, select an option to start the software.
The following menu appears when you install the IPM server and client software:
********************************************************************** * * * Cisco Systems * * + + + + * * | | Internetwork | | * * +|+ +|+ Performance Monitor +|+ +|+ * * +|||||+ +|||||+ +|||||+ +|||||+ * * ++|||||||++++|||||||++ Startup Options ++|||||||++++|||||||++* * Empowering The =============== Internet Generation* * * ********************************************************************** 1) Start IPM Server and Client 2) Start IPM Server Only 3) Exit Setup Please choose an option ->
The following menu appears when you install only the IPM client software:
********************************************************************** * * * Cisco Systems * * + + + + * * | | Internetwork | | * * +|+ +|+ Performance Monitor +|+ +|+ * * +|||||+ +|||||+ +|||||+ +|||||+ * * ++|||||||++++|||||||++ Startup Options ++|||||||++++|||||||++* * Empowering The =============== Internet Generation* * * ********************************************************************** 1) Start IPM Client and Connect to Default Remote Server - cwb-sun4 2) Start IPM Client and Connect to Alternate Remote Server 3) Exit Setup Please choose an option ->
To start the IPM server and client at a later time from the command line, use the following commands:
# cd /opt/CSCOipm/bin # ./ipm
To start just the IPM server at a later time from the command line, use the following commands:
# cd /opt/CSCOipm/bin # ./ipm start
For a complete list of all of the IPM commands, see the "IPM Command Reference" appendix in the Cisco Internetwork Performance Monitor User Guide.
The installation program automatically checks your system to verify that it is capable of running the express installation. The program verifies that the default TCP/IP ports that IPM uses are available and that adequate space exists in the default installation directory (/opt). If your system meets these requirements, the installation program provides the option to run the express installation.
|
Note The express installation option is available only when you are installing the IPM server and IPM client software at the same time. |
The following example shows the express installation option for the IPM client software:
********************************************************************** * * * Cisco Systems * * + + + + * * | | Internetwork | | * * +|+ +|+ Performance Monitor +|+ +|+ * * +|||||+ +|||||+ +|||||+ +|||||+ * * ++|||||||++++|||||||++ Setup Program ++|||||||++++|||||||++* * Empowering The ============== Internet Generation* * * ********************************************************************** 1) Review README File First (Recommended) 2) Install IPM Server and Client 3) Install IPM Client Only 4) Exit Setup Please choose an option -> 2 ================================================================= ================================================================= ================- IPM Client Install Tool Started -============== ================================================================= Fri Dec 11 10:47:55 EST 1998 SunOS yoursystem 5.5.1 Generic_103640-23 sun4u sparc SUNW,Ultra-1 ============================================================ ===============- System Requirements Check -================ ============================================================ INFO: Checking UID... root, OK. INFO: Checking Host Operating System... SunOS, OK. INFO: Checking Operating System Version... 5.5.1, OK. INFO: Checking Solaris patches... OK. INFO: Checking Solaris patches... OK. INFO: Checking Solaris patches... OK. INFO: Checking Solaris patches... OK. INFO: This product requires: RAM 131072 K SWAP 262144 K INFO: Checking Ram... OK. INFO: Checking Swap... OK. INFO: Checking your release... All components present. INFO: Checking for existing product tree... None. ============================================================ ================- Disk Space Usage check -================== ============================================================ INFO: For this product the default disk space requirements are: /opt 50000 K /var/adm 5000 K /var/tmp 1000 K INFO: Checking default disk space requirements... OK. ============================================================ ============================================================ ===================- IPM Client Summary -=================== ============================================================ INFO: The following ports will be used: INFO: [ 1] Web Server: 1744/tcp INFO: [ 2] Naming Server: 44342/udp The Express Install takes all defaults and places the product in /opt. No more questions will be asked. Do you want the Express Install (y/n)? [Y]
If the program detects that the ports are unavailable, or that there is insufficient space in the default installation directory, the express installation is disabled. You must run the standard installation to specify ports, or to choose another installation directory. See the example output in the "Installing IPM to a Different Directory" section which shows a disabled express installation option for the IPM server software.
The following example shows a case in which there is insufficient space in the default installation directory. Notice that after the message, "Where should the product be installed?", the program suggests an alternate directory /usr2/CSCOipm where it has determined that there is enough space to install IPM. To accept the proposed directory, press Enter. Otherwise, specify another directory and press Enter.
============================================================ ================- Disk Space Usage check -================== ============================================================ INFO: For this product the default disk space requirements are: /opt 250000 K /var/adm 5000 K /var/tmp 1000 K INFO: Checking default disk space requirements... INFO: /opt has insufficient space for installation. INFO: Express Install has been disabled. ============================================================ INFO: Local disks on this machine with enough space to install: Filesystem kbytes used avail capacity Mounted on /dev/dsk/c0t4d0s6 1925720 288623 1444527 17% /usr2 Where should the product be installed ? [/usr2/CSCOipm]
The IPM server software uses the following default ports:
|
Note The IPM client and server software must be set up to communicate on the same port. If you are installing the IPM client on the same machine as the IPM server, then the installation program handles this automatically. If you are installing the IPM client on a separate system from the server, you must make sure the ports specified during the client installation match those installed for the IPM server. In most installation situations the default ports should be available for the IPM client and server. |
# netstat -a -n -f inet -P {tcp|udp}
|
Note If you are specifying an alternate port, remember that ports 1 through 1023 are reserved for system processes. |
The following procedure explains how to download, uncompress, extract, and install the IPM client software on a Solaris system.
To install the IPM client on Solaris using the Web interface:
Step 2 From your browser, go to the URL for the IPM Web Server (for example, http://youripmserver:1744). The IPM Server Home Page is displayed (Figure 4-1).
|
Note If you do not have this information, contact the system administrator who installed the IPM server software. |
Step 3 Click Download Solaris Client. The IPM Client for Solaris page (Figure 4-2) is displayed.
Step 4 Click Download IPM Client for Solaris to download the client software installation files.
Step 5 When prompted, specify the directory where you want the installation software files to be downloaded, such as /temp-directory.
Step 6 From the Solaris command line, change to the directory where you downloaded the installation software and uncompress the files using the following command:
# uncompress CSCOipmClient.tar.Z
Step 7 In the directory where you uncompressed the files, extract the IPM client installation files to the CDImage directory using the following command:
# /usr/bin/tar -xvf CSCOipmClient.tar
Step 8 Change to the CDImage directory and run the IPM client software installation program using the following command:
# ./setupCli.sh
Step 9 After verifying that the IPM client software installed successfully, remove all installation files in the temporary directory using the following command:
# rm -rf temp_directory
Where temp_directory is the directory containing the downloaded files.
To check for installation error messages:
# more install_directory/install/cisco_ipm_install.log
Where install_directory is directory where IPM was installed. The default installation directory for IPM is /opt/CSCOipm.
Step 2 Press the Space bar to scroll through the display one screen at a time.
To view packaging information for the IPM server and client:
#pkginfo -l CSCOipm-s#pkginfo -l CSCOcwbS#pkginfo -l CSCOipm-c
Step 2 Verify that you receive output similar to the following display for each component you query with the pkginfo command:
PKGINST: CSCOipm-s
NAME: Cisco IPM Server
CATEGORY: application
ARCH: sparc
VERSION: 2.2
BASEDIR: /opt/CSCOipm
VENDOR: Cisco Systems, Inc
DESC: Cisco IPM Server
PSTAMP: nm-rtp-view2991220162731
INSTDATE: Dec 21 1999 11:44
HOTLINE: 1-800-553-2447
EMAIL: tac@cisco.com
STATUS: completely installed
FILES: 260 installed pathnames
26 directories
61 executables
1 setuid/setgid executables
113600 blocks used (approx)
If the result of the pkginfo command states that the package was not found as in the following example, then the software is not installed.
ERROR: information for "CSCOipm-s" was not found
You can also start the IPM server and client by using the following commands:
# cd /opt/CSCOipm/bin # ./ipm
If you installed the IPM server and client on different systems, use the following commands to start IPM:
#cd /opt/CSCOipm/bin#./ipm start
# cd /opt/CSCOipmClient/bin # ./ipm start client server_name
If the IPM server and client installation was successful, the IPM Main window opens (Figure 4-3).
The uninstall program provides you with a menu similar to that presented for installation. You can choose whether to uninstall both the IPM client and server software (for example, after a failed installation) or uninstall each component individually.
The IPM software consists of the following packages:
When you uninstall both the IPM server and client software on the same system, all of the listed package components must be uninstalled successfully. When you uninstall only the IPM server, both the components (CSCOcwbS and CSCOipm-s) of the IPM server software must be uninstalled successfully. When you uninstall only the IPM client, only the client component (CSCOipm-c) must be uninstalled successfully.
Uninstalling IPM on Solaris is discussed in the following sections:
Uninstall both the IPM server software and client software on a Solaris system, either at the same time or separately, using the following menu options provided by the uninstall program.
1. Uninstall IPM Server and Client---Use when the IPM server and client software reside on the same Solaris system and you want to remove all of the IPM software on that system. This option removes all of the IPM packages from the system.
2. Uninstall IPM Server Only---Use when you want to remove only the IPM server software on this system. This option removes both the common services (CSCOcwbS) package and the IPM server (CSCOipm-s) package.
|
Note Uninstalling the IPM server also disables the IPM client. To uninstall the IPM server, we strongly recommend you choose option 1 (uninstall both the IPM server and the IPM client). |
3. Uninstall IPM Client Only---Use when you want to remove only the IPM client software on this system. This option removes the IPM client (CSCOipm-c) package.
To uninstall the IPM software on Solaris:
|
Note To stop the uninstall process at any time, press Break or Ctrl-C. |
Step 2 If you are running an IPM client locally, stop the client by selecting File > Exit from the IPM Main window.
Step 3 Stop the IPM server by running the following commands:
#cd /opt/CSCOipm/bin#./ipm stop
Step 4 If you want to preserve any of the IPM server data in the database, run the following commands to change directories and copy the database to a temporary directory:
# cd /opt/CSCOcwbS/db/CSCOipm # cp IPMDB.db /tmp
Step 5 To start the uninstall script, run the following commands:
# cd /opt/CSCOipm/install # ./uninstall.sh
The following menu appears:
********************************************************************** * * * Cisco Systems * * + + + + * * | | Internetwork | | * * +|+ +|+ Performance Monitor +|+ +|+ * * +|||||+ +|||||+ +|||||+ +|||||+ * * ++|||||||++++|||||||++ Uninstall Program ++|||||||++++|||||||++* * Empowering The ================== Internet Generation* * * ********************************************************************** 1) Uninstall IPM Server and Client 2) Uninstall IPM Server Only 3) Uninstall IPM Client Only Please choose an option ->
Step 6 Type the number of the desired option and press Enter.
Step 7 To continue uninstalling the package components, respond to the confirmation messages to verify that you want to remove the server packages (CSCOcwbS and CSCOipm-s) or client package (CSCOipm-c).
Step 8 When the uninstall is complete, verify that you receive messages corresponding to the packages you selected for removal. The following example shows the message received during an uninstall of the IPM server package. You should receive a similar set of messages for the common services package (CSCOipm-s) and the client package (CSCOipm-c), depending on what you have selected to uninstall.
Removal of <CSCOcwbS> was successful. INFO: The following Cisco IPM INFO: packages have been successfully deleted from the system: CSCOipm-s CSCOcwbS Please review /var/tmp/cisco_ipm_uninstall.log for detailed results
Step 9 To further verify that the IPM server and its associated services are uninstalled, run the following pkginfo commands:
# pkginfo -l CSCOcwbS # pkginfo -l CSCOipm-s # pkginfo -l CSCOipm-c
Step 10 Verify that you receive a message for each package you uninstalled as shown in the following example, indicating that the package could not be found:
ERROR: information for "CSCOipm-s" was not found
Posted: Fri Jul 28 12:11:30 PDT 2000
Copyright 1989-2000©Cisco Systems Inc.