QuickStart Guide
...
Installation and Deployments
ISO Installation on Hypervisor...
VirtualBox MacOS
6min
You can use Oracle VirtualBox on macOS Big Sur to install Litmus Edge.
- Prepare your environment for running virtualization by using Oracle VirtualBox.
- 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 use VirtualBox on macOS Big Sur to install Litmus Edge, you will need to do the following.
- Step 1: Create a Virtual Machine
- Step 2: Configure Settings
- Step 3: 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.
You will first need to create the virtual machine that will run Litmus Edge.
To create the virtual machine:
- Start the Oracle VirtualBox application.
- Click the New icon.
- From the Name and operating system dialog box, configure the following.
- Name: Enter a name for the virtual machine.
- Type: Select Other.
- Version: Select Other/Unknown (64-bit).
- Click Continue. The Memory size dialog box appears.
- From the Memory size dialog box, enter 4096 in the MB field.
- Click Continue. The Hard disk dialog box appear.
- From the Hard disk dialog box, select Create a virtual hard disk now and click Create. The Hard disk file type dialog box appears.
- From the Hard disk file type dialog box, Select VDI (VirtualBox Disk Image) and click Continue. The Storage on physical hard disk dialog box appears.
- From the Storage on physical hard disk dialog box, select Fixed size and click Continue. The File location and size dialog box appears.
- From the File location and size dialog box, Enter 32.00 in the Size field and click Create. The progress bar appears, and then the Hard disk dialog box appears.
- From the Hard disk dialog box, select Create a virtual hard disk now and click Create. The VirtualBox Manager appears.
After installing the virtual machine, you will need to configure its settings.
To configure the settings:
- From the open Oracle VirtualBox application, select the deployed virtual machine from the left pane.
- Click the Settings icon, and then click the General section in the right pane. The General dialog box appears.
- From the General dialog box, select the System icon at the top. The System dialog box appears.
- From the System dialog box, configure the following.
- Enable I/O APIC: Select the checkbox.
- Hardware Clock in UTC Time: Select the checkbox.
- Processor: Click Processor and enter 2.
- Click Storage. The Storage dialog box appears.
- From the Storage dialog box, select the Empty device in the left pane.
- Hover over the Optical Drive icon and select Choose a disk file.
- Navigate to the ISO file, and then click Open.
- Click Network. The Network dialog box appears.
- From the Network dialog box, select Bridged Adapter from the Attached to drop-down list and the appropriate network card name.
- Click OK. The VirtualBox Manager appears.
- From the VirtualBox Manager, Click Start. The Terminal User Interface (TUI) opens and runs the installation you configured, and then the VirtualBox Manager appears.
- Click Settings, and then click System.
- From the System dialog box, configure the following:
- Optical: Uncheck the check box.
- Hard Disk: Select Hard Disk and click the Up arrow to move it up in the boot order.
- Enable EFI (special OSes only): Select the check box.
- Click OK. The VirtualBox Manager appears.
- Click Start.
The VM starts up and the terminal window displays the URLs to be used to access the edge device through the Web UI. If several URLs are shown, use the first one.
URLs to access Web UI
After you create the virtual machine, you must configure the network adapters.
- See Access the Terminal User Interface for instructions on how to navigate and log in for the first time.
If you don't see an option for a 64-bit version and only see a 32-bit version, refer to Installation and Deployments Troubleshooting.