Table Of Contents
Video SLA Assessment Agent 3.1
This guide is for Cisco Prime Collaboration users.
Overview of VSA Agent
Prime Collaboration uses VSA Agent to assess a network's readiness to deploy or upgrade Cisco TelePresence systems. VSA Agent provides network path characteristics, such as latency, jitter, and packet loss measurements, prior to deployment. By automating the assessment process, VSA Agent accelerates and simplifies deployment. We recommend that you review "Diagnostics for Video Endpoints" in the Cisco Prime Collaboration 9.0 Network Monitoring, Reporting, and Diagnostics Guide or Cisco Prime Collaboration Assurance Guide.
VSA Agent tests are run between two systems: source and destination. These systems must reside on the same topology as the source and destination video feeds (the Cisco TelePresence System). VSA Agent must be deployed at both the source and destination systems (see Figure 1 for the deployment topology).
Figure 1 VSA Agent Deployment Topology
System and USB Drive Requirements
You can install VSA Agent 3.1 on the USB drive only. Table 1 lists system and USB drive requirements for running the VSA Agent software.
Note The display driver, USB driver, and Intel Chipset Device Software on the system must support the Fedora Linux operating system. See Appendix: Tested Systems and USB Drives for all tested systems and USB drives.
Table 2 lists the ports that VSA Agent uses. These ports must be open in both directions on the source and destination systems on which VSA Agent is installed.
Table 2 Port Requirements
Port Number Protocol
Make sure that the ICMP ping and traceroute commands are enabled between:
•VSA Agent systems
•VSA Agent systems and the Prime Collaboration Assurance server
Installing VSA Agent on the USB Drive
VSA Agent installation consists of two steps:
We recommend that you install and test VSA Agent in a lab environment before you test it in a production environment.
If you are installing VSA Agent 3.1 software on multiple USB drives, make sure that the same VSA Agent version is installed on all systems.
Before You Begin:
1. Verify the following:
•A minimum 16 GB USB drive is available for the installation.
Caution Do not use a USB flash drive with more than 32 GB of memory.
•USB 2.0 port is available for the installation.You cannot install VSA agent on a USB 3.0 port.
•Administrator privilege is available on the system on which you plan to use the USB drive.
2. From the Cisco Prime Collaboration software download site, download the following images to the Windows system on which you plan to install VSA Agent:
Note You must have a valid Cisco.com user account to download the files.
Creating a Bootable USB Flash Drive for VSA Agent
To create a bootable USB flash drive:
Step 1 As administrator, log into the system on which you have downloaded the zip files from the software download site.
Step 2 Unzip the pc90-vsaa-creator-188.8.131.52-FC14.zip file.
Step 3 Insert the USB drive.
Step 4 Navigate to the directory where you have extracted the pc90-vsaa-creator-184.108.40.206-FC14.zip file.
If you are using Windows 7 operating system, you must run the file as an administrator (right-click the file and select the Run as administrator option).
Step 5 Open a command prompt and enter buildkey to format the USB drive.
Step 6 In the Buildkey window, select the USB device and click Browse for Fedora 14.
Step 7 Navigate to the directory where you have downloaded the pc90-Fedora-14-i686-Live-Desktop.iso file.
Step 8 Choose the pc90-Fedora-14-i686-Live-Desktop.iso file and click Accept.
Step 9 Click Install VSAA.
Step 10 Enter y to start the installation.
Step 11 Press any key to continue after the installation is complete.
Booting from the USB Drive
After you install VSA Agent on the USB drive, you must then boot the system from the USB drive. The system must have wired network connection. The wireless connection should be turned off.
To boot the system from the USB drive:
Step 1 Reboot the system and press the F12 key while rebooting.
Step 2 From the list of devices that allow you to boot, choose the USB drive.
You are logged in automatically.
Step 3 At the command prompt, switch user to root using the following command:
Step 4 Enter the password tpc1sc0.
Step 5 Click the terminal icon and verify the VSA Agent installation using the following command:ps -ef | grep mtaa
The following is sample output of the command:root 6996 1 0 May22 pts/3 00:00:00 /usr/local/mtaa/bin/vsaaTrouteSvcroot 9276 1 0 May23 pts/3 00:00:05 bin/mtaaSoapServerroot 9281 1 0 May23 pts/3 00:00:00 bin/mtaaHttpServerroot 9286 1 0 May23 pts/3 00:16:59 bin/mtaaSipServerroot 9291 1 0 May23 pts/3 00:22:47 bin/mtaaActiveqosroot 9295 1 0 May23 pts/3 01:42:03 bin/mtaaPassiveqosroot 14004 13987 0 11:50 pts/1 00:00:00 grep --color=auto mtaa
You can also verify the status of VSA Agent processes by entering the IP address of the VSA Agent system in a web browser:
See Troubleshooting the VSA Agent Installation if the processes are not running.
Step 6 Configure the VSA Agent IP address (see Configuring the VSA Agent System IP Address).
Caution The USB drive contains the live file system. To avoid data corruption, be sure to shut down the VSA Agent system in the proper manner.
Configuring the VSA Agent System IP Address
You can configure the VSA Agent system IP address in either of two ways:
•DHCP IP Address—The VSA agent system IP address is obtained automatically. Use the command ifconfig to find the IP address of the VSA Agent system. You can log into the VSA Agent system using SSH with the username root and the password tpc1sc0.
•Static IP Address—The VSA Agent system IP address must be configured manually.
To configure the static IP address on the VSA Agent system:
Step 1 Boot the VSA agent system using the USB drive. See Booting from the USB Drive.
Step 2 Choose System > Preferences > Network Connections.
Step 3 In the Query dialog box, enter the root password tpc1sc0, and click OK.
Step 4 In the Network Configuration properties window, double-click a device name.
Step 5 In the Ethernet Device properties window, change the interface from DHCP to STATIC and enter the required data.
If you change settings remotely, be sure to enter the values very carefully. You must have physical access to the VSA Agent system if you enter incorrect values.
Step 6 After the configuration, reboot the system and verify the IP address configuration using the command ifconfig.
Also, you must verify whether you can reach the default gateway from the VSA agent system.
You are now ready to run the network readiness assessment using Prime Collaboration. See "Diagnostics for Video Endpoints" in Cisco Prime Collaboration 9.0 Network Monitoring, Reporting, and Diagnostics Guide or Cisco Prime Collaboration Assurance Guide for the procedure.
Troubleshooting the VSA Agent Installation
Appendix: Tested Systems and USB Drives
Table 4 list the systems that are compatible with Fedora Linux 14 and tested for VSA Agent 3.1.
Tested USB Drives
Table 5 list the USB drives that are tested for VSA Agent 3.1.
Table 5 Recommended USB Drives for VSA Agent 3.1
Recommended Manufactures Not Recommended Manufacturer
See Cisco Prime Collaboration Documentation Overview for a list of Prime Collaboration guides.
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)
Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2013 Cisco Systems, Inc. All rights reserved