Installing and Configuring the Multi-System Architecture

This chapter describes the steps for installing and configuring Cisco Info Center in the recommended, multi-system architecture. In this configuration:

the Info Server component, the Process Control component, and the Licensing component are installed on one host
the Cisco WAN Manager (CWM) Mediator and the Process control component are installed on a separate host
in addition, administrative desktop components may be installed on separate workstations
if you have purchased a license for the Info Gateway component, then the Gateway component is installed on the host that will run the Info Server component

This chapter contains the following sections:

Installing the Cisco Info Server Component

Installing the Cisco Info Server component involves three steps:

determining which components you will install on the host that runs the Info Server
mounting the CD-ROM
running the installation script

Determining the Components to Install

Use Table 2-1 in Chapter 2 to determine which system components to install on the host that will run the Info Server component.

Note At a minimum, you must install the Info Server component and the Process Control component on the host that runs the Info Server. If you will install licenses on the Info Server host, then you must also install the Licensing component. In addition, if you have purchased a license for the Info Gateway component, you can install the Info Gateway on the host that will run the Info Server.

Mounting the CD-ROM

Complete these steps to mount the CD-ROM.

Step 1 Log in as user root.

Step 2 Insert the CD-ROM into your computer's CD-ROM drive.

Step 3 The CD-ROM should mount automatically if you are running the Solaris Volume daemon (vold) as /cdrom/infocenter. If this daemon is not running, issue the following command to start it:

host# /etc/init.d/volmgt start

Or, mount the CD-ROM with the following command:

host# mount -o ro -F hsfs </dev/dsk/device> /cdrom

where </dev/dsk/device> is the CD-ROM drive device entry.

Running the Installation Program

Complete these steps to run the Cisco Info Center installation program.

Step 1 Change directory to the directory where you mounted the CD-ROM.

For example, if the CD-ROM is mounted in the /cdrom/infocenter directory, specify the following command:

host# cd /cdrom/infocenter

Step 2 Enter the following to start the Info Center installation script.

host# ./setup.sh

The installation utility starts and displays a list of Java interpreters found on your system. You are then prompted to specify a path to an interpreter:

0) I want to specify a path to an interpreter.
1) Use /bin/java
2) Use /bin/jre
3) Use /usr/bin/java
4) Use /usr/bin/jre
5) Use /bin/java
6) Use /bin/jre
7) Use /usr/bin/java
8) Use /usr/bin/jre
9) Terminate this installation.
Select a choice [0-9]:

Step 3 Enter a number that corresponds to the interpreter that you want to use.

For example, if your Java interpreter is in the /bin/java directory, enter 1.

The Welcome screen appears.

Figure 3-1:

Step 4 Click Next.

A dialog box appears and you are asked whether you are upgrading Cisco Info Center. The following message appears on the screen:

ONLY upgrade from CIC 1.1 to 1.2 is supported. Features that you
have customized or added other than additional fields added to
Object Server in your CIC 1.1 installation may not be upgraded to
1.2. Before upgrading make sure that you have a backup.

Step 5 If you are upgrading from CIC 1.1 to 1.2, ensure that you have backed up your 1.1 installation. For detailed instructions on the upgrade procedure refer to one of the following sections in "Upgrade Procedures."

If you are upgrading an installation using the single-system architecture, see "Upgrade Procedure for the Single-System Architecture" in Chapter 5.
If you are upgrading an installation using the multi-system architecture, see "Upgrade Procedures for the Multi-System Architecture" in Chapter 5.

The installation utility checks to make sure that your system is running the proper version of the Sun operating system.

If your system runs a supported version, the following message appears:

Verifying OS:
Supported OS. Click Next to continue.

Step 6 Click Next.

The system checks that your user ID is valid. If you have the correct user ID, the following message appears:

Checking User Id:
OK. Click Next to continue.

Step 7 Click Next.

The utility displays the README file for the software.

Step 8 Click Next.

You are prompted to accept the license agreement

Figure 3-2: Software License Agreement Screen

Step 9 Click on the check box to accept the terms of the license.

Step 10 Click Next.

The system displays the default installation directory (/opt/Omnibus).

Figure 3-3: Choosing the Destination Directory

