Redmine

h1. HowTo Install Redmine 2.5.x on Fedora 20

{{toc}}

h2. System Requirements

No assumptions are made about the initial state of the system in this guide. The guide can be followed for either 32-bit or 64-bit systems - though all testing and the original installation was performed on a 64-bit system.

The hardware requirements are not significant, so a small VM with 10gb storage and 1GB ram and 1GB swap file should be sufficient.

This guide can be used on top of an already existing system or, from scratch, downloading from the Fedora website.

An ISO for installation can be downloaded from "here":http://fedoraproject.org/en/get-fedora.

The rest of the guide assumes that you have created a user account with wheel/administrator access and are logged in to the terminal directly or through SSH.

h2. Updating the System

Before beginning, you should ensure all of your installed packages are up-to-date. This can be done by issuing the following command:

<pre>

$ sudo yum update

</pre>

If the kernel was updated as part of this command, you should perform a restart to begin using it:

<pre>

$ sudo shutdown -r now

</pre>

h2. Installing Dependencies

Before beginning the installation of Redmine, there are a number of dependencies which need to be installed.

Depending on your needs, some of these may not be necessary.

<pre>

apr-devel         - For Passenger

apr-util-devel    - For Passenger

curl-devel        - For Passenger

gcc               - For JSON

gcc-c++           - For Passenger

git               - (Optional) For SCM Integration

httpd             - Web Server

httpd-devel       - For Passenger

ImageMagick-devel - For RMagick

mariadb-devel     - For Redmine

mariadb-server    - For Redmine

nano              - Configuration Editor

ruby-devel        - For Redmine

tar               - For Decompression

wget              - For Download

</pre>

All of these can be installed prior to starting with a single command:

<pre>

$ sudo yum install apr-devel apr-util-devel curl-devel gcc gcc-c++ git httpd httpd-devel ImageMagick-devel mariadb-devel mariadb-server nano ruby-devel tar wget

</pre>

h2. Disable SELinux

Some users have noted issues installing Redmine with SELinux active. This can be disabled via the following command:

<pre>

# sudo setenforce 0

</pre>

Steps will be taken throughout the remainder of the guide to ensure that, if desired, SELinux can be re-enabled after and still maintain a fully functional Redmine installation.

h2. Enable Server Environment

With all of the dependencies installed, we need to ensure that the servers are setup, ready for use, and accessible external to the OS installation.

The first step is to open the standard port 80 in the firewall for the web server:

<pre>

$ sudo firewall-cmd --zone=public --add-service=http

$ sudo firewall-cmd --permanent --zone=public --add-service=http

</pre>

The first line opens the port in the current configuration. The second line ensures that, after a restart, that port will remain open and available.

The second step is to start the web server and database server:

<pre>

$ sudo systemctl start httpd mariadb

$ sudo systemctl enable httpd mariadb

</pre>

Similar to the firewall commands, the first line starts the servers in the current configuration. The second line ensures that, after a restart, both servers come back online.