cc/td/doc/product/rtrmgmt/cw2000/cfm/cfm10
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Installing CFM on Solaris

Installing CFM on Solaris

This chapter describes how to install the CFM server software on a Sun Solaris system. It also provides information on verifying the installation and uninstalling and reinstalling CFM on Solaris.

It includes the following sections:

Installation Overview for Solaris

Perform the following steps to install the CFM server software on a Sun Solaris system. If you need more details about any of the installation steps provided here, see the relevant sections of this chapter.


Step 1 Verify that your Solaris system meets the requirements listed in the
"Server Hardware and Software Requirements" section.

Step 2 Log in as the root user.

Step 3 Insert the CFM CD-ROM into the drive and mount the CD-ROM drive.

Step 4 Start the installation script by typing the following command and press Enter:

# ./setup.sh
 

Step 5 If prompted that port 4791/tcp is already in use, specify an alternate TCP port for the CFM server.

Step 6 When prompted for the location to install CFM, press Enter to accept the default path or type the full path for an alternate directory.

Step 7 Verify that you receive messages of successful completion of the installation. Review the installation log. The installation log path is specified at the end of the installation script.

Step 8 Verify that CFM is installed properly by starting the CFM server's interface using the following commands:

# cd /opt/CSCOcfm
# ./cfm start
 

Server Hardware and Software Requirements

This section describes the hardware and software requirements to run the CFM server on a Solaris workstation. 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 Content Flow Monitor available on CCO.

Server Hardware Requirements

Your system must meet the following hardware requirements to run the CFM server:


Note Because you launch CFM from CiscoWorks2000 desktop, the memory and swap space requirements provided for the CFM server include the requirements that your system must meet to run CiscoWorks2000 desktop and CFM simultaneously on the same workstation.

Server Software Requirements

Your system must meet the following software requirements to run the CFM server:

The CFM installation program automatically verifies your operating system version and also checks the level of Solaris patches that your system should have.

Sun Solaris Patch Requirements

The Solaris patches listed by version in this section are also required to install CFM. 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 at http://sunsolve.sun.com.

The following minimum patch levels are required to run CFM on Solaris version 2.6:


Caution If you do not have the required patches installed, you can continue with the installation, but CFM might not operate as expected.

Becoming the Root User

To install and configure CFM, you must be logged in as the root user on the system where you want to install CFM.


Caution As the root user, you can adversely affect your operating environment if you are unaware of the effects of the commands that you use. If you are a relatively inexperienced UNIX user, limit your activities as the root user to the tasks described in this manual.

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
 

Mounting and Unmounting the CD-ROM Drive on Solaris

You can install the CFM server 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 Insert the CFM CD-ROM into the CD-ROM drive.

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 might 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 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 -15 process_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.


Mounting an NFS Exported CD-ROM Drive

CFM 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 workstation.


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:

Steps to Perform on the Remote System

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.


Note The vold process manages the CD-ROM device and performs the mounting. The CD-ROM might 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 -15 process_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 4.

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 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
 

Steps to Perform on the Local System

On the local system perform the following steps:


Step 1 Go to the machine on which you want to install CFM.

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/cfm
 

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/cfm
 

The remote CD-ROM is mounted and ready for software installation on the local system.


Unmounting the CD-ROM Drive

After you install CFM, you need to 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 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:

# umount /cdrom/cdrom0
 

Step 3 Remove the CD-ROM and store it in a safe place.


Unmounting a Remote CD-ROM Drive

To unmount a remote CD-ROM drive:


Step 1 Log in as the root user on the local machine and run the following command:

# umount /cdrom/cfm
 

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.


Installing CFM on Solaris

The CFM installation takes approximately 5-10 minutes. At any time during the installation, you can interrupt the install process by pressing Ctrl-C. However, any changes to your system (for example, installation of new files or changes to system files) will not be undone.


Note You must install CiscoWorks2000 CD One before you can install CFM. If you attempt to install CFM on a workstation that does not contain CiscoWorks2000 CD, the installation program reminds you that you must install CiscoWorks2000 CD first.

To begin the installation of the CFM software on 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 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 CFM setup program verifies the system environment for installation of the software.

Step 5 If your workstation meets the requirements for CFM, the following prompt is displayed:

Do you want the Express Install (y/n)? [Y]
 

Step 6 If your workstation does not meet all the requirements for CFM, then the installation program proceeds with the standard installation and you are prompted for information, such as port numbers and product path and filename.

Step 7 If the CFM setup program determines that port 4791/tcp is already being used, a prompt is displayed asking which TCP port to use for the CFM server. Type an appropriate port number and press Enter.

Step 8 When prompted for where to install CFM, press Enter to accept the default path. Otherwise, if you want to install CFM in a different directory, type the full path.


Note When you specify an alternate installation directory, CFM creates links from the default /opt/CSCOcfm directory to the actual directory that you specify. As CFM is installed, you might notice that the files look as if they are being stored in /opt/CSCOcfm. However, these are virtual paths maintained by CFM and the real storage path is in the directory that you specified.

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 <CSCOcfm> was successful.
 
INFO: Checking Installation.
INFO: Package CSCOcfm    installed OK. Verifying... OK.
 
