j2ee doc 之 配置指南www.goodsgy.com

关键词：Javawww.goodsgy.com

声明：本文档由freehero翻译，未经作者同意不能用于商业用途，您可以自由的复制和传播，文档只供您理解j2ee，因作者能力有限，建议您同时阅读英文文档，对于因为翻译的错误代来的后果作者不负任何责任，欢迎您来信讨论freehero@163.net www.goodsgy.com

j2ee配置指南www.goodsgy.com

1。介绍
本文介绍j2ee环境的配置，所有涉及的文件都在j2ee安装目录下的oncfig目录，这些文件都是文本文件，www.goodsgy.com

你可以有任意的文本编辑器来编辑它们。
通常情况下，你没有改变这些文件的必要。但是如果你使用的数据库驱动不是cloudscape的时候，你需要www.goodsgy.com

遵循本章的内容进行配置。www.goodsgy.com

2。JDBC驱动
默认的j2ee安装后支持cloudscape数据库（一个sun公司提供的演示数据库），如果你的ejb使用的jdbc不www.goodsgy.com

是连接cloudscape数据库，那么你需要按照下面的知道进行配置。（如果你不能确定本版本的j2ee支持你使用www.goodsgy.com

的jdbc驱动，请到 11111 看相关信息。）www.goodsgy.com

3。驱动的位置
你必须把驱动文件（.jar文件）copy到 $J2EE_HOME/lib/system目录下。并且保证该文件包含在www.goodsgy.com

J2EE_CLASSPATH 的环境变量中。www.goodsgy.com

4。J2EE_CLASSPATH 环境变量
j2ee server通过JDBC驱动连接数据库。通通过J2EE_CLASSPATH 的环境变量定位驱动文件（.jar文件）的位www.goodsgy.com

置。你可以在启动j2ee前在命令行设置这个变量。但是我们推荐你在脚本中设置J2EE_CLASSPATH 变量。编辑用www.goodsgy.com

户配置文件在安装的过程中是必须的一步。在unix中，用户配置文件是 /bin/userconfig.sh，windows nt中是www.goodsgy.com

bin/userconfig.bat
注意：你应该同时在CLASSPATH环境变量中去掉驱动文件（.jar文件）。www.goodsgy.com

5。JDBC 1.0 驱动
为了配置jdbc1.0驱动，编辑config/default.properties 文件的jdbc.drivers 和 jdbc.datasources两个www.goodsgy.com

属性值。再次要注意的是驱动文件必须包含在J2EE_CLASSPATH环境变量中。
jdbc.drivers 属性

jdbc.drivers 属性的值是有一系列的冒号分割的jdbc驱动的类名。格式如下：
jdbc.drivers=<classname>:<classname>: . . .
例如：
jdbc.drivers=oracle.jdbc.driver.OracleDriver:testutil.MyDriver

jdbc.datasources 属性值

jdbc.datasources 属性值由两部分组成，一个是datasource的jndi的名字，一个是数据库的url。典型的www.goodsgy.com

情况是：jndi名字是数据库的逻辑名字，rul指定数据库的实际位置。jndi名字和url都是在ejb编码的过程中指www.goodsgy.com

定的。rul的格式，请参照jdbc驱动提供商的文档。
jdbc.datasources 的语法如下：
jdbc.datasources=<jndi_datasource>|<url>|<jndi_datasource>|<url>. . .
|符号有两个作用。第一，它隔开几个jndi_datasource；第二，它隔开每一个jndi_datasource中的www.goodsgy.com

jndi_datasource> 和 <url> 元素.
jndi_datasource元素的语法如下：
jdbc/<jndi_name>
由jdbc关键字开头，jndi_name是在jndi目录中指定的datasouce名字。
例如：
jdbc.datasources=jdbc/Oracle|jdbc:oracle:thin@rtc:1521:acct|jdbc/MyDB|jdbc:testwww.goodsgy.com

