Building Ruby on Rails

Building Ruby on Rails

Below versions of Ruby on Rails are available in respective distributions at the time of creation of these build instructions:

• SLES (15 SP5, 15 SP6) have 5.2.3
• Ubuntu 20.04 has 5.2.3
• Ubuntu 22.04 has 6.1.4.1
• Ubuntu (24.04, 24.10) have 6.1.7.3

The instructions provided below specify the steps to build Rails version 8.0.1 on Linux on IBM Z for following distributions:

• RHEL (8.8, 8.10, 9.2, 9.4, 9.5)
• SLES 15 SP6
• Ubuntu (20.04, 22.04, 24.04, 24.10)

General Notes:

• When following the steps below please use a standard permission user unless otherwise specified.
• A directory /<source_root>/ will be referred to in these instructions, this is a temporary writable directory anywhere you'd like to place it.

Step 1: Install Ruby on Rails

1.1. Install build dependencies

• RHEL (8.8, 8.10)

  sudo yum groupinstall -y 'Development Tools'
  sudo yum install -y zlib-devel zlib make gcc wget which patch gcc-c++ npm sqlite-devel curl libyaml-devel
  

• RHEL (9.2, 9.4, 9.5)

  sudo yum install -y rpmdevtools
  sudo yum install -y zlib-devel zlib make gcc wget which patch gcc-c++ npm sqlite-devel curl ruby ruby-devel libyaml-devel
  

• SLES 15 SP6

  sudo zypper install -y wget gcc zlib-devel gawk make patch tar gzip shared-mime-info sqlite-devel gcc-c++ libxslt-devel npm20 curl
  

• Ubuntu 20.04

  sudo apt-get update
  sudo apt-get install -y wget curl patch make gcc zlib1g-dev build-essential libsqlite3-dev npm tzdata pkg-config ruby-nokogiri git libyaml-dev
  
  

• Ubuntu (22.04, 24.04, 24.10)

  sudo apt-get update
  sudo apt-get install -y wget ruby ruby-dev curl patch make gcc zlib1g-dev build-essential libsqlite3-dev npm tzdata pkg-config ruby-nokogiri git libyaml-dev
  

1.2. Build Ruby 3.3.4 (For RHEL, SLES, Ubuntu (20.04, 22.04) )

wget -q https://raw.githubusercontent.com/linux-on-ibm-z/scripts/master/Ruby/3.3.4/build_ruby.sh
bash build_ruby.sh -y

1.3. Correct the gem environment for a standard user

export GEM_HOME=$HOME/.gem/ruby
export PATH=$HOME/.gem/ruby/bin:$PATH

1.4. Install Ruby on Rails via gem

gem install rake                           # For Ubuntu

gem install rails -v 8.0.1                 # For All except SLES 15.x
gem install rails -v 8.0.1 -- --use-system-libraries	#For SLES 15.x

1.5. Ruby on Rails is now installed. Verify version with command rails -v

• (Output)

  Rails 8.0.1

Step 2: Verification

• Install NodeJS (Except SLES 15.x)

  cd $SOURCE_ROOT
  wget  https://nodejs.org/download/release/v16.3.0/node-v16.3.0-linux-s390x.tar.gz
  tar xzf node-v16.3.0-linux-s390x.tar.gz
  export PATH=$SOURCE_ROOT/node-v16.3.0-linux-s390x/bin:$PATH
  node -v

• Install required dependencies

  gem install bundler 
  sudo npm install -g yarn

• Create a new Rails application and start the web server

  mkdir myapp
  cd myapp
  echo "source 'https://rubygems.org'" > Gemfile
  echo "gem 'rails', '8.0.1'" >> Gemfile
  bundle install
  bundle exec rails new . --force --skip-bundle
  bundle install
  bin/rails server &

  Note: Use -b to bind Rails to the specified IP. By default, it is localhost.

• After starting Rails server, go to http://localhost:3000

  curl http://127.0.0.1:3000

References:

• http://rubyonrails.org/
• https://github.com/rails/rails#getting-started