============================================================
Integrating to CiscoWorks 2000 Server...
============================================================
 
To use this product, set your path to:
   /opt/CSCOcfm
 
To start server, run:
   cfm start
 
==========================- Error Summary -===========================
No Errors were encountered during installation.
 
======================================================================
===============- Content Flow Monitor Install Completed -=============
======================================================================
Started :  Wed Jan 12 11:11:43 EST 2000
Finished:  Wed Jan 12 11:12:56 EST 2000
Please review /var/tmp/cisco_cfm_install.log for detailed results.
======================================================================
 

Note The CFM server software must be running before you can access the CFM server from a web browser. For information on starting the CFM server, see the "Starting the CFM Server" section.


Specifying Alternate Ports

By default, the CFM server software uses port 4791/tcp for the CFM server. The CFM installation program determines whether or not this port is available. If there is a conflict with the port, the software provides you with the option to specify an alternate port number. For example, if port 4791 is already in use for the CFM server, CFM requests that you specify an alternate port.

CFM registers all of the ports that 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}
 

Note If you are specifying an alternate port, remember that ports 1 through 1023 are reserved for system processes.

Verifying CFM Installation on Solaris

You can verify that the CFM server software have been successfully installed by performing the following tasks:

Checking for Error Messages

During installation, messages are recorded in a log file to provide diagnostic information about problems that arise. The location of the installation output is provided at the end of the CFM installation script.

To examine the error logs for error messages that might have been generated during the installation process, use the following command:

# more /var/tmp/cisco_cfm_install.log
 

Press the Space bar to scroll through a display one screen at a time.

Viewing Packaging Information for the CFM Server

To verify that the CFM server software is installed on your system:


Step 1 Run the pkginfo command as shown in the following example:

# pkginfo -l CSCOcfm
 

Step 2 Verify that you receive output similar to the following display:

       PKGINST:  CSCOcfm
          NAME:  Cisco Content Flow Monitor
      CATEGORY:  application
          ARCH:  sparc
       VERSION:  1.0
       BASEDIR:  /opt
        VENDOR:  Cisco Systems, Inc
          DESC:  Cisco Content Flow Monitor package.
        PSTAMP:  leang000112092910
      INSTDATE:  Jan 12 2000 11:18
       HOTLINE:  1-800-553-2447
         EMAIL:  tac@cisco.com
        STATUS:  completely installed
         FILES:    381 installed pathnames
                    17 directories
                    81 executables
                  6565 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 "cfm" was not found
 

Verifying the Installation Directories

After you install CFM, use the ls command to verify that you have a new directory structure containing the CFM software. For the CFM server, the default directory is /opt/CSCOcfm.

Starting the CFM Server

After you install the CFM software, verify that you can start the CFM server.

To start the CFM server on Solaris:


Step 1 Make sure that you are logged in as the root user as described in the
"Becoming the Root User" section.

Step 2 From the command prompt, issue the following commands:

# cd /opt/CSCOcfm
# ./cfm start
 

The Server Administration window (Figure 3-1) is displayed.


Figure 3-1: Server Administration Window



Note Exiting the Server Administration window shuts down the CFM server. To exit the Server Administration window, select File > Close or type cfm stop at the command line prompt and press Enter.


Uninstalling CFM on Solaris

To uninstall the CFM software on Solaris:


Step 1 Log in as the root user as described in the
"Becoming the Root User" section.

Step 2 Stop the CFM server by selecting File > Close from the Server Administration window or by using the following commands at the command line:

# cd /opt/CSCOcfm
# ./cfm stop
 

Step 3 To start the uninstall script, run the following commands:

# cd /opt/CSCOcfm/install
# ./uninstall.sh
 

Step 4 To continue uninstalling the package components, respond to the confirmation messages to verify that you want to remove the CFM package.


Note If you installed the CFM server in alternate directories from the CFM default directories, you might see warning messages such as "WARNING: /opt/CSCOcfm <no longer a directory>". Disregard these messages. The CFM software has links from the default paths to the directory that you specified during installation.

Step 5 When the uninstall is complete, verify that you receive messages indicating a successful uninstall. The following example shows the message received during a successful uninstall of the CFM server package.

INFO: Wed Jan 12 11:16:10 EST 2000, now removing CSCOcfm...
 
Removal of <CSCOcfm> was successful.
 
 
INFO: The following Cisco Content Flow Monitor
INFO: packages have been successful deleted from the system:
 
 CSCOcfm
 

Step 6 To further verify that the CFM server and its associated services are uninstalled, use the following command:

# pkginfo -l cfm
 

Step 7 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 "CSCOcfm-s" was not found
 

Reinstalling CFM on Solaris

Before you can reinstall CFM on a Solaris workstation, you must first uninstall the application. For information on uninstalling CFM, see the "Uninstalling CFM on Solaris" section.

To reinstall the CFM software rerun the setup.sh command from the original CD-ROM image of CFM. Follow the instructions for installing CFM provided in the "Installing CFM on Solaris" section.


hometocprevnextglossaryfeedbacksearchhelp
Posted: Sun Apr 2 12:23:24 PDT 2000
Copyright 1989 - 2000©Cisco Systems Inc.