Redmine+Apache+SVN+Postfix完整配置指南

Redmine+Apache+SVN+Postfix完整配置指南

---

Edition	Author	State	Date	Description
1.0	iifksp	completed	2010/06/08	基于redmine-0.9.4, Ubuntu-server-10.04-i386, subversion-1.6.3
1.0.1	iifksp	completed	2010/07/19	更新gem install安装正常，passenger版本更新为2.2.15，修正一处添加redmine站点的不详描述
1.0.2	iifksp	completed	2010/08/01	redmine官方更新到版本1.0.0 (数据库表数为48)，更新wget地址

序言

安装配置时若是遇到问题，能够到 我博客的对应文章 给我留言，我会尽力回复你的问题。

版本0.8.x能够参考我写的在ubuntu上简单配置redmine。

版本0.9.x能够参考我写的redmine-0.9.x配置过程。

或者参看个人关于redmine的文章列表。

安装ubuntu-10.04-server

这里配置的是Ubuntu server最新的10.04。关于系统安装就很少说什么了，塞进光盘而后一路next~

系统初始配置信息。
IP：192.168.242.130
主机名：redmine
预装选择：LAMP server，Mail server，OpenSSH server

若是不须要redmine的邮件通知，或者不想本身搭建邮件服务器而使用已存在或者其余SMTP邮件服务来发送邮件的话，能够不用安装Mail server，即postfix。若是是这样，那么下面的这步也能够省去。

完成安装后，既然是新系统，就先更新到最新吧:)

apt-get update
apt-get upgrade

而后咱们来开始配置redmine。

获取redmine及相关信息

redmine基于ROR，因此对于ROR的开发人员来讲部署这个系统要比不了解ROR的人容易的多。这里假设你对ROR是有必定的了解的。若是不了解，照着步骤作便可。 先找到redmine的下载， redmine的官方网站上有不少参考信息， 下载列表则是在rubyforge.org上。 当前最新版本是0.9.4 1.0.0。redmine官方的 安装和配置文档包含了linux和windows的配置，包括对系统需求。但可能文档不尽详尽，安装中会遇到不少问题。若是仅仅只是想体验下安装过程，并想知道怎么解决具体遇到的问题，能够参看我以前写的 redmine-0.9.x配置过程。 我将redmine放在/usr/local/里：

cd /usr/local/

获取当前版本并解压：

wget http://rubyforge.org/frs/download.php/71723/redmine-1.0.0.tar.gz
tar zxvf redmine-1.0.0.tar.gz
mv redmine-1.0.0 redmine

配置mysql数据库

数据库是mysql，为redmine创建库，库名redmine。同时建立redmine用户，把库的权限分配给这个用户。最后设置用户的密码为'redminePASSWORD'。固然这里的库名、用户名和密码，能够按实际状况替换。

mysql -u root -p
mysql> create database redmine character set utf8;
mysql> grant select,insert,delete,update,create,drop,alter,index on redmine.* to redmine;
mysql> SET PASSWORD FOR 'redmine' = PASSWORD('redminePASSWORD');
mysql> flush privileges;
mysql> exit;

安装与配置

进入redmine的主目录，开始配置数据文件，把配置指向刚才创建的库。

cd /usr/local/redmine
cp config/database.yml.example config/database.yml
vim config/database.yml

配置production部分红以下所示。其中的database，username，password按实际状况替换。

production:
  adapter: mysql
  database: redmine
  host: localhost
  username: redmine
  password: redminePASSWORD
  encoding: utf8

当前版本的需求是ruby 1.8.6, 1.8.7 Rails 2.3.5 Rack 1.0.1。为此首先安装须要的包。

apt-get install rake rubygems libopenssl-ruby libmysql-ruby

能够看到这些包被安装：

irb1.8 libmysql-ruby libmysql-ruby1.8 libopenssl-ruby
libopenssl-ruby1.8 libreadline-ruby1.8 libreadline5 libruby1.8 rake
rdoc1.8 ruby ruby1.8 rubygems rubygems1.8 unzip zip

rake的安装则必须指定版本：

gem install rack --version=1.0.1

上面这条命令在我之前写配置的时候一直有效，可是在编写此文时，gem的在线安装有些问题。不知是出于网络的问题仍是其余缘由，我获得了下面的错误：

WARNING:  RubyGems 1.2+ index not found for:
        http://gems.rubyforge.org/

