INSTALL
67 lines
| 2.0 KiB
| text/plain
|
TextLexer
/ doc / INSTALL
Jean-Philippe Lang
|
r870 | == Redmine installation | ||
| Redmine - project management software | ||||
|
Jean-Philippe Lang
|
r1397 | Copyright (C) 2006-2008 Jean-Philippe Lang | ||
|
Jean-Philippe Lang
|
r870 | http://www.redmine.org/ | ||
| == Requirements | ||||
|
Jean-Philippe Lang
|
r1610 | * Ruby on Rails 2.1 | ||
| * A database: | ||||
| * MySQL (tested with MySQL 5) | ||||
| * PostgreSQL (tested with PostgreSQL 8.1) | ||||
| * SQLite (tested with SQLite 3) | ||||
|
Jean-Philippe Lang
|
r870 | |||
| Optional: | ||||
| * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH) | ||||
| * RMagick (gantt export to png) | ||||
| == Installation | ||||
| 1. Uncompress the program archive | ||||
| 2. Create an empty database: "redmine" for example | ||||
| 3. Configure database parameters in config/database.yml | ||||
| for "production" environment (default database is MySQL) | ||||
| 4. Create the database structure. Under the application main directory: | ||||
| rake db:migrate RAILS_ENV="production" | ||||
| It will create tables and an administrator account. | ||||
|
Jean-Philippe Lang
|
r2433 | |||
| 5. Generate a session store secret | ||||
| Redmine stores session data in cookies by default, which requires | ||||
| a secret to be generated. Run: | ||||
| rake config/initializers/session_store.rb | ||||
|
Jean-Philippe Lang
|
r870 | |||
|
Jean-Philippe Lang
|
r2433 | 6. Setting up permissions | ||
|
Jean-Philippe Lang
|
r1532 | The user who runs Redmine must have write permission on the following | ||
| subdirectories: files, log, tmp (create the last one if not present). | ||||
| Assuming you run Redmine with a user named redmine: | ||||
| mkdir tmp | ||||
| sudo chown -R redmine:redmine files log tmp | ||||
| sudo chmod -R 755 files log tmp | ||||
|
Jean-Philippe Lang
|
r2433 | 7. Test the installation by running WEBrick web server: | ||
|
Jean-Philippe Lang
|
r870 | ruby script/server -e production | ||
| Once WEBrick has started, point your browser to http://localhost:3000/ | ||||
| You should now see the application welcome page | ||||
|
Jean-Philippe Lang
|
r2433 | 8. Use default administrator account to log in: | ||
|
Jean-Philippe Lang
|
r870 | login: admin | ||
| password: admin | ||||
|
Jean-Philippe Lang
|
r1532 | Go to "Administration" to load the default configuration data (roles, | ||
|
Jean-Philippe Lang
|
r1027 | trackers, statuses, workflow) and adjust application settings | ||
|
Jean-Philippe Lang
|
r870 | |||
|
Jean-Philippe Lang
|
r1611 | == Email delivery Configuration | ||
|
Jean-Philippe Lang
|
r870 | |||
|
Jean-Philippe Lang
|
r1611 | Copy config/email.yml.example to config/email.yml and edit this file | ||
| to adjust your SMTP settings. | ||||
|
Jean-Philippe Lang
|
r870 | Don't forget to restart the application after any change to this file. | ||
|
Jean-Philippe Lang
|
r1611 | |||
| Please do not enter your SMTP settings in environment.rb. | ||||