jro_apps/redmine Commit - r1610:5d0b53544c85

1

== Redmine installation

1

== Redmine installation

2

3

Redmine - project management software

3

Redmine - project management software

4

5

http://www.redmine.org/

5

http://www.redmine.org/

6

7

8

== Requirements

8

== Requirements

9

10

* Ruby on Rails 2.~~0.2 (not Rails 2.~~1)

10

* Ruby on Rails 2.1

11

* A database (see compatibility below)

11

* A database:

12

* MySQL (tested with MySQL 5)

13

* PostgreSQL (tested with PostgreSQL 8.1)

14

* SQLite (tested with SQLite 3)

12

15

13

Optional:

16

Optional:

14

* SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)

17

* SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)

15

* RMagick (gantt export to png)

18

* RMagick (gantt export to png)

16

19

17

Supported databases:

18

* MySQL (tested with MySQL 5)

19

* PostgreSQL (tested with PostgreSQL 8.1)

20

* SQLite (tested with SQLite 3)

21

22

23

== Installation

20

== Installation

24

21

25

1. Uncompress the program archive

22

1. Uncompress the program archive

26

23

27

2. Create an empty database: "redmine" for example

24

2. Create an empty database: "redmine" for example

28

25

29

3. Configure database parameters in config/database.yml

26

3. Configure database parameters in config/database.yml

30

for "production" environment (default database is MySQL)

27

for "production" environment (default database is MySQL)

31

28

32

4. Create the database structure. Under the application main directory:

29

4. Create the database structure. Under the application main directory:

33

rake db:migrate RAILS_ENV="production"

30

rake db:migrate RAILS_ENV="production"

34

It will create tables and an administrator account.

31

It will create tables and an administrator account.

35

32

36

5. Setting up permissions

33

5. Setting up permissions

37

The user who runs Redmine must have write permission on the following

34

The user who runs Redmine must have write permission on the following

38

subdirectories: files, log, tmp (create the last one if not present).

35

subdirectories: files, log, tmp (create the last one if not present).

39

36

40

Assuming you run Redmine with a user named redmine:

37

Assuming you run Redmine with a user named redmine:

41

mkdir tmp

38

mkdir tmp

42

sudo chown -R redmine:redmine files log tmp

39

sudo chown -R redmine:redmine files log tmp

43

sudo chmod -R 755 files log tmp

40

sudo chmod -R 755 files log tmp

44

41

45

6. Test the installation by running WEBrick web server:

42

6. Test the installation by running WEBrick web server:

46

ruby script/server -e production

43

ruby script/server -e production

47

44

48

Once WEBrick has started, point your browser to http://localhost:3000/

45

Once WEBrick has started, point your browser to http://localhost:3000/

49

You should now see the application welcome page

46

You should now see the application welcome page

50

47

51

7. Use default administrator account to log in:

48

7. Use default administrator account to log in:

52

login: admin

49

login: admin

53

password: admin

50

password: admin

54

51

55

Go to "Administration" to load the default configuration data (roles,

52

Go to "Administration" to load the default configuration data (roles,

56

trackers, statuses, workflow) and adjust application settings

53

trackers, statuses, workflow) and adjust application settings

57

54

58

55

59

== SMTP server Configuration

56

== SMTP server Configuration

60

57

61

In config/environment.rb, you can set parameters for your SMTP server:

58

In config/environment.rb, you can set parameters for your SMTP server:

62

config.action_mailer.smtp_settings: SMTP server configuration

59

config.action_mailer.smtp_settings: SMTP server configuration

63

config.action_mailer.perform_deliveries: set to false to disable mail delivering

60

config.action_mailer.perform_deliveries: set to false to disable mail delivering

64

61

65

Don't forget to restart the application after any change to this file.

62

Don't forget to restart the application after any change to this file.

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

             == Redmine installation
             Redmine - project management software
             Copyright (C) 2006-2008  Jean-Philippe Lang
             http://www.redmine.org/
             == Requirements
-            * Ruby on Rails 2.0.2 (not Rails 2.1)
+            * Ruby on Rails 2.1
-            * A database (see compatibility below)
+            * A database:
+              * MySQL (tested with MySQL 5)
+              * PostgreSQL (tested with PostgreSQL 8.1)
+              * SQLite (tested with SQLite 3)
             Optional:
             * SVN binaries >= 1.3 (needed for repository browsing, must be available in PATH)
             * RMagick (gantt export to png)
-            Supported databases:
-            * MySQL (tested with MySQL 5)
-            * PostgreSQL (tested with PostgreSQL 8.1)
-            * SQLite (tested with SQLite 3)
             == Installation
 . Uncompress the program archive
 . Create an empty database: "redmine" for example
 . Configure database parameters in config/database.yml
                for "production" environment (default database is MySQL)
 . Create the database structure. Under the application main directory:
                rake db:migrate RAILS_ENV="production"
                It will create tables and an administrator account.
 . Setting up permissions
                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
 . Test the installation by running WEBrick web server:
                ruby script/server -e production
                Once WEBrick has started, point your browser to http://localhost:3000/
                You should now see the application welcome page
 . Use default administrator account to log in:
                login: admin
                password: admin
                Go to "Administration" to load the default configuration data (roles,
                trackers, statuses, workflow) and adjust application settings
             == SMTP server Configuration
             In config/environment.rb, you can set parameters for your SMTP server:
             config.action_mailer.smtp_settings: SMTP server configuration
             config.action_mailer.perform_deliveries: set to false to disable mail delivering
             Don't forget to restart the application after any change to this file.