...

• SecStorageSetupCommand -
  • All ssvms are rebooted when UploadCustomCertificate is invoked for server cert and private key. As part of ssvm agent connect with MS, a command called SecStorageSetupCommand containing all the certs and the key is sent to ssvm (you wont see the certs as it is sensitive information and not logged). 
  • On the ssvm side the root cert is inserted into the keystore. 
  • For apache server a server cert. file, a key file and a certificate chain file (consisting of certs from root cert to the intermediate cert) are created in the appropriate location and location put into the config file.   
    
• SSVM acts as a server for download template/volume/iso operations and during copyTemplate if it is in the source zone. It uses an Apache webserver when acting as server.
  • Apache server should have the latest key and , server cert and chain under the following location - 
    • /etc/ssl/private/cert_apache.key 
    • /etc/ssl/certs/cert_apache.
    key and 
    • crt
    • /etc/ssl/certs/cert_apache_chain.crt

  • /etc/apache2/sites-available/default-ssl is the config file for apache server where the chain location, server cert and private key are configured.

  • When client contacts the apache server it needs to present the entire chain of certificates to the client.
• It acts as a client during copyTemplate operation if it is in the destination zone. SSVM uses a Java client when acting as a client.
  • SSVM has a java keystore which should have the root certificate in the keystore so that when it tries to download from the url it can validate the chain presented by the server against the known root.
    Use the command below to list all certs in the keystore
     keytool -list -keystore /usr/local/cloud/systemvm/certs/realhostip.keystore -storepass vmops.com

CPVM

• CPVM acts as a server only and uses Java HTTP webserver
• Every time CPVM starts up, the keystore is created in-memory by management server and the data sent to CPVM
• CPVM uses this keystore to configure the Java webserver with right private key and certificate
• The key is saved with label “CPVMCertificate” in keystore
• Every time uploadSSL API is called, CPVM reboots
• Will be enhanced to reboot only when full chain is uploaded
• CPVM has an in-memory keystore (similar to SSVM’s realhostip.keystore)

TroubleShooting

Basics

...