Step 11 Do one of the following:

To accept the default destination directory, click Next.
If you want to change the destination directory, enter the path and name for the new installation directory.

If the specified destination directory does not exist, the following message appears:

The specified destination directory,
<directory name> does not exist. Would you like to
create this directory.

Step 12 Do one of the following:

If the directory shown in the message is the correct directory, click Yes.
If the directory shown in the message is not correct, click No and then re-enter the destination directory.

The system checks the specified directory for an existing version of Cisco Info Center. If an existing version is detected, the following message appears:

Legacy version exists
/opt/Omnibus/RELEASE_ID. Click cancel to exit
installation

Step 13 If there is an existing version of Info Center, click OK and then click Cancel to exit the installation program.

The system verifies that the existing directory is empty:

Step 14 Click Next.

The system checks for the common component and the following message appears:

Checking for Common component.
Common component not found. Click Next to continue.

Step 15 Click Next.

The system prompts you for the components that you want to install:

Figure 3-4: Choosing the Info Center Components to Install

Step 16 Click the check boxes for Process Control Component and Info Server Component.

Step 17 If you want to install the Licensing component on this host, click the check box for Licensing Component.

Step 18 If you have purchased a license for the Gateway component, click the check box for Info Gateway Component.

Step 19 Click Next.

A message appears asking if you want to overwrite any existing packages:

Figure 3-5: Overwrite Existing Package Prompt

Step 20 Do one of the following:

If you want to overwrite a previous installation, click Yes.
If there is no previous installation, click No.

Step 21 Click Install.

The installation program installs the selected packages. After the installation is complete, the system prompts you to finish the installation procedure.

Step 22 Click Finish.

The installation process is now complete.

Configuring the Info Server Component

After installing the Info Server component, start the configuration utility (nco_config) and then complete the steps to configure the component.

Starting the Configuration Utility

To start the configuration utility:

Step 1 Log in as user root.

Step 2 Set the OMNIHOME environment for ksh or sh shell:

host# OMNIHOME=/opt/Omnibus
host# export OMNIHOME
 
or for csh shell:
 
host# setenv OMNIHOME /opt/Omnibus

Step 3 Change to the following directory:

host# cd /opt/Omnibus/install

Step 4 Enter the following to start the configuration script:

host# ./nco_config

The following Configuration menu appears.

##################################################################
               Cisco Info Center Configuration Menu
##################################################################
 
           1.  Configure Info Server         
 
           2.  Help                          
 
           3.  Quit                          
 
Select one of the above options :

Note Configuration options reflect only those configurable options installed on the host.

The script displays the selected option and prompts you for confirmation.

You have Selected the following Info Center Components to be configured 
 
        Info Server

Do you want to continue (y/n)? [y]:

Step 5 Press Return to continue or specify N, then press Return to go back to the previous menu.

If you continue with the configuration process and the current installation directory is not /opt/Omnibus, the script automatically links the Cisco Info Center install directory to /opt/Omnibus.

However, when /opt/Omnibus is not the current installation directory and /opt/Omnibus already exists, either as a directory, file, or a link on the system, the following error message is displayed:

........ ...... 
*** Info Center Requires Installation in /opt/Omnibus*** 
*** /opt/Omnibus already exists, ***
*** Create a link to /opt/Omnibus from the <install directory> ***
*** at the end of this configuration script ***

The configuration utility now takes you through the steps to configure the Info Server component and the Process Control component. These are described in the following sections:

Configuring Cisco Info Server Properties

Complete these steps to configure the Info Server properties.

Step 1 Observe the following prompt.

*** Name for the Info Server must be alphanumeric beginning ***
*** With a letter and up to 11 characters long ***
Name for the Info Server [INFOSERVER]

Step 2 Do one of the following:

To accept the default name, INFOSERVER, press <Return>.
To specify a different name for the Info Server, enter an alphanumeric string of up to eleven characters, beginning with a letter.

The script converts any lowercase characters that you enter to uppercase and informs you of the converted Cisco Info Server name.

After you enter a valid Cisco Info Server name the following prompt appears:

Enter the Port Number for the Info Server [4100]:

Step 3 Do one of the following:

To accept the default port, press Return.
To change the port number, enter the number of an unused port.

The script validates the availability of the port and informs you when the port number you specified is already in use or is a reserved port. This process may take a few seconds. When the port number is in use or reserved, the following message is displayed:

Checking Port Availability Please Wait...
Port Number [4100] is already in use...Checking Port Number 4101
Enter the Port Number for the Info Server [4101]

The script automatically increments the port number and checks for port availability. It continues to do so until a free port is available and prompts you to accept this new port number.

Step 4 Press Return to accept the unused port number.

You are now ready to continue with the configuration of the Process Control properties.

Step 5 The following text is displayed:

Configure the Process Control Agent name as described in the next section.

Configuring Process Control Agent Properties

Complete these steps to configure the Process Control Agent properties.

Step 1 Observe the following prompt:

*** Name for the Process Agent must be alphanumeric beginning with ***
*** a letter, must NOT exceed 11 characters and must end with _PA ***
Name for the Info Server Process Agent [NCO_PA]

Step 2 Do one of the following:

To accept the default name, NCO_PA, press Return.
To specify another name, enter an alphanumeric string of up to eleven characters, beginning with a letter and ending with _PA.

The script validates the Process Control name and prompts you to specify the port number for the Process Control:

*** Port Number for the Process Agent must not be ***
*** the same as the Info Server Port Number [4100] ***
Enter the Port Number for the Info Server Process Agent [4200]:

Step 3 Do one of the following:

Press Return to accept the default port
Enter an unused port number.

The script validates the availability of the port number and also ensures the specified port number is not the port number selected for the Cisco Info Server. When the port number is in use or reserved, the following text is displayed:

Checking Port Availability Please Wait...
Port Number [4200] is already in use...Checking Port Number 4201
Enter the Port Number for the Info Server Process Agent [4201]

The script automatically increments the port number and checks for port availability. It continues to do so until a free port is available and prompts you to accept the new port number.

Step 4 Press Return to accept the unused port number. The following text is displayed:

Creating the new Process Agent NCO_PA
Adding its entry to omni.dat ... done
Creating the new Info Server INFOSERVER
Adding its entry to omni.dat... done
Generating the database files... Info Server INFOSERVER created
Updating /etc/services file ...done
Adding Info Server entry to /etc/services. . . done

You are now ready to specify the CWM Mediator hostname.

The next section discusses how to configure the Cisco Info Server to launch remote tools on the CWM Mediator workstation.

Specifying the CWM Mediator Hostname

The next portion of the configuration script configures the Process Control component on the Cisco Info Server machine with the properties of the Process Control Agent on the workstation(s) running the CWM Mediators (the workstation(s) running CWM).

Complete these steps to specify the CWM mediator hostname.

Step 1 Observe the following prompt:

Will this Info Server receive events from CWM Mediators (y/n) ? [y]:

Step 2 Press Return.

The following prompt appears:

*** Configuring Process Control on Info Server Machine requires ***
*** Properties of the Process Control on the CWM Machine ***
***
 
Configuring Info Server Process Control with Process Control on CWM Machine...
 
Enter Name of the CWM Host:

Step 3 Specify the hostname of the CWM workstation.

The script pings the specified hostname. If the specified workstation cannot be reached, the script displays a warning message indicating the unreachability of the CWM workstation and prompts you again for the hostname for verification.

When the CWM workstation cannot be reached, the script generates error messages during the generation of the communication interfaces. More details are available in Section, "Interfaces File", in Chapter 4, "Installing and Configuring the Single-System Architecture".

Trying to ping Host <hostname>... Host <hostname> is not reachable.
Is this the correct host for the CWM Mediators (y/n) [y]:

Step 4 Press Return to accept the specified hostname or N to go back.

You are now ready to specify the name and port of the CWM Mediator Process Control.

Specifying the CWM Mediator Process Control Name and Port Number

The next part of the installation script configures the CWM Mediator process control name and port number. Complete these steps to specify the CWM Mediator process control name and port number.

Step 1 Observe the following prompt:

Enter the Name for the Process Control on the CWM Machine [SVHOST1_PA]:

Step 2 Do one of the following:

