RailsPlayground
How To Install RadiantCMS

  1. Log on to your webserver via SSH
  2. Determine if the Radiant Gems are installed on your server by running the following command:
    gem list |grep radiant
    
  3. If your server does not have the Radiant Gems installed, please contact support (support@railsplayground.net) and request
    the Radiant Gems to be installed, once support notifies you that the correct GEMS have been installed move on to step 4.
  4. Install radiant by typing the following command in your SSH window:
    radiant --database [mysql|postresql|sqlite3] path/to/project 
    

    For most common installations you will use the mysql option for database. Your path for most common installations would be
    ~/radiant.
  5. Next you must create your database for radiant to use via Cpanel.
  6. In the Cpanel control panel select MySQL Database, give your new database a name and select the ‘Create Database’ button.
    Click the ‘Go Back’ Link.
  7. Next you must create and add a user for the new database.
    Under Add new user, type in a user name and password for the new user and click the ‘Create User’ button.
    Once the user has been created click the ‘Go Back’ link.
  8. Now you must add the new user to the database
    Under Add User to Database select the user you wish to add to the database, and select the database, then click the ‘Submit’ button.
  9. Add the appropriate permissions for the new user in the next screen and hit the ‘Submit’ button.
  10. Now you must tell Radiant what database and user account to use.
    Return to your SSH session. In your projects Config directory edit the database.yml file to reflect the database and user that you created. If you have created multiple databases for production, development and testing reflect the info in the appropriate headings in the database.yml.
  11. Now you must run the Radiant database bootstrap by executing the following command:
    rake production db:bootstrap
    

    Answer each of the prompts until you are finished.
  12. Next you need to edit the public/.htaccess file, change the line dispatch.cgi to dispatch.fcgi, you will also need to
    comment out the following line:
    # AddHandler fastcgi-script .fcgi
    
  13. Edit your environment.rb file to force rails into production mode by uncommenting the following line:
    # ENV['RAILS_ENV'] || = 'production'
    
  14. Add the following line in the environment.rb:
    ENV['HOME'] = '/home/username'
    
  15. Next, you will need to setup your symbolic link in one of two ways:
    1. If Radiant is going to run your main domain then you will need to create a symbolic link from your public_html to Radiant.
            mv ~/public_html ~/public_html_bk
            ln -s ~/radiant-0.5.2/public ~/public_html
      
    2. If Radiant will be running on a subdomain, first setup your subdomain in cPanel, then setup your symbolic link, for example we will use the subdomain blog.
            cd ~/public_html
            rm -rf blog
            ln -s ~/radiant-0.5.2/public ~/public_html/blog
      
  16. Finally, insure your /project/public directory is set to the correct permissions by running the chmod command and setting to 755.
  17. You should now be able to Login to your administration at http://domain.com/admin with the username ‘admin’ and the password ‘radiant’.