##// END OF EJS Templates
Merged r3448 and r3455 from trunk....
Jean-Philippe Lang -
r3346:7d913f93c339
parent child
Show More
@@ -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