If the Process Control Agent is already configured on the CWM Mediator workstation, specify the name of the Process Control Agent.
If the Process Control Agent is not configured on the CWM Mediator workstation, press Return to select the default name.

Note The name of the Process Control Agent can be any alphanumeric string up to eleven characters, beginning with a letter and ending with _PA. The name is not validated by the script. It is important that you specify this properly. For example, CISCO_PA and TIMBUKTU_PA are valid names.

The following prompt appears:

Enter the Port Number for the Process Control on the CWM Machine [4200]:

Step 3 Do one of the following:

If the Process Control Agent is already configured on the CWM Mediator workstation, specify the port number of the Process Control Agent.
If the Process Control Agent is not configured on the CWM Mediator workstation, press Return to specify the default port (4200).

The following prompt appears:

Will this Info Server receive events from any other CWM Mediators (y/n) ? [n]:

Step 4 Specify Y to enter another CWM Mediator host name, or press Return to accept the default (N) option. Upon selecting the N option, the following text is displayed:

Generating the NCO_PA config file
Running nco_igen... 
done
 
 
Do you wish to configure automatic startup upon system boot (y/n) [y]

Step 5 Press Return to accept the default (y) or n if you do not wish to configure automatic startup.

If you have accepted the default, the following message appears:

- scripts installed

Installing the CWM Mediator

The CWM Mediators, which consist of the HP NNM and Trapd Mediator, receive CWM event information from the HP NNM Trapd Mediator and from the CWM Service View agent.

Installing the CWM Mediators involves these steps:

mounting the CD-ROM
running the installation program

CWM Mediator - Mounting the CD-ROM

Complete these steps to mount the CD-ROM

Step 1 Insert the installation CD-ROM into the CD-ROM drive on the CWM mediator workstation.

Step 2 Log in as user root.

Step 3 The CD-ROM should mount automatically when running the Solaris Volume daemon (vold) as /cdrom/infocenter. If this daemon is not running, issue the following command:

host# /etc/init.d/volmgt start

or mount the CD-ROM with the following command:

host# mount -o ro -F hsfs </dev/dsk/device> /cdrom

where </dev/dsk/device> is the CD-ROM drive device entry.

CWM Mediator - Running the Installation Program

Complete these steps to run the installation script and install the CWM Mediator component.

Complete these steps to run the Cisco Info Center installation program.

Step 1 Change directory to the directory where you mounted the CD-ROM.

For example, if the CD-ROM is mounted in the /cdrom/infocenter directory, specify the following command:

host# cd /cdrom/infocenter

Step 2 Enter the following to start the Info Center installation script.

host# ./setup.sh

The installation utility starts and displays a list of Java interpreters found on your system. You are then prompted to specify a path to an interpreter:

0) I want to specify a path to an interpreter.
1) Use /bin/java
2) Use /bin/jre
3) Use /usr/bin/java
4) Use /usr/bin/jre
5) Use /bin/java
6) Use /bin/jre
7) Use /usr/bin/java
8) Use /usr/bin/jre
9) Terminate this installation.
Select a choice [0-9]:

Step 3 Enter a number that corresponds to the interpreter that you want to use.

For example, if your Java interpreter is in the /bin/java directory, enter 1.

The Welcome screen appears.

Figure 3-6: The Welcome Screen

Step 4 Click Next.

A dialog box appears and you are asked whether you are upgrading Cisco Info Center. The following message appears on the screen:

ONLY upgrade from CIC 1.1 to 1.2 is supported. Features that you
have customized or added other than additional fields added to
Object Server in your CIC 1.1 installation may not be upgraded to
1.2. Before upgrading make sure that you have a backup.

If you are upgrading an installation using the single-system architecture, see "Upgrade Procedure for the Single-System Architecture" in Chapter 5.
If you are upgrading an installation using the multi-system architecture, see "Upgrade Procedures for the Multi-System Architecture" in Chapter 5.

The installation utility checks to make sure that your system is running the proper version of the Sun operating system.

If your system runs a supported version, the following message appears:

Verifying OS:
Supported OS. Click Next to continue.

Step 6 Click Next.

The system checks that your user ID is valid. If you have the correct user ID, the following message appears:

