Browse Library
Sign In Start Free Trial
Close icon Search icon
Account
Browse Library Advanced Search Sign In Start Free Trial

Add to playlist

Create a Playlist

Modal Close icon
You need to login to use this feature.
  • Book Overview & Buying Redmine Cookbook
  • Table Of Contents Toc
  • Feedback & Rating feedback
Redmine Cookbook

Redmine Cookbook

By : Pavic
Buy this Book
close
close
Redmine Cookbook

Redmine Cookbook

By: Pavic
Buy this Book

Overview of this book

In a variety of online project management tools, Redmine markets itself as offering flexibility. Choosing the right management tool can mean the difference between the success and failure of a project. Flexible project management tools bend themselves to fit your needs, whether that’s communication regarding a simple project, or collaboration, or more complex project methodology such as SCRUM, or an issue-code relationship, or the need of different methodology for your project. Whether you are project manager or system administrator, this book provides valuable recipes to get the best possible performance out of your team, organization, infrastructure, and Redmine itself. Through a series of carefully crafted recipes covering the nitty-gritty of Redmine, you’ll be guided through the installation of Redmine, as well as how to fine-tune and customize your Redmine installation. Finally, we walk you through integrating Redmine with other softwares and databases like Tortoise SVN and Visual Studio and troubleshooting Redmine.
Table of Contents (12 chapters)
close
close
close
Preface
Icon
Preface
Icon
What this book covers
Icon
What you need for this book
Icon
Who this book is for
Icon
Sections
Icon
Conventions
Icon
Reader feedback
Icon
Customer support
Lock Free Chapter
1
1. Installing and Running Redmine
chevron up
Icon
1. Installing and Running Redmine
Icon
Introduction
Icon
Default installation on an Ubuntu server
Icon
Installing from a source on Ubuntu
Icon
Installation on Windows servers
Icon
Using Puma and IIS on Windows
Icon
Running with Apache as mod_fcgid
Icon
Running Redmine with Phusion Passenger
Icon
Running Redmine with Nginx and Thin
Icon
Installing optional requirements
Icon
Using custom Ruby for Redmine
2
2. Customizing Redmine
Icon
2. Customizing Redmine
Icon
Introduction
Icon
Customizing My page
Icon
Editing Redmine's views manually
Icon
Customizing modules per project
Icon
Extending user profiles with additional data
Icon
Customizing User roles
Icon
Creating and using User groups
Icon
Customizing the layout of the project entry page
Icon
Customizing the layout of the home page
Icon
Interacting with Redmine only through e-mail
3
3. Project Management with Redmine
Icon
3. Project Management with Redmine
Icon
Introduction
Icon
Splitting your project into phases
Icon
Creating and using subprojects
Icon
Splitting your tasks into subtasks
Icon
Managing issue relations
Icon
Creating and using template projects
Icon
Managing multiple projects simultaneously
Icon
Creating reports on spent time
Icon
Making sure everyone is optimally loaded with work
Icon
Relating between issue and time
Icon
Using the issue-code relation
Icon
Defining a roadmap to the release plan
4
4. Improving Team Performance
Icon
4. Improving Team Performance
Icon
Introduction
Icon
Keeping relevant documentation in Redmine
Icon
Putting the timeline to good use
Icon
Making sure that everyone is informed
Icon
Limiting access to some team members
Icon
Using metrics to improve team performance
Icon
Analyzing team performance through the code repository
Icon
Using the repository module to display code differences
Icon
Managing multicultural teams in different time zones
Icon
Applying advanced issue-code relationships
Icon
Improving Scrum meetings and backlogs
5
5. Regular and Planned Maintenance
Icon
5. Regular and Planned Maintenance
Icon
Introduction
Icon
Starting and restarting Redmine
Icon
Checking for active Redmine processes on the server
Icon
Configuring backup and recovery
Icon
Checking the data dirs for possible malware
Icon
Migrating and upgrading
Icon
Upgrading or migrating the database behind Redmine
Icon
Enhancing security
Icon
Upgrading Ruby safely
6
6. Performance and System Tuning
Icon
6. Performance and System Tuning
Icon
Introduction
Icon
Fine-tuning new project creation
Icon
Tuning authentication and auto-login features
Icon
Tuning the workflows
Icon
Setting the log level
Icon
Getting the most from a single server
Icon
Scaling Redmine across multiple servers
Icon
Increasing file upload size
Icon
Integrating Redmine with Active Directory
7
7. Integrating Redmine with Other Software
Icon
7. Integrating Redmine with Other Software
Icon
Introduction
Icon
Exporting to Microsoft Project
Icon
Using Redmine through browser plugins
Icon
Using Redmine mobile applications
Icon
Activity monitoring through Atom feed
Icon
Embedding Redmine into a web application
Icon
Using the Redmine REST API with PHP
Icon
Using the Redmine REST API with C#
Icon
Integrating with Tortoise SVN or GIT
Icon
Interacting with Redmine from Visual Studio
8
8. Getting the Most Out of Scripts and Plugins
Icon
8. Getting the Most Out of Scripts and Plugins
Icon
Introduction
Icon
Pasting images from clipboard
Icon
Keeping track of your clients
Icon
Redmine for document management
Icon
Implementing and using reoccurring tasks
Icon
Practicing Kanban
Icon
Importing issues to Redmine
Icon
Using Redmine with Jenkins
Icon
Using the assigned issues summary e-mail
Icon
Text formatting with CKEditor
Icon
Being Agile with Agile Dwarf
9
9. Troubleshooting
Icon
9. Troubleshooting
Icon
Introduction
Icon
Where to get help and how to get help faster
Icon
Troubleshooting bundler installation
Icon
Troubleshooting Apache installations
Icon
Troubleshooting plugin installation
Icon
E-mail sending issues
Icon
Incoming e-mail parsing issues
Icon
Recovering from system failure
Icon
Tackling a delayed response from the server
10
10. Making the Most of Redmine
Icon
10. Making the Most of Redmine
Icon
Introduction
Icon
How to convince management to use Redmine
Icon
Redmine as a Helpdesk with auto-responder
Icon
Using Redmine as a service desk platform
Icon
Improving Redmine Security for ISO 27000
Icon
Redmine and SLA
Icon
KPIs inside Redmine
Icon
Using Redmine with ITIL
11
Index
Icon
Index

Running Redmine with Phusion Passenger

Phusion Passenger is a Ruby application server that was originally designed to run web applications (such as Redmine) that were built on the Ruby on Rails framework. Nowadays it has evolved, and besides Ruby applications, it supports Python and Node.js, making it a good candidate for various use cases.

This recipe is written for the Ubuntu 14.04 server.

Getting ready

Make sure that you have Apache and passenger installed:

sudo apt-get install apache2 libapache2-mod-passenger

How to do it…

To configure Passenger, perform the following steps:

  1. Open /etc/apache2/mods-available/passenger.conf with your favourite editor, or use nano:
    nano /etc/apache2/mods-available/passenger.conf
  2. Add the following line: PassengerDefaultUser www-data.
  3. So, your passenger.com will look something like this:
    <IfModule mod_passenger.c>
  PassengerRoot /usr/lib/ruby/vendor_ruby/phusion_passenger/locations.ini
  PassengerDefaultRuby /usr/bin/ruby
  PassengerDefaultUser www-data
</IfModule>

    Tip

    If you are using a different Ruby version installed via RVM, update the paths accordingly. Also replace www-data with your user.

    Please keep in mind that PassengerDefaultUser can be entered in your virtual server's config file, which you may need to edit manually for installations on shared hosting.

  4. Create a symbolic link to the Redmine public folder from a web server's root folder like this:
    sudo ln -s /usr/share/redmine/public /var/www/html/redmine
  5. This link assumes that you installed Redmine through apt-get. If this is not the case and you installed it somewhere else such as /home/user/redmine, then you must adjust your links according to your Redmine installation and www root, which may look something like this (for example):
    ln –s /home/user/redmine/public /home/user/public_html/redmine
  6. Make sure that passenger is enabled in Apache:
    sudo a2enmod passenger
  7. Modify /etc/apache2/sites-available/000-default.conf by typing the following:
    sudo nano  /etc/apache2/sites-available/000-default.conf
  8. Add the following content near other Directory sections; if there are none, just make sure it's added before closing the </VirtualHost> line:
    <Directory /var/www/html/redmine>
    RailsBaseURI /redmine
    PassengerResolveSymlinksInDocumentRoot on
</Directory>
  9. Install bundler by typing the following:
    sudo gem update && sudo gem install bundler
  10. Finish the installation and restart Apache:
    sudo touch /usr/share/redmine/Gemfile.lock
sudo chown www-data:www-data /usr/share/redmine/Gemfile.lock
sudo service apache2 restart

After restarting Apache, your Redmine installation should be ready to access by going to http://your_server/redmine.

How it works…

First, you installed Apache web server and Phusion Passenger as a Ruby application server, which runs as an Apache module. Then you edited Apache's configuration file for Passenger by adding the default user to be www-data. After this, we created a symbolic link from Redmine's public directory to the web server's root directory. Then, we edited the virtual server's config to serve this particular directory with two Redmine-related configs – RailsBaseURI/redmine, —which tells Ruby on Rails to access Redmine via the /redmine subfolder, and PassengerResolveSymlinksInDocumentRoot tells Passenger to follow symlink to find a Rails application through the symlink path. Instead of this, you could have written the following:

PassengerAppRoot /usr/share/redmine/

Redmine would work the same way.

There's more…

The best way to run Redmine or any other web-exposed software is to run it as a restricted user from its home directory and adjust Apache or any other web server to serve data from this directory. Running Redmine as a subdomain such as http://redmine.yoursite.com, is done by creating an ordinary subdomain, and an Apache virtual host file for this subdomain with the settings that are provided in this recipe.

See also

If you stumble upon an error such as 403 (forbidden), error 500, or if you see Ruby code on the screen or the Passenger error screen, but you have followed the preceding steps exactly, refer to Troubleshooting Apache installations section in Chapter 9, Troubleshooting.

If you need to run Redmine as sub-uri, then take a look at http://www.redmine.org/projects/redmine/wiki/HowTo_Install_Redmine_in_a_sub-URI.

Visually different images
CONTINUE READING
83
Tech Concepts
36
Programming languages
73
Tech Tools
Icon Unlimited access to the largest independent learning library in tech of over 8,000 expert-authored tech books and videos.
Icon Innovative learning tools, including AI book assistants, code context explainers, and text-to-speech.
Icon 50+ new titles added per month and exclusive early access to books as they are being written.
Redmine Cookbook
End of Section 1
Next Section
notes
bookmark Notes and Bookmarks search Search in title playlist Add to playlist font-size Font size

Change the font size

margin-width Margin width

Change margin width

day-mode Day/Sepia/Night Modes

Change background colour

Close icon Search
Country selected
Close icon Your notes and bookmarks

Confirmation

Modal Close icon
claim successful
Order Page Read Now

Buy this book with your credits?

Modal Close icon
Are you sure you want to buy this book with one of your credits?
Close
YES, BUY

Submit Your Feedback

Modal Close icon
Modal Close icon
Modal Close icon