aboutsummaryrefslogtreecommitdiffstats
path: root/guides/source/development_dependencies_install.md
diff options
context:
space:
mode:
authorRafael Reggiani Manzo <rr.manzo@protonmail.com>2016-08-22 14:35:33 -0300
committerRafael Reggiani Manzo <rr.manzo@protonmail.com>2016-08-22 14:44:46 -0300
commit65b5960759ed7913189b94bea4ea96471bd07dac (patch)
tree8e7dbd26c652a2be3eb7aed59249e84439c863b2 /guides/source/development_dependencies_install.md
parent46a44243065dd1088458fc843875aa531b802a47 (diff)
downloadrails-65b5960759ed7913189b94bea4ea96471bd07dac.tar.gz
rails-65b5960759ed7913189b94bea4ea96471bd07dac.tar.bz2
rails-65b5960759ed7913189b94bea4ea96471bd07dac.zip
[ci skip] Update docs with Action Cable Redis dependency
Action Cable's test `test/subscription_adapter/redis_test.rb` fail if Redis is not installed and running. Following the guides `development_dependen there's no mention to this.
Diffstat (limited to 'guides/source/development_dependencies_install.md')
-rw-r--r--guides/source/development_dependencies_install.md43
1 files changed, 43 insertions, 0 deletions
diff --git a/guides/source/development_dependencies_install.md b/guides/source/development_dependencies_install.md
index cc24e6f666..20cd34c182 100644
--- a/guides/source/development_dependencies_install.md
+++ b/guides/source/development_dependencies_install.md
@@ -288,3 +288,46 @@ NOTE: Using the rake task to create the test databases ensures they have the cor
NOTE: You'll see the following warning (or localized warning) during activating HStore extension in PostgreSQL 9.1.x or earlier: "WARNING: => is deprecated as an operator".
If you're using another database, check the file `activerecord/test/config.yml` or `activerecord/test/config.example.yml` for default connection information. You can edit `activerecord/test/config.yml` to provide different credentials on your machine if you must, but obviously you should not push any such changes back to Rails.
+
+### Action Cable Setup
+
+Action Cable uses Redis as its default subscriptions adapter ([read more](action_cable_overview.html#broadcasting)). Thus, in order to have Action Cable's tests passing you need to install and have Redis running.
+
+#### Install Redis From Source
+
+Redis' documentation discourage installations with package managers as those are usually outdated. Installing from source and bringing the server up is straight forward and well documented on [Redis' documentation](http://redis.io/download#installation).
+
+#### Install Redis From Package Manager
+
+On OS X, you can run:
+
+```bash
+$ brew install redis
+```
+
+Follow the instructions given by Homebrew to start these.
+
+In Ubuntu just run:
+
+```bash
+$ sudo apt-get install redis-server
+```
+
+On Fedora or CentOS (requires EPEL enabled), just run:
+
+```bash
+$ sudo yum install redis
+```
+
+If you are running Arch Linux just run:
+
+```bash
+$ sudo pacman -S redis
+$ sudo systemctl start redis
+```
+
+FreeBSD users will have to run the following:
+
+```bash
+# portmaster databases/redis
+```