Setup Guide: TeraVM on Microsoft Azure. TeraVM Version 11.4

Transcription

1 Setup Guide: TeraVM on Microsoft Azure TeraVM Version 11.4

2 Help and Support Help and Support The TeraVM Documentation Guides, Online Training Guides and Videos are available on the documentation portal: For support queries, please log a call on our support portal: (For accounts, please contact your local Cobham Account Representative). Page i

3 Table of Contents Table of Contents Table of Contents Chapter 1. TeraVM Deployment Example System for Deployment TeraVM Deployment Steps Create Windows Virtual Machine Local Setup Download Microsoft Software Prerequisites Download TeraVM Azure files Configure Connectivity between your Windows Machine and the Azure cloud Set Up Azure Services Set Up Cloud Services Set Up Storage Manage Access Keys Create TeraVM Virtual Networks Example Network Configuration File (NetworkConfig.xml) Edit TeraVM Configuration File (tvm_azure.cfg) Deploy TeraVM in Powershell Select Azure Subscription Create TeraVM Images and Deploy TeraVM Create Virtual Machine for Running TeraVM Current Limitations/Recommendations on Using Azure Chapter 2. Post-Orchestration Steps Access the TVM-C Administration (Web) Interface Set Up and Point to TeraVM License Set Up the License Server Point to the License License Check-in Change Date/Time Settings Download the TeraVM Java Client Install and Run Demo Tests, and Validate Deployment Steps to Install Demo Tests Start TeraVM Client Appendix A. IP Addresses, Usernames and Passwords Appendix B. TeraVM Documentation Set Page ii

4 Chapter 1. TeraVM Deployment Chapter 1. TeraVM Deployment 1.1. Example System for Deployment The Azure cloud, showing an example TeraVM system, is shown below. TeraVM can be deployed from a local Windows machine or from a virtual Windows machine in the cloud. TeraVM is in storage blobs in Azure. Windows Powershell scripts and configuration files to deploy TeraVM are supplied by Cobham outside the cloud. These scripts download the blobs and create TeraVM images and virtual machines in Powershell. In addition, a virtual machine is required in Azure to run the TeraVM Java GUI once it is deployed. Figure 1-1. TeraVM System Example TeraVM Scripts Azure Cloud Local Windows Machine or Virtual Machine on Azure Host for TeraVM Deployment MGMT TVM-C teravmcs1 teravmn1 network COMMS Host for TeraVM Java Client TVM-4 5/ 1 5/ 2 5/ 3 NUT TVM-4 TVM-4 6/ 1 6/ 2 6/ 3 7/ 1 7/ 2 7/ 3 NUT2 NUT TeraVM Storage blob The system has a TVM-C, three TVMs of type TVM-4 (with instance names 5 to 7), and three virtual switches representing three networks under test. Each TVM has three interfaces, for example TVM instance 5 has interfaces 5/1, 5/2, 5/3. Each interface of each TVM is connected to a different virtual switch, for example 5/1 is connected to NUT1, 5/2 to NUT2 and 5/3 to NUT3. Page 1

5 1.2. TeraVM Deployment Steps Note 1. The numbering starts at 5 because the instance number matches the IP address. Azure reserves the first few IP addresses of the COMMS network, so the controller will be assigned the IP address , and the TVMs start at The same interface of all TVMs is connected to the same virtual switch. For example, 5/1, 6/1 and 7/1 are all connected via NUT1, and should be used for host client/server pairs when generating traffic TeraVM Deployment Steps This document guides you through the process of deploying and installing TeraVM on Microsoft's Azure cloud platform. There are a number of steps required to create and set up a TeraVM test bed in Azure before you can create and run tests, as shown below. They should be followed in the order described. The following sections describe the steps in detail. Page 2