RubyGems will revert to legacy indexes degrading performance.
Bulk updating Gem source index for: http://gems.rubyforge.org/
ERROR:  While executing gem ... (Gem::RemoteSourceException)
    Error fetching remote gem cache: SocketError: getaddrinfo: Temporary failure in name resolution (http://gems.rubyforge.org/yaml)

google以后也没能找到什么结果，因此只好本地安装rack了。

更新(2010/07/19):在线安装已经恢复正常，看来产生上面的错误是临时性的。但仍旧保留下面的本地安装方式。

下载对应的rack-1.0.1.gem到本地后安装：

wget http://rubyforge.org/frs/download.php/65736/rack-1.0.1.gem
gem install --local rack-1.0.1.gem

继续下面的步骤，生成会话存储密钥：

RAILS_ENV=production rake config/initializers/session_store.rb

注：r3055以后的版本移除了config/initializers/session_store.rb，使用下面的命令替代。

rake generate_session_store

而后开始建立数据库表结构，在redmine的根目录下运行：

RAILS_ENV=production rake db:migrate

读取默认配置数据，当遇到选择语言(Select language)时，选择zh：

RAILS_ENV=production rake redmine:load_default_data

Select language: bg, bs, ca, cs, da, de, el, en, es, fi, fr, gl, he, hr, hu, id, it, ja, ko, lt, nl, no, pl, pt, pt-BR, ro, ru, sk, sl, sr, sv, th, tr, uk, vi, zh, zh-TW [en]zh
====================================
Default configuration data loaded.

至此，redmine简单的配置就完成了。使用其自带的webrick来运行redmine，来检查下redmine的配置吧:)

ruby script/server webrick -e production

默认的管理员用户名和密码都是admin，进入系统后就能够开始熟悉下了。能够为每一个人定义语言环境。下图是管理页面。

在apache上部署

其自带的webrick可能不能知足使用需求，那么就把它配置到apache上。 apache运行ROR有多种方式，这里使用passenger。

apt-get install build-essential
apt-get install apache2-prefork-dev libaprutil1-dev libapr1-dev ruby1.8-dev

而后安装 passenger

gem install passenger
passenger-install-apache2-module

若是报passenger-install-apache2-module这条命令找不到的话，那么经过下面的命令查看执行路径：

gem environment

RubyGems Environment:
  - RUBYGEMS VERSION: 1.3.5
  - RUBY VERSION: 1.8.7 (2010-01-10 patchlevel 249) [i486-linux]
  - INSTALLATION DIRECTORY: /var/lib/gems/1.8
  - RUBY EXECUTABLE: /usr/bin/ruby1.8
  - EXECUTABLE DIRECTORY: /var/lib/gems/1.8/bin
  - RUBYGEMS PLATFORMS:
    - ruby
    - x86-linux
  - GEM PATHS:
     - /var/lib/gems/1.8
     - /root/.gem/ruby/1.8
  - GEM CONFIGURATION:
     - :update_sources => true
     - :verbose => true
     - :benchmark => false
     - :backtrace => false
     - :bulk_threshold => 1000
  - REMOTE SOURCES:
     - http://gems.rubyforge.org/

其中，EXECUTABLE DIRECTORY就是命令的全路径，因此对于我例子里的状况执行

/var/lib/gems/1.8/bin/passenger-install-apache2-module

根据提示安装和部署。passenger会在本机编译并成为apache的一个模块。安装过程当中会遇到下面的提示信息(根据版本的不一样，信息也会稍有变化)：

Welcome to the Phusion Passenger Apache 2 module installer, v2.2.13.

This installer will guide you through the entire installation process. It
shouldn't take more than 3 minutes in total.

Here's what you can expect from the installation process:

 1. The Apache 2 module will be installed for you.
 2. You'll learn how to configure Apache.
 3. You'll learn how to deploy a Ruby on Rails application.

Don't worry if anything goes wrong. This installer will advise you on how to
solve any problems.

The Apache 2 module was successfully installed.

Please edit your Apache configuration file, and add these lines:

   LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-2.2.13/ext/apache2/mod_passenger.so
   PassengerRoot /var/lib/gems/1.8/gems/passenger-2.2.13
   PassengerRuby /usr/bin/ruby1.8

After you restart Apache, you are ready to deploy any number of Ruby on Rails
applications on Apache, without any further Ruby on Rails-specific
configuration!

Deploying a Ruby on Rails application: an example

Suppose you have a Rails application in /somewhere. Add a virtual host to your
Apache configuration file and set its DocumentRoot to /somewhere/public:

   
      ServerName www.yourhost.com
      DocumentRoot /somewhere/public    # <-- be sure to point to 'public'!
      
         AllowOverride all              # <-- relax Apache security settings
         Options -MultiViews            # <-- MultiViews must be turned off
      
   

And that's it! You may also want to check the Users Guide for security and
optimization tips, troubleshooting and other useful information:

  /var/lib/gems/1.8/gems/passenger-2.2.13/doc/Users guide Apache.html

