3.配置tomcat :
   修改%TOMCAT_HOME%"conf"server.xml，以文字编辑器打开，查找这一行：
   xml 代码
  
   将之后的那段的注释去掉，并加上 keystorePass及keystoreFile属性。
   注意，tomcat不同版本配置是不同的:
   tomcat4.1.34配置：
   xml 代码     <Connector className="org.apache.coyote.tomcat4.CoyoteConnector"             port="8443" enableLookups="true" scheme="https" secure="true"             acceptCount="100"             useURIValidationHack="false" disableUploadTimeout="true"             clientAuth="false" sslProtocol="TLS"               keystoreFile="server.keystore"               keystorePass="changit"/>  tomcat5.5.9配置：
   
    
   xml 代码
     
   <Connector port="8443" maxHttpHeaderSize="8192"  
              maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
              enableLookups="false" disableUploadTimeout="true"  
              acceptCount="100" scheme="https" secure="true"  
              clientAuth="false" sslProtocol="TLS"    
              keystoreFile="server.keystore"    
              keystorePass="changit"/>  
   tomcat5.5.20配置(此配置同样可用于tomcat6.0)：
   
   xml 代码
     
   <Connector protocol="org.apache.coyote.http11.Http11Protocol"    
                        port="8443" maxHttpHeaderSize="8192"  
              maxThreads="150" minSpareThreads="25" maxSpareThreads="75"  
              enableLookups="false" disableUploadTimeout="true"  
              acceptCount="100" scheme="https" secure="true"  
              clientAuth="false" sslProtocol="TLS"                   
              keystoreFile="server.keystore"    
              keystorePass="changit"/>  
   tomcat6.0.10配置：
   
   xml 代码
   <Connector protocol="org.apache.coyote.http11.Http11NioProtocol"  
              port="8443" minSpareThreads="5" maxSpareThreads="75"  
              enableLookups="true" disableUploadTimeout="true"    
              acceptCount="100"  maxThreads="200"  
              scheme="https" secure="true" SSLEnabled="true"  
              clientAuth="false" sslProtocol="TLS"  
              keystoreFile="server.keystore"    
              keystorePass="changit"/>  
   tomcat6支持3种，请参考以下文档：
   http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html
   
  4.验证配置
   访问 https://localhost:8443/
   <connector protocol="org.apache.coyote.http11.Http11NioProtocol"></connector>
   
  5. 如果默认想用HTTPS 方式进行网站, 可以作如下配置:
  一般Tomcat默认的SSL端口号是8443，但是对于SSL标准端口号是443，
  这样在访问网页的时候，直接使用https而不需要输入端口号就可以访问，如https://localhost
  
   1).non-SSL HTTP/1.1 Connector定义的地方，一般如下：
        <Connector port="80" maxHttpHeaderSize="8192"  scheme="https"
                maxThreads="500" minSpareThreads="25" maxSpareThreads="75"
                enableLookups="false" redirectPort="443" acceptCount="100"
                connectionTimeout="20000" disableUploadTimeout="true" />  
  
      将其中的redirectPort端口号改为：443

   2).SSL HTTP/1.1 Connector定义的地方，修改端口号为：443，如下：
       <Connector    
       port="443" maxHttpHeaderSize="8192"
       maxThreads="150" minSpareThreads="25"
       maxSpareThreads="75"
       enableLookups="false"
       disableUploadTimeout="true"
       acceptCount="100" scheme="https"
       secure="true"
       clientAuth="false" sslProtocol="TLS"
        SSLEnabled="true"  
       keystoreFile="e:/server.keystore"
       keystorePass="changit" />
    3).AJP 1.3 Connector定义的地方，修改redirectPort为443，如下：  
    <Connector port="8009"
          enableLookups="false" redirectPort="443" protocol="AJP/1.3" />
                   
                   
   如上配置好后便可以用 Https://localhost 方式直接访问,无需输入端口号;

三、参考资料
  1. Keytool使用指南：
    http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/keytool.html
 
  2. tomcat-ssl配置指南：
    http://tomcat.apache.org/tomcat-5.5-doc/ssl-howto.html
    http://tomcat.apache.org/tomcat-6.0-doc/ssl-howto.html

2.然后修改ejb3.deployer中jboss-service.xml文件，主要是添加域名到3873的调用中
   <mbean code="org.jboss.remoting.transport.Connector"
          xmbean-dd="org/jboss/remoting/transport/Connector.xml"
          name="jboss.remoting:type=Connector,name=DefaultEjb3Connector,handler=ejb3">
      <depends>jboss.aop:service=AspectDeployer</depends>
      <attribute name="Configuration">
    <config>
     <invoker transport="socket">
     <attribute name="numAcceptThreads">1</attribute>
     <attribute name="maxPoolSize">300</attribute>
     <attribute name="clientMaxPoolSize" isParam="true">50</attribute>
     <attribute name="timeout" isParam="true">60000</attribute>
     <attribute name="serverBindAddress">${jboss.bind.address}</attribute>
     <attribute name="serverBindPort">3873</attribute>
     <!-- that's the important setting -->
     <attribute name="clientConnectAddress">10.104.46.119</attribute>
     <attribute name="clientConnectPort">3873</attribute>
     <attribute name="backlog">200</attribute>
     </invoker>
     <handlers>
     <handler subsystem="AOP">org.jboss.aspects.remoting.AOPRemotingInvocationHandler</handler>
     </handlers>
    </config>
      </attribute>
   </mbean>

3.设置java启动选项，添加rmi-server的外部地址和禁用本地域名解析到启动脚本
Windows脚本例：set JAVA_OPTS=-Djava.rmi.server.hostname= external IP -Djava.rmi.server.useLocalHostname=false
Unix脚本例：添加到jboss启动配置文件run.conf中即可。

4.用run.sh --host=192.168.1.25启动服务或添加--host=192.168.1.25到启动脚本。

1.在使用Jboss 4.2GA 遇到的问题. 以下是以default 模式启动的Jboss .启动参数 -c default /all
(1). localhost可以访问与本机IP不能访问
解决方式：
修改JBOSS_HOME"server"default"deploy"jboss-web.deployer下的server.xml 将address改为0.0.0.0或者你的实际IP 重启 JBOSS 然后就可以通过ip访问。

(3)在windows 客户端调用 Linux 服务端 遇到org.jboss.remoting.CannotConnectException: Can not get connection to server. Problem establishing socket connection for InvokerLocator [socket://127.0.0.1:3873/]
解决方法: 修改 JBOSS_HOME/server/default/deploy/ejb3.deployer/META-INF/jboss-services.xml 文件中的${jboss.bind.address}:3873 为linux_home_ip:3873

以上两个问题也可以通过以下设置解决：
For Windows, use
run.bat -b 0.0.0.0

for Linux use
run.sh -b 0.0.0.0

1.1 确认JDK安装配置

在启动JBOSS节点前，要正确安装SUN JDK1.5

并设置环境变量$JAVA_HOME

解压缩JBOOS-TGZ包

1.2 运行JBOSS

cd $JBOSS_HOME/bin

nohup ./run.sh -c vcom -b 0.0.0.0 –u 229.12.12.12&

参数说明：

-c: 指定运行的配置，default配置不带集群支持,all 和自定义的vcom目录配置带有集群支持功能

-b: 指定服务绑定的IP地址，即对外服务的IP地址，0.0.0.0表示对机器上所有的IP提供服务

-u 指定服务使用的UDP组播地址

1.3 关闭JBOSS服务

编写脚本内容如下：

#!/bin/bash

for i in ` ps -ef | grep -w java |grep -v grep |awk '{print $2 ""t"$3}'`;do kill -9 $i

done

2.jmx-console控制台

  安装好jboss并启动jboss后，在浏览器窗口的地址栏里键入 http://localhost:8080/jmx-console（jboss默认的端口号为8080,可以自定义修改）。就可以浏览 jboss的部署管理的一些信息，默认情况下不键入任何用户名和密码就可以进入此页面，方便是方便，但真正使用起来还是有点安全隐患，因为不管任何人只要知道server的ip 都可以进去访问。下面我们针对此问题对jboss进行配置，使得访问jmx-console也必须 要知道用户名和密码才可进去访问.

 2.1 设置jmx-console安全设置

 1. 进入jmx-console.war，通常此目录在$JBOSS_HOME/server/vcom/deploy目录下。

 2. 编辑该目录下的/WEB-INF/web.xml，把<security-constraint>部分注释去掉 3.编辑$jboss_home/server/vcom/conf/props目录下的jmx-console-roles.properties和jmx-console-users.properties；

       1) users.properties文件里定义用户名和密码，格式为username=password。可以依照此格式添加多个用户。

