在 Linux/Apache 2.2 上配置SVN服务器


  • 准备,下载所需要文件.

  • 检查已安装的 Apache2 是否已经安装了 mod_dav .

  • 编译SVN,遇到的问题和解决方法



    • 使用 默认文件系统(fsfs) 保存数据

    • 使用 Berkeley DB 保存数据


  • 配置Apache和SVN,测试.

  • 其它小结


    • 从Windows平台上数据转移

    • 配置文件,使用其支持对文件中的 $Id$ 标签每次提交的时候自动更新版本信息.

    • 基于路径的权限控制




    • 常用SVN命令


  • 相关资源



* 准备,下载所需要文件.


本文测试环境:




  • ubuntu 6.06 LTS (kernel 2.6.15-25-k7,gcc-4.0.3) /ubuntu server (2.6.15-26-server,gcc-4.0.4)
    Subversion 1.3.2/1.4.2
    Apache 2.2.2/2.2.3
    GCC 4.1.2

    最新的版本 Subversion 可以在这里找到 :http://subversion.tigris.org/project_packages.html



    * 下载neon库,使svn支持webdav,https加密的链接.(下载并重命名即可,subversion会自动监测并配置),目前只支持 0.25.5.




    cd subversion-SVN-LAST-VERSION-DIR
    wget http://www.webdav.org/neon/neon-0.25.5.tar.gz
    tar xzf neon-0.25.5.tar.gz
    mv neon-0.25.5 neon


    * 检查已安装的 Apache2 是否已经安装了 mod_dav .


    如果已经成功安装了Apache,使用 httpd -M 来查看有没有安装 dav_module,如果没有的话 必须附加 ‘–enable-dav’ ‘–enable-dav-fs’ 两个参数重新编译 Apache,否则即使编译通过了svn,apache也会启动不起来.



    如何编译 Apache 请参考我另外一篇文章.


    * 编译SVN,遇到的问题和解决方法.


    使用默认的文件系统保存数据.


    最终完整通过安装和测试的编译参数为:



    ./configure --with-apxs=/usr/local/apache2/bin/apxs \
    --with-apr=/home/src/server/httpd-2.2.2/srclib/apr \
    --with-apr-util=/home/src/server/httpd-2.2.2/srclib/apr-util
    ----with-ssl
    make
    make install

    其中 /home/src/server/ 为 httpd-2.2.2 源代码所在文件夹,根据实际情况调整一下.


    ◆ 遇到问题:


    1) --with-apr 和 --with-apr-util 如果没有加上的话,即使编译成功了也会出现


    Can’t set position pointer in file ‘/home/svn/repos/db/revs/0′: Invalid argument


    这样的错误提示.


    2) 暂时不能使用 Berkeley DB [* 已解决]


    svn保存文件更新数据库的方法有两个,一种是直接使用 fs (filesystem)来保存,另一种是通过Oracle提供支持的开源数据库 Berkeley DB 进行保存。但是如果加上 –with-berkeley-db=/usr/local/BerkeleyDB.4.4 就会configure时就会报错.



    configure: error: APR-UTIL was installed independently, it won’t be
    possible to use the specified Berkeley DB: /usr/local/BerkeleyDB.4.4


    我想 apr-unit 暂时不支持吧,我们就用默认的fs好了.


    3) 在make 的时候可能会遇到缺少 srclib/apr/libapr-1.la,srclib/apr-util/libaprutil-1.la 两个文件,找不到而make error.


    解决办法:/usr/local/apache2/lib/ 中找到,将其复制到源代码文件夹相应的位置中.


    Update!!

    使用 BerkeleyDB 保存数据.


    1) 安装 BerkeleyDB



    cd /usr/local/src
    wget http://downloads.sleepycat.com/db-4.3.29.tar.gz

    tar xzvf db-4.3.29.tar.gz
    cd /usr/local/src/db-4.3.29/build_unix
    ../dist/configure --enable-compat185
    make
    make install

    2) 更新apr和apr-util源代码



    # 清理编译后的.la文件
    cd /usr/local/src/httpd-2.2.3

    make clean


    cd /usr/local/src/subversion-1.3.2
    rm -rf apr
    rm -rf apr-util
    cp -rf /usr/local/src/httpd-2.2.3/srclib/apr ./
    cp -rf /usr/local/src/httpd-2.2.3/srclib/apr-util/ ./


    3) 编译安装



    ./configure --with-apxs=/usr/local/apache2/bin/apxs \
    --with-berkeley-db=/usr/local/BerkeleyDB.4.3 \
    --with-ssl
    make
    make install

    ◆ 遇到问题:
    1) BerkeleyDB 版本不能大于 4.3.否则同样会出现以下错误.



    configure: error: APR-UTIL was installed independently, it won’t be
    possible to use the specified Berkeley DB: /usr/local/BerkeleyDB.4.4


    主要是apr-util 暂时不支持4.4的版本.


    2) 必须更新apr,apr-util 源代码.
    subversion-1.3.2 自带的 apr-util 的版本是0.9.6的,必须升级为 1.2.7 虽然能编译过去。但在 svn checkout 的时候会提示



    svn: REPORT request failed on ‘/!svn/vcc/default’
    svn: REPORT of ‘/!svn/vcc/default’: Could not read status line: connection was closed by server.

    这个问题困扰了我很长时间,Google和官方论坛都无结果。后来昨天竟然自己无意中解决了,感动的得哭了:)


    * 配置Apache和SVN,测试



    成功编译svn后会在 httpd.conf 中自动加上



    LoadModule dav_svn_module modules/mod_dav_svn.so
    LoadModule authz_svn_module modules/mod_authz_svn.so

    两个模块,没有的话,自行加上或检测是否真的编译成功.


    假设我们现在要将一个名为 Lair 的项目导入到 SVN中


    1). Apache的配置


    在 conf/httpd.conf 或 conf/extra/httpd-vhosts.conf 中加入



    <Location /svn/Lair>

    DAV svn
    SVNPath /home/svn/Lair
    </Location>

    可以参考以下apache的配置,实现数据加密传输,用户身份验证.



    Listen 443


    AddType application/x-x509-ca-cert .crt
    AddType application/x-pkcs7-crl .crl.

    SSLPassPhraseDialog exec:/etc/sendsslpwd
    SSLSessionCache shmcb:/usr/local/apache2/logs/ssl_scache(512000)
    SSLSessionCacheTimeout 300
    SSLMutex file:/usr/local/apache2/logs/ssl_mutex


    <VirtualHost _default_:443>
    DocumentRoot /var/SVNRoot
    ServerName svn.yousite.com:443
    ServerAdmin webmaster@yousite.com
    <Location />

    DAV svn
    SVNPath /var/SVNRoot
    AuthzSVNAccessFile /etc/svnserve.conf
    Satisfy Any
    AuthType Basic
    AuthName “yousite SVN Repository”
    AuthUserFile /etc/httpd-passwords.txt
    Require valid-user

    </Location>
    SSLEngine on
    SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:+eNULL
    SSLCertificateFile /etc/ssl/server.crt
    SSLCertificateKeyFile /etc/ssl/server.key


    </VirtualHost>


    更详细的配置说明文档 http://svnbook.red-bean.com/nightly/en/svn.ref.mod_dav_svn.conf.html


    2). 配置,并且测试SVN,



    创建一个新用户,用了保存仓库.


    useradd -m svn

    创建一个新模块



    su daemon (apache是以daemon用户运行的,所以要切换身份,否则可能会报目录访问权限错误)
    svnadmin create --fs-type fsfs /home/svn/Lair

    导入原来的项目



    svn import /var/www/Lair http://localhost/svn/Lair -m ‘Initial import’


    重新建立工作目录



    rm -rf /var/www/Lair (注意备份!!)
    svn checkout http://localhost/svn/Lair

    测试打开 http://localhost/svn/Lair
    1152448175.png
    如能看到一个你项目录列表,说明您成功了。


    * 其它小结


    ■ 数据转移:

    从 Windows 平台 SVN 服务器转移
    如果windows svn储存的格式也是dbd的话,直接将SVN的文件夹copy过来即可.然后
    执行 svnadmin recover /var/SVNRoot 检查一下数据库是否损坏.


    最后注意权限,确保 db 目录下的所有文件能被apache读写(留意httpd.conf中的 User 和 Group)。



    chmod 755 db
    chmod 666 db/*

    否则checkout时出现以下错误,多数是因为 文件或者目录权限问题 引起的,可以尝试用 chown 或者 chmod 命令修改一下权限



    <m:human-readable errcode=”160029″>

    Could not open the requested SVN filesystem
    </m:human-readable>


    <m:human-readable errcode=”13″>
    Could not open the requested SVN filesystem
    </m:human-readable>

    Can't open activity db: APR does not understand this error code


    另外一种方法没有测试过,原理大致和mysqldump一样,将svn导出为文本文件,然后重新导入,好处是可以避免因为存储格式不同而导致的数据转移困难。



    # dump data to file (assuming a repo @ c:\repo):

    svnadmin dump c:\repo > c:\repo.txt
    # Copy the file over to linux:
    mkdir /repo
    svnadmin create /repo
    svnadmin load /repo < /repo.txt

    ■ 设置访问控制

    当 httpd.conf 中 设置 AuthzSVNAccessFile 时,可以设置不同用户对不同目录的访问控制.以下是一个例子.



    [groups]
    root = admin.root
    web = user1,user2
    soft = user3,user4


    [/]
    @root = rw


    [/www]

    @web = rw


    [/soft]
    @soft = rw



    一个更复杂的权限控制例子:


    [groups]
    root = user1,user2
    web = user3,user4,user5,user6
    art = user7,user8,user9,user6
    blog = user10,user11

    # 所有的对 根路径 有读写权限而不是具体的某个库,例如 192.168.1.56/svn/ 下 有 trunk,tag,release 三个库,
    则组内成员都对于这三个库具有读写权限.
    [/]
    @root = rw
    @web = rw

    # 指定某个库(trunk)的访问权限
    [trunk:/lib/Lair]
    @blog = rw

    # user5 将对目录有任何权限,虽然他继承根路径
    [trunk:/apps/views/blog]
    @blog = rw
    user5 =

    [trunk:/apps/views/myblog]
    @blog = rw
    user5 =

    [trunk:/www]
    @art = rw
    @blog = rw

    [trunk:/apps/views]
    @art = rw


    详细的说明文档:http://svnbook.red-bean.com/nightly/en/svn.serverconfig.httpd.html


    ■ 配置文件,使用其支持对文件中的 $Id$ 标签每次提交的时候自动更新版本信息(自动属性).


    Windows : C:\Documents and Settings\%USERNAME%\Application Data\Subversion\config
    Linux : ~\.subversion\config



    [miscellany]

    enable-auto-props = yes
    [auto-props]
    *.php=svn:keywords=Id
    *.html=svn:keywords=Id

    >> 关于自动属性的更高级讨论


    ■ 几条常用svn 命令
    svn update
    svn add “filename”
    svn commit


    ———————–
    Change Log:



    • 2007-06-14 httpd-2.2.4,subversion-1.4.4,BDB-4.3,下通过.neno 还是不能使用0.2.6的,否则根据没有办法 checkout http 协议开头的URL.
    • 2007-01-03 修正关于neno库的安装说明,以上配置可以最新版本的 httpd-2.2.3,subversion-1.4.2,BDB-4.3下通过.
    • 2006-08-14 neon库subversion已经自带,不需要在单独安装,添加-with-ssl即可使用svn对ssl支持.

    • 2006-08-10 补充自动属性的说明.

    • 2006-08-08 加入关于目录访问验证的说明.

    • 2006-08-07 httpd,2.2.3测试依然有效,解决bdb数据库的支持问题,添加从Windows到Linux下的数据转移方案。

    • 2006-07-25 看到到.声仔对 Can’t set position pointer in file 另一种解决方案,我当时也测试了,好像没有成功。不想用apache源代码编译的朋友可以也测试一下


    • 2006-07-09 初稿.


    ———————–
    参考:


  • 评论

    1. 先将所有目录和和文件置为 777 看看,因为读 svn repos 是以 httpd 的身份去读的.


      cd YOUR-REPOS
      find . -exec chmod {} \;


      稳定性没有问题的,我们天天在用.

      回复删除
    2. 想請問你後來是怎麼解決這個問題的呢?
      svn: REPORT request failed on ‘/!svn/vcc/default’
      svn: REPORT of ‘/!svn/vcc/default’: Could not read status line: connection was closed by server.

      回复删除

    发表评论

    此博客中的热门博文

    在PEA上海做演讲