2006-06-28 22:11:03 +04:00
|
|
|
== redMine installation
|
|
|
|
|
|
|
|
|
|
redMine - project management software
|
|
|
|
|
Copyright (C) 2006 Jean-Philippe Lang
|
2006-07-09 20:30:01 +04:00
|
|
|
http://redmine.org/
|
2006-06-28 22:11:03 +04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
== Requirements
|
|
|
|
|
|
|
|
|
|
* Ruby on Rails 1.1
|
2006-10-08 23:13:21 +04:00
|
|
|
* Iconv
|
|
|
|
|
* Net::LDAP for Ruby (for LDAP authentication)
|
2006-07-09 20:30:01 +04:00
|
|
|
* a database (see compatibility below)
|
2006-06-28 22:11:03 +04:00
|
|
|
* (recommended) Apache/Lighttpd with FCGI support
|
|
|
|
|
|
2006-07-09 20:30:01 +04:00
|
|
|
Supported databases:
|
|
|
|
|
|
|
|
|
|
* MySQL (tested with MySQL 5)
|
|
|
|
|
* PostgreSQL (tested with PostgreSQL 8.1)
|
|
|
|
|
* Oracle (tested with Oracle 10g)
|
|
|
|
|
* SQL Server (tested with SQL Server 2005)
|
|
|
|
|
* SQLite (tested with SQLite 3)
|
|
|
|
|
|
2006-10-08 23:13:21 +04:00
|
|
|
== Upgrade
|
|
|
|
|
|
|
|
|
|
Due to major database changes, there is no migration support from beta 0.2.0.
|
|
|
|
|
Next releases (0.3.0+) will be provided with upgrade support.
|
|
|
|
|
|
2006-06-28 22:11:03 +04:00
|
|
|
|
|
|
|
|
== Installation
|
|
|
|
|
|
|
|
|
|
1. Uncompress program archive:
|
|
|
|
|
tar zxvf <filename>
|
|
|
|
|
|
|
|
|
|
2. Create an empty database: "redmine" for example
|
|
|
|
|
|
|
|
|
|
3. Configure database parameters in config/database.yml
|
2006-07-09 20:30:01 +04:00
|
|
|
for "production" environment (default database is MySQL)
|
2006-06-28 22:11:03 +04:00
|
|
|
|
2006-07-09 20:30:01 +04:00
|
|
|
4. Create the database structure. Under application main directory:
|
2006-06-28 22:11:03 +04:00
|
|
|
rake migrate RAILS_ENV="production"
|
|
|
|
|
It will create tables and default configuration data
|
|
|
|
|
|
2006-10-08 23:24:44 +04:00
|
|
|
5. Insert default configuration data in database:
|
|
|
|
|
rake load_default_data RAILS_ENV="production"
|
|
|
|
|
This step is optional, as you can define your own configuration
|
|
|
|
|
(roles, trackers, statuses, workflows, enumerations) from sratch
|
|
|
|
|
|
|
|
|
|
6. Test the installation by running WEBrick web server:
|
2006-06-28 22:11:03 +04:00
|
|
|
ruby script/server -e production
|
|
|
|
|
|
|
|
|
|
Once WEBrick has started, point your browser to http://localhost:3000/
|
|
|
|
|
You should now see the application welcome page
|
|
|
|
|
|
2006-10-08 23:24:44 +04:00
|
|
|
7. Use default administrator account to log in:
|
2006-06-28 22:11:03 +04:00
|
|
|
login: admin
|
|
|
|
|
password: admin
|
|
|
|
|
|
2006-10-08 23:24:44 +04:00
|
|
|
8. Setup Apache or Lighttpd with fastcgi for best performance.
|
2006-06-28 22:11:03 +04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
== Configuration
|
|
|
|
|
|
2006-07-29 13:32:58 +04:00
|
|
|
A sample configuration file is provided: "config/config_custom.example.rb"
|
|
|
|
|
Rename it to config_custom.rb and edit parameters.
|
2006-06-28 22:11:03 +04:00
|
|
|
Don't forget to restart the application after any change.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
config.action_mailer.server_settings: SMTP server configuration
|
|
|
|
|
config.action_mailer.perform_deliveries: set to false to disable mail delivering
|
|
|
|
|
|
