搭建svn+apache+trac平台(一)-安装

我们的团队开始要进行前期的开发了，还有公司也有可能开始转到.NET平台，最近也可以说是软件的农闲时期，呵呵，刚好可以实现梦想好久的项目管理配置的实战了。
一路走来，现在基本已经可以搭建一个比较实用和稳定的项目管理平台了
使用的基本上是svn+apache+trac的组合(其间也使用过svn+apache+tomcat+sventon，也想过加上svnmanager+mantis来管理，但最终都选定了svn+apache+trac这个简单组合o(∩_∩)o)，中间也走过一些弯路，其中的艰辛对我这个技术菜鸟真是感受良多啊，趁现在有闲的时间赶紧记录下来^_^。

首先要感谢那些无私分享经验的大哥们的文章，如果没有他们，我想我走的弯路会更多更多

1.搭建SVN和APACHE
基本上我是参考Tsvn的文档和以下这两篇文章进行配置的
实战SVN For Apache2（一）  http://www.cnblogs.com/Xrinehart/archive/2005/10/27/262759.html
实战SVN For Apache2（二） http://www.cnblogs.com/Xrinehart/archive/2005/10/29/264659.html
相同的地方就不说了，大家自然可以参考文章中的详细说明，我想要说说的是自己菜出来的教训。
1）使用Apache的版本问题，我配置使用的是Apache2.0.59，因为现在的SVN都不支持2.2.x的版本的
2）每当改动过Apache的配置文件，不要偷懒使用restart，要用stop,再用start,不然就会出现莫名奇妙的问题。还有Apache的Bin目录最好也加到系统的Path中，因为命令都几常用，配置起来会省点心。
3）如果不装Apache，直接装SVN的话，其实也存在SVN自身带的服务器svnserve,可使用svn://<IP地址>/<配置好的项目名称> 来访问，但它老是拼命地提示“不能做任何链接，因为目标机器积极地拒绝它”这句极为搞笑的错误（后来知道其实svnserve还是要配置一下才能用的，TSVN的文档说了好清楚的啦，没有认真看，真抵死！）
4）由于Apache里面没有自带SSL（原因是美国的出口限制，他奶奶的，为什么不限制一下MS呢），所以要用他的话，还要另外装个模块，例如OPENSSL等，听文档点呢，就话有配置好的Apache，到时下载那些第三方的Apache的就可以了（例如 http://hunter.camphus.com）
【注】这个后来实验了，APACHE状态都显示是集成的ssl,设置都给文档对了又对，但就是没有办法用ssl进行访问，又不知道那里错了，真是一大遗憾啊:（
5)SVN提供两中存放文件的方式，一种是新些少的类文件方式，一种是用巴克利数据库，前者听说性能要好点，后者就稳定点，我觉得稳定重要D，大家话呢？[不过在公司上马的时候我最后还是选了文件的方式，毕竟是1.2后默认方式，至于稳定与否，拭目以待了！（千万不要出乱子，不然老大可饶不了我啊，阿门）] 
6）在Apache配置服务器的时候，发现一个小问题（可能大家已经知道^_^），就是路径还是尽量用英文的好，而且在配置文件中标签Location中的路径是严格区分大小写的。
 例如设置的时候定义如下：
 <Location /svn/Tif>
 #
 #配置信息，省略
 #
 </Location>
 那么访问的时候使用地址为http://<Ip:端口>/svn/Tif
 如果是使用http://<Ip:端口>/svn/tif就是不行的，呵呵，这样我想也许也可以当作一个安全特性来使用，试想下，一个大小写十分奇怪的组合路径，例如http://<Ip:端口>/svn/PbAssIsTAnt，这样外人是很难知道的（当然了，真正的安全配置还是要实实在在做的，毕竟还有很多路径嗅探的方法也十分容易，(*^__^*) ）

2.使用TSVN
TSVN的官方网站上的中文文档已经够详细了，我只想谈谈遇到过的问题
1）虽然TSVN有简体中文的语言包，不过在某些功能上好像对中文的支持好像还不是很好，例如在回溯的时候，对于一些源代码中的注释，要是中文的就可能在他那个回溯工具TortoiseBlam的界面中还是显示乱码,是有点瑕疵。（不过后来在不用的系统中这个现象好像也不出现，真不知道是为什么）
2）SVN的模型是“拷贝-修改-合并”，这样就可以并行开发了，而在合并中的冲突就靠开发人员的“交流”解决，敏捷开发味道十足，果然是开源项目，思想真好，比VSS爽多了！不过在使用一些本身就没有开源精神的开发工具进行开发的话，也就是说代码文件是那些不是代码级数的文件（说起来真拗口啊^_^），例如非常恶心的PB（他的pbl就足够另你恶心的了）的话，设置锁这种方法是少不了的。而最好的方式还要加上一个need-locks的属性，那样就更方便了，出错的机会就更少了，建议使用。还有，如果连古旧的配置文件也要版本控制的话，最好还是要锁，毕竟改来改去都是那几行，用合并的方式划不来的，冲突的机会太大了。

