##// END OF EJS Templates
jro_apps » redmine
RSS
Merged r3448 and r3455 from trunk....
Jean-Philippe Lang -
r3346:7d913f93c339
parent child
Show More
Side by Side Unified
Context file:
r3346:7d913f93c339 Loading diff...:
Show file before | Show file after | Hide comments
@@ -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 69 production:
4 70 delivery_method: :smtp
5 71 smtp_settings:
6 72 address: smtp.example.net
7 73 port: 25
8 74 domain: example.net
9 75 authentication: :login
10 76 user_name: "redmine@example.net"
11 77 password: "redmine"
12 78
13 79 development:
14 80 delivery_method: :smtp
15 81 smtp_settings:
16 82 address: 127.0.0.1
17 83 port: 25
18 84 domain: example.net
19 85 authentication: :login
20 86 user_name: "redmine@example.net"
21 87 password: "redmine"
Show file before | Show file after | Hide comments
@@ -1,71 +1,71
1 1 == Redmine installation
2 2
3 3 Redmine - project management software
4 4 Copyright (C) 2006-2010 Jean-Philippe Lang
5 5 http://www.redmine.org/
6 6
7 7
8 8 == Requirements
9 9
10 10 * Ruby 1.8.6 or 1.8.7
11 11
12 12 * Ruby on Rails 2.3.5 (official downloadable Redmine releases are packaged with
13 13 the appropriate Rails version)
14 14
15 15 * A database:
16 16 * MySQL (tested with MySQL 5)
17 17 * PostgreSQL (tested with PostgreSQL 8.1)
18 18 * SQLite (tested with SQLite 3)
19 19
20 20 Optional:
21 21 * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)
22 22 * RMagick (gantt export to png)
23 23
24 24 == Installation
25 25
26 26 1. Uncompress the program archive
27 27
28 28 2. Create an empty database: "redmine" for example
29 29
30 30 3. Configure database parameters in config/database.yml
31 31 for "production" environment (default database is MySQL)
32 32
33 4. Create the database structure. Under the application main directory:
34 rake db:migrate RAILS_ENV="production"
35 It will create tables and an administrator account.
36
37 5. Generate a session store secret
33 4. Generate a session store secret
38 34 Redmine stores session data in cookies by default, which requires
39 35 a secret to be generated. Run:
40 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 42 6. Setting up permissions
43 43 The user who runs Redmine must have write permission on the following
44 44 subdirectories: files, log, tmp (create the last one if not present).
45 45
46 46 Assuming you run Redmine with a user named redmine:
47 47 mkdir tmp
48 48 sudo chown -R redmine:redmine files log tmp
49 49 sudo chmod -R 755 files log tmp
50 50
51 51 7. Test the installation by running WEBrick web server:
52 52 ruby script/server -e production
53 53
54 54 Once WEBrick has started, point your browser to http://localhost:3000/
55 55 You should now see the application welcome page
56 56
57 57 8. Use default administrator account to log in:
58 58 login: admin
59 59 password: admin
60 60
61 61 Go to "Administration" to load the default configuration data (roles,
62 62 trackers, statuses, workflow) and adjust application settings
63 63
64 64
65 65 == Email delivery Configuration
66 66
67 67 Copy config/email.yml.example to config/email.yml and edit this file
68 68 to adjust your SMTP settings.
69 69 Don't forget to restart the application after any change to this file.
70 70
71 71 Please do not enter your SMTP settings in environment.rb.
Show file before | Show file after | Hide comments
@@ -1,33 +1,33
1 1 == Redmine upgrade procedure
2 2
3 3 Redmine - project management software
4 4 Copyright (C) 2006-2010 Jean-Philippe Lang
5 5 http://www.redmine.org/
6 6
7 7
8 8 == Upgrading
9 9
10 10 1. Uncompress the program archive in a new directory
11 11
12 12 2. Copy your database settings (RAILS_ROOT/config/database.yml)
13 13 and SMTP settings (RAILS_ROOT/config/email.yml)
14 14 into the new config directory
15 15 DO NOT REPLACE ANY OTHERS FILES.
16 16
17 3. Migrate your database (please make a backup before doing this):
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
17 3. Generate a session store secret
24 18 Redmine stores session data in cookies by default, which requires
25 19 a secret to be generated. Run:
26 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 28 == Notes
29 29
30 30 1. Rails 2.3.5 is required for version 0.9.
31 31
32 32 2. When upgrading your code with svn update, don't forget to clear
33 33 the application cache (RAILS_ROOT/tmp/cache) before restarting.
General Comments 0
You need to be logged in to leave comments. Login now