Trac0.12 的安装步骤！！！！

简介

Trac 是一个用Python写的开源的基于Web的项目管理系统，具有问题/Bug/任务管理，WIKI，通过浏览器访问Subversion仓库等特性，并可以通过一些插件来扩充Trac 的功能。Trac具有完善的权限管理机制Trac的核心是Ticket System，项目开发中的Task ,Bug在Trac中都统称为Ticket(可译为任务单),一个Ticket有很多属性，这些属性是可以自定义的，其中Type属性表明该Ticket是一个Task还是Bug。

Trac还具有路线图和Timeline，其中路线图由多个里程碑构成，一个里程碑中可以包含多个Ticket 任务；而Timeline则是查看对Ticket的历史改变，显示所有的对Ticket的变更记录

为了统一管理和协作编写项目文档，Trac也提供了Wiki功能，可以直接在Trac中写文档

Trac可以与SubVersion无缝集成，在Trac中可以直接通过浏览器访问Subversion存储库中的内容

Trac 的数据库缺省是SQLite，但也支持使用MySQL, PostgreSQL数据库

Trac的安装步骤：< http://hi.baidu.com/system_network/blog/item/ce1dcec37ff99538e5dd3b93.html>Trac is written in the Python programming language and needs a database,  SQLite,  PostgreSQL, or  MySQL. For HTML rendering, Trac uses the  Genshi templating system. （Trac是写在Python编程语言，需要一个数据库，   SQLite , SQLite的 ，   PostgreSQL , or PostgreSQL的 ，或   MySQL . MySQL的 。 For HTML rendering, Trac uses the对于HTML渲染，Trac的使用   Genshi templating system. 元史模板系统。）

安装需要的软件列表

httpd-2.2.15-win32-x86-openssl-0.9.8m-r2.msi
Setup-Subversion-1.6.6.msi
python-2.5.4.msi
setuptools-0.6c11.win32-py2.5.exe
mod_python-3.3.1.win32-py2.5-Apache2.2.exe
svn-python-1.6.6.win32-py2.5.exe
docutils
pygments
pytz
babel
genshi
trac-0.12rc1-py2.6-win32.

一.安装Apache 2.2，Setup-Subversion-1.6.6（就是svn），修改Apache的监听端口改为8000.

二.配置svn和apace
步骤1

 从Subversion/bin 中将mod_authz_svn.so mod_dav_svn.so复制到Apache2.2/modules下，再将 Subversion/bin目录下的所有dll文件全部复制到Apache2.2/bin文件夹下。
步骤2

 找到Apache2.2/conf/httpd.conf文件,然后去掉如下几行的注释(删除 '#'标记):
#LoadModule dav_fs_module modules/mod_dav_fs.so
#LoadModule dav_module modules/mod_dav.so
将下面两行添加到LoadModule部分的最后。
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so
进行如上后续修改后完成了SVN+Apache之间的WebDav的工作了。重启Apache以后可看到如下图:

 

 

注意下面的状态栏已经是Apache/2.2.15 SVN1.6.6

 

步骤3

建立一个SVN存放文件的目录，我在D盘下创建一个文件夹：D:/svn
接下来我们必须告诉Apache我们的资源 库所在的路径，可以通过Location指令来完成这个设置。因为不希望为每个单独的项目都进行单独的设置，所以我们把所有项目都存放在统一的资源库目 录，那么可以使用SVNParentPath指令来指定存放所有项目的路径。在httpd.conf文件最后添加下面配置：
<Location /svn>
    DAV svn
    SVNListParentPath on
    SVNParentPath "D:/svn"
    #SVNPath "D:/svn/projects"
    ####################认证的类型
    AuthType Basic
    ####################认证的名称,显示于登录提示框
    AuthName "Subversion 资源库，请登录!"
    ####################Which password file to use for authentication 存储用户登录信息的文件
    AuthUserFile D:/svn/passwd
    ####################限定各个用户或组在版本库中目录的访问权限
    AuthzSVNAccessFile D:/svn/svnaccessfile
    ####################让所有用户对版本库都有读的权限而只有特定的用户才有写的权限
    Require valid-user
</Location>
在命令行窗口中转到Apache所在的目录，执行下列命令,创建用户及密码
说明：创建用户admin

输入：htpasswd –c D:/svn/passwd admin
说明：使用-c参数来创建一个passwd文件
输出：
New password: *****
Re-type new password: *****
Adding password for user admin

再创建用户的时候就不用-c参数，而是用-m参数，因为文件passwd 已经创建。

打开passwd文件，密码使用MD5加密过了，而且同样的密码加密出来的内容却不相同。

执行命令svnadmin create --fs-type fsfs D:/svn/projects，等待提示创建完成

然后用文本编辑器创建一个Subversion授权文件，文件名为svnaccessfile，内容如下：
[groups]
admin =admin
devteam1 =
devteam2 =
# 为所有库指定默认访问规则
# 所有人可以读，管理员可以写，危险分子没有任何权限，[/]代表根目录
[/]
* = r
@admin = rw
dangerman =
# 允许开发人员可以完全访问他们的项目版本库
[projects:/]
@admin = rw

保存好上面的所有配置文件之后，重新启动Apache服务器。此时我们就可以在IE里面通过http://localhost:8000/svn/projects/来测试用户登录，以及不同用户组权限。

三.安装Python2.5，默认安装，我的安装路径D:/trac0.12/Python25

