Auto-Deploy: VMware vSphere
Use automatic deployment to have the toolkit provision the replacement scanner VM on VMware vSphere for you as part of the replacement.
To deploy the replacement scanner VM on VMware vSphere automatically:
- Select VMware vSphere as the target platform.
- Check Deploy for me.
- Complete the deployment form, described in the following tables.
vCenter Connection
Provide the vCenter Server connection details:
|
Field |
Description |
|---|---|
|
vCenter Host/URL |
vCenter server hostname or IP address, for example vcenter.example.com. |
|
Username |
vCenter username, for example [email protected]. |
|
Password |
vCenter password. |
|
vCenter certificate |
How the toolkit checks the vCenter's TLS certificate: Verify, Trust this vCenter's certificate, or Don't verify. See vCenter certificate below. |
vCenter certificate
Every connection to vCenter checks the server's TLS certificate in one of three modes (the vCenter certificate selector under the password field):
- Verify (public or company CA) — default. The certificate chain must verify against the system CA bundle and match the host you connect to.
- Trust this vCenter's certificate — for vCenters using a self-signed certificate or an internal VMware CA (VMCA). Click Fetch certificate; the toolkit connects to the vCenter, shows the certificate's subject, issuer, validity, and SHA-256 fingerprint. Compare the fingerprint with the one shown in vCenter (Administration → Certificates) or ask your vCenter administrator, then click Trust. The certificate — public data, not a credential — is remembered per vCenter host and survives reconnects; you can remove it any time with Remove.
- Don't verify (not recommended) — skips certificate checks. Your vCenter password could be intercepted on the network; use only as a last resort.
Trusted certificates are stored with the toolkit's data (the data directory); they are public information, not credentials.
Notes:
- The host you connect to must match the certificate's names. If the certificate is issued for vcenter.example.com, connect using that FQDN — not its IP address.
- ESXi hosts: trusting the vCenter's CA certificate (VMCA root) also covers ESXi hosts whose certificates it signed. If a deployment fails verifying an ESXi host certificate, trust the VMCA root (the fetch step offers it when the vCenter presents it) or use Don't verify.
- No certificate copying is required — the fetch and trust buttons do it for you. A Paste certificate (PEM) option exists if you already have the PEM from your administrator.
- Credentials remain in memory only; they are never persisted or logged.
OVA Source
Specify where the toolkit finds the qVSA OVA file:
|
Field |
Description |
|---|---|
|
Source |
URL – download the qVSA OVA file from a remote server, Local – use a file mounted in the container, or Content Library – clone from a vSphere Content Library item. |
|
OVA Path (URL) |
Full URL to the qVSA OVA file. |
|
OVA Path (Local) |
Path to the OVA file inside the container, for example /app/qvsa/qVSA.x86_64-4.2.21-1.ova. |
|
Content Library |
Name of the vSphere Content Library containing the qVSA OVF template. |
|
Content Library Item |
Name of the OVF template item within the Content Library, exactly as shown in the library (for example, qVSA.x86_64-4.<version>). |
Mount your OVA file as a volume and select Local to avoid large downloads on every deployment. If your qVSA OVF template is already imported into a vSphere Content Library, select Content Library and provide the library name and item name instead—the toolkit validates both exist before deployment starts and clones the VM directly from the library item, which is typically faster than importing an OVA file.
Network Configuration
Configure the network settings for the new VM:
|
Field |
Description |
|---|---|
|
Datacenter |
vSphere datacenter name. |
|
Cluster |
Compute cluster name. |
|
Datastore |
Target datastore for the VM. |
|
ESXi Host |
Target host. Optional if a cluster is specified. |
|
LAN Network |
vSphere port group or network for the LAN interface. |
|
WAN Network |
Port group for the WAN interface. Optional. |
|
Enable WAN |
Check to enable the WAN interface. |
|
LAN IP / Gateway / Netmask / DNS |
Static network settings. Optional—leave blank to use DHCP. |
|
LAN VLAN |
VLAN ID. Optional. |
|
IPv6 Only |
Check for an IPv6-only deployment. |
|
HTTP Proxy |
Proxy URL for scanner appliance-to-Qualys communication. Optional. |
|
User Data |
Cloud-init user data. Optional. |
VM Sizing
For VM sizing recommendations, see Qualys Scanner Appliance Sizing.
How It Works
The toolkit uses Terraform to import the OVA file and provision the VM with the network settings, sizing, and activation code you specified. It runs the deployment in a temporary workspace and cleans up automatically once the VM is provisioned.