Host templates

This section describes how to use templates to provision your elastic cloud-based hosts.

Host templates overview

Host templates are used for defining provisioning-related details, such as instance types, regions, hardware specifications, and software images. You create your own templates, and LoadRunner Enterprise uses the details of the selected template to provision your host.

All elastic cloud hosts are provisioned from host templates. When you provision a host, LoadRunner Enterprise copies the details of the template into the provisioned host.

  • If you are using an Amazon EC2 cloud account, LoadRunner Enterprise creates an image for each cloud account by default. The templates use a custom image which you create (see Create custom image for cloud hosts) with the recommended hardware settings, defined by instance type, for the load generator machine.

  • For Microsoft Azure cloud accounts, you must create you own host templates. When using the host templates, the administrator can control and manage which machine's specifications are allowed and recommended for use.

Back to top

Considerations when creating a host template

When creating host templates, make sure to:

  • Create a template for each host configuration that your testers need. Testers can only provision cloud hosts from existing templates.

  • Clearly describe the type of host that is provisioned by each template so that testers can provision exactly the hosts they need.

Create an elastic cloud host template

This task describes how to create a cloud host template in LoadRunner Enterprise.

  1. Prerequisites

    To add a host template to LoadRunner Enterprise, you must have added at least one cloud account. For details, see Cloud accounts.

  2. In LoadRunner Enterprise Administration, select Configuration > Cloud.

  3. Select the Host Templates tab, and then click Add Host Template .

  4. In the New Host Template dialog box, enter a name and description that clearly describe the type of host that is provisioned by the template so that testers can provision exactly the hosts they need.

    LoadRunner Enterprise automatically generates and ID for the host template at the time the template is created.

  5. Enter the following details for the new host template:

    UI Element Description
    Cloud Account The cloud account for which the template provisions a host.
    Type

    The installation type of the host. The following types are available:

    • Unix Load Generator. Indicates that this Unix host is used as a standalone load generator for performance tests.

    • OneLG. Indicates that this Windows host is used as a standalone load generator for performance tests.

    Note: Make sure that you select the correct installation type for the image. Incorrect settings cause the performance tests to run incorrectly.

    Location The region where the hosts are provisioned.
    Image

    The software image used for cloud hosts provisioned from the template. Machine images are managed on the website of your cloud provider, and are accessed automatically when creating host templates.

    Note: If the image value cannot be displayed, verify that you used the correct cloud account number.

     

    Instance Type

    (AWS accounts only)

    The hardware specs of cloud hosts provisioned from the template. Instance types can be viewed on the website of your cloud provider, and are accessed automatically when creating host templates.

    Note: While Amazon lists EC2 F1 instances for Windows, they are available for Linux/Unix operating systems only.

    Security Group

    Select a security group that allows the necessary access to your testing hosts. Security group specifies which inbound and outbound connections are permitted from the hosts, such as port 80 (HTTP) or port 3389 (RDP). Security groups are configured on your cloud provider's website, and must be created separately for each location. Only security groups configured for your selected location are displayed. For details, see Initial cloud settings overview.

    Key Pair

    (AWS accounts only)

     

    Select a key pair for which you have the private key. Key pair is used to generate the administrator password for Windows machines and to log in to Linux machines. Key pair is only relevant if you plan to remotely connect to your cloud hosts.

    Key pairs are managed on your cloud provider's website, and must be created separately for each location. Only key pairs configured for your selected location are displayed. For more details on key pairs, see Initial cloud settings overview.

    Note: You must have at least one key pair in order to provision a host.

    Virtual machine sizes

    (Azure accounts only)

    Size of the Azure virtual machine.

    Virtual Networks

    (Azure accounts only)

    Select a virtual network for virtual machines to use.

    Host Password

    (Azure accounts on Windows only)

    Enter a password to use as the administrator’s password for all virtual machines.

    The password must be between 8-123 characters long, and contain at least one character from three of the following categories: uppercase letter, lowercase letter, numeric digit, special character. Control characters are not allowed.

    SSH Public Key

    (Azure accounts on Linux only)

    This key is installed on the virtual machines.

    Use Elastic IP Addresses

    If you defined a pool of predefined IP addresses with your cloud provider, select this option to use those predefined static IP addresses to provision your host. For more details on elastic IP addresses, see Initial cloud settings overview.

    Note:

    • This option is automatically selected in multi-tenant environments and cannot be modified.

    • Make sure that your elastic IPs are tagged with a name and value as defined in the <LoadRunner Enterprise server installation>\LRE_BACKEND\appsettings.defaults.json file. You can customize the value in the file.

      For Azure (the default value):

      "PublicIpsTag": {
"Key": "LRE_TEST_TAG",
"Value": "LRE_TEST_TAG_VALUE"

      For AWS:

      "ElasticIpsTag": { 
"Key": "LRE_TEST_TAG",
"Value": "LRE_TEST_TAG_VALUE"

    Use Private IP Addresses

    Select this option to use private IP addresses to provision your host with this template (public IPs are not assigned).

    Note:

    • If selected, you must provide the virtual private cloud (VPC) subnet ID (for AWS) or subnet name (for Azure).

    • This option is not available in multi-tenant environments.

    VPC Subnet Id

    (AWS accounts only)

    ID of the virtual private cloud (VPC) subnet.

    Note: This option is not available in multi-tenant environments.

    Subnet Name

    (Azure accounts only)

    		 Name of the virtual private cloud (VPC) subnet.

  6. Click Save. The host template is created.

    Your new host template can now be used to provision cloud hosts.

Back to top

Export host template details to Excel

This task describes how to export information displayed in the host template grid to an Excel file.

  1. In LoadRunner Enterprise Administration, select Configuration > Cloud.

  2. Select the Host Templates tab, and then click Export to Excel file . Data from the grid is saved to an Excel file and downloaded to the Downloads folder of the client user.

Back to top

Create images for Microsoft Azure cloud accounts

To create images for Microsoft Azure cloud accounts, see Custom Azure (Windows) image and Custom Azure (Ubuntu) image.

Back to top

Modify host template details

To modify details for a host template:

  1. In LoadRunner Enterprise Administration, select Configuration > Cloud.

  2. In the Host Templates tab, select a template from the Host Templates list (click the link in the Template Name column). The Host Template details page opens.

  3. Make any necessary changes and click OK. For details, see Host Template details.

Back to top

Delete host templates

To delete a host template:

  1. Prerequisites

    Before deleting host templates, make sure there are no assigned projects with tests using the templates (deleting a host template that is used by a test causes the test to fail).

  2. In LoadRunner Enterprise Administration, select Configuration > Cloud.

  3. In the Host Templates tab, select the host templates that you want to delete, and click Delete .

Back to top

Next steps: