2007年9月9日星期日

Trac0.9b1简体中文版完全安装攻略,带所有配套软件!(Apache+SVN+Trac方式)

Trac0.9b1简体中文版完全安装攻略,带所有配套软件!(Apache+SVN+Trac方式)

由于工作需要,自己尝试安装TRAC系统,安装的过程实在是不敢恭维,太繁琐了,这里把我的安装过程记录下崽,希望对新来的人有所帮助。

辛苦劳动所得,欢迎转载,注明出处就可以了:http://blog.csdn.net/voyager512

完整命令都已经给出,可以直接拷贝到msdos运行

-----------安装Apache-------------
1 安装Apache 2.0.59

目前windows下的subversion只能跟Apache2.0.x配合,不能用于Apache2.2.x,除非你自己编译
安装Apache前,你要有一台运行Windows2000、Windows XP + sp1或Windows2003的电脑。

警告:请注意,没安装Service Pack 1的Windows XP将导致错误的网络数据从而破坏你的版本库!

http://httpd.apache.org/download.cgi 下载最新版本的Apache Web服务器。确保你下载的版本大于2.0.54。2.0.54版本的Apache将不能与Subversion 1.3.xx配合工作。而且,小于2.0.54的Apache也因为在windows上的编译存在一个bug而导致不能与subversion1.2配合 使用。

一旦你已经有了Apache2的安装程序,你可以双击它,它将引导你完成整个安装过程。请确保你输入正确的服务器URL(如果你的服 务器没有DNS名称,你可以直接输入IP地址)。我建议你将Apache安装成 for all Users,on Port 80,as a service。注意:如果你已经有一个IIS或者其它的程序使用80端口,安装可能会失败。如果是这样,你可以到程序目录下的Apache Group\Apache2\conf目录中找到文件httpd.conf,将其中的Listen 80改成一个不用的端口,比如Listen 8080。然后重新运行这个安装程序,这次应该不会再有问题了。

现在你可以在你的浏览器中键入 http://loccalhost/,如果呈现了一个已经配置好的网站,那么你的Apache就安装成功了。

警告:
如果你将Apache安装成一个服务,它将以本地system帐户来运行。为Apache创建一个单独的用户来运行它将会更安全一些。
请确保运行Apache的用户有版本库的完全访问权限(右键版本库目录->属性->安全)。要不然,用户将无法提交他们的更改。
就算Apache以本机system来运行,你也要设置它能完全读写版本库目录。
如果没有为Apache配置这个许可,用户将会得到"禁止访问"的错误信息,在Apache的错误日志中表现为错误500。

-----------安装SVN-------------
2. 安装Subversion
下载最新版本的svn-1.4.0-setup.exe
运行Subversion安装程序,
3 安装TortoiseSVN(如果喜欢svn命令方式可以跳过)
TortoiseSVN-1.4.0.7501-win32-svn-1.4.0.msi
LanguagePack-1.4.0.7501-win32-zh_CN.exe

-----------配置Apache-------------

4. 拷贝Subversion module文件到Apache目录
C:\> copy c:\Progra~1\Subver~1\bin\*.so c:\progra~1\apache~1\apache2\modules
C:\> copy c:\progra~1\subver~1\bin\*.dll c:\progra~1\apache~1\apache2\modules
5. 创建密码文件(w/user 'admin')
C:\> md c:\svn
C:\> c:\progra~1\apache~1\apache2\bin\htpasswd -cm c:\svn\.htaccess admin
题诗输入密码:比如admin888
6. 配置Apache (编辑 httpd.conf)

