Please read the DISCLAIMER and WARRANTY before continuing.
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|
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.
Create three *SAVF objects on the IBM i server for each of the uploads.
Do a binary FTP transfer of the downloaded *SAVF object to your IBM i
RSTLICPGM LICPGM(1PRUBY1) DEV(*SAVF) LNG(2924) SAVF(QGPL/PRUBY_BASE) RSTLICPGM LICPGM(1PRUBY1) DEV(*SAVF) LNG(2924) OPTION(2) SAVF(QGPL/PRUBY_0002)
Verify the install was successful by invoking the Ruby runtime in PASE.
Now set the PowerRuby version with the
SETPOWRBY command. In the future there will be more than one version included with PowerRuby.
Now enter the PASE environment by calling QP2TERM and run the 'ruby -v' command:
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
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)