Feedback
Table Of Contents
Hardware and Software Requirements
Mounting and Unmounting the CD-ROM Drive on Solaris
Mounting a NFS-Exported CD-ROM Drive
Steps to Perform on the Remote System
Steps to Perform on the Local System
Unmounting a Local CD-ROM Drive
Unmounting a Remote CD-ROM Drive
Overview of Installing IPM on Solaris
Running the Setup Program on Solaris
Running the Express Installation
Installing IPM to a Different Directory
Installing the IPM Client on Solaris Using the Web Server
Verifying IPM Installation on Solaris
Viewing Packaging Information for the IPM Server and Client
Verifying the Installation Directories
Overview of Uninstalling IPM on Solaris
Running the Uninstall Program on Solaris
Installing IPM on Solaris
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:
•
Hardware and Software Requirements
•
•
•
Quick Start for Solaris
This section provides basic information for installing IPM on a Solaris system.
To install the IPM software on a Sun Solaris system:
Step 1
•
•
Step 2
Step 3
Step 4
# ./setup.shStep 5
•
•
•
The following message appears:
Enter full Netscape browser executable pathname: ? [/opt/netscape/netscape]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 directory other than the default directory, type the full path (including file name) where the executable file is located.
The IPM installation program continues and determines whether your system meets the hardware and software requirements for running IPM.
Note
If your system meets the requirements for IPM, the following prompt appears:
New password:Step 6
The password is case sensitive and should begin with an alphabet. You can enter only a maximum of 15 characters and you can enter only alphanumeric characters.
Step 7
The password is case sensitive and should begin with an alphabet. You can enter only a maximum of 15 characters and you can enter only alphanumeric characters. IPM displays the following prompt:
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 prompts you for information such as port numbers and Netscape executable path.
Step 9
After IPM is successfully installed, the following IPM start-up menu appears.
*********************************************************************** Cisco Systems ** + + + + ** | | Internetwork | | ** +|+ +|+ Performance Monitor +|+ +|+ ** +|||||+ +|||||+ +|||||+ +|||||+ ** ++|||||||++++|||||||++ Startup Options ++|||||||++++|||||||++** Empowering The =============== Internet Generation***********************************************************************1) Start IPM Server and Client2) Start IPM Server Only3) Exit SetupPlease choose an option ->Step 10
Hardware and Software Requirements
This section describes the hardware and software requirements to run IPM on a Solaris system. It includes the following sections:
Note
Hardware Requirements
Your system must meet the following hardware requirements to run IPM:
•
•
•
•
•
Software Requirements
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.
Solaris Patch Requirements
The Solaris patches listed by version in this section are required to install IPM. These patches can be installed separately or as a jumbo patch from Sun Microsystems, Inc.
To verify the patches installed on your Solaris system, run the showrev -p command.
To obtain the patches, contact your Sun Microsystems representative, or download them from the Sun Web site.
Table 4-1 lists the required and recommended patches for Solaris 2.7 and 2.8.
Caution
Becoming the Root User
To install and configure IPM, you must be logged in as the root user on the system where you want to install IPM.
Caution
If you are not logged in, log in as the root user by entering:
> login: root> Password: rootpasswordIf you are already logged in, but not as the root user, use the su command to change your login to root:
# su# Password: rootpasswordMounting and Unmounting the CD-ROM Drive on Solaris
You can install the IPM server or client software from a CD-ROM drive connected to your local system or from a CD-ROM drive connected to a remote system. In either case, you must first mount the CD-ROM drive. Mounting a device makes it available to the local file system.
Mounting a Local CD-ROM
To mount a local CD-ROM:
Step 1
Step 2
If the /cdrom directory does not already exist, create it using the mkdir command:
# mkdir /cdromStep 3
Note
If you are running File Manager, a separate File Manager window displays the contents of the CD-ROM.
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 grepDo one of the following:
•
# /usr/sbin/vold &•
# kill -9 process_ID_number# /usr/sbin/vold &
Note
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/cdrom0Where:
-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.
Mounting a NFS-Exported CD-ROM Drive
IPM installation from a device on a remote system does not require any disk space on the remote system. The software is copied across the network to the local system.
Caution
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:
•
•
Steps to Perform on the Remote System
On the remote system:
Step 1
If the /cdrom directory does not already exist, create it using the mkdir command:
# mkdir /cdromStep 2
Note
If you are running File Manager, a separate File Manager window displays the contents of the CD-ROM.
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 grepDo one of the following:
•
# /usr/sbin/vold &•
# kill -9 process_ID_number# /usr/sbin/vold &
Note
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/cdrom0Where:
-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 3
share -F nfs -o ro -d /cdrom/cdrom0Where:
-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 4
# ps -ef | grep nfs | grep -v grepVerify that the /usr/lib/nfs/nfsd and /usr/lib/nfs/mountd daemons are running.
If the daemons you verified are not running, enable your machine as an NFS server by entering:
# /etc/init.d/nfs.server startStep 5
# share# shareall
Steps to Perform on the Local System
On the local system:
Step 1
Step 2
If the /cdrom directory does not already exist, create it using the
mkdir command:# mkdir -p /cdrom/ipmStep 3
# /usr/sbin/mount -r remote_hostname:/cdrom/cdrom0 /cdrom/ipmThe remote CD-ROM is mounted and ready for software installation on the local system.
Unmounting the CD-ROM Drive
After you install IPM, you must unmount the CD-ROM drive as explained in the following sections:
•
•
Unmounting a Local CD-ROM Drive
To unmount a local CD-ROM drive:
Step 1
Step 2
# cd# umount /cdrom/cdrom0Step 3
Unmounting a Remote CD-ROM Drive
To unmount a remote CD-ROM drive:
Step 1
# umount /cdrom/ipmStep 2
# umount /cdrom/cdrom0Step 3
Installing IPM on Solaris
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 2000 Professional, Windows XP Professional, or Windows 2000 Server systems.Overview of Installing IPM on Solaris
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
Running the Setup Program on Solaris
Before you run the setup program on Solaris:
•
If the IPM installation program determines that Netscape Communicator is installed in the default directory, /opt/netscape/netscape, then this location is used.
If necessary, you can change the location of Netscape Communicator after installing IPM by using the ipm browserpath command.
You can run IPM without Netscape, but you need Netscape 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 1
Step 2
Step 3
# cd /cdrom/cdrom0Step 4
# ./setup.shThe 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 Client3) Install IPM Client Only4) Exit SetupPlease choose an option ->Step 5
The following message appears:
Enter full Netscape browser executable pathname: ? [/opt/netscape/netscape]Step 6
The IPM installation program determines whether or not your system meets the hardware and software requirements for running IPM.
If your system meets the requirements for IPM, the following prompt appears:
New Password ->
Note
Step 7
The password is case sensitive and should begin with an alphabet. You can enter only a maximum of 15 characters and you can enter only alphanumeric characters.
Step 8
The password is case sensitive and should begin with an alphabet. You can enter only a maximum of 15 characters and you can enter only alphanumeric characters.
IPM displays the following prompts:
Do you want the Express Install (y/n)? [Y]Step 9
•
•
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 10
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:$PATHTo access the IPM Web Server use the URL:http://dheeru-u10:1744in your web browser.Check the documentation for supported browsers and versions.============================- Error Summary -=========================No Errors were encountered during installation.======================================================================Started : Tue Apr 9 06:30:38 Asia/Calcutta 2002Finished: Tue Apr 9 06:51:02 Asia/Calcutta 2002=========================================================================================- IPM Server Install Tool Completed -====================================================================================
Note
Step 11
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 Client2) Start IPM Server Only3) Exit SetupPlease 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-sun42) Start IPM Client and Connect to Alternate Remote Server3) Exit SetupPlease choose an option ->To start the IPM server and client at a later time from the command line, enter:
# cd /opt/CSCOipm/bin# ./ipmTo start only the IPM server at a later time from the command line, enter:
# cd /opt/CSCOipm/bin# ./ipm startFor a complete list of all of the IPM commands, see the "IPM Command Reference" appendix in the User Guide for Internetwork Performance Monitor.
Running the Express Installation
The IPM software express installation method allows you to accept all of the default settings and minimizes the need to respond to system prompts.
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 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 Client3) Install IPM Client Only4) Exit SetupPlease choose an option -> 3=======================================================================================- IPM Client Install Tool Started -==================Started : Tue Apr 9 17:14:59 PDT 2002Host : SunOS ipm01-u10 5.8 Generic_108528-13 sun4u sparc SUNW,Ultra-5_10Version : 2.5.0.0============================================================================================================================================ ===================- System Requirements Check -============================================================================================ INFO: Checking UID... root, OK.INFO: Checking Install Image... OK.INFO: Checking Host Operating System... SunOS, OK.INFO: Checking Operating System Version... 5.8, OK.INFO: Checking Solaris patches [108528-13]...OK.INFO: Checking Solaris patches [108652-35]...OK.INFO: Checking Solaris patches [108827-15]...OK.INFO: Checking Solaris patches [109324-02]...OK.INFO: Checking Solaris patches [109326-05]...OK.INFO: Checking Solaris patches [110286-02]...OK.INFO: Checking Solaris patches [110615-01]...OK.INFO: Checking Solaris patches [110662-02]...OK.INFO: Checking Solaris patches [110670-01]...OK.INFO: Checking Solaris patches [110700-01]...OK.INFO: Checking Solaris patches [110898-02]...OK.INFO: Checking Solaris patches [110934-01]...OK.INFO: Checking Solaris patches [110945-01]...OK.INFO: Checking Solaris patches [110951-01]...OK.INFO: Checking Solaris patches [111085-02]...OK.INFO: Checking Solaris patches [111327-02]...OK.INFO: Checking Solaris patches [111626-01]...OK.INFO: This product requires:RAM 131072 KSWAP 262144 KINFO: Checking Ram... OK.INFO: Checking Swap... OK.INFO : Checking the - "casusers" group ... OKINFO : Checking the - "casuser" account ... OKINFO: 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 64000 K/var/sadm 1000 K/var/tmp 1000 K/tmp 1000 KINFO: Checking default disk space requirements... OK.===========================================================================================================================================- IPM Client Summary -===============================================================================INFO: The following ports will be used:INFO: [ 1] Web Server: 1744/tcpINFO: [ 2] Naming Server: 44342/udpThe Express Install takes all defaults and places the productin /opt. No more questions will be asked.Do you want the Express Install (y/n)? [Y] yIf 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.
Installing IPM to a Different Directory
To install the IPM software in a directory other than the /opt default directory, do not run the express installation method. The standard installation method allows you to specify a new location to install the IPM software.
If the setup program detects insufficient space in the /opt default directory, it cannot execute the express installation and it looks for an alternate directory.
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 700000 K/var/adm 5000 K/var/tmp 1000 KINFO: 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% /usr2Where should the product be installed ? [/usr2/CSCOipm]Specifying Alternate Ports
The IPM server software uses the following default ports:
•
•
•
The IPM client software must know what ports the IPM server is using. By default, the client uses the following ports:
•
•
When you install the IPM server, or the IPM server and client, the IPM installation program determines whether or not these ports are available. (This is not done when you install only the IPM client.)
If there are conflicts with the ports, the software provides you with the option to specify an alternate port number.
For example, if port 44342/udp is already in use for the Naming Server, IPM prompts you to specify an alternate port.
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.
Verifying Port Usage
IPM registers all the ports it uses in the /etc/services file. If you want to find out what ports are currently in use on your system, you can run the following netstat command for the corresponding port type (tcp or udp):
# netstat -a -n -f inet -P {tcp|udp}
Caution
Installing the IPM Client on Solaris Using the Web Server
You can access the IPM client installation software from the IPM Web Server. This is useful if you do not have the CD-ROM, or if you prefer to download the software from the IPM server.
After you have downloaded the IPM client installation software to your system, you must install the software on your local system by running the setupCli.sh command.
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 1
Step 2
The IPM Server Home Page appears (Figure 4-1).
Figure 4-1 IPM Server Home Page
Note
Step 3
The IPM Client for Solaris page (Figure 4-2) appears.
Figure 4-2 IPM Client for Solaris Page
Step 4
Step 5
Step 6
Step 7
# uncompress CSCOipmClient.tar.ZStep 8
# /usr/bin/tar -xvf CSCOipmClient.tarStep 9
# ./setupCli.shStep 10
# rm -rf temp_directoryWhere temp_directory is the directory containing the downloaded files.
Verifying IPM Installation on Solaris
You can verify successful installation of the IPM server and client software by:
•
•
Checking for Error Messages
During installation, messages are recorded in a log file to provide diagnostic information about problems that might arise. The location of the installation log file is provided at the end of the IPM installation script.
To check for installation error messages:
Step 1
# more install_directory/install/cisco_ipmsvr_install.logWhere install_directory is directory where IPM was installed. The default installation directory for IPM is /opt/CSCOipm.
Step 2
Viewing Packaging Information for the IPM Server and Client
You can use the pkginfo command to verify that the IPM server (CSCOipm-s and CSCOcwbS) and IPM client (CSCOipm-c) software packages are installed on your system.
To view packaging information for the IPM server and client:
Step 1
# pkginfo -l CSCOipm-s# pkginfo -l CSCOcwbS# pkginfo -l CSCOipm-cStep 2
PKGINST: CSCOipm-sNAME: Cisco IPM ServerCATEGORY: applicationARCH: sparcVERSION: 2.5BASEDIR: /opt/CSCOipmVENDOR: Cisco Systems, IncDESC: Cisco IPM ServerPSTAMP: rme33-u10m02110619INSTDATE: Apr 02 2002 14:48HOTLINE: 1-800-553-2447EMAIL: tac@cisco.comSTATUS: completely installedFILES: 532 installed pathnames20 directories491 executables217258 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
Verifying the Installation Directories
After you install IPM, use the ls command to verify that you have a new directory structure containing the IPM software:
•
•
Starting IPM
After you install the IPM server and client software, verify that you can start the IPM software. You can start the IPM software by selecting the corresponding option on the start-up menu after the setup program is complete.
You can also start the IPM server and client by entering:
# cd /opt/CSCOipm/bin# ./ipmIf 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_nameIf the IPM server and client installation was successful, the IPM Main Window opens (Figure 4-3).
Figure 4-3 IPM Main Window
Uninstalling IPM on Solaris
The uninstall program provides you with a menu similar to that presented for installation. You can choose 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:
•
•
Overview of Uninstalling IPM on Solaris
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.
2.
Note
3.
Caution
Running the Uninstall Program on Solaris
To uninstall the IPM software on Solaris:
Note
Step 1
If you are running an IPM client locally, stop the client by selecting File > Exit from the IPM Main Window.
Step 2
# cd /opt/CSCOipm/bin# ./ipm stopIf you want to preserve any of the IPM server data in the database, run the following command to change directories and copy the database to a temporary directory:
# cd /opt/CSCOcwbS/db/CSCOipm# cp IPMDB.db /tmp# cp .dbpassword /tmpStep 3
# cd /opt/CSCOipm/install# ./uninstall.shThe following menu appears:
*********************************************************************** Cisco Systems ** + + + + ** | | Internetwork | | ** +|+ +|+ Performance Monitor +|+ +|+ ** +|||||+ +|||||+ +|||||+ +|||||+ ** ++|||||||++++|||||||++ Uninstall Program ++|||||||++++|||||||++** Empowering The ================== Internet Generation***********************************************************************1) Uninstall IPM Server and Client2) Uninstall IPM Server Only3) Uninstall IPM Client Only4) ExitPlease choose an option ->Step 4
Step 5
Step 6
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 IPMINFO: packages have been successfully deleted from the system:CSCOipm-s CSCOcwbSPlease review /var/tmp/cisco_ipmsvr_uninstall.log for detailed resultsStep 7
# pkginfo -l CSCOcwbS# pkginfo -l CSCOipm-s# pkginfo -l CSCOipm-cStep 8
ERROR: information for "CSCOipm-s" was not found
