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

• Git
• Subversion
• Mercurial
• CVS
• Darcs
• Bazaar

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

• http://rubyforge.org/frs/?group_id=1850
• http://download.huihoo.com/redmine

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

• http://demo.redmine.org/
• redmine论坛: http://rubyforge.org/forum/?group_id=1850
• http://download.huihoo.com/redmine
• http://docs.huihoo.com/redmine/

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

<discussion>characters_max=300</discussion>