Configure VMware Cloud Director Object Storage Extension with OSIS compliant object storage

Integrate any S3-compliant object storage platform by configuring Object Storage Interoperability Service (OSIS).

Prerequisites

• Before you can configure VMware Cloud Director Object Storage Extension to work with a third-party object storage platform, verify that you have developed an OSIS adapter for the platform. See the VMware Object Storage Interoperability Service - Development Guide.
• Verify that you have obtained the OSIS adapter name. See Get the OSIS adapter name.

Get the OSIS adapter name

Before you can integrate OSIS, you must obtain the OSIS adapter name.

Procedure

1. Start the OSIS adapter and verify that it is running.
2. Get the platform information by using a tool like cURL or Postman. See the Object Storage Interoperability Service API Reference Guide.
   For example, curl -k https://osis-adapter-api-server/api/info
   In the response, the property auth_modes displays the supported authentication modes.

How to configure VMware Cloud Director Object Storage Extension with OSIS compliant object storage

OSIS defines a set of management API specifications for VMware Cloud Director Object Storage Extension.

OSIS allows VMware Cloud Director Object Storage Extension to communicate with third-party object storage platforms and exchange tenant and user information.

Procedure

1. Configure the OSIS API connection.

   ose osis admin set --name OSIS-platorm-name --url https://osis-adapter-api-server --user username --secret
   password

2. (Optional) If the authentication mode for OSIS is with a bearer API token, set a refresh token.

   ose args set --k oss.platform.OSIS-adapter-name.admin.refresh-token --v refresh-token

   1. To determine the authentication mode of OSIS, run the OSIS API GET /api/info and view the auth_modes property.
3. Configure the third-party object storage platform S3 endpoint.

   ose osis s3 set --name OSIS-platform-name --url https://platform-S3-endpoint 

4. Switch to the third-party object storage platform.

   ose platforms enable osis --name OSIS-platform-name

5. Restart the VMware Cloud Director Object Storage Extension service.

   ose service restart

Results

You can now allow tenant organizations to use the new third-party object storage platform.