Checking User Id:
OK. Click Next to continue.

Step 7 Click Next.

The utility displays the README file for the software.

Step 8 Click Next.

You are prompted to accept the license agreement.

Figure 3-7: Software License Agreement Screen

Step 9 Click on the check box to accept the terms of the license.

Step 10 Click Next.

The system displays the default installation directory (/opt/Omnibus).

Figure 3-8: Choosing the Destination Directory

Step 11 Do one of the following:

To accept the default destination directory, click Next.
If you want to change the destination directory, enter the path and name for the new installation directory.

If the specified destination directory does not exist, the following message appears:

The specified destination directory,
<directory name> does not exist. Would you like to
create this directory.

Step 12 Do one of the following:

If the directory shown in the message is the correct directory, click Yes.
If the directory shown in the message is not correct, click No and then re-enter the destination directory.

The system checks the specified directory for an existing version of Cisco Info Center. If an existing version is detected, the following message appears:

Legacy version exists
/opt/Omnibus/RELEASE_ID. Click cancel to exit
installation

Step 13 If there is an existing version of Info Center, click OK and then click Cancel to exit the installation program.

The system verifies that the existing directory is empty:

Step 14 Click Next.

The system checks for the common component and the following message appears:

Checking for Common component.
Common component not found. Click Next to continue.

Step 15 Click Next.

The system displays a dialog box that prompts you for the components that you want to install:

Figure 3-9: Choosing the Info Center Components to Install

Step 16 Click the check boxes for Process Control Component and Info Mediators Component.

Step 17 Click Next.

A message appears asking if you want to overwrite any existing packages:

Figure 3-10: Overwrite Existing Package Prompt

Step 18 Do one of the following:

If you want to overwrite a previous installation, click Yes.
If there is no previous installation, click No.

Step 19 Click Install.

The installation program installs the selected packages. After the installation is complete, the system prompts you to finish the installation procedure.

Step 20 Click Finish.

The installation process is now complete.

Configuring the CWM Mediator

After installing the CWM Mediator component, start the configuration utility (nco_config) and then complete the steps to configure it.

Step 1 Log in as user root.

Step 2 Set the OMNIHOME environment for ksh or sh shell:

host# OMNIHOME=/opt/Omnibus
host# export OMNIHOME
 
or for csh shell:
 
host# setenv OMNIHOME /opt/Omnibus

Step 3 Change to the following directory:

host# cd /opt/Omnibus/install

Step 4 Run the configuration script:

host# ./nco_config

The following Cisco Info Center Configuration menu appears:

###############################################################
               Cisco Info Center Configuration Menu
###############################################################
 
           1.  Configure CWM Mediators
 
           2.  Help                          
 
           3.  Quit

The script displays the selected option and prompts you for confirmation.

You have Selected the following Info Center Components to be configured 
 
        CWM Mediators
 
Do you want to continue (y/n) ? [y]:

Step 5 Press Return to continue or N to go back to the previous menu.

If you continue with the configuration process, and the current installation directory is not /opt/Omnibus, the script automatically links the Cisco Info Center install directory to /opt/Omnibus.

However, when /opt/Omnibus is not the current installation directory and /opt/Omnibus already exists either as a directory, file, or a link on the system, the following error message is displayed:

........ ...... 
*** Info Center Requires Installation in /opt/Omnibus*** 
*** /opt/Omnibus already exists, ***
*** Create a link to /opt/Omnibus from the <install directory> ***
*** at the end of this configuration script ***

The configuration utility now takes you through the steps to configure the CWM component and the Process Control component. These are described in the following sections:

CWM Mediator - Configuring Process Control Agent Properties

The next part of the configuration script configures the name and port number used by the Process Control Agent. Complete these steps to configure the process control agent on the device that runs the CWM Mediator.

Step 1 Observe the following prompt.

*** Name for the Process Agent must be alphanumeric beginning with 
*** a letter, must NOT exceed 11 characters and must end with _PA 
 
Name for the CWM Mediators Process Agent [SVHOST1_PA]:

Step 2 Do one of the following:

To accept the default name, SVHOST_PA, press Return.
To specify another name, enter an alphanumeric string up to eleven characters, beginning with a letter and ending with _PA.

