Linux下Trac安装笔记

参考网址：
http://trac.edgewall.org/wiki/TracInstall
http://trac.edgewall.org/wiki/TracInstallPlatforms
http://trac.edgewall.org/wiki/TracOnRhel5
http://dag.wieers.com/rpm/FAQ.php#B
http://tech.idv2.com/2008/12/26/install-trac-on-linux/

 

软件下载地址：
trac:http://trac.edgewall.org/wiki/TracDownload
Genshi:http://genshi.edgewall.org/wiki/Download
pysqlite:http://download.chinaunix.net/download/0009000/8596.shtml

 

本文所用Linux发行版为CentOS5.3版本，httpd为系统自带版本为2.2.3，所用trac版本为0.11.5，所用Genshi版本为0.5.1，所用pysqlite版本为2.5.5

 

安装Trac所必须的软件：

• Python >= 2.3
  • 注意：如果是用rpm安装的python，那么还需要安装python-devel和python-xml包。
• Genshi >= 0.5
• 可选的subversion >= 1.0（推荐>=1.1.x）和subversion的SWIG Python绑定
• PySQLite，需要用于SQLite 3.x版本的PySQLite 2.x版
• 可运行CGI的Web服务器

接下来就先解决这些前提条件

1、修改yum源以增加trac

rpm -Uhv http://apt.sw.be/redhat/el5/en/i386/rpmforge/RPMS/rpmforge-release-0.3.6-1.el5.rf.i386.rpm

 

2、安装依赖软件

安装前请查看httpd是否安装有mod_python模块，没有则安装

yum install python python-devel python-setuptools mod_python

 

3、如果想要与svn结合则执行下条语句，否则跳过

yum install subversion

 

4、将下载的genshi解压并进行安装

tar -zxvf Genshi-0.5.1.tar.gzcd Genshi-0.5.1python setup.py install

 

5、接下来是subversion。可以用rpm -q subversion确认。而SWIG绑定也已经自带了，可以用以下命令确认

python>>> import svn.repos

不报错，就说明OK了。

 

6、然后确认一下已安装的sqlite版本，并安装sqlite-devel包（用来编译PySQLite）

yum install sqlite sqlite-devel

接下来安装pysqlite

tar -zxvf pysqlite-2.5.5.tar.gzcd pysqlite-2.5.5python setup.py install

 

7、安装Trac，解压安装包后进入解压的文件夹，执行如下命令：

python setup.py instal

 

配置Web服务器
我们将把 /var/www/trac 作为项目的主目录，所有新建的trac项目都放在该目录下，访问URL为/trac/<项目名>。
首先确认安装了 httpd 和 mod_python，此时/etc/httpd/conf.d下应该有个python.conf文件。之后，在/etc/httpd/conf.d下建立一个trac.conf作为Trac的配置文件：
<Location /trac>
    SetHandler mod_python
    PythonInterpreter main_interpreter
    PythonHandler trac.web.modpython_frontend
    PythonOption TracEnvParentDir /var/www/trac
    PythonOption TracUriRoot /trac/
    PythonOption PYTHON_EGG_CACHE /tmp/egg-cache
</Location>
然后在 /var/www 下建立trac目录并修改权限，修改权限是注意你的httpd运行用户，在httpd.conf文件中的user项。
# cd /var/www
# mkdir trac
# chown apache.apache trac
然后重新启动 httpd：
# /etc/init.d/httpd restart
接下来访问http://localhost/trac，如果看到“Available Projects”字样，就说明配置成功了。

建立项目
下面要建立一个Trac的演示项目。进入 /var/www/trac，用trac-admin命令建立：
# cd /var/www/trac
# trac-admin hello_project initenv        (hello_project为项目名称，可以任意选择，接下来的提问全部按回车即可。如果想与subversion联合使用，请继续看)
# chown -R apache.apache hello_project
然后访问http://localhost/trac/hello_project，即可看到Trac的主界面了！
如果想在Trac中查看subversion的代码库，可以在trac-admin工具中把trac项目关联到代码库上。比如，首先建立用于放置代码库的目录，并建立代码库：
# cd /var/www
# mkdir svn
# chown apache.apache svn
# cd svn
# svnadmin create hello_project        (hello_project为代码库名称，可以任意选择)
# chown -R apache.apache hello_project
然后在建立Trac项目时，回答代码库的完整路径：
# trac-admin hello_project initenv
.....
Path to repository [/path/to/repos]> /var/www/svn/hello_project        (输入代码库完整路径)
这样Trac中就可以访问subversion的代码库了。
如果项目已经建好，而想添加subversion支持的话，可以进入项目中的conf目录，修改trac.ini中的repository_dir变量为代码库完整路径即可。
这个方法要求/var/www/trac下的所有内容必须属于apache用户，否则Trac会出错。所以如果看到trac出错了，首先查看一下是不是忘记了做chown。

配置管理界面
接下来需要配置好认证，这样才能方便地通过浏览器来修改项目设置。
首先在 /var/www 下建立 .htpasswd 文件，用来保存用户名和密码：
# cd /var/www
# htpasswd -c .htpasswd root   (建立用户root。如果.htpasswd文件存在，则不用加-c)
然后继续修改 /etc/httpd/conf.d/trac.conf，在末尾添加以下内容：
<LocationMatch "/trac/[^/]+/login">
    AuthType Basic
    AuthName "Trac"
    AuthUserFile /var/www/.htpasswd
    Require valid-user
</LocationMatch>
然后重新启动httpd：
# /etc/init.d/httpd restart
最后，进入/var/www/trac，给刚才建好的hello_project项目设置权限：
# trac-admin hello_project permission add root TRAC_ADMIN
这样，访问 http://localhost/trac/hello_project，然后点击上方菜单中的“Login”，输入用户名root登录之后，即可在右上角看到“Admin”菜单，点击之后即可进入管理界面。

其他资源
    * Trac官方主页：http://trac.edgewall.org/
    * Trac插件：http://trac-hacks.org/
有几个插件不错，推荐使用：TocMacro, AccountManagerPlugin。

 

插件安装

AccountManagerPlugin插件：http://trac-hacks.org/wiki/AccountManagerPlugin

想要安装AccountManagerPlugin，首先要安装setuptools，下载 ez_setup.py (http://peak.telecommunity.com/dist/ez_setup.py)并执行 python ez_setup.py 后完成了setuptools的安装。之后的步骤参见该插件的官方网址。