WM-130-006-A-0_SVN服务端配置管理使用指导

1、wm-130-006-a-0_svn服务端配置管理使用指导svn服务端配置管理使用指导标准编号： wm-130-006-a-0svn 服务端配置管理使用指导作者确认批准姓潘涛许娟萍林澜名日 2007-12- 2007-12- 2007-12-期2425272svn服务端配置管理使用指导标准编号： wm-130-006-a-0版权所有， ? 北京福富软件技术股份有限公司福州分公司电信信息化部修订历史记录版改日期作者修订要点号号a 0 2007- 潘涛 新做成12-243svn服务端配置管理使用指导标准编号： wm-130-006-a-0目录1概述.62svn 简介 .63svn 安装指南 .73

2、.1相关软件 .73.2软件安装配置 .83.2.1安装配置 svn 服务器 .83.2.2安装配置 apache 服务器 .93.2.3安装配置修改密码的 cgi 程序 .124svn 库目录结构 .154.1部门 svn 工作目录 .154.2部门 svn 备份目录 .185创建配置 svn 工作库 .195.1使用 tortoise svn 建 svn 空库 .195.2在 a pache 中配置 svn 工作库 .196创建配置 svn 备份库 .216.1使用 tortoise svn 建 svn 空库 .216.2在 a pache 中配置 svn 备份库 .217svn 用户管理

3、 .234svn服务端配置管理使用指导标准编号： wm-130-006-a-08svn 库权限配置255svn服务端配置管理使用指导标准编号： wm-130-006-a-01 概述软件配置管理是项目运作的一个支撑平台，它将项目所有成员的工作协同起来，实现高效的团队沟通，使工作成果及时共享。为进一步规范配置管理，提高软件协同开发的工作效率，电信信息化部引入开源软件 subversion（以下简称 svn）作为统一的版本管理工具，本文主要对 svn服务端配置管理进行指导性说明。本指导书适用于电信信息化部的各产品部及南京分公司。2 svn简介svn全名 subversion ，是一种开放源码的全新版

4、本控制系统。svn支持客户端通过 http ，https ，专用的 svn协议，以及 svn+ssh来访问，库目录可以不用以目录写共享的方式让客户端直接访问。可以有效的进行权限控制，支持客户端设置代理，能有效保证数据源安全性以及数据传输安全性。6svn服务端配置管理使用指导标准编号： wm-130-006-a-0对于我们的应用，将采用 https 的方法访问 svn 库，使用的 web服务器需要是 apache。3 svn安装指南3.1 相关软件? svn server ：svn1.4.5 ，for windows ，是目前最新版本file ：svn-win32-1.4.5.zip下载地址：h

5、ttp://project_pa ckages.html? svn client：tortoisesvn 1.4.5，是目前最新版本下载地址：/? apache server ：apache2.2.4 加 ssl支持，for windowsfile ： httpd-2.2.4-win32-x86-ssl.zip下载地址：/download/bi7svn服务端配置管理使用指导标准编号： wm-130-006-a-0naries/httpd-2.2.

6、4-win32-x86-ssl.zip用户通过网页修改密码的cgi 程序： passwd.cgi3.2 软件安装配置以下以软件安装在 d:svn 目录为例， svn server 安装目录为 d:svnsvn-win32-1.4. , apache 的 安 装 目 录 为 d:svnapache2 。 tortoisesvn 安装路径可以任意指定。3.2.1安装配置 svn 服务器将 svn1.4.5 解压在 d:svnsvn-win32-1.4.5下，安装 tortoisesvn 。因为采用 apache 来访问svn库，因此 svn服务器的主要作用仅为 apache提供必要的动态库。服务端

7、上对 svn库的直接操作则通过 tortoisesvn 来进行。设置相关的环境变量：1）增加 svn 的 bin 目录到 path 环境变量中setpath=d:svnsvn-win32-1.4.5bin;%path%2）设置 apr_iconv_path8svn服务端配置管理使用指导标准编号： wm-130-006-a-0setapr_iconv_path=d:svnsvn-win32-1.4.5iconv3.2.2安装配置 apache 服务器将 apache 服务器安装在 d:svnapache2 目录下。然后进行配置。1） 将 svn 服务器 bin 目录下的mod_dav_svn.s

8、o、mod_authz_svn.so 录复制到 apache 的 modules 目录下。2） 修改 d:svnapache2confhttp.conf? 修改 apache 的安装目录将原先配置文件里头 apache 的目录替换为本次的 apache 的安装目录。配置文件里头缺省是 c:apache2 ，我们此次安装目录是 d:svnapache2 ，将 c:apache2 全部替换为 d:svnapache2 。? 修改 apache 导入的模块，导入 dav，svn相关模块去除下面两行行头的注释号 #，使 apache 导入这两个模块：#loadmodule dav_fs_module9