3.TSVN + SVN + APACHE都使用良好的话，如果想加个简单的webclient的话，使用tomcat+sventon是个不错的选择，而sventon的配置也简单到极点了，只使用一个war包就可以直接运行界面进行配置版本库了。
关于Sventon的中文问题，只要在服务器配置文件的server.xml中的Connector字段添加URIEncoding="UTF-8"即可:)。
还有以后想添加新的版本库，可以参照着sventon.properties文件照样画葫芦（该配置文件放在Tomcat的temp/sventon目录下）
至于用他来访问版本库的权限控制，我就不知道怎么做了，因为在他的配置页面就要填上用户名和密码，这个问题我到后来都没解决，只好使用Tomcat来做身份认证，这个比较笨的方法具体是：
1）修改在Sventon目录下（webapps\svn\WEB-INF）的web.xml文件
在在<web-app>和</web-app>之间加入
  <security-constraint>
    <web-resource-collection>
      <web-resource-name>SVN</web-resource-name>
      <url-pattern>/*</url-pattern>
    </web-resource-collection>
    <auth-constraint>
       <!-- NOTE:  这个角色是在user文件中使用的角色 -->
       <role-name>user</role-name>
    </auth-constraint>
  </security-constraint>

  <!-- Define the Login Configuration for this Application -->
  <login-config>
    <auth-method>BASIC</auth-method>
    <realm-name>Access</realm-name>
  </login-config>
2）然后在$TOMCAT_HOME/conf/tomcat-users.xml中加入，例如
   <user name="linqingfeng" password="123456" roles="user"/>
   roles的名字和web.xml中的相对应即可

经过这样的配置应该可以使用sventon了，不过在有TSVN的前提下，他的用处并不大，还好这样就可以搭建出一个RSS服务器了，同事间的修改记录也可以及时看到，省了一点心。不过平心而论，使用spring+struck开发的sventon运行起来的速度真有点不敢恭维，只能说凑合着用了，而且也只能说是一个纯WEBClient，没有配置管理的模块（这也是为什么我那时萌生要想再加一个mantis的原因，但最后我还是选择了可爱的trac，连sventon也不需要了，呵呵）

4.配置Trac
我配置Trac基本都是参照下面两篇文章进行搭建（再次感谢作者的辛勤劳动^_^）
SVN+Trac安装笔记
http://blog.nowans.com/content/log.2007.1.23.190.html
SVN+Trac的配置笔记
http://blog.nowans.com/content/log.2007.1.25.191.html
后来的设置基本看他自带的文档应该就没有什么问题了，现在说说配置经历过的教训了。
1）为了安装Trac，而下载的组件好像很多很烦人，不过一旦下完那些零碎的组件，安装起来就像风一下，很快很便捷的（印象中唯一卡过我这个菜鸟的就是找svn-python-1.4.2.win32-py2.4.exe这个组件，其实在SVN的官方主页的files/documents/中就有了，http://subversion.tigris.org/files/documents/）。
2）上面文章中用到的方法是直接使用tracd的方法直接运行服务器的，但那样要一直打开一个比较丑陋的DOS窗口呆在服务器上，很多人应该都不能接受（我想我们老大如果知道也不会接受的），查了查他的文档，其实他还可以完美的和apache进行结合的，使用的方法有很多，例如CGI,FCGI或者加上一个mod_python的APACHE模块
3）刚开始我图方便，就直接使用了CGI,不过性能正如文档中说的那样，慢得想蜗牛。我想我当时如果能上网加载其他组件的话，绝对不会用他的，不过公司不能上网，没有办法了。
不得不插一句，现在的网络就是程序员的眼睛，为了代码安全等理由来断网，效率从何谈起，真是得不尝失啊。
配置CGI的步骤如下（这个方法的性能这的差的没的说，我只是记录一下，建议直接看使用mod_python配置的方法，那个实际多了）:
①记得修改CGI里面的python的路径，就是trac.cgi的第一行，例如“#!C:\ProgramFiles\Python235\python.exe”要修改成python.exe所在的真正地址（刚开我是老是访问不了，就是这个原因，没有办法了，鬼叫我不会CGI嘛，而且EmEditor的语法高亮也害我不少，老让我以为那是一行注释，幸好后来在查看APACHE的日志文件的出错信息来了灵感，不然真不知道何年才知道错误再那里咯）
②配置文件和以前配置svn和apache时大同小异了，配置文件中加上
#注意这个是多版本库的配置方法，在TRAC的说明文档中也有单个项目的配置方法
#当然了，现在直接就使用多版本库的配置就可以了，毕竟以后还要增加的嘛，哈哈

#创建一个路径别名
ScriptAlias /trac C:/Python24/share/trac/cgi-bin/trac.cgi

<Location "/trac">
  #这个是设置那个放TRAC库父目录
  SetEnv TRAC_ENV_PARENT_DIR "D:/SubversionFiles/Trac"
</Location>

#认证模块
<LocationMatch "/trac/[^/]+/login">
Require valid-user
AuthType Basic
AuthName "Trac"
#这里使用的用户密码文件和APACHE一样了
AuthUserFile  D:\SubversionFiles\conf\user
</LocationMatch>

4）使用mod_python模块进行访问
使用CGI，性能差的无法忍受，如果测试时试用过tracd的方法的话，用的时候真有点想跳楼的感觉:(
这些TRAC开发者的文档也早就警告过用户了，他们都建议使用另外的方法，就是使用FCGI或者mod_python，毕竟我不懂CGI，配置FCGI时蒙头蒙脑，最后都是搞不定（菜就一个字，哈哈），只有直奔mod_python中去了，毕竟他的文档齐全，还简单（一位大哥说的好，不能有站在这山看那山高的心理啊！）
①下载mod_python-3.3.1.win32-py2.4-Apache2.0.exe，点击安装（废话）
②apache配置文件加上mod_python模块
LoadModule python_module modules/mod_python.so
③地位版本库的配置就相对改变成
<Location /trac>
  SetHandler mod_python
  PythonHandler trac.web.modpython_frontend
  PythonOption TracEnvParentDir "D:/SubversionFiles/Trac"
  #TracUriRoot这个设置是可有可无，好像是说不能访问的时候才用
  PythonOption TracUriRoot /trac
</Location>

配置完别急着打开浏览器看结果，记得把APACHE停止再启动一次（不是restart哦，原因应经说过了）。至于TRAC的配置和插件安装，下一篇再说了^_^。