Documentation - Redise Pack

A guide to Redise Pack installation, operation and administration

open all | close all

Initial setup – creating a new cluster

A Redise Pack (RP) cluster typically consists of several nodes. For production deployment, Redis Labs recommends an uneven number of nodes, with a minimum of three.

Note: In a cluster that consists of only one node some features and capabilities, such as database replication (which enables failover to ensure high availability), are not enabled.

To set up a new cluster, you must first install the installation package as described in the previous section, and then set up the cluster as described below. After the cluster is created you can add multiple nodes to the cluster (for additional details, refer to Joining a new node to a cluster).

To create a cluster:

  1. In a browser, navigate to https://<name or IP address of a machine on which you installed the package>:8443. For example, if you installed RP on a machine with IP address 10.0.1.34, then navigate to https://10.0.1.34:8443.

    Note: The RP management UI uses SSL encryption. For additional details, refer to Updating SSL certificates.

    Note: If the machine has both an internal IP address and an external IP address, use the external IP address to access the setup UI.

  2. Click Setup.
  3. In the Node Configuration page that appears:
    1. Enter a path for Persistent storage, or leave the default path.
      For additional details, refer to Persistent and ephemeral storage.
    2. Enter a path for Ephemeral storage, or leave the default path.
      For additional details, refer to Persistent and ephemeral storage.
    3. If you want to enable Redise Flash, select the Enable flash storage support check box and enter the path to the Flash storage that should be used as RAM extension.
      For additional details, refer to Redise Flash.
    4. If your machine is configured to have multiple IP addresses, the section IP Addresses Usage is displayed. Use the IP Addresses Usage section to assign a single IPv4 type address for internal traffic and multiple IPv4/IPv6 type addresses for external traffic. For additional details, refer to Multi-IP & IPv6.
    5. In Cluster configuration, select Create new cluster.
    6. In Cluster name (FQDN), enter a unique name for the cluster.
      For guidelines, refer to How to set the cluster name.
    7. Choose whether to Enable private & public endpoints support. For additional details, refer to Private & Public Endpoints.
    8. Choose whether to Enable rack-zone awareness. Enabling rack-zone awareness requires setting the Rack-zone ID for the node. For additional details, refer to Rack-zone awareness.
    9. Click Next.
  4. If you purchased a cluster key, use the Cluster authentication page to enter the key. Read the product Terms and Conditions and click Next.
  5. Use the Set admin credentials page to enter the credentials of the cluster administrator. These credentials are required in order to add nodes to the cluster, and to regularly log in to the cluster management UI.
  6. Click Next.

After a short wait your cluster is created and the cluster management UI appears.

You can now access any of the management capabilities. You will probably want to create a database (for additional details, refer to Creating a new database), or add a new node (for additional details, refer to Joining a new node to a cluster).

It is highly advisable to verify that the node is functioning properly, by carrying out the following tests: