Merge lp:~mbruzek/charms/precise/redis-slave/README into lp:charms/redis-slave

[Matt Bruzek]

The redis-slave charm lacks a copyright and README file, this merge adds them.

=== added file 'README.md'
--- README.md	1970-01-01 00:00:00 +0000
+++ README.md	2014-08-21 13:37:06 +0000
@@ -0,0 +1,88 @@
+# 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 slave implementation of Redis software. The slaves are configured 
+as _read-only_ so you can not set values on a redis-slave.  Go to the Redis 
+web pages for more information on [replication](http://redis.io/topics/replication).
+
+# Usage
+
+To deploy this charm first bootstrap your Juju environment and issue the
+following commands:
+
+    juju deploy redis-master
+    juju deploy redis-slave
+
+    juju add-relation redis-slave:redis-master redis-master:redis-master
+
+Expose the slave or master if you need to contact them for some reason.
+
+    juju expose redis-slave
+
+# Replication
+
+Redis replication is very simple to use with Juju.  Simply deploy a 
+redis-master node and a redis-slave node and add the redis-master relation
+between them. Adding a relation causes the charms to properly configure 
+master-slave replication on both servers without having to know how to
+configure Redis replication.
+
+Redis slaves contain the exact copy of the master server.  Redis replication 
+is a non-blocking operation, meaning the master and slave will continue to 
+handle queries when synchronization starts from other nodes.  A master can 
+have multiple slaves.
+
+Go to the Redis web pages for more information on [replication](http://redis.io/topics/replication).
+
+
+# Testing Redis
+
+To test if Redis software is functioning properly telnet to the redis ip
+address using port 6379:
+
+    telnet redis-slave-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](http://redis.io/commands) to test 
+that Redis is working as intended.
+
+Note that redis-slave are configured as read-only so set commands will not work.
+
+## Known Limitations and Issues
+
+If you run into problems or issues:
+
+Go to the [issue database on github](https://github.com/antirez/redis/issues) to check for problems related to the Redis software.
+
+Go to the [redis-slave page on launchpad](https://bugs.launchpad.net/charms/+source/redis-slave) to check for redis-slave related bugs. 
+
+The Redis log file can be found on the deployed instance at:  
+`/var/log/redis/redis-server.log` 
+
+## Configuration
+
+There are no Juju configuration options for the redis-slave 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 <[e-mail]>
+
+# Redis Information
+
+- Redis [home page](http://redis.io/)
+- Redis [github bug tracker](https://github.com/antirez/redis/issues)
+- Redis [documentation](http://redis.io/documentation)
+- Redis [mailing list](http://groups.google.com/group/redis-db)
+- Using IRC join the #redis channel on Freenode ([web access link](http://webchat.freenode.net/?channels=redis))
 
=== added file 'copyright'
--- copyright	1970-01-01 00:00:00 +0000
+++ copyright	2014-08-21 13:37:06 +0000
@@ -0,0 +1,18 @@
+Format: http://dep.debian.net/deps/dep5/
+
+Files: *
+Copyright: Copyright 2014, Canonical Ltd., All Rights Reserved.
+License: GPL-3
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+ .
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the 
+ GNU General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
 
=== removed file 'revision'
--- revision	2011-10-13 08:15:47 +0000
+++ revision	1970-01-01 00:00:00 +0000
@@ -1,1 +0,0 @@
-2