redis master #0

Supports: trusty
Add to new model

Description

Redis is a key-value database in a similar vein to memcache but the dataset is non-volatile. Redis additionally provides native support for atomically manipulating and querying data structures such as lists and sets. The dataset is stored entirely in memory and periodically flushed to disk. This charm provides the master/stand-alone service

Overview

Redis (http://redis.io) is an open source, advanced key-value cache and store. It is often referred to as a data structure server since keys can contain strings, hashes, lists, sets, sorted sets, bitmaps and hyperloglogs. In order to achieve its outstanding performance, Redis works with an in-memory dataset that can be written to disk. Redis also supports master-slave asynchronous replication.

Redis can be configured in a master or slave configuration. This charm provides a single stand alone master implementation of Redis software. Go to the Redis web pages for more information on replication.

Usage

To deploy this charm first bootstrap your Juju environment and issue the following command:

juju deploy redis-master

Expose the master if you need to contact them for some reason.

juju expose redis-master

Replication

Redis can be set up with master-slave replication in Juju. This allows the Redis slave to be an exact copy of master server. A master can have multiple slaves.

See the redis-slave charm for more details about how to configure the Juju charms with replication.

Testing Redis

To test if Redis software is functioning properly telnet to the redis ip address using port 6379:

telnet redis-master-ip 6379

You can also install the redis-tools package apt-get install redis-tools and connect using the Redis client command:

redis-cli

From there you can issue Redis commands to test that Redis is working as intended.

Known Limitations and Issues

If you run into problems or issues:

Go to the issue database on github to check for problems related to the Redis software.

Go to the redis-master page on launchpad to check for redis-master related bugs.

The Redis log file can be found on the deployed instance at:
/var/log/redis/redis-server.log

Configuration

There are no configuration options for the redis-master charm. Just deploy the charm in Juju and you will have a working Redis installation!

Contact Information

The charm was originally created by Juan Negron juan.negron@canonical.com

Redis Information