@@ -1,21 +1,87 | |||||
1 | # Outgoing email settings |
|
1 | # = Outgoing email settings | |
|
2 | # | |||
|
3 | # Each environment has it's own configuration options. If you are only | |||
|
4 | # running in production, only the production block needs to be configured. | |||
|
5 | # | |||
|
6 | # == Common configurations | |||
|
7 | # | |||
|
8 | # === Sendmail command | |||
|
9 | # | |||
|
10 | # production: | |||
|
11 | # delivery_method: :sendmail | |||
|
12 | # | |||
|
13 | # === Simple SMTP server at localhost | |||
|
14 | # | |||
|
15 | # production: | |||
|
16 | # delivery_method: :smtp | |||
|
17 | # smtp_settings: | |||
|
18 | # address: "localhost" | |||
|
19 | # port: 25 | |||
|
20 | # | |||
|
21 | # === SMTP server at example.com using LOGIN authentication and checking HELO for foo.com | |||
|
22 | # | |||
|
23 | # production: | |||
|
24 | # delivery_method: :smtp | |||
|
25 | # smtp_settings: | |||
|
26 | # address: "example.com" | |||
|
27 | # port: 25 | |||
|
28 | # authentication: :login | |||
|
29 | # domain: 'foo.com' | |||
|
30 | # user_name: 'myaccount' | |||
|
31 | # password: 'password' | |||
|
32 | # | |||
|
33 | # === SMTP server at example.com using PLAIN authentication | |||
|
34 | # | |||
|
35 | # production: | |||
|
36 | # delivery_method: :smtp | |||
|
37 | # smtp_settings: | |||
|
38 | # address: "example.com" | |||
|
39 | # port: 25 | |||
|
40 | # authentication: :plain | |||
|
41 | # domain: 'example.com' | |||
|
42 | # user_name: 'myaccount' | |||
|
43 | # password: 'password' | |||
|
44 | # | |||
|
45 | # === SMTP server at using TLS (GMail) | |||
|
46 | # | |||
|
47 | # This requires some additional configuration. See the article at: | |||
|
48 | # http://redmineblog.com/articles/setup-redmine-to-send-email-using-gmail/ | |||
|
49 | # | |||
|
50 | # production: | |||
|
51 | # delivery_method: :smtp | |||
|
52 | # smtp_settings: | |||
|
53 | # tls: true | |||
|
54 | # address: "smtp.gmail.com" | |||
|
55 | # port: 587 | |||
|
56 | # domain: "smtp.gmail.com" # 'your.domain.com' for GoogleApps | |||
|
57 | # authentication: :plain | |||
|
58 | # user_name: "your_email@gmail.com" | |||
|
59 | # password: "your_password" | |||
|
60 | # | |||
|
61 | # | |||
|
62 | # == More configuration options | |||
|
63 | # | |||
|
64 | # See the "Configuration options" at the following website for a list of the | |||
|
65 | # full options allowed: | |||
|
66 | # | |||
|
67 | # http://wiki.rubyonrails.org/rails/pages/HowToSendEmailsWithActionMailer | |||
2 |
|
68 | |||
3 | production: |
|
69 | production: | |
4 | delivery_method: :smtp |
|
70 | delivery_method: :smtp | |
5 | smtp_settings: |
|
71 | smtp_settings: | |
6 | address: smtp.example.net |
|
72 | address: smtp.example.net | |
7 | port: 25 |
|
73 | port: 25 | |
8 | domain: example.net |
|
74 | domain: example.net | |
9 | authentication: :login |
|
75 | authentication: :login | |
10 | user_name: "redmine@example.net" |
|
76 | user_name: "redmine@example.net" | |
11 | password: "redmine" |
|
77 | password: "redmine" | |
12 |
|
78 | |||
13 | development: |
|
79 | development: | |
14 | delivery_method: :smtp |
|
80 | delivery_method: :smtp | |
15 | smtp_settings: |
|
81 | smtp_settings: | |
16 | address: 127.0.0.1 |
|
82 | address: 127.0.0.1 | |
17 | port: 25 |
|
83 | port: 25 | |
18 | domain: example.net |
|
84 | domain: example.net | |
19 | authentication: :login |
|
85 | authentication: :login | |
20 | user_name: "redmine@example.net" |
|
86 | user_name: "redmine@example.net" | |
21 | password: "redmine" |
|
87 | password: "redmine" |
@@ -1,71 +1,71 | |||||
1 | == Redmine installation |
|
1 | == Redmine installation | |
2 |
|
2 | |||
3 | Redmine - project management software |
|
3 | Redmine - project management software | |
4 | Copyright (C) 2006-2010 Jean-Philippe Lang |
|
4 | Copyright (C) 2006-2010 Jean-Philippe Lang | |
5 | http://www.redmine.org/ |
|
5 | http://www.redmine.org/ | |
6 |
|
6 | |||
7 |
|
7 | |||
8 | == Requirements |
|
8 | == Requirements | |
9 |
|
9 | |||
10 | * Ruby 1.8.6 or 1.8.7 |
|
10 | * Ruby 1.8.6 or 1.8.7 | |
11 |
|
11 | |||
12 | * Ruby on Rails 2.3.5 (official downloadable Redmine releases are packaged with |
|
12 | * Ruby on Rails 2.3.5 (official downloadable Redmine releases are packaged with | |
13 | the appropriate Rails version) |
|
13 | the appropriate Rails version) | |
14 |
|
14 | |||
15 | * A database: |
|
15 | * A database: | |
16 | * MySQL (tested with MySQL 5) |
|
16 | * MySQL (tested with MySQL 5) | |
17 | * PostgreSQL (tested with PostgreSQL 8.1) |
|
17 | * PostgreSQL (tested with PostgreSQL 8.1) | |
18 | * SQLite (tested with SQLite 3) |
|
18 | * SQLite (tested with SQLite 3) | |
19 |
|
19 | |||
20 | Optional: |
|
20 | Optional: | |
21 | * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH) |
|
21 | * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH) | |
22 | * RMagick (gantt export to png) |
|
22 | * RMagick (gantt export to png) | |
23 |
|
23 | |||
24 | == Installation |
|
24 | == Installation | |
25 |
|
25 | |||
26 | 1. Uncompress the program archive |
|
26 | 1. Uncompress the program archive | |
27 |
|
27 | |||
28 | 2. Create an empty database: "redmine" for example |
|
28 | 2. Create an empty database: "redmine" for example | |
29 |
|
29 | |||
30 | 3. Configure database parameters in config/database.yml |
|
30 | 3. Configure database parameters in config/database.yml | |
31 | for "production" environment (default database is MySQL) |
|
31 | for "production" environment (default database is MySQL) | |
32 |
|
32 | |||
33 | 4. Create the database structure. Under the application main directory: |
|
33 | 4. Generate a session store secret | |
34 | rake db:migrate RAILS_ENV="production" |
|
|||
35 | It will create tables and an administrator account. |
|
|||
36 |
|
||||
37 | 5. Generate a session store secret |
|
|||
38 | Redmine stores session data in cookies by default, which requires |
|
34 | Redmine stores session data in cookies by default, which requires | |
39 | a secret to be generated. Run: |
|
35 | a secret to be generated. Run: | |
40 | rake config/initializers/session_store.rb |
|
36 | rake config/initializers/session_store.rb | |
41 |
|
37 | |||
|
38 | 5. Create the database structure. Under the application main directory: | |||
|
39 | rake db:migrate RAILS_ENV="production" | |||
|
40 | It will create tables and an administrator account. | |||
|
41 | ||||
42 | 6. Setting up permissions |
|
42 | 6. Setting up permissions | |
43 | The user who runs Redmine must have write permission on the following |
|
43 | The user who runs Redmine must have write permission on the following | |
44 | subdirectories: files, log, tmp (create the last one if not present). |
|
44 | subdirectories: files, log, tmp (create the last one if not present). | |
45 |
|
45 | |||
46 | Assuming you run Redmine with a user named redmine: |
|
46 | Assuming you run Redmine with a user named redmine: | |
47 | mkdir tmp |
|
47 | mkdir tmp | |
48 | sudo chown -R redmine:redmine files log tmp |
|
48 | sudo chown -R redmine:redmine files log tmp | |
49 | sudo chmod -R 755 files log tmp |
|
49 | sudo chmod -R 755 files log tmp | |
50 |
|
50 | |||
51 | 7. Test the installation by running WEBrick web server: |
|
51 | 7. Test the installation by running WEBrick web server: | |
52 | ruby script/server -e production |
|
52 | ruby script/server -e production | |
53 |
|
53 | |||
54 | Once WEBrick has started, point your browser to http://localhost:3000/ |
|
54 | Once WEBrick has started, point your browser to http://localhost:3000/ | |
55 | You should now see the application welcome page |
|
55 | You should now see the application welcome page | |
56 |
|
56 | |||
57 | 8. Use default administrator account to log in: |
|
57 | 8. Use default administrator account to log in: | |
58 | login: admin |
|
58 | login: admin | |
59 | password: admin |
|
59 | password: admin | |
60 |
|
60 | |||
61 | Go to "Administration" to load the default configuration data (roles, |
|
61 | Go to "Administration" to load the default configuration data (roles, | |
62 | trackers, statuses, workflow) and adjust application settings |
|
62 | trackers, statuses, workflow) and adjust application settings | |
63 |
|
63 | |||
64 |
|
64 | |||
65 | == Email delivery Configuration |
|
65 | == Email delivery Configuration | |
66 |
|
66 | |||
67 | Copy config/email.yml.example to config/email.yml and edit this file |
|
67 | Copy config/email.yml.example to config/email.yml and edit this file | |
68 | to adjust your SMTP settings. |
|
68 | to adjust your SMTP settings. | |
69 | Don't forget to restart the application after any change to this file. |
|
69 | Don't forget to restart the application after any change to this file. | |
70 |
|
70 | |||
71 | Please do not enter your SMTP settings in environment.rb. |
|
71 | Please do not enter your SMTP settings in environment.rb. |
@@ -1,33 +1,33 | |||||
1 | == Redmine upgrade procedure |
|
1 | == Redmine upgrade procedure | |
2 |
|
2 | |||
3 | Redmine - project management software |
|
3 | Redmine - project management software | |
4 | Copyright (C) 2006-2010 Jean-Philippe Lang |
|
4 | Copyright (C) 2006-2010 Jean-Philippe Lang | |
5 | http://www.redmine.org/ |
|
5 | http://www.redmine.org/ | |
6 |
|
6 | |||
7 |
|
7 | |||
8 | == Upgrading |
|
8 | == Upgrading | |
9 |
|
9 | |||
10 | 1. Uncompress the program archive in a new directory |
|
10 | 1. Uncompress the program archive in a new directory | |
11 |
|
11 | |||
12 | 2. Copy your database settings (RAILS_ROOT/config/database.yml) |
|
12 | 2. Copy your database settings (RAILS_ROOT/config/database.yml) | |
13 | and SMTP settings (RAILS_ROOT/config/email.yml) |
|
13 | and SMTP settings (RAILS_ROOT/config/email.yml) | |
14 | into the new config directory |
|
14 | into the new config directory | |
15 | DO NOT REPLACE ANY OTHERS FILES. |
|
15 | DO NOT REPLACE ANY OTHERS FILES. | |
16 |
|
16 | |||
17 | 3. Migrate your database (please make a backup before doing this): |
|
17 | 3. Generate a session store secret | |
18 | rake db:migrate RAILS_ENV="production" |
|
|||
19 |
|
||||
20 | 4. Copy the RAILS_ROOT/files directory content into your new installation |
|
|||
21 | This directory contains all the attached files |
|
|||
22 |
|
||||
23 | 5. Generate a session store secret |
|
|||
24 | Redmine stores session data in cookies by default, which requires |
|
18 | Redmine stores session data in cookies by default, which requires | |
25 | a secret to be generated. Run: |
|
19 | a secret to be generated. Run: | |
26 | rake config/initializers/session_store.rb |
|
20 | rake config/initializers/session_store.rb | |
27 |
|
21 | |||
|
22 | 4. Migrate your database (please make a backup before doing this): | |||
|
23 | rake db:migrate RAILS_ENV="production" | |||
|
24 | ||||
|
25 | 5. Copy the RAILS_ROOT/files directory content into your new installation | |||
|
26 | This directory contains all the attached files | |||
|
27 | ||||
28 | == Notes |
|
28 | == Notes | |
29 |
|
29 | |||
30 | 1. Rails 2.3.5 is required for version 0.9. |
|
30 | 1. Rails 2.3.5 is required for version 0.9. | |
31 |
|
31 | |||
32 | 2. When upgrading your code with svn update, don't forget to clear |
|
32 | 2. When upgrading your code with svn update, don't forget to clear | |
33 | the application cache (RAILS_ROOT/tmp/cache) before restarting. |
|
33 | the application cache (RAILS_ROOT/tmp/cache) before restarting. |
General Comments 0
You need to be logged in to leave comments.
Login now