1.    在Apache下为SVN建立多个库。上篇中虽然也建立了一个SVN的库在Apache下，但是我们不可能一个SVN服务器上只有一个项目，或者所有项目共用一个SVN库进行开发，在Apache上为SVN建立多个库可以通过建立多个虚拟目录的方式实现。下面我们就来讲讲具体的步骤（注意，此篇中的配置和上篇中的配置方式有很大区别）
   
   
   1. 到F盘建立我们的SVN代码存放位置目录：SubversionFiles，并在其中建立一个conf目录，将会把对Apache对SVN的配置文件都放在这里
      
   2. 再在F:\SubversionFiles下目录Test1和Test2，并将它们变成SVN库（用svnadmin create命令或者用TortoiseSVN来创建都可以）
      
   3. 在httpd.conf的最后添加如下代码
      
      #
      # SVN 项目配置文件，格式：Include 配置文件名
      #为每个虚拟目录设置一个配置文件，用Include命令加载
      #
      Include F:/SubversionFiles/conf/*.project
      
      即把F:/SubversionFiles/conf/目录下的所有*.project文件都包到httpd.conf中来
      
      
      
   4. 在F:/SubversionFiles/conf/创建Test1.project和Test2.project文件，Test1内容如下，Test2可以做相应的修改
      
      #SVN项目名
      
           DAV svn
      
          #SVN项目的路径
           SVNPath F:\SubversionFiles\Test1
      
          #SVN项目的路径权限授权文件存放路径
          AuthzSVNAccessFile F:\SubversionFiles\conf\Test1.access
      
      #对于所有用户都需要身份验证
          Satisfy Any
           Require valid-user
      
      #验证方式
          AuthType Basic
      
          #项目的名称
           AuthName "My Test1"
      
          #用户信息
           AuthUserFile  F:\SubversionFiles\conf\user
      
      
      
      
      以上配置含义是在Apache下建立了一个叫作Test1的SVN虚拟目录，指向F:\SubversionFiles\Test1，授权配置文件是F:\SubversionFiles\conf\Test1.access，用户信息和密码文件是F:\SubversionFiles\conf\user
      
      
      
   5.  通过以上配置，我们就在Apache上建立了Test1和Test2两个虚拟目录，也就是两个独立的SVN库，我们还需要两个文件访问权限配置的.access和包含登录用户的user。 在F:\SubversionFiles\conf目录中创建用户列表文件user，方法在上篇中已经说过，也就是htpasswd命令，我们需要创建Xrinehart, X-Killer, Guest三个用户。
      
      
   6. 接下来，我们为Test1库创建它的访问权限文件F:\SubversionFiles\conf\Test1.access。在上篇文章中我们是采用对每个用户分别赋予对应权限的方式，如果用户比较多，管理起来就会比较麻烦，这时我们需要用用户组来对用户进行管理。下面我们就来尝试用用户组配置访问权限。Test1.access文件内容如下：
      
      
      [groups]
      AdminGroup = Xrinehart
      GuestGroup = guest
      
      [/]
      @AdminGroup = rw
      @GuestGroup = r
      
      X-Killer = rw
      
      
              在上面的配置中，通过[groups]节定义了两个用户组：AdminGroup和GuestGroup，并将Xrinehart用户归入AdminGroup用户组，guest用户归入GuestGroup。再在下面的[/]定义了他们对Test1库的根目录的操作权限：AdminGroup组有读写权限，GuestGroup组只有读权限，X-Killer用户拥有读写权限。这里需要注意的是定义权限的时候，用户组需要在前面加@符号来标示。
      
      
   7. 为了测试效果，我们可以将Test2.access文件写为：
      
      [groups]
      AdminGroup = Xrinehart, X-Killer
      GuestGroup = guest
      
      [/]
      @AdminGroup = r
      @GuestGroup = rw
      
      
      
   8. 保存好上面的所有配置文件之后，重新启动Apache服务器。此时我们就可以在IE里面通过http://localhost:8080/Test1 和http://localhost:8080/Test2 来访问Test1和Test2库了，你可以测试一下，用户权限是否符合下面这个列表所示？做到这里，SVN在Apache上建立多个库的配置也就算完成了。
      
      
                                                       Test1                                            Test2
      
      Xrinehart                                    rw                                                  r
      X-Killer                                       rw                                                  r
      guest                                          r                                                    rw
      

1. 准备工作：
   
   
   1. 下载软件：
      1. SVN服务器端程序。到官方网站 的下载二进制安装文件，来到二进制包下载部分  ，找到 Windows NT, 2000, XP and 2003部分，然后选择"this directory"，这样我们可以看到许多下载的内容，目前可以下载 svn-1.2.3-setup.exe。
         
         
      2. TortoiseSVN，客户端程序。TortoiseSVN是扩展Windows Shell的一套工具，可以看作Windows资源管理器的插件，安装之后Windows就可以识别Subversion的工作目录。
         官方网站是TortoiseSVN，下载方式和前面的svn服务器类似，在Download页面的我们选择Official version for Win2k/XP or higher的版本，然后在sourceforge的下载页面选择目前的最高稳定版本的安装文件TortoiseSVN-1.2.5.4719-svn-1.2.3.msi。（注意：TortoiseSVN有一个特殊对VS.Net运行时一个BUG修正的版本，在下载页面有选择：Special version for Win2k/XP or higher: (We provide NO support for this!) uses _svn folders instead of .svn to work around the VS.NET bug with web projects. If you don't use web projects then please use the official version. ）
         
         
      3. TortoiseSVN的中文语言包，注意这个需要下和客户端程序版本相同的。可以在Download页面内的Language Packs选择下载。
         
         
      4. Apache服务器程序。可以到Apache官方网站下载最新版本的Apache，并且SVN必须运行在Apache2以上版本，在下载页面选择Windows的安装包文件apache_2.0.55-win32-x86-no_ssl.msi
         
         
      5. AnkhSVN，可选安装VS.Net的SVN插件。有0.5和0.6版本选择，0.6版支持VS2005 Beta2，下载页面。
         
         
   2. 停止IIS，因为Apache默认安装为80端口，需要关闭IIS避免端口冲突。可以在安装好之后再调整端口。
      
      
      
2. 开始安装：
   
   
   1. 先安装Apache服务器。在到填写ServerInfo的时候，若机器已经启用了AD，安装程序会自动填写，否则自己手动填写。安装完成之后到安装目录下找到conf目录下的httpd.config文件，搜索Listen，并将Listen后面的80改为8080（或者你希望的端口），然后重新启动Apache服务器，这时可以用http://localhost:8080 来测试是否安装正确。
      
      
   2. 再安装SVN服务器，没有什么好说的，一路回车就可以了。（安装SVN时，请确保Apache服务器正在运行状态，安装过程中可能会将Apache关闭，重新启动属于正常现象）
      
      
3. 配置Apache服务器与SVN集成：
   
   
   
   1. 首先将Subversion安装目录bin\下面的两个文件：mod_authz_svn.so和mod_dav_svn.so复制到Apache安装目录modules\目录下。
      
   2. 有些文章说需要再修改httpd.conf，并做如下修改：
      找到Apache安装目录下的conf目录，用文本编辑器打开httpd.conf，找到一下两行：
      
      #LoadModule dav_module modules/mod_dav.so
      #LoadModule dav_fs_module modules/mod_dav_fs.so
      
      将每行前面的注释符“#”去掉。再在所有LoadModule语句的最后添加一下几行：
      
      #SVN
      LoadModule dav_svn_module modules/mod_dav_svn.so
      LoadModule authz_svn_module modules/mod_authz_svn.so
      
      但是我安装完之后发现这个文件已经被做了那些修改，大概是新版的SVN安装程序做了一些优化吧。其实在成功安装SVN之后，Apache服务器已经和SVN初步集成。如图：
      
      
      
      注意下面的状态栏已经是Apache/2.0.55 SVN1.2.3 DAV/2
      
      
   3. 建立一个SVN存放文件的目录，我在F盘下创建一个文件夹：F:/SubversionFiles
   4. 接下来我们必须告诉Apache我们的资源库所在的路径，可以通过Location指令来完成这个设置。因为不希望为每个单独的项目都进行单独的设置，所以我们把所有项目都存放在统一的资源库目录，那么可以使用SVNParentPath指令来指定存放所有项目的路径。在httpd.conf文件最后添加下面配置：
      
      #SVN
      
      <Location /svn>
          DAV svn
          SVNParentPath "F:/SubversionFiles"
      </Location>
      
      

   这样我们就可以通过http://myhost:8080/svn/<项目名> 来访问存放于资源库F:/SubversionFiles中的指定项目。当然有可能你并不希望某个项目提供这样一种访问方式，这时候你可以使用SVNPath为每个项目进行单独的设置，SVNPath的使用方法如下：
   
       DAV svn
       SVNPath "F:/SubversionFiles/project1"
   

   同样把这段配置放在httpd.conf最后，重启Apache HTTP服务即可通过http://myhost:8080/svn/project1 来访问project1项目的资源库。

   1. 下面作一个测试：

      1. 到F:\SubversionFiles下建立一个子目录Test，然后到Aapche下的Bin目录下执行svnadmin create F:\SubversionFiles\Test

      2. 打开浏览器输入网址：http://localhost:8080/svn/Test ，应该可以正确访问，但当前该项目下还没有加入任何内容，所以显示为空的

      3. 有一点需要提示的是，现在的访问是完全匿名的，任何人都可以对SVN进行操作。所以我们接下来利用Apache的权限管理功能来对SVN进行用户验证集成

   2. 加入用户身份验证：
      
      在确定对访问用户的权限控制之前，你必须规划好是对整个资源库中的所有项目还是单独的某一个项目进行统一的身份验证， 也就是我们前面讲到的是使用SVNParentPath还是SVNPath的问题。
      
      最简单的身份验证方式是使用Basic HTTP Authentication机制，该方式通过用户名和口令对访问用户进行身份验证。我们可以直接通过Apache提供的支持进行设置。Apache提供一个htpasswd工具来管理用户名和口令。接下来我们利用这个工具来添加两个用户。
      
      在命令行窗口中转到Apache所在的目录，执行下列命令
      
      说明：创建用户Xrinehart
      输入：htpasswd –c F:\SubversionFiles\svn_auth_passwd Xrinehart
      说明：使用-c参数来创建一个passwd文件
      输出：
      New password: *****
      Re-type new password: *****
      Adding password for user Xrinehart
      
      再创建用户的时候就不用-c参数，而是用-m参数，因为文件svn_auth_passwd 已经创建。
      
      

      打开svn_auth_passwd文件，密码使用MD5加密过了，而且同样的密码加密出来的内容却不相同
      
      接下来我们必须告诉Apache服务器如何使用这个passwd文件，打开httpd.conf找到刚才我们添加的Location配置的位置，修改如下：
      
      #
      # SVN
      #
      
        DAV svn
        SVNParentPath "F:/SubversionFiles"
      
      # how to authenticate a user
       AuthType Basic
       AuthName "Subversion repository"
       AuthUserFile "F:/SubversionFiles/svn_auth_passwd"
       
        # only authenticated users may access the repository
      Require valid-user
      
      
      重新启动Apache HTTP服务器，使用浏览器打开 http://localhost:8080/svn/Test 你将会看到要求登录的对话框，输入你刚设置的用户名和口令即可。
      
      这样Apache和SVN的集成就基本告成了
      
      

1．   按照启动Tomcat中的说明启动Tomcat。

2．   启动Web浏览器。

3．   在Web浏览器内，指向下列URL：

http://localhost:8080/admin

<user name="adeveloper" password="secret"
  roles="admin, manager" />

该命令调用了admin Web应用程序。在使用该应用程序前必须添加用户名/密码组合并将其与角色名admin关联。访问这个工具所需的的初始用户名和密码必须在Java WSDP安装期间设置。如果忘记了用户名和密码，可以用任意的文本编辑器参阅<JWSDP_HOME>/conf/tomcat-users.xml。该文件包含各个用户的元素<user>，该元素可能如下所示：<user name="adeveloper" password="secret"
  roles="admin, manager" />

4．   使用分配了admin角色的用户名和密码组合登录到admintool。该用户名和密码必须与build.properties文件中的用户名和密码匹配。

5．   结束时，通过选择上窗格中的Logout来退出管理工具。

本节介绍了如何利用管理工具设置角色、组和用户。比如关于利用管理工具创建、删除、和（或）配置的信息：

·   Tomcat服务器。

·   运行在Tomcat服务器上的服务，以及嵌套在这些服务里的各种元素，例如主机、上下文、成员域、连接器、日志记录器以及过滤阀。

·   各种资源例如数据源、环境条目，以及用户数据库。

理解角色、组以及用户

Tomcat服务器验证服务包括下列组件：

·   角色——用于设置具体的资源访问权限的抽象名。角色可比作能开锁的钥匙。许多人可能都配有同样的钥匙，而锁不会考虑你是谁，只要有正确的钥匙就行了。

·   用户——经过验证（关于验证前面章节已讨论过）的个人（或者应用程序）身份。一个用户可以有一系列与他身份相关联的角色，这样他就可以访问所有被保护的资源。

·   组——按照像工种或客户资料这样的普通特性分类的一组验证用户。组还与一组角色关联，并且属于该组的用户继承了所有分配给该组的角色。

·   成员域——角色、用户和组的完整数据库，用于识别Web应用程序的合法用户。

我们将在管理角色和用户一节中详细讨论了这些概念，关于管理工具的更多信息也可以找到。

利用管理工具添加角色

为设置容器管理安全的全新角色，遵循下列说明。管理工具中的添加、删除和改变写在tocamt-users.xml文件中。

1．   向下滚动管理工具的左窗格到User and Group Administration（用户和组管理）节点。

2．   选择Role Administration（角色管理）。

3．   从Roles List（角色列表）中选择Create New Role（创建新角色）。

4．   输入角色名和描述，例如Customer或User。

5．   选择Save（保存）。

利用管理工具添加用户

要想为容器管理安全设置新用户，遵循下列说明。管理工具中的添加、删除和改变写在tocamt-users.xml文件中。

1．  向下滚动管理工具的左窗格到User and Group Administration（用户和组管理）节点。

2．  选择User Administration（用户管理）。

3．  从Users List（用户列表）中选择Create New User（创建新用户）。

4．  输入用户名和密码，并为新用户选择一个角色。如果为新用户选择admin角色，该用户将能访问管理工具.

5．  选择Save（保存）。

修改应用程序

由于Java Web Services Developer Pack用于实验目的，它支持重复开发。只要改动了应用程序，就必须重新部署和加载该应用程序。在build.xml文件中定义的任务使得将这些改动部署到ConverterBean和JSP页面变得更简单。

在build.xml文件里，我们设置了一个在运行Tomcat服务器上安装应用程序的目标，和一个在运行Tomcat服务器内重载该应

用程序的目标。这些任务是用Tomcat服务器管理程序工具完成的，该工具是一个manager Web应用程序。可以使用在Java WSDP安装期间设置的用户名/密码组合，因为它能使管理程序的角色名与它关联。如果忘记了在安装期间设置的用户名/密码组合，可以利用任何文本编辑器查阅<JWSDP_HOME>/conf/tomcat/-user.xml。

修改类文件

为了修改Java组件内的类文件，更改源代码，重编译它，然后重新部署应用程序。使用Tomcat manager Web应用程序时，不需要停止并重新启动Tomcat以便重新部署这个更改过的应用程序。例如，假定你想改变ConverterBean组件的yenRate属性中的汇率：

1.       在源目录中编辑ConverterBean.java。

2.       通过输入ant build重新编译ConverterBean.java。

3.       通过输入ant reload重新部署ConverterBean.java。

4.       在Web浏览器中重新加载JSP页面。

修改Web客户端

为了修改JSP页面，更改源代码并重新部署应用程序。使用Tomcat manager Web应用程序时，不需要停止并重新启动Tomcat以便重新部署更改过的Web客户端程序。例如，假定你想修改字体或者在JSP页面中添加另外的描述文本。为了修改Web客户端程序：

1．   在源目录中编辑index.jsp。

2．   通过输入ant reload重新加载Web应用程序。

3．   在Web浏览器里重新加载JSP页面。

常见问题及其解决方案

使用下列指南来解决创建、编译、安装、部署和运行示例应用程序时遇到的问题。

启动Tomcat时的错误

"Out of Environment Space"错误

症状：在基于Microsoft Windows 9x/ME操作系统上，运行启动和关闭批处理文件时候出现“out of environment Space“错误。

解决方案：在Microsoft Windows 资源管理器中，右键单击startup.bat和shutdown.bat文件。选择“属性”，接着选择“内存”选项卡。 将“初始环境”域中的值增加到4096。选择“应用”。

选中“应用”后，在用来启动和停止容器的目录内将生成快捷方式。

"Unable to Locate the Server localhost:8080"错误

症状：试图在浏览器里加载Web应用程序时出现的"unable to locate server"错误。

解决方案：Tomcat的完全加载要花费一些时间，所以在继续疑难解决前首先要保证给Tomcat至少5分钟的加载时间。为了检验Tomcat是否正在运行，将浏览器指向http://localhost:8080。在Tomcat索引屏幕出现时，便可以继续了。如果索引屏幕没有立即加载，等几分钟然后再重试。如果Tomact还没有加载，就像下面描述的那样，点击日志文件以获取更多的疑难解答信息。

Tomcat启动时将初始化自身，然后加载<JWSDP_HOME>/webapps中的所有Web应用程序。当通过调用startup.sh运行Tomcat时，服务器消息被登入到<JWSDP_HOME>/logs/launcher.server.log中。加载Web应用程序的过程可在<JWSDP_HOME>/logs/jwsdp_log.<date>.txt文件中看到。

编译错误

Ant 不能定位生成文件

症状：在输入ant build时，出现如下消息：

Buildfile: build.xml does not exist!

Build failed. 

解决方案：从<JWSDP_HOME>/docs/tutorial/sxample/gs/目录启动Ant，或者从创建应用程序的目录。如果希望从当前目录启

动Ant，那么必须在命令行指定生成文件。例如，输入如下命令：

ant -buildfile 

<JWSDP_HOME>/docs/tutorial/examples/gs/build.xml

build 

编译器不能解析符号

症状：输入ant build时，编译器会报告许多错误，包括：

cannot resolve symbol

. . .

BUILD FAILED

. . .

Compile failed, messages should have been provided 

解决方案：确定所使用的Ant版本是与该Java WSDP版本一起发布的。确保这一要求的最好方法是使用Ant文件的完整PATH来构建应用程序，<JWSDP_HOME>/jakarta-ant-1.5.1/bin/ant build。其他版本可能不包括示例应用程序生成文件所期望的所有功能。

 “连接拒绝“错误

症状：在终端提示窗口中输入ant install时，收到下列消息：

<JWSDP_HOME>/docs/tutorial/examples/gs/build.xml:82: 

java.net.ConnectException: Connection refused 

解决方案：Tomcat没有完全启动。等待几分钟，然后尝试再次安装应用程序。关于Tomcat启动疑难解答的更多信息，参阅无效的本地服务器localhost:8080 。

试图运行安装任务时，系统出现中止

症状：输入ant install时，系统出现了中止。

解决方案：Tomcat启动脚本在后台启动了Tomcat，然后立即将用户返回命令提示行。尽管返回了命令行，但启动脚本可能还没有完全启动Tomcat。如果这个安装任务没有立即运行，等待几分钟后重试安装任务。为了检验Tomact是否在运行，将浏览器指向http://localhost:8080。若出现Tomcat索引屏幕，就可以继续。如果这个闪屏没有立即加载，等待几分钟后重试。如果Tomcat一直没有加载，检查日志文件以获得更多疑难解答信息：

Tomcat启动时先初始化自己，然后加载<JWSDP_HOME>/webapps中的所有Web应用程序。通过调用startup.sh运行Tomcat时，服务器消息已经登入<JWSDP_HOME>/logs/launcher.server.log。加载Web应用程序的过程可在<JWSDP_HOME>/logs/jwsdp_log.<date>.txt文件中看到。

部署错误

Server returned HTTP response code: 401 for URL ...

症状：输入ant install时，出现如下消息：

BUILD FAILED

/home/you/gs/build.xml:44:

java.io.IOException: Server returned HTTP response code: 401

for URL: http://localhost:8080/manager/install?path= ... 

解决方案：确定build.properties文件中的用户名和密码与具有tomcat-users.xml文件里manager角色的用户名和密码相匹配。

不能运行客户端应用程序

症状：浏览器报告找不到该页面（HTTP404）。

解决方案：启动脚本在后台启动任务，然后立即将用户返回命令行提示窗口。尽管已经返回命令行，但启动脚本可能还没有

完全启动Tomcat。如果Web客户端没有立即运行，等待几分钟再重试加载Web客户端。

找不到localhost机器

症状：浏览器报告找不到该页面（HTTP404）。

解决方案：有时候，若位于代理服务器和防火墙的后面将不能访问localhost机器。为了解决这个问题，更改代理设置以便不再通过代理访问localhost。

为了在Netscape Navigator 浏览器中实现这一目的，选择Edit -> Preferences -> Advanced -> Proxies ，然后选择 No Proxy for: localhost。 在 Internet Explorer中，选择 Tools -> Internet Options -> Connections -> LAN Settings。

应用程序没有部署

症状：浏览器报告找不到该页面（HTTP404）。

解决方案：部署应用程序。想了解更多的细节，参阅部署应用程序一节。

"Build Failed: Application Already Exists at Path" 错误

症状：在终端提示窗口输入ant install时，收到如下消息：

[install] FAIL - Application already exists at path /GSApp 

BUILD FAILED 

<JWSDP_HOME>/docs/tutorial/examples/gs/build.xml:82: FAIL - 

Application already exists at path /GSApp 

该应用程序已经安装。如果由于应用程序的安装而对它作出了改动，利用ant reload更新Tomcat中的应用程序。

HTTP 500: No Context Error

症状：在试图运行部署应用程序时候收到一个No Context Error错误。

解决方案：这个错误意味Tomcat被加载，但是它不知道应用程序。如果还没有通过运行ant remove、ant build、ant install和ant reload部署应用程序，现在做吧。

解决方案：如果Tomacat正在加载，但是还没有加载所有已存在的上下文，将收到该错误。不断点击浏览器中的重载或者刷新按钮，直到应用程序被加载或者收到另一种错误消息。

更多信息

·   Tomcat 管理工具。阅读Tomcat管理工具以获得利用admintool，无需停止并重新启动Tomcat来配置它的行为的更多信息。

·   Tomcat 配置参考。想了解更多关于能用来配置Tomacat行为的元素的信息，阅读<JWSDP_HOME>/docs/tomcat/config/index.html中的Tomcat配置参考。

·   类加载器入门。该文档讨论了应用开发者和部署者应该把类和资源文件放在哪里，以便让Web应用能找到它们。该文档位于<JWSDP_HOME>/docs/tomcat/class-loader-howto.html中。

·   JNDI 资源入门。该文档讨论了JNDI资源配置、Tomcat标准资源工厂、JDBC数据源，和定制资源工厂。该文档位于 <JWSDP_HOME>/docs/tomcat/jndi-resources-howto.html中。

·   Manager Application入门。该文档描述了如何利用Manager Application，无需关闭和重新启动Tomcat，来部署新的Web应用程序，解除部署现有的应用程序，或者重载现有的应用程序。该文档位于<JWSDP_HOME>/docs/tomcat/manager-howto.html中。

·   代理支持入门。该文档讨论了如何在代理服务器（或者配置来行使代理服务器功能的Web服务器）后面运行。特别地，该文档讨论了如何管理来自Web应用的调用返回值。其中该Web应用请求服务器名和请求将被发往的端口号。该文档位于<JWSDP_HOME>/docs/tomcat/proxy-howto.html中。

·   成员域配置入门。该文档讨论了如何通过连接到用户名、密码、和用户角色的现有数据库，配置Tomcat以支持容器管理安全。该文档位于<JWSDP_HOME>/docs/tomcat/realm-howto.html

·   安全管理程序入门。该文档讨论了运行Tomcat以保护服务器免受未经验证的serlvets、JSP、JSP bean、和标签库侵扰时，Security Manager的用法。该文档位于<JWSDP_HOME>/docs/tomcat/security-manager-howto.html中。

SSL 配置入门。该文档讨论了如何在Tomcat上安装和配置SSL支持。安装和配置SSL支持中讨论了如何利用Java WSDP在Tomcat上安装和配置SSL支持。<JWSDP_HOME>/docs/tomcat/ssl-howto.html 中的Tomcat文档也讨论了这个主题，然而，本教程中的信息对于这个与Java WSDP一起发布的Tomcat版本来说是最新的。