SVN 的使用

1）首先安装服务器端软件“svn-1.4.2-setup.exe”（附件可以下载），这个安装就很简单，下一步，下一步就行了。

       我把这个安装在“C:\Program Files\Subversion”目录。

2）其次安装客户端软件“TortoiseSVN-1.4.1.7992-win32-svn-1.4.2.msi ”（太大传不上，网上自己找把，

   要的话也可以发邮件给我[e-mail]），

    这个安装也很简单，下一步，

     下一步就行了。

     客户端软件安装好以后，它会要求你重新启动电脑。重启一下。。。

3）因为这个软件开机就要用，所以对开发者来讲把它安装成一个服务是最好的（这样电脑一启动这个软件的服务器也载运行

     了，要不然你要到 命令行模式去手工启动服务）。下面就来讲述怎么样把它设置成一个服务。

    3.1）下载“SVNService.exe”（附件可以下载），把“SVNService.exe”拷贝到“C:\Program Files\Subversion\bin\”

    3.2）进入命令行模式：开始菜单－－运行－－进入“C:\Program Files\Subversion\bin\”这个目录。

            打入命令： svnservice -install -d -r  "e:\svn_service_root"。（这一步很重要很重要，以前我就是这一步误解走了很多

           弯路）。具体详细介绍见3.3。把它设为自动启动：开始菜单－－控制面板－－性能维护－－管理工具－－服务

          进去以后你会在服务列表中看到svnservice这个服务，右击－－把它设为自动启动（这样开机的时候这个服务也启动了）

    3.3）这里就是把“e:\svn_service_root” 这个目录指定为SVN版本控制的服务目录（网上很多帖子把上面这个命令称作建立

            仓库是不对的）其实这个目录应该称作仓库所在的目录，假如我有有三个仓库：repository_1,repository_2,repository_3

            他们的位置应该是：e:\svn_service_root\repository_1，

                                                e:\svn_service_root\repository_2，

                                                e:\svn_service_root\repository_3。

4）前面已经讲到仓库了，现在讲一下怎么样建立了一个仓库：有2中办法如下

     4.1）命令行模式进入”C:\Program Files\Subversion\bin\“

              再打入命令：svnadmin create e:\svn_service_root\repository_1，这样第一个仓库就建立好了。以后你的项目就可以

             导入到这个仓库中。（其他仓库的建立类似）此时进入目录：桌面－－我的电脑－－本地磁盘E:

             －－svn_service_root－－  repository_1 。你会看到文件夹 conf,dav,db 等等

         

    4.2）打开目录：我的电脑－－本地磁盘E:－－svn_service_root。在这个目录下新建文件夹，取名“repository_1”，右击

           新建的文件夹－－TortoiseSVN--Create Repository Here.效果同第一种方法一样。

5）进入“e:\svn_service_root\repository_1\conf”目录配置权限。






    配置conf 下的文件详细：


svnserve.conf
-------------

``arm\conf\svnserve.conf`` 文件，是 svnserve.exe 这个服务器进程的配置文件，我们逐行解释如下。

首先，我们告诉 svnserve.exe，用户名与密码放在 passwd.conf 文件下。当然，你可以改成任意的有效文件名，比如默认的就是 passwd::

    password-db = passwd.conf

接下来这两行的意思，是说只允许经过验证的用户，方可访问代码库。 那么哪些是“经过验证的”用户呢？噢，当然，就是前面说那些在 passwd.conf 文件里面持有用户名密码的家伙。这两行的等号后面，目前只允许 read write none 三种值，你如果想实现一些特殊的值，比如说“read-once”之类的，建议你自己动手改源代码，反正它也是自由软件::

    anon-access = none
    auth-access = write

接下来就是最关键的一句呢，它告诉 svnserve.exe，项目目录访问权限的相关配置是放在 authz.conf 文件里::

    authz-db = authz.conf

当然，svn 1.3.2 引入本功能的时候，系统默认使用 authz 而不是 authz.conf 作为配置文件。不过可能由于鄙人是处女座的，据说有着强烈的完美主义情结，看着 svnserve.conf 有后缀而 passwd 和 authz 没有就是不爽，硬是要改了。

