Installing a Cisco ANA Unit
This chapter covers the typical installation of a Cisco ANA unit.
This chapter includes:
•Before You Begin
•Cisco ANA Unit Installation Overview
•Installing the Cisco ANA Unit
•Adding the Unit to Cisco ANA
•Launching the Unit Manually
•Verifying the Unit Processes
•Configuring the Unit
•Verifying the Cisco ANA Unit Installation
Before You Begin
Before starting the unit installation, verify that:
•The "Disk 1: New Install" DVD is available. (See Installation DVDs and Disk Mounting, page 2-12.)
•The units that are going to be installed comply with the minimum system requirements specified in Chapter 2, "Installation Prerequisites."
•The time set on the clocks of all units in the setup is the same. The maximum difference allowed between the different clocks is 4 minutes.
•You are about to install the correct Cisco ANA version and build. Enter the ./install.pl -version command, which returns the following output:
–Build date and time
–Version and build number
Cisco Ana install version 3.7.1-874, built on Thu Apr 1 05:34:03 IDT 2010
BID: SOL_ANA3.7.1_IL_20100401_0504 BST: dev.ana3.7.1 BU: cwadmin
Cisco ANA Unit Installation Overview
Figure 5-1 presents the unit installation workflow and the tasks in the order in which they should be performed.
Figure 5-1 Cisco ANA Unit Installation Workflow
1. Install the Cisco ANA unit. See Installing the Cisco ANA Unit.
2. Add the unit to Cisco ANA and configure it in the system. See Adding the Unit to Cisco ANA.
3. Launch the unit. See Launching the Unit Manually.
4. Verify the unit installation. See Verifying the Unit Processes.
5. Configure the unit. See Configuring the Unit.
Installing the Cisco ANA Unit
This procedure describes how to install the tools that are required for unit functionality, including JDK 1.6.0 and Active Perl v5.6.1.
To install the Cisco ANA unit:
Step 1 Verify that "Disk 1: New Install" is in the DVD drive.
Step 2 Open a Telnet or SSH session to the unit and log in as the user root.
Step 3 Check the system prerequisites, such as the required disk space. See Cisco ANA Unit, page 2-4.
Step 4 Back up and remove the old version of the unit (if an older version exists).
Step 5 To change to the CD directory, enter:
Step 6 To install the Cisco ANA unit, complete one of the following substeps:
a. For a new Cisco ANA 3.7.1 installation, enter the following command:
perl ./install.pl -user name
You must enter the same username and home directory that you used when you installed the gateway. (If the gateway and unit have different usernames or home directories, the unit will not start.)
For example, if the name of the user is ana371, enter:
perl ./install.pl -user ana371
b. If you are installing a new Cisco ANA 3.7.1 unit for a migrated Cisco ANA gateway, enter the following command:
perl ./install.pl -user sheer -dir /export/home/sheer4
The installation of the unit starts. The installation procedure is automatic and requires no user input.
Note If the installation does not start, verify that the installation DVD is mounted correctly as hsfs and read-only. See Installation DVDs and Disk Mounting, page 2-12.
Note This process might take a while. For information about the Cisco ANA environment created during installation, see Appendix A, "Folders Created in Cisco ANA."
Step 7 Open a Telnet or SSH session to the unit and log in as ana-user (where ana-user is the UNIX user account for the Cisco ANA application, created when Cisco ANA is installed).
Step 8 After logging in as the new user (ana-user), enter the following command:
Step 9 Choose Set machine as unit (see Figure 5-2). Use the down arrow key to choose a machine as the unit, then press Enter.
Figure 5-2 Choose Set Machine as Unit
Step 10 The Cisco ANA configuration utility configures the system by running a number of procedures:
a. You are prompted to enter the IP address of the gateway and verify the input:
- Enter the gateway IP address: <IP-address>
Please make sure that the gateway is up and running before proceeding
b. Enter the root user password to complete the unit installation:
- Enter the password for OS root user:
- Setup is updating the configuration directories, this might take a while
- Enter the ANA administrator username(root): root
- Enter the ANA administrator password:
- Connecting to GW to get SSH keys
- GW SSH keys copied successfully.
+ Done setting the machine as unit.
Note After you run the ana-conf command on the unit, if the SSH keys are not retrieved automatically within 60 seconds, the following message is displayed: "Connection to gateway-IP-address failed. 60 seconds timeout exceeded." To resolve this issue, verify that the unit can reach port 6081 on the gateway.
Step 11 If more than one IP address is defined on the Cisco ANA host UNIX workstation, Cisco ANA automatically chooses the IP address of the network interface card (NIC) that acts as a default route to the gateway. If required, you can change the NIC; use the choose_nic.pl tool to choose any IP address defined in the operating system.
Figure 5-3 Change the Default Route to the Gateway
Adding the Unit to Cisco ANA
Adding a unit to Cisco ANA requires the unit to be 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 can communicate with the other elements in the system.
Use Cisco ANA Manage to add the unit. (See "Adding New Cisco ANA Units" in the Cisco Active Network Abstraction 3.7.1 Administrator Guide.) Cisco ANA Manage automatically registers the unit in the registry and creates a transport uplink between the unit and the gateway.
The gateway starts the unit automatically.
The following requirements must be met before you add units to Cisco ANA:
•Remote procedure call (RPC) services must be enabled in the gateway so that the gateway and the unit can communicate.
•For gateways with more than one NIC, you must specify the NIC that the unit is to use.
Launching the Unit Manually
After installing the unit and adding it to Cisco ANA, you have the option of launching the unit manually. The gateway automatically verifies that the unit is up when it is added to the setup and, if the unit is down, starts it.
To launch the unit manually:
Step 1 Open a Telnet or SSH session to the unit and log in as ana-user (where ana-user is the UNIX user account for the Cisco ANA application, created when Cisco ANA is installed).
Step 2 Enter the following command to launch the unit:
The unit begins loading. The process might take a while to complete.
Verifying the Unit Processes
The status command verifies that the following unit processes are up and running:
•AVM 0—High availability/switch process
•AVM 25—Event persistence
•AVM 83—Internal use; used as a TFTP server by Configuration and Image Management
•AVM 99—Management process
•AVM 100—ANA Event Collector (AEC) process
•secured connectivity daemon
At this point in the installation, no AVMs have been added. When you add AVMs and assign VNEs to them, they appear as AVM XXX, where XXX is the number assigned to the AVM.
To check the status of all processes and daemons, enter:
The output lists all processes. For each AVM process that is checked, the status command displays, in brackets, the number of exceptions found in the total number of log file lines for that process. For example, the information for AVM 0 is [OK 0/32]; that is, 0 exceptions in the 32 log file lines that were checked:
.-= Welcome to <server-name>, running Cisco ANA unit (v3.7.1 (build 874)) =-.
+ Checking for services integrity:
- Checking if host's time server is up and running [OK]
- Checking if secured connectivity daemon is up and running [OK]
+ Detected AVM99 is up, checking AVMs
- Checking for AVM83's status [OK 0/19]
- Checking for AVM0's status [OK 0/32]
- Checking for AVM100's status [OK]
- Checking for AVM25's status [OK 0/25]
Configuring the Unit
At this point, 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 3.7.1 Administrator Guide.
Note Before creating any AVMs on the unit, the transport uplinks must be in place.
Verifying the Cisco ANA Unit Installation
The following sections describe how to check the Cisco ANA unit installation:
•Cisco ANA Version Information
•Key Directories and File Configuration
•Golden Source Configuration
Cisco ANA Version Information
Use this procedure to view the version of Cisco ANA installed on the unit and to verify that the major components of the Cisco ANA system are located correctly and are running.
Note This test also checks additional characteristics of the installation, such as directories and classes.
If there are any files missing or problems with the configuration, this check fails.
Step 1 On the unit, enter:
Step 2 Confirm that the correct version of Cisco ANA has been installed.
The following is an example of the message that should be displayed:
.-= Welcome to sh-t100-600t, running Cisco ANA unit (v3.7.1 (build 999)) =-.
Key Directories and File Configuration
Use this procedure to verify that key directories and files exist in the setup.
In the ~/Main directory, confirm that:
•The scheme subdirectory exists and contains the correct scheme files.
•The scripts and UNIX subdirectories were created correctly.
•The scheme subdirectory exists.
•The scripts and UNIX subdirectories exist.
If Failure Occurs
Rerun the installation.
To verify that the registry directory has been created correctly and contains the necessary files, browse to the ~/Main/registry directory on the server.
The registry directory exists and contains the necessary files.
If Failure Occurs
Rerun the installation.
Golden Source Configuration
Use this procedure to verify that the Golden Source was configured correctly on the unit.
Step 1 On the server, locate and open the ~/Main/registry/avm99.xml file.
Step 2 Confirm that the file contains an entry for the key parent, which is the value of the IP address of the gateway.
The file contains an entry for the key parent, which is the value of the IP address of the gateway.
If Failure Occurs
Rerun the installation.
After installing the gateway and the units, the system is up and ready to use. You can now install the client application to enable users to view the network. See Chapter 6, "Installing Cisco ANA Clients."