Emulator Virtual Appliance Installation and Configuration Guide

Transcription

1 Emulator Virtual Appliance Installation and Configuration Guide Global Support Regional Telephone Hotline Support: Americas: EMEA: +44 (0) Copyright Itrinegy Limited Page 1

2 NOTICE itrinegy provides this publication "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability or fitness for any particular purpose. itrinegy will not be liable (i) to you for any incidental, consequential, or indirect damages (including damages for loss of business profits, business interruption, loss of business information, and the like) arising out of the use of or inability to use this product even if itrinegy or any authorised itrinegy representative has been advised of the possibility of such damages, or (ii) for any claim by any other party. Further, itrinegy reserves the right to make changes or improvements to the product described in this guide and to this publication without obligation of itrinegy to notify any person of such revision or changes. Trademarks itrinegy and itrinegy NE-ONE are trademarks of itrinegy Limited. All other trademarks or registered trademarks are the property of the respective manufacturers of the products associated with them. Copyright Copyright itrinegy Limited. All rights reserved. No part of this publication may be reproduced, translated or distributed without the prior written permission. Edition: V1.7 March 2016 Copyright Itrinegy Limited Page 2

3 Contents Introduction... 4 Installation... 4 Configuration and Setup... 8 Configure the network management port... 8 Obtain a licence key... 9 Install the licence key Configure the Network Test Environment Routed Configuration Virtual Switch Configuration Emulator Configuration Client and Server Configuration Running the Tests Non-routed Configuration Virtual Switch Configuration Emulator Configuration Client and Server Configuration Running the Tests Copyright Itrinegy Limited Page 3

4 Introduction This guide provides information of how to install and configure the Emulator Virtual Appliance. Some example scenarios are included although please note that detailed product information can be found in the product guides and videos. Installation The following instructions detail how to import the Emulator Virtual Appliance (VA) using VMware s vsphere client. We use the vsphere client throughout this guide although vcenter could equally be used to configure the environment. itrinegy have tested the Virtual Appliance on VMware s ESXi server products, workstation support will be added in a later release. 1. Download the Emulator Virtual Appliance from or copy the link in preparation for step Using vsphere client connect to the ESXi host where you would like to deploy the emulator. 3. Click File/Deploy OVF Template and select the OVA file or insert the URL. Copyright Itrinegy Limited Page 4

5 Click Next; you should see the following information. Click Next; provide a name for the virtual machine. The default is Emulator but it can be changed to a name of your choice. Copyright Itrinegy Limited Page 5

6 Click Next; select the datastore that you would like to use. We recommend that you use Thin Provisioning so that capacity is only used when data is written to disk. Click Next; the Emulator has three network interfaces defined that connect to the VM Network. If your network uses a different name then select the applicable network in your environment. Don t worry too much about this step as we will review the virtual network configuration later on. Copyright Itrinegy Limited Page 6

7 Click Next; the final screen provides a summary of your choices. Click Finish to build the Emulator Virtual Appliance. The following dialogue box will appear that provides an indication of how long it will take to deploy the Emulator VA. Copyright Itrinegy Limited Page 7

8 Configuration and Setup The Emulator Virtual Appliance is preconfigured with 2 CPUs, 8GB RAM, 12GB SCSI hard disk and 3 virtual network interface cards. This configuration is usually sufficient for most emulations and should only be changed under guidance from your support representative. There are three stages to complete before you can use the Emulator: 1. Configure the network management port 2. Obtain and install a licence key 3. Configure the network test environment Configure the network management port The network management or netmgt port is connected to your LAN so that you can access the Emulator using a web browser. We therefore need to connect the first virtual network interface to your LAN. 1. Login to the ESXi/ESX host using the vsphere Client and edit the Emulator VM settings. 2. Click on Network adapter 1 and check that the Connect at power on is ticked. Select an applicable network under Network Connection: Network label that is connected to a LAN that you can reach from your web browser. 3. Click on Network adapter 2 and 3 and check that the Connect at power on is unticked. Don t worry about these network adapters for now as we will configure them later on. Click on OK and then Power On the Emulator VM. Copyright Itrinegy Limited Page 8

9 4. Using the Emulator console, login as user itrinegy, password itrinegy. 5. Select option 2 Set Network Management Address and then select either Static or DHCP configuration. The default is set to DHCP so you may already have an IP address allocated. 6. Once set confirm that you can ping the Emulator from your workstation. Do not exit the Console as we will need it in the next step. Obtain a licence key 1. Select Option 5, List Host ID (for licensing). The following screen is displayed. Copyright Itrinegy Limited Page 9

