Emulator Virtual Appliance
Emulator Virtual Appliance Installation and Configuration Guide
Global Support Email:
[email protected] Regional Telephone Hotline Support: Americas: 1-888-448-4366 EMEA: +44 (0)1799 252 200
Copyright © 2011-2015 Itrinegy Limited
Page 1
Emulator Virtual Appliance
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 © 2011-2015 iTrinegy Limited. All rights reserved. No part of this publication may be reproduced, translated or distributed without the prior written permission.
Edition: V1.5.2 June 2015
Copyright © 2011-2015 Itrinegy Limited
Page 2
Emulator Virtual Appliance
Contents Introduction ............................................................................................................................................ 4 Installation .............................................................................................................................................. 4 Configuration and Setup ......................................................................................................................... 8 Configure the network management port.......................................................................................... 8 Obtain a licence key ............................................................................................................................ 9 Install the licence key ........................................................................................................................ 11 Configure the Network Test Environment ............................................................................................ 12 Routed Configuration........................................................................................................................ 12 Virtual Switch Configuration ......................................................................................................... 12 Emulator Configuration................................................................................................................. 16 Client and Server Configuration .................................................................................................... 18 Running the Tests.......................................................................................................................... 19 Non-routed Configuration ................................................................................................................ 20 Virtual Switch Configuration ......................................................................................................... 20 Emulator Configuration................................................................................................................. 25 Client and Server Configuration .................................................................................................... 26 Running the Tests.......................................................................................................................... 28
Copyright © 2011-2015 Itrinegy Limited
Page 3
Emulator Virtual Appliance
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 http://support.iTrinegy.com/VirtualAppliances/emulator.ova or copy the link in preparation for step 3. 2. 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 © 2011-2015 Itrinegy Limited
Page 4
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 5
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 6
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 7
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 8
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 9
Emulator Virtual Appliance
2. Make a note of the Host Id, in this case the Host Id is 005056-A95B28. Send an email to
[email protected] that includes your name, contact telephone number and Host Id. You cannot continue to the next stage until iTrinegy Support have sent you an email confirming that the license key is ready for download. 3. Using a web browser connect to http://support.iTrinegy.com 4. Enter your Username and Password. If you haven’t received your login credentials please contact
[email protected]. 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 © 2011-2015 Itrinegy Limited
Page 10
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 11
Emulator Virtual Appliance
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: 11.0.0.1 WAN
IP: 12.0.0.1
Client IP: 11.0.0.2/8 GW: 11.0.0.1
Server IP: 12.0.0.2/8 GW: 12.0.0.1
The Emulator has two ESXi virtual network interfaces defined for emulation so we can now think of the above scenario like this: IP: 11.0.0.1
Client IP: 11.0.0.2/8 GW: 11.0.0.1
IP: 12.0.0.1
Server IP: 12.0.0.2/8 GW: 12.0.0.1
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 © 2011-2015 Itrinegy Limited
Page 12
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 13
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 14
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 15
Emulator Virtual Appliance
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 – https://. 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 © 2011-2015 Itrinegy Limited
Page 16
Emulator Virtual Appliance
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 Ok.
The Emulator now has the IP addresses assigned to its physical ports.
Copyright © 2011-2015 Itrinegy Limited
Page 17
Emulator Virtual Appliance
IP: 11.0.0.1
Client IP: 11.0.0.2/8 GW: 11.0.0.1
IP: 12.0.0.1
Server IP: 12.0.0.2/8 GW: 12.0.0.1
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 © 2011-2015 Itrinegy Limited
Page 18
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 19
Emulator Virtual Appliance
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 IP: 192.168.0.100/24
Server IP: 192.168.0.5/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: 192.168.0.100/24
Server IP: 192.168.0.5/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 © 2011-2015 Itrinegy Limited
Page 20
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 21
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 22
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 23
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 24
Emulator Virtual Appliance
Emulator Configuration 1. Login to the Emulator GUI – https://. 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 © 2011-2015 Itrinegy Limited
Page 25
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 26
Emulator Virtual Appliance
Copyright © 2011-2015 Itrinegy Limited
Page 27
Emulator Virtual Appliance
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 © 2011-2015 Itrinegy Limited
Page 28
