Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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).

...

Note
titleNotes:
  • We recommend that you perform the steps in this document via the command line as a cPanel user unless otherwise specified.
  • You can also use cPanel's Terminal interface ( cPanel >> Home >> Advanced >> Terminal) to perform these steps in cPanel & WHM version 72 and later.
  • In this document, user represents the cPanel user, and greenmine represents the Redmine web application's name.

For more information, read Redmine's documentation.

Install Redmine

...

Section


Column
width72px


Column

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
    titleNote:

    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
    titleNote:

    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:

Code Block
languagebash
yum install ea-ruby24-mod_passenger ea-ruby24-ruby-devel ImageMagick-devel ea-apache24-mod_env



...

Section


Column
width72px


Column

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:

Note
titleNote:

In the following examples, redmine-X.X.X.tar.gz represents the most recent redmine version.

  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
    titleNote:

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


    Code Block
    languagebash
    wget url http://www.redmine.org/releases/redmine-X.X.X.tar.gz


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

    Code Block
    languagebash
    tar xvzf redmine-X.X.X.tar.gz


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

    Code Block
    languagebash
    mv /home/$user/redmine-X.X.X /home/user/greenmine


    Tip
    titleRemember:

    greenmine represents your web application's name.



...

Section


Column
width72px


Column

Create the database and database users.

After you extrac thte 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:

    Expand
    titleClick to view...


    Code Block
    languagebash
    linenumberstrue
    # 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



 

 

...


Section


Column
width72px


Column

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).


 


 

Section


Column
width72px


Column

Restart apache.

Warning
titleImportant:

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:

Code Block
languagetext
/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).


 Additional documentation

Localtab Group


Localtab
activetrue
titleSuggested documentation

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("ruby","apache") and label = "whm" and space = currentSpace()


Localtab
titleFor cPanel users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("ruby","apache") and label = "cpanel" and space in (currentSpace(),"72Docs76Docs")


Localtab
titleFor WHM users

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("ruby","apache") and label = "whm" and space in (currentSpace(),"DOC")


Localtab
titleFor developers

Content by Label
showLabelsfalse
max5
showSpacefalse
cqllabel in ("ruby","apache") and space = "DD"


...