上述的 passwd.conf 和 authz.conf 两个文件也可以作为多个代码库共享使用，我们只要将它们放在公共目录下，比如说放在 ``D:\svn`` 目录下，然后在每个代码库的 svnserve.conf 文件中，使用如下语句::

    password-db = ..\..\passwd.conf
    authz-db = ..\..\authz.conf

或者::

    password-db = ../../passwd.conf
    authz-db = ../../authz.conf
   
这样就可以让多个代码库共享同一个用户密码、目录控制配置文件，这在有些情况下是非常方便的。


authz.conf 之用户分组
---------------------

``arm\conf\authz.conf`` 文件的配置段，可以分为两类， ``[group]`` 是一类，里面放置着所有用户分组信息。其余以 ``[arm:/]`` 开头的是另外一类，每一段就是对应着项目的一个目录，其目录相关权限，就在此段内设置。

首先，我们将人员分组管理，以便以后由于人员变动而需要重新设置权限时候，尽量少改动东西。我们一共设置了5个用户分组，分组名称统一采用 ``g_`` 前缀，以方便识别。当然了，分组成员之间采用逗号隔开::

    [groups]
    # 任何想要查看所有文档的非本部门人士
    g_vip = morson

    # 经理
    g_manager = michael

    # 北京办人员
    g_beijing = scofield

    # 上海办人员
    g_shanghai = lincon

    # 总部一般员工
    g_headquarters = rory, linda

    # 小秘，撰写文档
    g_docs = linda

注意到没有， linda 这个帐号同时存在“总部”和“文档员”两个分组里面，这可不是我老眼昏花写错了，是因为 Subversion 允许我这样设置。它意味着，这个家伙所拥有的权限，将会比他的同事 rory 要多一些，这样的确很方便。具体多了哪些呢？请往下看！


authz.conf 之项目根目录
-----------------------

接着，我们对项目根目录做了限制，该目录只允许arm事业部的经理才能修改，其他人都只能眼巴巴的看着::

    [arm:/]
    @g_manager = rw
    * = r

- ``[arm:/]`` 表示这个目录结构的相对根节点，或者说是 arm 项目的根目录。其中的 arm 字样，其实就是代码库的名称，即前面用 svnadmin create 命令创建出来的那个 arm。

- 这里的 ``@`` 表示接下来的是一个组名，不是用户名。因为目前 g_manager 组里面只有一个 michael，你当然也可以将 ``@g_manager = rw`` 这一行替换成 ``michael = rw`` ，而表达的意义完全一样。

- ``*`` 表示“除了上面提到的那些人之外的其余所有人”，也就是“除了部门经理外的其他所有人”，当然也包括总经理那个怪老头

- ``* = r`` 则表示“那些人只能读，不能写”


authz.conf 之项目子目录
-----------------------

然后，我们要给总部人员开放日志目录的读写权限::

    [arm:/diary/headquarters]
    @g_manager = rw
    @g_headquarters = rw
    @g_vip = r
    * =

这个子目录的设置有些特色，因为从需求分析中我们知道，这个子目录的权限范围要比其父目录小，它不允许除指定了的之外其他任何人访问。在这段设置中，我们需要注意以下几点：

- 我敢打赌，设计svn的家伙们，大部分都是在类 unix 平台下工作，所以他们总喜欢使用 ``/`` 来标识子目录，而完全忽视在 MS Windows 下是用 ``\`` 来做同样的事情。所以这儿，为了表示 ``diary\headquarters`` 这个目录，我们必须使用 ``[arm:/diary/headquarters]`` 这样的格式。当然如果你一定要用 ``\`` ，那么唯一的结果就是，Subversion 会将你的这部分设置置之不理，全当没看到。

