Microsoft HyperV Deployment Guide

This deployment guide contains information on deploying, interacting, and configuring the Qualys Gateway Service (QGS) HyperV in the Windows environment. This document outlines the steps required to set up a Centralized Appliance Management Service (CAMS) Qualys Gateway Service (QGS) appliance for Microsoft HyperV. This process includes the installation of the VHD file locally using the Hyper-V Manager application in the Windows environment.

To learn more about the QGS application and its features, refer to the Qualys Gateway Service User Guide.

Pre-requisites

• To get the latest version of QGS image, you need access to Qualys Cloud Platform.
• Ensure to cover the minimum system requirements recommended in the Qualys Gateway Service User Guide.

Virtualization Server Requirements and Virtual Machine File Formats

The supported server versions and file formats are listed below. To successfully launch the appliance on your virtual machine, ensure you comply with these versions.

QGS HyperV Deployment Process

This section outlines the step-by-step process for deploying Qualys Gateway Services on Microsoft HyperV.

1. Log in to the Qualys Cloud Platform.
2. Navigate to the Qualys Gateway Service app menu by selecting it from the application selector drop-down.
   
3. Download the VHD zip file to your local computer.
   
4. Extract the zip file and save its contents to the local disk.
5. Launch the Hyper-V Manager.
6. Right-click on the Hyper-V system within the Hyper-V Manager, then navigate to New > Virtual Machine.
   

   The New Virtual Machine Wizard is displayed.

7. On the Before You Begin page, click Next.

   

8. From the left pane, select the Specify Name and Location category, then provide the name for the Hyper-V appliance.
9. Click Next.

   

10. Choose Generation 1 on the Specify Generation page, then click Next.
    
11. Enter a minimum of 16 GB of startup memory in the Startup memory field on the Assign Memory page, and click Next.
    
    Note: If the server version is Windows 10/11, you must deselect the ‘Use Dynamic Memory for this virtual machine’ checkbox.
12. Select the appropriate network from the Connection drop-down on the Configure Networking page, and click Next.
    
13. Select the Use an existing virtual hard disk option on the Connect Virtual Hard Disk page.
14. Browse to the VHD location extracted in Step 3.
15. Click Next.
    
16. On the Completing the New Virtual Machine wizard page, verify all details listed in the Summary section, and click Finish.
    
17. Go to Hyper-V Manager and select created Hyper System.
    
18. Once the Appliance system gets created, go to the appliance from Hyper-V Manager, right-click, and select the Settings option.
    
19. Go to the Processor field and add the Number of Processors as >=2.
20. Click Apply and then click OK.
    
21. Once the configuration is saved, right-click on the Hyper-V system and select Connect.
    
22. Once the Hyper-V system is connected, click the Start button to start your appliance.
    

For details on the configuration screens of the appliance, refer to the ‘Configuration Screens’ section of the Qualys Gateway Service User Guide.

Connecting Secondary Disk Using Patch Mode

Below are the steps for connecting the secondary disk to the QGS appliance for using Patch Mode.

1. Go to Hyper-V manager and select QGS appliance.

   Note: The appliance must be in a shutdown state to attach a secondary drive. If the appliance is powered on, you must shut it down before attaching the secondary drive.

2. Right-click on the appliance and select the Settings option.
   
3. Navigate to IDE controller 0 > Hard Drive > and click Add.
   
4. Click New.
   
5. Click Next on the Before You Begin page.
   
6. Select the VHD option from the Choose Disk Format page and click Next.
   
7. Select the Fixed size option from Choose Disk Type and click Next.
   
8. Enter the secondary drive name and location to create a new hard disk on the Specify Name and Location page and click Next.
   
9. On the Configuration Disk page, select the Create a new blank virtual hard disk option, add a minimum 250 GB size, and click Next.
   
10. Verify the details on the Completing the New Virtual Hard Disk wizard and click Finish.
    The creation of the secondary drive may take some time.
    
11. Once the disk is created, click Apply and then click OK.
    
12. Verify that the secondary disk is attached properly by right-clicking on the appliance in Hyper-V Manager and selecting the Settings option.
    
13. Once you verify that the secondary disk is attached properly, connect and start the appliance.