Trac的安装和配置

技术准备
检查软件包your_package是否安装
#rpm -qa | grep your_package
安装your_package软件包
#rpm -ivh your_package
或者
#rpm -Uvh your_package

步骤1、安装python及相关软件包
请确认下面软件包有没有安装，如果没有安装，请到rhel5/centos5光盘找到这些软件包并安装
libxml2-python-2.6.26-2.1.2
mod_python-3.2.8-3.1
python-devel-2.4.3-19.el5
python-2.4.3-19.el5

步骤2、安装SQLite及相关软件包[如果用MySQL做为Trac数据库，此步可忽略]
请确认下面软件包有没有安装，如果没有安装，请到rhel5/centos5光盘找到这些软件包并安装
sqlite-3.3.6-2
python-sqlite-1.1.7-1.2.1

步骤3、安装MySQL以及相关包[如果用SQLite做为Trac数据库,此步可忽略]
请确认下面软件包有没有安装，如果没有安装，请到rhel5/centos5光盘找到这些软件包并安装
mod_auth_mysql-3.0.0-3.1mysql-server-5.0.22-2.1
mysql-5.0.22-2.1
mysql-devel-5.0.22-2.1
MySQL-python-1.2.1-1

步骤4、安装setuptools[如果你不想用easyInstall，此步可以省略，下面的步骤中我们确实没有用到easyInstall]
#wget http://peak.telecommunity.com/dist/ez_setup.py
#python ez_setup.py
确保你的网络畅通，如果安装失败，多试几次，或者忽略此步安装

步骤5、安装ClearSliver
到官方网站http://www.clearsilver.net/downloads/下载合适版本的ClearSliver
笔者用的是clearsilver-0.10.5.tar.gz
#tar xvfz clearsilver-0.10.5.tar.gz
#cd clearsilver-0.10.5
#./configure --with-python=/usr/bin/python --prefix=/usr/local --disable-ruby --disable-java --disable-apache --disable-csharp --disable-perl
#make
#make install
#cd python
#python ./python.py install

如果你不想自己编译或者安装失败，也可下载以下rpm包
python-clearsilver-0.10.4-4.fc5.rpm
clearsilver-0.10.4-4.fc5.rpm
不过上面两个软件包都是for dedora5,不保证不出什么问题，附件中有这两个rpm包

步骤6、安装Trac及相关软件包
到官方网站http://trac.edgewall.org/下载合适的版本,
笔者用的是trac-0.10.4.tar.gz
#tar xvfz trac-0.10.4.tar.gz
#cd trac-0.10.4
#python ./setup.py install
默认安装在/usr/share/trac/目录下

步骤7、创建MySQL数据库[如果你用SQLite做为Trac的数据库，此步可忽略]
登陆MySQL
#mysql mysql -u root -p
创建用户trac
mysql>GRANT ALL PRIVILEGES ON *.* TO trac@'%' IDENTIFIED BY 'password' WITH GRANT OPTION;
创建数据库,注意:如果你想在Trac中使用中文,必须设定数据库编码是utf8,MySQL缺省编码方式是latin1
mysql>CREATE DATABASE IF NOT EXISTS trac_telecom default charset utf8 COLLATE utf8_general_ci;

步骤8、Trac Projects项目库配置
创建Trac的项目库父路径,我把/trac/projects做为Trac的项目库父路径(ParentDir)。这个目录是任意的，如果是多个项目库的话必须在同一个父路径下，为了便于管理,建议把所有的Trac项目库放在同一个父路径下。我们使用下面的命令来初始化项目库TelecomProjects
#trac-admin /trac/projects/TelecomProjects initenv
下面是trac-admin的安装向导

Project Name [My Project]>TelecomProject //输入项目名称TelecomProject,当然名字是任意的,建议项目库名字和路径名字相同
Database connection string [sqlite:db/trac.db]>mysql://trac:password@localhost:1521/trac_telecom //这里我们用MySQL数据库,如果用SQLite直接回车即可
Repository type [svn]>直接回车 //仓库类型svn回车
Path to repository [/path/to/repos]>/svn/repos/TelecomProjects //输入svn项目库路径
Templates directory [/usr/share/trac/templates]>直接回车 //模板路径，如果你安装的时候选择了Trac安装路径,那么这里要改写成正确的Trac安装路径

步骤9、启动Trac并访问
启动Trac
#tracd --port 8000 /trac/projects/TelecomProjects
然后访问以下网址看Trac是否正常工作
http://localhost:8000/或者http://localhost:8000/TelecomProject
通过上面的步骤7~8,我们可以重复添加多个trac项目
比如
#trac-admin /trac/projects/OtherProjects initenv

步骤10、Apache和Trac集成
编辑apache的配置文件/etc/httpd/conf/httpd.conf文件或者/etc/httpd/conf.d/python.conf文件
在最后增加如下部分

<Location /trac>
SetHandler mod_python
PythonInterpreter main_interpreter
PythonHandler trac.web.modpython_frontend
PythonOption TracEnvParentDir //如果单个项目的话,也可以写成PythonOption TracEnv /trac/projects/TelecomProjects
#PythonOption TracEnv /trac/projects/TelecomProjects
AuthType Basic
AuthName "Trac Projects"
AuthUserFile /svn/.htpasswd
Require valid-user
</Location>

注意1:如果单个项目的话,也可以写成PythonOption TracEnv /trac/projects/TelecomProjects的形式,不过我还是建议所有项目库放在同一个父路径下
注意2：我们可以看到认证方式的配置和svn的配置相同,并且用的是同一个用户认证文件(如果你的svn用用户认证文件认证的话)!

步骤11、安全访问设置[必须设置,否则Trac无法访问]
修改目录的属主和访问权限
#chown apache.apache -R /trac
#chmod 755 -R /trac

修改SELinux的设置
禁用SELinux(强烈不推荐)或者在SELinux图形管理界面中勾上Disable SELinux protection for httpd daemon这个选项，否则apache这个虚拟用户无法访问/trac目录，当然你也可以用更好的方法设置apache的访问权限.

使用心得1．Trac不支持数据库认证方式，支持ldap认证方式，如果想和svn的帐号合二为一，必须采用登陆用户文件的认证方式，笔者在另外一篇文章中将会谈到svn+trac+apache的集成方案2．Trac的附件支持太小（大概250k左右），我们可以修改Trac项目库的配置文件，比如/trac/projects/TelecomProjects/conf/trac.ini文件，找到[attachment]max_size=262144………把max_size的值修改成你想要的大小即可，比如1000000(10M左右)3．附件文本中文问题，附件如果是文本方式的，要把文本的字符编码变成utf-8，比如可用记事本把txt文件变成utf-8格式，否则附件内容显示在页面上显示会出现乱码，当然文件下载下来是没问题的，不知道Trac为什么会显示文本附件的内容。

相关推荐