Install/Update Instructions

Please read the DISCLAIMER and WARRANTY before continuing.

Requirements

PowerRuby requires IBM i version 7.1 (aka V7R1) along with the following licensed programs.

Licensed Program Product Option Description
5733SC1 ​*BASE IBM Portable Utilities for i
5733SC1 1 OpenSSH, OpenSSL, zlib
5770SS1 33 Portable Application Solutions Environment 
5770DG1 *BASE IBM HTTP Server for i

 

Install Instructions

The PowerRuby product is packaged using IBM's License Program approach.  The PRUBY_BASE option contains the core functionality for PowerRuby.  The PRUBY_0001 option contained Ruby 1.9.3 + Rails 3.2.14 and has since been retired**.  The PRUBY_0002 option contains Ruby 2.0.x + Rails 4.0.x.  The PRUBY_0003 option contains Ruby 2.1.x + Rails 4.0.x and is still in beta.  Install PRUBY_BASE and PRUBY_0002.

**Learn more about PowerRuby versions here.

Step 1

Create three *SAVF objects on the IBM i server for each of the uploads.
CRTSAVF FILE(QGPL/PRUBY_BASE)
CRTSAVF FILE(QGPL/PRUBY_0002)

Step 2

Do a binary FTP transfer of the downloaded *SAVF object to your IBM i 

Step 3


RSTLICPGM LICPGM(1PRUBY1) DEV(*SAVF) LNG(2924) SAVF(QGPL/PRUBY_BASE)
RSTLICPGM LICPGM(1PRUBY1) DEV(*SAVF) LNG(2924) OPTION(2) SAVF(QGPL/PRUBY_0002)

Step 4

Verify the install was successful by invoking the Ruby runtime in PASE.
ADDLIBLE LIB(POWER_RUBY)

Now set the PowerRuby version with the SETPOWRBY command. In the future there will be more than one version included with PowerRuby.
SETPOWRBY VRM(*V20

Now enter the PASE environment by calling QP2TERM and run the 'ruby -v' command:

QP2TERM

That's it!  Your installation is complete.

A very pertinent next step is to develop your first RubyOnRails application: Create a new rails app from scratch

Update Instructions

We expect updates frequent updates to PowerRuby because of how quickly the Ruby on Rails community moves with new features and fixes.  The below describes the necessary steps to take to remove an existing installation.

NOTE: It is important to note that you should not put your own work in the /PowerRuby folder as it could get deleted!

First shut down all PowerRuby Apache and Thin servers by following the instructions here: Start and stop PowerRuby servers 
Below the mv command is essentially backing up the existing IFS install.  This is good for scenarios where you want to retain any gems that were downloaded into the the /PowerRuby/prVxMx folders. Replace YYYYMMDD with the current year, month, and day.

 
DLTLIB POWER_RUBY
QSH CMD('mv /PowerRuby /PowerRubyYYYYMMDD-1')
CLRSAVF FILE(QGPL/PRUBY_BASE)
CLRSAVF FILE(QGPL/PRUBY_0002)

Then run through the installation documentation at the beginning of this document.

If doing a patch then do the following:

RSTOBJ OBJ(*ALL) SAVLIB(POWER_RUBY) DEV(*SAVF) SAVF(QGPL/PATCH)