9、svn服务端配置管理使用指导标准编号： wm-130-006-a-0modules/mod_dav_fs.so#loadmodule dav_modulemodules/mod_dav.so在 load 模 最后增加如下两行：loadmodule dav_svn_module modules/mod_dav_svn.so loadmodule authz_svn_module modules/mod_authz_svn.so? 修改 confhttpd.conf配置文件，使其包含 ssl 配置文件 httpd-ssl.conf 。在 httpd.conf 里 ，有如下配置# secure (s

10、sl/tls) connections #includeconf/extra/httpd-ssl.conf .去除 #includeconf/extra/httpd-ssl.conf前的注 号，将其改 10svn服务端配置管理使用指导标准编号： wm-130-006-a-0include conf/extra/httpd-ssl.conf3） 修改 confextra httpd-ssl.conf文件? https 缺省监听端口是 443，调整为 4443，相关内容如下：listen 4443? 修改 apache 的相关目录，将其替换为 apache 的安装目录documentroot d:

11、/svn/apache2 /htdocserrorlogd:/svn/apache2/logs/error_logtransferlogd:/svn/apache2/logs/access_log? 修改 ssl相关证书密钥文件路径# server certificate: sslcertificatefile d:/svn/apache2 /conf/server.crt11svn服务端配置管理使用指导标准编号： wm-130-006-a-0#server private key:sslcertificatekeyfile d:/svn/apache2/ conf/server.keyssl

12、要求有 server certificate和server private key。需要在相应目录下生成需要的认证和 key 文件。4） 将 apache 的 bin 目录添加到系统的 path变量中5） 创建名为“ svn-apache ”的 apache 服务敲入命令： httpd n svn-apache k install ，即创建了名为“ svn-apache ”的 apache 服务。然后可以通过 windows 服务管理程序来起停该服务。连接到:4443/检查缺省网页是否能够正常显示。3.2.3安装配置修改密码的cgi 程序passwd.cgi 需

13、要放在 apache 的 cgi-bin 目录下，可以根据需要更改名字，其对应的配置文件12svn服务端配置管理使用指导标准编号： wm-130-006-a-0是其名字加上 .ini 后缀。一个 cgi 及其配置为一组合，可以修改一个密码文件。多个部门，需要有多套的 cgi 及对应的 ini 文件。该文件同时需要旧版 （2.0 版）的 apache 的动态链接库 libapr.dll、libapriconv.dll、libaprutil.dll。这三个文件需要也放在cgi-bin目录下。ini文件格式样例如下：pathauthuserfile=f:/svn_data/ddrv/ddrv_pas

14、swdlogfile=osspass.logsetuppassminlen=6htmltitle= 修改开发推进部用户 subversion 密码 description= 修改开发推进部用户subversion 密码yourname = 用户名oldpasswd =旧密码13svn服务端配置管理使用指导标准编号： wm-130-006-a-0newpasswd1 = 新密码newpasswd2 = 验证新密码btn_change =修 改btn_reset =重 置changepassok=成功修改密码 changepassfailed= 修改密码失败oldpasserror= 旧密码错误

15、servererror= 服务器错误 passmustgreater= 密码位数必须大于 twopassnotmatched= 两密码不一致entername=请输入用户名back=返回通常需要修改的是上面的蓝色字体部分。 authuserfile 是需要修改的密码文件的路径 logfile 是 log 记录。 passminlen 规定密码的最短长度。title、description是页面上看到的窗口标题以及页面标题。14svn服务端配置管理使用指导标准编号： wm-130-006-a-04 svn库目录结构4.1 部门 svn 工作目录以下以电信产品三部为例，目录结构如下：oss 为电信

16、三部门用户目录，其下有 repos 、 manage password 、oss_share 三个目录，以及 oss_passwd 文件，具体说明如下：repos （目录）repos 目录下面存放 svn库，一个 svn库对应repos 下的一个目录。部门用户目录下面可以有多个 svn库目录，可以根据项目的需要来建 svn 库。一般一个库包含一个项目或者多个相关项目。电信产品三部目录repos 结构样例如下：15svn服务端配置管理使用指导标准编号： wm-130-006-a-0部门名 _passwd（文件）部门用户密码文件，直接在部门目录下，上图没有列出。一个部门仅有一个 passwd 文件

17、。该部门所有的 svn库共享使用该文件。对应于 oss 部门其文件为 oss/oss_passwd 。manage passwd（目录）管理用户密码的管理工具目录，其下有简化的脚本命令，用来维护部门用户密码文件，可以增加删除用户，以及修改密码。部门名 _share( 目录 )该目录通过网络共享，部门维护人员可以通过网络共享可以直接访问。其下有两个目录，svnaccess 、backup。a)svnaccess （目录）项目的权限配置文件。每个项目在 svnaccess 目录下对应一个权限配置文件， 文件名称为 项目名 _access 。电信产品三部样例如下：16svn服务端配置管理使用指导标准