2) roles.propertie文件里定义用户名和角色，格式为username=role。这里的role必须和web.xml文件里的<role-name>相对应。

4. 编辑/WEB-INF/jboss-web.xml文件，打开<security-domain>部分注释；这里<security- domain>内容对应的security-domain对应$jboss_home"server"vcom"conf"login-config.xml这个jaas配置文件里的某个application-policy。

如:

<security-domain>java:/jaas/jmx-console</security-domain>
在login-config.xml里对应有：

<application-policy name = "jmx-console">

<authentication>

<login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" flag = "required" />

</authentication>

</application-policy>

5．重启jboss，在浏览器中键入控制台地址，就会出现输入username和password的提示窗口。

2.2 监控集群状况和session复制情况

使用http://localhost:8080/jmx-console,使用名为jboss.cache:service=TomcatClustering MBean Members可以查看当前机群节点成员信息，使用jboss.cache:service=TomcatClustering，可以看到当前集群的节点ip,在member 一项中，可以观察到当前集群中节点ip,如图：

在此页面下找到java.lang.String printDetails() ，

invoke the printDetails操作，点击invoke，可以对session复制进行监控。

3、配置JBOSS应用数据库连接

目前应用使用的数据库连接是应用程序自带的JDBC （API）接口，配置如下：

