How to make Integris work on a virtual machine.
This document is intended to give general guidelines on how to work/install Integris on a virtual machine.
Virtual machine must comply with certain prerequisites:
• Windows OS compatible: WIN 10 is the most recommended one.
• Serial ports (including Ethernet Port) should be allowed to be mapped by the virtual machine.
The following are the steps:
• Open the Virtual Machine and within a WIN OS (win 10 recommended) environment already installed,
• Copy the Integris Installer (from any mean it was provided on- usually a zip file) to the desktop folder, then,
• Unzip the installer on a new created folder in the desktop folder (name the new created folder as Integris Installer 20xx)
• Once decompressed, open the newly created folder Integris Installer 20xx and look for the Installer application
• Double click on it and wait until the Installation process is done.
• If applicable, install the drivers for the corresponding ISOx communications device. Some drivers can be obtained from the Support Folder found in the Installer folder:
o In this particular case, and although the technical issues that several Integris systems have experienced with, we are going to go through the ISO3 communications device configuration (as an example), as this is the most common used COM device when Integris is installed on virtual machine: due to the fact that this com device uses TCP IP protocol and it is provided with an ethernet port, it can be installed on a remote location, provided that the virtual machine can access the ethernet domain in which the ISO3 com device has been attached to, whereas the other ISOx com devices must have a physical connection (to a serial port) to the PC where the virtual machine resides.
o The first step when setting up an ISO3 device is to define the Ethernet domain and the IP address: a static IP address within the selected domain should be assigned to the ISO3
device (in this example, we are going to work with the following IP address: 192.168.168.8)
o The second step is to configure/program the ISO3 device (Digione_SP) with the selected static IP address using a laptop/desktop:
▪ If the ISO3 device was purchased/obtained from OPI, these are preconfigured with the following static IP address:
• Static IP: 192.168.3.8, therefore,
• Configure the laptop/desktop’s ethernet port with the following IP address: 192.168.3.7
• Open a web browser session (chrome/Internet/…) and in the URL field type in: http://192.168.3.8 and wait for the Digione_SP admin website to request credentials.
• Type in:
o For Username: root
o For Password: dbps
• The following website should appear:
http://192.168.3.8
• Then click on “Network” option:
• Configure the networking fields accordingly.
• And “Apply”
• Reboot the ISO3 device: cycle the power for the changes to take effect.
• Repeat the web browser session ensuring the changes took place (using now the new URL: http://static-assigned-IP-Address
o The third step is to configure a Real_Port on the virtual machine to allow Integris software to communicate with the ISO3 device:
▪ In the “Support/ISO3” folder within the Installer folder, run the corresponding Setup32/64 (preferably win 10, 64 bits)
A window will pop-up
Select “Add a New Device” and press “Next”
Wait until <Device not listed> shows up, select it and press “Next >”
Populate (type in) the IP address field with the ISO3 device assigned IP address, and within “No. Ports” select “1” then press “Finish” button.
If the ISO 3 device has not been connected yet or the virtual machine is not getting access to the domain (network) where the ISO3 device has been hooked up to, then a warning message will appear letting you know about this. Press “Yes” and a progress bar will show up indicating the process has started.
Once the process is complete, you will be informed that the process has been successfully completed
Click “Finish”
Now, make sure the ISO3 device (Digione_SP) is up and running and connected to the network, and that the virtual machine is getting access (communication) to the ISO3 device:
• Open command line in virtual machine and ping the ISO3 device static IP address to ensure communication between Integris software and ISO3 device will is ok.
Once the communication has been verified, Integris software can be ran.
* This is not the recommended configuration. OPI recommends a stand-alone PC for Integris.