doc_update_for_0.9.x_and_1.0.x-r3847.patch - Redmine

Defect #5463 » doc_update_for_0.9.x_and_1.0.x-r3847.patch

SVN-patch against Redmine trunk @ r3847. - Mischa The Evil, 2010-07-18 00:33

     == Redmine upgrade procedure
     === Redmine upgrade
     Redmine - project management software
     Copyright (C) 2006-2010  Jean-Philippe Lang
-...
     == Upgrading
 . Uncompress the program archive in a new directory
 . Copy your database settings (RAILS_ROOT/config/database.yml)
        and SMTP settings (RAILS_ROOT/config/email.yml)
        into the new config directory
        DO NOT REPLACE OR EDIT ANY OTHER FILES.
        and SMTP settings (RAILS_ROOT/config/email.yml) into the new
        config directory
 . Generate a session store secret
 . 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
 . Generate a session store secret
        Redmine stores session data in cookies by default, which requires
        a secret to be generated. Run:
        rake generate_session_store
 . Migrate your database (please make a backup before doing this):
        rake db:migrate RAILS_ENV="production"
        a secret to be generated. Under the new application directory run:
          rake generate_session_store
        DO NOT REPLACE OR EDIT ANY OTHER FILES.
 . Copy the RAILS_ROOT/files directory content into your new installation
        This directory contains all the attached files
 . Migrate your database
        Please make a backup before doing this! Under the new application
        directory run:
          rake db:migrate RAILS_ENV="production"
        If you have installed any plugins, you should also run their database
        migrations using:
          rake db:migrate_plugins RAILS_ENV="production"
        If you are upgrading to Rails 2.3.5 as part of this migration, you
        need to upgrade the plugin migrations before running the plugin migrations
        using:
          rake db:migrate:upgrade_plugin_migrations RAILS_ENV="production"
 . Clean up
        Clear the cache and the existing sessions by running:
          rake tmp:cache:clear
          rake 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
     == Notes
 . Rails 2.3.5 is required for version 0.9.
     * Rails 2.3.5 is required for versions 0.9.x and 1.0.x.
 . When upgrading your code with svn update, don't forget to clear
        the application cache (RAILS_ROOT/tmp/cache) before restarting.
     == References
     * http://www.redmine.org/wiki/redmine/RedmineUpgrade

     == Redmine installation
     === Redmine installation
     Redmine - project management software
     Copyright (C) 2006-2010  Jean-Philippe Lang
-...
     * Ruby on Rails 2.3.5 (official downloadable Redmine releases are packaged with
       the appropriate Rails version)
     * Rack 1.0.1
     * RubyGems 1.3.1
     * Rake 0.8.3
     * 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)
     * SCM binaries (e.g. svn), for repository browsing (must be available in PATH)
     * RMagick (to enable Gantt export to png images)
     * Ruby OpenID Library >= version 2 (to enable OpenID support)
     == 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)
 . Configure the database parameters in config/database.yml
        for the "production" environment (default database is MySQL)
 . Generate a session store secret
        Redmine stores session data in cookies by default, which requires
        a secret to be generated. Run:
        rake generate_session_store
        a secret to be generated. Under the application main directory run:
          rake generate_session_store
 . Create the database structure
 . Create the database structure. Under the application main directory:
        rake db:migrate RAILS_ENV="production"
        It will create tables and an administrator account.
        Under the application main directory run:
          rake db:migrate RAILS_ENV="production"
 . Setting up permissions
        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 (create the last one if not present).
        subdirectories: files, log, tmp & public/plugin_assets (create the last
        two if they are not yet present).
        Assuming you run Redmine with a user named "redmine":
          mkdir tmp public/plugin_assets
          sudo chown -R redmine:redmine files log tmp public/plugin_assets
          sudo chmod -R 755 files log tmp public/plugin_assets
        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
 . Test the installation by running the WEBrick web server
        Under the main application directory run:
          ruby script/server -e production
        Once WEBrick has started, point your browser to http://localhost:3000/
        You should now see the application welcome page
        You should now see the application welcome page.
 . Use default administrator account to log in:
 . 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 adjust application settings
        Go to "Administration" to load the default configuration data (roles,
        trackers, statuses, workflow) and to adjust the application settings
     == SMTP server Configuration
     == Email delivery Configuration
     Copy config/email.yml.example to config/email.yml and edit this file
     to adjust your SMTP settings.
     Don't forget to restart the application after any change to this file.
     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

(1-1/1)

Project

General

Profile

Redmine

Defect #5463 » doc_update_for_0.9.x_and_1.0.x-r3847.patch