1. Local Installation

Prerequisites

DMPonline is a Ruby on Rails application and you'll need to have Ruby 2.0.0p247 [x86_64-linux], plus Rails 3.2.13 on your server and a MySQL server v5.1 or greater.

You will need to ensure you have RubyGems installed too. If you've had to upgrade the version of Ruby running on your server, don't forget to update the gems system too by running the following:

$> gem update --system
$> gem install bundler

Further details on how to install Ruby on Rails applications are available from the Ruby on Rails site.

While not a prerequisite, we are running this using Phusion Passenger 4 with an Apache webserver on Red Hat 4.4.7

The shell utility wkhtmltopdf is used to create PDF output and so this needs to be installed on your server.

Getting started

After downloading, create a config/database.yml file based on the provided config/database_example.yml file. Currently only MySQL databases are supported.

Edit the configuration files at config/environments to include your contact email addresses.

Edit the configuration setting config.action_mailer.default_url_options in config/application.rb

Edit values for config.mailer_sender and config.pepper in config/initializers/devise.rb

Set a secret token in config/initializers/secret_token.rb

If wkhtmltopdf is not installed to /usr/local/bin/wkhtmltopdf then you will need to edit the config value in config/initializers/wicked_pdf.rb

You'll need to install the gems, build the database and start the server:

$> cd dmponline4  
$> bundle update  
$> rake db:setup  

In a development environment where you're not using Passenger or an equivalent deployment method, start the server with

$> rails server  

and go to localhost:3000