LoadMaster in Azure Government
This document provides step-by-step instructions on how to deploy a Virtual LoadMaster using the Azure Resource Manager (ARM) portal. This document is intended to provide an overview of LoadMaster in Azure Government and to introduce some basic aspects of LoadMaster functionality.
1.1 Load Balancing in Microsoft Azure
Before we create a LoadMaster Virtual Machine (VM) with Azure Government, it is important to understand the traffic flow so that VMs in Microsoft Azure can be configured appropriately.
Microsoft Azure Infrastructure as a Service (IaaS) deployments accept traffic only on published endpoints. Any request to access Microsoft Azure workloads passes through the default load balancing layer of the Microsoft Azure platform. The figure below depicts the default deployment without the use of a LoadMaster in Azure.
Any workload being published consists of an availability set, which represents a single VM or multiple VMs. When a VM is created, if an availability set exists, you have an option to connect the VM to an existing availability set. As more VMs are connected to an existing VM (and thus to an existing availability set), the built-in Microsoft Azure load balancer distributes connections when creating a load-balanced endpoint.
If you wish to use LoadMaster in Azure Government for your deployment, the following steps must be completed:
1. The LoadMaster in Azure Government needs to be deployed first.
2. All the VMs that need to be load balanced using the LoadMaster can then be created and must be connected to the existing LoadMaster VM to create the required grouping.
3. Finally, when creating endpoints, we cannot use the Load-Balance traffic on an existing endpoint option in Azure as we do not want to use the Microsoft Azure Load Balancer to load balance incoming connections.
The figure below depicts the flow when LoadMaster for Azure is deployed:
Notice that VM1, VM2 and VM3 in this example are grouped into a single availability set and the endpoint for published Virtual Services is created only on the LoadMaster VM. By doing this, we receive all load balanced traffic on the LoadMaster VM and the logic of load balancing incoming connections are applied as per the configured Virtual Service on the LoadMaster for a given workload.
Also, notice that VM1, VM2 and VM3 will not have any endpoints as they are not going to be published directly to the internet.
There may be exceptions to this rule for connections that require direct connectivity to the VM such as Remote Desktop Connections to Windows Server OS.
For details on all of the supported configurations regarding multiple Public IP addresses along with multiple interfaces, refer to the following Knowledge Base article: Supported Network Configurations for LoadMaster in Azure.
1.2 Known Issues/Limitations
There are some known issues/limitations to be aware of:
- Transparency is not possible in HA setups in Azure environments. For more information and requirements, refer to the Transparency Feature Description document on the Documentation page.
- Do not downgrade from firmware version 7.2.36 or higher to a version below 7.2.36. If you do this, the LoadMaster becomes inaccessible and you cannot recover it.
- The Virtual Service IP address must be the same IP address as the network interface.
- Alternate default gateway support is not permitted in a cloud environment.
- When setting up the LoadMaster in Azure, ensure that the Enable OS guest diagnostics check box is disabled because there is no support available for collection of diagnostics from the LoadMaster in Azure. If this option is enabled, the LoadMaster will not boot correctly.
The table below summarizes some of the limitations in Azure:
|Single unit, one-armed||Single unit, two-armed||HA pair one-armed||HA pair two-armed|
|Access Control List (ACL)||Requires that Server NAT is disabled if below firmware 7.2.50||Requires that Server NAT is disabled if below firmware 7.2.50||Requires that Server NAT is disabled if below firmware 7.2.50||Requires that Server NAT is disabled if below firmware 7.2.50|
|Transparency||Does not work||Works||Does not work||Does not work|
|10Gb NICs||7.2.48 and above||7.2.48 and above||7.2.48 and above||7.2.48 and above|
|Additional addresses||Works||Works||Does not work||Does not work|
|Virtual Service not on eth0||Not applicable||Works||Not applicable||Does not work|
2 Installation Prerequisites
To support LoadMaster in Azure Government, the following are required:
- An active subscription of Microsoft Azure Virtual Machines
- A client computer running Windows 7 or newer
- Internet Explorer 9 or newer, or any modern browser
- A minimum of 2GB RAM on the cloud environment
If you want to enable 10 Gb throughput for a LoadMaster virtual machine (VM) in Azure, you must select an Azure VM instance type that supports the 10 Gb Mellanox driver. Refer to the Sizes for Linux virtual machines in Azure page for further details.
It is not possible to bond interfaces on Azure LoadMasters.
3 Creating a LoadMaster in Azure Government VM
Please ensure that the prerequisites documented in the earlier section are met.
3.1 Licensing Options
There are four main licensing options when deploying a LoadMaster in Azure Government:
- Hourly consumption
- Bring Your Own License (BYOL)
- Free version
- License Agreement - Service Provided License Agreement (SPLA)/Metered
To use the BYOL option, follow the steps below:
1. Deploy the BYOL – Trial and perpetual license version of the Virtual LoadMaster (follow the steps in the section below to do this).
2. Contact a Progress Kemp representative to get a license.
3. Update the license on your LoadMaster to apply the license change (System Configuration > System Administration > Update License).
4. We recommend rebooting after updating the license.
3.2 Creating a LoadMaster in Azure Government VM
This section provides step-by-step instructions on how to deploy a Virtual LoadMaster.
The steps in this document reflect the steps in the Azure Marketplace (https://portal.azure.us).
To deploy a new LoadMaster using ARM, follow the steps below:
1. From the Azure Management Portal dashboard, click Create a resource.
2. Enter Kemp in the search bar and press Enter on your keyboard.
3. Select LoadMaster Load Balancer ADC Content Switch.
4. From the drop-down menu, select the desired LoadMaster type and click Create.
5. Under Project details, complete the following fields:.
a) Select the Azure Subscription.
b) Select an existing or create a new Resource group to deploy the LoadMaster into.
6. Under Instance details, complete the following fields:
a) Enter a Virtual machine name for the LoadMaster.
b) Select an Azure Region.
c) Optionally select Availability options if you are deploying a High Availability (HA) pair.
The LoadMaster is compatible with Availability sets and Availability zones and it is preferred to use managed disks for production environments. Some settings are not available in all regions. Check with Microsoft if needed.
d) Confirm that the desired LoadMaster type is selected in the Image drop-down list.
e) Enable or disable Azure Spot instance.
f) Select the desired Size for the virtual machine.
|LoadMaster||Recommended vCPU||Recommended RAM|
|VLM-500||2 vCPU||4 GiB|
|VLM-3000||4 vCPU||8 GiB|
|VLM-MAX||User defined *||User defined *|
* VLM-MAX vCPU and RAM allocation can be assigned based on your requirements due to the uncapped performance available.
If you want to enable 10 Gb throughput for a LoadMaster virtual machine (VM) in Azure, you must select an Azure VM instance type that supports the 10 Gb Mellanox driver. For more information, refer to the Enable a 10 Gb Interface (Optional) section.
7. Under Administrator account, complete the following fields:
a) Select the Authentication type (SSH public key or Password).
We recommend using a password, but either way will work fine.
b) Enter a Username.
This username is not used by the LoadMaster for Azure. The default username to access the LoadMaster is bal.
c) Enter a Password for the bal account and confirm the password.
This password is used to access the LoadMaster Web User Interface (WUI).
d) SSH public key source: You can either create a new key pair, use an existing key stored in Azure, or use an existing public key.
It is recommended to store SSH keys in a secure location.
8. Click Next: Disks.
9. Leave the defaults for Disk options and Data disks.
10. Click Next: Networking.
11. Under Network interface, complete the following fields:
a) Select an existing or create a new Virtual network.
b) Select an existing or create a new Subnet.
c) Select an existing or create a new Public IP.
d) Keep the default setting for NIC network security group.
The security group should contain rules for port 8443 (management), 22 (SSH), and any other ports that are needed by the back-end. Do not block port 6973.
If you want to enable 10 Gb throughput for a LoadMaster VM in Azure, you must select an Azure VM instance type that supports the 10 Gb Mellanox driver. This can be enabled after the LoadMaster has been deployed, for more information, refer to the Enable a 10 Gb Interface (Optional) section.
e) If you are deploying a HA pair of LoadMasters, you can select an existing load balancer.
12. Click Next: Management.
13. You can optionally make any necessary changes to the Monitoring, Identity, and Auto-Shutdown sections or leave them as default.
Ensure that the Enable OS guest diagnostics check box is disabled because there is no support available for collection of diagnostics from the LoadMaster in Azure. If this option is enabled, the LoadMaster will not boot correctly.
14. Click Next: Advanced.
Custom data is not supported by the LoadMaster.
15. You can optionally make any necessary updates to the Tags section or leave the defaults.
16. Click Next: Review + create.
17. You can optionally click Download a template for automation to download an ARM template.
18. Click Create.
If you chose to create a new SSH key pair, you are now prompted to store the private key for the public key you created. Azure does not store the private key. After the SSH key is created, you will not be able to download the private key.
The creation of a VM may take a few minutes or more depending on the Azure portal’s responsiveness and other factors. Ensure that the VM is created without any errors. Resolve any errors if needed.
When creating connected VMs, ensure to select the same Virtual network as the LoadMaster.
3.2.1 Enable a 10 Gb Interface (Optional)
Follow one of the two procedures below depending on whether you are adding a single network interface or multiple network interfaces to the LoadMaster.
To enable 10 Gb throughput for a LoadMaster virtual machine (VM) in Azure, you must select an Azure VM instance type that supports the 10 Gb Mellanox driver. Accelerated Networking is supported on most general purpose and compute-optimized instance sizes with two or more vCPUs. These supported series are: D/DSv2 and F/Fs. On instances that support hyperthreading, Accelerated Networking is supported on VM instances with four or more vCPUs. Supported series are: D/Dsv3, E/Esv3, Fsv2, Lsv2, Ms/Mms and Ms/Mmsv2. Refer to the Sizes for Linux virtual machines in Azure page for further details.
188.8.131.52.1 Add a Single Interface to the LoadMaster
To enable 10 Gb interfaces on the LoadMaster, perform the following steps:
1. Deploy the LoadMaster.
For the purposes of this document, the Standard DSv2 machine size is used.
When you instantiate a 10 Gb interface, it appears as two interfaces in the LoadMaster Web User Interface (WUI). The two interfaces are related and have the same MAC address. Only the first interface has an IP address. If you want to modify the interface, you must do this on the interface that has the IP address listed.
2. License and log into the LoadMaster.
3. Navigate to System Configuration > System Administration > System Reboot.
4. Click Shutdown.
5. In the Azure Portal, navigate to the LoadMaster Virtual Machine and click Stop.
6. In the Azure Portal, navigate to the Network Interface associated with the LoadMaster Virtual Machine.
7. Click Edit accelerated networking.
8. Click Enabled and select the validation box.
9. Click Save.
10. In the Azure Portal, navigate back to the LoadMaster Virtual Machine and click Start.
11. Log into the LoadMaster and verify that the Mellanox driver has instantiated correctly by performing the following steps:
a) If the LoadMaster was deployed with a single interface, two interfaces are displayed under System Configuration > Interfaces on the LoadMaster WUI. If only one interface is displayed this means that the Mellanox driver has not instantiated.
b) You can also verify that two interfaces are active by checking performing an Ifconfig. To perform an Ifconfig, navigate to System Configuration > Troubleshooting. On the Troubleshooting screen, click Ifconfig. This displays two interfaces with the same hardware address.
184.108.40.206.2 Add Multiple Interfaces to the LoadMaster
The Azure WUI does not allow interfaces with accelerated networking to be added. You must add the interface by using the Azure command line interface (CLI) or by using PowerShell.
You must run the command with the LoadMaster in a powered off state.
1. Create the interface using the Azure CLI similarly to the example below:
PS C:\Users\test> az network nic create --resource-group testdoc --name myNic2 --vnet-name myVnet --subnet subnet2 --accelerated-networking true --public-ip-address myPublicIp2 --network-security-group myNetworkSecurityGroup --location eastus
2. When the interface is created, you can add this interface to the LoadMaster when it is in a powered off state. Navigate to the Networking tab of the LoadMaster on the Azure WUI.
3. Click Attach network interface.
4. When the attachment is complete, both interfaces appear on the Azure WUI.
5. Restart the LoadMaster.
6. Verify that the interfaces are displayed under System Configuration > Interfaces on the LoadMaster WUI. The LoadMaster WUI should now display four interfaces.
You can also verify that four interfaces are active by checking performing an Ifconfig. To perform an Ifconfig, navigate to System Configuration > Troubleshooting. On the Troubleshooting screen, click Ifconfig.
Unlike the single interface case where eth0 and eth1 are related, for multiple interfaces, eth0 and eth2 and eth1 and eth3 are related (with the same MAC address). eth0 and eth1 have the IP addresses, the other interfaces without the IP addresses are related by the HWaddr (the MAC address).
3.3 Licensing and Initial Configuration
The following procedure outlines how to set up LoadMaster in Azure Government by ensuring appropriate licensing and basic configuration before you can create a Virtual Service and publish the required workloads:
1. Using a supported web browser, navigate to https://<DNSName>:8443.
Substitute <DNSName> with the DNS name you created in previous section.
2. Take the appropriate steps to acknowledge notification about the self-signed certificate to proceed.
3. You are presented with the End User License Agreement (EULA). You must accept the EULA to proceed further. Click Agree to accept the EULA.
4. You are prompted to enter your Kemp ID and password for licensing. If you do not have a Kemp ID, click the link to create one. Click License Now.
5. When licensing a BYOL LoadMaster, a list of available licenses is provided and/or a temporary trial license. Select the desired license and click Continue.
When licensing a trial, you are presented with a VLM-MAX Enterprise Plus subscription.
6. The LoadMaster requires you to log in before you can proceed any further. The password used to log in will vary depending on whether you choose to use Password authentication or SSH Public Key authentication when creating the VM in the Licensing Options section:
a) Password: Provide the username bal and the password which was set in the Licensing Options section. Click Continue.
b) SSH Public Key: Provide the default username bal and password 1fourall to proceed. You are required to change the default password soon after. Click Continue.
7. You are then presented with the main menu and home screen of the LoadMaster.
8. Before using the LoadMaster, it must be licensed. For instructions on how to license the LoadMaster, refer to the LoadMaster Licensing Feature Description.
9. After licensing, you are given the opportunity to enable Kemp Analytics. With this feature, LoadMaster collects and sends usage data to Progress Kemp for analysis. This data is strictly about product usage, enabled capabilities, and statistics. No sensitive user data, or traffic of any kind is either collected or communicated. To enable this feature, click Enable Kemp Analytics. To proceed without enabling this feature, click Don't Enable Kemp Analytics. For more information, visit https://kemp.ax/KempAnalytics.
Before you can create Virtual Services, you should create VMs that you are load balancing through LoadMaster in Azure Government. Ensure that your Network Security Group (NSG) is set up correctly depending on which services you are load balancing. For instructions on how to create Virtual Services, refer to the Virtual Services and Templates Feature Description.
4 Best Practices for Backups
Hypervisor snapshots cannot be used to restore a LoadMaster to a working state. The best way to back up your LoadMaster settings is by using the native backup and restore facility in the LoadMaster WUI or API.
To back up your LoadMaster configuration, follow these steps:
1. In the main menu, go to System Configuration > System Administration > Backup/Restore.
2. Click Create Backup File.
You can create a remote host for automated backups using SCP to save backups to a remote server.
For further details on backing up and restoring the LoadMaster configuration, including certificates and cipher sets, refer to the following links:
How to Create and Restore a LoadMaster Configuration or Certificate Backup
5 Change the 'bal' User Password using the Serial Console
The default administrator user for the LoadMaster is called bal. You can change the bal user password using the serial console in Local Administration > Set Password. If you know the current password, enter it along with the new password to change the password.
You can only change the password in this way if you are using the current password (you cannot change the password using an SSH key).
If you do not know the bal password, you can reset it by following these steps:
1. Log in using pwreset as the username and 1pwreset as the password. This resets the password to the default value (1fourall).
This default password is only valid for the console. The old bal password for the WUI is still valid at this point and the password only gets updated after completing the steps below. If the LoadMaster is rebooted at this point, the default password of 1fourall no longer works, so you would need to log in with pwreset and 1pwreset again to reset the password to the default password of 1fourall.
Logging in using pwreset only works if the LoadMaster is licensed. This does not work on newly deployed units that are unlicensed.
2. Log in using the bal username 1fourall password.
3. Then, go to Local Administration > Set Password.
4. Enter the current password (1fourall) and the new password.
While the instructions above provide a basic overview of how to deploy and configure LoadMaster for Azure, it is not designed to be a comprehensive guide to configure every possible workload. This section identifies some of many guides published on our resources section of our website. Unless otherwise specified, the following documents can be found at http://kemptechnologies.com/documentation.
LoadMaster, Product Overview
Web User Interface (WUI), Configuration Guide
CLI, Interface Description
RESTful API, Interface Description
Virtual Services and Templates, Feature Description
SubVSs, Feature Description
SSL Accelerated Services, Feature Description
Port Following, Feature Description
Content Rules, Feature Description
ESP, Feature Description
LoadMaster HA for Azure, Installation Guide
Licensing, Feature Description
You can find more documentation here: http://kemptechnologies.com/documentation
You can engage in community discussions on forums at: https://support.kemptechnologies.com/hc/en-us/community/topics
Last Updated Date
This document was last updated on 01 March 2023.