10 2. Make a note of the Host Id, in this case the Host Id is A95B28. Send an to support@itrinegy.com that includes your name, contact telephone number and Host Id. You cannot continue to the next stage until itrinegy Support have sent you an confirming that the license key is ready for download. 3. Using a web browser connect to 4. Enter your Username and Password. If you haven t received your login credentials please contact support@itrinegy.com. 5. Hover-over the Menu item so that the drop-down menu appears. Check that the Key Code is identical to your Host Id. Select the Create Key option. Copyright Itrinegy Limited Page 10

11 6. The Support Portal will create the licence key file and your web browser will automatically download a file named license.txt. Install the licence key 1. Using a web browser login using https to the Emulator specifying the IP Address or hostname that you have configured. 2. Login using the below credentials: Username: admin Password: admin 3. From the menu click on the Settings/Licensing, then click on the Upload License File button and select the licence file that was created from the support site. 4. The Emulator will now request your confirmation click on OK the emulator reboots and is now ready for use. Copyright Itrinegy Limited Page 11

12 Configure the Network Test Environment Before you start using the Emulator it is necessary to configure the network in VMware. The following two examples show a routed and non-routed configuration. Routed Configuration In this example we need to recreate the following scenario where a client computer is accessing a server over a WAN. IP: WAN IP: Client IP: /8 GW: Server IP: /8 GW: The Emulator has two ESXi virtual network interfaces defined for emulation so we can now think of the above scenario like this: IP: IP: Client IP: /8 GW: Server IP: /8 GW: In our virtual test environment we need: 1 x ESXi Virtual Switch 1 x Virtual Emulator VM 1 x Client VM 1 x Server VM For best performance we will only use one virtual switch as it use less CPU and network overhead. The Virtual Emulator will route traffic between the client and server. Virtual Switch Configuration 1. Log into the ESXi server using the vsphere Client. 2. Click on your ESXi server and select the Configuration tab. Now click on the Networking link and click the Add Networking link at the top right of the page. Copyright Itrinegy Limited Page 12

13 3. Select Virtual Machine and click on Next. 4. Select a physical NIC that this virtual switch will use. On our esxserver we have four NICs and for this switch we will use vmnic1. Note that it isn t physically connected but that doesn t matter as no traffic will actually traverse the physical network in this example. Click Next. Copyright Itrinegy Limited Page 13

14 5. Enter a name for this network, for example Test Network, click Next and then click Finish. 6. Click on your new switch, in this example vswitch1, and select the Properties link. Copyright Itrinegy Limited Page 14

15 7. Click on Edit button. 8. Select the Security tab. In the Promiscuous Mode drop-down box select Accept and click on OK. 9. Now that the Virtual Switch is configured we need to connect the Emulator to it. Click on the Emulator VM, select Edit Settings and connect Network adapter 2 and 3 to the Test Network. Also tick the Connect at power on button. Copyright Itrinegy Limited Page 15

16 To test that the Emulator is working we need two endpoints. In our environment we will use the Win81_Client and Win81_Server virtual machines. Both have one virtual network interface which is connected to the Test Network. We can now see that the Test Network has three Virtual Machines connected to it. Emulator Configuration 1. Login to the Emulator GUI address>. The default username is admin, password admin. 2. Click on Load an Emulation, choose LAN_No_Impairment and click on OK. We will start with no impairment to test client to server connectivity and then increase the latency. Now click on the Configured green link. Copyright Itrinegy Limited Page 16

17 We can see that we have configured a perfect 1 gigabit link, i.e. there is zero latency and loss. Click on OK and scroll to the bottom of the page. Click on the slider to enable the Emulator s Port Properties. Enter the IP addresses and Netmask and then click on Activate. Copyright Itrinegy Limited Page 17

18 The Emulator now has the IP addresses assigned to its physical ports. IP: IP: Client IP: /8 GW: Server IP: /8 GW: To start the emulation click on Emulation Control and Start. We will ping the emulator from the client and server in the next section. Client and Server Configuration On our esxtest server we have two Windows 8.1 test machines, i.e. one client and one server. These are configured to route their traffic through the Emulator. Client Configuration Server Configuration The below output shows that we can ping the server from the client with < 1ms latency. Copyright Itrinegy Limited Page 18

