Getting Started with Redis

1. Create an instance

Step 1

  1. Click the Instance heading, then click on Add Instance.

  2. Enter a name for your instance.

    This can be almost anything, as any alpha numeric string is valid.

  3. Select Redis for the service.

    The type defaults to HA Redis.

_images/createredis.png

Click on Step 2 to continue.

Step 2

  1. Select a version to deploy.

    ObjectRocket offers Redis versions 2.8 and 3.0.

  2. Select a zone.

    Zones are Rackspace and/or AWS Direct Connect zones, labeled by airport codes in that region. For more information about ObjectRocket’s datacenters, check out the FAQ or our zone map.

  3. Select a plan that suits your needs.

    For more details, check out plans and pricing.

_images/createredis_2.png

Click on Confirm to review your entries, then click Create. Your new instance is ready!

2. Add an Access Control List (ACL)

Access Control Lists (ACL) limit who connects to your instance.

Note

ObjectRocket denies access by default so you need to add any appropriate ACL’s for servers that are connecting to ObjectRocket.

  1. In the Security section of the instance details page, click Add ACL.

  2. Enter an IP address/CIDR block and a description.

    Only the IP address is mandatory, but descriptions can help when maintaining larger lists.

  3. Click Add ACL Entry.

_images/addacl_mongo.png

3. Connect!

After you’ve created a database with user authentication and added an ACL, you’re ready to test basic connectivity in a terminal session with redis-cli:

$ redis-cli -h '<hostname>' -p '<port>' -a '<password>'
hostname:port> set my_key my_value
OK
hostname:port> get my_key
"my_value"

You can also connect with netcat/telnet:

$ nc '<hostname>' '<port>'
auth <password>
+OK
set my_key my_value
+OK
get my_key
$8
my_value

If you see similar results, you’re connected to the instance and can perform database operations. Success!

If you have any issues or just need guidance, contact our support team.