Cloud Agent Installation Steps

Perform the following steps to install the Cloud Agent on a host asset.

1. Copy the downloaded Cloud Agent installer package on a host asset.
2. Run the following installation command in the command prompt with root privileges (For x64). The installation command may vary depending on the type of installer package (x64 or ARM64).

   For Linux (.rpm) Package

   
   sudo rpm -ivh qualys-cloud-agent.x86_64.rpm 
   sudo /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx CustomerId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ServerUri=<qualys_pod_url>/CloudAgent
         

   For Linux (.deb) Package

   
   sudo dpkg install qualys-cloud-agent.x86_64.deb
      
   sudo /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx CustomerId=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx ServerUri=<qualys_pod_url>/CloudAgent 
         

   In the above commands, the values for Proxy, ActivationID, CustomerID, and ServerUri parameters are only placeholders. Replace these values with the respective correct values for your account.

 For RPM-based packages, if you do not import the GPG signing key, the NOKEY warning is displayed during installation. Refer to Cloud Agent Package Integrity to learn more about the GPG signing key.

How to Install FedRAMP-compliant Build

Use the following commands to install FedRAMP-compliant Cloud Agent. 

For Linux (.rpm) Package

rpm -ivh qualys-cloud-agent.rpm; echo "qualys_https_proxy=http://10.113.194.54:3128" >> /etc/sysconfig/qualys-cloud-agent; /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxx-xxxxx-xxxxx-xxxx CustomerId=xxxx-xxxxx-xxxxx-xxxx ServerUri=https://qualysguard.gov1.qualys.us/CloudAgent /FEDRAMP=true

For Linux (.deb) Package

dpkg --install QualysCloudAgent.deb; echo "qualys_https_proxy=http://10.113.194.54:3128" >> /etc/default/qualys-cloud-agent; /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxx-xxxxx-xxxxx-xxxx CustomerId=xxxx-xxxxx-xxxxx-xxxx ServerUri=https://qualysguard.gov1.qualys.us/CloudAgent/FEDRAMP=true

In the above commands, the values for Proxy, ActivationID, and CustomerID parameters are only placeholders. Replace these values with the respective correct values for your account.

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. 

Consolidated Installation and Configuration Command

The following are the consolidated commands for Cloud Agent installation and configuration. You can use these commands to install Cloud Agent, configure the proxy, and provision the Cloud Agent.

For Linux (.rpm) Package

rpm -ivh qualys-cloud-agent.rpm; echo "qualys_https_proxy=https://[<username>:<password>@]<host>[:<port>]" >> /etc/sysconfig/qualys-cloud-agent; /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxx-xxxxx-xxxxx-xxxx CustomerId=xxxx-xxxxx-xxxxx-xxxx ServerUri=[<qualys_platform_url>/CloudAgent/]
      

For Linux (.deb) Package

dpkg --install QualysCloudAgent.deb; echo "qualys_https_proxy=https://[<username>:<password>@]<host>[:<port>]" >> /etc/default/qualys-cloud-agent; /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=xxxx-xxxxx-xxxxx-xxxx CustomerId=xxxx-xxxxx-xxxxx-xxxx ServerUri=[<qualys_platform_url>/CloudAgent/]
  

 The configured proxy applies only to Cloud Agent communication.

The following table lists the parameters used in the above commands.

Parameter	Description
Cloud Agent Installer (qualys-cloud-agent.rpm / QualysCloudAgent.deb)	Replace this placeholder value with the correct Cloud Agent installer name available on your machine.
qualys_https_proxy	Use this parameter to specify the proxy for Cloud Agent. You can provide user credentials, host details, and proxy port while configuring the proxy.
ActivationId	Provide the activation for your account.
CustomerId	Provide the customer ID for the subscription.
ServerUri	Provide the Qualys platform URL for your account. Refer to Identify your Qualys Platform to know your platform URL.