Canaries aren't just hardware devices. You can run Canaries inside your Microsoft Hyper-V infrastructure, using the same console as the rest of your Canary fleet.
Follow the steps below to create your Hyper-V Canary.
Note: Hyper-V Canaries are only supported on our new interface. We will enable the new interface for you when you request Hyper-V Canaries, if you have not already got it enabled.
Step 1: Login to your console
Browse to your Console's URL and login with your credentials:
Step 2: Select your destination Flock
Browse down to the list of Flocks, and click on the Flock you want to deploy this new Hyper-V bird into:
Step 3: Download the Hyper-V VM:
In the modal which pops up, click Hyper-V, then Download, then Zip:
This starts a download in your browser:
Step 4: Move the Zip file to the Hyper-V server
Using the file transfer mechanisms at your disposal, copy the downloaded Zip file to your Hyper-V server.
Step 5: Unpack the Zip file on the Hyper-V server
Login to the Hyper-V Server's console, and unpack the Zip file. In our example below, the commands are run as the Administrator user, and the downloaded file was called Hyper-VCanary_1d94b56_Template.zip. The filename can change, so be sure to use the filename you downloaded in the commands below.
You can use this Powershell line to unpack the file, or use a graphical tool:
Expand-Archive -Force -LiteralPath Hyper-VCanary_1d94b56_Template.zip -DestinationPath C:\Users\ Administrator\Hyper-V-Canary
Step 6: Find the path to the .vmcx file
Since the filenames may be different, discover the Virtual Machine's description file with this Powershell:
dir ".\Hyper-V-Canary\Hyper-VCanary-*\Virtual Machines\*.vmcx" Directory: C:\Users\Administrator\Hyper-V-Canary\Hyper-VCanary-2.3.2-1d94b56\Virtual Machines Mode LastWriteTime Length Name ---- ------------- ------ ---- -a---- 2/10/2020 2:14 PM 57238 5C7CEAD8-609B-4CB8-9A7A-B2DFDA2ADB1A.vmcx
Putting together the Folder path and filename, this is the full path to the .vmcx file:
Step 6: Import the Virtual Machine
Using either the Hyper-V Manager or this Powershell snippet, import the Virtual Machine (the path to the .vmcx file was found above in Step 6):
Import-VM -Path 'C:\Users\Administrator\Hyper-V-Canary\Hyper-VCanary-2.3.2-1d94b56\Virtual Machines\5C7CEAD8-609B-4CB8-9A7A-B2DFDA2ADB1A.vmcx'
Step 7: Confirm the import and name
Using Powershell, run Get-VM to confirm the VM imported correctly, and to find out the VM's name:
Get-VM Name State CPUUsage(%) MemoryAssigned(M) Uptime Status Version ---- ----- ----------- ----------------- ------ ------ ------- Hyper-VCanary-2.3.2-1d94b56 Off 0 0 00:00:00 Operating normally 9.0
Step 8: Start the Virtual Machine
With the VM imported, the next step is to start it up. You can use the Hyper-V Manager, or this Powershell with the name recovered from Step 7:
Start-VM -Name Hyper-VCanary-2.3.2-1d94b56
Step 9: Commission your bird
Switch back to your Canary Console, and commission the bird into the flock of your choice.