Installing and Configuring the Redis Labs Enterprise Cluster Service Broker

This topic describes how to install and configure Redis Labs Enterprise Cluster (RLEC) Service Broker, as well as how to create an instance of the RLEC service from the Marketplace of your Pivotal Cloud Foundry (PCF) deployment.

Install RLEC

To use the RLEC Service Broker, you must have a RLEC cluster already deployed. Configuring the RLEC Service Broker requires a RLEC admin account username and password, as well as the URL of your RLEC cluster.

To download and install RLEC, follow the instructions in the RLEC documentation. RLEC is available as an Amazon Web Services AMI or as an installation package for Ubuntu and Red Hat / CentOS.

For more information about how to install RLEC and create a cluster, see the RLEC documentation.

Install the RLEC Service Broker

  1. Download the product file from Pivotal Network.
  2. Upload the product file on the Ops Manager Installation Dashboard.
  3. Click Add next to the uploaded RLEC Service Broker in the Ops Manager Available Products view to add it to your staging area.
  4. Click the newly added tile.
  5. From the Settings tab, click Redis Labs Enterprise Cluster and complete the following fields:
    • RLEC admin account username: Enter the email address you used to create the RLEC cluster.
    • RLEC admin account password: Enter the password you used to create the RLEC cluster.
    • RLEC address: Enter the Cluster Name (FQDN) of the RLEC cluster as you provided it when you created the cluster, in the following format: https://YOUR-CLUSTER-NAME:9443.
  6. Click Save.
  7. Return to the Ops Manager Installation Dashboard and click Apply Changes to install the RLEC Service Broker.

Create a Redis Database in Apps Manager

After installing the RLEC Service Broker, the Redis Labs Enterprise Cluster appears as a service in the Marketplace of your deployment. Developers can provision Redis databases by creating service instances using Apps Manager or the cf Command Line Interface (CLI).

Follow the instructions below to create a Redis Labs Enterprise Cluster service instance using Apps Manager.

  1. Navigate to Apps Manager in a browser and log in.
  2. Click Marketplace.
  3. Click Redis Labs Enterprise Cluster.
  4. Choose one of the four preconfigured database plans and click Select this plan. For more information about the preconfigured plans, see the Overview.
  5. In the Configure Instance form, enter an Instance Name to identify the service instance in the deployment as well as the database name in RLEC. To override the default parameters and provide additional database configuration parameters, click Show Advanced Options. Contact support@redislabs.com for further instructions on using this feature.
  6. Once you create the service and bind it to an app, you can find the credentials in the VCAP_SERVICES environment variable in the following format:
"VCAP_SERVICES": {
  "redislabs-enterprise-cluster": [
   {
    "credentials": {
     "host": "redis-12345.pcf-rlec.redislabs.com",
     "ip_list": [
      "10.0.0.171"
     ],
     "password": "some-redis-password",
     "port": 12345
    },
    "label": "redislabs-enterprise-cluster",
    "name": "my-redis-db",
    "plan": "ha-redis",
    "provider": null,
    "syslog_drain_url": null,
    "tags": [
     "redislabs"
    ]
   }
  ]
}
Was this helpful?
What can we do to improve?
Create a pull request or raise an issue on the source for this page in GitHub