Installing Redis Enterprise Software
To install Redis Enterprise Software (RS), you must first choose the supported platform that you want to deploy on. In addition to Linux operating systems (Ubuntu, RHEL/CentOS, Oracle Linux), you can also deploy RS with:
To access the installation package for any of these platforms:
- Go to the Redis Labs download page.
- Log in with your Redis Labs credentials or sign up for a new account.
- In the Downloads section for Redis Enterprise Software, select the installation package for your platform and click Go.
In this article we walk you through the process for installing the RS installation package for Linux.
If you want to use Redis on Flash (RoF) for your databases, review the prerequisites, storage requirements, and other considerations for RoF databases and prepare and format the flash memory.To prepare and format the flash memory:
This command finds all of the unformatted disks and mounts them as RAID partitions in
To verify the disk configuration, run:
Disable Linux swap on all cluster nodes.
Make sure that you have root-level access to each node, either directly or with sudo.
When port 53 is in use, the installation fails. This is known to happen in default Ubuntu 18.04 installations in which systemd-resolved (DNS server) is running. To work around this issue, change the system configuration to make this port available before running the RS installation.Example steps to resolve the port 53 conflict:
sudo vi /etc/systemd/resolved.conf
DNSStubListener=noas the last line in the file and save the file.
sudo mv /etc/resolv.conf /etc/resolv.conf.orig
sudo ln -s /run/systemd/resolve/resolv.conf /etc/resolv.conf
sudo service systemd-resolved restart
Installing RS on Linux
After you download the tar file installation package, install the package on one of the nodes in the cluster.
To install RS on Linux from the CLI:
- Copy the installation package to the node.
On the node, change to the directory where the installation package is and extract the installation files:
tar vxf <tarfile name>
To install RS, run:
sudo ./install.shNote -You must either be logged in as the root user or use
sudoto run the install process.
Answer the installation questions when shown to complete the installation process, including the
rlcheckinstallation verification.Note -To install RS without answering the installation questions, either:
./install.sh -yto answer yes to all of the questions.
- Use an answer file to answer the installation questions.
After RS is successfully installed, the IP address of the RS web UI is shown:
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
RS is now installed on the node. Repeat this process for each node in the cluster. Then:
- Create or join an existing RS cluster.
For geo-distributed Active-Active replication, create an Active-Active database.
During the installation process, you must answer a few questions to configure the node for your environment. These installation questions are:
Linux swap file -
Swap is enabled. Do you want to proceed? [Y/N]?
We recommend that you disable Linux swap in the operating system configuration to give RS control of the memory allocation.
Automatic OS tuning -
Do you want to automatically tune the system for best performance [Y/N]?
To let the RS installation optimize the OS for Redis Enterprise, answer
Y. The installation process prompts you for additional information.
/opt/redislabs/sbin/systune.shfile contains details about the tuning process.
Network time -
Do you want to set up NTP time synchronization now [Y/N]?
Redis Enterprise requires that all cluster nodes have synchronized time. You can either let the installation process configure NTP or you can configure NTP manually.
Firewall ports -
Would you like to open RedisLabs cluster ports on the default firewall zone [Y/N]?
RS requires the node to have specific network ports open. You can either:
Yto let the installation process open these ports.
Nand configure the firewall manually for RHEL/CentOS firewall.
Nand configure the firewall on the node manually for your OS.
Installation verification (rlcheck) -
Would you like to run rlcheck to verify proper configuration? [Y/N]?
We recommend that you run the
rlckeckinstallation verification to make sure that the installation completed succesfully. If you want to run this verification at a later time, you can run:
Installation answer file
To avoid answering the installation questions during the installation process, you can prepare an answer file and use it to do a silent installation.
To install RS with an answer file:
Prepare the answer file with the answers to the installation questions.
The answer file can contain any of the parameters for the installation questions and
noto indicate the answer for the question.
ignore_swap=no systune=yes ntp=no firewall=no rlcheck=yesNote -If you use
systune=yes, the installation answers yes to all of the system tuning questions.
Run the install script with
-cand the path to the answer file.
./install.sh -c /home/user/answers