|
|
This chapter describes how to install the IPM server and client software on a Sun Solaris system. It provides information on the following topics:
To run IPM on a Sun Solaris system you must have the Solaris version 2.5.1 or version 2.6 operating system software. In addition, you need the latest recommended patches from Sun Microsystems, Inc. and the required patches for IPM.
The following minimum patch levels are required to run IPM on Solaris version 2.5.1:
The following minimum patch level is required to run IPM on Solaris version 2.6:
 | Caution If you do not have the required patch level installed, then you can continue with the installation, but some features might not work or IPM might not operate as expected. |
For additional information about hardware and software requirements to run IPM see the "Preparing to Install IPM" chapter.
To install and configure IPM, you must know the root user's password to log in to your system as the root user or become the root user with the su command.
| 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
Insert the IPM CD-ROM into the CD-ROM drive and perform the following steps:
Step 1 Log in as the root user, as described in the "Becoming the Root User" section. The command prompt changes to the pound sign (#).
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.
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 -15 process_ID_numberStep 6 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 1 Log in as the root user as described in the "Becoming the Root User" section. The command prompt changes to the pound sign (#).
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.
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 -15 process_ID_numberStep 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 Be sure that 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 that 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 1 Go to the machine on which you want to install IPM.
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 need to unmount the CD-ROM drive as explained in the following sections:
To unmount a local CD-ROM drive follow these steps:
Step 1 Log in as the root user as described in the "Becoming the Root User" section. The command prompt changes to the pound sign (#).
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 follow these steps:
Step 1 Log in as the root user on the local machine and run the following command:
# 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 workstation that is located on the same network as the IPM server. The IPM server on Sun Solaris can also be accessed by IPM clients running Windows NT.
You can install both the IPM server software and client software on a Sun Solaris system, either at the same time or separately 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 the IPM server only, then both the components (CSCOcwbS and CSCOipm-s) of the IPM server software must be successfully installed.
Before you run the setup program on Sun Solaris note the following information:
To begin the installation of the IPM software on Sun Solaris perform the following steps.
Step 1 Log in as the root user as described in the "Becoming the Root User" section.
Step 2 Mount the CD-ROM drive, as described in the "Mounting and Unmounting the CD-ROM Drive on Sun 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 Server Only 4) Install IPM Client Only 5) 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.
Step 6 Type Enter to accept the default path or type the full path (including file name) to the Netscape browser binary file when the following message appears:
Enter full netscape browser executable pathname: ? [/opt/netscape/netscape]
Step 7 If IPM has verified that the system environment is acceptable and you are given the option to perform the express installation, do one of the following after you receive the following message:
Do you want the Express Install (y/n)? [Y]
Step 8 If IPM has disabled the express installation, then respond to the messages issued to specify a new port or another directory location to continue with the installation.
Step 9 Verify that you receive messages of successful completion of the installation and that no errors were encountered, as 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. To use this product, set your path to: /opt/CSCOipm/bin:/opt/CSCOcwbS/bin To access the web server for client image downloads, use the URL: http://youripmserver:1744 in your web browser. Check the documentation for supported browsers and versions. ========================- Error Summary -======================== No Errors were encountered during installation. ================================================================= Started : Fri Dec 11 10:22:28 EST 1998 Finished: Fri Dec 11 10:30:19 EST 1998 ================================================================= ===============- IPM Server Install Tool Completed -============= ================================================================= Please review /var/tmp/cisco_ipm_install.log for detailed results
Step 10 Depending on the installation option that you selected, a menu appears with options to start the software or exit setup. If the server and client software has been successfully installed, then select an option to start the software.
The following menu appears when you install the client software only:
*********************************************************************** * Cisco Systems * * + + + + * * | | Internetwork | | * * +|+ +|+ Performance Monitor +|+ +|+ * * +|||||+ +|||||+ +|||||+ +|||||+ * * ++|||||||++++|||||||++ Startup Options ++|||||||++++|||||||++ * * Empowering The =============== Internet Generation * * * *********************************************************************** 1) Start IPM Client and Connect to Remote Server 2) Exit Setup Please choose an option ->
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 is set up to use are available and that there is enough space in the default installation directory /opt. If your system meets these requirements, then the installation program provides the option to run the express installation. 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 Server Only 4) Install IPM Client Only 5) Exit Setup Please choose an option -> 3 ================================================================= ================================================================= ================- 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, then the express installation is disabled and 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 where 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. Accept the proposed directory by pressing Enter or by specifying another directory.
============================================================ ================- 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:
# netstat -a -n -f inet - p {tcp|udp}
For requirements and information about using the web server see the "Installing the IPM Client Software Using the Web Server" chapter. The following procedure explains how to download, uncompress, extract, and install the IPM client software on a Sun Solaris workstation.
To install the IPM client on Sun Solaris using the web interface:
Step 1 Create a temporary directory in a disk partition that contains at least 60 MB of space on the machine where you want to install the IPM client software.
Step 2 From your browser, go to the URL for the IPM web server (for example, http://youripmserver:1744).
Step 3 From the IPM home page, click Solaris 2.5.1 & 2.6.
The IPM Client for Solaris 2.5.1 and 2.6 page (Figure 5-1) appears.
Step 4 From the IPM Client for Solaris 2.5.1 & 2.6 page, click where indicated in the first step instructing you to download the client software installation files.
Step 5 When queried, specify the directory where you want the installation software files to be downloaded.
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 commands:
# cd CDImage # ./setupCli.sh
Step 9 After you have verified successful installation of the client software, remove all files in the temporary directory where you downloaded the installation files using the following command:
# rm -rf CDImage CSCOipmClient.tar
To examine the error logs for error messages that might have been generated during the installation process, use the following command:
# more /opt/CSCOipm/install/cisco_ipm_install.log
Press the space bar to scroll through a display one screen at a time.
Step 1 Run the pkginfo command as shown in the following examples:
#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 that you have queried with the pkginfo command:
PKGINST: CSCOipm-c
NAME: Cisco IPM Client
CATEGORY: application
ARCH: sparc
VERSION: 2.0
BASEDIR: /opt
VENDOR: Cisco Systems, Inc
DESC: Cisco IPM Client
PSTAMP: nm-rtp-view1981119112510
INSTDATE: Nov 19 1998 17:05
HOTLINE: 1-800-553-2447
EMAIL: tac@cisco.com
STATUS: completely installed
FILES: 1169 installed pathnames
141 directories
28 executables
43583 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 currently installed.
ERROR: information for "CSCOipm-s" was not found
# cd /opt/CSCOipm/bin # ./ipm
#cd /opt/CSCOipm/bin#./ipm start
# cd /opt/CSCOipmClient/bin # ./ipm start client
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 need to be successfully uninstalled. When you uninstall the IPM server only, then both the components (CSCOcwbS and CSCOipm-s) of the IPM server software need to be successfully uninstalled.
Uninstalling IPM on Sun Solaris is discussed in the following sections:
Uninstall both the IPM server software and client software on a Sun Solaris system, either at the same time or separately, using the following menu options provided by the setup 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 only want to remove the IPM server software on this system. This option removes both the common services (CSCOcwbS) package and the IPM server (CSCOipm-s) package.
3. Uninstall IPM Client Only---Use when you only want to remove the IPM client software on this system. This option removes the IPM client (CSCOipm-c) package.
Complete the following steps to uninstall the IPM software on Sun Solaris:
Step 1 Log in as the root user as described in the "Becoming the Root User" section.
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 database engine and 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 that you selected to remove. 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 that you uninstalled as shown in the following example, indicating that the package can no longer be found:
ERROR: information for "CSCOipm-s" was not found
If you want to reinstall IPM software release 2.0 on Sun Solaris it is not necessary to uninstall and reinstall the software. The installation program detects if there is an existing version installed on the system and allows you to confirm that you want to overwrite the existing installation. If you confirm the overwrite, then everything but the data is overwritten. In this case, the reinstallation maintains the directory structure of the previous installation, including any user-specified directory.
However, if you want to change the directory structure to specify an alternate directory for the reinstallation of the IPM software, then you must uninstall and reinstall the IPM software.
To reinstall the IPM software after you have uninstalled the server, follow the procedure described in the "Installing IPM on Sun Solaris" section.
Posted: Fri Mar 12 11:41:09 PST 1999
Copyright 1989-1999©Cisco Systems Inc.