Configuring VMware Cloud Director Object Storage Extension with a Cloudian HyperStore cluster consists of establishing a connection between the VMware Cloud Director Object Storage Extension and Cloudian HyperStore services.

For security purposes, VMware Cloud Director Object Storage Extension validates the complexity of all passwords. When you set passwords using the ose command-line utility, make sure that the password complies with the following requirements:
  • At least eight characters in length
  • Minimum one uppercase character
  • Minimum one lowercase character
  • Minimum one numeric digit character
  • Minimum one non-alphanumeric character. Use only visible American Standard Code for Information Interchange (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 cloudian admin set
  • ose cloudian console set
For testing purposes, you can avoid the password validation by adding the --force argument to the command that you run.

Prerequisites

  • Verify that you deployed VMware Cloud Director Object Storage Extension and configured connections to VMware Cloud Director and to your database.
  • Verify that you upgraded your Cloudian HyperStore to version 7.1.6 or 7.2.
  • Verify that you increased the maximum length of Cloudian HyperStore user IDs from 64 bytes to 255 bytes. See Before You Begin and Cloudian Deployment Requirements.

Procedure

  1. Open an SSH connection to the machine to which you installed VMware Cloud Director Object Storage Extension.
  2. Start the VMware Cloud Director Object Storage Extension Keeper service.
    systemctl start voss-keeper
  3. Configure the connection to the Cloudian HyperStore Admin Service HTTPS API endpoint.
    ose cloudian admin set --url hyperstore-admin --user admin-user --secret 'password'

    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.

    For example:
    ose cloudian admin set --url https://object-storage.acme.com:19443 --user sysadmin --secret 'ChangeIt!'
  4. Configure the connection to the Cloudian HyperStore S3 Service.
    ose cloudian s3 set hyper-store-s3-url

    To configure the connection, use the FQDN or the IP address of the S3 Service. If you use the FQDN, make sure that you correctly configure the S3 Service domain in the Cloudian HyperStore cluster. Also, make sure that your DNS server can route all bucket requests from the virtual to the actual S3 Service host. For example, from bucket-name.hyper-store-s3-host to hyper-store-s3-host. If you use the IP address of the S3 Service, no domain and virtual host route settings are required.

    For example:
    ose cloudian s3 set https://object-storage.acme.com:443
  5. Configure the connection to the Cloudian HyperStore IAM Service.
    ose cloudian iam set hyper-store-iam-url
    For example:
    ose cloudian iam set http://object-storage.acme.com:16443
  6. Configure the connection to the Cloudian Management Console.
    ose cloudian console set --url hyperstore-cmc-url --user admin-user --secret cmc-sso-shared-key

    The user name that you enter must be the user name of a valid system administrator user. For the --secret argument value, enter the single sign-on shared key that is configured in the Cloudian Management Console.

    For example:
    ose cloudian console set --url https://object-storage.acme.com:8443 --user admin --secret UinqeMQA9FAWy8zbDqWTLBRRg23U72xBWi
  7. Validate the configuration of VMware Cloud Director Object Storage Extension .
    ose config validate
    If all components are successfully configured, the system returns the following message:
    +------------------------+-------------+-----------------+---------------------------------+
    |          Name          |   Required  |   Connectivity  |            Detail               |
    +========================+=============+=================+=================================+
    |        Database        |      Y      |      Normal     |                                 |
    +------------------------+-------------+-----------------+---------------------------------+
    |       Certificate      |      Y      |      Normal     |                                 |
    +------------------------+-------------+-----------------+---------------------------------+
    |     Cloud Director     |      Y      |      Normal     |                                 |
    +------------------------+-------------+-----------------+---------------------------------+
    |  Platform - Cloudian   |      Y      |      Normal     |                                 |
    +------------------------+-------------+-----------------+---------------------------------+
    | Cloudian Admin Service |      Y      |      Normal     |                                 |
    +------------------------+-------------+-----------------+---------------------------------+
    |Cloudian Console Service|      N      |      Normal     |                                 |
    +------------------------+-------------+-----------------+---------------------------------+
    |  Cloudian S3 Service   |      Y      |      Normal     |                                 |
    +------------------------+-------------+-----------------+---------------------------------+
    
    If the system returns an error, review the log file at /opt/vmware/voss/log.
  8. Verify the status of the VMware Cloud Director Object Storage Extension service.
    ose service show
    If the VMware Cloud Director Object Storage Extension service runs as expected, the system returns a Running status and configuration details.

    If you receive an error message, you can start the VMware Cloud Director Object Storage Extension service in debugging mode by adding the --debug argument and troubleshoot the problem.

  9. Start VMware Cloud Director Object Storage Extension services.
    ose service start