19 Running the Tests Now that the virtual network, Emulator and test machines are configured we can impede the network traffic. First let s change the bandwidth and latency to something that s more representative of a WAN. 1. Login to the Emulator, click on Configuration and click on the link. Change the Bandwidth to 1Mbps (100000) and set the Min and Max Latency to 5 and click on OK. Note that latency is applied in both directions so we will expect to see an overall roundtrip time of 10ms. Click on the Emulation Control menu item and click on the Update button. We can now see that the ping, from the client to the server, has changed from 1ms to 10ms proving that the emulator is now impeding the traffic. Copyright Itrinegy Limited Page 19

20 Non-routed Configuration In this example we need to recreate the following scenario where a client computer is accessing a server over a LAN. LAN Client Server IP: /24 IP: /24 The Emulator has two ESXi virtual network interfaces defined for emulation so we can now think of the above scenario like this: Client IP: /24 Server IP: /24 In our virtual test environment we need: 2 x ESXi Virtual Switch 1 x Virtual Emulator VM 1 x Client VM 1 x Server VM Although using two ESXi virtual switches does not provide the best performance compared to using only one virtual switch, as shown in the routed configuration, it is necessary otherwise traffic would not pass through the Emulator. Virtual Switch Configuration 1. Log into the ESXi server using the vsphere Client. 2. Click on your ESXi server and select the Configuration tab. Now click on the Networking tab and click the Add Networking link. Copyright Itrinegy Limited Page 20

21 3. Select Virtual Machine and click on Next. 4. In this scenario we won t bind the virtual switch to a physical network adapter so ensure that none are ticked. Copyright Itrinegy Limited Page 21

22 5. Enter a name for this network, for example Net 0 as we ll use this to connect to port 0 on the Emulator, click Next and then click Finish. 6. Click on your new switch, in this example vswitch1, and select the Properties link. 7. Click on Edit button. Copyright Itrinegy Limited Page 22

23 8. Select the Security tab. In the Promiscuous Mode drop-down box select Accept and click on OK. Repeat steps 2 through to 8 to add a second virtual switch but this time name it Net 1 as we will connect it to port 1 on the Emulator. 9. Now that the Virtual Switches are configured we need to connect the Emulator s port 0 to net 0 and port 1 to net 1. Click on the Emulator VM, select Edit Settings and connect Network adapter 2 to Net 0 and Network adapter 3 to Net 1. Also tick the Connect at power on button for both adapters. Copyright Itrinegy Limited Page 23

24 In our test environment we will use Win81_Client and Win81_Server virtual machines. Both have one network interface with the Client connected to Net 0 and Server connected to Net 1. We can now see that we have two virtual switches configured and that the Emulator is connected to both basically acting as a bridge between the two switches. Therefore any traffic passing between vswitch1 and vswitch2 must go via the switch allowing the Emulator to impede the traffic. Copyright Itrinegy Limited Page 24

25 Emulator Configuration 1. Login to the Emulator GUI address>. The default username is admin, password admin. 2. Click on Load an Emulation, choose LAN_No_Impairment and click on OK. We will start with no impairment to test client to server connectivity and then increase the latency. Now click on the Configured green link. 3. We can see that we have configured a perfect 1 gigabit link, i.e. there is zero latency and loss. Click on OK as no further changes are needed. To start the emulation click on Emulation Control and Start. We will ping the emulator from the client and server in the next section. Copyright Itrinegy Limited Page 25

26 Client and Server Configuration On our esxtest server we have two Windows 8.1 test machines, i.e. one client and one server. Client Configuration Server Configuration The below output shows that we can ping the server from the client with < 1ms latency. To prove that the client to server traffic is going through the Emulator stop the running emulation by clicking on the Emulation Control, Stop Emulations button. We can see that the ping requests from the client to server have started to fail. Copyright Itrinegy Limited Page 26

27 Copyright Itrinegy Limited Page 27

28 Running the Tests Now that the virtual network, Emulator and test machines are configured we can impede the network traffic. First let s change the bandwidth and latency to something that s more representative of a WAN. 1. Login to the Emulator, click on Configuration and click on the link. Change the Bandwidth to 1Mbps (100000) and set the Min and Max Latency to 8 and click on OK. Note that latency is applied in both directions so we will expect to see an overall roundtrip time of 16ms. Click on the Emulation Control menu item and click on the Update button. We can now see that the ping, from the client to the server, is 16ms proving that the Emulator is impeding the traffic. Copyright Itrinegy Limited Page 28