Overview

This document describes how to install the Redmine web application. The Redmine application is a project management web application that functions on the Ruby platform. You can register the Redmine application in cPanel’s Application Manager interface (cPanel >> Home >> Software >> Application Manager).

For more information, read Redmine’s documentation.

Install Redmine

Pre-installation settings.

Before you begin, ensure that you remove the operating system-provided Ruby installation. Then, install Ruby via the following RPMs:

• ea-ruby24-mod_passenger
  Note:

  If you enable this module, the system will disable

  Apache’s mod_userdir module.

  • ea-ruby24-ruby-devel

  • ImageMagick-devel

  • ea-apache24-mod_env

  Note:

  The ea-apache24-mod_env module allows you to add environment variables when you register your application. For more information about environment variables, read our Application Manager documentation.

  To install these RPMs, run the following command as the root user:

  <p>yum install ea-ruby24-mod_passenger ea-ruby24-ruby-devel ImageMagick-devel ea-apache24-mod_env</p>

  Install the bundler gem

  To install the bundler Ruby gem, run the following command as a cPanel user:

  <p>scl enable ea-ruby24 &lsquo;gem install bundler --user-install&rsquo;</p>

  If you do not wish to use the scl utility, perform the following steps to install the bundler Ruby gem:

  1. Log in to the server as a cPanel user.

  2. Add the following line to your shell’s rc file (for example,/home/user/.bashrc file):

     <p>source /opt/cpanel/ea-ruby24/enable</p>

  3. Log out of your terminal session, and log back in again.

  Note:

  You can also create an additional terminal session.

  1. Run the gem install bundler --user-install command.

  Extract the redmine archive file

  After you install the bundler and rake Ruby gems, download the application and extract the archive file. To do this, perform the following steps:

  1. Access the Redmine website in a web browser.

  2. Download the most recent .tar.gz file from the Stable Releases section. To do this, run the following command:

  Note:

  Make certain that you install wget before you run this command.

  <p>wget url <a href="http://www.redmine.org/releases/redmine-X.X.X.tar.gz">http://www.redmine.org/releases/redmine-X.X.X.tar.gz</a></p>

  1. Extract the .tar.gz file’s contents. To do this, run the following command:

     tar xvzf redmine-X.X.X.tar.gz

  2. After you extract the .tar.gz file, rename the file to your Ruby application’s name. To do this, run the following command:

     mv /home/$user/redmine-X.X.X /home/user/greenmine

  Note:

  In the above examples: * redmine-X.X.X.tar.gz represents the most recent redmine version. * greenmine represents your web application’s name.

  Create the database and database users

  After you extract the redmine archive file, create the application’s database and configure the database users. To do this, perform the following steps:

  1. Create production and development databases and database users in cPanel’s MySQL Database Wizard interface (cPanel >> Home >> Databases >> MySQL Database Wizard).

  2. Copy the contents of the /home/user/greenmine/config/database.yml.example file to the /home/user/greenmine/config/database.yml file.

  3. Open the /config/database.yml file with a text editor.

  4. Add the following information to the file:

     • The databases’ names.
     • The databases’ usernames.
     • The databases’ passwords. The file will resemble the following example:

  Click to view...

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

  # Default setup is given for MySQL with ruby1.9. # Examples for PostgreSQL, SQLite3 and SQL Server can be found at the end. # Line indentation must be 2 spaces (no tabs). production: adapter: mysql2 database: kermit_greenminetest host: localhost username: kermit password: "misspiggy1" encoding: utf8 development: adapter: mysql2 database: kermit_greenmine_development host: localhost username: kermit_dev password: "fozzy1" encoding: utf8

      </div>
  </div>
  

  Install your Ruby Gems

  To install the Ruby Gems that reside in the /home/user/greenmine/Gemfile file, change to the /home/user/greenmine directory and run the following command.

  scl enable ea-ruby24 ‘bundle install’

  Create a secret key

  After you install your Ruby Gems, create the “secret” key, which the system uses to encode cookies. To generate the “secret” key, run the following command:

  scl enable ea-ruby24 ‘rake secret’

  This command returns a key hash that resembles the following example:

  <p>0d3f00336c10ac419f9ed08b4448dc1e652179b86eb1c434d3e4cf68b15aa92fbac1dc1f24a19b150b63a133fe4e89b8fb79ca5e78026bcbcf8ce183f5c9ca8c</p>

  After you create the secret key, create the /home/user/greenmine/config/secrets.yml file and add the following content:

  1 2	production: secret_key_base: secretkey

  Note:

  Replace secretkey with the key that the scl enable ea-ruby24 'rake secret' command returned.

  Create the database structure

  After you add the security key to the /home/user/greenmine/config/secrets.yml file, create the database structure. To do this, change to the /home/user/greenmine directory and run the following command:

  RAILS_ENV=production scl enable ea-ruby24 ‘bundle exec rake db:migrate’

  The output will resemble the following partial example:

  1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

  == 20160416072926 RemovePositionDefaults: migrating =========================== -- change_column("boards", :position, :integer, {:default=>nil}) -> 0.0025s -- change_column("custom_fields", :position, :integer, {:default=>nil}) -> 0.0024s -- change_column("enumerations", :position, :integer, {:default=>nil}) -> 0.0023s -- change_column("issue_statuses", :position, :integer, {:default=>nil}) -> 0.0021s -- change_column("roles", :position, :integer, {:default=>nil}) -> 0.0022s -- change_column("trackers", :position, :integer, {:default=>nil}) -> 0.0020s == 20160416072926 RemovePositionDefaults: migrated (0.0139s) ================== == 20160529063352 AddRolesSettings: migrating ================================= -- add_column(:roles, :settings, :text) -> 0.0109s == 20160529063352 AddRolesSettings: migrated (0.0109s) ========================

  Create the data configuration

  After you create the database structure, create the database’s default configuration data set. To do this, perform the following steps:

  1. Run the following command:

     RAILS_ENV=production scl enable ea-ruby24 ‘bundle exec rake redmine:load_default_data’

  2. When the system prompts you, select the database’s locale. To do this, enter your chosen locale’s two letter abbreviation in the command line. For example:

     <p>Select language: ar, az, bg, bs, ca, cs, da, de, el, en, en-GB, es, es-PA, et, eu, fa, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, lv, mk, mn, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sq, sr, sr-YU, sv, th, tr, uk, vi, zh, zh-TW [en] en-GB</p>

  Note:

  This example selects British English ( en-GB ) as the database’s locale.

  Set the file system permissions

  After you create the database’s data configuration, set the file system permissions. To do this, change to the /home/user/greenmine directory and run the following series of commands:

  1 2 3

  $ mkdir -p tmp tmp/pdf public/plugin_assets $ chown -R user. files log tmp public/plugin_assets $ chmod -R 755 files log tmp public/plugin_assets

  Register the application

  After you set the file permissions, register your web application. To do this, use UAPI’s PassengerApps::register_application function, or cPanel’s Application Manager interface (cPanel >> Home >> Software >> Application Manager).

  Restart apache

  Important:

  This step is optional. UAPI’s register_application function performs an Apache restart, but may not execute immediately.

  After you register the Apache configuration, restart Apache. To do this, run the following command as the root user:

  /usr/local/cpanel/scripts/restartsrv_httpd

  After Apache restarts, you can access the greenmine application in cPanel’s Application Manager interface (cPanel >> Home >> Software >> Application Manager).