Introduction

Introduction to the Rubrik VMware Cloud Director HTML5 Plugin

Introducing the VMware Cloud Director (also known as vCD) Extension for Rubrik. This Gitbook will provide steps for Installing, Configuring and Using the Extension with Rubrik.

NOTE: vCD must be version 9.1.0.2 or newer to support this plugin. This is required due to earlier versions not supporting RxJS and HTTPClient.

Workflow:

vCloud Director 9.7 and 10.0

1. Determine Proxy or CORS

   1. Proxy

      1. Create a Certificate for Nginx Reverse Proxy*

      2. Build and Install Nginx Reverse Proxy

   2. CORS (Rubrik CDM 5.2+ Only)

      1. Enable CORS on Rubrik

2. Deploy the Rubrik Extension for vCloud Director

3. Configure the Rubrik Extension for vCloud Director

vCloud Director 9.5 and earlier

1. Deploy Nginx Reverse Proxy

   1. Create a Certificate for Nginx Reverse Proxy*

   2. Build and Install Nginx Reverse Proxy

2. Build the VMware Customize Portal Plug-in

3. Install the VMware Customize Portal Plug-in

4. Deploy the Rubrik Extension for vCloud Director

5. Configure the Rubrik Extension for vCloud Director * Nginx Reverse Proxy is required to support Cross-Origin API requests.

Rubrik Prerequisites

• Check Rubrik Compatability Matrix to determine support Cloud Director and CDM versions.

• When using Nginx, this must be configured with a valid SSL Certificate

  • SSL Certificates that are self signed need to be trusted by the client before the extension will work i.e. Opening Chrome and accepting the untrusted certificate. More information on certificates can be found in the Troubleshooting - Plugin Connectivity section.
• Rubrik CDM must have the Cloud Director (vCD) Cell Registered. Refer to Rubrik User Guide Section: "Adding a vCloud Director instance".

• Rubrik Credentials are required to perform tasks via the Extension. Refer to the "User Guide" Section.

Additional Prerequisites

• A Linux server is required to run nginx, or another preferred reverse proxy. This guide currently only includes steps for installing and configuring nginx on RHEL/CentOS based systems.
• The VMware Customize Portal plugin is used to install the Rubrik Extension for Cloud Director. Steps to build and install this plug-in are detailed below. (This is maintained by VMware)
• vCD Cells running 9.1.x.x must have JSON Media Type enabled: this can be done by logging into the vCD cell and running:

/opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n vcloud.rest.api.mediatype.json.enable -v true