QuickStart Guide
...
Installation and Deployments
ISO Installation on Hypervisor...

ESXi ISO (VMWare vSphere 6.7.0)

16min

You can install Litmus Edge on a virtual machine using the ESXi Hypervisor (VMWare vSphere 6.7.0) with an ISO file.

A typical Litmus Edge virtual file for ESXi deployment adheres to a naming convention as follows: <product>-std_3.1.5.0-amd64.iso.

Before You Begin

  • Prepare your environment for running virtualization by using VMWare ESXi - Hypervisor.
    • Review Verified VM Versions and confirm the correct version to download. See VMWare.
    • The virtual machine will run on the same physical network card as the host environment. To ensure that the device can communicate with data sources such as PLC, DCS or CNC and can be accessed through the Web UI, make sure that communication can be established.
  • Adjust the system clock for the host environment prior to installing Litmus Edge. UTC is recommended. The 15-day trial period may be rejected and invalidated by the license server if the system clock is not adjusted. If this happens, contact your Litmus representative.
  • Obtain a valid file in the ISO format (example filename: <litmusedge-std_3.1.5.0-amd64>.iso). You can get the ISO file from the Litmus Central portal.

To install Litmus Edge on VMWare vSphere 6.7.0, you will need to do the following., you will need to do the following.

  • Step 1: Create a Virtual Machine
  • Step 2: Log in to Litmus Edge

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

Step 1: Create a Virtual Machine

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

To install the ESXi-Hypervisor virtual machine:

  1. Start the VMWare (VMWare vSphere 6.7.0) application. The VMWare ESXi application appears.

    ESXi Application window
    ESXi Application window
    
  2. From the left panel, select Virtual Machines.
  3. Click Create/Register VM. The New virtual machine wizard > Select creation type window appears.

Select Creation Type

Select Create a new virtual machine and click Next.

Select creation type screen
Select creation type screen


Select a Name and Guest OS

This section allows you to provide a name for the virtual machine and identify the guest operating system.

Enter the details for the name and guest OS.

Name and guest OS
Name and guest OS

  • Name: Enter a name for the virtual machine.
  • Compatibility: Your selection must be compatible with your ESXi version Guest OS family (Linux).
  • Guest OS family: The operating system is based on Linux.
  • Guest OS version: The kernel used for the operating system is a 64-bit Yocto Kernel.

Select Storage

You will need to select a datastore for the virtual machine's configuration files and all of its virtual disks.

Select a datastore and click Next.

Note: The datastore must have at least 50 GB of free capacity.

Select storage screen
Select storage screen


Customize Settings

You will need to configure the virtual machine hardware and virtual machine additional options.

Note: Your specific setup may require different or additional configurations. Follow up with your IT department for these requirements.

Configure the Virtual Hardware parameters.

Customize settings screen
Customize settings screen


CPU parameter

Select 4. This value is recommended to improve the performance of the VM. If the host system permits or the VM is a production deployment, more cores should be allocated.

Memory parameter

Enter 8 GB or set the memory size to the desired allocation. At least 2048 MB should be allocated to prevent significant reduction in performance. If the host system permits, more memory is better.

Hard disk 1 parameter

Enter a minimum of 25 GB in the Hard disk field. Depending on your storage requirements, you may have to select a higher value.

Note: The VM should boot up successfully with the hard disk Controller location configured with an SCSI controller. If there are issues with the VM booting up, follow up with your IT department. Review this configuration by expanding this section.

Network Adapter 1 parameter

Notes:

  • By default, VMs are defined with two network cards. They are configured for the first network card as a Bridged Network and the second network card as NAT.
  • Based on the ESXi host environment, if a NAT network exists, a second network adapter must be added and set to NAT.
  • If a NAT network exists, move to the next section. Otherwise, skip it.

To confirm the network adapter:

  1. Click Add network adapter.
  2. From the New Network Adapter drop-down list, select NAT Network.

CD/DVD Drive 1 parameter

To configure the CD/DVD Drive:

  1. From the CD / DVD Drive 1 drop-down list, select Datastore ISO file. The Datastore browser appears.
  2. Select the ISO file, and then click Select.

Click the VM Options tab.

The VM Options section
The VM Options section


To configure the VM options:

  1. Select the VM Options tab.
  2. Expand Boot Options and select BIOS from the Firmware drop-down list. BIOS is needed for the installer to load.
  3. Click Next.
  4. Click Finish. The new virtual machine link appears in the Virtual Machine list.

Step 2: Run Operating System Installer

You will run the operating system installer that will install Litmus Edge.

Notes:

  • During the installation, the progress bar may decrease at times due to partitioning.
  • The time to complete the installation is based on the size of the hard disk drive. Large disk drives will cause the installation to take longer to partition the disk and therefore longer to complete setting up the virtual machine.

To configure the operating system installer:

  1. Click the new virtual machine link. The virtual machine details pane appears.
  2. Click the Terminal shell to start the virtual machine. Some errors appear in the terminal window. You can disregard them. The Welcome to Operating System Installer appears in the Terminal shell.
  3. From the Welcome to Operating System Installer screen, enter yes and press ENTER. Select a drive to Install (sda) appears.

    Document image
    
  4. Enter sda and press ENTER. To Confirm Installation and format partitions appears.

    Document image
    
  5. Enter yes and press ENTER. The installation begins. During the installation, another error appears regarding an invalid partition table. You can disregard it.

    Document image
    
  6. When the installation completes, close the terminal shell.
  7. From the virtual machine details pane, click Edit. The Edit settings dialog box appears.
  8. Select the VM Options tab.
  9. Expand Boot Options and select EFI from the Firmware drop-down list.
  10. Click Save. The virtual machine details pane appears.
  11. Click Power on, and then click the Terminal shell. The Welcome window appears.
  12. Note the IP address required for log in.
Terminal User Interface: Welcome to Litmus Edge
Terminal User Interface: Welcome to Litmus Edge


Step 3: Log in to Litmus Edge