KEMP Xen User Manual

VLM for Xen (Para Virtualized)

Installation Guide

Virtual LoadMaster

for Xen (Para

Virtualized)

Installation Guide

VERSION: 1.12

UPDATED: JULY 2014

VLM for Xen (Para Virtualized)

Installation Guide

KEMP Technologies, Inc. reserves all ownership rights for the LoadMaster product line including software and 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 without limitation 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 provided that 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.

VLM for Xen (Para Virtualized)

Installation Guide

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.

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.

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.

Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby 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 Nos. 6,473,802, 6,374,300, 8,392,563, 8,103,770, 7,831,712, 7,606,912, 7,346,695, 7,287,084 and 6,970,933

VLM for Xen (Para Virtualized)

Installation Guide

Table of Contents

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

2 Installing Virtual LoadMaster (VLM) on a Xen Environment .......................................................... 6

2.1 Download the Xen, Para-Virtualized, Files .............................................................................. 6

2.2 Configure the Configuration File ............................................................................................. 6

2.2.1 Edit the Sample Configuration File ................................................................................. 6

2.3 Power On the LoadMaster ...................................................................................................... 8

2.4 Licensing and Configuration .................................................................................................... 8

3 Troubleshooting and Notes .......................................................................................................... 13

3.1 Cannot access the Web User Interface ................................................................................. 13

3.2 Common Xen Commands ..................................................................................................... 14

3.3 Factory Reset ........................................................................................................................ 14

3.4 Items of Note ........................................................................................................................ 15

Appendix A: Sample Configuration File ................................................................................................ 16

4 References .................................................................................................................................... 17

Document History ................................................................................................................................. 18

VLM for Xen (Para Virtualized)

Installation Guide

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 Xen, paravirtualized environment.

The VLM has been tested with Xen.org versions 3.1, 4.0 and 4.1.

There are several different versions of the VLM available. Full details of the currently supported versions are available on our website: www.kemptechnologies.com.

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

 1 GB RAM  32 GB virtual hard disk capacity

Para-virtualization requires some modification of the guest OS or application. The guest OS or applications are aware that they are in a virtual environment which allows for a near-native performance.

There may be maximum configuration limits imposed by Xen such as maximum RAM per VM, Virtual NICs per VM etc. For further details regarding the configuration limits imposed by Xen, please refer to the relevant Xen documentation.

A wide variety of Linux distributions can be used as the Dom0 operating system. For a full list of the compatible Linux distributions, please refer to www.xen.org.

KEMP LoadMaster has been tested with OpenSUSE 12.1 as the Dom0 operating systems and the

3.1 Xen.org version.

If you have any issues with the Virtual LoadMaster when using a different combination of Xen.org versions and Linux distributions as the Dom0, then please contact KEMP Support.

VLM for Xen (Para Virtualized)

Installation Guide

2 Installing Virtual LoadMaster (VLM) on a Xen

Environment

The following instructions describe how to install a Virtual LoadMaster on a Xen environment.

2.1 Download the Xen, Para-Virtualized, Files

The VLM is packaged within a .tar.gz 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 to http://www.KEMPtechnologies.com/try

2. Within the Select the hypervisor platform section, select the option for Download Xen,

Para-Virtualized

3. Read the end user agreement.

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

5. Click on the Agree button.

6. Download the Xen .tar.gz file.

7. Unzip the contents of the file to an accessible location within the Xen environment. The

.tar.gz file contains the following files, where x.x-xx denotes the release number:

 LoadMaster-VLM-x.x-xx-XEN.disk: the disk image  LoadMaster-VLM-x.x-xx-XEN.config.sample: a sample configuration file  LoadMaster-VLM-x.x-xx-XEN.initrd  LoadMaster-VLM-x.x-xx-XEN.linux

2.2 Configure the Configuration File

To install a Virtual LoadMaster as a guest virtual machine within a Xen, para-virtualized environment, the first step is to create a configuration file detailing the correct parameters for your installation. The values for these parameters may differ depending on the Linux distribution in use as the Dom0 and on your networking requirements.

KEMP provides a sample configuration file within the Xen .tar.gz file, LoadMaster-VLM-x.x-xx- XEN.config.sample which you can edit to create your own configuration file.

2.2.1 Edit the Sample Configuration File

Within the Xen .tar.gz file, KEMP have provided a sample configuration file, LoadMaster-VLM x.x-xx-XEN.config.sample. This file can be used to configure the required parameters for the

Virtual LoadMaster.

Kernel path

Configure the path to hvmloader. This path may differ depending on the Linux distribution being used as Dom0.

+ 12 hidden pages

KEMP Xen User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual