Installing the Setup Package
The first thing you need to choose the platform to run Redis Enterprise Software on. If on-premise or in the cloud and you want to install it yourself, you need to download the package. For Amazon AWS, there are other instructions to set up an AMI image. You can also run RS in a Docker container for testing purposes. Navigate to the Redis Labs download page and select one of the following options:
- Installation package - Click the Download button for the OS you would like to use in order to download the .tar file installation package.
- AMI - Click the AWS AMI button for the option you would like to use in order to launch an instance on Amazon Web Services (AWS).
- Docker (For testing purposes only) - Go here for the install guide and skip this page.
Note: If you are using the AMI option or installing the .tar file package on an AWS instance, review the guidelines in Configuration of AWS instances.
- If you intend to use Redis on Flash for your databases, be familiar with the specifics of that feature and its set of prerequisites, storage, and considerations.
- Disable Linux swap on all nodes to be part of the cluster.
- Ensure you have root level access to each node, either directly or via 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 workaround this issue, change the system configuration to make this port available before running 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
If you downloaded the .tar file installation package, install the package on a machine that is one of the nodes in the cluster by performing the following steps:
- In the operating system command-line-interface (CLI), also referred to as Terminal, run the cd command to change the location to the directory where you saved the .tar file.
Extract the package by running the following command in the CLI:
tar vxf <tarfile name>
To initiate the installation in the CLI, run the following command:
Note: You must either be the root user or have access to sudo to the root user to run the install process.
During the installation process, enter the requested input each time you are prompted to do so.
After installation has completed successfully
The install finishes up with rlcheck make testing the installation out and confirming the installation passed.
2017-04-24 10:54:12 [!] Installation is complete! 2017-04-24 10:54:12 [?] Would you like to run rlcheck to verify proper configuration? [Y/N]? Y 2017-04-24 10:54:15 [$] executing: '/opt/redislabs/bin/rlcheck --suppress-tests=verify_bootstrap_status,verify_processes' saving to file: /var/opt/redislabs/log/rlcheck.log ##### Welcome to RedisLabs Enterprise Cluster settings verification utility #### Skipping test: verify_bootstrap_status Skipping test: verify_processes Running test: verify_dmcproxy Verifying dmcproxy process... PASS Running test: verify_port_range Verifying local port range... PASS 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
Make sure to save this URL for when you go to configure the cluster.
If you intend to create Redis on Flash enabled databases, you must prepare and format the flash memory. You should run:
This command finds all the unformatted disks, RAIDs and mounts them under /var/opt/redislabs/flash You can verify the configuration by running:
Open a web browser and go to the Web UI to complete the cluster setup.
If you would like to automate the installation script, use either of the following methods to perform a "silent" installation that speeds the process:
- Run the install script with "-y" as a parameter (i.e. ./install.sh -y), which silently uses "Y" as a default response to all questions. WARNING: By using the -y parameter you fail to see any alerts from the installer to the possible presence of DBs in Sync state. These alerts when in normal mode allow you to stop the upgrade if they find a DB in that state. Check that your DBs are not in this state before possibly using this flag. Otherwise, do not use this feature.
- Run the install script with "-c" and an answers file path as parameters (i.e. ./install.sh --c <answers and="" file="" name="" path="">), thereby allowing the installation to use the answers provided in your answers file. Here is sample content for the answers file: systune=yes ntp=no firewall=no rlcheck=yes
Not all questions in install.sh can be automated with the answers file. The reason being is we want an admin to see what was detected and consciously agree to do or not to do something. An example is when install.sh detects that a shard of a DB is syncing right now. If that situation is detected, the admin needs to knowingly assume the risk of proceeding and not waiting.
sudo ./install.sh -y or using an answers file does not
perform the steps necessary for Redis on Flash or creating a
cluster. That part of each node's install still has to be done and
potentially automated separately.
During the interactive installation process, there questions asked to understand how much you want the process to try and configure the OS environment for optimal usage by Redis Enterprise. Each question and what they do is below.
Swap is enabled. Do you want to proceed? [Y/N]?
Due to how Redis Enterprise manages memory on a node, Linux swap should be disabled in the operating system configuration. For more information on why and how to do this, please see Swap in Linux.
Shard is syncing
Under some circumstances, a database shard may be syncing at the time you run the install script.
shard:X of db:Y is now syncing. Do you want to continue the upgrade
This answer cannot be automatically answered 'Y' due to the sensitive nature of the operation it is warning about. An admin must either assume the risk or abort the install/upgrade.
Automatically Tuning the System
Do you want to automatically tune the system for best performance [Y/N]?
The install process can run a script that does environment changes on your behalf. If you answer yes to this question, the install asks more in-depth questions to best optimize the OS environment for running Redis Enterprise.
If you answer no, you manually have to tune the OS for running Redis Enterprise.
It is recommended to answer 'Y' to this question and the remaining questions as they streamline the configuration of the environment.
If you would like to see specifically what is being done, please see /opt/redislabs/sbin/systune.sh on the node.
Network Time Configuration
Do you want to set up NTP time synchronization now [Y/N]?
Redis Enterprise requires that all nodes of the cluster have synchronized time. If you do not permit the script to configure this, then you must do this manually. For more information see Syncing Node Clocks.
Would you like to open RedisLabs cluster ports on the default firewall zone [Y/N]?
If a firewall is operating on the node the install process is running, the script can configure the firewall to open the correct ports Redis Enterprise requires to operate. If not, you have to open the necessary ports on your own. If you need, there is specific information on RHEL/CentOS firewall configuration.
Would you like to run rlcheck to verify proper configuration? [Y/N]?
This runs a final check to make sure everything has been done correctly. It is advisable to answer 'Y' on this. If you would like to see the contents of this script, it is installed to /opt/redislabs/bin/rlcheck on every Redis Enterprise node.