Redmine
From DreamHost
| The instructions provided in this article or section are considered advanced. You are expected to be knowledgeable in the UNIX shell. |
| The instructions provided in this article or section require shell access unless otherwise stated. You can use the PuTTY client on Windows, or SSH on UNIX and UNIX-like systems such as Linux or Mac OS X. |
Contents |
This article describes how to install Redmine, an integrated Wiki and Issue Tracker with support for Subversion. These instructions assume you will be doing this on a shared host (DreamHost).
Installation
For help on using the shell you can take a look at the UNIX commands and you can also get help on changing directories.
If you want to save the output for debugging and support then you can look at the Redirection Symbol.
Instructions
From Alan Daveline’s Blog About Everything
1. From the Dreamhost control panel, create a new subdomain for the application such as yoursubdomain.yourdomain.com
1. Make sure the domain supports “Ruby on Rails Passenger (mod_rails)?”
2. Specify your web directory: /home/username/yoursubdomain.yourdomain.com/public
* you must add the public!!!
2. From the Dreamhost control panel create a new MySQL database named yourdatabasename
3. ssh into your Dreamhost account
4. cd ~/yoursubdomain.yourdomain.com
5. svn export --force svn://rubyforge.org/var/svn/redmine/branches/0.7-stable ./
* check http://www.redmine.org/wiki/redmine/Download for the latest version
6. also watch out for permissions
* chmod -v -R 755 ./*
7. cd ~/yoursubdomain.yourdomain.com/config
8. cp database.yml.example database.yml
9. nano database.yml
1. edit the database.yml config file with the appropriate info. Should be similar to the following
production:
adapter: mysql
database: yourdatabasename
username: yourusername
password: yourpassword
host: mysql.yourdomain.com
10. cd ~/yoursubdomain.yourdomain.com/public
11. cp dispatch.rb.example dispatch.rb
12. nano .htaccess (replace with following text)
Options +FollowSymLinks +ExecCGI
RewriteEngine On
RewriteRule ^$ index.html [QSA]
RewriteRule ^([^.]+)$ $1.html [QSA]
RewriteCond %{REQUEST_FILENAME} !-f
ErrorDocument 500 "H2Application errorH2 Rails application failed to start properly"
* replace the H2 with the proper HTML tag when you place it in the .htaccess
13. cd ~/yoursubdomain.yourdomain.com
14. from application root type
* rake db:migrate RAILS_ENV="production"
15. also type the following to load config defaults
* rake redmine:load_default_data RAILS_ENV="production"
* choose "en" for english
16. browse to http://yoursubdomain.yourdomain.com
Sending Email
From Matt Jones' Blog
In order to get Redmine to send emails, you will need to update config/environment.rb
Find the following code:
# SMTP server configuration
config.action_mailer.smtp_settings = {
:address => "127.0.0.1",
:port => 25,
:domain => "somenet.foo",
:authentication => :login,
:user_name => "redmine@somenet.foo",
:password => "redmine",
}
config.action_mailer.perform_deliveries = true
# Tell ActionMailer not to deliver emails to the real world.
# The :test delivery method accumulates sent emails in the
# ActionMailer::Base.deliveries array.
#config.action_mailer.delivery_method = :test
config.action_mailer.delivery_method = :smtp
Update the domain, user_name and password values if using SMTP.
To use Sendmail, change the above code to:
# SMTP server configuration
config.action_mailer.smtp_settings = {
:address => "127.0.0.1",
:port => 25,
:domain => "yourdomain",
:authentication => :plain,
}
config.action_mailer.perform_deliveries = true
# Tell ActionMailer not to deliver emails to the real world.
# The :test delivery method accumulates sent emails in the
# ActionMailer::Base.deliveries array.
#config.action_mailer.delivery_method = :test
config.action_mailer.delivery_method = :sendmail
Don't forget to restart Passenger by adding the file restart.txt to the tmp folder.
Features
- Bug and Feature Tracker
- Wiki
- MySQL, PostgreSQL support
- Unicode Support
- Svn, git, mercurial, bazzaar repository support.
Link a new repository
When a new project is made you will probably link a repository to it. Go to the project. Then settings -> repository -> Create. Choose the repository type and enter its full local path. For example, for git:
/home/username/repodict/.git
It is important to tell Redmine to look for new repositories. Execute this line:
ruby /home/username/sub.domain.com/script/runner "Repository.fetch_changesets" -e production
Change production for any envirorment you made.
Logging In
Username: admin Password: admin
Please login and change the administrator password as soon as possible
Alternative Packages
Mantis is a PHP bug tracker

