cc/td/doc/product/rtrmgmt/ana/4_0
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table Of Contents

Installing and Uninstalling Cisco ANA 4.0

Ensuring a Smooth Installation

Ensuring a Smooth Installation of the Gateway

Ensuring a Smooth Installation of the Unit

Ensuring a Smooth Installation of the Client

Installing the Gateway

Installing the Gateway with a Local Database

Installing the Gateway with a Remote Database

Starting the Gateway Server

Verifying the Gateway Installation

Installing the Unit

Guidelines for Allocating Units and AVMs

Installing a Unit

Adding a Unit to the Gateway Server

Starting a Unit

Verifying the Unit Installation

Installing the Client

Invoking the Client

Accessing Installation Log Files

Uninstalling ANA 4.0

Uninstalling the ANA 4.0 Gateway and Local Database

Uninstalling the ANA 4.0 Gateway and Remote Database

Uninstalling the ANA 4.0 Unit

Uninstalling the ANA 4.0 Client


Installing and Uninstalling Cisco ANA 4.0

The following sections in this chapter provide instructions to install ANA 4.0:

• Ensuring a Smooth Installation

• Installing the Gateway

• Installing the Unit

• Installing the Client

• Accessing Installation Log Files

• Uninstalling ANA 4.0

Ensuring a Smooth Installation

You should install the gateway first since it has to be up and running before you install the client.

When a gateway is installed on a server, the unit functionality is automatically available on that server. You can install a unit on a separate server and point it to a gateway installed on another server.

For information on uninstalling ANA 4.0, see Uninstalling ANA 4.0.

This section contains information on:

• Ensuring a Smooth Installation of the Gateway

• Ensuring a Smooth Installation of the Unit

• Ensuring a Smooth Installation of the Client

Before you begin your installation, review the section Cisco ANA 4.0 Installation Prerequisites

Ensure that:

•The user who starts the installation has root privileges.

•You exit all programs before starting the ANA installation.

•Cisco ANA 4.0 installation DVD is in place.

•You will need an inviolable password. This password should have 8 or more characters and contain at least:

–One uppercase letter

–One lowercase letter

–One numeral

–One special character

