installation guide vmware workstation and player v.1.10

8/12/2019 Installation Guide VMWare Workstation and Player v.1.10

1/19

Copyright 2002 - 2014 KEMP Technologies, Inc. All Rights Reserved. Page 1 / 19

VLM for VMware Workstation and Playernstallation Guide

Virtual LoadMaster

for VMware

Workstation and

Player

Installation Guide

VERSION: 1.10

UPDATED: JANUARY 2014


2/19



Copyright Notices

Copyright 2002-2014 KEMP Technologies, Inc.. All rights reserved.. KEMP Technologies and the KEMP

Technologies logo are registered trademarks of KEMP Technologies, Inc..

KEMP Technologies, Inc. reserves all ownership rights for the LoadMaster product line including softwareand documentation. The use of the LoadMaster Exchange appliance is subject to the license agreement.

Information in this guide may be modified at any time without prior notice.

Microsoft Windows is a registered trademarks of Microsoft Corporation in the United States and other

countries. All other trademarks and service marks are the property of their respective owners.

Limitations: This document and all of its contents are provided as-is. KEMP Technologies has made efforts

to ensure that the information presented herein are correct, but makes no warranty, express or implied,

about the accuracy of this information. If any material errors or inaccuracies should occur in this document,

KEMP Technologies will, if feasible, furnish appropriate correctional notices which Users will accept as the

sole and exclusive remedy at law or in equity. Users of the information in this document acknowledge that

KEMP Technologies cannot be held liable for any loss, injury or damage of any kind, present or prospective,

including without limitation any direct, special, incidental or consequential damages (including withoutlimitation lost profits and loss of damage to goodwill) whether suffered by recipient or third party or from

any action or inaction whether or not negligent, in the compiling or in delivering or communicating or

publishing this document.

Any Internet Protocol (IP) addresses, phone numbers or other data that may resemble actual contact

information used in this document are not intended to be actual addresses, phone numbers or contact

information. Any examples, command display output, network topology diagrams, and other figures

included in this document are shown for illustrative purposes only. Any use of actual addressing or contact

information in illustrative content is unintentional and coincidental.

Portions of this software are; copyright (c) 2004-2006 Frank Denis. All rights reserved; copyright (c) 2002

Michael Shalayeff. All rights reserved; copyright (c) 2003 Ryan McBride. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted providedthat the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the

following disclaimer

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the

following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE ABOVE COPYRIGHT HOLDERS ''AS IS'' AND ANY EXPRESS OR IMPLIED

WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND

FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE ABOVE COPYRIGHT

HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR

CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR

SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY

THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR

OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE

POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation are those of the authors and

should not be interpreted as representing official policies, either expressed or implied, of the above

copyright holders..

Portions of the LoadMaster software are copyright (C) 1989, 1991 Free Software Foundation, Inc. -51

Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA- and KEMP Technologies Inc. is in full compliance

of the GNU license requirements, Version 2, June 1991. Everyone is permitted to copy and distribute

verbatim copies of this license document, but changing it is not allowed.

Portions of this software are Copyright (C) 1988, Regents of the University of California. All rights reserved.


3/19



Redistribution and use in source and binary forms are permitted provided that the above copyright notice

and this paragraph are duplicated in all such forms and that any documentation, advertising materials, and

other materials related to such distribution and use acknowledge that the software was developed by the

University of California, Berkeley. The name of the University may not be used to endorse or promote

products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,

WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

PURPOSE.

Portions of this software are Copyright (C) 1998, Massachusetts Institute of Technology

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated

documentation files (the "Software"), to deal in the Software without restriction, including without

limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the

Software, and to permit persons to whom the Software is furnished to do so, subject to the following

conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions

of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING

BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY

CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,

ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

SOFTWARE.

Portions of this software are Copyright (C) 1995-2004, Jean-loup Gailly and Mark Adler

This software is provided 'as-is', without any express or implied warranty. In no event will the authors be

held liable for any damages arising from the use of this software.

Permission is granted to anyone to use this software for any purpose, including commercial applications,

and to alter it and redistribute it freely, subject to the following restrictions:

1. The origin of this software must not be misrepresented; you must not claim that you wrote the original

software. If you use this software in a product, an acknowledgment in the product documentation would

be appreciated but is not required.

2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the

original software.

3. This notice may not be removed or altered from any source distribution.

Portions of this software are Copyright (C) 2003, Internet Systems Consortium

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee ishereby granted, provided that the above copyright notice and this permission notice appear in all copies.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING

ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,

INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,

WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE

USE OR PERFORMANCE OF THIS SOFTWARE.

Used, under license, U.S. Patent No. 6,473,802 and 6,374,300


4/19



Table of Contents

1 Introduction .................................................................................................................................... 5

2 Installing Virtual LoadMaster (VLM) on VMware Workstation ...................................................... 62.1 Download the .vmx File .......................................................................................................... 6

2.2 Deploy the vmx File ................................................................................................................. 6

2.3 Check the Network Adapter Settings ...................................................................................... 7

2.4 Power On the LoadMaster ...................................................................................................... 8

2.5 Licensing and Configuration .................................................................................................... 8

3 Installing Virtual LoadMaster (VLM) on VMware Player .............................................................. 13

3.1 Download the .vmx File ........................................................................................................ 13

3.2 Deploy the vmx File ............................................................................................................... 13

4 Troubleshooting ............................................................................................................................ 16

4.1 Cannot access the Web User Interface ................................................................................. 16

4.2 Static MAC Addresses Must Be Configured .......................................................................... 17

4.3 Factory Reset ........................................................................................................................ 17

5 References .................................................................................................................................... 18

Document History ................................................................................................................................. 19


5/19



1 Introduction

The KEMP Virtual LoadMaster is a version of the KEMP LoadMaster that runs as a virtual

machine within a hypervisor and can provide all the features and functions of a hardware-based

LoadMaster.

This document describes the installation of the Virtual LoadMaster (VLM) within a VMware

Workstation and VMware Player hosted hypervisor environment.

Note: As of June 30th, 2011 the VLM is no longer supported by KEMP on VMware Server, since

VMware Server is no longer supported by VMware.

The VLM has been tested with VMware Workstation 4.0 and above and VMware Player 8.0 and

above.

There are several different versions of the VLM available. Full details of the currently supported

versions are available on our website:http://www.kemptechnologies.com.

The VMware virtual machine guest environment for the VLM, at minimum, must include:

2 x virtual CPUs (reserve 2 GHz)

1 GB RAM

32GB disk space

There may be maximum configuration limits imposed by VMware such as maximum RAM per

VM, Virtual NICs per VM etc. For further details regarding the configuration limits imposed byVMware, please refer to the relevant VMware documentation.
http://www.kemptechnologies.com/http://www.kemptechnologies.com/http://www.kemptechnologies.com/http://www.kemptechnologies.com/


6/19



2 Installing Virtual LoadMaster (VLM) on VMware

Workstation

The following instructions describe how to install a Virtual LoadMaster (VLM) on VMwareWorkstation.

2.1 Download the .vmx File

The VLM is packaged with a .vmx file for ease of deployment. This file can be freely downloaded

from KEMP Technologies for a 30 day evaluation period. To download the VLM please follow the

instructions below:

1. Log on tohttp://www.KEMPtechnologies.com/try

2. Within the Select the hypervisor platformsection, select the option for VMware

Workstation, Server and Player.

3. Click on the Download VMDKbutton.

4.

Read the end user agreement.

5. If you wish to continue, select your country from the drop-down list.

6. Click on the Agreebutton.

7.

Save the vmx zip file.

8. Unzip the contents of the zip file to an accessible location.

2.2 Deploy the vmx File1.

Open the VMware Workstation application.

Note: VMware Workstation version 8.0.2 was used as an example for the purposes of this

document. Earlier or later versions may have different user interfaces.

2.

Click on the File > Openmenu option or, alternatively, click on the Open a Virtual

Machineoption within the Hometab.

3.

Browse to where you downloaded the vmx files and select the LoadMaster .vmx file.

4. Click on the Open button.

5.

Ensure that the correct VLM environment opens within the VMware Workstation