6 1.2. TeraVM Deployment Steps Figure 1-2. TeraVM Deployment Steps Local Workstation or Virtual Machine Download Microsoft Software Pre-Requisites Download TeraVM Azure files from Cobham server Configure Local Connection to Azure Edit NetworkConfig.xml Azure Web Interface Create Cloud Service Create Azure TeraVM network Create Storage Windows Powershell Select Azure Subscription Edit tvm-azure.cfg Create TeraVM Images./ create_images.ps1 Deploy TVM-C./ deploy-tvmc.ps1 Deploy TVM./ deploy-tvm.ps1 Deploy Virtual Machine for running TeraVM TeraVM Administration Interface* Set Up & Point to License Server TeraVM Java Client CLI Download TeraVM Client ssh to TVM-C (user cli) Install Demo Tests through CLI Create, Execute Tests, and Analyze Results *Access from web browser (TVM-C IP address) Page 3

7 1.3. Create Windows Virtual Machine 1.3. Create Windows Virtual Machine You may need to create a virtual windows host in Azure if: You are unable to deploy TeraVM in Azure from your workstation due to firewall issues. You are not using a Windows workstation. The steps to do this are as follows: 1. Log into Azure from your web browser. 2. Click on Subscriptions at the top of the screen, and select a subscription. Click Apply. Figure 1-3. Select Subscription Note You can see your subscriptions under Settings -> Management Certificates. 3. Click +New at the bottom of the Azure screen to create a new virtual machine. 4. Click Compute-Virtual Machine-Quick Create. Page 4

8 1.3. Create Windows Virtual Machine Figure 1-4. Create Virtual Machine to Deploy TeraVM from Azure 5. Give a DNS name, user name and password for the virtual machine, and select your region. Click Create. Important The DNS name must be unique. Names already taken will show a red exclamation mark (!). 6. When the machine is created, it will appear in the list on the Virtual Machines tab. Click on it. 7. If you are using a Microsoft RDP client: Click on the Dashboard tab, and then the Connect button at the bottom of the screen. You will see the following prompt. Click Save to save the.rdp file that you will use to connect to the virtual machine. Figure 1-5. Save Settings File Open Windows Remote Desktop Connection. Select the virtual machine in the Computer drop down menu. Click on Local Resources -> More and select your C: drive (where you will store the TeraVM script and configuration files). Figure 1-6. Remote Desktop Connection Page 5

9 1.3. Create Windows Virtual Machine When you connect to the virtual machine, you will see your local C: drive under Windows Explorer. Figure 1-7. Remote Desktop Connection 8. If you are not using a Microsoft RDP client, you will need to manually enter the DNS name and public port to connect. To get the port, to the Endpoints tab, and note the public port number corresponding to 3389 (remote desktop connection). Page 6