Note Some special characters will not be accepted by ANA. Special characters that are not accepted in ANA passwords are: dollar sign ($), single apostrophe ('), double apostrophe ("), question mark (?), and backquote (`).

The password cannot contain a username or reversed username, or the word cisco, or any variation of the name cisco, for example ocsic.

An example of a good password is System123!

Installing ANA from the DVD takes a little longer, and the message, Preparing to install is displayed as ANA 4.0 prepares to install.

If you copy installAna40.sh and Ana40.bin from the DVD to the hard disk, installation will be faster. Do not copy installAna40.sh and Ana40.bin to the /tmp directory.

To navigate through the installation or uninstallation processes, you can:

•Click Next to proceed to the next screen.

•Click Previous if you want to change anything on a previous screen.

•Click Cancel to exit the installation.

We recommend that you do not click Cancel during installation. If you encounter a problem during the installation, do not cancel it. Let it proceed until it exits. For details of installation logs, see Accessing Installation Log Files.

Ensuring a Smooth Installation of the Gateway

Before proceeding with the installation of the gateway, ANA checks for the following and if it does not find what is required, error messages appear, and the installation may terminate.

Therefore, ensure that the following requirements are met for a gateway installation:

What ANA Checks For
What You Should Ensure

Whether the user has ANA root user privileges.

Ensure that the user performing the installation has ANA superuser privileges. After the installation has completed, the ANA root user can login as ANA root user and create other users.

To do this, see the section User Privileges for Installation

Whether all required ports are available.

Ensure that the required ports are available.

For a list of ports, see Ports and Protocols.

Whether Perl exists on the installation machine.

Ensure that Perls is present on the installation machine.

Usually Perl is present on a machine that runs on Solaris. During installation, ANA 4.0 checks for the Perl that is present on the machine for initial bootstrapping.

After ANA 4.0 installs its own version of Perl, it no longer requires the system version.

Whether the /bin/tcsh. is available.

Usually tcsh is present on a machine that runs on Solaris. After ANA 4.0 installs its own version of tcsh, it no longer requires the system version.

Ensure that the shell is /bin/tcsh on the installation machine.

Whether the system is running SPARC based Solaris 10 with required patch Generic_118822-25 and the required packages.

Ensure that Solaris 10 with the required patch Generic_118822-25 has been installed.

For minimum hardware requirements, see Hardware and Software Requirements.

For the patches required, see Solaris Patches.

Whether there is enough space available in / (200MB), /tmp (2.1GB), and /var (100MB) for the installation.

Ensure that there is enough disk space available.

See Hardware and Software Requirements for details.

Whether enough RAM is available.

Ensure that the required RAM is available.

See Hardware and Software Requirements.

If the requirement is not met, the installation is not terminated. You will only see a warning message.

Whether ANA 4.0 has already been installed on the machine.

Ensure that any earlier installation is uninstalled.

Whether there has been an incomplete uninstall of ANA 4.0

If prompted by ANA, you should manually remove the existing version.


Ensuring a Smooth Installation of the Unit

For a unit installation, the Oracle database is not required explicitly. It is only needed for the gateway server. Also, you will have to provide the IP address of the gateway.

To install a unit follow the same steps as for the gateway. See Ensuring a Smooth Installation of the Gateway

Ensuring a Smooth Installation of the Client

For the client installation to proceed smoothly, ensure that you have Microsoft Windows XP Service Pack 2 or later installed. See Client Requirements

Installing the Gateway

You have two options to install the gateway. They are:

• Installing the Gateway with a Local Database

• Installing the Gateway with a Remote Database

This section also contains information on:

• Starting the Gateway Server

• Verifying the Gateway Installation

The installation performs certain preinstallation checks. For example, it checks:

•For available disk space

•For the correct operating system version and patches

•Whether the product is already installed

The Transparent Network Substrate (TNS) listener service must be up and available for connection with the Oracle database services.

The installation displays a warning if the prerequisites are not met. You can either cancel the installation and check the prerequisites, or continue with the installation. For details of the prerequisites, see Cisco ANA 4.0 Installation Prerequisites.

ANA 4.0 installation then extracts, creates directories, and installs the software. It creates a temporary directory under /tmp directory.

You should have the Oracle details ready since you will be prompted to enter them during the installation process. You will need the password for a local installation of Oracle. For a remote installation of Oracle, you will need the host IP address and the Oracle password.

The default install directory is /export/home/ana40 and the default UNIX user/group is anauser/ana. These defaults can be overwritten during installation.

As part of the installation, the Application Registry is configured and environment variables are set. User aliases, database tables and indices are also created, during installation.

Depending on the location of your database (local or remote), you can select these options during the gateway installation:

•Gateway and Local DB—Choose this option if you are performing a gateway installation with the database locally available on the gateway machine. See Installing the Gateway with a Local Database for details.

•Gateway and Remote DB—Choose this option if you are performing a gateway installation with the database available on a separate machine. See Installing the Gateway with a Remote Database for details.

You cannot change the location of your database (local or remote) after installation.

Note Before installing, ensure that all prerequisites and system requirements are met. See Cisco ANA 4.0 Installation Prerequisites. Also see Ensuring a Smooth Installation.

Installing the Gateway with a Local Database

To install the gateway with a local database:

Step 1 Insert the DVD in the DVD-ROM drive.

Step 2 Log into the machine as root user.

Step 3 Back up and uninstall an earlier installation of the gateway, if it exists.

Step 4 Go to the DVD-ROM root directory

or

If you copied installAna40.sh and Ana40.bin from the DVD to the hard disk, go to that directory.

Note If you copy installAna40.sh and Ana40.bin from the DVD to the hard disk, installation will be faster. Do not copy installAna40.sh and Ana40.bin to the /tmp directory.

Step 5 Mount the DVD-ROM. See "Mounting and Unmounting the DVD-ROM Drive".

Step 6 If you are using Xterm, verify that your display is correctly set by entering:

setenv DISPLAY x.x.x.x:0.0

Where x.x.x.x is the IP address of the client connecting to the Xterm server.

If you receive an error, enter csh, and re-enter the setenv command.

Step 7 Install the gateway by entering the following command at the command prompt:

./installAna40.sh

The Introduction dialog box is displayed.

Step 8 Click Next.

The License Agreement dialog box is displayed.

Step 9 Accept the License Agreement and click Next.

The Validating Installation Environment dialog box appears. The Installation program checks the system configuration.

Step 10 Click Next.

The Server Role Selection dialog box is displayed.

Step 11 Click the Gateway and Local Database radio button.

Step 12 Click Next.

The Choose Install Directory dialog box is displayed.

The default folder is /export/home/ana40.

You can either:

•Click Choose to choose the install directory you want from a file browser that appears with a list of directories.

or

•Click Restore Default Folder to install ANA in the default location.

Step 13 Click Next.

The Unix User Information dialog box is displayed.

Step 14 Enter the following details:

•Unix Group—This value is prepopulated. However, you may change the Unix Group name.

•Unix User—This value is prepopulated. However, you may change the Unix User name.

•Unix Password—Enter the Unix password.

•Password Confirm—Re-enter the Unix password.

Step 15 Click Next.

The Database Information dialog box appears.

Step 16 Enter the following Oracle database information:

•Host IP Address—This value is prepopulated.

•Port—This value is prepopulated.

•SID—This value is prepopulated.

•Oracle System User—This value is prepopulated.

•Oracle User Password—Enter the password set on the database.

Step 17 Click Next.

The ANA User Information dialog box is displayed.

Step 18 Enter the ANA root user password.

Step 19 Re-enter the password in the Confirm field.

Step 20 Click Next.

The PrepreInstallation Summary dialog box is displayed.

Step 21 Review the information displayed in the dialog box.

Step 22 Click Install.

The installation starts. A progress dialog is displayed during installation.

The Install Complete dialog box is displayed when the installation completes.

Step 23 Click Done.

Step 24 To start the gateway, log in as anauser and enter:

cmpctl start

Installing the Gateway with a Remote Database

To install the gateway with a remote database:

Step 1 Insert the DVD in the DVD-ROM drive.

Step 2 Log into the machine as root user.

Step 3 Back up and uninstall an earlier installation of the gateway, if it exists.

Step 4 Go to the DVD-ROM root directory

or

If you copied installAna40.sh and Ana40.bin from the DVD to the hard disk, go to that directory.

Note If you copy installAna40.sh and Ana40.bin from the DVD to the hard disk, installation will be faster. Do not copy installAna40.sh and Ana40.bin to the /tmp directory.

Step 5 Mount the DVD-ROM. See "Mounting and Unmounting the DVD-ROM Drive".

Step 6 If you are using Xterm, verify that your display is correctly set by entering:

setenv DISPLAY x.x.x.x:0.0

Where x.x.x.x is the IP address of the client connecting to the Xterm server.

If you receive an error, enter csh and re-enter the setenv command.

Step 7 Install the gateway by entering the following command, at the command prompt:

./installAna40.sh

The Introduction dialog box appears.

Step 8 Click Next.

The License Agreement dialog box is displayed.

Step 9 Accept the License Agreement and click Next.

The Validating Installation Environment dialog box is displayed. The Installation program checks the system configuration.

Step 10 Click Next.

The Server Role Selection dialog box is displayed.

Step 11 Click the Gateway and Remote Database radio button.

Step 12 Click Next.

The Choose Install Directory dialog box is displayed.

The default folder is /export/home/ana40.

You can either:

•Click Choose to choose the install directory you want from a file browser that appears with a list of directories.

or

•Click Restore Default Folder to install ANA in the default location.

Step 13 Click Next.

The Unix User Information dialog box is displayed.

Step 14 Enter the following details:

•Unix Group—This value is prepopulated. However, you may change the Unix Group name.

•Unix User—This value is prepopulated. However, you may change the Unix User name.

•Unix Password—Enter the Unix password.

•Password Confirm—Re-enter the Unix password.

Step 15 Click Next.

The Database Information dialog box is displayed.

Step 16 Enter the following Oracle database information:

•Host IP Address—Enter the host IP Address.

•Port—This value is prepopulated.

•SID—This value is prepopulated.

•Oracle System User—This value is prepopulated.

•Oracle User Password—Enter the password set on the database.

Step 17 Click Next.

The Database File Directory dialog box is displayed.

Step 18 Enter the directory of the remote database server where you want to store data file:

•The directory should exist on the remote database machine.

•The directory must be owned by the Oracle user.

•We recommend that the directory does not contain any datafiles.

Click Next. The ANA User Information dialog box is displayed.

Step 19 Enter the ANA root user password.

Step 20 Re-enter the password in the Confirm field.

Step 21 Click Next.

The PreInstallation Summary dialog box is displayed.

Step 22 Review the information displayed in the dialog box.

Step 23 Click Install.

The installation starts. A progress dialog is displayed during installation.

The Install Complete dialog box is displayed when the installation completes.

Step 24 Click Done.

Step 25 To start the gateway, log in as anauser and enter:

cmpctl start

Starting the Gateway Server

You can start the gateway server when the installation is complete. See Starting the Gateway Server.

Verifying the Gateway Installation

You can verify whether all the required processes are running.

To do this:

Step 1 Use Telnet and connect to the gateway as anauser.

Step 2 Run the following command:

cmpctl status

The current status of all the ANA processes is displayed.

You may also check the installation logs, these are present in the $ANAHOME/Main/logs/install directory.

Here, $ANAHOME is the ANA installation directory. By default, ANA is installed in /export/home/ana40.

Installing the Unit

This section has the following topics:

• Guidelines for Allocating Units and AVMs

• Installing a Unit

• Adding a Unit to the Gateway Server

• Starting a Unit

• Verifying the Unit Installation

Note For details about installing a unit in a multi-homed Solaris environment, see Configuration Settings for Running ANA In a Multi-homed Solaris Environment

Guidelines for Allocating Units and AVMs

If you have only one gateway and multiple units to be deployed, you should consider the following before installing units.

•The number of unit to be deployed to allocate the AVMs.

•The number of network elements that will be managed by each AVM.

•Number of network scopes and their policy. Scopes enable an administrator to group network elements together to enable users to view and manage them based on user roles.

•Number of users.

The unit installation is similar to the gateway installation, except that Oracle is not needed for the units, and you must enter the IP address of the gateway.

For more details, see the section Guidelines for adding Network Elements to ANA in the Cisco Active Network Abstraction 4.0 User and Administration Guide.

Installing a Unit

To install a unit:

Step 1 Insert the DVD in the DVD-ROM drive.

Step 2 Log into the machine as root user.

Step 3 Mount the DVD-ROM. See "Mounting and Unmounting the DVD-ROM Drive".

Step 4 Go to the DVD-ROM root directory

or

If you copied installAna40.sh and Ana40.bin from the DVD to the hard disk, go to that directory.

Note If you copy installAna40.sh and Ana40.bin from the DVD to the hard disk, installation will be faster. Do not copy installAna40.sh and Ana40.bin to the /tmp directory.

Step 5 If you are using Xterm, verify that your display is correctly set by entering:

setenv DISPLAY x.x.x.x:0.0

Where x.x.x.x is the IP address of the client connecting to the Xterm server.

If you receive an error, enter csh, and re-enter the setenv command.

Step 6 Install the unit by entering the following command, at the command prompt:

./installAna40.sh

An Introduction dialog box is displayed.

Step 7 Click Next.

The License Agreement dialog box is displayed.

Step 8 Accept the License Agreement and click Next.

The Validating Installation Environment dialog box appears. The Installation program checks the system configuration.

Step 9 Click Next.

The Server Role Selection dialog box is displayed.

Step 10 Choose the ANA Unit radio button and click Next.

The Choose Install Directory dialog box is displayed.

The default folder is /export/home/ana40.

You can either:

•Click Choose to choose the install directory you want from a file browser that appears with a list of directories.

or

•Click Restore Default Folder to install in the default location.

Step 11 Click Next.

The Unix User Information dialog box is displayed.

Step 12 Enter the following details:

•Unix Group—This value is prepopulated. However, you may change the Unix Group name.

•Unix User—This value is prepopulated.You may change the Unix User name. The Unix User entered has to be consistent with that on the gateway, to ensure proper communication between gateway and unit.

•Unix Password—Enter the Unix password.

•Password Confirm—Re-enter the Unix password.

Step 13 Click Next.

The gateway server IP dialog box is displayed.

Step 14 Enter the gateway IP and click Next.

The PreInstallation Summary Unit dialog box is displayed.

Step 15 Review this information. Click Install.

The installation starts. A progress dialog is displayed during installation.

The Install Complete dialog box is displayed when the installation completes.

Step 16 Click Done.

Adding a Unit to the Gateway Server

After you install the ANA software on a unit, you can add it to the ANA fabric by adding it to the gateway. For more information, see Adding Units.

See also the Cisco Active Network Abstraction 4.0 User and Administration Guide.

Starting a Unit

A unit starts automatically when the gateway server starts. A unit can also be started or stopped independently.

A unit does not stop automatically when a gateway server is stopped.

A unit will be started automatically when added to a gateway.

Verifying the Unit Installation

You can verify whether all the required processes are running.

To do this:

Step 1 Use Telnet and connect to the unit as anauser.

Step 2 Run the following command:

cmpctl status

The current status of all the ANA processes is displayed.

You may also check the installation logs, these are present in the $ANAHOME/Main/logs/install directory.

Here, $ANAHOME is the ANA installation directory. By default, ANA is installed in /export/home/ana40.

Installing the Client

Note Your client machine should have Microsoft Windows XP Service Pack 2 or later.

For details on installing a client in a multi-homed Solaris environment, see Configuration Settings for Running ANA In a Multi-homed Solaris Environment

To install the client:

Step 1 Go to any ANA gateway server using this URL: http://Servername:8080/install/install.htm

For example: http://10.76.85.44:8080/install/install.htm

Step 2 Click on Download Installer for Windows.

Step 3 Run the installation file that was downloaded from the server. The default name of this file is clientfw_install.exe

The Introduction dialog box is displayed.

Step 4 Click Next.

The License Agreement dialog box is displayed.

Step 5 Accept the License Agreement and click Next.

The Installation program checks whether a previous installation of the client is present in the machine. If it is detected, you will be prompted to terminate the current installation. You can choose to proceed and have multiple versions of ANA, or you can uninstall the previous installation.

Installation program then checks whether Microsoft Windows XP Service Pack 2 or later is present in the machine.

Step 6 Click Next, after the check is complete.

The Choose Install Directory dialog box is displayed.

Step 7 Either:

•Click Choose to choose the install directory you want from a file browser that appears with a list of directories.
or
Click Restore Default Folder to install ANA in the default location.

Step 8 Click Next.

The Choose Shortcut Folder dialog box is displayed.

Step 9 Choose the desired options to create shortcuts to launch ANA 4.0 and click Next.

The Preinstallation Summary is displayed.

Step 10 Review the information, and click Install.

The Install Complete screen is displayed.

Step 11 Click Done.

Step 12 In the pop-up dialog box, click Now to launch ANA client immediately, or Later to launch it at a later point of time.

See Invoking the Client for details on invoking the client.

Invoking the Client

Extra application plug-ins are dynamically downloaded from the gateway when the client is invoked for the first time. Owing to this, the first invocation takes longer than subsequent client startups.

Step 1 Go to Start > Programs > Cisco ANA > Cisco ANA Client 4.0 > ANA Client 4.0.

Note Cisco ANA Client 4.0 is the default name, this may have been changed during installation.

The login screen is displayed.

Step 2 Enter the gateway server IP address.

Step 3 Enter the username and password.

Step 4 Click Login.

After you log in as the ANA root user, you can create more users as required.

Accessing Installation Log Files

Logs generated by the installer component during the ANA installation are present in $ANAHOME/Main/logs/install directory.

Here, $ANAHOME is the ANA installation directory. By default, ANA is installed in /export/home/ana40.

For more information, see Log Files.

Uninstalling ANA 4.0

The following sections provide details on uninstalling the ANA gateway, unit, and client:

• Uninstalling the ANA 4.0 Gateway and Local Database

• Uninstalling the ANA 4.0 Gateway and Remote Database

• Uninstalling the ANA 4.0 Unit

• Uninstalling the ANA 4.0 Client

Uninstalling the ANA 4.0 Gateway and Local Database

This procedure applies to a gateway with the database locally available on the gateway machine.

To uninstall the gateway:

Step 1 Go to the directory, /var/adm/cisco/ana/Uninstall_Cisco_ANA_4.0

Step 2 Login as Unix root user on the gateway server.

Step 3 Run the following command:

./Uninstall_Cisco_ANA_4.0

The Uninstall Cisco ANA dialog box is displayed.

Step 4 Click Next.

The Database Information dialog box appears.

Step 5 Enter the following details and click Next.

Values provided at the time of installation will be shown by default during uninstallation.

•Host IP Address

•Port

•SID

•System User

•System Password

The Uninstall Cisco ANA 4.0 window is displayed. It provides information on the progress of the uninstallation process.

After the uninstallation is complete, the Uninstall Complete dialog box appears.

Step 6 Click Done.

Uninstalling the ANA 4.0 Gateway and Remote Database

This procedure applies to a gateway with the database on a separate machine.

To uninstall the gateway:

Step 1 Go to the directory, /var/adm/cisco/ana/Uninstall_Cisco_ANA_4.0

Step 2 Login as Unix root user on the gateway server.

Step 3 Run the following command:

./Uninstall_Cisco_ANA_4.0

The Uninstall Cisco ANA dialog box is displayed.

Step 4 Click Next.

The Database Information dialog box appears.

Step 5 Enter the following details and click Next.

Values provided at the time of installation will be shown by default during uninstallation.

•Host IP Address

•Port

•SID

•System User

•System Password

The Uninstall Cisco ANA 4.0 window is displayed. It provides information on the progress of the uninstallation process.

After the uninstallation is complete, the Uninstall Complete dialog box appears.

Step 6 Click Done.

Uninstalling the ANA 4.0 Unit

To uninstall a unit:

Step 1 Go to the directory, /var/adm/cisco/ana/Uninstall_Cisco_ANA_4.0

Step 2 Login as Unix root user on the unit.

Step 3 Run the following command:

./Uninstall_Cisco_ANA_4.0

The Uninstall Cisco ANA dialog box is displayed.

Step 4 Click Next.

The Uninstall Cisco ANA 4.0 window is displayed. It provides information on the progress of the uninstallation process.

After the uninstallation is complete, the Uninstall Complete dialog box appears.

Step 5 Click Done.

For information on moving AVMs on the unit that is being uninstalled, to another unit, see Cisco Active Network Abstraction 4.0 User and Administration Guide.

Uninstalling the ANA 4.0 Client

To uninstall the ANA 4.0 client:

Step 1 Exit any client applications that are running.

Step 2 Go to Programs > Cisco_ANA_Client_4.0 > Uninstall ANA Client 4.0

Note Cisco_ANA _Client_4.0 is the default name, this may have been changed during installation.

The Uninstall Cisco_ANA_Client_ 4.0 dialog box is displayed.

Step 3 Click Uninstall.

The Uninstall Complete dialog box is displayed when uninstallation is complete.

Step 4 Restart the system to complete the uninstallation. Choose:

Yes, restart my system

Or

No, I will restart my system myself.

The restarting is needed to make sure all ANA process are exited. If you choose not to restart now, make sure that you restart the system before the next client installation.

Step 5 Click Done.

hometocprevnextglossaryfeedbacksearchhelp

Posted: Mon Sep 24 21:03:53 PDT 2007
All contents are Copyright © 1992--2007 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.