Installation Steps for .exe Package
Installation Requirements
To install Cloud Agent, you must have an associated Activation ID and Customer ID for the agent installer package. To get these details, log in to the Qualys Cloud Platform, and in the Cloud Agent user interface, follow the installation steps for Windows (.exe) to get everything you need.
Steps to Install Cloud Agent
Following are the steps to install Cloud Agent on the host asset.
- Once downloaded, copy the Cloud Agent installer on the target host.
- Run the following command in the Command Prompt (with elevated privileges) to install Cloud Agent.
> QualysCloudAgent.exe CustomerId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} ActivationId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} WebServiceUri=<platform_url>/CloudAgent/ FEDRAMP={true|false}
Where,
FEDRAMP={true|false} is the variable to specify the FedRAMP Compliant build.
- You can also install a Cloud Agent on target hosts using the system management tool.
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.
Installation Command for FedRAMP Compliant Build
Use the following installation command to install the FedRAMP Compliant Build:
QualysCloudAgent.exe ACTIVATIONID={xxxxxxx-xxxx-xxxx-xxxxxx} CUSTOMERID={xxxxx-xxx-xxx-xxx-xxx-xxxxx} WEBSERVICEURI=https://qualysguard.gov1.qualys.us/CloudAgent/FEDRAMP=true
Where,
FEDRAMP={true|false} is the variable to specify the FedRAMP Compliant build.
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.
QualysCloudAgent.exe CustomerId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} 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-xxxx-xxxxxxxxxxxx} ActivationId={xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx} 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.