6。支持JTA的JDBC2.0驱动
配置JTA的JDBC2.0的驱动，你需要设置以下属性的值：
jdbc20.datasources
xadatasource.<n>.jndiname
xadatasource.<n>.classname
xadatasource.<n>.dbuser
xadatasource.<n>.dbpassword
xadatasource.<n>.prop.<property-name>
同时你也必须在J2EE_CLASSPATH 环境变量中包括jdbc驱动文件。www.goodsgy.com

jdbc20.datasources 属性
jdbc20.datasources 属性的值和jndi名字连接，用于定位datasouce的位置（它就是lookup方法的参数）www.goodsgy.com

。
jdbc20.datasources 的语法如下：
www.goodsgy.com

jdbc20.datasources=<jndi_datasource>|<jndi_XA_datasource>|<jndi_datasource>|<jndi_XA_datasource> www.goodsgy.com

|的作用有两个，第一，隔开jndi_datasource 和<jndi_XA_datasource>并组成一对，第二，隔开每一对的www.goodsgy.com

jndi_datasource> 、<jndi_XA_datasource>元素。
<jndi_datasource> 和 jndi_XA_datasource有相同的语法：
jdbc/<jndi_name>
jdbc关键字开头。jndi_name是datasource名字，这个名字指向jndi目录。
例如：
jdbc20.datasources=jdbc/Merant|jdbc/XAMerant|jdbc/Finch|jdbc/XAFinchwww.goodsgy.com

xadatasource属性
xadatasource.<n>.jndiname 属性指定XA DataSource的jndi名字。语法如下：
xadatasource.<n>.jndiname=jdbc/<jndi_XA_datasource>
n代表每一组xadatasource。第一个jdbc2.0驱动n为0，下一个是1，2等等。jndi_XA_datasource元素和www.goodsgy.com

jdbc20.datasources 指定的值对应。
The xadatasource.<n>.dbuser 和 xadatasource.<n>.dbpassword 属性指定数据库用户和密码。通常该用www.goodsgy.com

户具有管理员的权限（更多的信息请看 2222 The distributed.transaction.recovery ）。
xadatasource.<n>.prop.<property_name> 指定和特定的属性值关联的值。实际的值可能是jdbc驱动。
例如：
xadatasource.0.jndiname=jdbc/XAMerant
xadatasource.0.classname=com.merant.sequelink.jdbcx.datasource.SequeLinkDataSource
xadatasource.0.prop.url=jdbc:sequelink://mypc:5000/[Oracle]www.goodsgy.com

7。事务www.goodsgy.com

你可以编辑config/default.properties 文件控制事务发生和超时设置。
distributed.transaction.recovery 属性
这个属性控制分布事物是否发生。入这些事物可以发生的化，下面的条件必须满足：
跨库操作时的事物范围。
j2ee程序通过jdbc2.0 JTA驱动访问数据库
当故障发生的时候，事物的各个的组成部分可以按照符合两段提交协议的方式提交或回滚。
事物发生的时候，server重新启动后事物可以提交或回滚。
distributed.transaction.recovery的值为true或者false。j2ee安装后默认为false。
distributed.transaction.recovery=falsewww.goodsgy.com

transaction.time属性
在应用container-managed 事物的ejb中，你可以控制事物超时的间隔通过设置transaction.timeout的值www.goodsgy.com

。例如：
transaction.timeout=5
在设置以后，如果事物在5秒内没有完成，j2ee事物管理器将回滚它。
当j2ee第一次安装的时候，timeout的值时0代表没有超时。
只有使用container-managed 管理事物的ejb受到timeout的影响。至于在bean-managed和JTA www.goodsgy.com

transactions 中你可以引用 UserTransaction 的 setTransactionTimeout方法。同时你也可以在其他组建中www.goodsgy.com

引用setTransactionTimeout方法：比如servlets和JSP。www.goodsgy.com

8。端口www.goodsgy.com

j2ee需要tcp/ip端口。修改config目录下的相应文件可以修改端口号。下表是端口号和相应的文件。www.goodsgy.com

EJB 9191 ejb.properties http.port=9191
HTTP 8000 web.properties port=8000
HTTPS 7000 web.properties https.port=7000
Naming and Directory 1050 orb.properties port=1050 www.goodsgy.com

9191 端口用于提供client下载需要的stub类
8000 提供http服务
7000 提供https服务
1050 基于orb的jndi名字服务使用的端口www.goodsgy.com

9。日志文件www.goodsgy.com

j2ee server有几个日志文件。默认这些文件在logs目录下。编辑config/default.properties 文件中的 www.goodsgy.com

log.directory 属性可以更改默认目录。
log.directory=logs www.goodsgy.com

同时你也可以编辑default.properties 文件更改日志文件的名字。例如：你可以修改log.output 属性的www.goodsgy.com

值来修改the output.log 文件的名字。
一般来说，日志文件决定于启动j2ee的模式。（single还是multiple VM (virtual machine) 模式）
Single VM 日志文件
默认的情况是Single VM 模式。在这种情况下，日志文件位于
$J2EE_HOME/<logs>/<host>/ejb
logs是在default.properties 文件中log.directory 属性指定的。host元素是计算机名称。
生成下列文件。
system.out
system.err
event.log
output.log
error.log
system.out 和system.err文件包括ejb中 System.out 和 System.err的输出。如果你运行j2ee -verbosewww.goodsgy.com

参数，输出被写到stdout（标准输出） 和stderr（标准错误。输出）。system.out 和 system.err日志文件不www.goodsgy.com

创建。只有config/auth.properties 文件中audit属性值为true时audit.lo才创建。www.goodsgy.com

Multiple VM 日志www.goodsgy.com

如果你用j2ee -mutiVM启动server，ejb和http服务在自己的虚拟机以单独的服务启动。每一个depploy的www.goodsgy.com

应用程序也在自己的虚拟机中运行。日志文件和上述的一样，但是存放的目录不同。
目录如下：
EJB $J2EE_HOME/<logs>/ejb/ejbd
HTTP $J2EE_HOME/<logs>/ejb/httpd
deployed application $J2EE_HOME/<logs>/ejb/<app-name> www.goodsgy.com

web server日志
编辑web.properties文件中的内容，可以改变由web server创建的日志文件的名字。www.goodsgy.com

10。安全www.goodsgy.com

未授权用户
对于j2ee来说，当有未授权的用户试图调用ejb container的时候，j2ee必须存在一般意义上的未授权用户www.goodsgy.com

存在。在j2ee中这个用户名字是guest，密码是guest123。你可以在auth.properties 文件中修改用户名和密码www.goodsgy.com

。
default.principal.name=guest
default.principal.password=guest123www.goodsgy.com

Keystore密码
如果用户使用公钥访问https，认证信息放在<user-home>/.keystore 文件中。同时user-home是www.goodsgy.com

System.getProperty("user.home")的返回值。
keystore是一个典型的密码文件。默认的密码是changeit。可以在web.properties 文件中修改www.goodsgy.com

keystore.password 属性的值来改变密码。www.goodsgy.com

ANYONE 角色
在application deployment工具的security面板中，默认的情况下方法分配给ANYONE 角色。这样的结果www.goodsgy.com

是所有的用户和组都可以调用它。如果你没有影射到一个特定的角色，每一个用户和用户都可以调用它。可以www.goodsgy.com

在auth.properties 文件中设置anyone.role.name 的值来改变默认anyone角色。

钝化发生的条件：内存限制
当ejb container开始钝化一个ejb的时候，它把ejb保存在附属存储中并且试图重新分配内存。默认的情况www.goodsgy.com

下，如果内存使用超过128m的时候钝化开始发生。可以编辑config/default.properties 文件中www.goodsgy.com

passivation.threshold.memory 属性的值来修改默认值。
passivation.threshold.memory=128000000
值必须是一个正的整数。当你减少这个值的时候钝化现象回经常发生。www.goodsgy.com

jndi name server host
如果jndi name server和j2ee server不在同一个机器上，你必须改变config/orb.properties 文件中hostwww.goodsgy.com

属性的值。
host=localhostwww.goodsgy.com

HTTP 文档根
默认的情况下，http和https服务的文档是public_HTML。你可以编辑web.properties 文件中documentrootwww.goodsgy.com

属性的值来改变它。
documentroot=public_HTML/