Installing Cisco ANA Clients
This chapter covers the typical installation of the following Cisco ANA client components:
•Cisco ANA Manage
•Cisco ANA NetworkVision
•Cisco ANA EventVision
Before starting the installation procedure, verify that:
•The "Disk 1: New Install" DVD is available. (See Installation DVDs and Disk Mounting, page 2-12.)
•There is IP connectivity between the gateway and the client workstation that you are about to install.
Before installing the Cisco ANA 3.7.1 client, you must uninstall any previous version. If you want to retain the information from a previous client, move the previous client to another directory. For information about uninstalling clients, see
Uninstalling a Cisco ANA Client, page 8-3.
This chapter includes:
•Using the Client Installation Wizard
•Disabling the Automatic Client Update
Using the Client Installation Wizard
The client installation wizard guides you step-by-step through the client installation process.
Step 1 Use either of the following options to begin the client installation:
•Insert "Disk 1: New Install" in the DVD drive. The client installation wizard launches automatically and the Welcome window is displayed.
If the client installation wizard does not launch automatically, browse to the DVD directory and launch the CiscoANA_webstart.exe executable.
•Open a web browser and download the client executable from http://gateway-IP-address:6080/ana/services/install/install/index.html, where gateway-IP-address is the IP address of the newly installed gateway. After the download is complete, launch the CiscoANA_webstart.exe executable. The client installation wizard launches and the Welcome window is displayed.
Note The web browser option is available only if the gateway is up.
Step 2 Click Next. The Destination Location window is displayed.
Note The default installation location is C:\Cisco Systems\ANA\.
For Windows 7 only: We recommend that you do not install the Cisco ANA GUI clients in the Program Files folder. Only Windows Administrators can run the GUI clients if they are installed in that folder.
Step 3 To change the default installation location, click Browse and choose the preferred installation directory.
Step 4 Click OK after choosing the required directory, or click Cancel to return to the default installation location.
Step 5 Click Next to accept the installation directory location.
The Select Components window is displayed. This window provides options to:
•Overwrite any older or existing version of Java with a new version of Java
•Install Cisco ANA NetworkVision and Cisco ANA EventVision
•Install the management tools:
–Cisco ANA Manage
–Cisco ANA Shell
–Cisco ANA Workflow Editor (which is based on LiquidBPM by Autonomy, Inc.)
Step 6 Verify that the JAVA Runtime check box is checked. Choose additional options according to your preference, then click Next.
The Select Program Manager Group window is displayed.
Note The default Program Manager group is Cisco ANA. Cisco ANA overwrites any existing icons. It is recommended that you add a version number to the Program Manager group; for example, Cisco ANA 3.7.1.
Step 7 If you want to change the default Program Manager group, enter your preference.
Step 8 Click Next. The Start Installation window is displayed.
Step 9 Click Next to start the installation. The Installing window is displayed.
Step 10 When the installation is complete, choose the options displayed in the final installation window, according to your preference:
•Create "Quick Launch" icons—Create a Quick Launch icon for Cisco ANA NetworkVision and Cisco ANA Manage on the Quick Launch toolbar.
•Launch Cisco ANA NetworkVision—Immediately launch Cisco ANA NetworkVision.
Step 11 Click Finish.
When the client installation is finished, use Cisco ANA Manage to complete the deployment of Cisco ANA. For information, see the Cisco Active Network Abstraction 3.7.1 Administrator Guide.
For detailed information about starting and working with Cisco ANA Manage, see the Cisco Active Network Abstraction 3.7.1 Administrator Guide.
For detailed information about starting and working with Cisco ANA NetworkVision and Cisco ANA EventVision, see the Cisco Active Network Abstraction 3.7.1 User Guide.
Note•If you encounter latency problems, close any other applications running on the desktop.
•When you launch the client, if you receive an error that says you are using a noncompliant Java version, you must reinstall the client. See Using the Client Installation Wizard.
•When you launch the client, the following message is displayed if the server and client have different versions of the launcher.jar file, and no other Cisco ANA applications are running:
An automatic upgrade of the ANA installer is required to connect to the specified
server. The application will restart after the upgrade has completed.
Click OK. The installer upgrades automatically to the same launcher.jar version as the server, and the login process continues.
•When you launch the client, a message is displayed if another Cisco ANA application is running, accessing host1. The client that is being launched tries to access host2. If host1 and host2 have different launcher.jar versions, the following message is displayed:
Another ANA client accessing a different server is open on your computer. This
additional ANA client will open using the same installer version as the currently open
Click OK. The client launches with the same launcher.jar as host1's launcher.jar file, but different from host2's launcher.jar file. Consequently, the GUI might not match the host code. When you relaunch Cisco ANA when the client launcher.jar is not already in use, the client launcher.jar file updates to the host2's launcher.jar file.
The default location of the client launcher.jar file is C:\Cisco Systems\ANA\.
The default location of the host launcher.jar file is Main/webstart/jars.
The clients support automatic client updates from the gateway. When connecting with a gateway, the system verifies that the client version is the latest one available and, if an upgrade is required, the system automatically updates the client from the gateway.
Note•This process might take several minutes.
•Unless there is a major version change, you do not need to upgrade clients manually.
Disabling the Automatic Client Update
The automatic client update is enabled by default.
To disable the automatic client update:
Step 1 Install the client applications.
Step 2 Log into the gateway as ana-user (where ana-user is the UNIX user account for the Cisco ANA application, created when Cisco ANA is installed).
Step 3 To disable the Apache port from which the clients download the JAR files, enter:
Step 4 To create /tmp/ClientJars.zip, enter:
Step 5 From the client PC:
a. Use FTP to connect to the gateway.
b. Transfer /tmp/ClientJars.zip in binary mode to [Applications location]\.
c. Extract the ClientJars.zip to [Applications location]\.
Note The default [Applications location]\ is C:\Cisco Systems\ANA\.
[Applications location]\jars should now contain its original contents and the extracted contents of ClientJars.zip, and [Applications location]\ should contain .dll files.
Step 6 In all .properties files in [Applications location]\, change the value of the update entry to false (updateJars=false).