To install VMware Cloud Director Object Storage Extension, deploy an RPM package to a target Linux virtual machine and use the ose command-line utility to configure VMware Cloud Director Object Storage Extension and the external components.

For security purposes, VMware Cloud Director Object Storage Extension validates the complexity of all passwords. When you set passwords by using the ose command-line utility, make sure that the password contains:
  • At least eight characters
  • Minimum one uppercase character
  • Minimum one lowercase character
  • Minimum one numeric digit character
  • Minimum one non-alphanumeric character.

    Use only visible ASCII characters. Do not use space and non-printing control characters, such as BEL or NUL.

VMware Cloud Director Object Storage Extension performs a password validation as part of the execution of the following scripts:
  • ose cert import
  • ose director set
  • ose db set
For testing purposes, you can avoid the password validation by adding the --force argument to the script that you run.

Prerequisites

  • Verify that your target environment and target machine meet the deployment and hardware requirements. See Deploying VMware Cloud Director Object Storage Extension.
  • If you want to install VMware Cloud Director Object Storage Extension on top of a Cloudian HyperStore cluster, verify that you upgraded your Cloudian HyperStore to version 7.1.6 or 7.2. You must also increase the maximum length of Cloudian HyperStore user IDs from 64 bytes to 255 bytes. See Before You Begin and Cloudian Deployment Requirements.
  • Verify that you have a dedicated database instance and a database user that has enough privileges to create tables and change schemas.
  • Verify that the installation RPM package is uploaded to the /temp directory of the target machine.

Procedure

  1. Open an SSH connection to the target machine and log in as root.
  2. Install VMware Cloud Director Object Storage Extension from the RPM package by running the yum install command.
    yum install /temp/vmware-ose-1.5.0-16046355.el7.x86_64.rpm
    The VMware Cloud Director Object Storage Extension Keeper Service starts immediately after the RPM package is installed.
    Important: If you are deploying the RPM package as part of upgrading VMware Cloud Director Object Storage Extension, do not perform any further command-line configuration steps. Keep the VMware Cloud Director Object Storage Extension server running for about a minute and continue the upgrade process. See Upgrading VMware Cloud Director Object Storage Extension.

    If you are deploying the RPM package as part of a clean installation of VMware Cloud Director Object Storage Extension, proceed to the next step.

  3. Verify that the ose command-line utility works, by running the ose -h command.
    The system returns help information about the ose command-line utility.
  4. Import an externally signed SSL certificate.
    1. Prepare the PKCS 12 keystore with the externally signed certificate and a unique alias by running the export command.
      openssl.exe pkcs12 -export -in cert-file-name.cer -inkey s3.key -CAfile CA-cert-file-name.cer -passout pass:password -out PKCS-file-name.p12 -chain -name unique-cert-alias
      In the current example, the openssl tool is used for exporting the certificate. You can use an alternative tool.
      For example:
      openssl.exe pkcs12 -export -in s3.cer -inkey s3.key -CAfile CA.cer -passout pass:ChangeIt! -out s3.p12 -chain -name s3
    2. Import the certificate to your PKCS12 keystore by running the import command.
      ose cert import --path path-to-keystore-file --secret 'password-of-the-keystore'

      If the password that you enter contains a single quote character ('), run the command without the --secret argument. The system prompts you to enter the password on a new line.

      For example:
      ose cert import --path ./ose-service.p12 --secret 'ChangeIt!'
    1. For testing purposes, instead of importing a certificate, you can generate a self-signed SSL certificate by running the following command:
      ose cert gen --cn common-name-of-ose-host --secret certificate-password
      For example, ose cert gen --cn s3.acme.com.
  5. Configure the database connection.
    ose db set --url jdbc:postgresql://db_host:db_port/db_instance --username 'db-user' --secret 'db-password'

    If the password that you enter contains a single quote character ('), run the command without the --secret argument. The system prompts you to enter the password on a new line.

    For example:
    ose db set --url jdbc:postgresql://localhost:5432/ossdb --username oseadmin --secret 'ChangeIt!'
  6. Configure the connection to VMware Cloud Director.
    ose director set --url vcd-url --username vcd-sysadmin-user@system --secret 'vcd-sysadmin-password'
    Important: For the --username argument value, if you are installing VMware Cloud Director Object Storage Extension to a multisite VMware Cloud Director environment, make sure that the system administrator account can log in to all sites.

    The system administrator user name that you enter must be with an @system suffix.

    For example:
    ose director set --url https://vcd.acme.com --username vcd-admin-user@system --secret 'ChangeIt!'
    If the password you enter contains a single quote character ('), run the command without the --secret argument and the system prompts you to enter the password in a new line.
  7. Install the VMware Cloud Director Object Storage Extension user interface plug-in.
    ose ui install --ose-url ose-host-url

    Here, ose-host-url is the public server endpoint of VMware Cloud Director Object Storage Extension. Typically, the public server endpoint is the HTTPS URL of the VMware Cloud Director Object Storage Extension host on port 443. It becomes available after you complete the configuration and start the VMware Cloud Director Object Storage Extension service. Make sure that the URL is open for a public access.

    If you deploy multiple instances of VMware Cloud Director Object Storage Extension behind a load balancer, the ose-host-url must be the public FQDN of VMware Cloud Director Object Storage Extension.

    For example:
    ose ui install --ose-url https://ose-host:443

What to do next

Configure VMware Cloud Director Object Storage Extension with a Cloudian HyperStore or an ECS cluster.