---
title: VirtualBox ISO
slug: manufacturing-connect-edge-v1/virtualbox-iso
docTags: 
createdAt: 2022-03-30T21:23:30.000Z
---

You can use VirtualBox to install Manufacturing Connect Edge using an ISO file.

# Before You Begin

- Prepare your environment for running virtualization by using Oracle VirtualBox. 
  - Review [Verified VM Versions](docId:36xPLuILTp2QajsR8ltHw) and confirm the correct version to download. See  [VirtualBox Downloads](https://www.virtualbox.org/wiki/Downloads). 
  - Refer to [VirtualBox Documentation](https://www.virtualbox.org/wiki/Documentation) to learn more. 
  - 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 Manufacturing Connect 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. You can download it from **Manufacturing Connect (MC)** > **Edge Management** > **Downloads**. Alternatively, you can obtain an ISO file from Litmus.

To use VirtualBox to install Manufacturing Connect Edge using an ISO file, you will need to do the following. 

- Step 1: Create a Virtual Machine
- Step 2: Configure the Virtual Machine
- Step 3: Install the ISO File
- Step 4: Run Manufacturing Connect Edge On the Virtual Machine
- Step 5: Log in to Manufacturing Connect 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 need to create a virtual machine (VM) that will be used to run Manufacturing Connect Edge. 

**To create a virtual machine**:

1. Start the VirtualBox application.
2. From the *Oracle VM VirtualBox Manager* window, click **New **on the toolbar.
   The *Create Virtual Machine* dialog box appears.
3. If needed, toggle **Guided Mode** to **Expert Mode**.
   The dialog box expands.
4. Enter a name for the virtual machine in the **Name** field.
5. Select **Linux** from the **Type** drop-down list.
6. Select **Other Linux (64-bit)** from the **Version** drop-down list. You can select Linux 2.6, 3.x, or 4.x (64-bit).
7. Move the **Memory Size **slider to set the memory size. The minimum is 2 GB of (2048 MB). Select more memory if the host system permits.
8. From the *Hard disk *section, select **Create a virtual hard disk now**.
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/Vp1-c36calrAwVDWXAqTi_01-1tpt74joo7cuctby3ksysimage.png" size="80" width="896" height="779" caption="Create virtual machine dialog box" position="center" showCaption="true"}
9. Click **Create**.
   The **Create Virtual Hard Disk** dialog box appears.
10. From the *Hard disk file type* section, select the **VMDK (Virtual Machine Disk)**.
11. From the *Storage on physical hard disk *section, select **Dynamically allocated**.
12. Move the **File Size** slider to set the file size. The minimum value is 16 GB, which enables the VM to run. This size provides the resulting VM with about 2 GB of data storage. This is enough for a small-scale PoC without much data storage on the disk. If this VM is deployed as a production system or the PoC requires more storage for databases, increase the file size beyond 16 GB.
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/m1M0gTirOrXvxJFfhp_1F_02-ihklwlmgncgehevbnbrgbimage.png" size="80" width="782" height="703" caption="Virtual Disk parameters" position="center" showCaption="true"}
13. Click **Create**. 
    The new VM is deployed. It appears on the list in the *Oracle VM VirtualBox Manager* window.
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/RZyc7VEocj7Z4rmB10Y9O_03-dnydbqsiqqkn8btoo9mbyimage.png" size="80" width="1496" height="820" caption="New VM listed in left pane" position="center" showCaption="true"}



# Step 2: Configure the Virtual Machine

After installing the VM, you will need to configure it. 

**To configure the virtual machine you created**:

1. From the *Oracle VM VirtualBox Manager* window, select the new VM on the left pane, then click **Settings** on the toolbar. 
   The** ***Settings *dialog box appears.
2. From the left pane, select **System**.
   The *System *pane appears on the right. 
3. Click the** Motherboard** tab.
4. From the* Pointing Device* drop-down list, select **PS/2 Mouse**. 
5. From the *Boot Order* section, highlight the **Optical** option and then click the **Up** arrow to make this option first on the list. Make sure the *Optical *option is not deselected when moving it. 
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/t-XDGxieYC5ZI_5yEgSa9_04-r4iysa7rskvttexngiznhimage.png" size="80" width="1226" height="741" caption="System settings dialog box" position="center" showCaption="true"}
6. Click the **Processor** tab.
7. Move the **Processor(s)** slider to set the cores for the VM to **2** (the recommended minimum). If the host system permits or the VM is a production deployment, more cores should be allocated.
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/sSOmdBnvbOH5Iu_8d-21w_05-cdxkefi5by93amfmhxiagimage.png" size="80" width="1226" height="741" caption="Processor system settings" position="center" showCaption="true"}
8. From the left pane, select **Storage**.
   The *Storage *pane appears on the right.
9. From the *Storage Devices* section, select the **Controller**. 
10. From the *Type *drop-down list, select **AHCI**. 
    If *AHCI *is not available, select, **PIIX4**. The PIIX4 option works, but displays a number of messages throughout the installation. 
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/L2AdCESfXAhBySmoPgJCo_isovirtualboxstorage01.png" size="80" width="1227" height="908" caption="Storage controller settings" position="center" showCaption="true"}
11. From the *Storage Devices *section, select the **Optical **drive (currently shown as *Empty*). 
12. From the *Attributes *section, click the **Optical Drive** icon and select **Choose a disk file**. 
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/eVugEq9xGgKm7zKxmSX4z_isovirtualboxstorage02.png" size="80" width="1227" height="908" caption="Optical settings" position="center" showCaption="true"}
13. Navigate to the ISO file from which you want to install, and then click **Open**.
    The Optical drive in the *Storage Devices* section displays the name of the ISO file you selected.
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/oJ7hbeMpF2Ayni7Zl_EQV_17-koj9jzs-hssiheusny6luimage.png" size="80" width="1226" height="742" caption="ISO file listed in Controller: IDE" position="center" showCaption="true"}
14. From the left pane, select **Audio**. 
    The *Audio *pane appears on the right.
15. Clear the **Enable Audio Output** check box.
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/m9KzWcLcJS2H8U942Pj3U_18-h9garqgevxhxeogguqimage.png" size="80" width="1226" height="742" caption="Audio settings" position="center" showCaption="true"}
16. From the left pane, select **Network**.
    The *Network *pane appears on the right.  
17. Click the **Adapter 1** tab.
18. Select the** Enable Network Adapter** check box.
19. From the *Attached to* drop-down list, select **Bridged Adapter**.
20. Select the appropriate network card name from the **Name **drop-down list.
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/K_DNC1QPR0pB_ykymRAII_19-hmapy5hnqugbgzukao9rtimage.png" size="80" width="1226" height="742" caption="Network settings" position="center" showCaption="true"}
21. Select the **Adapter 2** tab.
22. Select the** Enable Network Adapter** check box.
23. From the* Attached to* drop-down list, select **NAT**.
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/qsMYFRsg3hQnlRa2MJhrc_20-kdvuafcs96jzh3shc4eadimage.png" size="80" width="1226" height="742" caption="Adapter 2 tab" position="center" showCaption="true"}
24. From the left pane, select **USB**.
    The **USB** pane appears on the right.
25. Deselect the **Enable USB Controller** check box. 
    ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/or72WzxrUtsEoLIMKHrLh_21-fnusb9qr-htqgcqsmnllvimage.png" size="80" width="1226" height="742" caption="USB settings" position="center" showCaption="true"}
26. Click **OK**. 

# Step 3: Run the Operating System Installer

You will run the operating system installer that will install Manufacturing Connect Edge. 

:::hint{type="info"}
**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 install the ISO file:**

1. From the *Oracle VM VirtualBox Manager* window, select your VM and click **Start** on the toolbar.
2. If prompted, select the ISO file you added to the Optical device in the **Storage **settings, then click **Start**. If the Start button does not close the prompt box, click **Cancel**. This will not interfere with the installation. 
   The Terminal User Interface (TUI) appears. If a message appears warning you that the mouse you are using is not supported in TUI, ignore it. You can navigate the TUI using arrow keys and make selections by pressing the `ENTER` key.
   During loading, the Terminal User Interface may display the following warning/error messages. These can be ignored. 
   ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/XpcrGKSTdXToEskOH347Z_22-j99c4rqmqic80gzv-hb7doc454-screenshot-1.png "Warning/error messages")
3. After the device initiates, respond to the questions in the TUI. Enter **No** to continue with the installation using the graphical interface.
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/fdv6yuZoLjvvMW8WdklsI_23-if9prgtfougvok8qothuoimage.png" size="80" width="720" height="90" caption="Question asking if you are installing over Serial interface" position="center" showCaption="true"}
4. Select **Install Operating System**, and then select **Ok**.
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/l8vADEN0UVOa1g9SNGDJc_24-wbmapjshnkw4qnrvimaaaimage.png" size="80" width="720" height="400" caption="Install Operating System message" position="center" showCaption="true"}
5. Select the partition to install, and then select **Ok**.
   The list is device-specific. Typically, the installation location is *sda*. If the device/gateway has embedded MMC (eMMC) components, the partition name may be listed as *mmcblk *instead of *sda*. Make sure you select the correct hard-drive location. 
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/v2H4KZ6UWvp_IkfhiyG10_25-0oizj2isjura3lff6zrrimage.png" size="80" width="719" height="400" caption="Partition selection option" position="center" showCaption="true"}
6. Select **Yes **to verify the OS installation location. If you select** No**, you return to the beginning of the installation.
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/UXBG6qqb1_30UuC-G7Dx4_26-r1tw9wawtgicjqiv276nimage.png" size="80" width="719" height="400" caption="Select Partition and Install message" position="center" showCaption="true"}
7. Select **Yes** to continue formatting the device and installing the operating system.
   The installer indicates its progress followed by a success message.
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/EkP6nk11UbkJL4g81ckBa_27-bdvxoumzyrintkn9s2y6yimage.png" size="80" width="720" height="400" caption="Format Devices and Install message" position="center" showCaption="true"}
8. After installation, the Terminal User Interface may display the following warning/error messages. These can be ignored. 
   ![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/xVGgGmSB5qFEuah90hA0T_29-ne7kjp5ak6bwcec4d62-qdoc454-screenshot-2.png "Warning/error messages")
9. Select **Yes** to power off the device.
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/zqc9QOlQ1ypEjRljni2Iy_30-e9ok6r03gmpmslrhgn4l5image.png" size="80" width="720" height="400" caption="Power Off message" position="center" showCaption="true"}

# Step 4: Run Manufacturing Connect Edge on the Virtual Machine

Once the ISO file is successfully installed, you can run Manufacturing Connect Edge on the virtual machine. 

**To run Manufacturing Connect Edge on the virtual machine:**

1. You will need to remove the ISO file from the Optical drive. From the *Oracle VM VirtualBox Manager* window, select your VM on the left pane. On the right pane, click the **\[Optical Drive]** text in the *Storage *section.
   The selected file turns blue.
2. Right-click the file and deselect the ISO file. 
   The Optical Drive shows empty. 
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/voiYDIKdthnvkqx58JR_u_opticaldrive.png" size="80" width="1140" height="919" caption="Optical Drive settings" position="center" showCaption="true"}
3. In the *System* section, select **Boot Order**. 
4. Highlight **Hard Disk**, click the **Up **arrow to move the Hard Disk to the top, and then click **OK**. The order should be Hard Disk, Optical, and Floppy. 
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/yKLDNKtybm1dlGnJKRLGP_bootorder.png" size="80" width="1140" height="919" caption="Boot Order settings" position="center" showCaption="true"}
5. Click **Start**. 
   ::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/5f_5FG6yzBQdGZJMQXSrK_startvm.png" size="80" width="1140" height="919" caption="Start VM" position="center" showCaption="true"}

During loading, the Terminal User Interface may display the following warning/error messages. These can be ignored. 

::Image[]{src="https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/5J-6KMWRWLIh4x301cCq2_33-i5ojuy6lnrqequ00ztydoc454-screenshot-3.png" size="80" width="459" height="30" caption="Warning/error messages" position="center" showCaption="true"}

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.

![](https://api.archbee.com/api/optimize/SSUUxKZUk9bFTEPNn_6Zo/4Px_dBtnrf-Z1cR2PhXH1_image.png "URLs to access Web UI")

# Step 5: Log in to Manufacturing Connect Edge

- See [Access the Manufacturing Connect Edge Web UI](docId:9y0-N74s8m5X4GYnBfB9U) for details on logging in. 
- See [Access the Terminal User Interface](docId\:Nv5-VDIQScYC3UKTNEy38) for instructions on how to navigate and log in for the first time.

# Troubleshooting

If you don't see an option for a 64-bit version and only see a 32-bit version, refer to [VirtualBox Only Showing 32-bit and No 64-bit Versions](docId\:h5aBb9Q5KFja1FNT4BxRp).