Installation Steps for .msi Package

Installation Requirements

To install a .msi Cloud Agent installer on your target host, you need a .exe Cloud Agent installer package with its associated Activation ID and Customer ID. Follow the installation steps on the Cloud Agent user interface to get everything you need.

Cloud Agent requirements

Extracting MSI Package

Run the following command to extract the .msi package from the downloaded .exe package.

QualysCloudAgent.exe ExtractMSI=<value>

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

For example, if you want to install a Cloud Agent on a 64-bit machine, you need to extract the .msi package with the value 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 package  on the OS architecture. It extracts a 32-bit .msi package on a 32-bit machine and a 64-bit .msi package on a 64-bit machine.

The .msi file is extracted in the same directory where the .exe file is available.

The 32-bit .msi Cloud Agent installer are specifically designed for x86 Windows platforms. The 32-bit .msi Cloud Agent installers does not work for other platforms such as, x64 Windows platforms.

Installing MSI Package

Copy the Qualys Cloud Agent installer onto the host where you want to install the Cloud Agent. To install the Cloud Agent on your host system, run the following command or use a systems management tool as per your organization's standard process. Following is the sample command for installing .msi package for 32-bit installer:

Cloud Agent Installation Command

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

Where, CloudAgent_x86.msi is extracted .msi file for 32-bit installer.

The installation commands used in this document are only for illustration. Do not use these commands as it is. Replace the placeholders used in the commands with proper parameters.

Installing FedRAMP Compliant Build

Use the following command to install the FedRAM Compliant Build:

Installation Command for FedRAMP Compliant Build

  Msiexec.exe /i CloudAgent_x86.msi CustomerId={12345678-1234-1234-1234-123456789012} 
  ActivationId={12345678-1234-1234-1234-123456789012} WebServiceUri=https://qualysguard.gov1.qualys.us/CloudAgent/FEDRAMP=true

FedRAMP-compliant Cloud Agents can be installed only on the GOV1 Platform (https://qualysguard.gov1.qualys.us/). These agents are not supported for other Qualys platforms.

Steps to Install Cloud 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 the proxy URL, corresponding username, and password.

The following command shows how to pass proxy configuration in the installation command.

Command to Configure Single Proxy

Msiexec.exe /i CloudAgent_x86.msi CustomerId={12345678-1234-1234-1234-123456789012} 
ActivationId={12345678-1234-1234-1234-123456789012} 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.

Command to Configure Multiple Proxies

Msiexec.exe /i CloudAgent_x86.msi CustomerId={12345678-1234-1234-1234-123456789012} 
ActivationId={12345678-1234-1234-1234-123456789012} WebServiceUri=<platform_url>/CloudAgent/ 
Proxy="/u <1st proxy url>;<2nd proxy url> /n <proxy username> /p <proxy password>"
  

Multiple proxy user names and proxy passwords are not supported.