10 1.4. Local Setup Figure 1-8. Public Port 1.4. Local Setup Download Microsoft Software Prerequisites Your Windows machine must have an internet connection and the following Microsoft software installed: 1..NET Framework 3.5 (already installed in Windows 8 or later). If you do not have it, do an internet search for "Download.NET Framework"; (it is currently available from 2. Windows Powershell 3.0 or later (already installed in Windows 8 or later). This is a scripting platform from where you can control Windows Azure from the command line. You will run TeraVM deployment in Azure from here. Search for "Windows Powershell"; currently available from articles/powershell-install-configure/. 3. Azure Cmdlets Module (otherwise known as Windows Azure Powershell (and should not be confused with Windows Power Shell as they are different). These are scripts that run within Windows Powershell. Search for "Download Azure Cmdlets Module"; currently available from the following link: msdn.microsoft.com/en-us/library/dn135248(v=nav.70). 4. Azure Azcopy, (also known as Microsoft Azure Storage). Search for "Download Azure Azcopy"; currently available from Download TeraVM Azure files 1. Go to the release location given to you by Cobham support. 2. Go to the Azure directory. You will see a number of files. There are three Powershell scripts, which you will run to deploy TeraVM, and two configuration files, one for the Network Configuration (NetworkConfig.xml) and one for the orchestration (tvm-azure.cfg). 3. Download the files, and save them in your work area. You will use these files, together with the TeraVM blobs in Azure, to deploy TeraVM. Page 7

11 Configure Connectivity between your Windows Machine and the Azure cloud Note If you are using a Virtuial Windows Machine without RDP, you will need to transfer these files to the Azure Windows Virtual Machine you created earlier Configure Connectivity between your Windows Machine and the Azure cloud Next you must download Azure credentials onto your Windows machine to allow you to use Azure. 1. Find Powershell on your Windows machine and select Run as administrator. Figure 1-9. Open Powershell in Adminstrator Mode 2. On the Powershell command line, run Get-AzurePublishSettingsFile. This opens Internet Explorer and brings you to the web address for Azure. 3. Login into your Microsoft Azure account. Follow the on-screen instructions to download (save) your Azure.publishsettings file (This is an XML file which contains information about your subscription). Note the name and the path of the file. Take a note of the Subscription ID, as you will need to put in the TeraVM configuration file later. An example is given below. Page 8

12 1.5. Set Up Azure Services Figure PublishSettings File Example 4. Run the command below to import the subscription file you just downloaded onto your machine: Import-AzurePublishSettings path_to_file_you_just_downloaded/filename. Figure Import PublishSettings File Command 1.5. Set Up Azure Services Next, you will set up an Azure cloud service and storage. These will be used during TeraVM deployment Set Up Cloud Services Create a cloud service as shown, giving it a unique name. This cloud service will be used to hold your TeraVM virtual machines. Take a note of the name to use later in tvm-azure.cfg. Page 9

13 Set Up Storage Figure Create Cloud Service Set Up Storage Create a storage service as shown, giving it a unique name. This will hold your TeraVM virtual machines. Take a note of the name to use later in tvm-azure.cfg. Page 10

14 Manage Access Keys Figure Create Storage Service Manage Access Keys 1. Click on the Storage you just created and click the Manage Access Keys button at the bottom of the screen: Figure Manage Access Keys 2. Copy the primary key and paste it to a file; you will be putting this into the configuration file, tvm-azure.cfg, later. Page 11

15 Create TeraVM Virtual Networks Figure Copy Access Keys Create TeraVM Virtual Networks Next create your virtual TeraVM networks. You can enter the network details directly in Azure, but it is easier to modify and import the supplied template configuration file, NetworkConfig.xml, as we shall do here. An example file is shown in the next section. You need to define a management network, MGMT, a COMMS network, and one or more NUT networks, as appropriate for your network under test, for example, NUT1. The COMMS address space should be /24. The MGMT subnet should match the address space for your TeraVM license. Configure the NUT address space as appropriate for testing. 1. Click the + button on the Network tab, and select Import Configuration. Figure Import Network Configuration 2. Browse for and select your network configuration file, and click -> followed by a tick. Page 12

16 Create TeraVM Virtual Networks Figure Select Configuration File 3. The network will be created and you will see your virtual network address spaces under the Configuration tab. Figure Network Address Spaces Page 13

17 Example Network Configuration File (NetworkConfig.xml) Example Network Configuration File (NetworkConfig.xml) Note The file shown here is one of those you downloaded. This example creates five TeraVM virtual networks, and corresponds to the example system described earlier. Figure NetworkConfig.xml 1.6. Edit TeraVM Configuration File (tvm_azure.cfg) Next edit the configuration file you will use during TeraVM deployment. A template is supplied with TeraVM. An example is shown below that corresponds to the example system described earlier. Page 14

18 1.6. Edit TeraVM Configuration File (tvm_azure.cfg) Figure tvm-azure.cfg supplied with TeraVM Page 15

19 1.7. Deploy TeraVM in Powershell 1.7. Deploy TeraVM in Powershell Select Azure Subscription Next you need to select the Azure subscription you will use to deploy TeraVM. 1. Open Windows Powershell on your workstation. 2. Select the subscription you want (you may have a few): Select-AzureSubscription <subscription name> Figure Windows Powershell Create TeraVM Images and Deploy TeraVM Tip Type Get-Help in Powershell for help with commands. Note All the TeraVM files you downloaded should be in your work directory. 1. Run the following powershell script from your work directory./create_images.ps1 This file uses the configuration file, tvm-azure.cfg, you edited in the previous step. It uses Azure Azcopy to copy TeraVM Azure.vhd files from their central location to the storage area you created locally in Azure, and then creates TVM-C and TVM images which will be used in the TeraVM deployment. 2. Now deploy the TVM-C. Run the following Powershell script, again from your work directory:./deploy-tvmc.ps1 3. Now deploy the TVMs. Run the following Powershell script, again from your work directory:./deploy-tvm.ps1 Page 16

20 1.8. Create Virtual Machine for Running TeraVM 4. Once TeraVM is deployed successfully, you will see your new virtual machines in the Azure GUI, as shown below. Note You can ignore the error "Provisioning Failed"; this is an Azure issue. Provided all machines are there and running, and no errors messages were returned during deployment in Powershell, TeraVM has been deployed correctly. 5. Click on the Controller Virtual Machine, and go to Dashboard to find the IP address of TeraVM. There are public and internal IP addresses assigned by Azure for the TeraVM controller. Attention. You should use the internal IP address for the controller. This IP address is referred to as the Controller (TVM-C) IP address in the TeraVM documentation Create Virtual Machine for Running TeraVM You also need to create a virtual machine to run TeraVM. This is because the management network for TeraVM must be in Azure. Page 17

21 1.9. Current Limitations/Recommendations on Using Azure 1. Follow the same procedure described earlier to create and connect to a new virtual machine for running TeraVM. 2. Use this machine to complete the post-orchestration steps in the next section. Note The web administration steps can be done from the local machine, or anywhere with access to the Internet using the public address of the controller, but starting the client should be done from the Virtual Machine you just created, by accessing the internal address of the controller Current Limitations/Recommendations on Using Azure A virtual machine should be used to run the TeraVM Java client, as the Management Network for TeraVM needs to be in Azure. TeraVM's host scaling feature is not useful as the resulting traffic would be dropped by Azure's anti-spoofing access lists. It is recommended that you use DHCP to assign IP addresses of hosts, or use the static addresses assigned by DHCP. Only TVMs of type TVM-4 are supported. If you already have a virtual network set up in Azure, you may have problems importing a network configuration file. In this case, you should add the network manually. It is best to put the virtual machine for running TeraVM in its own cloud service. This is because the cloud service for TeraVM only supports multiple NIC virtual machines (which require more expensive virtual machine sizes, and cannot be created with the Azure GUI). Page 18

22 Chapter 2. Post-Orchestration Steps Chapter 2. Post-Orchestration Steps Note Before you begin, make sure you have all IP addresses, user names and passwords at hand. For convenience, these are listed in Appendix A. After you have deployed and started TeraVM, you still need to perform some additional steps before using the system. 1. Log on to the TeraVM Administration Interface. 2. Set up and point to the License Server. 3. Download client. 4. Install and run demo tests Access the TVM-C Administration (Web) Interface You configure TeraVM through the TVM-C Administration (Web) Interface. Open your web browser and go to the IP address of the TVM-C. Figure 2-1. TeraVM Administration Interface Note The software and build version of TeraVM are shown on the right. Username is diveradmin, password is diversifeye. Page 19

23 2.2. Set Up and Point to TeraVM License 2.2. Set Up and Point to TeraVM License Set Up the License Server The TeraVM license file must be either installed on the TVM-License Server (TVM-LS) or added as a system specific license uploaded directly through the TVM-C Administration interface. If you are using TVM-LS, see the TVM-LS License Server User Guide for details on how to set it up Point to the License Once the license file is installed and running: Open the TVM-C Administration Interface from your web browser. Select the TeraVM tab and click Post Install Configuration. Figure 2-2. Post Install Configuration In the License Mechanism section, choose between License Server and System Specific License in the drop-down. If you choose License Server: Specify the IP Address of the License Server in License Server Settings. Click Save. Make sure that 'Web Interface Status' shows Contactable and click Browse it to make sure that you can get to the license server. Page 20

24 License Check-in Figure 2-3. Configure License Server Settings If you choose System Specific License, the license is attached to the MAC address of the controller. Select Choose File in the New License section. Browse to and select the license file you received from Cobham and click Upload. Once the.lic file has successfully uploaded, a notice appears at the top of the License Mechanism page License Check-in Available licenses are automatically checked out when a test is started, but it is necessary to manually check-in a license once the test is complete so that it is available to others. To check-in a license, click License Check-in on the TeraVM page in the TVM-C Administration Interface. The License Check-in page shows whether licenses are checked-out or checked-in. If no tests are running, the page is empty. The Checked-out Licenses section lists the names of licenses in use, and how many of each license are currently checked-out. The Check-in All Licenses button allows you to manually check-in all currently checked-out licenses simultaneously. If there are no licenses currently checked-out the Check-in All Licenses button appears greyed out. TVM-C checks the status of all the licenses every 120 seconds. To ensure that you see all of the licenses that are currently checked-out, click Refresh in the Checked-out Licenses section Change Date/Time Settings To make sure your licenses are checked out correctly for different time zones, you may need to change your date/time settings. 1. At the Admin tab in the TVM-C Administration Interface, click the Configure button in the Date/Time Settings section. Page 21

25 2.3. Download the TeraVM Java Client Figure 2-4. Configure Date/Time Settings 2. Choose the appropriate time zone, whether or not you wish to enable Network Time Protocol on the network, and if you want to use a specific NTP server. Click Save. This will result in a reboot of the TVM-C Download the TeraVM Java Client 1. Open the TeraVM Administration Interface from your web browser (this is the IP address of the TeraVM controller). 2. Click Download TeraVM X Client in the Quick Links Menu (where X stands for the TeraVM version number). 3. Once the installer has downloaded completely, right-click on it, and select Run as Administrator. The installation wizard guides you through several configuration steps to complete installation. Page 22

26 2.4. Install and Run Demo Tests, and Validate Deployment Figure 2-5. Download TeraVM Java Client 2.4. Install and Run Demo Tests, and Validate Deployment TeraVM comes with pre-configured test groups which help you get started quickly with TeraVM. The applications covered include HTTP, VoIP, FTP, Replay, RTSP and Multicast Steps to Install Demo Tests To successfully load the demo tests, you must deploy a TVM with a minimum of two test interfaces, and define these interfaces in the file flowprocessors.ini. The steps to install and run the demo tests are as follows: 1. Login to the TVM-C console as user cli. 2. cd demodb This directory contains the interface configuration file, flowprocessor.ini, which defines the two test interfaces that are used to pass traffic between client and server during the demo tests. The default test ports for client and server are 3/1/3 and 3/1/4 respectively. 3. Run the following cli command to check which interfaces you have: cli listinterfaces 4. If you don t have the two interfaces called 3/1/3 and 3/1/4, modify flowprocessors.ini to include yours. (The file must only have 2 lines and maintain the format. TeraVM:Test Module:Test Interface) Page 23

27 Start TeraVM Client 5. Import the tests into the controller database by running: bash /home/cli/demodb/build.sh As the configuration proceeds, error messages will be generated if invalid test interfaces are selected. Note There is currently a TeraVM bug where spurious error messages are generated, for example Test Group does not exist. If this happens, continue to the next step to see if the tests were imported successfully into TeraVM Start TeraVM Client 1. Once the TeraVM client installation is complete, double-click on the TeraVM application icon to open the TeraVM Client. The Logon to Server dialog appears. 2. Enter the IP address of the TVM-C in the Server Host field, and username demo. Click OK. Note You must log in as user demo to see the Demo tests you installed earlier. Figure 2-6. TeraVM Client Login Screen 3. The TeraVM Client opens up at the Test Groups tab. To see if the TVMs registered correctly, click the Nodes tab. The TVMs and interfaces installed should appear as shown below. A TVM is only available for use if it has registered with the TVM-C. If the TVM fails to start, check your installation. Page 24

28 Start TeraVM Client Figure 2-7. TeraVM Client open on the Nodes Tab 4. Click on the Test Group tab. Right click on Test Groups in the left panel, and select Load All Test Entries to bring the demo tests into TeraVM. Figure 2-8. Load Demo Database Tests 5. If you click on an application, such as http in the left panel, the Host tab will show the interfaces being used. If you can see these applications (with your corresponding interfaces), you have completed installation successfully. Continue to the TeraVM User Guide to start using TeraVM. Figure 2-9. View Demo Test Interfaces Page 25

29 Appendix A. IP Addresses, Usernames and Passwords Appendix A. IP Addresses, Usernames and Passwords The usernames and passwords you will need in TeraVM are shown below. Where a blank column is given, it is recommended you fill this in before you start. Table A-1. IP Addresses, Usernames and Passwords in TeraVM Description Function/Access IP Address Username Password TeraVM Administration Interface Access Controller with Web Browser. Used for Set Up/Admin/Global Settings Controller IP Address diveradmin diversifeye TeraVM Client TeraVM GUI Application. Username and password needed for 1. Admin Tab 2. Shutdown/Restart from GUI. Controller IP Address diveradmin diversifeye Demo Tests To access demo tests diversifeye you must log in as user demo. Controller IP Address demo TeraVM CLI Interface Required to 1. Configure TVM-C with Controller IP Address. cli a static IP address. 2. Run cli commands Accessed from console and automation scripts. or SSH if IP reachable (also TVM_Mgmt) diversifeye License Server (TVM-LS) License Server License set up Hypervisor ESXi Management Assistant (TVMMA) Configure and run ESXi orchestration from the command line. TVM-MA IP Address vi-admin TeraVM Page 26

30 Appendix B. TeraVM Documentation Set Appendix B. TeraVM Documentation Set All TeraVM Guides are available for download at the TeraVM documentation portal: Table B-1 and Table B-2 show the complete TeraVM documentation list. It consists of installation and user guides, which cover the main functionality, and application notes, which provide different application examples. Table B-1. TeraVM Installation and Configuration Guides Hypervisor/Environment Description Document Name ESXi Install and orchestrate TeraVM on ESXi Hypervisor (VMWare) TeraVM on VMWare Set Up and Configuration Guide KVM Install and orchestrate TeraVM on KVM TeraVM on KVM Set Up and Configuration Guide OpenStack on KVM Install and orchestrate TeraVM on KVM on Openstack TeraVM on OpenStack Set Up and Configuration Guide Citrix XenServer Install and orchestrate TeraVM on Citrix XenServer TeraVM on Citrix Xen Set Up and Configuration Guide Hyper-V Install and orchestrate TeraVM on Hyper-V (Microsoft). TeraVM on Hyper-V Set Up and Configuration Guide Amazon AWS Install and orchestrate TeraVM on Amazon AWS TeraVM on Amazon AWS Set Up and Configuration Guide Microsoft Azure Install and orchestrate TeraVM on Microsoft Azure TeraVM on Microsoft Azure Set Up Guide Table B-2. TeraVM User Guides Guide Description TeraVM Orientation Guide Introduction to TeraVM for New Users Release Notes New features / Changes in the latest release. (Includes upgrade instructions and supported versions). TeraVM Appliance Set Up Guide TeraVM Hardware Appliance Set Up TeraVM User Guide How to create and run tests; Details of applications and Hosts supported; TeraVM CLI User Guide Using the Automation Interface (CLI, Perl commands and RFC scripts) for testing. Also man pages are available for commands and scripts in the Documentation sub-directory cli. TeraVM License Server Guide Setting up the License Server Page 27

31 Appendix B. TeraVM Documentation Set TeraVM Application Library Test Configuration Guide, Application Library Repository Users Guide Application Library for test traffic generation. Includes repository setup information. TeraVM 3G and 4G Encapsulation Session Support Guide Tests for 3G and 4G TeraVM Metrics Guide Reference of Types of Statistics Gathered Page 28

32 Copyright Limited, a Cobham Test Solutions Company. All rights reserved, subject to change without notice. The material contained in this document is for general information purposes only and does not constitute technical or professional advice. All third party trademarks are acknowledged in this document. All copyrights in and to the software product are owned by or its licensors. The software is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. End User License Agreement The usage of the TeraVM product and documentation is subject to the Aeroflex Ireland Ltd standard Software Licence Agreement, which is available at TeraVM License Agreement. Please read the terms of the Software Licence Agreement carefully before using the documentation. Page i