Enjoy Phusion Passenger, a product of Phusion (www.phusion.nl) :-)
http://www.modrails.com/

Phusion Passenger is a trademark of Hongli Lai & Ninh Bui.

根据提示信息部署，我这里的步骤稍有不一样。

首先，编辑apache的配置文件并添加下面的信息

(注：“passenger-2.2.13”里的版本号需根据实际状况更改，当前(2010/07/19)的更新为passenger-2.2.15)

：

vim /etc/apache2/apache2.conf

LoadModule passenger_module /var/lib/gems/1.8/gems/passenger-2.2.13/ext/apache2/mod_passenger.so
   PassengerRoot /var/lib/gems/1.8/gems/passenger-2.2.13
   PassengerRuby /usr/bin/ruby1.8

而后在/etc/apache2/sites-available添加一个站点：

vim redmine

并添加以下内容：

RailsBaseURI /redmine

在web根目录创建redmine主目录的符号连接，并设置权限：

ln -s /usr/local/redmine/public /var/www/redmine 
chown -R www-data:www-data /var/www

启用redmine站点：

a2ensite redmine

最后重启apache：

/etc/init.d/apache2 restart

或，从新加载配置：

/etc/init.d/apache2 reload

打开浏览器，若是你可以访问到redmine，那么恭喜你，redmine已经在apache上运行良好！

创建SVN版本库

版本控制svn能够参考《subversion 权威指南》，网上也有不少下载。不过我不太喜欢这本书，由于看起来会比较无聊:) 下面简单地安装svn并创建一个测试用库。 首先，安装subversion版本控制：

apt-get install subversion

建立SVN的根目录，这里我建在/var。而后创建一个演示用的库。

cd /var
mkdir svn
cd svn
svnadmin create demo

而后配置demo库：

cd demo/conf
ls -l

conf目录里是authz，passwd和svnserve.conf这三个文件，分别用于配置用户权限、用户密码和配置此版本库(demo)。

-rw-r--r-- 1 root root 1089 2010-06-04 14:45 authz
-rw-r--r-- 1 root root  335 2010-06-04 14:44 passwd
-rw-r--r-- 1 root root 2265 2010-06-04 14:44 svnserve.conf

首先配置svnserve.conf的内容：

• anon-access 匿名访问默认权限，默认为read。
• auth-access 受权访问默认权限，默认为write。
• password-db 用户密码文件，默认为与svnserve.conf同目录的passwd文件。
• authz-db 用户受权文件，默认为与svnserve.conf同目录的authz文件。
• realm 显示库名

须要注意的是，每行开头不能留空格。

[general]
anon-access = read
auth-access = write
password-db = passwd
authz-db = authz
realm = Demo Repository

passwd文件里存储的是用户名和密码，一行一条记录。

[users]
redmine = redminePASSWORD

authz是受权文件，配置着每一个用户和组的权利，下面是把redmine用户放到redmine_group组里并赋予redmine_group组demo库的读写权限。

[groups]
dev = redmine
[demo:/]
@dev = rw

简单配置完后，启动svnserve：

svnserve -d -r /var/svn

最后将SVN服务加入自启动：

cd /etc/rc2.d
vim S88svnserve

并在文件S88svnserve中添加上面的启动命令

svnserve -d -r /var/svn

最后还不能忘了加上执行权限：

chmod +x S88svnserve

而后，在redmine中对应项目的配置里，指向对应的版本库。

邮件配置

这里让redmine用默认配置的Postfix来发送邮件。若是在安装ubuntu的时候没有安装邮件服务器，这里也能够经过下面的命令来安装：

apt-get install postfix

这里之因此要特地配置个邮件服务器，彻底是为了使整个redmine系统完整。彻底可使用其余邮件服务。 默认配置的Postfix已经可以知足当前的发信状况。关于邮件系统和Postfix的讨论严重超出了本文范围，对于不熟悉Postfix的人，我推荐阅读 Postfix基础配置，若是想了解更多，能够阅读 Postfix虚拟邮件系统彻底配置(尽管此文还未彻底完成)。 若是想要知道邮件系统的前因后果，邮件服务器如何处理邮件，那么我强烈建议阅读《Postfix权威指南》一书，这本书对于邮件系统的讲解深刻浅出，是本好书。 redmine邮件的配置文件一样在主目录的config里：

cp email.yml.example email.yml
vim email.yml

移动到末尾能够看到默认的配置，将production改成以下所示。其中的域名等信息按实际状况替换。

production:
  delivery_method: :smtp
  smtp_settings:
    address: localhost
    port: 25
    domain: swordair.com
    authentication: :none

更多邮件信息参考： 官方邮件配置参考。里面包括了如何来写验证信息等内容。 至此，你就得到了一个敏捷运行的redmine项目管理系统。