四.安装setuptools 至少要 0.6。将easy_install.exe所在路径（例如D:/trac0.12/Python26/Scripts）添加到系统环境变量path中。
五使用 setuptools 安装 docutils、pygments ，pytz
就是进入命令行执行
easy_install docutils
easy_install pygments
easy_install pytz
注：Docutils 是一个开源的文本处理工具，主要用来将纯文本转换成 HTML 或者 LaTeX 格式文档。
genshi，一个基于 Python 的模板引擎，由 edgewall(www.edgewall.org) 开发。
六.从 svn 安装 Genshi、Babel 和 Trac，通过 easy_install 安装的版本太低，会挂掉。我统一把它们安装到 D:/trac0.12 。
svn co http://svn.edgewall.org/repos/babel/trunk babel
svn co http://svn.edgewall.org/repos/genshi/trunk genshi
svn co http://svn.edgewall.org/repos/trac/trunk trac
svn co http://www.unicode.org/repos/cldr/tags/release-1-7-2/common/ cldr
svn co 之后，进入 genshi 目录，执行 python setup.py install 安装好。
然后进入 babel 目录，执行一下 python ./scripts/import_cldr.py ../cldr，把 cldr 的导入，这是正确安装多语言版本必经的一步。一定要注意。cldr 导入完成后再执行 python setup.py install，这是必须的。
接下来进入 trac 目录，需要注意一下是我们要使用中文翻译，所以要进入 trac 的目录执行一下 python setup.py compile_catalog -f，把语言包编译成本地的版本。再执行 python setup.py install 就行了。
先简单验证一下安装有没有成功，在任意目录执行一下 tracd，如果出现 tracd 的 usage 就对了：
Usage: tracd-script.py [options] [projenv] ...

七.配置Trac环境
完成上述的安装后，就可以创建一个TracEnvironment，它是Trac存储信息的地方，如 wiki pages, tickets, reports, settings, 等。
1. 通过trac-admin创建一个Trac Environment
trac-admin D:/trac0.12/projects initenv
后根据提示输入项目的名字(myproject)，数据库连接字符串（默认），你的源代码资源库路径。
2.在8080端口上单项目运行   tracd -p 8080 D:/trac0.12/projects
当看到 Serving on 0.0.0.0:8080 view at http://127.0.0.1:8080/ 时，就表示服务器启动成功了，可以打开浏览器，看到如下效果图：

配置内容说明

设置	解释
<Location>	意思是Subversion版本库的URL是http://ipaddress/svn/
DAV svn	告诉Apache是哪个模块响应那个URL的请求－此刻是Subversion模块。
SVNPath	告诉Subversion需要查看的版本库位于D:/var/svnhome/projects之下
AuthType Basic	激活基本认证，就是用户名/密码
AuthName	用来说明弹出要求输入认证信息的对话框信息,可以使用中文.
AuthUserFile	指定使用认证密码的文件
AuthzSVNAccessFile	位置Subversion版本库的访问控制权限的路径文件
Require valid-user	指定只有输入了正确的用户/密码的用户可以访问URL

八.Apache+SVN与Trac集成
上面的配置是运行在一个独立的服务器上，只能运行一个项目，一般只用于自己单机访问。考虑到我们前面安装的SVN是运行在Apache服务器上，我们最好也让Trac运行在Apache服务器上，便于网上共享；而且和Apache集成有很多优点，比如充分利用apache的强大功能以及ModPython的高效率，便于管理与控制，很方便支持ssl等等。在官方网站上提供的安装指南上面提供了三种方法CGI, FastCGI and mod_python.为了提高性能，推荐使用后面两种，我安装时采用第三种。1、在http://www.modpython.org/ 页面下载相应的安装程序，注意版本对应。我下载的是mod_python-3.3.1.win32-py2.5-Apache2.2.exe，然后安装，安装过程中会要求选择apache的安装目录，并且自动把mod_python.so复制到modules目录 。完成后还要进行配置.

配置ModPython
在apache的httpd.conf中加入下面一行：
LoadModule python_module modules/mod_python.so
配置trac
在apache的httpd.conf中加入下面内容：
#setup trac on mod_python
<location /trac0.12/projects>
SetHandler mod_python
PythonInterpreter main_interpreter
PythonHandler trac.web.modpython_frontend
PythonOption TracEnv d:/trac0.12/projects
PythonOption TracUriRoot /trac0.12/projects
</location>

配置用户身份的验证Trac可以使用Apache的身份验证。

创建密码文件,如为outpop创建密码文件，outpop为用户名：
htpasswd -c d:/trac0.12/projects/conf/trac.passwd outpop
New password: ****
Re-type new password: ****
Adding password for user outpop

若对密码不想加密可使用-cp参数，win平台下默认是MD5加密。
配置身份验证 #设置outpop的Trac用户验证
<location /trac0.12/projects/login>
AuthType Basic
AuthName myjavatrac
AuthUserFile d:/trac0.12/projects/conf/trac.passwd
Require valid-user
</location>

完成后重启Apache服务器，然后浏览http://localhost:8000/trac0.12/projects,点击Login，将看到如下效果图

Trac的授权设置
在Trac 0.11以前的版本需要安装WebAdmin插件才能以web的方式管理用户及授权，以后的版本就不在需要了，已经集成了。前面创建的Apache的身份验证，都不具有TRAC_ADMIN权限，下面我们新创建一个admin用户，然后授予TRAC_ADMIN权限：
#创建一个admin用户
命令行转到%Apache%/bin>htpasswd -c d:/trac0.12/projects/conf/trac.passwd admin
New password: *****
Re-type new password: *****
Adding password for user admin
#为admin用户授权TRAC_ADMIN
trac-admin D:/trac0.12/projects permission add admin TRAC_ADMIN
完成后再以admin帐号Login，在search的后面就会看到Admin，点击进入可以看到如下效果图：

在管理中，0.12版比以前多了个了版本控制。因为从0.12版本后trac支持多个svn库的管理。

另外，导航栏中的源码浏览只有在添加了一个版本库，并同步Trac和版本库。才会出现。