Set up external and internal scans
      Back to home
      1. Knowledge Base
      2. Set up and manage scans
      3. Set up external and internal scans

      Install an Autobahn Fit Cloud Agent on Windows

      This guide will instruct you on how to install a Qualys Cloud Agent on Windows to run internal scans through Autobahn Fit

      Table of content

      1. Installation requirements
      2. Request the Agent installer
      3. Download the Agent installer
      4. Installation steps for .exe based package
      5. Installation steps for MSI based package

      1. Installation requirements

      To install a Cloud Agent on Windows, you must have Local or Domain administrator privileges on your hosts. Proxy configuration is supported.

      The following are minimum system requirements:

      • 512 MB of RAM for scan-based features such as Inventory, Vulnerability Management (VM), and Policy Compliance (PC).

      • 1 GB of RAM for File Integrity Monitoring (FIM) and Patch Management (PM).

      • For system requirements with Endpoint Detection and Response (EDR), refer to the Qualys EDR Onboarding Guide.

      • Minimum 200 MB of available disk space.

      2. Request the Agent installer

      Before starting, obtain the Cloud Agent installer file from your Customer Success Manager. Once obtained, proceed with the installation on your system.

      If you encounter any difficulties during the process, feel free to contact us for further assistance.

      3. Download the Agent installer

      After the Customer Success Manager shares the Agent installer, you need to download the file.

      1 - Once the Agent installer is downloaded to your local system, in the UI you will see the associated Activation key ID and Customer ID.

      2 - Copy and paste the Activation key ID and Customer ID to a safe place, you will need it later to complete the installation.

      4. Installation steps for .exe based package

      Steps to install Agents

      1 - Copy the Cloud Agent installer onto the host where you want to install the agent.

      2 - Run the command or use a systems management tool to install the agent as per your organization's standard process to install the software.

      > QualysCloudAgent.exe 
      CustomerId={xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx} 
      ActivationId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
      WebServiceUri=<platform_url>/CloudAgent/

      Steps to install an Agent with Proxy Support

      You can provide a default proxy configuration as an argument at the time of agent installation. The proxy parameters can be passed through the Proxy argument, where, Proxy="<argument-to-pass>".

      The proxy argument contains proxy URL, corresponding user name, and password.

      QualysCloudAgent.exe 
      CustomerId={xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx} 
      ActivationId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} 
      WebServiceUri=<platform_url>/CloudAgent/ Proxy="/u <proxy url> /n
      <proxy username> /p <proxy password>"

      You can also pass multiple proxies, separated by semi-colon, as an argument during agent installation.

      QualysCloudAgent.exe CustomerId={xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx} ActivationId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}
      WebServiceUri=<platform_url>/CloudAgent/ Proxy="/u <1st proxy
      url>;<2nd proxy url> /n <proxy username> /p <proxy password>"

      Please note that multiple proxy user names and proxy passwords are not supported.

      Steps to install Agent on Golden images

      If the GoldenImage=true is passed as a parameter during installation, the agent will be installed in a non-running state, hence, without the HostID in the registry. The agent is started after the machine reboots or the agent service is manually started, and then, the HostID is generated by the agent.

      Run the command or use a systems management tool to install the agent into Golden images as per your organization's standard process for installing software.

      > QualysCloudAgent.exe 
      CustomerId={xxxxxxxx-xxxx-xxxxxxxxxxxxxxxxxxxx} 
      ActivationId={xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx} 
      WebServiceUri=<platform_url>/CloudAgent/
      GoldenImage=true

      5. Installation steps for MSI based package

      Extracting MSI Package

      To extract MSI from the downloaded .exe file, run the following command:

      QualysCloudAgent.exe ExtractMSI=

      For ExtractMSI, use the following values (value) as per host architecture.

      For example, if you want to install the cloud agent on 64-bit machine, you need to extract MSI package with the value for ExtractMSI=64.

      • 32: Extracts 32-bit MSI Installer

      • 64: Extracts 64-bit MSI Installer

      • BOTH: Extracts both (32-bit and 64-bit) the MSI Installers

      • AUTO: Extracts the appropriate MSI based on the OS architecture. It extracts 32-bit MSI on a 32-bit machine and 64-bit MSI on a 64-bit machine

      The MSI file will be extracted in the same directory where .exe file is available.

      Installing MSI Package

      1 - Copy the Cloud Agent installer onto the host where you want to install the agent

      2 - Run the command or use a systems management tool to install the agent as per your organization's standard process for installing software.

      Following is the sample command for installing the MSI package with a 32-bit installer:

      Msiexec.exe /i 
      CloudAgent_x86.msi 
      CustomerId={12345678-1234-1234- 1234-123456789012} 
      ActivationId={12345678-1234-1234-1234- 123456789012} 
      WebServiceUri=/CloudAgent/

      Here CloudAgent_x86.msi is the extracted MSI file for the 32-bit installer.