application as perFigure 2-1.

6.

We recommend that you do not edit the default configuration settings.

7.

These settings should be as follows:

Memory:1 GB

Processors:2

Hard Disk (SCSI) :32GB

CD/DVD (IDE):Auto detect

Floppy:Using drive A:
http://www.kemptechnologies.com/tryhttp://www.kemptechnologies.com/tryhttp://www.kemptechnologies.com/tryhttp://www.kemptechnologies.com/try


7/19



Network Adapter: Bridged

Network Adapter 2:Bridged

Display:Auto Detect

Figure 2-1: VLM Screen

2.3 Check the Network Adapter Settings

Before starting the VLM we must first verify that the network adapters are configured correctly

and note the MAC address(es).

1.

Click on the Edit virtual machinesettings option within the LoadMaster VLMtab.

2.

Select the Network Adapter device.

3. Ensure that the Connect at power on checkbox is selected and that the Bridgednetwork

connection option is selected.

4. Click on the Advancedbutton.

5.

In the Network Adapter Advanced Settingsdialog box, please note the value in the MAC

Address input field.

It is advisable to keep the value of the MAC Address because the license is tied to the MAC

address. If, for some reason, the MAC address changed, it is useful to be able to manually return

to the original MAC address.


8/19


9/19



Figure 2-3: License Required

4. If using the Online licensing method, fill out the fields and click License Now.

If you are starting with a trial license, there is no need to enter an Order ID.If you are starting with a permanent license, enter the KEMP Order ID# if

this was provided to you..

If using the Offline Licensing method, select Offline Licensing, obtain the license text,

paste it into the License field and click Apply License.

For detailed instructions on how to register for a KEMP ID and license theLoadMaster, refer to theLicensing, Feature Description.

Figure 2-4: Authentication Required

5.

After the LoadMaster is licensed, a prompt will appear asking to log in. Enter the user

name and password and click OK.

Please use the following login credentials:

lb100 login: bal

Password: 1fourall

6. The Change Passwordscreen appears


10/19



7. Enter a new password for the baluser in the Password input field and retype it in the

Retype Passwordinput field.

8.

The login screen appears again, enter the baluser name and the new password as

defined in Step 14

9. In the screen informing you that the password has changed, press the Continuebutton

10. If your machine has shipped with a temporary license you should get a warning

informing you that a temporary license has been installed on your machine and for how

long the license is valid.

Click OK.

11.You should now connect to the Appliance Vitalsscreen of the LoadMaster.

Figure 2-5: Home Page

12.

Click the System Configurationmenu option.

13.Click on the eth0menu option within the Interfaces section.


11/19



14. In the Network Interface 0screen, enter the IP address of the eth0 interface, the

network facing interface of the LoadMaster, in the Interface Addressinput field.

15.Click on the Set Address button

16.

Click on the eth1menu option within the Interfaces section17.

In the Network Interface 1screen, enter the IP address of the eth1 interface, the farm-

side interface of the LoadMaster, in the Interface Addressinput field.

18.Click on the Set Address button

19.

This interface is optional, depending on the network configuration.

20.Click on the Local DNS Configuration > Hostname Configurationmenu option.

21. In the Hostname configuration screen, enter the hostname into the Current Hostname

input field.22.Click on the Set Hostname button.

23.Click on the Local DNS Configuration > DNS Configurationmenu option.

24. In the DNS configuration screen, enter the IP address(es) of the DNS Server(s) which will

be used to resolve names locally on the LoadMaster into the DNS NameServerinput

field.

25.Click on the Add button.

26.

Enter the domain name that is to be prepended to requests to the DNS nameserver into

the DNS NameServerinput field.

27.Click on the Add button.

28.

Click on the Route Management > Default Gatewaymenu option.

29.

In the DNS configuration screen, enter the IP address of the default gateway into the

IPv4 Default Gateway Addressinput field.

30. If you have an IPv6 Default Gateway, please enter the value in the IPv6 Default Gateway

Addressinput field.

31.

Click on the Set IPv4 Default Gatewaybutton.


12/19



The LoadMaster is now fully installed and ready to be used. For further information on how to

