jro_apps/redmine Commit - r13836:16516fb48a18

Merged r14217 (#19185)....

Jean-Philippe Lang -

r13836:16516fb48a18

parent child

Context file:

r13836:16516fb48a18

Collapse all files

doc/INSTALL +3 0

             == Redmine installation
             Redmine - project management software
             Copyright (C) 2006-2015  Jean-Philippe Lang
             http://www.redmine.org/
             == Requirements
             * Ruby >= 1.9.3
             * RubyGems
             * Bundler >= 1.0.21
             * A database:
               * MySQL (tested with MySQL 5.1)
               * PostgreSQL (tested with PostgreSQL 9.1)
               * SQLite3 (tested with SQLite 3.7)
               * SQLServer (tested with SQLServer 2012)
             Optional:
             * SCM binaries (e.g. svn, git...), for repository browsing (must be available in PATH)
             * ImageMagick (to enable Gantt export to png images)
             == Installation
 . Uncompress the program archive
 . Create an empty utf8 encoded database: "redmine" for example
 . Configure the database parameters in config/database.yml
                for the "production" environment (default database is MySQL and ruby1.9)
 . Install the required gems by running:
                  bundle install --without development test
                If ImageMagick is not installed on your system, you should skip the installation
                of the rmagick gem using:
                  bundle install --without development test rmagick
                Only the gems that are needed by the adapters you've specified in your database
                configuration file are actually installed (eg. if your config/database.yml
                uses the 'mysql2' adapter, then only the mysql2 gem will be installed). Don't
                forget to re-run `bundle install` when you change config/database.yml for using
                other database adapters.
                If you need to load some gems that are not required by Redmine core (eg. fcgi),
                you can create a file named Gemfile.local at the root of your redmine directory.
                It will be loaded automatically when running `bundle install`.
 . Generate a session store secret
                Redmine stores session data in cookies by default, which requires
                a secret to be generated. Under the application main directory run:
                  bundle exec rake generate_secret_token
+               Alternatively, you can store this secret in config/secrets.yml:
+               http://guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml
 . Create the database structure
                Under the application main directory run:
                  bundle exec rake db:migrate RAILS_ENV="production"
                It will create all the tables and an administrator account.
 . Setting up permissions (Windows users have to skip this section)
                The user who runs Redmine must have write permission on the following
                subdirectories: files, log, tmp & public/plugin_assets.
                Assuming you run Redmine with a user named "redmine":
                  sudo chown -R redmine:redmine files log tmp public/plugin_assets
                  sudo chmod -R 755 files log tmp public/plugin_assets
 . Test the installation by running the WEBrick web server
                Under the main application directory run:
                  ruby bin/rails server -e production
                Once WEBrick has started, point your browser to http://localhost:3000/
                You should now see the application welcome page.
 . Use the default administrator account to log in:
                login: admin
                password: admin
                Go to "Administration" to load the default configuration data (roles,
                trackers, statuses, workflow) and to adjust the application settings
             == SMTP server Configuration
             Copy config/configuration.yml.example to config/configuration.yml and
             edit this file to adjust your SMTP settings.
             Do not forget to restart the application after any change to this file.
             Please do not enter your SMTP settings in environment.rb.
             == References
             * http://www.redmine.org/wiki/redmine/RedmineInstall
             * http://www.redmine.org/wiki/redmine/EmailConfiguration
             * http://www.redmine.org/wiki/redmine/RedmineSettings
             * http://www.redmine.org/wiki/redmine/RedmineRepositories
             * http://www.redmine.org/wiki/redmine/RedmineReceivingEmails
             * http://www.redmine.org/wiki/redmine/RedmineReminderEmails
             * http://www.redmine.org/wiki/redmine/RedmineLDAP

doc/UPGRADING +8 -2

             == Redmine upgrade
             Redmine - project management software
             Copyright (C) 2006-2015  Jean-Philippe Lang
             http://www.redmine.org/
             == Upgrading
 . Uncompress the program archive in a new directory
 . Copy your database settings (RAILS_ROOT/config/database.yml)
                and your configuration file (RAILS_ROOT/config/configuration.yml)
                into the new config directory
                Note: before Redmine 1.2, SMTP configuration was stored in
                config/email.yml. It should now be stored in config/configuration.yml.
 . Copy the RAILS_ROOT/files directory content into your new installation
                This directory contains all the attached files.
 . Copy the folders of the installed plugins and themes into new installation
                Plugins must be stored in the [redmine_root]/plugins directory
                Themes must be stored in the [redmine_root]/public/themes directory
                WARNING: plugins from your previous Redmine version may not be compatible
                with the Redmine version you're upgrading to.
 . Install the required gems by running:
                  bundle install --without development test
                If ImageMagick is not installed on your system, you should skip the installation
                of the rmagick gem using:
                  bundle install --without development test rmagick
                Only the gems that are needed by the adapters you've specified in your database
                configuration file are actually installed (eg. if your config/database.yml
                uses the 'mysql2' adapter, then only the mysql2 gem will be installed). Don't
                forget to re-run `bundle install` when you change config/database.yml for using
                other database adapters.
                If you need to load some gems that are not required by Redmine core (eg. fcgi),
                you can create a file named Gemfile.local at the root of your redmine directory.
                It will be loaded automatically when running `bundle install`.
 . Generate a session store secret
-               Redmine stores session data in cookies by default, which requires
+               If you're upgrading from Redmine 2.x or below, remove the following file
-               a secret to be generated. Under the new application directory run:
+               if it exists: config/initializers/secret_token.rb
+               Then generate a new secret by running the following command under the
+               application directory:
                  bundle exec rake generate_secret_token
+               Alternatively, you can store this secret in config/secrets.yml:
+               http://guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml
                DO NOT REPLACE OR EDIT ANY OTHER FILES.
 . Migrate your database
                If you are upgrading to Rails 2.3.14 as part of this migration, you
                need to upgrade the plugin migrations before running the plugin migrations
                using:
                  bundle exec rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
                Please make a backup before doing this! Under the new application
                directory run:
                  bundle exec rake db:migrate RAILS_ENV="production"
                If you have installed any plugins, you should also run their database
                migrations using:
                  bundle exec rake db:migrate_plugins RAILS_ENV="production"
 . Clear the cache and the existing sessions by running:
                  bundle exec rake tmp:cache:clear tmp:sessions:clear
 . Restart the application server (e.g. mongrel, thin, passenger)
 . Finally go to "Administration -> Roles & permissions" to check/set permissions
                 for new features, if any
             == References
             * http://www.redmine.org/wiki/redmine/RedmineUpgrade

General Comments 0

Write
Preview

You need to be logged in to leave comments. Login now

No TODOs yet

	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