X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/51dc4f3f6d1faa0dfa79ae4d282f584fbe797299..af1a79779dad6f9b01fd9deb2197ece416c014ec:/doc/_includes/_install_ruby_and_bundler.liquid
diff --git a/doc/_includes/_install_ruby_and_bundler.liquid b/doc/_includes/_install_ruby_and_bundler.liquid
index 84544ba075..d14e555f89 100644
--- a/doc/_includes/_install_ruby_and_bundler.liquid
+++ b/doc/_includes/_install_ruby_and_bundler.liquid
@@ -1,23 +1,77 @@
-Currently, only Ruby 2.1 is supported.
+{% comment %}
+Copyright (C) The Arvados Authors. All rights reserved.
-h4(#rvm). *Option 1: Install with rvm*
+SPDX-License-Identifier: CC-BY-SA-3.0
+{% endcomment %}
+
+Minimum of Ruby 2.3 is required. Ruby 2.5 is recommended.
+
+* "Option 1: Install from packages":#packages
+* "Option 2: Install with RVM":#rvm
+* "Option 3: Install from source":#fromsource
+
+h2(#packages). Option 1: Install from packages
+
+{% include 'notebox_begin' %}
+Future versions of Arvados may require a newer version of Ruby than is packaged with your OS. Using OS packages simplifies initial install, but may complicate upgrades that rely on a newer Ruby. If this is a concern, we recommend using "RVM.":#rvm
+{% include 'notebox_end' %}
+
+h3. Centos 7
+
+The Ruby version shipped with Centos 7 is too old. Use "RVM.":#rvm
+
+h3. Debian and Ubuntu
+
+Debian 9 (stretch) and Ubuntu 16.04 (xenial) ship Ruby 2.3, which is sufficient to run Arvados. Later releases have newer versions of Ruby that can also run Arvados.
sudo gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3
-\curl -sSL https://get.rvm.io | sudo bash -s stable --ruby=2.1
-sudo -i gem install bundler
-sudo adduser "$USER" rvm
+
+# apt-get --no-install-recommends install ruby ruby-dev bundler
+yum install gpg curl which ++ +h4. Debian and Ubuntu + +
+apt-get --no-install-recommends install gpg curl ++ +h3. Install RVM + +
# gpg --keyserver pool.sks-keyservers.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
+\curl -sSL https://get.rvm.io | bash -s stable --ruby=2.5
+
. /usr/local/rvm/scripts/rvm
source /usr/local/rvm/scripts/rvm
+rvm-exec default rails console
~$ gem install bundler
+
sudo apt-get install \
@@ -26,22 +80,22 @@ Install prerequisites for Debian 7 or 8:
libssl-dev libxslt1.1 zlib1g-dev
sudo yum install \
libyaml-devel glibc-headers autoconf gcc-c++ glibc-devel \
patch readline-devel zlib-devel libffi-devel openssl-devel \
- automake libtool bison sqlite-devel
+ make automake libtool bison sqlite-devel tar
sudo apt-get install \
gawk g++ gcc make libc6-dev libreadline6-dev zlib1g-dev libssl-dev \
libyaml-dev libsqlite3-dev sqlite3 autoconf libgdbm-dev \
- libncurses5-dev automake libtool bison pkg-config libffi-dev
+ libncurses5-dev automake libtool bison pkg-config libffi-dev curl
mkdir -p ~/src
cd ~/src
-curl http://cache.ruby-lang.org/pub/ruby/2.1/ruby-2.1.6.tar.gz | tar xz
-cd ruby-2.1.6
-./configure --no-install-rdoc
+curl -f http://cache.ruby-lang.org/pub/ruby/2.5/ruby-2.5.5.tar.gz | tar xz
+cd ruby-2.5.5
+./configure --disable-install-rdoc
make
sudo make install
-sudo gem install bundler
+sudo -i gem install bundler