Step-by-step guide to generate a CSR, sign it with VMCA, and install vCenter CA certificates on a vSphere Replication appliance.
How to Install vCenter CA Certificates on a vSphere Replication Server
This guide explains how to generate a certificate signing request (CSR), sign it using the VMware vCenter Certificate Authority (VMCA), and install the signed certificate on a vSphere Replication appliance.
Prerequisites
- Access to the vSphere Replication Appliance (VAMI)
- Root credentials for the replication appliance
- Root or administrative access to the vCenter Server Appliance (VCSA)
- vCenter administrative credentials (administrator@vsphere.local)
Step 1: Generate a CSR from the Replication Appliance
-
Open a web browser and access the VAMI interface:
https://<VR_Appliance_FQDN_or_IP>:5480 - Log in using the root account.
- Navigate to the Certificates tab.
- Select Generate CSR.
- Enter the required details:
- Organization
- Organizational Unit
- State and Locality
- Accept the default FQDN and IP values unless changes are required.
-
Click Generate and Download to save:
.csrfile (certificate signing request).keyfile (private key)
Important: Keep the private key file secure. It is required for certificate installation.
Step 2: Sign the CSR Using vCenter VMCA
Option A: Using vCenter Certificate Manager (CLI)
- SSH into the vCenter Server Appliance (VCSA).
- Log in as root.
- Enable the Bash shell:
shell -
Launch the certificate manager:
/usr/lib/vmware-vmca/bin/certificate-manager - Select the option to sign a custom certificate request and follow the prompts.
Option B: Using vSphere Web Client (Recommended)
- Log in to vCenter.
- Navigate to:
Administration → Certificates → Certificate Management - Select VMCA Root Certificate.
- Click Issue New Leaf Certificate.
- Upload the previously generated CSR file.
-
Download:
- Signed certificate (leaf certificate)
- VMCA root certificate
Step 3: Install the Signed Certificate on the Replication Appliance
- Return to the replication appliance VAMI interface.
- Navigate to Certificates.
- Select:
Appliance Certificate → Change - Choose: Use a CA-signed certificate generated from CSR
- Upload the following files:
- Signed certificate (leaf certificate)
- VMCA root certificate
- Private key file generated earlier
- Note: Ensure your file browser shows all file types (not just PEM files).
- Apply the configuration.
Step 4: Reconfigure the Appliance
After uploading the certificates, the appliance will require reconfiguration.
- Provide vCenter administrator credentials (administrator@vsphere.local)
- Allow the appliance to complete certificate installation and service updates
Verification
- Access the replication appliance UI and confirm no certificate warnings
- Verify certificate details from the browser (issuer should be VMCA)
- Confirm replication services are operational
Best Practices
- Always back up the appliance before modifying certificates
- Ensure time synchronization between vCenter and appliances
- Store private keys securely
- Use VMCA or enterprise CA consistently across infrastructure
Last Updated:
2025/10/16