How to Set Up Orangescrum on CentOS 7

Table of Contents

• Introduction
• Requirements
• Install the required packages
  • Install MySQL
  • Install PHP
• Download Orangescrum and upload it to the Apache web directory
• Configure MySQL
• Configure PHP
• Configure Apache
• Configure Orangescrum
• Test Orangescrum

Introduction

Orangescrum is the ideal open source, free project management and collaboration tool for small and medium businesses. It helps you to manage projects, teams, documents, and tasks, all in one place.

You can organize your tasks, communicate with the team on important issues, and manage project documents easily using Orangescrum.

Orangescrum provides various features like agile project management, collaboration, issue tracking, notifications, reporting, task management, and traditional project management functionality for small/medium businesses.

Requirements

• A server running CentOS v. 7 with Apache installed
• A static IP address for your server

Install the required packages

This section will walk you through the process of preparing your server for installing MySQL and PHP.

Install MySQL

By default the MySQL package is not available in CentOS 7. You will need to download and install the MySQL RPMs.

You can do this by running:

sudo wget http://repo.mysql.com/mysql-community-release-el7-5.noarch.rpm
sudo rpm -ivh mysql-community-release-el7-5.noarch.rpm

After the installation of this package, you can install MySQL using the following command:

sudo yum install mysql-server

After this, start the mysql service and enable mysql to start on boot.

sudo systemctl start mysqld
sudo systemctl enable mysqld

Install PHP

After installing MySQL, you need to install PHP. To do this, run:

sudo yum install httpd php php-mysql php-gd php-ldap php-odbc php-pear php-xml php-xmlrpc php-mbstring php-snmp php-soap curl curl-devel

After this, start the apache service and enable apache to start on boot.

sudo systemctl start httpd
sudo systemctl enable httpd

Download Orangescrum and upload it to the Apache web directory

To download the Open Source version of Orangescrum run:

sudo wget https://github.com/Orangescrum/orangescrum/archive/master.zip

After downloading Orangescrum you will need to unzip master.zip. To do this, run:

sudo unzip master.zip

This will create the orangescrum-master directory.

Rename this directory to orangescrumPM and move it to your Apache web directory. You can do this by running:

sudo mv orangescrum-master /var/www/html/orangescrumPM

Give the orangescrumPM directory the correct permissions:

sudo chown -R apache:apache /var/www/html/orangescrumPM
sudo chmod -R 777 /var/www/html/orangescrumPM

Configure MySQL

First you need to setup the MySQL root password. You can do this by running:

sudo mysql_secure_installation

Answer all the questions shown as below:

Enter current password for root (enter for none): [Type your root password]
Set root password? [Y/n]: [Press Enter]
New password: [Type your new MySQL root password]
Re-enter new password: [Type your new MySQL root password]
Remove anonymous users? [Y/n]: [Press Enter]
Disallow root login remotely? [Y/n]: [Press Enter]
Remove test database and access to it? [Y/n] : [Press Enter]
Reload privilege tables now? [Y/n] : [Press Enter]

All done! If you have completed all of the above steps, your MySQL installation should now be secure.

Now you need login to MySQL and create a database and user for Orangescrum. You can do this by running following commands:

Log into MySQL:

sudo mysql -u root -p

Create a database named orangescrum:

mysql> create database orangescrum;

Create a user named orangescrum:

mysql> create user orangescrum;

Grant all privileges while assigning the password:

mysql> grant all on orangescrum.* to 'orangescrum'@'localhost' identified by 'orangescrum';

Exit from the MySQL shell:

mysql> exit

Next you need to import the data from the database.sql file located in the /var/www/html/orangescrumPM directory.

You can do this by running:

sudo cd /var/www/html/orangescrumPM/
sudo mysql -u orangescrum -porangescrum < database.sql

Next, By default STRICT mode is set to On in MySQL. You will need to disable it.

You can do this by editing the my.cnf file:

sudo nano /etc/my.cnf

Find and change the line from:

sql-mode="STRICT_TRANS_TABLES,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"

To:

sql_mode=NO_ENGINE_SUBSTITUTION,STRICT_TRANS_TABLES

Save and close the file, then restart MySQL to reflect changes.

sudo systemctl restart mysqld

Configure PHP

Now you need to change the post_max_size and upload_max_filesize to 200M in the php.ini file:

sudo nano /etc/php.ini

Find and change the value from 2M to 200M:

post_max_size=200M
upload_max_filesize=200M

Save and close the file.

Configure Apache

First, create a virtual host file for Orangescrum:

sudo nano /etc/httpd/conf.d/orangescrum.conf

Add the following content:

<VirtualHost 192.0.2.0:80>
ServerName localhost
DocumentRoot /var/www/html/orangescrumPM
<Directory /var/www/html/orangescrumPM>
AllowOverride All
Order allow,deny
allow from all
</Directory>
</VirtualHost>

When you are finished, check the syntax of the configurations. You can do this with the following command:

sudo apachectl configtest

After the syntax check is done, restart Apache to make these changes take effect:

sudo systemctl restart httpd

Configure Orangescrum

Now you need to edit the database.php file to update the database connection details:

sudo nano /var/www/html/orangescrumPM/app/Config/database.php

Change the file as shown below:

class DATABASE_CONFIG {

    public $default = array(
            'datasource' => 'Database/Mysql',
            'persistent' => false,
            'host' => 'localhost',
            'login' => 'orangescrum',
            'password' => 'orangescrum',
            'database' => 'orangescrum',
            'prefix' => '',
            'encoding' => 'utf8',
    );
}

Save and close the file when you are finished.

Next, you need to provide your valid email address and password for SMTP, and update the FROM_EMAIL_NOTIFY and SUPPORT_EMAIL configurations in the constants.php file:

sudo nano /var/www/html/orangescrumPM/app/Config/constants.php

Change the following lines as per your need:

//Gmail SMTP
define("SMTP_HOST", "ssl://smtp.example.com");
define("SMTP_PORT", "465");
define("SMTP_UNAME", "jdoe@example.com");
define("SMTP_PWORD", "[Your email password]");

define('FROM_EMAIL_NOTIFY', 'jdoe@example.com'); //(REQUIRED)
define('SUPPORT_EMAIL', 'jdoe@example.com'); //(REQUIRED) From Email
define("DEV_EMAIL", 'jdoe@example.com'); // Developer Email ID to report the application error

define('SUB_FOLDER', '/');</code></pre>

Save and close the file when you are finished.

Test Orangescrum

From your desktop computer, open your browser and go to the URL http://your.server.ip.address.

You will be asked to provide your company name, email address, and a password to login and start using Orangescrum.

After this, you should see the Orangescrum default welcome page shown here: