project_management:redmine
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
project_management:redmine [2011/01/26 14:14] – aorth | project_management:redmine [2020/01/30 12:52] (current) – removed aorth | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Redmine Project Management ====== | ||
- | Redmine is a bug tracking, source code and project management web application (similar to [[project_management: | ||
- | * Official install guide: http:// | ||
- | * Unofficial install guide: http:// | ||
- | * Arch Linux wiki guide: http:// | ||
- | |||
- | ===== Install dependencies ===== | ||
- | ==== apt-get ==== | ||
- | < | ||
- | |||
- | ==== Ruby gems ==== | ||
- | < | ||
- | $ sudo gem install sqlite3 | ||
- | $ sudo gem install fastthread | ||
- | $ sudo gem install -v=0.4.2 i18n</ | ||
- | |||
- | ===== Configure Redmine ===== | ||
- | Download and unzip the latest stable tarball: | ||
- | < | ||
- | $ tar zxf redmine-0.9.4.tar.gz</ | ||
- | |||
- | ==== Move redmine ==== | ||
- | Move redmine somewhere universal, outside of your home folder. | ||
- | |||
- | < | ||
- | $ cd / | ||
- | |||
- | ==== Configure the database ==== | ||
- | We can either use MySQL or SQLite. | ||
- | |||
- | Edit // | ||
- | < | ||
- | | ||
- | | ||
- | |||
- | ==== Initialize the database ==== | ||
- | < | ||
- | $ rake rake generate_session_store | ||
- | $ RAILS_ENV=production rake db:migrate | ||
- | $ RAILS_ENV=production rake redmine: | ||
- | |||
- | ==== Test the server ==== | ||
- | Before we can use Redmine with Apache, we have to make sure the installation worked fine. Use the built-in webserver to test first: | ||
- | < | ||
- | If you get an error about not finding ruby, make sure the ruby version in the '' | ||
- | |||
- | Navigate to http:// | ||
- | |||
- | ===== Configure Apache ===== | ||
- | |||
- | ==== Install Phusion Passenger ==== | ||
- | Phusion Passenger (" | ||
- | |||
- | * Reference: http:// | ||
- | * http:// | ||
- | |||
- | === Enable the repository === | ||
- | < | ||
- | $ sudo sh -c 'wget -q -O - http:// | ||
- | $ sudo apt-get update</ | ||
- | |||
- | === Install the Apache module === | ||
- | < | ||
- | |||
- | === Configure Apache settings === | ||
- | Apache will serve Redmine via Phusion Passenger, which doesn' | ||
- | |||
- | === Configure mod_rail.conf === | ||
- | /// | ||
- | < | ||
- | PassengerRoot / | ||
- | PassengerRuby / | ||
- | |||
- | === Configure redmine.conf === | ||
- | /// | ||
- | < | ||
- | RailsEnv production | ||
- | |||
- | < | ||
- | AllowOverride all | ||
- | Options -MultiViews | ||
- | #Options Indexes ExecCGI FollowSymLinks | ||
- | Order allow,deny | ||
- | Allow from all | ||
- | </ | ||
- | |||
- | Link the Redmine installation to the web document root; make sure to use the same name as in your Apache configuration: | ||
- | < | ||
- | |||
- | === Fix permissions === | ||
- | Change permissions so the web server can read/write important files/ | ||
- | < | ||
- | |||
- | === Restart Apache === | ||
- | < | ||
- | |||
- | === Test the install === | ||
- | |||
- | http:// | ||
- | |||
- | ===== Migrate Trac projects ===== | ||
- | * Reference: http:// | ||
- | |||
- | ==== Install sqlite3-ruby ==== | ||
- | My Trac 11.x databases were in sqlite3 format, so I needed the '' | ||
- | < | ||
- | |||
- | ==== Migrate project ==== | ||
- | From the Redmine directory: | ||
- | < | ||
- | (in / | ||
- | |||
- | WARNING: a new project will be added to Redmine during this process. | ||
- | Are you sure you want to continue ? [y/N] y | ||
- | |||
- | Trac directory []: / | ||
- | Trac database adapter (sqlite, sqlite3, mysql, postgresql) [sqlite]: sqlite3 | ||
- | Trac database encoding [UTF-8]: | ||
- | Target project identifier []: sampler | ||
- | |||
- | Migrating components.. | ||
- | Migrating milestones.... | ||
- | Migrating custom fields | ||
- | Migrating tickets | ||
- | Migrating wiki........ | ||
- | |||
- | Components: | ||
- | Milestones: | ||
- | Tickets: | ||
- | Ticket files: | ||
- | Custom values: | ||
- | Wiki edits: | ||
- | Wiki files: | ||
- | |||
- | Make sure you don't use spaces in the project identifier; this is part of the URL path for the Redmine interface. | ||
- | |||
- | ===== Active Directory Authentication ===== | ||
- | None of this seems to work... | ||
- | |||
- | * Reference: http:// | ||
- | * Reference: http:// | ||
- | * Reference: http:// | ||
- | |||
- | ==== Patch ==== | ||
- | http:// | ||
- | |||
- | < | ||
- | # patch -p1 < / | ||
- | |||
- | ===== Updating Redmine from SVN ===== | ||
- | See the [[http:// | ||
- | < | ||
- | # tar cjf redmine_before_1.0.1.tar.bz2 redmine/ | ||
- | # cd redmine | ||
- | # svn update | ||
- | # rake db:migrate RAILS_ENV=production | ||
- | # rake db: | ||
- | # rake tmp: | ||
- | # rake tmp: | ||
- | # apache2ctl graceful</ | ||
- | |||
- | ===== Change local administrator password manually ===== | ||
- | < | ||
- | # RAILS_ENV=production ruby1.8 script/ |