Setting up the Virtual Appliance on Virtual Box

note

Download the Inimco Virtual Box image [here].(https://stfactsprd.blob.core.windows.net/inimco-vai-vbox/inimco-vai-vbox.ova?sp=r&st=2023-06-12T13:55:20Z&se=2100-06-12T21:55:20Z&sv=2022-11-02&sr=b&sig=%2FhRI58ZMV3OzsWUTq0CypPOZd65rvZDUcYpsAc3lCao%3D)

Pre-requisites:

• Hypervisor set up in the Utility VM.
• IoTHub enrollmend created in the DPS.

Get the VM Ready

1. Start the VM.

2. Log in with the following credentials: ubuntu, ubuntu.

3. To set a temporary static IP, edit the Netplan file by executing the following command:

   sudo nano /etc/netplan/50-cloud-init.yaml

4. Fill in the variables using the IP setting of your current plant. Make sure you use the same IP as the VM you started in the above steps.

   note

   The first address is the PRD or ACC VM address, not the one of the Hypervisor. The gateway and the DNS server names can be found by typing 'ipconfig /all' in the Hypervisor command line.

5. Save with ctrl+x > y > enter.

6. To set the IP, execute the following command:

   sudo netplan apply

7. Connect to the virtual machine via PowerShell on the Utility VM, execute the following command:

   ssh ubuntu@[IP of VM]

8. Log in with the Ubuntu credentials again.

   note

   It's easier to connect to the virtual machine via PowerShell as it allows easy copying and pasting.

Deploy the Virtual Appliance

1. While connected to the Linux VM you just created via SSH on the Utility VM, execute the Sysprep script:

   sudo ./sysprep.sh

2. Fill in the fields as requested:

Field	Description	Required / Optional
Hostname	Name of VM	Required
IDScope	Can be copied from the Azure IoT Hub Device Provisioning Service	Required
DeviceID	Same as Hostname, which is the name of VM	Required
Symmetric key	Can be copied from the individual enrollment in DPS	Required
Default Username	Your default username	Required
Public SSH key	Public SSH key, if set up	Optional
Static IP	Y	Required
Static IPv4 Address	The assigned IP address of the original VM	Required
Subnet Mask	The subnet mask of the network. Can be found by typing ipconfig /all in the Hypervisor cmd line. Make sure to use the prefix notation.	Required
Gateway	Can be found by typing ipconfig /all in the Hypervisor cmd line.	Required
Nameservers	The DNS server names can be found by typing ipconfig /all in the Hypervisor cmd line.	Required
Proxy address	Proxy server address	Optional

3. The VM will now restart and install the required applications and settings. Wait until the machine has restarted a second time.

4. You can now log in with the username you set over SSH. Upon first login, you will have to specify a new password as no password is set. You will be logged out as the new password is set, but due to certificate login, you no longer need the password to log in.