Installing and Configuring Redis Enterprise Pack for PCF

This topic describes how to install and configure Redise Pack for Pivotal Cloud Foundry (PCF).

Install Redis Enterprise Pack for PCF

  1. Download the product file from Pivotal Network.

  2. Navigate to the Ops Manager Installation Dashboard and click Import a Product to upload the product file.

  3. Under the Import a Product button, click + next to the version number of Redise Pack for PCF. This adds the tile to your staging area.

  4. Click Save.

  5. Return to the Ops Manager Installation Dashboard and click Apply Changes to install Redise Pack for PCF tile.

Configure and Deploy Redis Enterprise Pack for PCF

  1. Click the newly imported tile.
    Imported tile

  2. Navigate to the Assign AZs and Network section on the right navigation bar. Ensure you have a network selected for the cluster to use.

  3. Navigate to the Redis Enterprise Pack section on the right navigation bar. Enter the following details:

  4. From the Settings tab, click Redise Pack and complete the following fields:

    • Cluster Name: Provide a sub-domain for the cluster name. The Redise Pack cluster name is a sub-domain under the system domain, which is found under the Pivotal Elastic Runtime in Ops Manager.

      For example, set the cluster name as CLUSTERNAME.redislabs.com if your system domain is redislabs.com. The cluster name specified represents part of the connection string for Redis apps when connecting to Redise Pack databases using DNS-based connections.

    • Admin Email: Provide an email that has full administrative privileges to the new Redise Pack cluster.

    • Admin account password: Provide the password for the administrative account.

    For production clusters, you can also provide a set of static IPs addresses to use for cluster nodes and enabled Multiple Availability Zone (Rack) awareness. Import button

  5. Navigate to the Resource Config section on the right navigation bar. Ensure there are resources assigned to the required resources for Redise Pack.
    Import button

    Important: Ensure the capacity used for Redise Pack cluster nodes meet the minimum hardware specification requirements for Redise Pack. For more information, see the minimum hardware specifications in the Redise Pack documentation.

  6. Click Save.

  7. Return to the Ops Manager Installation Dashboard and click Apply Changes to deploy Redise Pack for PCF tile.

    Import button

  8. (Optional) Double-click the tile, and then click the Status tab to view the state of the cluster nodes under the jobs named redis-pack-node and redis-pack-service-broker.

Create a New Database on the Redis Enterprise Pack Cluster

  1. Connect to the Redise Pack Admin Console by putting the Cluster Name you previously specified in the URL: https://rpadmin.CLUSTER-NAME

  2. Log in using the Administrator email account and password you specified in the tile configuration above.

  3. Navigate to the databases tab and create a new database by selecting redis db. Import button

  4. On the new redis db page, in the Name field, enter database1 and then click the Show advanced options link.

  5. In the Endpoint port number field, enter 12000. Import button

  6. Click Activate to create your database.

You now have a Redis database on Redise Pack.

Connect to Redis Database Using redis-cli

redis-cli is a simple command-line tool for interacting with Redis database.

To connect to Redis Database do the following:

  1. Connect to one of the IP addresses of the nodes through SSH and find redis-cli under /opt/redislabs/bin/redis-cli.

  2. Change to the /opt/redislabs/bin directory and run redis-cli to connect to port 12000, and to the database-endpoint that is reported in the database properties after you created the database.

    # sudo /opt/redislabs/bin/redis-cli -p 12000 -h database-endpoint
    
  3. To store and retrieve a key in database1, do the following:

    127.0.0.1:16653> set key1 123
    OK
    127.0.0.1:16653> get key1
    "123"
    

    For information about Redise Pack, see the Redise Pack documentation.

Create a pull request or raise an issue on the source for this page in GitHub