Installation steps

Use the following steps to install Qualys Cloud Agent on your Gentoo Linux host:

1. Download the Qualys Cloud Agent package (.tar.gz) for your Gentoo Linux host. Refer to Download Cloud Agent Package.
2. Extract the downloaded Qualys Cloud Agent package on your host using the following command:
   tar -vxf <qualys-cloud-agent-package>
   
   For example,
   tar -vxf QualysCloudAgent.tar.gz
3. The extracted Cloud Agent package contains a shell script file. Run this shell script file in the command prompt using the following command. This creates a repository to install Cloud Agent.
   ./<shell script file name>
   
   For example,
   ./qagent_install.sh
4. Go to the Qualys Cloud Agent directory using the following command.
   cd /var/db/repos/qualys/app-misc/qualys-cloud-agent
5. Create a manifest file in the Cloud Agent Cloud Agent repository using the following command. This manifest file contains the required hashes and ebuild file required agent installation.
   ebuild <Cloud Agent Directory Path>-<Agent Version>.ebuild digest
   
   For example,
   ebuild qualys-cloud-agent-6.0.0.8.ebuild digest
6. Install Qualys Cloud Agent on your Gentoo Linux host using the following command.
   emerge -av <Cloud Agent Binary>
   
   For example,
   emerge -av qualys-cloud-agent
7. Provision the Qualys Cloud Agent to connect with Qualys Cloud Platform.
   sudo <Shell Script Path> ActivationId=<activation_id> CustomerId=<customer_id> ServerUri=<server_uri>
   
   For example,
   sudo /usr/local/qualys/cloud-agent/bin/qualys-cloud-agent.sh ActivationId=1a34b567-8cd9-1ef2-34g5-678h9a1b2c34 CustomerId=1a234567-bcd8-e9f1-23gh-4a5b678c91d2 ServerUri=https://qagpublic.qg1.apps.qualys.com/CloudAgent

   Parameter	Description
   ActivationId	Activation-ID for the Qualys Cloud Agent. This is auto-generated and required to access Cloud Agent services.
   CustomerId	Qualys subscription’s Customer ID.
   ServerUri	https://qagpublic.qg1.apps.qualys.com/CloudAgent The Server URI is associated with your subscription. You can see it on the Cloud Agent user interface while downloading a Cloud Agent package.

8. Check the status of an installed Cloud Agent using the following command.
   qlist -Iv | grep qualys

 If Cloud Agent can not connect to the Qualys Cloud Platform, it does not show any status, and you may need to troubleshoot the Cloud Agent to resolve this issue.

Cloud Agent Log Collection

Once the Cloud Agent is provisioned, it connects to the Qualys Cloud Platform and starts syncing the agent host data. You can see your first asset discovery results within a few minutes. The first assessment scan in the Qualys Cloud Platform takes some time; after that, scans are completed as soon as new host metadata is uploaded to the Qualys Cloud Platform.