- 这里最后一行的 ``* =`` 表示，除了经理、总部人员、特别人士之外，任何人都被禁止访问本目录。这一行是否可以省略呢？不行，因为 **权限具备继承性** ，子目录会自动拥有父目录的权限。若没有这一行，则所有帐号都可以读取 ``/diary/headquarters`` 目录下的文件。因为虽然我们并没有设置这个目录的父目录权限，可是默认的规则使得 ``/diary`` 目录的权限与根目录完全一样，从而让其余帐号获得对 ``/diary/headquarters`` 目录的 r 权限。所以简单来说， ``* =`` 这一句的目的，就是割断权限继承性，使得管理员可以定制某个目录及其子目录的权限，从而完全避开其父目录权限设置的影响。

- 之所以这儿需要将 ``@g_vip = r`` 一句加上，就是因为存在上述这个解释。如果说你没有明确地给总经理授予读的权力，则他会和其他人一样，被 ``* =`` 给排除在外。

- 如果众位看官中间，有谁玩过防火墙配置的话，可能会感觉上述的配置很熟悉。不过这里有一点与防火墙配置不一样，那就是各个配置行之间，没有 **先后顺序** 一说。也就是说，如果我将本段配置的 ``* =`` 这一行挪到最前面，完全不影响整个配置的最终效果。

接下来我们看看这一段::

    [arm:/ref]
    @g_manager = rw
    @g_docs = rw
    * = r

这里的主要看点，就是 g_docs 组里面包含了一个 linda 帐号，她也同时在 g_headquarters 组里面出现，这就意味着， linda 将具备对 ``/ref`` 和 ``diary\headquarters`` 两个目录的读写权限。