The script validates the Process Control name and prompts you to specify the port number for Process Control:

Enter the Port Number for the CWM Mediators Process Control [4200]:

Step 3 Do one of the following:

To accept the default port, press Return.
To specify an unused port number, enter the port number.

The script validates the availability of the port number. If the port number is in use or reserved, the following message appears:

Checking Port Number Please Wait... done

You are now ready to configure the Info Server properties.

The following text is displayed:

The following section describes how to configure the CWM Mediators with Cisco Info Server properties.

Configuring the CWM Mediator with Cisco Info Server Information and Rules File Information

The next part of the configuration script configures the Info Server properties and prompts you for information required to generate the cisco.rules file. Complete these steps to configure the Info Server properties and provide rules file information.

Step 1 Observe the following prompts:

*** CWM Mediators must be configured with the Info Server Properties ***
 
Configuring Info Server Properties on the CWM Mediator Machine ...
 
Hostname of the Machine running the Info Server:

Step 2 Enter the hostname of the machine that is running the Info Server component.

Note The name of the Cisco Info Server can be any alphanumeric string up to eleven characters, beginning with a letter. The name is not validated by the script. It is important that you specify this properly. Valid names include: CISCO and INFOSERVER.

The following prompt appears.

Name of the Info Server to connect to [hostname]:

The installation script attempts to ping the specified host. If the host is not reachable, the following message appears:

Trying to connect to Host <hostname>. . . Host <hostname> not reachable.
Is this the correct hostname for the Info Server (y/n) [y]:

Step 3 If the hostname that entered is correct, enter y. Otherwise, enter n and then re-enter the hostname.

Step 4 You are prompted to enter the port name for the Info Server:

Enter the Info Server Port Number [4100]:

Step 5 Do one of the following:

To accept the default port number (port 4100), press Return.
To change the port number, enter the port number.

You are now ready to configure the Info Mediators.

Step 6 The following text appears:

************************************
Info Mediators configuration menu
************************************
 
        1. Trap Receiver, NNM and Syslog Mediators
        2. Trap Receiver and NNM Mediators
        3. Syslog Mediator only
 
Select one of the above options :1

Step 7 Enter the number that corresponds to the combination of Info Mediators that you want to install.

If you select option 3, the following message appears:

*** Configuring Syslog Mediator ***
 
Syslog Mediator configured
Configuring Process Control for CWM Mediators...done
Running nco_igen...

Step 8 If you selected option 1 or 2 from the Info Mediators configuration menu, complete these steps.

(a) Answer the following prompts:

*************************************************************
Info Center rules configuration for NNM and rttrapd Mediators
*************************************************************
 
The CWM installation on host "<hostname>" is version 9.2
 
Are you using SWSW 9.2 or higher on the BPX/IGX
monitored by CWM on host "<hostname>"? (y/n)? [y] 
 
Are you using any MGX 8850? -OR- Firmware 5.0x
on any MGX monitored by CWM on host "<hostname>"? (y/n)? [y]

The installation script generates a cisco.rules file that reflects the choices that you make and a message similar to the following appears.

CIC 1.2 will be configured to support the following:
 
        :-CWM 9.2 on host "<hostname>"
        :-SWSW 9.2 or higher on BPX/IGX
        :-MGX 8850 or Firmware 5.0 on at least one MGX
 
Is this correct? (y/n)? [y] y

(b) Do one of the following:

If the configuration shown in the prompt is correct, enter y.
If the configuration is not correct, enter n.

: If you respond by entering n, you are prompted once again to enter the rules file information.

You are now prompted for the IP address of the CWM machine:

IP address of the CWM machine [171.71.28.116]:

Step 9 Do one of the following:

To accept the IP address displayed with the prompt, press Return.
To specify another IP address, enter the new address.

You are prompted for the port number:

Port Number to run the Info Center Trap Receiver [4000]: 
Checking Port Availability Please Wait... done

Step 10 Do one of the following:

To accept the default port number (port 4000), press Return.
To specify another port number, enter the port number.

Step 11 You are prompted for the name of the database:

Name for the CWM Informix Database [stratacom]:

Step 12 Enter the name of your Informix database.

