Install Redis Enterprise Software on Linux

Install Redis Enterprise Software on Linux.

After you download a Redis Enterprise Software installation package, install it on one of the nodes in the cluster.

For installation on machines without an internet connection, see Offline installation.

Install on Linux

To install Redis Enterprise Software, use the command line:

1. Copy the installation package to the node.

2. On the node, change to the directory where the installation package is located and extract the installation files:

   tar vxf <tarfile name>
   

3. (Optional) Use the GPG key file to confirm the authenticity of Ubuntu/Debian or RHEL RPM packages:

   • For Ubuntu:

     1. Import the key:

     gpg --import <path to GPG key>
     

     2. Verify the package signature:

     dpkg-sig --verify </path-to/package.deb>
     

   • For RHEL:

     1. Import the key:

     rpm --import <path to GPG key>
     

     2. Verify the package signature:

     rpm --checksig </path-to/package.rpm>
     

4. To start the installation process, run the installation script. See installation script options for a complete list of command-line options.

   For default installation:

   sudo ./install.sh
   

   For custom installation directories:

   If you need to specify custom storage paths for persistent or ephemeral storage during cluster setup, you must install Redis Enterprise Software to custom directories.

   sudo ./install.sh --install-dir <path> --config-dir <path> --var-dir <path>
   

   For detailed information about custom installations, see Customize installation directories.

   Note:

   • The Redis Enterprise Software files are installed in the default file locations unless you specify custom directories.
   • By default, Redis Enterprise Software runs on the OS as the redislabs user and redislabs group. If needed, you can specify a different user and group during the installation.
   • You must either be the root user or use sudo to run the installation script.

5. Answer the installation questions when shown to complete the installation process.

   Note:

   To skip the installation questions, use one of the following methods:

   • Run ./install.sh -y to answer yes to all of the questions.
   • Create an answer file to answer installation questions automatically.

6. When installation completes successfully, the output displays the Cluster Manager UI's IP address:

   Summary:
   -------
   ALL TESTS PASSED.
   2017年04月24日 10:54:15 [!] Please logout and login again to make
   sure all environment changes are applied.
   2017年04月24日 10:54:15 [!] Point your browser at the following
   URL to continue:
   2017年04月24日 10:54:15 [!] https://<your_ip_here>:8443
   

7. Repeat this process for each node in the cluster.

Redis Flex and Auto Tiering installation

If you want to use Redis Flex or Auto Tiering for your databases, review the prerequisites, storage requirements, and other considerations and prepare and format the flash memory.

After you install Redis Enterprise Software, use the prepare_flash script to prepare and format flash memory:

sudo /opt/redislabs/sbin/prepare_flash.sh

This script finds unformatted disks and mounts them as RAID partitions in /var/opt/redislabs/flash.

To verify the disk configuration, run:

sudo lsblk

More info and options

To learn more about customization and find answers to related questions, see:

• CentOS/RHEL firewall configuration
• Change socket file location
• Cluster DNS configuration
• Cluster load balancer setup
• mDNS client prerequisites
• File locations
• Supported platforms

Limitations

Several Redis Enterprise Software installation reference files are installed to the directory /etc/opt/redislabs/ even if you use custom installation directories.

As a workaround to install Redis Enterprise Software without using any root directories, do the following before installing Redis Enterprise Software:

1. Create all custom, non-root directories you want to use with Redis Enterprise Software.

2. Mount /etc/opt/redislabs to one of the custom, non-root directories.

Next steps

1. Create or join an existing Redis Enterprise Software cluster.

2. Create a database.

   For geo-distributed Active-Active replication, create an Active-Active database.

3. Add users to the cluster with specific permissions. To begin, start with Access control.