configure and implement the Virtual LoadMaster, please refer to the LoadMaster

documentation which can be downloaded from the

http://www.KEMPtechnologies.com/documentationpage.
http://www.kemptechnologies.com/documentationhttp://www.kemptechnologies.com/documentationhttp://www.kemptechnologies.com/documentation


13/19



3 Installing Virtual LoadMaster (VLM) on VMware Player

The following instructions describe how to install a Virtual LoadMaster on VMware Player.

3.1

Download the .vmx File

The VLM is packaged within a .vmx file for ease of deployment. This file can be freely

downloaded from KEMP Technologies for a 30 day evaluation period. To download the VLM

please follow the following instructions.

Download the .vmx file as per the instructions in Section2.1 Download the .vmx File.

3.2 Deploy the vmx File1.

Open the VMware Player application.

Note: version VMware Player 4.0.2 was used as an example for the purposes of this

document. Earlier or later versions may have different user interfaces.

2. Click on the Open a Virtual Machineoption within the Hometab.

3.

Browse to where you downloaded the vmx files and select the LoadMaster .vmx file.

4. Click on the Open button.

5. Ensure that the LoadMaster VLM tab appears.


14/19



Figure 3-1: The LoadMaster VLM tab

6. Click on the Edit virtual machine settings option on the LoadMaster VLM tab.

7.

We recommend that you do not edit the default configuration settings.

8. Ensure that the correct configuration settings appear as follows:

Memory:1 GB

Processors:2

Hard Disk (SCSI) :32GB

CD/DVD (IDE):Auto detect

Floppy:Using drive A:

Network Adapter: Bridged

Network Adapter 2:Bridged

Display:Auto Detect

9.

Click the Cancelbutton


15/19



Continue with the installation process.

The VLM is now fully installed and ready to be used. For further information on how to configure

and implement the Virtual LoadMaster, please refer to the LoadMaster documentation which

can be downloaded from thehttp://www.KEMPtechnologies.com/documentationpage.
http://www.kemptechnologies.com/documentationhttp://www.kemptechnologies.com/documentationhttp://www.kemptechnologies.com/documentationhttp://www.kemptechnologies.com/documentation


16/19



4 Troubleshooting

4.1

Cannot access the Web User Interface

If a connection to the WUI cannot be established, network settings can be configured via the

console view.

1.

Login into the VLM via the console using the settings:

lb100 login: bal

Password: 1fourall

Figure 4-1: Enter IP address

2. Enter the IP addressof the eth0 interface, the network-facing interface of the LoadMaster,

in the input field within the Network Side Interface Address field and press Enter on the

keyboard.

Figure 4-2: Enter default gateway address

3.

Enter the IP address of the Default Gateway.


17/19



Figure 4-3: Nameserver IP addresses

4.

Enter a space-separated list of nameserver IP addresses.

5. A message will appear asking to continue licensing via the WUI. Try to access the IP address

via a web browser. Ensure to enter https://before the IP address.

6. Contact the local KEMP Customer Services Representative for further support if needed.

4.2 Static MAC Addresses Must Be Configured

In case you move a VLM system to a different Virtual Machine, ensure that the MAC addresses

of the Virtual Machines NICs stay the same. It is recommended to configure static MAC

addresses for all NICs within Virtual Machines.

For further information on configuring static MAC addresses, please refer to the relevant

VMware documentation.

4.3 Factory Reset

If you perform a factory reset on your VLM, all configuration data, including the VLMs IP address

is deleted. During the subsequent reboot the VLM attempts to obtain an IP address via DHCP. If

the VLM is on a different subnet to the DHCP server then an IP address will not be obtained and

the IP address is set to the default 192.168.1.101.

The VLM may not be accessible using this address. If this is the case then you must run through

the quick setup via the console as described in Section4.1.


18/19



5 References

Unless otherwise specified, the below documents can be found at

http://www.kemptechnologies.com/documentation

Licensing, Feature Description
http://www.kemptechnologies.com/documentationhttp://www.kemptechnologies.com/documentationhttp://www.kemptechnologies.com/documentation


19/19

installation guide vmware workstation and player v.1.10

Documents