Red Hat OpenShift Deployment Guide

This deployment guide contains the information for deploying, interacting, and configuring Centralized Appliance Management Service (CAMS) QGS Appliance on Red Hat OpenShift.

Prerequisites

• You need an active Red Hat OpenShift account to set up CAMS QGS.
• Ensure to cover the minimum system requirements recommended in the Qualys Gateway Service User Guide.

Steps to Configure the CAMS Appliance

1. Steps to Deploy CAMS/QGS on OpenShift
2. Add a Secondary Hard Disk to use Patch Mode

Steps to Deploy CAMS/QGS on OpenShift

1. Select the target project and verify that sufficient resources are available to deploy the CAMS/QGS appliance. For system requirements, see the QGS User Guide.
2. Navigate to Storage > PersistentVolumeClaims.
   
3. Click Create Persistent Volume Claim, and then select With data upload form.
   
4. Select your project.
   
5. Upload the CAMS/QGS image by clicking Upload.
6. Enter a name for the Persistent Volume Claim.
7. Select the appropriate storage class.
8. Specify a disk size of 50 GB. Refer to the QGS User Guide for supported configurations.
9. Click Upload to begin the upload process.
   
10. The upload starts and the PVC creation progress page is displayed.
    
11. Click View PVC details.
    
12. The PVC status initially appears as Pending. PVC creation can take approximately 2–3 hours.
    
13. When creation completes, the PVC status changes to Bound.
    
    
14. Navigate to Virtualization > Virtual Machines.
    
15. Click Create, and then select From template.
    
16. Select the Red Hat Enterprise Linux 7 template, or another supported RHEL template.
    
17. Set the disk source to PVC (Clone PVC).
18. Select the project that contains the PVC.
19. Select the previously created PVC.
    
20. Configure the virtual machine with 4 CPUs and 16 GB RAM. Refer to the QGS User Guide for supported configurations.
    
    
21. Configure networking according to your environment. For required ports, URLs, and network prerequisites, see the QGS User Guide.
22. Enter a name for the QGS appliance.
23. Click Quick create Virtual Machine, or select Customize Virtual Machine to modify settings before creation.
    
24. The VM is created and transitions from Provisioning to Running.
25. Access the text-based UI by using the VNC console or Serial console. Select the VM, then choose Console.

or

Add a Secondary Hard Disk to use Patch Mode

This section explains how to attach a secondary data disk to an existing QGS virtual machine.

1. Select the QGS appliance and open the Overview tab.
2. Scroll down and select Storage.
   
3. Click Add, and then select Empty Disk (Blank).
4. Enter a name for the secondary disk.
5. Specify a disk size of 150 GB. Refer to the QGS User Guide for supported configurations.
6. Set Type to Disk.
7. Select the disk interface (for example, VirtIO).
8. Select the appropriate storage class (for example, gp3-csi), and then click Save.
9. Wait for the disk to be created and attached to the appliance.
   
10. Verify that the secondary disk appears with an attached status.

If the secondary disk is attached after appliance registration, reboot the appliance to ensure the disk is detected. After the reboot, allow several minutes for the system to initialize.