X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/fc55e48b43faeb6909ea161d804d5600df3d5c5c..8a6bd5b851e0e947b74710c4c2dd1ea59dce606a:/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 8fae4bf3bf..4381d9fedf 100644 --- a/doc/_includes/_install_ruby_and_bundler.liquid +++ b/doc/_includes/_install_ruby_and_bundler.liquid @@ -4,110 +4,21 @@ Copyright (C) The Arvados Authors. All rights reserved. SPDX-License-Identifier: CC-BY-SA-3.0 {% endcomment %} -Ruby 2.6 or newer is required. +Ruby 2.7 or newer is required. -* "Option 1: Install from packages":#packages -* "Option 2: Install with RVM":#rvm -* "Option 3: Install from source":#fromsource +h2. Alma/CentOS/Red Hat/Rocky -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. Alma/CentOS/Red Hat/Rocky - -The Ruby version shipped with version 7 of these distributions is too old. Use "RVM":#rvm to install a newer version of Ruby (we recommend installing version 2.7 or newer). - -Ruby 2.7 is available in a module with version 8 of these distributions. You can install it by running: +Version 8 of these distributions provides Ruby 2.7. You can install it by running:
# dnf module enable ruby:2.7
 # dnf install --enablerepo=devel ruby ruby-devel
-h3. Debian and Ubuntu - -Debian 10 (buster) and Ubuntu 18.04 (bionic) ship with Ruby 2.5, which is too old for Arvados. Use "RVM":#rvm to install a newer version of Ruby (we recommend installing version 2.7 or newer). +h2. Debian and Ubuntu Debian 11 (bullseye) and Ubuntu 20.04 (focal) and later ship with Ruby 2.7 or newer, which is sufficient for Arvados.
# apt-get --no-install-recommends install ruby ruby-dev
- -h2(#rvm). Option 2: Install with RVM - -h3. Install gpg and curl - -h4. Alma/CentOS/Red Hat/Rocky - -
-dnf install gpg curl which
-
- -h4. Debian and Ubuntu - -
-apt-get --no-install-recommends install gpg curl
-
- -h3. Install RVM, Ruby and Bundler - - -
# gpg --keyserver pgp.mit.edu --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
-\curl -sSL https://get.rvm.io | bash -s stable --ruby=2.7
-
- -This command installs the latest Ruby 2.7.x release, as well as the @gem@ and @bundle@ commands. - -To use Ruby installed from RVM, load it in an open shell like this: - - -
source /usr/local/rvm/scripts/rvm
-
- -Alternately you can use @rvm-exec@ (the first parameter is the ruby version to use, or "default"), for example: - - -
rvm-exec default ruby -v
-
- -h2(#fromsource). Option 3: Install from source - -Install prerequisites for Debian 10, Ubuntu 18.04 and Ubuntu 20.04: - - -
sudo apt-get install \
-    bison build-essential gettext libcurl4 \
-    libcurl4-openssl-dev libpcre3-dev libreadline-dev \
-    libssl-dev libxslt1.1 zlib1g-dev
-
- -Install prerequisites for Alma/CentOS/Red Hat/Rocky: - - -
sudo dnf install \
-    libyaml-devel glibc-headers autoconf gcc-c++ glibc-devel \
-    patch readline-devel zlib-devel libffi-devel openssl-devel \
-    make automake libtool bison sqlite-devel tar
-
- -Build and install Ruby: - - -
mkdir -p ~/src
-cd ~/src
-curl -f https://cache.ruby-lang.org/pub/ruby/2.7/ruby-2.7.5.tar.gz | tar xz
-cd ruby-2.7.5
-./configure --disable-install-rdoc
-make
-sudo make install
-
-# Make sure the post install script can find the gem and ruby executables
-sudo ln -s /usr/local/bin/gem /usr/bin/gem
-sudo ln -s /usr/local/bin/ruby /usr/bin/ruby
-# Install bundler
-sudo -i gem install bundler
-