6.1. 添加Modules
6.1.1. 去掉以下行的注释(将开头的#删除):
LoadModule dav_module modules/mod_dav.so
LoadModule dav_fs_module modules/mod_dav_fs.so
6.1.2. 最后添加(默认系统已经有的话,可以不修改):
# Subversion
LoadModule dav_svn_module modules/mod_dav_svn.so
LoadModule authz_svn_module modules/mod_authz_svn.so
6.2. 添加Apache为服务运行(一般已经作为服务了,没有的话运行下面命令)
C:\Progra~1\Apache~1\Apache2\bin\Apache -k install -n "Apache2"
6.3. Add location root for multiple repositories
在配置文件的最后添加下面这些行:
# Subversion

DAV svn
# any /svn/foo URL will map to a repository C:/svn/foo
# I've only got it working using SVNPath!!
SVNParentPath C:/svn
AuthType Basic
AuthName "Subversion repository"
AuthUserFile c:/svn/.htaccess
#AuthzSVNAccessFile D:\svnaccessfile
Require valid-user

6.4. 添加cgi handler,去掉注释:
AddHandler cgi-script .cgi

-----------配置SVN-------------
7 创建Repository版本库
7.1 命令方式(file://):
C:\> svnadmin create c:\svn\repo1
在c:\temp\project创建目录结构
例如:
/project
/vendor
/tags
/trunk
files
/myproject
/branches
/tags
/trunk
files
建立版本库目录
C:\> svn import d:\temp\project file:///d:/svn/repo1 -m "Initial Load"

建立本地版本
C:\> svn checkout file:///d:/svn/repo1 d:\project

7.2 TortoiseSVN方式略过,比较简单

8. 测试安装的Subversion
重起Apache
http://localhost:80/svn/repo1
如果一切正常,你将被提示输入用户名密码,输入正确的用户名密码后你就可以看到版本库中的内容了。

-----------添加用户-------------
9. 通过以下方式往password文件中继续添加用户
C:\> c:\progra~1\apache~1\apache2\bin\htpasswd -m c:\svn\.htaccess user

-----------安装Trac必备软件-------------
注意软件版本
10. 安装Python
下载:python-2.4.3.msi,默认安装
Add C:\Python24 to the path

11. 安装Subversion Python Bindings
svn-python-1.4.0-py2.4.exe

12. 安装PySQLite
pysqlite-2.3.2.win32-py2.4.exe

13. 安装ClearSilver
clearsilver-0.9.14.win32-py2.4.exe
-----------安装Trac-------------
14. 安装Trac
trac-0.10.win32.exe
想安装中文版TRAC就下载0.91b版,
trac-0.9b1.win32.exe
0.91b版的中文包,共创软件联盟有人汉化,下面是地址,支持一下,不过里边的包有点小问题,siteconfig.py文件有问题,如果从网上下载的话,删除了这个文件再覆盖就没有问题了。
http://cosoft.org.cn/forum/forum.php?forum_id=8756

-----------配置CGI script-------------
15. 拷贝trac.cig文件

C:\> copy c:\python24\share\trac\cgi-bin\trac.cgi c:\progra~1\apache~1\apache2\cgi-bin
用ultraedit编辑trac.cgi,确保第一行包含python的正确路径
#!C:\Python24\python.exe

-----------配置Trac DB-------------
trac数据库可以命名成和他配合的版本库的名字,特别是有多个版本库的时候,更有利于区分,这个例子中"trac.db"可以被认为就是"repo1.db"

16. 运行trac-admin

C:\python24\Scripts> python trac-admin c:/svn/trac.db
如果提示‘python不是内部或外部命令‘,是因为没有设置环境路径,可以运行下面的命令

C:\python24> python scripts/trac-admin c:/svn/trac.db

17. 初始化DB

Trac [c:/svn/trac.db]> initenv
输入项目名称:My Project

Database connection string [sqlite:db/trac.db]>
接受默认就可以了

Enter path to repository
c:\svn\repo1(输入真实版本库地址)

Enter path to templates
c:\python24\share\trac\templates(一般是默认)

成功的话最后给出Congratulations!!

18. 继续添加管理权限(下面命令将所有权限付给'admin'用户)

Trac [c:/svn/trac.db]>permission add admin TRAC_ADMIN
Trac [c:/svn/trac.db]>quit

-----------将Trac添加到Apache-------------

19. 编辑httpd.conf:

19.1 第一种Apache访问trac方式(http://localhost/cgi-bin/trac.cgi)
文件最后添加以下代码
# TRAC
Alias /trac "C:/python24/share/trac/htdocs"


SetEnv TRAC_ENV "c:/svn/trac.db"
SetEnv PYTHONPATH "C:/Program Files/Subversion/bin"
# if you are running Apache as a user other than System, the TMP variable
# needs to be set to a place where that user can write scratch files. Make
# sure that this directory is created and writable by that user.
# SetEnv TMP "c:/svn/trac.db/tmp


AuthType Basic
AuthName "Project"
AuthUserFile C:/svn/.htaccess
Require valid-user


Options Indexes MultiViews
AllowOverride None
Order allow,deny
Allow from all

19.2第二中方是:URL友好模式,比如 http://hostname/trac,
用下面代码替换上面相关代码
注意:这个是用的C:/Python24/share/trac/cgi-bin/trac.cgi,确保里边第一行包含python24的正确位置

# TRAC

# Transfer serving up of static content to Apache
Alias /trac/chrome/common "C:/Python24/share/trac/htdocs"

# Alias for the friendly URL
ScriptAlias /trac "C:/Python24/share/trac/cgi-bin/trac.cgi"

SetEnv TRAC_ENV "d:/svn/trac.db"
SetEnv PYTHONPATH "C:/Program Files/Subversion/bin"
# if you are running Apache as a user other than System, the TMP variable
# needs to be set to a place where that user can write scratch files. Make
# sure that this directory is created and writable by that user.
SetEnv TMP "d:/svn/trac.db/tmp



AuthType Basic
AuthName "trac"
AuthUserFile C:/svn/.htaccess
Require valid-user

Note: if you get an error "Authentication information not available." after clicking "login", refer to #2258

19.3 集成域账号模式(略,参照官方文档)

20. 重起Apache.

------------摒住呼吸,测试TRAC------------
http://localhost:80/cgi-bin/trac.cgi
或者
http://localhost:80/trac
我一直是使用8080端口,也正常安装了

------------排错------------
如果出现错误,仔细看Apache的提示吧,会有所提示,我第一次也没有运行成功,提示找不到clearsilver,后来重新运行了一遍clearsilver,就好了
如果是ntfs文件系统的话,注意检查目录权限;
如果启用tmp,建立: D:\svn\trac.db\tmp目录,给权限;
确保trac.cgi第一行得python路径;
其他错误,自己检查C:\Program Files\Apache Group\Apache2\logs\error.log;

------------软件下载------------
打包软件下载地址(包含文中提到的软件):
http://www.bamtri.com/lq/trac/trac09b1allinonecn.rar


参考网站:
http://trac.edgewall.org/
http://www.iusesvn.com/bbs/index.php
http://cosoft.org.cn/projects/cntrac/
http://www.tigris.org/
等等
一并表示感谢!

没有评论: