Details:

This article explains how to install the Radiant CMS system on a (gs) Grid-Service. The steps outlined in this walkthrough guide you through the setup of Radiant CMS in production mode. You will need a few things before starting this walkthrough:

• SSH access to your server, see our article (gs) Enabling SSH Access for detailed instructions.
• An enabled Ruby on Rails (RoR) container, this can be done through the AccountCenter.
• Rails and mongrel installed on your (gs) container, see our article (gs) HOWTO: Initial Setup of a Ruby On Rails (RoR) Container for detailed instructions.

Installing Radiant

1. Log into your server as 'serveradmin@mt-example.com' and cd to your rails container directory:

   cd ../../containers/rails

2. We will be installing Radiant as a gem, use this command to download it and get it installed:

   gem install --include-dependencies radiant

3. Make a directory for Radiant to live in and cd into it:

   mkdir radiant
   cd radiant

4. Use the 'radiant' command to tell it to copy the necessary files into this new directory:

   radiant .
   

5. Copy the radiant gem into your application, which will effectively freeze the version of radiant you are using.

    cp -a ~/data/rubygems/gems/gems/radiant-0.6.6 vendor/radiant
   

6. Add a database for Radiant to use. This must be done through the AccountCenter, for the purposes of this tutorial we've named our database db#####_radiant. Your database name will of course vary.
7. In your SSH window cd into the config directory, make a copy of database.MySQL.yml, name it database.yml and edit it:

   cd config
   cp database.mysql.yml database.yml
   vi database.yml

8. Enter your actual database user info into database.yml and save it. Instead of using the recommended socket connection we will enter your database host which can be found in the AccountCenter. The contents should look something like this:

   production:
     adapter: mysql
     database: db#####_radiant
     username: <mysql_username_here>
     password: <mysql_password_here>
     host: internal-db.s#####.gridserver.com
   
   





NOTE:

Please take special care to put the two spaces for each line under 'production:'. Not doing this will result in a failure running the next command.



9. Use the script provided with Radiant to set the database up:

   cd ~/../../containers/rails/radiant/
   RAILS_ENV=production rake db:bootstrap
   

10. Go back a directory and use the mtr command to add Radiant to your list of applications. This tutorial will use radiant.mt-example.com, be sure to replace this with your actual domain:

    cd ~/../../containers/rails/radiant/
    mtr add radiant $PWD radiant.mt-example.com

11. Generate the required htaccess file and create a link to the domain you'd like to use to host Radiant :

    mtr generate_htaccess radiant
    mtr create_link radiant

12. Use the mtr command to start Radiant:

    mtr start radiant

13. Log into Radiant via a browser, the username will be 'admin' and the password will be 'radiant':

    http://radiant.mt-example.com

Revisions:

07-20-2009: Minor Fixes