Upgrade VMware Cloud Director Extension for Data Solutions

You can upgrade to VMware Cloud Director Extension for Data Solutions 1.2 from versions 1.X.

Note: To get the certificate file, run the following command: $ run get certificates --accept --host HOST_NAME -o ~/vcd_cert.pem. You must not download the VMware Cloud Director certificate file in the folder, where you mount the ISO package. If you do not trust the VMware Cloud Director certificate, use the following command to trust it: $ run trust --accept --host HOST_NAME --username USER_NAME --password PASSWORD --certificate-file ~/vcd_cert.pem

Prerequisites

• Verify that you have the credentials of a VMware Cloud Director System Administrator account.
• Verify that you have downloaded the installation ISO package for VMware Cloud Director Extension for Data Solutions.
• Verify that you have copied the VMware Cloud Director API endpoint SSL certificate file in the local directory.
• If you maintain an internal container registry, verify that the Data Solutions operator package is cloned to its internal container registry.

Procedure

1. Copy the ISO file to the client machine and upload it to the local file system.
2. Mount the ISO package to a new folder.
   • For Windows: Right click the ISO file and click Mount.
   • For MacOS: Run the following command: hdiutil mount FILENAME.iso -mountroot FILE_DIRECTORY
   • For Linux: Run the following command: mount -o loop FILENAME.iso FILE_DIRECTORY
3. To upgrade VMware Cloud Director Extension for Data Solutions, navigate to the folder, which contains the extracted ISO package and run the following command:
   • For Windows:

     ./windows.run.exe create instance --name EXTENSION_NAME --encryption-key ENCRYPTION_KEY --host HOST_NAME --username USER_NAME --password PASSWORD --certificate-file CERTIFICATE_FILE_NAME --accept --input-delete-previous-uiplugin-versions=false
     

   • For MacOS:

     ./darwin.run create instance --name EXTENSION_NAME --encryption-key ENCRYPTION_KEY --host HOST_NAME --username USER_NAME --password PASSWORD --certificate-file CERTIFICATE_FILE_NAME --accept --input-delete-previous-uiplugin-versions=false
     

     Or

      ./darwin-arm64.run create instance --name EXTENSION_NAME --encryption-key ENCRYPTION_KEY --host HOST_NAME --username USER_NAME --password PASSWORD --certificate-file CERTIFICATE_FILE_NAME --accept --input-delete-previous-uiplugin-versions=false
     

   • For Linux:

     ./linux.run create instance --name EXTENSION_NAME --encryption-key ENCRYPTION_KEY --host HOST_NAME --username USER_NAME --password PASSWORD --certificate-file CERTIFICATE_FILE_NAME --accept --input-delete-previous-uiplugin-versions=false
     

   The following table describes the parameters values that you must enter.

   Note: To see the full list of command parameters, run the following command: <run> create instance -h.

   Table 1. Upgrade command parameters

   Parameter	Description
   EXTENSION_NAME	The name of the VMware Cloud Director Extension for Data Solutions.
   ENCRYPTION_KEY	The encryption key, used for encrypting data. The encryption key can be any string of numbers.
   HOST_NAME	The name of the VMware Cloud Director host.
   USER_NAME	The user name of the VMware Cloud Director system administrator.
   PASSWORD	The password of the VMware Cloud Director system administrator.
   CERTIFICATE_FILE_NAME	TheVMware Cloud Director API endpoint SSL certificate filename.

   Example:

   windows.run.exe get certificates --accept --host atl1-vcd-static-000-00.eng.vmware.com -o C:\Users\Administrator\Downloads\vcd_cert.pem
   windows.run.exe trust --accept --host atl1-vcd-static-000-00.eng.vmware.com --username admin --password vmware --certificate-file C:\Users\Administrator\Downloads\vcd_cert.pem
   windows.run.exe create instance --name tds1 --encryption-key 123 --host atl1-vcd-static-000-00.eng.vmware.com --username admin --password vmware --certificate-file C:\Users\Administrator\Downloads\vcd_cert.pem --accept --input-delete-previous-uiplugin-versions=false
   

What to do next

• Update the VMware Cloud Director Extension for Data Solutions repository and set to the latest version. You can preview the latest version, by selecting the Use Default Value check box in the Update Repository window. See Managing container registries in the Using VMware Cloud Director Extension for Data Solutions as a Service Provider guide.
• The tenant administrator must upgrade each Data Solutions operator, which runs in the Kubernetes clusters within their organizations. To avoid upgrading the Data Solutions operators during the next VMware Cloud Director Extension for Data Solutions upgrade, the tenant administrator must set the Data Solutions operator upgrade policy to Auto upgrade to the latest version.