Redmine Installation and Starting Guide
programming help stk
Redmine is a free and flexible open source tool for project management and error tracking, written using the Ruby On Rails environment.
Redmine supports several projects, with their own wiki, forum, time tracker and problems management.
In addition, Redmine implements platform plug-ins, so it can be configured depending on your requirements. There are plugins to work with Kanban, Scrum, notification plugins or reports.
What I really like in Redmine is that, although it does not define how you should work, it contains enough parameters to work with any type of project management.
Redmine can be installed differently: Using WEBRICK (not recommended in the production environment). Run with a mongrel and fastghi. Using the passenger. Or pack Redmine to war and expand to a Java container, such as Tomcat or Glassfish.
In this post, I am going to show you how to pack Redmine 1.3 to the War file so that it can be launched in Tomcat7 and Linux. The idea should be working with GlassFish, JBOSS or any other OS.
First of all, download Jruby 1.6.6, so open the terminal
Wget http://jruby.org.s3.amazonaws.com/downloads/1.6.6/jruby-bin-1.6.6.tar.gz.
Unpack the downloaded file and go to the / usr / share directory.
TAR XVZF Jruby-Bin-1.6.6.tar.gz Sudo MV Jruby-1.6.6 / /usr/Share/Jruby-1.6.6
Then update the environment variables using the Jruby setting directory.
Sudo Gedit / etc / Environment one
2. Path = ...: /usr/Share/Jruby-1.6.6/bin
Jruby_home = "/ usr / share / jruby-1.6.6"
Finally, try to execute Jruby to make sure it is installed correctly:
jruby -V.
And information about the version of Jruby should be printed on the console.
The next step is to install the necessary precious stones: one
2.
Z.
C. five sh sh
8 nine
GEM Install Rack -V = 1.1.1
GEM INSTALL RAILS -V = 2.3.14 gem install rdoc -v = 2.4.2
GEM Install ActiveRecord-jdbcmysql-adapter -v = 1.2.2
GEM Install Warbler -V = 1.3.2
GEM Install Jruby-OpenSSL -V = 0.7.5
GEM Install Rubytree -V = 0.8.2 gem install i18n -v = 0.4.2
Gem Install Tree -V = 0.2.1
Set Redmine
Download Redmine 1.3 and install them in the / usr / share directory: one
2.
3. four
Wget http://rubyforge.org/frs/download.php/75597/redmine-1.3.0.tar.gz.
TAR XVZF Redmine-1.3.0.tar.gz
Sudo MV Redmine-1.3.0 /usr/Share/Redmine-1.3.0
Redmine requires a database for work.In this case, I already installed MySQL5, but also supported postgesql.So, let's configure MySQL in Redmine.
CD /USR/Share/Redmine-1.3.0/config/
The installation goes with the database template configuration file, we are going to rename it and change according to our medium.In addition, RedMine contains various launch modes (production, development, testing).In our case, since we are tightening the production environment, only the production section will be affected. one
2.
CP Database.yml.example Database.yml
Sudo Gedit Database.yml one
2. Z.
C. five sh sh
PRODUCTION:
Adapter: jdbcmysql
Database: Redmine.
Host: Localhost.
UserName: redmine.
Password: redmine.
Encoding: UTF8.
After this modification, it's time to create a user and a redmine database in MySQL.
MySQL -u root -p one
2.
3.
CREATE DATABASE REDMINE CHARACTER SET UTF8;
Create User 'Redmine' @ 'Localhost' identified by 'redmine';
GRANT ALL Privileges on Redmine. * to 'Redmine' @ 'Localhost';
Now it's time to initialize redmine one 2.
CD /USR/Share/Redmine-1.3.0
Rake Generate_Session_Store.
The next step is necessary because we set Redmine 1.3, in the following versions of Redmine 1.4 and above will not be necessary.Open Config / Environment.rb and comment on the following as:
Config.gem Rubytree: Lib => Tree
And then create a database schema and fill out by default data using the following scenarios. one
2.
Rails_env = PRODUCTION RAKE DB: MIGRATE
Rails_env = Production Rake Redmine: Load_Default_Data
Now we are going to check whether redmine is correctly configured.To do this, we will use Webry. one
2.
CD /USR/Share/Redmine-1.3.0
Jruby Script / Server Webrick -E Production
and open the browser at http: // LocalHost: 3000 to start checking the installation.
Redmine Web Page will be displayed, you can log in with the user name and password Admin / Admin
At the moment we have redmine installed.
Email Setup
The problem tracking system should be able to send mail to affected users when a new problem is created or changed by change. If your mail server requires TLS security protocol, you must install the Action_Mailer_Optional_tls plugin.
This plugin requires Git if you have not yet installed, enter:
Sudo Apt-Get Install Git
And then complete the command in the Redmine directory:
Jruby Script / Git: //github.com/collectiveidea/ACTION_Mailer_Optional_tls.git
Let's configure email delivery: one
2.
3.
CD /USR/Share/Redmine-1.3.0/config/
CP Configuration.yml.example Configuration.yml
Sudo Gedit Configuration.yml.
Inside the configuration file, you will find general email settings.Depending on your email server, these attributes can vary greatly, so at this stage I am going to show you a simple configuration of the SMTP server using simple authentication in the production environment.Go to the last row of the configuration.yml file and add the following lines to the work section.
01.
02.
03.
04.
05.
06.
07. 08.
09. ten
Production: # This Line Is Already Present In Configuration.yml.
email_delivery:
Delivery_Method :: SMTP
SMTP_Settings:
Address: "Example.com"
Port: 25.
Authentication :: Plain
Domain: 'Example.com'
user_name: 'myaccount'
Password: 'password'
All attributes speak for themselves.
And before creating a War file, let's check whether the email is correctly configured. We again use Webric. one
2.
CD /USR/Share/Redmine-1.3.0
Jruby Script / Server Webrick -E Production
Then open the browser at http: // LocalHost: 3000 and log in with the administrator account.
Configure the administrator's email address by clicking the "My Account" link, and in the Email section, set the administrator's email address. After that, we are going to test the email configuration, in the main menu, go to "Administration" -> "Settings" -> "Email Notifications", add an email and click "Check email". After some time, the test message will be sent to the email address of the administrator.
We managed to install Redmine, now it's time to pack it in Tomcat.
Packing Redmine.
Before starting due to incompatibility with the Jruby-Rack gem installed, we must launch the following commands to install version 1.0.10 Jruby-Rack. one
2.
GEM Uninstall Jruby-Rack
GEM Install Jruby-Rack -V = 1.0.10
The Warble command requires a configuration file.This file is created using the following command: one
2.
3. four five
CD /USR/Share/Redmine-1.3.0.
Warble Config
CD Config /
Sudo Gedit Warble.rb.
Edit the Warble :: Config section and configure the CONFIG.DIRS, Config.gems and Config.Webxml.rails.RAILS.Env sections as follows: one 2.
3. four five
Warbler :: Config.New Do | Config |
Config.Dirs =% W (App Config Lib Log Vendor TMP Extra Files Lang)
config.gems + = ["ActiveRecord-JDBCMYSQL-Adapter", "jruby-openssl", "i18n", "Rack", "Tree"]
config.webxml.rails.env = env ['Rails_env'] || 'PRODUCTION'
End.
And finally, run:
trill
And Redmine War was created and ready for deployment in Tomcat.
Despite the fact that we have a War file, I do not recommend deleting the Redmine setting directory as it can be used in the future to install new plugins or changes any configuration. After the modification calling the Warble command, a new war with this change will be created.
I wish you to find it useful.
Reference: Installation and Starting Guide with RedMine from our JCG partner