Differences

This shows you the differences between two versions of the page.

--- vb:run_webhmi_as_virtual_machine [2022/01/14 13:41] – ↷ Links adapted because of a move operation emozolyak
+++ vb:run_webhmi_as_virtual_machine [2024/04/05 08:33] (current) – emozolyak
@@ Line 3: / Line 3: @@
 ====== Run Virtual Box WebHMI image ======
-It is possible to run WebHMI as virtual machine. You can download VirtualBox image at [[https://level2.webhmi.com.ua/apps/downloads/list| Level2 system]].
+It is possible to run WebHMI as virtual machine (VM).
-{{ network:vm-1.jpg?nolink&912 |}}
+<WRAP center round download 50%>
+**Prerequisites** - You must have [[https://www.virtualbox.org/wiki/Downloads|VirtualBox]] installed on your computer to be able run this VM. VirtualBox Extension Pack is **required** as well if you want to use USB serial adapters (RS-232 or RS-485) inside VM.
+</WRAP>
-You must have [[https://www.virtualbox.org/wiki/Downloads|VirtualBox]] installed on your computer to be able run this machine. VirtualBox Extension Pack is **required** as well if you want to use USB serial adapters (RS-232 or RS-485) inside VM.
+The steps required are as follows:
-Once image was downloaded, extract archive to desired destination and open **WebHMI.vbox** file with VirtualBox.
+  - [[#downloading_the_image|Download the image]]
+  - [[#add_the_image_to_your_virtual_machines|Add it to your virtual machines]]
+  - [[#network_setup|Setup network]]
+  - [[#running_vm|Run the VM]]
+  - [[#adding_serial_ports_to_vm|Setup serial ports (if necessary)]]
-{{ network:vm-2.jpg?nolink&912 |}}
-This will run VirtualBox and add WebHMI virtual machine into it.
+You can also export your machine to other virtualization systems like VMware, Proxmox, etc.
-{{ network:vm-3.jpg?nolink&912 |}}
+===== Downloading the image =====
-You might want to adjust Processors amount on **System->Processor** tab settings.
+You can download VirtualBox image at [[https://level2.webhmi.com.ua/apps/downloads/list| Level2 system]].
-{{ network:vm-4.jpg?nolink&912 |}}
+{{vb:vbox_download_new.png?direct&688|}}
-Also you might need to select correct network adapter on **Network->Adapter 1** tab.
+===== Add the image to your virtual machines =====
+Once image was downloaded, extract archive to desired destination and double click the image configuration file for auto-install.
+{{:vb:install:vbox-machine-definition.png?direct|}}
+After this WebHMI VM will be in your system.
+{{:vb:install:webhmi-vm-in-your-vbox.png?direct&688|}}
+===== Network setup =====
+Upon installation, there will be one network adapter in the virtual machine with static IP address of 192.168.1.1 bound to one of your PC's network adapters (bridge mode).
+<WRAP center round important 60%>
+If your PC network differs from 192.168.1.0 network, you won't be able to connect to your virtual machine yet, becuase adapter's IP is set inside the VM.
+</WRAP>
+Enter setting and make neccessary network changes accordingly.
+{{ network:vm-3.jpg?nolink&800 |}}
+Select the PC's network adapter on **Network->Adapter 1** tab you want to share with VM's network #1 adapter.
 {{ network:vm-5.jpg?nolink&912 |}}
+Also we reccomend add another **Adapter #2** to your VM in the //virtual host adapter mode// to be able to connect to VM for sure. Please refer to this [[#create_virtual_network|section]]
+{{:vb:install:vbox-host-adapter.png?direct&600|}}
+===== Running VM =====
 Close settings window and click **Start** button.
@@ Line 51: / Line 81: @@
+====== Adding serial ports to VM ======
+===== Windows 10 host system =====
+For Windows 10 host system, a USB filter should be set up in the image properties.
+Please refer to the following picture:
+{{ :vb:v_box_serial_filter_eng.png?direct&600 |}}
+Be sure you enabled the USB converter for the virtual machine:
+{{ :vb:v_box_usb_serial_mapping.png?direct&600 |}}
+Inside WebHMI project, select your serial device in the connection properties, as shown below:
+{{ :vb:install:vm-select-usb-uart.png?direct&600 |}}
 ====== Troubleshooting ======