Hyper-V

How to deploy a prebuilt Hyper-V VM agent

This article contains a few tips and tricks on how to deploy a pre-built Hyper-V virtual machine image to a Hyper-V host.

Get your pre-built Hyper-V image

  1. Download the Hyper-V image from here:
    https://domotz-vm-images-temp.s3-eu-west-1.amazonaws.com/Ubuntu_20.04_Domotz_Agent_2.5.9-3.1.0-b001_HyperV.zip
  2. Unzip it in a location of your choice.

Deploy the VM

1. Open the Hyper-V Manager > Click on Action > Import Virtual Machine…:

Hyper-V screenshot 1

2. Browse and choose the folder where you extracted the VM Image:

Hyper-V screenshot 2

3. Select the VM image:

Hyper-V screenshot 3

4. Select “Copy the virtual machine (create a new unique ID)”:

Hyper-V screenshot 4

5. Select the location where you want to save the VM and the location for its virtual Disks:

Hyper-V screenshot 5
Hyper-V screenshot 6

6. Click on finish.

7. Once the VM is imported make sure the VM is connected to the correct virtual switch configured in bridge mode. By doing this the VM will be able to get a valid IP Address on the network:

Hyper-V screenshot 7

8. Start the VM. 

To login and see the current IP address use the following credentials:

User: domotz
Password: domotz

9. At the command prompt run command “ifconfig”, the current IP Address will be shown.

10. Activate the agent from a browser access the VM IP address (which you discovered by issuing the ifconfig command) on its port 3000.

For example, http://192.168.1.104:3000

Updated on November 18, 2021

Was this article helpful?