Redmine

redMine is a flexible project management web application. Written using Ruby on Rails framework, it is cross-platform and cross-database.

redMine is open source and released under the terms of the GNU General Public License (GPL).

Features

Multiple projects support
Flexible role based access control.
Flexible issue tracking system
Gantt chart and calendar
News, documents & files management
Feeds & email notifications.
Per project wiki
Per project forums
Simple time tracking functionality
Custom fields for issues, projects and users
Repository integration (SVN, CVS, Mercurial and Darcs)
Multiple LDAP authentication support
User self-registration support
Multilanguage support
Multiple databases support

more redmine features: http://www.redmine.org/wiki/redmine/Features

Repository

Download

Latest source

You can checkout the latest source from the SVN repository trunk.

svn checkout svn://rubyforge.org/var/svn/redmine/trunk

Or

svn checkout http://redmine.rubyforge.org/svn/trunk/

download Latest release from

Install

在 NetBeans 6.0 下编译 redMine

安装 Ruby:

Linux/UNIX

http://download.huihoo.com/ruby/
tar xzvf ruby-1.8.6.tar.gz
cd ruby-1.8.6
./configure –prefix=/usr/local/ruby
make && make install
修改 .bashrc
export PATH=/usr/local/ruby/bin:$PATH
http://download.huihoo.com/ruby/rubygems-0.8.11.zip
unzip rubygems-0.8.11.zip
cd rubygems-0.8.11
ruby setup.rb
gem install rake

Windows

http://download.huihoo.com/ruby/

安装 Rails:

http://download.huihoo.com/rails/

按顺序安装

gem install activesupport-1.4.2.gem
gem install activerecord-1.15.3.gem
gem install actionpack-1.13.3.gem
gem install actionmailer-1.3.3.gem
gem install actionwebservice-1.2.3.gem
gem install rails-1.2.3.gem   
rails -v 显示Rails 1.2.3 :)

注意：若先前安装了JRuby可能安装会出现问题，建议安装前删除jruby目录

通过NetBeans IDE 6.0 > New Project > Ruby > Ruby on Rails Application with Existing Sources 导入 redmine-0.6.0

选择 Ruby Interpreter 是 Ruby // JRuby编译redmine有问题

创建数据库, 在 mysql 中创建以下数据库:

redmine
redmine_development
redmine_test

这样创建: CREATE DATABASE test DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;

cd redmine-0.6.0/config copy database.yml.exmple to database.yml

修改 Configuration>database.yml中的mysql连接信息

导入原始数据:

In the Projects window, right-click the readmin-0.6.0 project node and choose Migrate Database > To Current Version from the pop-up menu.

安装成功，启动应用:

right-click the readmin-0.6.0 project node and choose Run
http://localhost:3000 :)

或

Create an empty database: "redmine" 
CREATE database redmine DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
rake db:migrate RAILS_ENV="production" // linux 下可能要做个符号链接 ln -s /var/lib/mysql/mysql.sock /tmp/mysql.sock
rake redmine:load_default_data RAILS_ENV="production"
ruby script/server -e production   
http://localhost:3000/
用户信息: admin/admin

目前在Windows上可能会出现的严重错误是当点击版本库时(与Subversion的绑定)，系统会自动停止，并删除了Ruby等执行文件(没注意是不是卡巴斯基的问题)。之后 Ruby,Rails等应用就无法再启动。需重新安装 Ruby

部署到 Apache HTTPD上

命令行下编译:

Requirements

Ruby 1.8.6
Rails >= 1.2.2

先卸载Ruby 1.8.5, 再重新安装 Ruby 1.8.6

$ gem list --local
# gem install rails --include-dependencies

1. Uncompress the program archive

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

3. Configure database parameters in config/database.yml

  for "production" environment (default database is MySQL)

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

  rake db:migrate RAILS_ENV="production"
  It will create tables and an administrator account.

5. Insert default configuration data in the database:

  rake redmine:load_default_data RAILS_ENV="production"
  It will load default roles, trackers, statuses, workflows and enumerations.
  This step is optional but *highly recommended*

6. 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

7. Use default administrator account to log in:

  login: admin
  password: admin

8. You can go to "Admin -> Settings" to modify application settings.

9. Setup Apache or Lighttpd with fastcgi for best performance.

Database

数据库中表的定义在 redmine-0.6.0\db\schema.rb 中, 如：

  create_table "projects", :force => true do |t|
   t.column "name",           :string,   :limit => 30, :default => "",   :null => false
   t.column "description",    :string,                 :default => "",   :null => false
   t.column "homepage",       :string,   :limit => 60, :default => ""
   t.column "is_public",      :boolean,                :default => true, :null => false
   t.column "parent_id",      :integer
   t.column "projects_count", :integer,                :default => 0
   t.column "created_on",     :datetime
   t.column "updated_on",     :datetime
   t.column "identifier",     :string,   :limit => 20
   t.column "status",         :integer,                :default => 1,    :null => false
 end

PostgreSQL

创建 redmine, 格式为 UTF-8

修改database.xml

test_pgsql:
 adapter: postgresql
 database: redmine
 host: localhost
 username: postgres
 password: "postgres"

执行以下命令：

rake db:migrate RAILS_ENV="test_pgsql"

中文化

用UTF-8建立数据库后, 运行

rake db:migrate RAILS_ENV="devlopment"
rake redmine:load_default_data RAILS_ENV="developent"

select language: bg, cs, de, en, es, fr, he, it, ja, ko, nl, pl, sr, sv, zh[en] //默认是en,选择zh存入数据库的数据是乱码，但显示正确。

ruby script/server -e development

在这里要解决数据库乱码的问题

更多细节: redMine Chinese

Continuous integration

Continuous Integration Plugin

A generic plugin for integrating per project RSS continuous integration feeds in Redmine.

svn co svn://rubyforge.org/var/svn/redmine/plugins/simple_ci

http://www.redmine.org/wiki/1/PluginSimpleCI

Mongrel

使用Mongrel异常简单, 使用的是plain HTTP而非FastCGI或SCGI.

Lighttpd

绑定Lighttpd可参考 Install_Ruby_Rails_Lighttpd_MySQL_on_Ubuntu_or_FreeBSD

Nginx

绑定Nginx

gem install mongrel

Nginx Ruby on Rails Mongrel http://wiki.codemongers.com/NginxRubyonRailsMongrel

SSO

集成OpenSSO]

Plugins

提供RedMine的可扩展性, 使其RedMine成为类似Eclipse的插件系统 :)

To add plugin support to Redmine, install engines plugin:

  See: http://rails-engines.org/

Plugin installation

1. Copy the plugin directory into the vendor/plugins directory

2. Migrate plugin: rake db:migrate_plugins

3. Start Redmine, Installed plugins are listed on 'Admin -> Information' screen.

Links

User

http://redmine.lighttpd.net/
TYPO3 Forge - http://forge.typo3.org
Redmine Hacks - http://www.redminehacks.org/
IntelliSoft Systems - http://intellisoftsystems.com
Makerlab - http://makerlab.com
phpBB Code Forge - http://code.phpbb.com
rVooz - http://redmine.rvooz.org/projects
Applied Solutions - http://www.appsol.net
SharpOS - http://sharpos.org/redmine
Quake-World Dev - http://www.qw-dev.net/
Ensemble OS - http://ensemble-os.org/
Siemens (PG branch) - http://www.co2quickstart.co.uk/redmine/login
Nebular Gauntlet - http://www.silentlink.com/
Little Stream Software - https://projects.littlestreamsoftware.com
OpenRain, LLC - (hidden Redmine) homepage: http://openrain.com/
John Goerzen - 17 projects at http://software.complete.org/
http://dev.ruby-lang.org.cn/

More: http://www.redmine.org/wiki/redmine/TheyAreUsingRedmine