Step 13 The following messages appear:

Configuring CWM Mediators...
 
        Configuring nnm5 mediator...
        Configuring rttrapd mediator...
 
CWM Mediators Configured
 
Generating Lookup Files for the CWM Mediators
 
Generating empty files for the Info Mediators
Generating Node IP Address Lookup File... 
Generating Node Platform Lookup File... 
Generating Node Release Lookup File... 
Generating Node NetId Lookup File... 
Generating Node Model Lookup file... 
Generating NetId NetworkName Lookup File...
 
Generating SV+ Version Lookup File...

The following prompt appears:

Do you wish to configure automatic startup upon system boot? (y/n) [y]

Step 14 Press Return if you wish to configure automatic startup when the system is booted or n if you do not want this option.

If you respond y to the prompt, the following message appears:

Automatic Startup Scripts Installed

Installing Cisco Info Admin Desktops

The Cisco Info Admin Desktop can be installed on multiple Sun SPARC workstations acting as clients to the Cisco Info Server workstation. You can install the Admin Desktops on multiple hosts, including the host that is running the Info Server component.

Installing the CWM Mediators involves these steps:

mounting the CD-ROM
running the installation program

Cisco Info Admin Desktop - Mounting the CD-ROM

Step 1 Log in as user root.

Step 2 Insert the CD-ROM into the CD-ROM drive.

host# /etc/init.d/volmgt start

Or, mount the CD-ROM with the following command:

host# mount -o ro -F hsfs </dev/dsk/device> /cdrom

where </dev/dsk/device> is the CD-ROM drive device entry.

Cisco Info Admin Desktop - Running the Installation Program

On each workstation where you will run an Admin Desktop, complete these steps to run the installation program.

Complete these steps to run the Cisco Info Center installation program.

Step 1 Change directory to the directory where you mounted the CD-ROM.

For example, if the CD-ROM is mounted in the /cdrom/infocenter directory, specify the following command:

host# cd /cdrom/infocenter

Step 2 Enter the following to start the Info Center installation script.

host# ./setup.sh

The installation utility starts and displays a list of Java interpreters found on your system. You are then prompted to specify a path to an interpreter:

0) I want to specify a path to an interpreter.
1) Use /bin/java
2) Use /bin/jre
3) Use /usr/bin/java
4) Use /usr/bin/jre
5) Use /bin/java
6) Use /bin/jre
7) Use /usr/bin/java
8) Use /usr/bin/jre
9) Terminate this installation.
Select a choice [0-9]:

Step 3 Enter a number that corresponds to the interpreter that you want to use.

For example, if your Java interpreter is in the /bin/java directory, enter 1.

The Welcome screen appears.

Figure 3-11:

Step 4 Click Next.

A dialog box appears and you are asked whether you are upgrading Cisco Info Center. The following message appears on the screen:

ONLY upgrade from CIC 1.1 to 1.2 is supported. Features that you
have customized or added other than additional fields added to
Object Server in your CIC 1.1 installation may not be upgraded to
1.2. Before upgrading make sure that you have a backup.

If you are upgrading an installation using the single-system architecture, see "Upgrade Procedure for the Single-System Architecture" in Chapter 5.
If you are upgrading an installation using the multi-system architecture, see "Upgrade Procedures for the Multi-System Architecture" in Chapter 5.

The installation utility checks to make sure that your system is running the proper version of the Sun operating system.

If your system runs a supported version, the following message appears:

Verifying OS:
Supported OS. Click Next to continue.

Step 6 Click Next.

The system checks that your user ID is valid. If you have the correct user ID, the following message appears:

Checking User Id:
OK. Click Next to continue.

Step 7 Click Next.

The utility displays the README file for the software.

Step 8 Click Next.

You are prompted to accept the license agreement

Figure 3-12: Software License Agreement Screen

Step 9 Click on the check box to accept the terms of the license.

Step 10 Click Next.

The system displays the default installation directory (/opt/Omnibus).

Figure 3-13: Choosing the Destination Directory

Step 11 Do one of the following:

To accept the default destination directory, click Next.
If you want to change the destination directory, enter the path and name for the new installation directory.

If the specified destination directory does not exist, the following message appears:

