Frequently Asked Questions¶

• Table of contents
• Frequently Asked Questions
  • Installing and Running Redmine
    • When I start the application, I get this error "in `gem_original_require': no such file to load -- initializer (LoadError)"
    • The application seems to work fine but some pages (eg. login form) have no content.
    • The application freeze after a long time of inactivity.
  • Issue tracking
    • I've created a new issue status but I can't use it, it doesn't show up in the status drop-down list.
  • Repositories
    • Commits don't show up in the activity until I click on 'Repository'
  • Performance
    • When I create a new issue, Redmine freeze during one minute.

Installing and Running Redmine¶

When I start the application, I get this error "in `gem_original_require': no such file to load -- initializer (LoadError)"¶

Make sure Ruby on Rails is properly installed on your machine.

The application seems to work fine but some pages (eg. login form) have no content.¶

You’re running Rails 1.1.x but Redmine requires 1.2.2.
Upgrade Rails (if you're using gem package system, run the command gem update as root/administrator).

The application freeze after a long time of inactivity.¶

There's a bug in ruby/mysql adapter < 2.7.3 that leads to loose the database connection. Please update your adapter.
You can see thread at: http://rubyforge.org/forum/message.php?msg_id=25951.

Issue tracking¶

I've created a new issue status but I can't use it, it doesn't show up in the status drop-down list.¶

Once you've created a new issue status, you need to include it in the workflow.

Say you have created a status named 'In progress' and you want the developers to be able to change bugs from 'New' to 'In progress'.
Go to "Admin -> Issue tracking -> Workflow", select 'Bug' and 'Developer' then click edit.
You now see all the transitions allowed for developers on bugs. Check the 'New' -> 'In progress' checkbox and save.

See Workflow setup.

Repositories¶

Commits don't show up in the activity until I click on 'Repository'¶

By default, Redmine fetches the new commits from the repository only when you browse it.

If you want the commits to be retrieved periodically by Redmine in the background for all your repositories, uncheck 'Autofetch commits' setting and add a cron that runs (with appropriate environment):

ruby script/runner "Repository.fetch_changesets" -e production

Performance¶

When I create a new issue, Redmine freeze during one minute.¶

You have to configure email notification, or desactivate it. Please turn off email notification feature if you don't use it. In config/environment.rb replace the line

config.action_mailer.perform_deliveries = true

to

config.action_mailer.perform_deliveries = false

and restart redmine.