Installation – RedHat Enterprise Linux 4

1. Start with a clean slate Linux installation. Make sure that you don’t have anything Ruby-related installed on it. If you are using non-root account as admin, login as root and add this account to /etc/sudoers.

Do not call your admin account rails. RubyWorks uses that as a service account name, so you will be effectively giving root privileges to your web servers. That’s bad for security.

2. Import RubyWorks repository public key:

wget http://rubyworks.rubyforge.org/RubyWorks.GPG.key
sudo rpm --import RubyWorks.GPG.key

Note: RubyWorks RPMs are signed, this step tells your package manager to trust the signature. MD5 checksum of the key file should be 971cf342ec253b0f5288cf55cbcf5e12.

3. Point your package manager to RubyWorks yum repository. Open file /etc/sysconfig/rhn/sources in a text editor, and add this line to it:

# For 32-bit architecture
yum Rubyworks http://rubyworks.rubyforge.org/redhat/4/RPMS/i386
# For 64-bit architecture
yum Rubyworks http://rubyworks.rubyforge.org/redhat/4/RPMS/x86_64

4. Install RubyWorks

sudo up2date rubyworks

If all goes well, you now have a skeleton Rails application up and running at http://localhost:3001. There is also monitoring console running at http://localhost:2812. Congratulations!

Note that the monitoring console at this point will only be accessible from localhost. The next page tells you how to make it available on the network.

If something goes wrong, seek help at rubyworks-users maillist.

Theoretically, at this stage you can leave everything as it is, and it will work. However, especially if you are installing RubyWorks for the first time, you should go to the next page and work through the instructions there. You will set some passwords, learn what is where, and how to customize RubyWorks configuration to suite your taste.