authz.conf 之目录表示法
-----------------------
在前面的描述中，我们都采用 ``[repos:/some/dir]`` 这样的格式来表示项目的某个目录，比如上一小节中的 ``[arm:/diary/headquarters]`` 。而实际上，Subversion 允许你采用 ```[/some/dir]`` 这样的格式，即不指定代码库的方式来表示目录，此时的目录就匹配所有项目。

对于使用 svnserve 的用户来说，只有当 svnserve 运行的时候使用了 ``-r`` 参数，并且让多个代码库共享同一个目录权限文件（即 authz.conf 或 authz）时，不指明代码库名称才有可能惹麻烦。一般情况下，我们对每个代码库都会独立使用配置文件，毕竟每个项目的目录结构，都有很大不同，混在一起意义不大。因此一般来说，为简洁起见，都可以不指明代码库名称。本文全都指明了代码库名称，主要是为了将来扩展成同一个配置文件，以方便配合 Apache 服务器。

对于使用 Apache 的用户来说，它们二者可有着很大的不同，因为此时往往习惯于使用一个公共的目录权限配置文件。如果你使用了 SVNParentPath 指令，则指定版本库的名字是很重要的，因为假若你使用后者，那么 ``[/some/dir]`` 部分就会与所有代码库项目的 ``[/some/dir]`` 目录匹配。如果你使用 SVNPath 指令，则这两种表示方式就没有什么区别了，毕竟只有一个版本库。


authz.conf 的其他注意点
-----------------------

1. 父目录的 ``r`` 权限，对子目录 ``w`` 权限的影响

把这个问题专门提出来，是因为在1.3.1及其以前的版本里面，有个bug，即某个帐号为了对某个子目录具备写权限，则必须对其父目录具备读权限。因此现在使用了1.3.2及其更高的版本，就方便了那些想在一个代码库存放多个相互独立的项目的管理员，来分配权限了。比如说央舜公司建立一个大的代码库用于存放所有员工日志，叫做 diary，而arm事业部只是其中一个部门，则可以这样做::

    [diary:/]
    @g_chief_manager = rw

    [diary:/arm]
    @g_arm_manager = rw
    @g_arm = r

这样，对于所有arm事业部的人员来说，就可以将 svn://192.168.0.1/diary/arm 这个URL当作根目录来进行日常操作，而完全不管它其实只是一个子目录，并且当有少数好奇心比较强的人想试着 checkout 一下 svn://192.168.0.1/diary 的时候，马上就会得到一个警告“Access denied”，哇，太酷了。


2. 默认权限

如果说我对某个目录不设置任何权限，会怎样？马上动手做个试验，将::

    [diary:/]
    @g_chief_manager = rw

改成::

    [diary:/]
    # @g_chief_manager = rw

这样就相当于什么都没有设置。在我的 svn 1.3.2 版本上，此时是禁止任何访问。也就是说，如果你想要让某人访问某目录，你一定要显式指明这一点。这个策略，看起来与防火墙的策略是一致的。



3. 只读权限带来的一个小副作用

若设置了::

    [arm:/diary]
    * = r

则 Subversion 会认为，任何人都不允许改动 diary 目录，包括删除、 **改名** ，和 **新增** 。

也就是说，如果你在项目初期创建目录时候，一不小心写错目录名称，比如因拼写错误写成 dairy，以后除非你改动 authz.conf 里面的这行设置，否则无法利用 svn mv 命令将错误的目录更正。


4. anon-access 属性对目录权限的影响

你想将你的代码库开放给所有人访问，于是你就开放了匿名访问权限，在 svnserve.conf 文件中添加一行： ``anon-access=read`` 。可是对于部分目录，你又不希望别人看到，于是针对那些特别目录，你在 authz.conf 里面进行配置，添加了授权访问的人，并添加了 ``* =`` 标记。你认为一切OK了，可是你缺发现，那个特别目录却无法访问了，总是提示 ``Not authorized to open root of edit operation`` 或者 ``未授权打开根进行编辑操作`` 。你再三检查你配置的用户名与密码，确认一切正确，还是无法解决问题。

原来，Subversion 有个小 bug ，当 ``anon-access=read`` 并且某个目录有被设置上 ``* =`` 标记，则会出现上述问题。这个 bug 在当前最新版本上（v1.4）还存在，也许在下一版本内可以被改正吧。

解决的办法是，在 svnserve.conf 中，将 anon-access 设置成 none 。



改进
====

对中文目录的支持
----------------

上午上班的时候，Morson 来到 Michael 的桌子前面，说道：“你是否可以将我们的北京办、上海办目录，改成用中文的，看着那些拼音我觉得很难受？” Michael 心想，还好这两天刚了解了一些与 unicode 编码相关的知识，于是微笑地回答：“当然可以，你明天下午就可以看到中文目录名称了。”

1. 使用 svn mv 指令，将原来的一些目录改名并 commit 入代码库，改名后的目录结构如下::

    arm
    ├─工作日志
    │ ├─总部人员
    │ ├─北京办
    │ └─上海办
    ├─公司公共文件参考目录
    └─临时文件存放处

2. 修改代码库的 authz.conf 文件，将相应目录逐一改名

3. UTF-8 格式的 authz.conf 文件，以及 BOM

   将配置文件转换成 UTF-8 格式之后，Subversion 就能够正确识别中文字符了。但是这里需要注意一点，即必须保证 UTF-8 文件不包含 BOM 。BOM 是 Byte Order Mark 的缩写，指 UNICODE 文件头部用于指明高低字节排列顺序的几个字符，通常是 ``FF FE`` ，而将之用 UTF-8 编码之后，就是 ``EF BB BF`` 。由于 UTF-8 文件本身不存在字节序问题，所以对 UTF-16 等编码方式有重大意义的 BOM，对于 UTF-8 来说，只有一个作用——表明这个文件是 UTF-8 格式。由于 BOM 会给文本处理带来很多难题，所以现在很多软件都要求使用不带 BOM 的 UTF-8 文件，特别是一些处理文本的软件，如 PHP、 UNIX 脚本文件等，svn 也是如此。

目前常用的一些文本编辑工具中，MS Windows 自带的“记事本”里面，“另存为”菜单保存出来的 UTF-8 格式文件，会自动带上 BOM 。新版本 UltraEdit 提供了选项，允许用户选择是否需要 BOM，而老版本的不会添加 BOM。请各位查看一下自己常用的编辑器的说明文件，看看它是否支持这个功能。

对于已经存在 BOM 的 UTF-8 文件，比如说就是微软“记事本”弄出来的，我们可以利用 UltraEdit 来将 BOM 去掉。方法是，首先利用“UTF-8 TO ASCII”菜单将文件转换成本地编码，通常是GB2312码，然后再使用“ASCII TO UTF-8(UNICODE Editing)”来转换到 UTF-8 即可。当然，这么操作之前，你肯定得先保证，你的 UltraEdit 保存出来的 UTF-8 文件的确是不带 BOM 的。







6）如果你的服务端装在本机就可以这样访问：右击－－SVN checkout .此时会打开一个对话框。

      在 URL of repository 下面输入 svn://localhost/repository_1（如果是其他电脑访问这个仓库：

     svn://10.1.246.68/repository_1，其中10.1.246.68是我的IP地址，到时候大家可以自己替换。

     其实这里的svn://10.1.246.68地址对应e:\svn_service_root目录，因为一开始我通过命令：

    svnservice -install -d -r  "e:\svn_service_root" ，把e:\svn_service_root目录安装成可以通过SVN协议来访问

     e:\svn_service_root目录下的各个仓库。）

  在Checkout directory 下面输入检出的位置，这样就  OK !!!!










一、安装SVN默认安装到/usr/local/bin下面二、创建仓库 svnadmin create /home/svnrepo/root/svnrepo为所创建仓库的路径，理论上可以是任何目录三、修改配置文件/home/svnrepo/conf/svnserve.conf代码 #去掉#[general]前面的#号[general]#匿名访问的权限，可以是read,write,none,默认为readanon-access = none#认证用户的权限，可以是read,write,none,默认为writeauth-access = write#密码数据库的路径，去掉前面的#password-db = passwd 注意：所有的行都必须顶格，否则报错。建议：为了防止不必要的错误，建议你直接用我上面的内容覆盖掉文件原来的内容四、修改配置文件passwd。代码 [users]sxy = sxy 注意1. 一定要去掉[users]前面的#,否则svn只能以匿名用户登录，客户端不会出现登录窗口，除非你的anon不为none,否则将返回一个错误。2. 这里的密码都是没有加密的，我按照一些教程所说的用htpasswd生成的密码无法使用。五、配置SVN xinetd启动方式：在/etc/xinetd.d/下面新建svn文件service svn{    disable = no    port = 3690    socket_type = stream    protocol = tcp    wait = no    user = svn    server = /usr/local/bin/svnserve    server_args = -i -r /home/svn}重启xinetd   /etc/init.d/xinetd restart六、停止SVN服务器：killall svnserve七、启动SVN服务器对于单个代码仓库启动命令   svnserve -d -r /home/svn --listen-host 192.168.1.16其中-d表示在后台运行，-r指定服务器的根目录，这样访问服务器时就可以直接用svn://服务器ip来访问了。如果服务器有多ip的话--listen-host来指定监听的ip地址.我们可以在svn客户端中通过svn://192.168.1.16来访问svn服务器对于多个代码仓库,我们在启动时也可以用-r选项来指定服务器根目录,但访问时需要写上每个仓库相对于svn根目录的相对路径.比如,我们有两个代码仓库/home/repo1 和/home/repo2,我们用svnserve -d -r /home --listen-host 192.168.1.16来启动,那么在客户端访问时可以用svn://192.168.1.16/repo1和svn: //192.168.1.16/repo2来分别访问两个项目八、开放服务器端口svn默认端口是3690，你需要在防火墙上开放这个端口。      /sbin/iptables -A INPUT -i eth0 -p tcp --dport 3690 -j ACCEPT      /sbin/service iptables save你也可以通过svnserve的--listen-port选项来指定一个已经开放的其他端口,不过这样的话客户端使用也必须家上端口,如svn://192.168.1.200:9999/.九、使用svn客户端导入项目推荐使用客户端 http://tortoisesvn.tigris.org/eclipse插件 http://subclipse.tigris.org/






















创建端口为 5555  的SVN  服务
sc create SVNService5555 binPath= "\"C:\Program  Files\Subversion\bin\svnserve.exe\" --service -r  D:\SVN\Test --listen-port 5555" displayname= "SVNService5555" depend= "Tcpip"

查看5555的端口有没有启动
telnet  localhost 5555

删除名称为：SVNService5555的svn服务
sc delete SVNService5555

查看系统端口
netstat --ano