The specified destination directory,
<directory name> does not exist. Would you like to
create this directory.

Step 12 Do one of the following:

If the directory shown in the message is the correct directory, click Yes.
If the directory shown in the message is not correct, click No and then re-enter the destination directory.

The system checks the specified directory for an existing version of Cisco Info Center. If an existing version is detected, the following message appears:

Legacy version exists
/opt/Omnibus/RELEASE_ID. Click cancel to exit
installation

Step 13 If there is an existing version of Info Center, click OK and then click Cancel to exit the installation program.

The system verifies that the existing directory is empty:

Step 14 Click Next.

The system checks for the common component and the following message appears:

Checking for Common component.
Common component not found. Click Next to continue.

Step 15 Click Next.

The system displays a dialog box that prompts you for the components that you want to install:

Figure 3-14: Choosing the Info Center Components to Install

Step 16 Click the check box for Info Admin Desktop Component.

Step 17 Click Next.

A message appears asking if you want to overwrite any existing packages:

Figure 3-15: Overwrite Existing Package Prompt

Step 18 Do one of the following:

If you want to overwrite a previous installation, click Yes.
If there is no previous installation, click No.

Step 19 Click Install.

The installation program installs the selected packages. After the installation is complete, the system prompts you to finish the installation procedure.

Step 20 Click Finish.

The installation process is now complete.

Configuring the Cisco Info Admin Desktop

After installation, you must configure the Cisco Info Admin desktop.

Step 1 Login as user root.

Step 2 Set the OMNIHOME environment for ksh or sh shell:

host# OMNIHOME=/opt/Omnibus
host# export OMNIHOME
 
or for csh shell:
 
host# setenv OMNIHOME /opt/Omnibus

Step 3 Change to the following directory:

host# cd /opt/Omnibus/install

Step 4 Run the configuration script:

host# ./nco_config

The following Configuration menu is displayed:

#################################################################
               Cisco Info Center Configuration Menu
##################################################################
 
           1.  Configure Info Admin Desktop  
 
           2.  Help                          
 
           3.  Quit                          
 
Select one of the above options :

Step 5 Select Option 1.

The script displays the selected option and prompts you for confirmation.

You have Selected the following Info Center Components to be configured 
 
        Info Admin Desktop
 
Do you want to continue (y/n) ? [y]:

Step 6 Press Return to continue or specify N, then press Return to go back to the previous menu.

When you continue with the configuration process, if the current installation directory is not /opt/Omnibus, the script automatically links the Cisco Info Center install directory to /opt/Omnibus.

However, if /opt/Omnibus is not the current installation directory and /opt/Omnibus already exists, either as a directory, file, or a link on the system, the following error message is displayed:

*** Info Center Requires Installation in /opt/Omnibus*** 
*** /opt/Omnibus already exists, ***
*** Create a link to /opt/Omnibus from the <install directory> ***
*** at the end of this configuration script ***

You are prompted to enter the hostname of the host that is running the Info Server.

Hostname of the Machine running the Info Server []:

Step 7 Enter the hostname of the machine where the Info Server is installed.

The installation script pings the specified host. If the host is not reachable, the following message appears.

Trying to ping Host <hostname>... Host <hostname> is not reachable.
Is this the correct host for the Info Server (y/n) [y]:

Step 8 Press Return to accept the specified hostname or N to go back to the previous text.

You are prompted for the name of the Info Server to connect to:

Name of the Info Server to connect [INFOSERVER]:

Step 9 If the Cisco Info Server is already configured, specify the name of the Cisco Info Server. Otherwise, select the default name.

Note The name of the Cisco Info Server can be any alphanumeric string up to eleven characters, beginning with a letter. The name is not validated by the script, therefore, it is important that you specify this name properly. Valid names include: CISCO and INFOSERVER.

You are prompted for the port number of the Info Server.

Enter the Info Server Port Number [4100]:

Step 10 If the Cisco Info Server is already configured, specify the port number of the Cisco Info Server. Otherwise, select the default port.

The following message appears:

Info Admin Desktop Configured

Installation and configuration of the multi-system architecture is now complete.

Table of Contents

Installing and Configuring the Multi-System Architecture