Launch QVSA in Oracle Cloud via OCI CLI Tool
The following OCI CLI command is used to create an instance in Oracle Cloud Infrastructure:
oci compute instance launch [OPTIONS]
Required Parameters
|
Parameter |
Data Type |
Description |
|---|---|---|
| availability-domain |
text |
Tag name assigned to a web application. |
| compartment-id, -c | text | The OCID of the compartment. |
| shape | text | The shape of an instance. The shape determines the number of CPUs, amount of memory, and other resources allocated to the instance. |
| display-name | text | A user-friendly name. Does not have to be unique, and it is changeable. Avoid entering confidential information. |
| image-id | text | The OCID of the image used to boot the instance. |
| subnet-id | text | The OCID of the subnet where the VNIC attached to this instance is created. |
| user-data-file | filename | A file containing PERSCODE and Proxy Server configuration. PERSCODE and PROXY_URL must be placed on separate lines in a text file.
Using a Proxy to connect your Qualys Scanner to Qualys Cloud is optional.
The content of the file should look like:
|
| instance-options | complex type |
This is a complex type whose value must be valid JSON. The value can be provided as a string on the command line or passed in as a file using the file://metadatav2.json syntax. Example: # cat metadatav2.json |
The '--user-data-file' option includes PERSCODE and Proxy server configuration, which must be specified on separate lines.
Example of Launching a Qualys Scanner via OCI CLI
oci compute instance launch --availability-domain "Lhkx:US-ASHBURN-AD-1" -c ocid1.compartment.oc1..aaaaaaaaj6vzcb4ycwussogxfxqwn2v6cpy2em5nygfckkj7ftveengh2xoq --shape "VM.Standard1.1" --display-name "qualys-scanner" --image-id ocid1.image.oc1.iad.aaaaaaaappeu6n3of7gnckw5nkubfwrotm4ef2ytu4yetlobztkh5wcuwrza --subnet-id ocid1.subnet.oc1.iad.aaaaaaaa4iegkvmt6lkk2zhcaxwocuhnc2lxenwsa32vq7zbib4dgu2pslvq --user-data-file scanner_user_data.txt--instance-options file://metadatav2.json
For more information on launching compute instances in Oracle Cloud Infrastructure, refer to the OCI CLI Command Reference document.
When deploying the Qualys Virtual Scanner Appliance, choose an instance type that provides a CPU-to-RAM ratio of either 1:2 (for example, 4 CPUs with 8 GB of RAM) or 1:3, based on the available instance types on your cloud platform.
The optimal instance size depends on your specific scanning requirements. It is important to consider factors such as the frequency of scans and the number of virtual machines you plan to scan. If needed, you can increase the instance size to better accommodate your workload.
The minimum instance size supported for a Qualys scanner using the qVSA image version 4.1 or higher is at least 2 GB of RAM.