This step by step tutorial guides you through the detail process of installing Redmine 4.1.0 on Ubuntu 19.10. During installation there are few build errors related to nokogiri and mysql2, this post describes how to install redmine on Disco Dingo Ubuntu 19.10 with solved build errors.
To get working Redmine 4.1.0 we need to follow following steps (total 8 steps) :
Step 1 :Install redmine on Disco Dingo Ubuntu 19.10
First step is to check and install apache server. Open your terminal by pressing Alt+Ctrl +T and enter following command to install Apache2 server
sudo apt install apache2 libapache2-mod-passenger
after execution of above command , visit http://localhost/ on your browser to check proper installation
Step 2: Install Redmine Application
To install redmine application , visit https://www.redmine.org/projects/redmine/wiki/Download and download redmine tar.gz package.
After Downloading Enter following commands in terminal (first make sure you are in Downloads Directory ) to place Downloaded application to /usr/share/ directory
Copy redmine tar.gz file to /usr/share/
sudo cp redmine-4.1.0.tar.gz /usr/share/
Extract This compressed file
sudo tar -xvzf redmine-4.1.0.tar.gz
Now , remove tar.gz file as it is not needed afterwords
sudo rm redmine-4.1.0.tar.gz
we can see following directory structure in redmine folder
Step 3 : Install MySql and Create an Empty Redmine Database
Enter following command to install MySql server as well as client
sudo apt-get install mysql-server mysql-client
Now , check MySql Version
mysql – -version
Now , create Empty database as root/super user
Now that we have all the privilages to change the system , create empty database
Enter following command to create database
CREATE DATABASE redmine CHARACTER SET utf8mb4;
create user redmine with password ‘my_password’
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
Grant all access to user
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
Now , exit MySql
Step 4 : DATABASE configuration
Copy Following details to config/database.yml file
above command will open gedit editor (you can use vim ,nano, emacs or any other editor also) . Now paste above configuration in this opened file , save and close it.
Note: make sure you are in Redmine directory and You are standard user . If you edit database.yml as a super user (# prompt ) , standard user can only read this file and cannot edit it ) . so make sure there is $ prompt not #.
Step 5 : Dependency Installation
In this step we will install lots of ruby gems (59 total ) and other dependencies (total 31)
Enter following commands as standard user ($ prompt)
sudo gem install bundler
bundle install --without development test
Here , you may face the Nokogiri dependency error, “an error occurred while installing nokogiri (1.10.9) and bundler cannot continue”
This occur due to multi level dependencies .
To resolve this , we need to manually install nokogiri gem.
sudo apt-get install build-essential patch ruby-dev zlib1g-dev liblzma-dev
sudo gem install nokogiri -v 1.10.3
Again run above command to continue on how to Install Redmine on Disco Dingo Ubuntu 19.10.
bundle install --without development test
This time we get error for myslq2 ” an error occured while installing mysql2 (0.5.3) and bundler cannot continue, Make sure that ‘get install mysql2 -v ‘0.5.3’ –source ‘https://rubygems.org/’ succeeds before bundling.
We need to install MySql client to proceed, follow below steps to install it.
sudo apt-get install libmysqlclient-dev
again enter bundle command
sudo bundle install –without development test
Step 6: Database Schema Objects Creation
Generate a random key used by Rails to encode cookies storing session data thus preventing their tampering.
bundle exec rake generate_secret_token
Create the database structure, by running the following command under the application root directory i.e./usr/share/redmine-4.1.0
RAILS_ENV=production bundle exec rake db:migrate
If Rake abort appears , check database.yml file and confirm the accuracy of username and password and try again.
Then insert default configuration data in database, by running the following command
This step will ask to select language. Select en for english.
RAILS_ENV=production bundle exec rake redmine:load_default_data
Step 7: Test Installation
Test the installation by running WEBrick web server:
bundle exec rails server webrick -e production
Now , open url http://0.0.0.0:3000 in your browser to launch redmine .( The URL is given in above pitcher . It may vary .)
Click on sign In and log in using default credentials i.e. Username : admin , password : admin
You will be asked to change your password to custom one . Now set the password of your choice .and save it.
Also you change account details from My account .
Click on administration -> information to check Redmine details.
Step 8 : Plugin Installation
Redmine 4.1.0 is installed on Ubuntu 19.10 Now lets install a plugin to check its working .
enter following command ( first check you are in plugin sub directory in redmine directory). to install pivot table plugin
git clone git://github.com/deecay/redmine_pivot_table
If Git is not installed on your system, above command will not execute . So, first Install Git by executing following command and try again
sudo apt-get install git
after successfull execution of git clone command, run following command
sudo RAILS_ENV=production rake redmine:plugins:migrate
Now , restart redmine to see the plugin added .
In this way, we have completed how to install redmine on Disco Dingo Ubuntu 19.10 with solved build errors and also added pivot table plugin to it for testing its working.