Table Of Contents
Purpose of the Quick Start Guide
Planning and Pre-Installation Tasks
Prepare Your Gateway, Unit, and Client Hardware and Software
Gateway and Unit Hardware and Software Prerequisites
Ensure that the Required Disk Space is Available Prior to Installation
Ensure that Ports to be Used by Cisco ANA are Open
Configure Your Devices to Enable Effective Cisco ANA Management
Verify That the Gateway Installation was Successful
Add the Unit to the System (2-Server Setup Only)
Verify that the Unit Installation was Successful
Install Cisco ANA Network Service Activation (NSA)
First Steps with Cisco ANA NetworkVision
Log Into Cisco ANA NetworkVision
Quick Overview of the Cisco ANA NetworkVision GUI
Create a Map for Network Visualization
Appendix A: Additional Cisco ANA 3.7.3 Guides
Appendix B: Device Information Form
Cisco ANA 3.7.3 Quick Start Guide
Released: May 23, 2011Part No.: OL-23759-01Table of Contents
1 Overview
This section provides an overview of the goals, assumptions, and content of the Quick Start Guide, as follows:
•
Purpose of the Quick Start Guide
Purpose of the Quick Start Guide
The purpose of this Quick Start Guide is to get you up and running with Cisco ANA 3.7.3, to the point where you can create a map to visualize your network and you can take advantage of Cisco ANA's many capabilities to monitor and manage your network elements and services. This guide will lead you through the planning, installation, and post-installation tasks required to get to this point.
Note
This Quick Start Guide does not replace other available Cisco ANA documentation, as it contains the minimum subset of information required to get started. You will find detailed information on any of the subjects mentioned in this guide in the Cisco ANA installation, user, administrator, and theory of operations guides, as listed in Appendix A: Additional Cisco ANA 3.7.3 Guides.
The Quick Start Guide covers planning and installation of the Cisco ANA 3.7.3 gateway, unit, clients, and NSA, after which you will have access to the functionality available in Cisco ANA NetworkVision, EventVision, and Manage (depending on user security level), as well as Configuration and Image Management and Network Service Activation (NSA) components.
Assumptions and Caveats
This section describes the assumptions upon which the information in this Quick Start Guide is based. If your Cisco ANA deployment differs from what is described in these assumptions, please contact your Cisco account representative for assistance with planning and installation of Cisco ANA.
Note
The Quick Start Guide is not intended for high scale environments, either at the network element level or the cross-network size. Details about hardware requirements for high scale setups, including database and memory sizing calculations, can be found in the Capacity Planning Guide which can be obtained from your Cisco account representative.
The guide assumes the following:
•
This is a new Cisco ANA installation, not an upgrade from a previous version.
•
Cisco ANA will be used to manage up to 100 network elements, i.e., a small-medium deployment of Cisco ANA. See Supported Deployment Options for examples.
•
The network can be managed by a maximum of one Cisco ANA gateway and one unit, either co-located on one server or on separate servers.
•
The Cisco ANA embedded database (Oracle 11g 11.2.0.1.0) will be used, not an external database.
•
Cisco ANA will be run in a production environment with a low rate of database operations:
–
0-5 actionable events per second. Actionable events are events that can be parsed by Cisco ANA and can therefore participate in correlation.
–
Up to 50 incoming events per second
–
Up to 500 workflows per day
–
Up to 300 configuration and image management operations persisted in the database.
–
The default history size will be retained, i.e., 14 days for events, 7 days for workflows. If a longer history period is required, please consult your Cisco account representative.
•
Telnet and SNMP will be used for device modeling and discovery when adding VNEs to the system, not SSH.
•
The reader has experience in the Unix environment.
The Quick Start Guide does not cover the following:
•
Integration
•
Customization
•
Package download
•
Advanced configuration (e.g., polling)
•
High availability
•
LDAP
•
External or remote database
Supported Deployment Options
Following are some examples of Cisco ANA network setups that fit within the Quick Start Guide scope. If your network setup is significantly larger than the examples below, please contact your Cisco account representative for assistance with planning and installation of Cisco ANA.
Example 1
Deployment type: Carrier E Aggregation
Number of Managed Elements: 35 aggregation routers
Possible Device Types: ASR 9000, 7600
Example 2
Deployment type: MPLS Core
Number of Managed Elements: 75, of which 50 core routers (P, PE) and 25 aggregation routers
Possible Device Types for Core: CRS-1, 12k, 76xx, 72xx, 65xx
Possible Device Types for Aggregation: 76xx, 65xx
Example 3
Deployment type: Basic element management functionality, no network level services or topology
Number of Managed Elements: 100 small/medium access routers
Possible Device Types: ME3400, 4900, 3750, generic VNE
Example 4
Deployment type: IP RAN
Number of Managed Elements: 100, of which 5 aggregation devices, 30 cell site devices, 65 layer 2 switches
Possible Device Types for Aggregation: 7600
Possible Device Types for Cell Sites: MWR-2941, MWR2941-DC
Possible Layer 2 Switches: 3400, 3400 ME
Example 5
Deployment type: Carrier E
Number of Managed Elements: 100, of which 95 UPE devices, 5 NPE devices
Possible Device Types for UPE: 3400, 3750
Possible Device Types for NPE: 76xx, ASR 9000
2 Planning and Pre-Installation Tasks
To make Cisco ANA installation and setup as quick and seamless as possible, you need to plan your deployment in advance and perform the following pre-installation tasks:
•
Read the Cisco Active Network Abstraction 3.7.3 Release Notes.
•
Verify that the devices you intend to manage with Cisco ANA are supported, using the Cisco Active Network Abstraction 3.7.2 Reference Guide (the 3.7.2 Reference Guide applies to Release 3.7.3) and the Cisco Active Network Abstraction 3.7.3 Release Notes.
•
Prepare Your Gateway, Unit, and Client Hardware and Software.
•
Ensure that the Required Disk Space is Available Prior to Installation.
•
Ensure that Ports to be Used by Cisco ANA are Open.
•
Configure Your Devices to Enable Effective Cisco ANA Management.
Prepare Your Gateway, Unit, and Client Hardware and Software
This section provides prerequisites and recommendations for the hardware and software you need to support your Cisco ANA deployment. These recommendations are based on the assumptions and target setup for this Quick Start Guide, as described in Assumptions and Caveats and Supported Deployment Options. If your network setup is not covered by this guide, please see "Installation Prerequisites" in the Cisco Active Network Abstraction 3.7.3 Installation Guide.
The recommended hardware options for the target setup are either:
•
Gateway and unit co-located on one server (one-server setup). This option requires the installation of the gateway software only, as the gateway acts as both gateway and unit.
or
•
Gateway installed on one server, unit installed on a separate server (two-server setup).
Gateway and Unit Hardware and Software Prerequisites
This section provides the prerequisites for the hardware and software required for the Cisco ANA gateway and unit in the Quick Start Guide target setups. See Example Hardware for One-Server Setup and Example Hardware for Two-Server Setup, for server recommendations.
The prerequisites are relevant for an embedded database installation, where the Oracle database is installed on the gateway during Cisco ANA installation and is fully integrated with Cisco ANA. The gateway and unit can run either Solaris or Linux operating systems.
Note
The hardware requirements are provided under the assumption and recommendation that Cisco ANA 3.7.3 does not share the hardware with additional applications.
Example Hardware for One-Server Setup
For a one-server setup where the gateway, unit, and database are co-located (with no LDOM partitioning), you could choose one of the examples below:
•
Cisco UCS C210 M1 General-Purpose Rack-Mount Server with:
–
2 Xeon 5500 processors
–
Red Hat Enterprise Linux Server Release 5.3 64-bit
–
64 GB RAM
–
No VMWare
•
Sun SPARC Enterprise T5240 server with:
–
2 UltraSPARC T2+ processors
–
64 GB RAM
–
Solaris 10 64-bit update 6
Example Hardware for Two-Server Setup
For a two-server setup, you could choose to use one server with two virtual partitions, or two separate machines, as in the examples below:
•
One Sun SPARC Enterprise T5240 server with:
–
2 UltraSPARC T2+ processors
–
64 GB RAM divided into two logical domains of 32 GB each (one for the gateway and the database, and one for the unit).
–
Solaris 10 64-bit update 6
•
Two separate Sun SPARC Enterprise T5220 servers (one for the gateway and one for the unit) with:
–
UltraSPARC T2 processor
–
32 GB RAM
–
Solaris 10 64-bit update 6
•
Two Cisco UCS C210 M1 General-Purpose Rack-Mount servers (one for the gateway and one for the unit) with:
–
1 Xeon 5500 processor
–
Red Hat Enterprise Linux Server Release 5.3 64-bit
–
32 GB RAM
–
No VMWare
Client Prerequisites
Table 2 Cisco ANA Client Minimum Installation Prerequisites
Item Specifications Minimum Hardware RequirementsIBM PC or PC-compatible workstation
•
Pentium IV, 2.66-GHz or better processor
•
1 GB RAM
•
2 GB of free disk space
•
512 MB of free nonvirtual memory per running instance
Screen
•
Minimum screen resolution of 1024 x 768 pixels
•
True color (32-bit) setting
Minimum Software RequirementsOperating system
•
Windows 2000, Windows XP, Windows Vista, or Windows 7
•
Citrix XenApp 5 with the Citrix Hotfix patch CTX120923, available at http://support.citrix.com/article/CTX120923
Note
The Citrix Hotfix patch requires an upgraded Citrix License Server (version 11.6.1). A single Citrix server supports multiple Citrix clients, each of which can run Cisco ANA clients.
Internet ConnectionRequirement
1.5 MB/s bandwidth (to download)
Supported browsers
•
Microsoft Internet Explorer 7.0 or later, on Windows XP
•
Firefox 3.0 or later, on Windows XP
Note
You must turn off the pop-up blocker so that all Configuration and Image Management operations will work correctly.
Ensure that the Required Disk Space is Available Prior to Installation
Before installing Cisco ANA, please verify that the disk space and storage requirements for the installation and for the database are fulfilled:
Note
The system administrator must back up the archive logs to tape daily and must transfer database backups to external storage.
Ensure that Ports to be Used by Cisco ANA are Open
The following ports are used by Cisco ANA and must be open prior to installation or the installation process will fail:
Configure Your Devices to Enable Effective Cisco ANA Management
Before adding your devices to the system, you need to run some commands on each device so that Cisco ANA can model the devices accurately and perform management tasks, such as processing syslogs, traps, logging, and so on. This section lists the device configuration prerequisites. Please see "Device Configuration Required Before Adding VNEs" in the Cisco Active Network Abstraction 3.7.3 Administrator Guide for details.
Table 6 Device Configuration Prerequisites
Required Configuration To be configured on... DetailsConfigure devices to send SNMP traps
All Cisco devices to be managed by ANA
See "Device Configuration Required Before Adding VNEs," in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
Configure devices to send syslogs
All Cisco devices to be managed by ANA
"Device Configuration Required Before Adding VNEs," in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
Configure devices to forward events to the server hosting the ANA Event Collector (AEC)
All Cisco devices to be managed by ANA
For traps:
snmp-server community public RO snmp-server host <IP> publicFor syslogs:
snmp-server community public RO snmp-server host <IP> publiclogging <IP>where <IP> is the IP address of the server hosting the AEC (usually the gateway).
Enable XML
IOS-XR devices
Cisco ANA VNEs use XML mode to communicate with IOS XR devices. Enable XML command:
xml agent ttyConfigure Virtual Device Contexts (VDCs)
Devices running Nexus operating system
"Device Configuration Required Before Adding VNEs," in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
3 Installation Tasks
This section provides step-by-step instructions for installing the Cisco ANA gateway, unit, and client software. It also provides instructions for installing Cisco ANA Network Service Activation (NSA):
•
Install Cisco ANA Network Service Activation (NSA)
•
Install Cisco ANA Network Service Activation (NSA)
Note
If you have a one-server setup, you need to install the gateway only. There is no need to install the unit because the gateway acts as both gateway and unit.
Install the Gateway
Installation of the gateway consists of two parts:
•
Installation, which involves running the install.pl command to install the gateway software on the designated server. This part should take between 10 and 20 minutes.
•
Configuration, which involves running the ana-conf script to configure the gateway. This part might take up to an hour.
To install and configure the Cisco ANA gateway:
Step 1
Insert "Disk 1: New Install" in the DVD drive of the server on which you will be installing the gateway.
Step 2
Open a Telnet or SSH session to the server on which the gateway will be installed and log in as the user root.
Step 3
Go to the DVD directory:
cd /cdrom/cdrom0/Server
Note
If you decide not to run the installation directly from the DVD, you must copy ivne-drivers.tar into the same directory as install.pl.
Step 4
Run the following command to start the installation and install the gateway in the default directory /export/home/name:
perl ./install.pl -user ana-userFor example, if the name of the user is ana373, enter:
perl ./install.pl -user ana373To install the gateway in a different directory, specify the directory at the end of the install command. For example:
perl install.pl -user ana373 -dir /opt/ana373The installation is initiated.
Step 5
When prompted, it is recommended that you change the default password.
To change the default user password, enter:
passwd ana-userwhere ana-user is the UNIX user account for the Cisco ANA application.
Step 6
Log in as the new user:
su - ana-userStep 7
Before configuring Cisco ANA on the gateway, copy the Oracle installation .zip files from the installation DVD (Disk 3: Database Binaries for Solaris or Disk 4: Database Binaries for Linux) to $ANAHOME/local/scripts/embedded_oracle.
For Solaris, copy solaris.sparc64_11gR2_database_1of2.zip and solaris.sparc64_11gR2_database_2of2.zip.
For Linux, copy linux.x64_11gR2_database_1of2.zip and linux.x64_11gR2_database_2of2.zip.
Step 8
Start the gateway configuration by entering the following command:
ana-conf
Note
Do not rerun the ana-conf script after AVMs or units are added. Rerunning the ana-conf script could cause problems with the Cisco ANA registry.
Step 9
Select Set machine as ANA gateway, then press Enter.
The Cisco ANA configuration utility configures the system by running a number of procedures, including generation of SSH keys.
Step 10
Enter the required information at the prompts. The following table lists the prompts and the required settings:
The following logs are available:
•
Installation logs at /var/adm/cisco/ana/logs/.
•
Embedded database configuration logs at $ANAHOME/local/scripts/embedded_oracle.
•
Configuration logs at $ANAHOME/Main/.
Step 11
Run the add_emdb_storage.pl script to add the database files required for your database profile, as follows:
a.
Change directories to $ANAHOME/Main/scripts/embedded_db and enter the following command:
# ./add_emdb_storage.plb.
Choose option 2—Small deployment (up to 5 actionable events per second) => required disk space for database files & redologs: 69 GB.
Verify That the Gateway Installation was Successful
To verify the gateway installation:
Step 1
If you did not start the gateway at the end of the installation process, launch the gateway by entering the following command:
anactl startThe gateway might take a while to load.
Step 2
Check the status of all processes and daemons by entering the following command:
statusThe output shows the status of each process and the number of exceptions found in the total number of log file lines for that process. For example, [OK 0/39] means 0 exceptions found in the 39 log file lines that were checked:
-------------------------------------------------------------------------------------.-= Welcome to server-name, running Cisco ANA gateway (v3.7.3 (build number)) =-.-------------------------------------------------------------------------------------+ Checking for services integrity:- Checking if host's time server is up and running [OK]- Checking if webserver daemon is up and running [OK]- Checking if secured connectivity daemon is up and running [OK]- Checking XMP runtime DM [UP]+ Detected AVM99 is up, checking AVMs- Checking for AVM83's status [OK 0/22]- Checking for AVM0's status [OK 0/39]- Checking for AVM100's status [OK 0/119]- Checking for AVM25's status [OK 0/28]- Checking for AVM11's status [OK 1/141]- Checking for AVM84's status [OK 0/29]
Note
Check the log files for each AVM if there are any problems. The log files are located under main/logs.
Install the Client
The client installation wizard guides you step-by-step through the process for installing the Cisco ANA client which covers Cisco ANA Manage, NetworkVision, and EventVision clients.
Step 1
Use either of the following options to begin the client installation:
•
Insert "Disk 1: New Install" in your 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://GatewayIP:6080/anaclient, where GatewayIP 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. The default installation location is C:\Cisco Systems\ANA\.
Note
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
Click Next to accept the default installation location. If you want to change the installation location, click Browse, select the preferred installation directory, click OK, and then click Next.
Step 4
In the Select Components window, do the following:
a.
Make sure that the JAVA Runtime check box is checked.
b.
Select all the available installation options (Cisco ANA NetworkVision, EventVision, Manage, Shell, Workflow Editor).
c.
Click Next.
Figure 1 Select Components
Step 5
In the Select Program Manager Group window, click Next to accept the default program manager group. If you want to change the default program manager group, enter your preference and then click Next.
Step 6
In the Start Installation window, click Next to start the installation. The Installing window is displayed.
Step 7
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 8
Click Finish.
Install the Unit
Installing the unit involves running the installation and configuration scripts from the Cisco ANA DVD, after which you must add the unit to the system, as described in Add the Unit to the System (2-Server Setup Only).
To install the Cisco ANA unit:
Step 1
Insert "Disk 1: New Install" in the DVD drive of the server on which the unit will be installed.
Step 2
Open a Telnet or SSH session to the server on which the unit will be installed and log in as the user root.
Step 3
Go to the DVD directory:
cd /cdrom/cdrom0/ServerStep 4
Run the following command to start the installation and install the unit in the default directory /export/home/name:
perl ./install.pl -user nameFor example, if the name of the user is ana373, enter:
perl ./install.pl -user ana373
Note
You must enter the same username that you used when you installed the gateway. If the gateway and unit have different usernames, the unit will not start.
Step 5
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):
su - ana-userStep 6
Start the unit configuration by entering the following command:
ana-confStep 7
Select Set machine as unit, then press Enter.
Step 8
Enter the required information at the prompts. The following table lists the prompts and the required settings:
After entering the information at the prompts, a connection is made to the gateway to retrieve SSH keys. 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 and then run ana-conf again.
Note
If more than one IP address is defined on the unit server, 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 use the choose_nic.pl tool to change the NIC.
The unit installation ends with the following message:
+ Done setting the machine as unit.
Add the Unit to the System (2-Server Setup Only)
If you have a two-server gateway-unit setup, you must add your unit to the system using Cisco ANA Manage so that the gateway is aware of it. When the unit is added, it is automatically registered in the registry and a transport uplink between the unit and the gateway is created. The gateway starts the unit automatically, if the unit is reachable.
Note
Remote procedure call (RPC) services (such as ANA SSH and XML-RPC) must be enabled in the gateway so that the gateway and the unit can communicate.
To add a new unit:
Step 1
Log into Cisco ANA Manage. From the Start menu, choose Programs > Cisco ANA > Cisco ANA Manage. The Cisco ANA Manage Login dialog box is displayed.
Step 2
Enter the username and password.
Step 3
In the Server field, enter the IP address or hostname of the Cisco ANA gateway.
Step 4
Click OK. The Cisco ANA Manage window is displayed with the username and host information in the window title.
Step 5
Right-click ANA Servers in the Cisco ANA Manage navigation tree, and select New ANA Unit.
Step 6
In the displayed New ANA Unit dialog box, enter the IP address of the unit. This IP address must be unique.
Figure 2 New ANA Unit Dialog
Step 7
Click OK. The new unit is displayed in the Cisco ANA Manage navigation tree and content area.
Note
The unit is displayed as Down at first but the status changes to Up after a few minutes.
Step 8
Right-click on the unit and select Properties to view memory allocation information for the unit, and other unit properties.
Figure 3 Unit Properties Dialog
Verify that the Unit Installation was Successful
Return to your Telnet/SSH session to the unit or open a new one. Follow the steps below to verify that the unit was installed properly. If there are any problems, rerun the installation.
Step 1
Check the status of all processes and daemons by entering the following command:
statusThe output shows the status of each process and the number of exceptions found in the total number of log file lines for that process. For example, [OK 0/39] means 0 exceptions found in the 39 log file lines that were checked.
Step 2
In the ~/Main directory, confirm that:
a.
The scheme subdirectory exists and contains the correct scheme files.
b.
The scripts and UNIX subdirectories were created correctly.
c.
The registry directory exists and contains the necessary files.
Step 3
Check that the golden source was configured correctly on the server:
a.
Open the ~/Main/registry/avm99.xml file.
b.
Confirm that the file contains an entry for the key parent, which is the value of the IP address of the gateway.
Install Cisco ANA Network Service Activation (NSA)
Cisco ANA NSA 1.3 is installed as an add-on module on the Cisco ANA gateway. For a list of the NSA components included in the installation, see "Installed Cisco ANA NSA Components" in the Cisco Active Network Abstraction 3.7.3 Installation Guide.
To install Cisco ANA NSA 1.3:
Step 1
Ensure that AVM 66 is running on the gateway server:
•
Open Cisco ANA Manage.
•
Expand the ANA Servers and the ANA Gateway branches.
•
Select AVM 66. The properties of AVM 66 are shown on the right.
•
If the status is Down, click the Load AVM button on the toolbar to start AVM 66.
Step 2
Ensure that "Disk 1: New Install" is in the DVD drive of the gateway server.
Step 3
Copy the Cisco ANA NSA installation file, ana_nsa_installer.pl, from the NSA directory to a temporary directory on the Cisco ANA gateway server.
Note
The directory to which you copy the ana_nsa_installer.pl file must be writable for ana-user (where ana-user is the UNIX user account for the Cisco ANA application) and must have at least 400 MB of free space available.
Step 4
Enter the following commands to change the permission to ana-user and navigate to the directory where you copied the Cisco ANA NSA installation file:
cd location-of-ana_nsa_installer.plchmod 777 ana_nsa_installer.plsu - ana-usercd location-of-ana_nsa_installer.plFor example:
cd /NSAInstall/Step 5
Enter the following command to run the Cisco ANA NSA installation:
./ana_nsa_installer.pl -installStep 6
Enter the ANA root username and password, as specified when installing the gateway. The installation begins.
Note
The Cisco ANA NSA 1.3 installer also installs the AWB gateway component. AWB requires a client installation. See "Installing the Cisco ANA NSA AWB Client" in the Cisco Active Network Abstraction 3.7.3 Installation Guide.
Step 7
Restart the Cisco ANA gateway by logging in as ana-user and entering the following command:
anactl restartStep 8
When the gateway is up, restart the Cisco ANA unit by logging into the unit as ana-user and entering the following command:
anactl restart
Verify the NSA Installation
To verify the Cisco ANA NSA 1.3 installation:
Step 1
Open Cisco ANA NetworkVision.
Step 2
From the Help menu, choose About. The installed Cisco ANA version is shown in the About Cisco ANA NetworkVision window under Additional Installed Applications.
Tip
You can also use the status command to verify that Cisco ANA NSA is running.
4 Post-Installation Setup Tasks
After you have installed Cisco ANA, you must perform the following tasks:
•
Get a Valid Cisco ANA License
Get a Valid Cisco ANA License
You must activate a valid Cisco ANA license within 120 days of installation. Until you activate the license, you will be running an evaluation version of Cisco ANA, with full functionality. After 120 days, this evaluation version will expire and if Cisco ANA is closed, it will not restart.
Cisco ANA software must be registered via Cisco.com in order to obtain a license file (*.lic). The license file will be sent to you by e-mail and must be installed on the Cisco ANA gateway server.
Note
The license file is bound to the server credentials that are provided during license generation. The license file will only be usable on that server only and cannot be ported from one server to another.
For any licensing issues, please contact your Cisco account representative or send an e-mail to ask-ana-licensing@cisco.com for assistance. For further details about licensing, see "Cisco ANA Licensing" in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
To obtain the license file:
Step 1
Go to the licensing web page at http://www.cisco.com/go/license and enter your Cisco.com user credentials to start the Product License Registration process. If you are not a registered Cisco.com user, create an account and log in.
Step 2
Enter the Product Authorization Key (PAK number) that appears at the bottom of the Software License Claim Certificate you received with your Cisco ANA package. The PAK number is a unique, automatically generated identification key that represents the specific software and hardware covered by the license. An example PAK number is ANA-3X-JAB-XXXXXX. Click Submit after entering the PAK number.
Step 3
Enter the hostname and host ID of the Cisco ANA gateway server.
Note
If you do not know the host ID, log into the Cisco ANA gateway server and enter the command hostid.
Step 4
Fill in the rest of the requested information, including your e-mail address, and submit the request.
Your license file and user information will be sent within 1 hour to the e-mail address you specified. If you do not receive an e-mail within 1 hour, contact your Cisco account representative or send an e-mail to ask-ana-licensing@cisco.com for assistance.
CautionDo not edit the contents of the .lic file in any way. The contents of the file are signed and must remain intact.
Step 5
Copy the license file to the $FLEXNET_HOME/licenses directory in the Cisco ANA gateway server.
Step 6
Enter the following command to make sure that the file is detected:
# LicenseAdminScript.pl -o rereadVerify that the license has been registered by entering the following command:
statusThe output should include the following:
- Checking if license server is up and running [LOADED]
Set Up AVMs and VNEs
AVMs are Java processes (independent JVMs) with their own dedicated memory. AVMs are mostly used to provide the necessary distribution support platform for executing and monitoring multiple VNEs.
Each VNE is a virtual representation of a single network element. VNEs are distributed between the AVMs.
The distribution of VNEs to AVMs depends mainly on the VNE memory footprint. A single AVM may hold tens of smaller VNEs (U-PE, access, CEs) or fewer very large VNEs (Aggregation, PE, P).
Follow these general guidelines for AVMs and VNEs:
•
Allocate 1.5 GB per AVM.
•
Assign VNEs with similar device types to the same AVM.
•
You should have up to 13 AVMs with 1.5 GB each for your entire setup. (This guideline assumes your setup meets the assumptions and caveats described in Assumptions and Caveats.)
Following are more specific guidelines for AVM-VNE distribution based on the Supported Deployment Options for the Quick Start Guide setup:
Use the following procedures to create AVMs and assign VNEs:
Create AVMs
You can add AVMs to units or directly to a gateway (in a one-server setup). The AVM must have a unique ID between 101-999 (AVMs 1-100 are reserved by Cisco ANA). Every AVM requires a dedicated TCP port which is created using the following naming convention:
AVM-ID + 2000
For example, if you created AVM 711, it would use port 2711. The appropriate TCP port must be available or the AVM creation will fail.
Each AVM has its own log in $ANAHOME/Main/logs.
Note
Before you add AVMs, confirm that AVM 0, AVM 99, and AVM 100 are running on the gateway. For more information on the status of AVMs, see "Understanding AVM Status" in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
To create an AVM:
Step 1
In Cisco ANA Manage, expand the ANA Servers branch.
Step 2
Right-click the unit (or gateway) on which the AVM will be created, and select New AVM. The New AVM dialog is displayed. It provides the following pre-populated information for the AVM:
•
The parent unit's IP address, in the ANA Unit field.
•
The available memory on the unit.
•
The allocated memory for the AVM (default is 256 MB).
Figure 4 New AVM Dialog
Step 3
Enter a unique ID for the AVM in the ID field. The ID can be a number between 101-999.
Step 4
Enter a name for the AVM in the Key field. This key will be used as the AVM's unique identifier and display name in Cisco ANA Manage. If you do not enter a key, the default ID+time_stamp is used.
Step 5
Change the maximum allocated memory in the Allocated Memory field. The recommended size for the Quick Start Guide setup is 1536 MB (1.5 GB).
Step 6
Check the Activate on Creation check box to load the AVM, change its administrative status to Up, and ensure that the AVM is loaded on subsequent restarts of the unit.
Step 7
Click OK. The new AVM is added to the selected unit and is activated. The AVM can now host VNEs.
Add VNEs
To manage your network elements (NEs) with Cisco ANA, you must add VNEs to the system. Each VNE represents a single NE. Adding a VNE involves specifying identifying information and defining the communication protocols the VNE will use to communicate with the NE. When the VNE loads, Cisco ANA starts investigating the NE and automatically builds a live model of it, including its physical and logical inventory, its configuration, and its status. The logic and method used by Cisco ANA is described in the Cisco Active Network Abstraction 3.7.2 Theory of Operations Guide. (The Theory of Operations Guide was not revised for Cisco ANA 3.7.3.)
For detailed information about adding and managing VNEs, see "Managing VNEs" in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
For the purposes of this Quick Start Guide, we assume the following:
•
The default Telnet protocol (not SSH) will be used for network element access (reachability) and modeling.
•
ICMP will not be enabled.
•
The default polling values will be used to determine polling intervals.
•
No additional IP addresses other than the management IP address will be monitored for events.
Before you begin to add VNEs:
1.
Make sure that the devices to be managed by Cisco ANA are configured according to the prerequisites. See Configure Your Devices to Enable Effective Cisco ANA Management.
2.
Identify which AVMs will hold which VNEs. See Ensure that Ports to be Used by Cisco ANA are Open.
Tip
Place devices of the same type together in an AVM to reduce the memory consumption of the VNEs.
3.
To speed up the procedure for adding VNEs to Cisco ANA, prepare the following information for each device in advance:
a.
Device management IP address
b.
SNMPv1 or v2: read and write community strings
c.
SNMPv3: The username and, optionally, the authentication or privacy configuration.
d.
Telnet port number and login sequence.
4.
Consider which VNE scheme to specify for your VNEs, Product or IPcore. The VNE scheme determines the network element information that is collected by a VNE and populated in its model. You should choose the scheme based on the device's role in the network. If you want to designate a router as a core Provider or Provider Edge device in an MPLS VPN network, use IPCore, otherwise you can use Product. For details, see "Choosing a Scheme" in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
5.
Make sure that the status of the AVM to which you will be adding VNEs is Up.
To add VNEs to an AVM:
Step 1
Navigate to the required AVM in the navigation tree.
Step 2
Right-click the AVM, then choose New VNE. The New VNE dialog box is displayed.
Step 3
In the General tab, specify the following mandatory information in the relevant fields:
a.
VNE name, which will server as a unique identifier for the VNE.
b.
Device management IP address of the network element.
c.
In most cases, you should be able to use the default values for the other fields. For a full description of all the fields in this tab, see "VNE General Settings" in the Cisco Active Network Abstraction 3.7.3 Administrator Guide. You can change these settings at a later stage, if necessary, by right-clicking the VNE and selecting Properties.
Figure 5 New VNE - General Tab
Step 4
In the SNMP tab, enter SNMP credentials. For a full description of all the fields in this tab, see "VNE SNMP Settings" in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
Step 5
In the Telnet/SSH tab, select the Enable checkbox and enter Telnet prompt information, as follows:
a.
In the Prompt field, enter the prompt expected from the device.
b.
In the Run field, enter the response to the expected prompt.
Note
Click Mask if you do not want your entries to be displayed in clear text. The Confirm field will be enabled so that you can confirm your Run entry.
Figure 6 New VNE - Telnet/SSH Tab
c.
Click Add. The prompt-run sequence line is added to the table.
d.
Continue to add lines as necessary, ending with a line that includes only the prompt.
For examples of how to enter the Telnet login sequence, see "Telnet and SSH Login Sequences: Notes and Examples" in theCisco Active Network Abstraction 3.7.3 Administrator Guide.
Note
Telnet is the default protocol used for network element access (reachability) and modeling. The assumption in this guide is that you will not be using SSH for this purpose. It is also assumed that you will not be using ICMP polling.
Step 6
Click OK to create the VNE.
Timesaver
For similar VNEs, use the Clone VNE feature. Add the first VNE, then right-click on it and select Clone VNE. Specify the VNE name and IP address; other definitions are copied from the source VNE and you can change them if necessary.
Set Up Users and Security
Cisco ANA uses two methods to control user access and security:
•
Security access roles determine the actions a user can perform in the GUI clients
•
Scopes determine which devices a user can access, and the actions they can perform on those devices.
When you create a user in the system, you assign one user access role and one or more scopes to the user.
Cisco ANA provides five predefined security access roles that can be assigned to users:
•
Viewer—Read-only access to Cisco ANA NetworkVision to view devices, links, events and inventory.
•
Operator—Can perform most day-to-day business operations, such as managing alarms, manipulating maps, viewing network-related information, and managing business tags.
•
OperatorPlus—Can manage the alarm lifecycle, in addition to the functions available to the Operator.
•
Configurator—Can perform tasks and tests related to configuration and activation of services, through Command Builder, Configuration Archive, NEIM, and activation commands.
•
Administrator—Full access to all devices and system functions. Only the Administrator has access to Cisco ANA Manage and Cisco ANA EventVision.
For details about the tasks available for the different user roles and scopes, see "Managing User Security: Roles and Scopes" in theCisco Active Network Abstraction 3.7.3 Administrator Guide.
Add Scopes
Scopes are groups of network elements. Using scopes, you can determine the devices to which users have access. Each scope has a security level that determines which actions the user can take on the devices in the scope.
It is useful to create scopes before creating users so that the scopes will be readily available for assigning to the users. You can also create scopes on-the-fly during the user creation process.
To create a scope:
Step 1
Right-click on Scopes in the Cisco ANA Manage navigation tree, and select New Scope.
Step 2
Enter a unique identifying name for the scope in the Scope field.
Step 3
Specify the devices to include in the scope by selecting the required devices from the Available Devices list and then clicking Add All or Add Selected to move the devices to the Active Devices list.
Tip
You can use the Ctrl or Shift keys to select multiple devices.
Figure 7 New Scope
Step 4
Click OK. The scope is created and is displayed in the content area.
Add Users
You need to create a user account for each person who will be accessing the Cisco ANA GUI. This involves defining the username and password and other user account settings, assigning a user role, and assigning scopes.
To create a user account:
Step 1
Right-click on Users in the Cisco ANA Manage navigation tree, and select New User. The New User wizard is launched. For detailed information about all the fields in the New User wizard, see "Creating User Accounts and Assigning Default Permissions" in the Cisco Active Network Abstraction 3.7.3 Administrator Guide.
Step 2
In the General Information area, enter a unique identifying name for the user in the User Name field, and enter a password in the Password and Confirm Password fields. Follow these guidelines for creating a valid password:
•
At least 8 characters long, but not more than 20 characters.
•
Must contain at least 3 of the following: lowercase letters, uppercase letters, digits, and special characters.
•
Must not contain the user name.
•
Must not contain the words Cisco or ANA.
Step 3
Click Next.
Step 4
In the ANA User Role area, select the relevant user role for this user.
Tip
When you select a radio button, a description of that role is displayed on the right.
Step 5
In the Device Security area, assign one or more scopes to define the user's device access rights, as follows:
a.
Click Add. The Add Scope dialog is displayed.
b.
Select the required scope(s) in the Available Scopes area.
c.
Select a security level for the selected scope(s). This determines what actions the user will be able to perform on the devices in the scope.
d.
Click OK. The scopes appear in the list of assigned scopes.
Tip
Click Edit if you want to change the scope's security level.
Note
If the scope you need does not exist, click New Scope to create it. You will then be able to assign it to the user.
Step 6
Click Next if you want to change the User Account settings, or click Finish to create the user. The user appears in the table of ANA users.
5 First Steps with Cisco ANA NetworkVision
After installing and setting up Cisco ANA, you can start creating maps and monitoring your network elements in Cisco ANA NetworkVision. This section contains the following subsections:
•
Log Into Cisco ANA NetworkVision
•
Quick Overview of the Cisco ANA NetworkVision GUI
•
Create a Map for Network Visualization
Log Into Cisco ANA NetworkVision
To log into Cisco ANA NetworkVision:
Step 1
Choose Start > Programs > Cisco ANA > Cisco ANA NetworkVision.The Cisco ANA NetworkVision Login dialog box is displayed.
Step 2
Enter your username and password.
Step 3
In the Host field, enter the IP address (as specified during gateway installation) or the hostname of the Cisco ANA gateway server.
Step 4
Click OK. The Cisco ANA NetworkVision window appears empty when it is opened for the first time.
Quick Overview of the Cisco ANA NetworkVision GUI
Cisco ANA NetworkVision is the main GUI application used to visualize the network through network and service maps, to view device physical and logical inventories and connectivity, and to manage device configuration and software images.
Cisco ANA NetworkVision enables you to:
•
View network inventory and multiple-layer connectivity.
•
Troubleshoot, monitor, and manage network elements (NEs).
•
Model and view network maps, maintaining up-to-date topological information on device connections, traffic, and routes.
Figure 8 shows the Cisco ANA NetworkVision window. The window includes a tree-and-branch representation of the network elements on the left, and a map view representation of the network elements, links, and logical entities such as VLAN, VPNs and other entities that comprise the network on the right.
Map view icons are displayed in aggregated or expanded view. Any icon that has a + in the upper right corner is closed aggregation. Double-clicking it expands the aggregation. Right-clicking and selecting Show Thumbnail displays the aggregation contents within the parent map. Anything that has a green frame around it and a - (minus sign) in the upper right corner is an open aggregation. Almost all the items in the upper right corner of Figure 8 are aggregations as indicated by the + symbol. Aggregations can contain other aggregations.
Bell icons displayed in different colors can be attached to network element icons. These are alarm severity badges. The color indicates the highest severity alarm raised for the network element. Beneath the severity badges are the management state badges. The management state indicates the state or mode of the VNE managing a network element and the communication with it. This enables you to determine the accuracy of the network information and the availability of VNEs to carry out network operations.
For a list of all icons and buttons displayed in Cisco ANA NetworkVision, see "Icon and Button Reference" in the Cisco Active Network Abstraction 3.7.3 User Guide.
Figure 8 Cisco ANA NetworkVision Primary Window with an Open Map
1Menu bar—The functionality that a user can access depends on the user role and the security level of the scopes assigned to the user. The menus are context-sensitive and the options vary depending on your selection in the application. See "Cisco ANA NetworkVision Menu Bar" in the Cisco Active Network Abstraction 3.7.3 User Guide for details.
2Toolbar—The toolbar is context-sensitive and the options vary depending on your selection in the application. See "Cisco ANA NetworkVision Toolbar" in the Cisco Active Network Abstraction 3.7.3 User Guide for details.
3Network element. Icon color denotes severity.
4Links—Can represent multiple physical, topological, service, and business links.
5Alarm icon; color indicates severity: Critical (red), Major (orange), Minor (yellow), Warning (sky blue), Cleared/Normal (green), Informational (dark blue), Indeterminate (white). Under the alarm icon is a VNE state badge displaying the communication and status of the device VNE.
6VLAN displayed in expanded view.
7MPLS network displayed in aggregated view.
8VPN displayed in aggregated view.
9VLAN displayed in aggregated view.
10Ethernet service with a second Ethernet service displayed in expanded view.
11Map view content pane. The content pane displays three views: map, list and links. For details, see "Content Pane: Map, List, and Links Views" in the Cisco Active Network Abstraction 3.7.3 User Guide.
•
Map view—Topological view of managed elements.
•
List view—Tabular view of managed elements contained in the map.
•
Links view—Tabular view of links and link aggregations.
12Status bar—Displays the view's current connection status and status of any issued commands. The memory utilization bar in the status bar displays the amount of memory used by the client. By default, if memory utilization exceeds 60%, it is colored yellow, and if it exceeds 80%, it is colored red.
13Ticket pane—Displays tickets relating to all the network elements in the map.
14Hide/display ticket pane.
15Navigation pane—Displays a tree-and-branch representation of the network elements and aggregations defined for the loaded map.
Create a Map for Network Visualization
Cisco ANA NetworkVision enables you to create multiple network maps to represent specific network views. Views can cover specific network segments, customer networks, or any other mix of network elements desired. When you create a map, it is available to other users if they have sufficient access and security privileges.
The network maps provide a graphic display of active faults and alarms, and serve as an easy access point for activating services.
To create a new map:
Step 1
Do one of the following:
•
Click New Map in the main toolbar.
•
Choose File > New Map in the main menu.
The Create Map dialog box is displayed.
Step 2
Enter a name for the new map and click OK.
Step 3
Add elements to your new map. Choose File > Add to Map or click the down arrow next to the Add to Map icon in the main toolbar. Choose the type of element you want to add to the map, for example, network element, VPN, VPLS, VLAN, and so on.
Figure 9 Select Element Type
Step 4
In the Add Element dialog box, either select Show All to display all available elements of that type, or run a search for specific elements.
Note
If a network element is not included in your scope, it is displayed with the locked device icon.
Figure 10 Select Elements to Add to Map
Step 5
Select the elements that you want to add to the map. You can select and add multiple elements by pressing Ctrl while selecting individual network elements or by pressing Ctrl +Shift to select a group of elements.
Step 6
Click OK. The elements are displayed in the navigation pane and in the map. In addition, any associated tickets are displayed in the ticket pane.
Fault Management Basics
Cisco ANA analyzes and manages faults through event collection, identification, and correlation. After identifying the event, Cisco ANA groups the events related to it, then uses the virtual network model to inspect the fault and perform correlation to find the root cause and create a ticket.
An event is a distinct incident that occurs at a specific point in time, for example, a port status change, connectivity loss, device unreachable, etc. Examples of events include:
•
Port status change
•
Connectivity loss (for example, BGP Neighbor Loss) between routing protocol processes on peer routers
•
Device reset
•
Device becoming unreachable by the management station
An event is a possible symptom of a fault, which is an error, failure, or exceptional condition in the network.
In Cisco ANA NetworkVision and Cisco ANA EventVision, an event is represented by a small icon in the form of a bell. Events have an associated severity, and each severity is represented by a specific color—Critical (red), Major (orange), Minor (yellow), Warning (sky blue), Cleared/Normal (green), and Information (dark blue).
The lifecycle of a fault scenario is called an alarm. An alarm is characterized by a sequence of related events, such as port-down and port-up. A ticket represents an attention-worthy root alarm whose type is marked as ticketable.
For details about fault management in Cisco ANA, see "Fault Management in Cisco ANA" in the Cisco Active Network Abstraction 3.7.2 Theory of Operations Guide.
Appendix A: Additional Cisco ANA 3.7.3 Guides
The Cisco ANA 3.7.3 documentation set contains the following guides:
•
Cisco Active Network Abstraction 3.7.3 User Guide
•
Cisco Active Network Abstraction 3.7.3 Configuration and Image Management User Guide
•
Cisco Active Network Abstraction Network Service Activation 1.3 User Guide
•
Cisco Active Network Abstraction 3.7.3 Quick Start Guide
•
Cisco Active Network Abstraction 3.7.3 Installation Guide
•
Cisco Active Network Abstraction 3.7.3 Release Notes
•
Cisco Active Network Abstraction 3.7.3 Administrator Guide
•
Cisco Active Network Abstraction Network Service Activation 1.3 Customization Guide
•
Open Source Used in Cisco Active Network Abstraction 3.7.3
Although the following documents were not updated for this release, their content applies to Cisco ANA 3.7.3.
•
Cisco Active Network Abstraction 3.7.2 Reference Guide (reference information is instead provided in the Cisco Active Network Abstraction 3.7.3 Release Notes)
•
Cisco Active Network Abstraction 3.7.2 Device Package Third-Party VNE Reference Guide
•
Cisco Active Network Abstraction 3.7.2 Theory of Operations
•
Cisco Active Network Abstraction 3.7.2 Customization User Guide
•
Cisco Active Network Abstraction Integration Developer Guide
Appendix B: Device Information Form
You can print this table and use it to organize your AVM-VNE distribution and list the information you will need when creating VNEs.