18、编号： wm-130-006-a-0b)backup （目录）存放备份脚本以及备份日志。备份脚本： svn_部门名 _backup.bat ，一个备份脚本同步该部门所有的 svn库。备份日志： backup.log电信产品三部样例如下：目录用户权限 :用户权限部门用户完全权限开发推进部用只读户system完全权限17svn服务端配置管理使用指导标准编号： wm-130-006-a-04.2 部门 svn 备份目录备份目录的一个部门用户目录下，就一个repos 目录，以及一个部门用户密码文件。repos目录下面放备份的svn库，和工作用的svn库一一对应。密码文件里仅需要两个帐号： syncus

19、er 、 reader 。同步的时候使用 syncuser 帐号进行同步， reader 帐号用于用户读取备份库。目录用户权限 :用户权限部门用户完全权限开发推进部用户只读system完全权限18svn服务端配置管理使用指导标准编号： wm-130-006-a-05 创建配置 svn工作库5.1 使用 tortoisesvn建 svn 空库在部门用户的 repos 目录下，建立新的 svn库目录。点中新建的目录，点击右键菜单，选择tortoisesvn-create repository here，然后弹出一个对话框，指定 svn存储格式，保持缺省的 fsfs类型，即创建完成。如下图：5.2

20、在 apache 中配置 svn 工作库对于工作库，每个 svn库需要在 apache 的 conf 中增加一个配置段。添加在 conf 文件的最后：dav svnsvnpath f:/svn_data/oss/repos/xnglxt19svn服务端配置管理使用指导标准编号： wm-130-006-a-0authtype basicauthname oss fj_jzgj repositories authuserfile f:/svn_data/oss/oss_passwd authzsvnaccessfilef:/svn_data/oss/svnaccess/xnglxt_access

21、require valid-user? location /oss/xnglxt表示相对的url路 径 是 /svn， 也 就 是 客 户 端 用http(s):/ip:4443/oss/xnglxt/来 访问。? svnpath 是指 svn库的目录，本例中svn目录为 f:/svn_data/oss/repos/xnglxt，? authuserfile passwd是该库使用的用户密码文件，一个部门只需要一个用户密码文件。用户密码管理详见? authzsvnaccessfile是该 库的目录权限控制文件，一个工作库需要配置一个权限文件。20svn服务端配置管理使用指导标准编号： wm-1

22、30-006-a-0修改 apache 的 conf 文件，需要重启 svn-apache 服务才能生效。6 创建配置 svn备份库6.1 使用 tortoisesvn建 svn 空库建库方法同 svn工作库。还需要在库的 hook 目录下增加两个脚本文件，pre-revprop-change.bat和 start-commit.bat。这两个脚本文件限制只有 syncuser 这个用户才可以向备份库提交数据。这两个文件内容不需要修改，直接复制到相应库的 hook 目录下即可。6.2在 apache 中配置 svn 备份库svn备份库在配置文件里头只需要为一个部门配置一个配置段。不需要为每个备

23、份库单独配置。dav svnsvnlistparentpath on21svn服务端配置管理使用指导标准编号： wm-130-006-a-0svnparentpathh:/svn_backup_data/mss/reposauthtype basicauthname mss backup repositoriesauthuserfileh:/svn_backup_data/mss/mss_passwdrequire valid-user对于备份库，用户文件可以仅有两个用户，一个 syncuser ，用于同步写库。一个reader ，用于读库。不需要权限配置文件。svnparentpath 是指

24、定备份库总的目录。该目录下的目录对应每一个实际的备份库。只要在库总的目录下建好备份库，该库即可使用。svnlistparentpath on 允许浏览备份库总的目录，从而可以看到每个部门当前的备份库情况。因此，在初次配置好 conf 文件后，此后再增加一个部门的备份库，不需要调整 conf 文22svn服务端配置管理使用指导标准编号： wm-130-006-a-0件的内容，也不需要重启apache 服务。7 svn用户管理用户管理实际上是管理svn conf中指定的authuserfilepasswd 文件，修改该文件内容不需要重启 apache 服务。1）使用 manage password

25、 目录下的简化脚本manage password 目录下面存放管理用户密码文件的简化命令，其实是对 apache 的 htpasswd 的封装，指定了密码文件以及参数选项。c.bat ：初始化运行环境，进行命令行状态，设置工作目录。如果运行 manage password 下面的脚本来管理用户，则需要首先执行 c.bat 脚本，并此后在这个命令行窗口中进行后继操作。addu.bat增加用户，不在命令行指定密码，由后继提示输入。用法： addu 用户名addd.bat23svn服务端配置管理使用指导标准编号： wm-130-006-a-0增加用户，在命令行直接指定密码。用法： addd 用户名 密码updateu.bat修改用户密码，不在命令行指定密码，由后继提示输入。用法： updateu 用户名resetu:修改用户密码，在命