Cisco Active Network Abstraction Installation Guide, 3.6.2
Installing a Unit
Download this chapter
Installing a UnitInstalling a Unit
Download the complete book
Cisco Active Network Abstraction Installation Guide 3.6 Service Pack 2 - PDF of Entire BookCisco Active Network Abstraction Installation Guide 3.6 Service Pack 2 - PDF of Entire Book (PDF - 3 MB)
give_us_feedback

Table Of Contents

Installing a Unit

Unit Installation Overview

Installing the Unit System

Adding the Unit to the Cisco ANA Platform

Launching the Unit

Verifying the Unit Processes

Configuring the Unit

Verifying the Unit Installation

Cisco ANA Version Information

Key Directories and File Configuration

Registry Configuration

Golden Source Configuration

What's Next?


Installing a Unit

This chapter covers the typical installation of a unit.

Note For instructions how to install Service Packs 1 and 2 on a unit in a Cisco ANA 3.6 installation, please see Chapter 7, "Installing the Service Packs".

Before starting the installation verify the following:

•The installation DVD is available (see Installation DVD, page 2-6).

•The unit machines that are going to be installed comply with the minimum system requirements as specified in Chapter 2, "Installation Pre-requisites".

Note The time set on the clocks of all of the units in the setup should be the same. The maximum difference allowed between the different clocks is four minutes.

This chapter includes the following sections:

•Unit Installation Overview

•Verifying the Unit Installation

•What's Next?

Unit Installation Overview

The unit installation workflow below describes the steps required in the order in which they should be performed.

Figure 6-1 Unit Installation Workflow

Step 1 Install the unit system (see Installing the Unit System).

Step 2 Add the unit to the Cisco ANA platform and configure it in the system (see Adding the Unit to the Cisco ANA Platform).

Step 3 Launch the unit (see Launching the Unit).

Step 4 Verify the unit installation (see Verifying the Unit Processes).

Step 5 Configure the unit (see Configuring the Unit).

For information about restarting the Cisco ANA platform, refer to the Cisco Active Network Abstraction Administrator Guide.

Note The installation procedure changes the .rhosts file of the sheer user. For more information see Appendix B, "Cisco User .rhosts File".

Installing the Unit System

This procedure describes how to install the tools that are required for the unit functionality, including Java™ v1.3.1_09 and Active Perl v5.6.1.

To install the unit system:

Step 1 Verify the DVD is in the DVD drive.

Step 2 Open a Telnet/SSH session to the unit machine and log into the machine as "root" user.

Step 3 Check the system prerequisites such as the required disk space. See Cisco ANA Unit, page 2-3.

Step 4 Backup and remove the old version of the unit (if an older version already exists).

Step 5 Change the directory to the following CD directory, by entering: 

cd /cdrom/cdrom0/Server

Step 6 Install the unit system, enter: 

perl install.pl -encaped

Note If you used the -dir [desired directory] switch to change the directory at the gateway, you must install the unit to the same directory.
To change the installation directory, add -dir [desired directory] switch at the end of the perl install.pl -encaped command. For example: perl install.pl -encaped -dir /opt/sheer
Important: If you did not use the -dir [desired directory] switch when you installed the gateway, DO NOT use it here.

The installation of the unit begins. This procedure is automatic and requires no user input.

Note This process may take a while. For a further explanation about the ANA environment created during installation see Appendix A, "Folders Created in Cisco ANA".

Step 7 Open a Telnet/SSH session to the unit machine and log into the machine as "sheer" user.

Step 8 Continue installing the unit system, by entering: 

sheer-conf.pl

Step 9 Select set machine as unit. The Cisco ANA configuration utility will request the IP address of the gateway machine and verify input (y).

Figure 6-2 Request IP Address of the Gateway Machine

Step 10 Enter the "root" password to complete the unit installation.

Step 11 When more than one IP address is defined on the Cisco ANA host UNIX machine, Cisco ANA automatically chooses the IP address of the network interface card which acts as a default route to the gateway. If required you can change the network interface card, use the choose_nic.pl tool to choose any IP address defined in the operating system.

Figure 6-3 Change the Default Route to the Gateway

For information on how to configure the unit for high availability see the Cisco Active Network Abstraction High Availability User Guide.

