Quick Setup of Redis Enterprise Software (RS)
The steps to set up a Redis Enterprise Software (RS) cluster with a single node are super simple and go as follows:
- Step 1: Install Redis Enterprise Software
- Step 2: Setup a Redis Enterprise Software cluster
- Step 3: Create a new Redis database
- Step 4: Connect to your Redis database
"Quick Setup" steps on this page apply to a Linux based system install. For instructions for running Docker on Linux, Windows, or MacOS, go to the Docker Quick Start Guide.
Step 1: Install Redis Enterprise Software
You can download the binaries from the Redis Enterprise Software download site. Once you have the bits on a Linux based OS, you need to untar the image
$ tar vxf <downloaded tar file name>
Once the tar command completes, you will find a new install.sh script in the current directory.
$ sudo ./install.sh -y
Step 2: Setup a Cluster
In the web browser on the host machine, go to https://localhost:8443 to see the Redis Enterprise Software web console.
- Depending on your browser, you may see a certificate error. You can safely continue to the web console.
- If you see an error from nginx, try again after a few minutes.
Click Setup to start the node configuration steps.
In the Node Configuration settings, enter a cluster FQDN such as
cluster.local. Then click Next button.
Enter your license key, if you have one. If not, click the Next button to use the trial version.
Enter an email and password for the admin account for the web console.
Step 3: Create a Database
Select "redis database" and the "single region" deployment, and click Next.
Enter a database name such as
database1and click Activate to create your database.
You now have a Redis database!
Step 4: Connect to your Database
After you create the Redis database, you are ready to store data in your database. You can test connectivity to your database with:
- redis-cli - the built-in command-line tool
- A Hello World application using Python
Connecting Using redis-cli
redis-cli is a simple command-line tool to interact with Redis database.
Run redis-cli, located in the /opt/redislabs/bin directory, to connect to port 12000 and store and retrieve a key in database1
$ sudo /opt/redislabs/bin/redis-cli -p 12000 127.0.0.1:16653> set key1 123 OK 127.0.0.1:16653> get key1 "123"
Connecting Using Hello World Application in Python
A simple python application running on the host machine, not the container, can also connect to database1.
Note: The following section assumes you already have Python and redis-py (python library for connecting to Redis) configured on the host machine running the container. You can find the instructions to configure redis-py on the github page for redis-py.
Create a new file called
redis_test.pywith this contents:
import redis r = redis.StrictRedis(host='localhost', port=12000, db=0) print ("set key1 123") print (r.set('key1', '123')) print ("get key1") print(r.get('key1'))
Run the redis_test.py application to store and retrieve a key:
If the connection is successful, the output of the application looks like this:
set key1 123 True get key1 b'123'
Now you have a Redis Enterprise cluster ready to go. You can connect to it with a redis client to start loading it with data or you can use the memtier_benchmark Quick Start to check the cluster performance.