Building Ruby on Rails - linux-on-ibm-z/docs GitHub Wiki

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 has 6.1.7.3

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

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

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)

    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 12 SP5

    sudo zypper install -y bison flex libopenssl-devel libyaml-devel libffi48-devel readline-devel zlib-devel gdbm-devel ncurses-devel tcl-devel tk-devel sqlite3-devel gcc make wget shared-mime-info tar  gcc-c++ libxslt-devel npm14 timezone curl

  • SLES 15 SP5

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

  • 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)

    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 7.2.0                 # For All except SLES 15.x
gem install rails -v 7.2.0 -- --use-system-libraries	#For SLES 15.x

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

  • (Output)

    Rails 7.2.0

Step 2: Verification

  • Install NodeJS

    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', '7.2.0'" >> 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: