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

Using Puma and IIS on Windows

Puma is advertised as a small and fast server. It is derived from Mongrel, which is an open source web server written in Ruby by Zed Shaw. It can serve Redmine on its own, or behind Nginx, Apache, or IIS. Puma can be run and installed in a user's home directory or system-wide.

Getting ready

First, install Redmine as explained in the previous recipe.

Then, we need the OpenSSL Developer Package (this contains header files and binaries), which can be downloaded from http://packages.openknapsack.org/openssl/openssl-1.0.0k-x64-windows.tar.lzma. Considering that we followed the previous recipe precisely, if you need a different SSL version, you can obtain it from https://www.openssl.org. Now, perform the following steps:

  1. Download http://packages.openknapsack.org/openssl/openssl-1.0.0k-x64-windows.tar.lzma and copy it to C:\ruby.
  2. Create a folder, openssl, in C:\ruby and copy the downloaded OpenSSL lzma archive here.
  3. Run cmd and navigate to C:\ruby\openssl by typing the following: cd C:\ruby\openssl. Extract the content of the archive by typing:
    bsdtar --lzma -xf openssl-1.0.0k-x64-windows.tar.lzma

    Note

    If minigw bin from devkit is not added to path, you must specify full folder in order to execute bsdtar, and it would look somewhat like this:

    c:\ruby\devkit\mingw\bin\bsdtar.exe --lzma -xf c:\ruby\openssl\openssl-1.0.0k-x64-windows.tar.lzma

  4. You should end up with OpenSSL files extracted in C:\ruby\openssl.

How to do it…

Once you have installed Redmine and its prerequisites, as explained in this recipe, proceed by installing the Puma server by typing the following:

gem install puma -- --with-opt-dir=c:\ruby\openssl

Testing Puma

This recipe assumes that your Redmine is installed, as explained in the, Installation on Windows servers recipe.

Run the following command from Redmine's directory in the command prompt:

puma -e production -p 3000

You should get a screen that looks like the following:

Testing Puma

Navigating to http://127.0.0.1:3000 on your browser should open Redmine screen.

Configuring Puma to start with Windows

To have your Puma server started automatically with Windows, perform the following steps:

  1. Create a file, pumastart.bat, in C:\ruby with the following contents:
    cd C:\redmine
start /min puma -e production -p 3000 -t 8:32
  2. Then go to Server Manager | Tools | Task Scheduler | Create a Task.
  3. Check the Run whether user is logged or not, Run with highest privileges, and Hidden checkboxes.
  4. Then in Actions, go to New | Start a program and find pumastart.bat.
  5. On the Triggers tab, click New and choose Begin the task: At startup (located in the top dropdown).

Configuring IIS

You should add an IIS role to your server and install the following two add-ons to IIS. You can install them directly from the Microsoft website.

You can get the URL Rewrite from http://www.iis.net/download/URLRewrite and the reverse proxy from http://www.iis.net/download/ApplicationRequestRouting.

  1. Open IIS Manager.
  2. Navigate to the website that you want to use as a Redmine proxy
  3. Click the URL Rewrite icon.
  4. Right-click inbound rules list.
  5. Select Add Rule and choose Reverse proxy.
  6. Add an Inbound rule with the following: 127.0.0.1:3000.

If your Puma server runs after clicking OK, you should be able to type http://localhost or whatever your server name is and you will get the Redmine welcome screen.

How it works…

At first, we needed some prerequisites to install Puma because the gem to install Puma compiles it on your machine, and it requires proper OpenSSL library headers and binaries to compile. This is the reason why OpenSSL and dev tools are required. Then, the Puma installation is tested just by typing puma -e production -p 3000. To ensure that Puma starts after the Windows server restarts, Task Scheduler is used, and it schedules Puma to start on boot through a BAT file. In a bat file, command –t 8,32 tells Puma to start with a minimum of 8, and a maximum of 32 threads. You can adjust these values to fit your configuration. After this, we installed two Microsoft original modules to the IIS server and added a reverse proxy rule to forward all requests to 127.0.0.1:3000 where the Puma server is listening. We used the default IIS site, but this rule works with any or multiple IIS sites.

There's more…

This recipe can be easily adopted to use Puma behind Nginx or Apache on both Windows and Linux systems. Also Thin or Unicorn can be used instead of Puma.

See also

Check out the Puma website for updates, additional configurations and fine-tuning:

http://puma.io/

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