Installing the VM in Hyper-V

How to Create a Hyper-V Virtual Machine

Note: This method of conversion has not been fully tested, and at this time we do not fully support it.

Currently, EmcienScan provides a virtual machine .ova file as the method to deploy the software, which are then typically imported using VMware or VirtualBox.  However, customers operating in a Hyper-V environment require a different file type to create their VM.  The Hyper-V compatible file types are VHD and VHDX.  The good news is that this is a common scenario and there are tools available to create the properly formatted file, as well as a wealth of information on the internet to help resolve any challenges you may encounter.

 

The ova file is actually a tar file that consists of an ovf and a VMDK.  The ovf is an XML based file that describes the contents of the package along with the VM’s properties (network configuration, virtual hardware configuration, etc).   The VMDK is the disk image that gets converted to a VHD or VHDX disk image.   Below are the steps the Emcien team followed to create a working Hyper-V Scan VM.  Since we regularly use VirtualBox, we utilized the VBoxManage.exe tool to perform the V2V conversion.

 
  1. Create the VHD file

    1. Extract the disk image from the Emcien Scan ova file

      1. Rename the emcien-scan-1-5.ova to have a .tar extension

      2. Using your preferred archive/compression tool, open the .tar file and extract the .vmdk file

    2. Convert the VMDK disk image to a VHD disk image

      1. From your Windows machine command prompt, navigate to the location of your VirtualBox installation.

      2. Type the following command:  VBoxManage.exe clonehd --format vhd <path to your scan disk image>\emcien-scan-1-5-disk1.vmdk <path to your scan disk image>\emcien-scan-1-5-disk1.vhd

      3. Once the process completes (indicated by 100% progress), confirm that there is now an emcien-scan-1-5-disk1.vhd file in the same location as your emcien-scan-1-5-disk1.vmdk file.

 
  1. Create a NAT network connection for your Hyper-V virtual machine

    1. Open your Hyper-V Manager

      1. Select Virtual Switch Manager

      2. Select Internal to create an internal virtual switch.  (Note that you must select Internal)

      3. Click the “create virtual switch button”

    2. Enable the NAT connection

      1. Open your computer’s Network Connections.

      2. Select the host network adaptor that your computer is using to gain access to the internet, and right click to view “properties”.

      3. Open the “Sharing” tab.

      4. Check the first checkbox: “Allow other network users to connect through…”.

      5. Select the Internal virtual switch that you just created.  Note that it will be named as follows “vEthernet (name_you_gave_the_switch)”    

      6. Click Settings and check the following two boxes

        1. Secure Web Server (HTTPS)

        2. Web Server (HTTP)

      7. Click OK

      8. Your Host network adapter should now display as “shared”

  2. Create the virtual machine

    1. Open your Hyper-V Manager and click New → Virtual Machine

    2. Respond to the prompts to create the virtual machine

      1. Give it a name and either allow the VM to be stored in the default folder or enter your predefined virtual machine folder.

      2. Select Generation 1

      3. Enter the amount of memory you want to allocate to your VM.  The minimum Emcien recommends to operate the VM is 2048 MB (2 GB).  Please refer to the Emcien Scan KB (www.scan-support.com/help/installing-on-a-vmware-virtual-machine) for guidelines on VM memory requirements

      4. Configure networking to connect to the Internal Virtual Switch that you created in Step II-A

      5. On the Connect Virtual Hard Disk page, select the second option “Use an existing virtual hard disk”, and enter the location of your emcien-scan-1-5-disk1.vhd file.

      6. Verify your selections and click “Finish”

    3. Configure the settings for the newly created VM

      1. Open the VM Settings in Hyper-V Manager and select “Processor”

      2. Select the number of processors you want to allocate to your VM, using the Emcien provided guidelines at http://www.scan-support.com/help/installing-on-a-vmware-virtual-machine

      3. Either leave other settings in the default state or make changes accordance to your organization’s policies

  3. Start the VM

    1. Select “Connect” in hyper-V Manager to open the VM console

    2. Select “Start” in hyper-V Manager to boot up the VM

    3. Once the VM has fully booted, the console will display the ip address for your VM.  Browse to that ip address to log into the Scan application.

    4. For instructions on logging into the VM pease refer to “Step 4: Launching the Emcien Scan VM” in the KB article titled “Installing on a VMware Virtual Machine” (http://www.scan-support.com/help/installing-on-a-vmware-virtual-machine)