Cd /$JBOSS_HOME/server/vcom/deploy/*.war/WEB-INF/class/

Vi proxool.xml

 <?xml version="1.0" encoding="UTF-8"?>

<datasource>

 <proxool>

    <alias>pool</alias>

    <driver-url>jdbc:oracle:thin:@192.168.104.32:1521:cportal</driver-url>

    <driver-class>oracle.jdbc.driver.OracleDriver</driver-class>

    <driver-properties>

      <property name="user" value="cportal"/>

      <property name="password" value="cportal"/>

    </driver-properties>

    <house-keeping-sleep-time>30000</house-keeping-sleep-time>

    <minimum-connection-count>0</minimum-connection-count>

    <maximum-connection-count>300</maximum-connection-count>

    <house-keeping-test-sql>select CURRENT_DATE</house-keeping-test-sql>

 </proxool>

</datasource>

(1) jdbc:oracle:thin:@192.168.104.32:1521:cportal，oracle服务端口是1521，cportal为数据库的实例名即sid。

(2) <property name="user" value="cportal"/>

 <property name="password" value="cportal"/> 为数据库的用户名和密码

（3）<maximum-connection-count>300</maximum-connection-count>为客户端 最大的数据库连接数

4.修改jboss服务端口号

使用JBOSS中间件时,默认的访问端口是8080，可以修改问你想使用的端口，修改步骤如下：
打开JBOSS目录$JBOSS_HOME/server/vcom/deploy/jboss-web.deployer/下的server.xml文件,搜索8080,将8080改为新的端口号,保存文件,重启应用服务器即可.访问时使用新的端口号.
<Connector port="80" address="${jboss.bind.address}"   

         maxThreads="150" maxHttpHeaderSize="8192"

         emptySessionPath="true" protocol="HTTP/1.1"

         enableLookups="false" redirectPort="8443" acceptCount="100"

         connectionTimeout="20000" disableUploadTimeout="true" />

其中150是JVM中启动的最大线程数，100 为JVM达到最大线程阀值时，可以放在队列中的HTTP请求数

5.JBOSS服务状态监控（web-console）

 如果需要监控jboss的系统资源，如：jboss的基本配置情况，jvm的利用率，线程池的使用情况，可以使用web-console进行监控。

5.1配置web-console

具体方法同jmx-console，就是位置不同，具体方法参考jmx-console配置：

· jboss-web.xml、web.xml在$JBOSS_HOME/vcom/deploy/management/console-mgr.sar/web-console.war/WEB-INF下；

· login-config.xml还是原来的那个，把application-policy名为$webConsoleDomain的部分改成你需要的web-console；

· web-console-users.properties、web-console-roles.properties定义了访问 web-console的用户、用户角色，具体位置自己去找，使用find /jboss -name web-console-users.properties 找到以后可以修改用户名、密码。

5.2 监控

使用http://localhost:8080/web-console/ 中，获取当前JBOSS-WEB应用模块的负载分担情况，并可以查看到当前JAVA虚拟机的内存使用情况，及线程池使用情况。

使用http://localhost:8080/web-console/status，可以进一步监控到每个线程的状态。

6.系统日志分析

在$JBOSS_HOME /server/vcom/log下，有关于jboss的日志记录， 其中server.log是用来记录JBOOS运行过程的日志记录,boot.log用来记录JBOOS启动信息的，出现问题时可以通过sever.log对jboss进行分析。

 6.1 JBOSS的日志配置文件

$JBOSS_HOME /server/vcom/conf下的jboss-log4j.xml，可以对日志的来源和级别进行定义，也可以定义日志的记录方式。

6.2 产生cluster.log

可以把jboss-log4j.xml中最后有关cluster.log的APPENDER注释掉，系统运行时会在log目录下产生cluster.log文件，可以通过此文件对集群故障进行分析。在测试调试过程可以使用此日志

6.3 更改日志记录方式

Jboss日志记录方式有2种：

1．              按日期进行记录

2．              按日志文件的大小进行记录

目前使用的是按照大小信息记录。如果要修改记录方式，直接编辑jboss-log4j.xml文件，将此段注释去掉。

<!-- A time/date based rolling appender -->

   <appender name="FILE" class="org.jboss.logging.appender.DailyRollingFileAppender">

      <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>

      <param name="File" value="${jboss.server.log.dir}/server.log"/>

      <param name="Append" value="false"/>

      <!-- Rollover at midnight each day -->

      <param name="DatePattern" value="'.'yyyy-MM-dd"/>

      …………………………………………………

……………………………………………………………………….

      </layout>

   </appender>

同时将下段注释掉

<!-- A size based file rolling appender-->

   <appender name="FILE" class="org.jboss.logging.appender.RollingFileAppender">

     <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/>

     <param name="File" value="${jboss.server.log.dir}/server.log"/>

     <param name="Append" value="false"/>

     <param name="MaxFileSize" value="500KB"/>

     <param name="MaxBackupIndex" value="1"/>

 ……………………………………………………………

…………………………………………………………

     </layout>

   </appender>

      一、修改数据库的连接方式

         1、采用数据源的形式
            在 tomcat 中配置数据源方式如下:
            在生成的项目同级目录中找此文件： context.xml 
                     Servers/Tomcat 。。。/context.xml  作如下配置：
            在标签 <Context> 中间加入:
            <Resource  
                  name="jdbc/demo" auth="Container" type="javax.sql.DataSource" 
                  maxActive="30" maxIdle="5" maxWait="10000" username="root" 
                  password="admin" driverClassName="com.mysql.jdbc.Driver" 
                  url="jdbc:mysql://localhost:3306/demo?useUnicode=true&amp;characterEncoding=UTF-8">

          </Resource>          

         2、使用非数据源的形式
            在文件：persistence.xml 中添加hibernate 的连接数据库的方式，如下：
              <property name="hibernate.connection.username" value="root"/>
            <property name="hibernate.connection.password" value="admin"/>
            <property name="hibernate.connection.driver_class" value="com.mysql.jdbc.Driver"/>
            <property name="hibernate.connection.url" 
                  value="jdbc:mysql://localhost:3306/demo?useUnicode=true&characterEncoding=UTF-8"/>

      二、修改 JPA 配置文件 persistence.xml

          1、如果数据的连接方式采用数据源的形式，则只需修改里面数据源的名称，如：
            <jta-data-source>java:comp/env/jdbc/demo</jta-data-source>

          2、如果采用hibernate 的连接方式，则把此行删了。        

          3、删除里面的此行配置：
             <property name="hibernate.transaction.manager_lookup_class" 
                  value="org.hibernate.transaction.JBossTransactionManagerLookup"/>

          4、修改事务的策略方式为 RESOURCE_LOCAL ： 

            <persistence-unit name="demo" transaction-type="RESOURCE_LOCAL">

      三、配置 Seam 的事务管理器
          在 component.xml 文件加入：
          <transaction:entity-transaction entity-manager="#{entityManager}"/>
         默认生成的此文件是不含有 transaction 的命名空间，需要手动在此文件加入它的命名空间：

          xmlns:transaction=http://jboss.com/products/seam/transaction
         http://jboss.com/products/seam/transaction 
         http://jboss.com/products/seam/transaction-2.1.xsd

      四、为此项目加入必要的依赖包 。。。。。。

How do I set the Transaction Timeout?

Transaction timeout (unit is always seconds) can be configured in various ways:

This argument is the same no matter if you are using JBossTM(<=4.0.5) or JBossJTA-Arjuna(>=4.2).

• Globally: You can change this behavior globally by modifying the TransactionManagerService in /conf/jboss-service.xml (or /deploy/jta-service.xml for 4.0.3)

Version <= 4.0.5

This part is the same for either JBossTM or JBossJTA and is the same for ejb2 and ejb3

• Per-method basis: Modifying the <transaction-timeout> element inside the <method> element of a session or entity bean. This is located in the META-INF/jboss.xml deployment descriptor of a session bean. When the transaction timeout is specified at the method level, it overrides the default timeout. Further information about this element can be found in jboss-x.x.x/docs/dtd/jboss_4_0.dtd. Example taken from the testsuite:

• Using BMT: Calling javax.transaction.UserTransaction.setTransactionTimeout(int seconds). Please, be aware that this only applies to transactions started after this invocation on the same thread. Example:

@TransactionTimeout(1500)

Available option in deploy/jbossweb-tomcat.sar/META-INF/jboss-service.xml

or deploy/jboss-web.deployer/META-INF/jboss-service.xml

This configuration options toggles usage of separate classloaders for web modules. The JBoss unified classloader holds all the classes from multiple web applications in one big classloader and may cause unwanted interference.

Example

Imagine web modules "sales.war" and "stock.war", both containing some version of "utility.jar". In case "sales.war" uses version 1.0 and "stock.war" requires version 2.0, turning off the unified web loader is the safest solution. If you don't, the first loaded library will have priority, and remains in the classloader till the reference count drops to zero.

The disadvantage of using isolated classloaders: either you need to duplicate the same library across multiple web modules, or add it to the classpath of your server instance (default: lib/). The instance libraries are defaults, they can be overridden when the web module contains it's own custom versions.

The configuration file contains a small comment about isolation of JSP files as well, to separate two JSP files with the same name from two different web modules. In JBoss 4.0.5, using non-precompiled JSP pages, this seems to work fine, even with the JBoss unified web loader.

mod_python is similar to (and inspired by) mod_perl : It embeds Python within Apache and loads Python code into memory when the server starts. Code stays in memory throughout the life of an Apache process, which leads to significant performance gains over other server arrangements.

Django requires Apache 2.x and mod_python 3.x, and you should use Apache’s prefork MPM, as opposed to the worker MPM.

You may also be interested in How to use Django with FastCGI, SCGI or AJP (which also covers SCGI and AJP).

<Location "/mysite/">

SetHandler python-program

PythonHandler django.core.handlers.modpython

SetEnv DJANGO_SETTINGS_MODULE mysite.settings

PythonOption django.root /mysite

PythonDebug On

</Location>

<Location "/mysite/">

SetHandler python-program

PythonHandler django.core.handlers.modpython

SetEnv DJANGO_SETTINGS_MODULE mysite.settings

PythonOption django.root /mysite

PythonDebug On

PythonPath "['/path/to/project'] + sys.path"

</Location>

PythonPath "['/usr/local/django-apps/', '/var/www'] + sys.path"

PythonPath "['c:/path/to/project'] + sys.path"

NameVirtualHost *



<VirtualHost *>

ServerName www.example.com

# ...

SetEnv DJANGO_SETTINGS_MODULE mysite.settings

</VirtualHost>



<VirtualHost *>

ServerName www2.example.com

# ...

SetEnv DJANGO_SETTINGS_MODULE mysite.other_settings

</VirtualHost>

<VirtualHost *>

ServerName www.example.com

# ...

<Location "/something">

SetEnv DJANGO_SETTINGS_MODULE mysite.settings

PythonInterpreter mysite

</Location>



<Location "/otherthing">

SetEnv DJANGO_SETTINGS_MODULE mysite.other_settings

PythonInterpreter othersite

</Location>

</VirtualHost>

assert False, the_value_i_want_to_see

<Location "/media">

SetHandler None

</Location>

<Location "/">

SetHandler python-program

PythonHandler django.core.handlers.modpython

SetEnv DJANGO_SETTINGS_MODULE mysite.settings

</Location>



<Location "/media">

SetHandler None

</Location>



<LocationMatch "".(jpg|gif|png)$">

SetHandler None

</LocationMatch>

import os

os.environ['PYTHON_EGG_CACHE'] = '/some/directory'

PythonInterpreter my_django

PythonImport /path/to/my/project/file.py my_django

127.0.0.1    localhost www.test.com www.service.test.com bbs.test.com bbs.service.test.com

<Host name="www.service.test.com" unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false"/>

<Context docBase="/home/mahaibo/app/test"
privileged="true" antiResourceLocking="false" antiJARLocking="false">
</Context>

<Host name="bbs.service.test.com" unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false"/>

<Context docBase="/home/mahaibo/app/bbs"
privileged="true" antiResourceLocking="false" antiJARLocking="false">
</Context>

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_ftp_module modules/mod_proxy_ftp.so

NameVirtualHost *:80
<VirtualHost *:80>
ServerName www.test.com
ProxyIOBufferSize 8192
ProxyRequests Off
ProxyVia Full
ProxyPass / http://www.service.test.com:8080/ smax=5 max=20 ttl=120 retry=300
</VirtualHost>
<VirtualHost *:80>
ServerName bbs.test.com
ProxyIOBufferSize 8192
ProxyRequests Off
ProxyVia Full
ProxyPass / http://bbs.service.test.com:8088/ smax=5 max=20 ttl=120 retry=300
</VirtualHost>

./apachectl start

1.   目标

使用 apache 和 tomcat 配置一个可以应用的 web 网站，要达到以下要求：

1、 Apache 做为 HttpServer ，后面连接多个 tomcat 应用实例，并进行负载均衡。

2、 为系统设定 Session 超时时间，包括 Apache 和 tomcat

3、 为系统屏蔽文件列表，包括 Apache 和 tomcat

2.   安装 tomcat

2.1. 下载，解压 tomcat

不要下载安装版 , 下载地址

http://tomcat.apache.org

2.2. 配置 tomcat

2.2.1.     配置 server 的关闭口

我们需要在一台机器上跑 2 个不同的 tomcat ，需要修改不同的 tomcat 的关闭口，避免出现端口被占用的情况。在 server.xml 中找到 server, 将：

<Server port="8005" shutdown="SHUTDOWN">

改为

<Server port="XXXX" shutdown="SHUTDOWN">

XXXX 在这里表示不同的端口：我的两个 tomcat 分别使用 8035 ， 8045

注意：这里之所以要配置不同的 tomcat 关闭口，只是因为我们使用了多个 tomcat ，其实用一个 server 多个实例也可以。

2.2.2.     配置 service

我们需要对不同的 tomcat 的 service 取不同的名字，在 server.xml 中找到：

<Service name="Catalina">

改为：

<Service name="XXXX">

两个 service 分别为 tomcat6 和 tomcat5

2.2.3.     配置 Connector

这个部分主要是要改两个 Connector ，当然前提是你的 tomcat 只有两个 Connector 。

修改 ajp1.3 的端口：

找到： <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

改为： <Connector port="XXXX" protocol="AJP/1.3" redirectPort="8443" />

两个 Service 的 ajp/1.3 的端口分别为： 8019 ， 8029

修改 http 的端口：

找到：

<Connector port="8080" protocol="HTTP/1.1"

               maxThreads="150" connectionTimeout="20000"

               redirectPort="8443" />

改为：

<Connector port="XXXX" protocol="HTTP/1.1"

               maxThreads="150" connectionTimeout="20000"

               redirectPort="8443" />

两个 Service 的 ajp/1.3 的端口分别为： 8060 ， 8070

2.2.4.     配置 Engine

Engine 主要是配置 jvmRoute 属性，找到：

<Engine name="Catalina" defaultHost="localhost">

改为：

<Engine jvmRoute="XXXX" name="Catalina" defaultHost="localhost">

两个实例分别为： tomcat6 和 tomcat5.

2.2.5.     配置公用性 Context

如果有 Context 是多个系统公用的，比如图片等的存放地，可以做个配置：

在 Host 中增加：

<Context path="/image" docBase="D:"webRoot"image" debug="0" reloadable="false" crossContext="true">

</Context>

2.2.6.     屏蔽文件列表

打开 tomcat 目录下的 conf/web.xml ，

找到：

<servlet>

        <servlet-name>default</servlet-name>

        <servlet-class>org.apache.catalina.servlets.DefaultServlet</servlet-class>

        <init-param>

            <param-name>debug</param-name>

            <param-value>0</param-value>

        </init-param>

        <init-param>

            <param-name>listings</param-name>

            <param-value>true</param-value>

        </init-param>

        <load-on-startup>1</load-on-startup>

    </servlet>

将 listings 参数改为 false;

2.3. 配置应用 (web.xml)

对系统应用做些控制。

配置 session 过期时间，大多数网站用户都只是做些浏览性的操作，为了减轻服务器负载压力，我们将 session 超时时间从默认的 30 分钟变为 5 分钟。

在 web 应用程序的 web.xml 中 servlet-mapping 之后增加如下一段：

<session-config>

    <session-timeout>5</session-timeout>

</session-config>

3.   安装 Apache

3.1. 下载、安装 Apache

下载地址 http://httpd.apache.org/download.cgi

下载后点击安装 msi 文件。

安装的时候没有什么特别需要注意的地方，按照默认就行了。是否安装为 service 看具体情况而定。

3.2. 下载、安装 Apache 、 tomcat 的 Connector

http://tomcat.apache.org/download-connectors.cgi

注意，很多网站上都介绍是 JK2 ，可能是觉得 JK2 比 JK 要新吧，其实 JK2 已经停止研发了，建议使用 jk1.2 。

下载压缩包，之后将 module 目录中的 mod_jk-apache****.so 文件放入 /module/ 目录下。

3.3. 配置 Apache （ httpd.conf ）

3.3.1.     配置端口：

找到

Listen 80

改为

Listen **

当然如果不需要改的话，就不用改了。正常情况无须更改。

3.3.2.     配置 DocumentRoot

找到 DocumentRoot 段，将其改为：

DocumentRoot "E:/MyWebsite"

这里的 "E:/MyWebsite" 指的是你的 web 程序的根路径，视具体应用而定。

3.3.3.     配置 serverName

找到 serverName 这个段，将其配置为你的 ServerName

如果没有配置为域名，配为 IP 也可以，此处还不是很清楚，多虚拟主机的情况的配置。

3.3.4.     配置虚拟主机

<VirtualHost *:80>

    ServerAdmin flyffa@gmail.com

    DocumentRoot       E:/MyWebsite

    ServerName localhost

    DirectoryIndex index.html index.htm index.jsp

    ErrorLog logs/error_log

    CustomLog logs/access_log common

    ErrorDocument 404 /sys/logon.jsp

</VirtualHost>

3.4. 配置 JK 方式的负载均衡

3.4.1.     配置 module

我们需要与 tomcat 做连接，所以要把 tomcat 的 connector 的模块配置进去。

在 LoadModule 部分加入：

LoadModule jk_module modules/mod_jk-apache-2.0.55.so －加载模块

这个 so 是我下载的版本，个人可以根据自己下载的文件名加以配置

JkWorkersFile conf/workers.properties －指定 connector 的配置文件名称

JkLogFile logs/mod_jk.log －指定 connector 的日志文件名称

JkLogLevel info －指定 connector 的日志等级

3.4.2.     配置 worker 列表 (conf/workers.properties)

定义列表

worker.list=tomcat6,tomcat5,loadbalancer

定义一个名为 “loadbalancer” 的 worker

其作为对多个 Tomcat 进程的负载平衡使用：

worker.loadbalancer.type=lb

worker.loadbalancer.balanced_workers=tomcat5, tomcat6

（ 负载平衡类型的 worker 并不与 Tomcat worker 通讯，它负责管理这些 Tomcat worker 。 ）

定义多个 worker 列表

# Set properties for tomcat6 (ajp13)

worker.tomcat6.type=ajp13

worker.tomcat6.host=localhost

worker.tomcat6.port=8019

worker.tomcat6.lbfactor=50

worker.tomcat6.cachesize=10

worker.tomcat6.cache_timeout=600

worker.tomcat6.socket_keepalive=1

worker.tomcat6.reclycle_timeout=300

# Set properties for tomcat5 (ajp13)

worker.tomcat5.type=ajp13

worker.tomcat5.host=localhost

worker.tomcat5.port=8029

worker.tomcat5.lbfactor=50

worker.tomcat5.cachesize=10

worker.tomcat5.cache_timeout=600

worker.tomcat5.socket_keepalive=1

worker.tomcat5.reclycle_timeout=300

注意： lbfactor= 50 （ 当此 Tomcat worker 被用于一个负载平衡 worker 使用时，此属性将被使用。它定义了此 worker 的负载平衡权值。 ）

cachesize= 10 （ 当在多线程的 web server （例如 apache2.0 、 IIS 、 Netscape ）中使用 JK 时，此属性是有效的。如果将 cachesize 的值设置为较高的值，这些支持多线程的 web server 将获得很好的处理能力。如果此属性不被设置，则连接 cache 特性将失效。 ）

3.4.3.     配置 Apache 到 tomcat 的桥接

在 DocumnetRoot 片段下加入

JkMount /*.jsp tomcat6

JkMount /*.do tomcat6

JkMount /*Servlet tomcat6

这里只是简单的将 apache 的请求转到其中的一个 tomcat 中，形成桥接，至于负载均衡的时候，就无须进行这步操作，直接启动负载均衡。启动负载均衡见下一节。

3.4.4.     启动负载均衡

在 DocumnetRoot 片段下加入

JkMount /*.jsp loadbalancer

JkMount /*.do loadbalancer

JkMount /*Servlet loadbalancer

－指定对所有的请求启动负载均衡，这里的 loadbalancer 是定义的 worker 的名字

这里我在配置的时候犯了两个错误：

第一是没有配置 JkWorkersFile conf/workers.properties ，以为 Apache 会自动认识（其实 apache 是自动产生了一个叫做 ajp13 的 worker ，指向本机的 8009 端口）。

第二是以为 JkMount 语句中出现 loadbalancer,ajp13 之类的是系统设定的东西，其实都是在 workers.properties 文件中定义的，结果出现名字不匹配的情况。后来配置了 JkLogFile logs/mod_jk.log 之后看到错误日志才明白。

3.5. 配置 Proxy 方式的负载均衡

使用 Apache2.1 以上的版本，就可以用 mod_proxy_ajp 来完成负载均衡的配置，不过到目前为止，没有看到如何让 Apache 负责静态部分， tomcat 负责动态部分的配置方式，只能用 path 进行区分分发请求。如：在虚拟主机的配置中增加：

ProxyPass / ajp://localhost:8019/

ProxyPassReverse / ajp://localhost:8019/

而形如：

ProxyPass /*.jsp ajp://localhost:8019/

ProxyPassReverse /*.jsp ajp://localhost:8019/

这样的配置是不能通过的。

1、

PermGen space的全称是Permanent Generation space,是指内存的永久保存区域OutOfMemoryError: PermGen space从表面上看就是内存益出，解决方法也一定是加大内存。说说为什么会内存益出：这一部分用于存放Class和Meta的信息,Class在被 Load的时候被放入PermGen space区域，它和和存放Instance的Heap区域不同,GC(Garbage Collection)不会在主程序运行期对PermGen space进行清理，所以如果你的APP会LOAD很多CLASS的话,就很可能出现PermGen space错误。这种错误常见在web服务器对JSP进行pre compile的时候。

2、

在tomcat中redeploy时出现outofmemory的错误.

可以有以下几个方面的原因:

１,使用了proxool,因为proxool内部包含了一个老版本的cglib.

2, log4j,最好不用,只用common-logging

3, 老版本的cglib,快点更新到最新版。

４，更新到最新的hibernate3.2

PermGen space的全称是Permanent Generation space,是指内存的永久保存区域,
这块内存主要是被JVM存放Class和Meta信息的,Class在被Loader时就会被放到PermGen space中,
它和存放类实例(Instance)的Heap区域不同,GC(Garbage Collection)不会在主程序运行期对
PermGen space进行清理，所以如果你的应用中有很多CLASS的话,就很可能出现PermGen space错误,
这种错误常见在web服务器对JSP进行pre compile的时候。如果你的WEB APP下都用了大量的第三方jar, 其大小
超过了jvm默认的大小(4M)那么就会产生此错误信息了。
解决方法： 手动设置MaxPermSize大小

修改TOMCAT_HOME/bin/catalina.sh
在“echo "Using CATALINA_BASE:   $CATALINA_BASE"”上面加入以下行：
JAVA_OPTS="-server -XX:PermSize=64M -XX:MaxPermSize=128m
建议：将相同的第三方jar文件移置到tomcat/shared/lib目录下，这样可以达到减少jar 文档重复占用内存的目的。

二、java.lang.OutOfMemoryError: Java heap space
Heap size 设置
JVM堆的设置是指java程序运行过程中JVM可以调配使用的内存空间的设置.JVM在启动的时候会自动设置Heap size的值，
其初始空间(即-Xms)是物理内存的1/64，最大空间(-Xmx)是物理内存的1/4。可以利用JVM提供的-Xmn -Xms -Xmx等选项可
进行设置。Heap size 的大小是Young Generation 和Tenured Generaion 之和。
提示：在JVM中如果98％的时间是用于GC且可用的Heap size 不足2％的时候将抛出此异常信息。
提示：Heap Size 最大不要超过可用物理内存的80％，一般的要将-Xms和-Xmx选项设置为相同，而-Xmn为1/4的-Xmx值。
解决方法：手动设置Heap size
修改TOMCAT_HOME/bin/catalina.sh
在“echo "Using CATALINA_BASE:   $CATALINA_BASE"”上面加入以下行：
JAVA_OPTS="-server -Xms800m -Xmx800m   -XX:MaxNewSize=256m"

三、实例，以下给出1G内存环境下java jvm 的参数设置参考：

JAVA_OPTS="-server -Xms800m -Xmx800m  -XX:PermSize=64M -XX:MaxNewSize=256m -XX:MaxPermSize=128m -Djava.awt.headless=true "

三、相关资料

/show/3/7/20061112220131.htm

/show/3/7/20061112220054.htm

/show/3/7/20061112220201.htm

JVM 性能调整的一些基本概念

apache+Tomcat负载平衡设置详解[转]

java - the Java application launcher

JVM调优[转]

在整合Apache和Tomcat之后，发现该服务器的两个网站一个是静态的，一个是动态jsp的，设置总结如下

主要设置httpd.conf

1、DirectoryIndex的设置

如果多个虚拟站点中包含多种文件格式和文件名的首页文件，必须在这里全部出现

2、多个站点的定义如下

#NameVirtualHost *:80

#
# VirtualHost example:
# Almost any Apache directive may go into a VirtualHost container.
# The first VirtualHost section is used for requests without a known
# server name.
#
NameVirtualHost 220.231.32.*:80

<VirtualHost 220.231.32.*:80>
    ServerAdmin liubin@sina.com
    DocumentRoot /usr/local/tomcat/webapps/ronglian
    ServerName www.ronglian.com
    ErrorLog logs/ronglian.com-error_log
    CustomLog logs/ronglian.com-access_log common
</VirtualHost>

<VirtualHost 220.231.32.*:80>
    ServerAdmin wellboby@tom.com
    DocumentRoot /usr/local/wwwroot/chinaface
    ServerName www.chinaface.net
    ErrorLog logs/chinaface.net-error_log
    CustomLog logs/chinaface.net-access_log common
</VirtualHost>

！！ 在这里，NameVirtualHost的字段不能省略，否则起apache时报错：VirtualHost 220.231.32.*.80 overlaps with VirtualHost 220.231.32.*:80, the first has precedence, perhaps you need a NameVirtualHost directive——虽然apache能起，同错误描述一样，第二个站点的定义被第一个站点的定义所覆盖，即访问第二个站点指向的其实是第一个

！！ NameVirtualHost字段的端口号不能忽略，否则起apache时报错：VirtualHost 220.231.32.*:80 -- mixing * ports and non-* ports with a NameVirtualHost address is not supported, proceeding with undefined results
[Sun Jul 09 16:59:37 2006] [error] VirtualHost 220.231.32.*:80 -- mixing * ports and non-* ports with a NameVirtualHost address is not supported, proceeding with undefined results——apache不能起

！！如果VirtualHost 字段的端口号确实，起apache时报错：VirtualHost 220.231.32.28:0 -- mixing * ports and non-* ports with a NameVirtualHost address is not supported, proceeding with undefined results——但apache可以启动，访问也正常

Java代码

1. 127.0.0.1    localhost www.test.com www.service.test.com bbs.test.com bbs.service.test.com  

Java代码

1. <Host name="www.service.test.com" unpackWARs="true" autoDeploy="true"  
2. xmlValidation="false" xmlNamespaceAware="false"/>  

<Host name="www.service.test.com" unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false"/>

Java代码

1. <Context docBase="/home/mahaibo/app/test"  
2. privileged="true" antiResourceLocking="false" antiJARLocking="false">  
3. </Context>  

<Context docBase="/home/mahaibo/app/test"
privileged="true" antiResourceLocking="false" antiJARLocking="false">
</Context>

Java代码

1. <Host name="bbs.service.test.com" unpackWARs="true" autoDeploy="true"  
2. xmlValidation="false" xmlNamespaceAware="false"/>  

<Host name="bbs.service.test.com" unpackWARs="true" autoDeploy="true"
xmlValidation="false" xmlNamespaceAware="false"/>

Java代码

1. <Context docBase="/home/mahaibo/app/bbs"  
2. privileged="true" antiResourceLocking="false" antiJARLocking="false">  
3. </Context>  

<Context docBase="/home/mahaibo/app/bbs"
privileged="true" antiResourceLocking="false" antiJARLocking="false">
</Context>

Java代码

1. LoadModule proxy_module modules/mod_proxy.so  
2. LoadModule proxy_ajp_module modules/mod_proxy_ajp.so  
3. LoadModule proxy_balancer_module modules/mod_proxy_balancer.so  
4. LoadModule proxy_connect_module modules/mod_proxy_connect.so  
5. LoadModule proxy_http_module modules/mod_proxy_http.so  
6. LoadModule proxy_ftp_module modules/mod_proxy_ftp.so  

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_ajp_module modules/mod_proxy_ajp.so
LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
LoadModule proxy_connect_module modules/mod_proxy_connect.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule proxy_ftp_module modules/mod_proxy_ftp.so

Java代码

1. NameVirtualHost *:80  
2. <VirtualHost *:80>  
3. ServerName www.test.com  
4. ProxyIOBufferSize 8192  
5. ProxyRequests Off  
6. ProxyVia Full  
7. ProxyPass / http://www.service.test.com:8080/ smax=5 max=20 ttl=120 retry=300  
8. </VirtualHost>  
9.   
10. <VirtualHost *:80>  
11. ServerName bbs.test.com  
12. ProxyIOBufferSize 8192  
13. ProxyRequests Off  
14. ProxyVia Full  
15. ProxyPass / http://bbs.service.test.com:8088/ smax=5 max=20 ttl=120 retry=300  
16. </VirtualHost>  

NameVirtualHost *:80
<VirtualHost *:80>
ServerName www.test.com
ProxyIOBufferSize 8192
ProxyRequests Off
ProxyVia Full
ProxyPass / http://www.service.test.com:8080/ smax=5 max=20 ttl=120 retry=300
</VirtualHost>
<VirtualHost *:80>
ServerName bbs.test.com
ProxyIOBufferSize 8192
ProxyRequests Off
ProxyVia Full
ProxyPass / http://bbs.service.test.com:8088/ smax=5 max=20 ttl=120 retry=300
</VirtualHost>

Java代码

1. ./apachectl start  

自动化配置的前提是只有一个 Tomcat 实例和 Apache 在同一台机器上运行。自动化配置是通过在 Tomcat 的配置文件 server.xml 中的 Engine 元素中添加相应的 ApacheConfig 监听器(Listener)来实现的。

下面是具体的配置：

第一步：下载并安装 Apache httpd和 Tomcat

下载并安装 Apache 2.2.9 和 Tomcat 5.5.26，假设他们的安装目录如下：

D:/apps/Apache/Apache2.2

D:/apps/Apache/apache-tomcat-5.5.26

这两个服务器可以在以下地址下载：

Tomcat:

http://apache.osuosl.org/tomcat/tomcat-5/v5.5.26/bin/apache-tomcat-5.5.26.zip

Apache:

http://apache.osuosl.org/httpd/binaries/win32/apache_2.2.9-win32-x86-openssl-0.9.8h-r2.msi

第二步：下载并安装 mod_jk.so

mod_jk 的下载地址如下：

http://apache.osuosl.org/tomcat/tomcat-connectors/jk/binaries/win32/jk-1.2.26/mod_jk-1.2.26-httpd-2.2.4.so

下载后将其重命名并复制到到 D:/apps/Apache/Apache2.2/modules 下

第三步：创建 workers.properties 文件

workers.properties 定义了每个 worker 的类型、协议、端口等信息。如果手上没有现成的配置文件，可以使用以下最简单的配置：

# Define 1 real worker using ajp13

worker.list=worker1

# Set properties for worker1 (ajp13)

worker.worker1.type=ajp13

worker.worker1.host=localhost

worker.worker1.port=8009

将这个文件放在 Tomcat 下的 conf/jk 目录中，如果放在其他地方，则需要在 server.xml 的配置中明确指定。

第四步：修改 Tomcat server.xml 文件

找到下面这行内容并在后面添加配置信息：

   <Engine name="Catalina" defaultHost="localhost">

配置信息如下：

    <Listener className="org.apache.jk.config.ApacheConfig"

       workersConfig="conf/workers.properties"

       modJk="D:/apps/Apache/Apache2.2/modules/mod_jk.so"

       jkLog="logs/mod_jk.log"

       jkDebug="info"

       jkWorker="worker1"

       noRoot="true"

    />

其中：

• workersConfig 是 workers.properties 的位置，这里我没有使用默认的位置，所以在此明确说明了。

• modJk：定义了 mod_jk.so 的具体位置

• jkLog 定义了 mod_jk.log 的位置，这里是 tomcat 下的 logs 目录

• jkDebug：定义日志级别，可以使用的级别有：debug, info, error, 或者 emerg，默认为 emerg

• jkWorker：定义 worker 的名称，必须是在 workers.properties 中定义过的名称，否则可能会出现 internal server error 的错误

• noRoot：如果为 true，则根目录不会映射到 Tomcat 的根目录，false 则映射到 Tomcat 根目录，如果是 false 的话，http://localhost/ 会打开 Tomcat 的欢迎页面（ROOT）

第五步：修改 Apache httpd.conf 文件

找到 httpd.conf 文件并在最后加上如下配置：

#To be added at the end of your httpd.conf

Include $TOMCAT_HOME/conf/auto/mod_jk.conf

要注意的是，这里 Include 后面的路径必须正确，这里 $TOMCAT_HOME 是 Tomcat 安装目录，D:/apps/Apache/apache-tomcat-5.5.26。

第六步：重启 Tomcat 并自动生成 mod_jk.conf

重启 Tomcat，重启成功后会在其 conf 下面生成 mod_jk.conf 文件，这个配置文件就是在 httpd.conf 中要用到的那个，这个文件的路径必须和在 httpd.conf 中的一致。下面是生成的一个mod_jk.conf：

########## Auto generated on Sun Jun 29 11:21:57 CST 2008##########

<IfModule !mod_jk.c>

 LoadModule jk_module "D:/apps/Apache/Apache2.2/modules/mod_jk.so"

</IfModule>

JkWorkersFile "D:/apps/Apache/apache-tomcat-5.5.26/conf/workers.properties"

JkLogFile "D:/apps/Apache/apache-tomcat-5.5.26/logs/mod_jk.log"

JkLogLevel info

<VirtualHost localhost>

    ServerName localhost

    JkMount /webdav worker1

    JkMount /webdav/* worker1

    JkMount /servlets-examples worker1

    JkMount /servlets-examples/* worker1

    JkMount /tomcat-docs worker1

    JkMount /tomcat-docs/* worker1

    JkMount /jsp-examples worker1

    JkMount /jsp-examples/* worker1

    JkMount /balancer worker1

    JkMount /balancer/* worker1

</VirtualHost>

第七步：启动 Apache 并测试配置

Apache 启动完成后，测试如下地址：

http://localhost/jsp-examples

如果页面能正常显示，说明配置成功！如果出现 internal server error 之类的错误，说明上面的配置有误，需要检查并测试。

Table of Contents

• What is mod_jk?
• Why mod_jk?
• What does it mean to me?
• Definitions and Terminology
• Obtaining mod_jk
  • mod_jk Binaries
  • Building mod_jk
  • Building mod_jk for NT
  • Building mod_jk for Unix
• Configuring Apache
  • Removing mod_jserv directives
  • Configuring Apache to use mod_jk
  • Assigning URLs to be redirected to Tomcat
• Configuring Tomcat
  • Enabling Tomcat's Apache Auto-Config
  • Configuring Tomcat to use the AJPv13 Protocol
  • Defining Workers
• Example Configuration
• Troubleshooting and F.A.Q's
• Credits

What is mod_jk?

mod_jk is a replacement to the elderly mod_jserv. It is a completely new Tomcat-Apache plug-in that handles the communication between Tomcat and Apache.

Why mod_jk?

Several reasons:

• mod_jserv was too complex. Because it was ported from Apache/JServ, it brought with it lots of JServ specific bits that aren't needed by Apache.
• mod_jserv supported only Apache. Tomcat supports many web servers through a compatibility layer named the jk library. Supporting two different modes of work became problematic in terms of support, documentation and bug fixes. mod_jk should fix that.
• The layered approach provided by the jk library makes it easier to support both Apache1.3.x and Apache2.xx.
• Better support for SSL. mod_jserv couldn't reliably identify whether a request was made via HTTP or HTTPS. mod_jk can, using the newer Ajpv13 protocol.

What does it mean to me?

You will need to get to know a new simplified configuration mechanism. The advantage is that learning this mechanism will give you a head start if you want to deploy Tomcat on Apache and other web servers, such as Microsoft's Internet Information Server (IIS) and the iPlanet Enterprise Web Server.

Definitions and Terminology

In this document I am going to use a few terms, so let's define them:

Obtaining mod_jk

mod_jk can be obtained in two formats - binary and source.  Depending on the platform you are running your web server on, a binary version of mod_jk may be available.  It is recommended to use the binary version if one is available.  If the binary is not available, follow the instructions for building mod_jk from source.  Notes at the end of this section offer recommendations for specific platforms.

mod_jk Binaries

Binaries for mod_jk are available for several platforms in the same area as the Tomcat Binary Release.  The binaries are located in subdirectories by platform.  For some platforms, such as Windows, this is the typical way of obtaining mod_jk since most Windows systems do not have C compilers.  For others, the binary distribution of mod_jk offers simpler installation.

For example, the Tomcat 3.3 M1 Release at http://jakarta.apache.org/builds/jakarta-tomcat/release/v3.3-m1/bin/ contains the following:

Check the site for the latest binaries.

Note: The version of mod_jk is not dependent on the version of Tomcat.  The Tomcat 3.3 distribution of mod_jk will function correctly with other 3.x versions of Tomcat, such as Tomcat 3.2.1.

Building mod_jk

mod_jk is available in source distribution for all Windows and most Unix platforms.  The source for mod_jk is included in the Binary Distribution of Tomcat in the TOMCAT_HOME/native/mod_jk/ directory.  This directory is organized by Web Server name and version.  Each directory contains the source as well as the appropriate build scripts, make files, or project files.

Building mod_jk for NT

The redirector was developed using Visual C++ version 6.0, so having this environment is a prerequisite if you want to perform a custom build.

The steps that you need to take are:

1. Change directory to the apache1.3 or apache2.0 source directory depending on your version of Apache.
2. Set an APACHE1_HOME environment variable which points to where your Apache is installed.
3. Execute the following command:
   
   MSDEV mod_jk.dsp /MAKE ALL
   
   If msdev is not in your path, enter the full path to msdev.exe. Also, ApacheCore.lib is expected to exist in the APACHE1_HOME"src"CoreD and APACHE1_HOME"src"CoreR directories before linking will succeed. You will need to build enough of the Apache source to create these libraries.
4. Copy mod_jk.dll to Apache's modules directory.

This will build both release and debug versions of the redirector plug-in (mod_jk).

An alternative will be to open mod_jk.dsp in msdev and build it using the build menu.

Building mod_jk for Unix

Apache

1. Make sure your Apache has DSO support. You can check this with $APACHE_HOME/bin/httpd -l. If you see "mod_so.c" in the output, DSO support is available. If it's missing, you may have to recompile or reinstall Apache.
2. Find out whether your Apache has EAPI support. If you compiled it yourself from source, EAPI is probably not compiled in, unless you added it yourself (perhaps with mod_ssl). You need to build mod_jk.so with or without EAPI to match your Apache configuration. If you install a mismatched mod_jk.so, $APACHE_HOME/bin/apachectl configtest will warn you.
3. Make sure you have Perl 5 installed. The apxs script used to build the module is written in Perl.
4. Change directory to TOMCAT_HOME/native/mod_jk/apache1.3 (or apache2.0).

5. Build mod_jk.so. Following are three techniques you can try, in order of simplicity:

   1. Run the build script for your platform.  If a build script is not available for your platform, you may be able to build mod_jk using ./build-unix.sh. This script will set some variables, call apxs as below, and try to copy mod_jk.so to $APACHE_HOME/libexec. If it fails, you need to do the following manually:
      • set JAVA_HOME in your shell, e.g. "set JAVA_HOME=/usr/local/jdk1.2.2; export JAVA_HOME"
      • set APACHE_HOME in your shell, e.g. "set APACHE_HOME=/usr/local/apache; export APACHE_HOME"
      • uncomment the following line in the build-unix.sh file, replacing "linux" with the name of your platform as specified in the Java include directory for your installation

        # JAVA_INCLUDE="-I ${JAVA_HOME}/include -I ${JAVA_HOME}/include/linux"

   2. If build-unix.sh fails, you may have better luck with the Makefiles in the same directory, e.g. "make -f Makefile.linux mod_jk.so"

   3. Finally, you can try to build it manually. Run the apxs command that came with your apache distribution (hint: look in /usr/local/apache/bin, /usr/sbin, or wherever you installed apache). Type the command all on one line.

      ---

      For Linux:

      apxs -o mod_jk.so -I../jk -I/usr/local/jdk/include -I/usr/local/jdk/include/linux -c *.c ../jk/*.c

      Your build may fail because the object files from the ../jk directory have been compiled to the current directory, rather than their source directory. Running gcc -shared -o mod_jk.so *.o should finish the build.

      ---

      For Solaris:

      Use the build-solaris.sh script as follows:

      # sh build-solaris.sh

      This will build and install mod_jk.so in your apache/libexec directory.  This script contains settings for your Java and Apache home locations.  Make sure that these are set according to your installation.  The default settings are JAVA_HOME=/usr/java and APACHE_HOME=/usr/local/apache.  If your installation is different, you will need to edit the build-solaris.sh script and change these values appropriately.

      See README.solaris located in TOMCAT_HOME/native/mod_jk/apache1.3 for more information.

      If the build script does not work, you can also build mod_jk as follows:

      $APACHE_HOME/bin/apxs -o mod_jk.so -DSOLARIS -I../jk -I/usr/java/include -I/usr/java/include/solaris -c *.c ../jk/*.c

      On some systems, this will build the module correctly, but will fail at runtime with a "symbol "fdatasync" not found". To fix, add -lposix4 just before the -c in the above command.

      ---

      For HP-UX 11.00:

      Use the build-hpux.sh script as follows:

      # sh build-hpux.sh

      This will build and install mod_jk.so in your apache/libexec directory.  This script contains settings for your Java and Apache home locations.  Make sure that these are set according to your installation.  The default settings are JAVA_HOME=/opt/java1.3 and APACHE_HOME=/usr/local/apache.  If your installation is different, you will need to edit the build-hpux.sh script and change these values appropriately.

      Also note that there are two HP-UX build scripts.  One script was written to build mod_jk without JNI support using GNU GCC.  The other script builds mod_jk with JNI support, however, this script requires the HP ANSI C Compiler (not the stripped down C compiler included with HP-UX to rebuild the kernel).  The HP Compiler is required because the dlopen() and related shared libraries are only available for 64-bit applications and reliable 64-bit compilation is not available with the current version of GCC.

      The build-hpux.sh script should also work for HP-UX 10.00.

      See README.hpux located in TOMCAT_HOME/native/mod_jk/apache1.3 for more information.

      ---

      For other Unixes (including FreeBSD):

      You may need to replace fdatasync() with fsync() in jk_util.c.

      The build-hpux-cc.sh script should be modifiable for IRIX and AIX.  Edit the script and change the APACHE_HOME and JAVA_HOME locations as required.

      ---

      If you are using EAPI, try adding -DEAPI to the apxs command after mod_jk.so.

      If apxs fails with apxs:Break: Command failed with rc=255, it may have been damaged by mod_ssl. Search for:

      my $CFG_LD_SHLIB      = q();          # substituted via Makefile.tmpl
      
              my $CFG_LDFLAGS_SHLIB = q(); # substituted via Makefile.tmpl
      
              

      and change to:

      my $CFG_LD_SHLIB      = q(ld);          # substituted via Makefile.tmpl
      
              my $CFG_LDFLAGS_SHLIB = q(-G); # substituted via Makefile.tmpl
      
              

      If you've installed Java in another directory, adjust accordingly.

      For other Unixes you should be able to work it out, but remember that the order of the arguments to apxs is important!.

6. Now, copy the mod_jk library.  # cp mod_jk.so $APACHE_HOME/libexec. (Note that the build scripts attempt to do this, but you may have to su first.)

Other Webservers

There are several Makefiles in the other directories under the TOMCAT_HOME/native/mod_jk/ directory.  You should also check the Tomcat documentation for specific information related to other web servers.

Configuring Apache

This section details the configuration that is required for the Apache Web Server to support mod_jk.

Removing mod_jserv directives

If you've previously configured Apache to use mod_jserv, remove any ApJServMount directives from your httpd.conf. If you're including tomcat-apache.conf or tomcat.conf, you'll want to remove them as well - they are specific to mod_jserv.  The mod_jserv configuration directives are not compatible with mod_jk!

Configure Apache to use mod_jk

Assigning URLs to Tomcat

JkMount <URL prefix> <Worker name>

Configuring Tomcat

Enabling Tomcat's Apache Auto-Config

(Optional) Configuring Tomcat to use the Ajpv13 protocol

(Optional) Defining "workers"

Configuring workers manually.

Example Configuration

Troubleshooting and F.A.Q.s

Q. Where can I get help/support for mod_jk?

For additional help, the best resource is the Tomcat Users Discussion list.  You should start by searching the mail list archives located at http://mikal.org/interests/java/tomcat/index.html before you post questions to the list.  If you are unable to locate the answer to your question in the archive, you can post questions about Tomcat or mod_jk to the user list for assistance.  Make sure that you include the version of Apache and Tomcat that you are using as well as the platform you are running on. http://jakarta.apache.org/site/mail.html

Q. I can't find mod_jk anywhere. Where is it?

Q. Which protocol should I use? Ajp12 or Ajp13?

Q. Whenever I restart Tomcat, Apache locks up!

Q. Why did exist two files mod_jk.so (-eapi ad -noeapi) in download dir for Linux ?

Q. What's that message about 'garbled DSO ?'

Q. And the message about 'module might crash under EAPI! '

Q. Where can I get more information?

Q. APXS is getting an error during the build of mod_jk, like rc=0 or rc=255.  I tried all of the steps in the build section, what do I do now?

# cd /usr/local/src

# gzip -dc apache_1.3.19.tar.gz|tar xvf -

# cd apache_1.3.19

# ./configure --prefix=/usr/local/apache "

--enable-module=most "

--enable-shared=max

# make

# make install

Note: The above steps assume that you downloaded the Apache source and placed it in your /usr/local/src directory.

Credits

This document was originally created by Gal Shachor

Revisions by (Alphabetical)

Mike Braden <mikeb@mwbinc.com>
Mike Bremford
Chris Pepper

With help from countless others on the tomcat-dev and tomcat-user lists!

Copyright ©1999-2001 The Apache Software Foundation
Legal Stuff They Make Us Say
Contact Information

首先我们先介绍一下为什么要让 Apache 与 Tomcat 之间进行连接。事实上 Tomcat 本身已经提供了 HTTP 服务，该服务默认的端口是 8080，装好 tomcat 后通过 8080 端口可以直接使用 Tomcat 所运行的应用程序，你也可以将该端口改为 80。

既然 Tomcat 本身已经可以提供这样的服务，我们为什么还要引入 Apache 或者其他的一些专门的 HTTP 服务器呢？原因有下面几个：

1. 提升对静态文件的处理性能

2. 利用 Web 服务器来做负载均衡以及容错

3. 无缝的升级应用程序

这 三点对一个 web 网站来说是非常之重要的，我们希望我们的网站不仅是速度快，而且要稳定，不能因为某个 Tomcat 宕机或者是升级程序导致用户访问不了，而能完成这几个功能的、最好的 HTTP 服务器也就只有 apache 的 http server 了，它跟 tomcat 的结合是最紧密和可靠的。

接下来我们介绍三种方法将 apache 和 tomcat 整合在一起。

JK

这是最常见的方式，你可以在网上找到很多关于配置JK的网页，当然最全的还是其官方所提供的文档。JK 本身有两个版本分别是 1 和 2，目前 1 最新的版本是 1.2.19，而版本 2 早已经废弃了，以后不再有新版本的推出了，所以建议你采用版本 1。

JK 是通过 AJP 协议与 Tomcat 服务器进行通讯的，Tomcat 默认的 AJP Connector 的端口是 8009。JK 本身提供了一个监控以及管理的页面 jkstatus，通过 jkstatus 可以监控 JK 目前的工作状态以及对到 tomcat 的连接进行设置，如下图所示：

在 这个图中我们可以看到当前JK配了两个连接分别到 8109 和 8209 端口上，目前 s2 这个连接是停止状态，而 s1 这个连接自上次重启后已经处理了 47 万多个请求，流量达到 6.2 个 G，最大的并发数有 13 等等。我们也可以利用 jkstatus 的管理功能来切换 JK 到不同的 Tomcat 上，例如将 s2 启用，并停用 s1，这个在更新应用程序的时候非常有用，而且整个切换过程对用户来说是透明的，也就达到了无缝升级的目的。关于 JK 的配置文章网上已经非常多了，这里我们不再详细的介绍整个配置过程，但我要讲一下配置的思路，只要明白了配置的思路，JK 就是一个非常灵活的组件。

JK 的配置最关键的有三个文件，分别是

httpd.conf
Apache 服务器的配置文件，用来加载 JK 模块以及指定 JK 配置文件信息

workers.properties
到 Tomcat 服务器的连接定义文件

uriworkermap.properties
URI 映射文件，用来指定哪些 URL 由 Tomcat 处理，你也可以直接在 httpd.conf 中配置这些 URI，但是独立这些配置的好处是 JK 模块会定期更新该文件的内容，使得我们修改配置的时候无需重新启动 Apache 服务器。

其中第二、三个配置文件名都可以自定义。下面是一个典型的 httpd.conf 对 JK 的配置

# (httpd.conf)

            # 加载 mod_jk 模块

            LoadModule jk_module modules/mod_jk.so

            

            #

            # Configure mod_jk

            #

            

            JkWorkersFile conf/workers.properties

            JkMountFile conf/uriworkermap.properties

            JkLogFile logs/mod_jk.log

            JkLogLevel warn

            

接下来我们在 Apache 的 conf 目录下新建两个文件分别是 workers.properties、uriworkermap.properties。这两个文件的内容大概如下

#

            # workers.properties

            #

            

            

            # list the workers by name

            

            worker.list=DLOG4J, status

            

            # localhost server 1

            # ------------------------

            worker.s1.port=8109

            worker.s1.host=localhost

            worker.s1.type=ajp13

            

            # localhost server 2

            # ------------------------

            worker.s2.port=8209

            worker.s2.host=localhost

            worker.s2.type=ajp13

            worker.s2.stopped=1

            

            worker.DLOG4J.type=lb

            worker.retries=3

            worker.DLOG4J.balanced_workers=s1, s2

            worker.DLOG4J.sticky_session=1

            

            worker.status.type=status

            

以上的 workers.properties 配置就是我们前面那个屏幕抓图的页面所用的配置。首先我们配置了两个类型为 ajp13 的 worker 分别是 s1 和 s2，它们指向同一台服务器上运行在两个不同端口 8109 和 8209 的 Tomcat 上。接下来我们配置了一个类型为 lb（也就是负载均衡的意思）的 worker，它的名字是 DLOG4J，这是一个逻辑的 worker，它用来管理前面配置的两个物理连接 s1 和 s2。最后还配置了一个类型为 status 的 worker，这是用来监控 JK 本身的模块。有了这三个 worker 还不够，我们还需要告诉 JK，哪些 worker 是可用的，所以就有 worker.list = DLOG4J, status 这行配置。

接下来便是 URI 的映射配置了，我们需要指定哪些链接是由 Tomcat 处理的，哪些是由 Apache 直接处理的，看看下面这个文件你就能明白其中配置的意义

/*=DLOG4J

            /jkstatus=status

            

            !/*.gif=DLOG4J

            !/*.jpg=DLOG4J

            !/*.png=DLOG4J

            !/*.css=DLOG4J

            !/*.js=DLOG4J

            !/*.htm=DLOG4J

            !/*.html=DLOG4J

            

相信你已经明白了一大半了：所有的请求都由 DLOG4J 这个 worker 进行处理，但是有几个例外，/jkstatus 请求由 status 这个 worker 处理。另外这个配置中每一行数据前面的感叹号是什么意思呢？感叹号表示接下来的 URI 不要由 JK 进行处理，也就是 Apache 直接处理所有的图片、css 文件、js 文件以及静态 html 文本文件。

通过对 workers.properties 和 uriworkermap.properties 的配置，可以有各种各样的组合来满足我们前面提出对一个 web 网站的要求。您不妨动手试试！

回页首

http_proxy

这是利用 Apache 自带的 mod_proxy 模块使用代理技术来连接 Tomcat。在配置之前请确保是否使用的是 2.2.x 版本的 Apache 服务器。因为 2.2.x 版本对这个模块进行了重写，大大的增强了其功能和稳定性。

http_proxy 模式是基于 HTTP 协议的代理，因此它要求 Tomcat 必须提供 HTTP 服务，也就是说必须启用 Tomcat 的 HTTP Connector。一个最简单的配置如下

ProxyPass /images !

            ProxyPass /css !

            ProxyPass /js !

            ProxyPass / http://localhost:8080/

            

在这个配置中，我们把所有 http://localhost 的请求代理到 http://localhost:8080/ ，这也就是 Tomcat 的访问地址，除了 images、css、js 几个目录除外。我们同样可以利用 mod_proxy 来做负载均衡，再看看下面这个配置

ProxyPass /images !

            ProxyPass /css ! 

            ProxyPass /js !

            

            ProxyPass / balancer://example/

            <Proxy balancer://example/>

            BalancerMember http://server1:8080/

            BalancerMember http://server2:8080/

            BalancerMember http://server3:8080/

            </Proxy>

            

配置比 JK 简单多了，而且它也可以通过一个页面来监控集群运行的状态，并做一些简单的维护设置。

回页首

ajp_proxy

ajp_proxy 连接方式其实跟 http_proxy 方式一样，都是由 mod_proxy 所提供的功能。配置也是一样，只需要把 http:// 换成 ajp:// ，同时连接的是 Tomcat 的 AJP Connector 所在的端口。上面例子的配置可以改为：

ProxyPass /images !

            ProxyPass /css ! 

            ProxyPass /js !

            

            ProxyPass / balancer://example/

            <Proxy balancer://example/>

            BalancerMember ajp://server1:8080/

            BalancerMember ajp://server2:8080/

            BalancerMember ajp://server3:8080/

            </Proxy>

            

采用 proxy 的连接方式，需要在 Apache 上加载所需的模块，mod_proxy 相关的模块有 mod_proxy.so、mod_proxy_connect.so、mod_proxy_http.so、mod_proxy_ftp.so、 mod_proxy_ajp.so， 其中 mod_proxy_ajp.so 只在 Apache 2.2.x 中才有。如果是采用 http_proxy 方式则需要加载 mod_proxy.so 和 mod_proxy_http.so；如果是 ajp_proxy 则需要加载 mod_proxy.so 和 mod_proxy_ajp.so这两个模块。

回页首

三者比较

相 对于 JK 的连接方式，后两种在配置上是比较简单的，灵活性方面也一点都不逊色。但就稳定性而言就不像 JK 这样久经考验，毕竟 Apache 2.2.3 推出的时间并不长，采用这种连接方式的网站还不多，因此，如果是应用于关键的互联网网站，还是建议采用 JK 的连接方式。

参考资料

• 获得 Apache Http Server。
  
  
• 获得 Apache Tomcat。
  
  
• JK 文档。

关于作者

		刘冬，一直使用 J2EE/J2ME 从事移动互联网方面的开发。您可以通过 Java 自由人网站来跟他联系，网址是：http://www.dlog.cn/javayou ，另外他的邮件地址是javayou@gmail.com。

JBoss 4.0.4GA环境变量

    JBOSS_HOME                                        JBoss的位置
    JAVA                                                         Java运行程序的位置
    JAVA_OPTS                                            JVM启动参数
    MAX_FD                                                  JBoss能够使用文件描述符的最大数量（仅用于Un*x）