Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: 5.4.1 - release -

Table of Contents

...

  • VMware vCloud Director
  • VMware vCenter


Requirements

  • For vCloud Director, to When you use Rubrik with vCloud Director
    • You must configure the endpoint in Rubrik properties
    • To create the Backup manager in Abiquo, you must enter Rubrik credentials and vCloud credentials separated by a hash ("#") or a custom separator configured in
    Abiquo
    • Rubrik properties
  • For Rubrik, Abiquo backup policies must have the policy Code set to a valid Rubrik SLA Domain (default or custom)

  • Users can add one backup policy only to a VM or they can request an immediate backup


Create custom SLA domains in Rubrik

The default Abiquo configuration includes the default Rubrik SLA Domains: Gold, Silver, and Bronze.

To use custom SLA domains, first create them in Rubrik.

Then save the names of the custom SLA domains to add them to Abiquo.


Configure Rubrik properties

...

  1. Log in to the Abiquo Remote Services server. 
  2. Go to the /opt/abiquo/config folder and create a rubrik.properties file. 
    1. Make the tomcat user the owner of this file. 
    • This is the default location, but you can configure the another location of your own file as required.
    For the properties you wish to use
  3. Add each property
  4. From in front of the property name, remove the comment hash ("#") symbol
  5. Enter the new value as required
    • the file in Abiquo properties
  6. Edit this properties file and add properties as described in the following steps

  7. If you are using Rubrik with vCloud Director, you must set the endpoint for vCloud, for example:

    Code Block
    abiquo.rubrik.vcloud.endpoint=https://myvclouddirector.example.com


  8. If you have more than one vCenter server, set the vcenter.id property to specify the server that Rubrik is attached to, for example:

    Code Block
    abiquo.rubrik.vcenter.id=aa92b229-0eff-4153-c94e-ab9e581e1cdf


  9. If you are using custom SLA domains in Rubrik, set the sla property to add their names as a comma separated list, for example:

    Code Block
    abiquo.backup.rubrik.sla=Platinum,Palladium


  10. You can add any of the other properties from the Rubrik configuration properties reference below as required. Don't forget to remove the hash '#' comment symbol from the start of each property. (smile) 


Configure Abiquo Properties

To activate the Rubrik plugin and define the location of the configuration file:

  1. Log in to the Abiquo Remote Services server

  2. Edit the abiquo.properties file. 
  3. Set the path to the plugin properties file using the following property.

    Code Block
    abiquo.backup.rubrik.config.path=/opt/abiquo/config/rubrik.properties


  4. Optionally configure other rubrik properties for nars and virtualfactory as required:
    1. Abiquo Configuration Properties#nars
    2. Abiquo Configuration Properties#virtualfactory


Configure all backup jobs with policy codes

In Abiquo, create a Backup policy for each type of backup.

For the policy Code, enter the Rubrik SLA domain to use.

When a user assigns a backup policy to a VM, if Abiquo cannot find the Rubrik SLA Domain to match a backup policy code, then it will not be able to create a new backup job in Rubrik and the VM backups will not run.


Rubrik configuration properties reference

This section contains the configuration properties for the Rubrik integration. The Configure Rubrik Properties section describes the required and recommended properties.

Code Block
languageapplescript
# Log level for feign client
#abiquo.rubrikclient.feign.logger.level=INFO
???

# TimeoutsTimeout for client to connect, andto readthe from Rubrik API. To disable the timeout, set the value to 0 
#abiquo.rubrikclient.timeout.connectionInSeconds=300


#abiquo.rubrikclient.timeout.readInSeconds=300 


# ???# Timeout for client to read from Rubrik API. To disable the timeout, set the value to 0 
#abiquo.rubrikclient.followRedirects=false timeout.readInSeconds=300 

# TimeMaximum ???time to performwait afor task ???to finish in Rubrik API 
#abiquo.rubrik.task.max.minutes=30 

# Interval between checks if task is finished in Rubrik API
#abiquo.rubrik.task.period.minutes=1 


# TimeoutsTimeout for client to connect, andto read from vCloud API. To disable athe timeout, set the value to 0 
#abiquo.rubrik.vcloudclient.timeout.connectionInSeconds=300 

# Timeout for client to read from the vCloud API. To disable the timeout, set the value to 0 
#abiquo.rubrik.vcloudclient.timeout.readInSeconds=300 


# For vCloud, character to split user into backup system and vCloud user
#abiquo.rubrik.credentials.splitter.user=# 


# For vCloud, character to split password into backup system and vCloud password
#abiquo.rubrik.credentials.splitter.pass=#  

# Number of backup results  
#abiquo.rubrik.clients.pagesize=50 

 # ???
isn't
this in the backup manager
#abiquo.rubrik.vcloud.endpoint= 


# In addition to the default Gold, Silver, and Bronze SLA Domains
# List of custom SLA Domains that you already configured in Rubrik
#abiquo.backup.rubrik.sla=


# ??? ID of the vCenter that Rubrik is attached to 
#abiquo.rubrik.vcenter.id=


Configure Abiquo Properties

To activate the Rubrik plugin and define the location of the configuration file:

  1. Log in to the Abiquo Remote Services server

  2. Edit the abiquo.properties file. 
  3. Set the path to the plugin properties file using the following property.
     
Code Block
abiquo.backup.rubrik.config.path=/opt/abiquo/config/rubrik.properties

Configure all backup jobs with policy codes

For Rubrik, you MUST enter an Abiquo policy Code for each backup.

Abiquo ALWAYS uses the backup policy Code attribute to identify the Rubrik SLA domain to use.

The default Abiquo configuration includes the default Rubrik SLA Domains: Gold, Silver, and Bronze

If you are using custom SLA domains, your system administrator must use the abiquo.backup.rubrik.sla property to add their names as a comma separated list.

For example: 

Code Block
#abiquo.backup.rubrik.sla=Platinum,Palladium 

When a user assigns a backup policy to a VM, if Abiquo cannot find the Rubrik SLA Domain to match a backup policy code, then it will not be able to create a new backup job in Rubrik and the VM backups will not run.

Table of plugin properties

For vCenter, you do not need to set any properties for Rubrik because all of these properties have default values.

If you change the Rubrik properties, to reload the properties in Abiquo, you must restart the Tomcat server.

...

abiquo.rubrikclient.feign.logger.level

...

String

...

FULL

...

abiquo.rubrikclient.timeout.connectionInSeconds

...

Long

...

300

...

abiquo.rubrikclient.timeout.readInSeconds

...

Long

...

300

...

abiquo.rubrikclient.followRedirects

...

Boolean

...

false

...

abiquo.rubrik.task.max.minutes

...

Long

...

30

...

abiquo.rubrik.task.period.minutes

...

Long

...

1

...

abiquo.rubrik.vcloudclient.timeout.connectionInSeconds

...

Int

...

300

...

abiquo.rubrik.vcloudclient.timeout.readInSeconds

...

Int

...

300

...

abiquo.rubrik.credentials.splitter.user

...

String

...

abiquo.rubrik.credentials.splitter.pass

...

String

...

abiquo.rubrik.clients.pagesize

...

String

...

50

...

abiquo.rubrik.vcloud.endpoint

...

String

...

 

...

abiquo.backup.rubrik.sla

...

String

...

 

...

abiquo.rubrik.vcenter.id

...

String

...