Adding the Unit to the Cisco ANA Platform

Adding a unit to the Cisco ANA platform requires that the unit is defined in the system so that the gateway is aware of it. When the unit is added, it automatically connects to the transport fabric so that it is able to communicate with the other elements in the system.

You need to use Cisco ANA Manage to add the unit (see the Cisco Active Network Abstraction Administrator Guide). Cisco ANA Manage automatically registers the unit in the registry and creates a transport uplink between the unit and the gateway.

Note Important: If you are adding a unit to an already existing setup, you must generate the SSH keys. For more information, please see Adding a Unit after SSH Keys Generation, page 7-6.

Launching the Unit

After installing the unit and adding it to the Cisco ANA platform, you can launch it. The gateway automatically verifies that the unit is up when it is added to the setup, and if it is down, the gateway starts it.

To launch the unit:

Step 1 Open a Telnet/SSH session to the unit machine and log into the machine as user "sheer", default password "sheer".

Step 2 Launch the unit, by entering: 

mvm.csh

The unit loading process begins.

Note This process may take a while.

Verifying the Unit Processes

This procedure enables you to verify that the unit processes are up and running. The gateway server processes are:

•AVM 0—transport switch process

•AVM 99—management process

•AVM XXX—any AVM defined on the unit to load upon VNEs. At this installation step, no AVMs were added yet.

•Sheer_secured daemon

To verify the unit process:

Step 1 Check the status of all processes and daemons, by entering: 

status

The output lists all the processes, as shown in Figure 6-4:

Figure 6-4 List of the Processes

Configuring the Unit

At this stage, the unit is installed and ready to host VNEs. For information about setting up AVMs and VNEs using Cisco ANA Manage see the Cisco Active Network Abstraction Administrator Guide.

Note Before creating any AVMs on the unit the transport uplinks must be in place.

Verifying the Unit Installation

The following sections describe how to check the unit server installation:

•Cisco ANA Version Information—Describes how to check the version of Cisco ANA installed on the server.

•Key Directories and File Configuration—Describes how to check that several key directories and files exist in the setup.

•Registry Configuration—Describes how to check that the registry directory was properly created.

•Golden Source Configuration—Describes how to check that the Golden Source was properly configured.

Cisco ANA Version Information

This procedure checks the version of Cisco ANA installed on the server. In addition, it also checks that the major parts of the Cisco ANA system are properly located and running.

Note This procedure also checks a few additional characteristics of the installation such as directories, classes and so on.

If there are any files missing or problems with the configuration, the procedure will fail.

Step 1 On the server, enter: 

echo $SHEER_VER

Step 2 Check that the correct version of Cisco ANA has been installed.

Successful Result

The version, build, and customer information installed on the setup is displayed.

Actual Sample Result 

AVM OS v3.6.0 (290) (PRODUCT)

Failure

Rerun the installation.

Key Directories and File Configuration

This procedure checks that several key directories and files exist in the setup.

Step 1 Check that the license.jar file exists on the server, in the following directory: 

~/Main

Step 2 Check that there is a scheme sub-directory in the following directory, and that it contains the proper scheme files: 

~/Main

Step 3 Check that the scripts and UNIX sub-directories were properly created, in the following directory: 

~/Main

Successful Result

•The license.jar file exists in the directory.

•The scheme sub-directory exists.

•The scripts and UNIX sub-directories exist.

Failure

Rerun the installation.

Registry Configuration

This step checks that the registry directory has been created correctly and contains the necessary files.

Step 1 Browse to the following directory on the server: 

~/Main/registry/

Successful Result

The registry directory exists and contains the necessary files.

Failure

Rerun the installation.

Golden Source Configuration

This step checks that the Golden Source was configured correctly on the unit.

Steps

Step 1 On the server, locate and open the following file: 

~/Main/registry/avm99.xml

Step 2 Check that the file contains an entry for the key "parent", which is the value of the IP of the gateway.

Successful Result

The file contains an entry for the key "parent", which is the value of the IP of the gateway.

Failure

Rerun the installation.

What's Next?

After installing the gateway server and the units servers, the system is up and ready to use. The client application can now be installed to enable the user to view the network. See Chapter 8, "Installing a Client".