QuickStart Guide
Installation and Deployments

Virtual Machine Installation (ESXi-Hypervisor)

9min

You can install Litmus Edge Manager on a virtual machine using VMWare ESXi - Hypervisor.

The virtual machine that runs Litmus Edge Manager uses the system time of the host environment. To ensure that timestamps of collected data are as universal as possible, we recommend setting the system time of the host environment to the UTC timezone.

A typical Litmus Edge Manager virtual file for ESXi deployment adheres to the following naming convention: <product-2.2.2>.ova.



Before You Begin

  • Configure the docker bridge network. By default, this installation allocates the subnet 172.17.0.0/16. Make sure that this does not conflict with your host environment network configuration.

Tip: To reconfigure the docker bridge network, please refer to this docker guide.

  • Set up proxies to access Litmus Edge Manager behind the company firewall.
  • Install ESXi v6.7 or higher. See VMware for more information.
  • Obtain a valid .ova file. Contact Litmus or download the file from the Customer Portal.

To use ESXi-Hypervisor to install Litmus Edge Manager, you will need to do the following.

  • Step 1: Install the Virtual Machine (ESXi-Hypervisor)
  • Step 2: Log in to the Litmus Edge Manager (LEM) UI
  • Step 3: Verify Trial License and Register a Litmus Edge Manager License

To jump to a specific section, refer to the Table of Contents on the right side and click the corresponding step.

Step 1: Install the Virtual Machine (ESXi-Hypervisor)

You will first need to install the virtual machine that will run Litmus Edge Manager.

To install the virtual machine:

  1. Start the VMWare application (for example, VMWare vSphere 6.7 hypervisor). The VMWare ESXi application appears.

    VMWare ESXI panel
    VMWare ESXI panel
    
  2. Click Create/Register VM. The New virtual machine wizard - select creation type appears.
  3. Click Deploy a virtual machine from OVF or OVA file, and then click Next. The New virtual machine wizard - select OVF and VMDK files appears.

    Select creation type panel
    Select creation type panel
    
  4. From the right pane, enter a name in the Name field.
  5. Select the .ova file using Browse or drag and drop the file on the Select File field, and then click Next. The New Virtual Machine wizard - Select datastore appears.

    Select OVF and VMDK files panel
    Select OVF and VMDK files panel
    
  6. From the right pane, select the datastore and then click Next. (See Note below.) The New virtual machine wizard - Deployment options appears.

    Select storage panel
    Select storage panel
    
  7. From the right pane, verify that the VM Network is set to your main Network port group (for example, VM Network).

    Deployment options panel
    Deployment options panel
    
  8. From the same pane, uncheck Power on automatically, and then click Next. The New virtual machine wizard - Ready to complete pane appears.
  9. Review the settings and then click Finish.

    Ready to complete panel
    Ready to complete panel
    

Note: The datastore selected in Step 6 must have at least 80 GB of free capacity.

The virtual machine deploys. The progress of the deployment is indicated at the bottom in the Recent tasks display.

Deployment may take several minutes.

The virtual machine appears in the localhost pane.

Finished Virtual Machine with LEM
Finished Virtual Machine with LEM


The virtual machine starts up and the terminal window displays.

Tip: You can change your settings using the Terminal User interface (TUI).

To log in using the Terminal window, refer to the Default Login Credentials section above.

10. Note the IP address required for login.

Step 2: Log in to the Litmus Edge Manager(LEM) Web UI

After installing the virtual machine, you can then log in to Litmus Edge Manager using a browser.

To log in to LEM Web UI:

  1. Open a new incognito browser window and paste the IP address noted during setup into the URL field. The application initializes, and then the Log In screen appears.
  2. Enter the default credentials. Refer to the Default Login Credentials section above.
  3. Change your password to activate your account, and then click Submit. The Litmus Edge Manager application opens.

Note: You must change your password after the first log in.

Step 3: Verify Trial License and Register a Litmus Edge Manager License

After the Litmus Edge Manager is successfully installed, it will automatically be installed with a trial license.

To verify the trial license:

  1. From the Navigation panel, select Settings. The Settings pane appears.
  2. From the Settings pane, select Licenses.
  3. From Licenses' Available Licenses section, view the license list. Initially, the device operates on a trial license.

You will eventually need to register a Litmus Edge Manager license once the trial license expires. To register a Litmus Edge Manager license, see Site and Node-Locked License Overview for Litmus Edge Manager.