Prestage a root/intermediate CA certificate in Aria Operations
search cancel

Prestage a root/intermediate CA certificate in Aria Operations

book

Article ID: 328177

calendar_today

Updated On:

Products

VCF Operations/Automation (formerly VMware Aria Suite) VMware Cloud Foundation VMware vSphere ESXi

Issue/Introduction

  • Preparing to migrate to a new Certificate Authority (CA)
  • Prestaging root and intermediate CA certificates is required prior to CA cutover to prevent SSL/TLS handshake failures, broken API integrations, or endpoint rejections.

Environment

Aria Ops: 8. x, 8.18

VCF: 5.2

Resolution

  1. Take a snapshot of the Aria Ops appliances. See Snapshot Creation in VMware Aria Operations

  2. For all Aria Ops nodes (primary, replica, data, cloud proxies), import the new root/intermediate CA certificates to the cacerts trust stores using the following commands:

    • $VCOPS_BASE/jre/bin/keytool -import -alias <alias> -file /tmp/<certfile> -keystore "$VCOPS_DATA_VCOPS/user/conf/ssl/tcserver.truststore" -storepass $(grep ssltruststorePassword /storage/vcops/user/conf/ssl/storePass.properties | sed s/ssltruststorePassword=//) -trustcacerts -noprompt

    • Note: You will want to run this command once for the Root CA, and once for each Intermediate CA
  3. Confirm the new CA certificates were successfully imported:

    • $VCOPS_BASE/jre/bin/keytool -list -v -keystore "$VCOPS_DATA_VCOPS/user/conf/ssl/tcserver.truststore" -storepass $(grep ssltruststorePassword /storage/vcops/user/conf/ssl/storePass.properties | sed s/ssltruststorePassword=//) -alias <alias>

  4. Take the Aria Ops cluster offline via the Admin UI

  5. Apply Shut Down Guest OS on all Aria for Logs VMs via ACTIONS > Power within vCenter.
  6. Bring the Aria Ops cluster online via the Admin UI

Additional Information

See Adding an SSL Certificate to the VMware Aria Operations Truststore