iPlanet安装简单说明
关键字索引:
. 软件安装
. 管理部署
. 开发调试
. 参考资料
第一部分: 软件安装
1. 介绍: iPlanet 是SUN公司推荐的支持JAVA应用服务的优秀产品,它包含iPlanet Web Server 和 iPlanet Application Server 两个部分,功能十分强大,但本文只介绍了支持JAVA的部分功能.
2. 软件版本及环境:
iPlanet Web Server 6.0
iPlanet Application Server 6.5(学习版)
操作系统是win2000,256M内存,但iPlanet Application Server 推荐512M内存,
它比较耗资源.
3. 安装 iPlanet Web Server:
通过安装向导可以轻松安装它,需要定制管理帐号密码和两个侦听端口号(管理端口和Web端口),其中要注意的是在配置JDK的时候,有两种选择,一是采用它自带的,二是自定义.推荐用自定义,只需要配置第一项如:JDK Path: d:/jdk1.3即可.此版本目前支持jdk1.2 ,1.3. 当然JDK参数也可以在安装后在管理界面修改配置.
安装完后可以访问调试: http://localhost:port/ 根据安装时候配置的端口可以分别访问管理端和服务端,管理部分还可以从windows的开始菜单中进入.如果顺利访问,则安装成功.
4. 安装iPlanet Application Server:
安装前应该先安装iPlanet Web Server,必需装有tcp/ip协议,还需要提供一个域名,例如domain. 在安装服务过程中,它自带的iPlanet Directory Server也是必须安装的,安装此服务要为它提供一个suffix: dc=,这是一个自定义的标识,也可以填domain. 安装过程中会出现配置Web Server的界面,如果已经安装的iPlanet Web Server(这是安装程序的首选),安装程序会自动配置二者连接支持,还会发布一样例程序到iPlanet Web Server.也可能会修改Web Server的侦听端口. 后面还有一些配置缺省即可, 数据库驱动可以在安装后去配置.
安装完成后可以从开始菜单中打开Samples Application ,可以显示许多样例入口和样例相关介绍说明, 但它在们Application Server上只发布了Fortune (包含Session Bean) ,你可以访问Sample Applications 下的 Fortune (quick test)连接,如果成功显示,则安装成功.
第二部分 管理部署
1. 在iPlanet Web Server 上部署应用程序
iPlanet Web Server 可以支持不含EJB等企业级应用的部署.
进入管理后台后可以在Global Settings 下配置和修改JDK.
部署应用程序的功能可以从Servers----Manage----Class Manager----defaultclass----Manager----Web Application进入到以下发布页面
发布和管理应用程序,注意的是Application URI这一栏应该以"/"开头.
2. iPlanet Application Server的后台管理:
从开始菜单运行IAS Administration Tool可对Application Server进行管理.
下面介绍几个已知部分.
General: 可以配置一些基本参数,选中Enable Dynamic Class Reloading
可以保证每次调用JSP的最新编译.
Database: 用来配置DataSouce.它提供了两种方式,第二种应该是它自带,这里只配置第一种比较常见的Oracle的thin连接.
首先要配置JDBC Drivers:
Drivers Type : 自定义的Drivers标识 .如jdbc_type4
Drivers classpath: 驱动的类路径.
Pooled DataSouce Name:数据源连接池的类名
如:oracle.jdbc.pool.OracleConnectionPoolDataSource
JDBC ClassName: 先填了上面栏目,此栏会被屏蔽.如强行填上会出错
XA Datasouce Name: oracle.jdbc.xa.client.OracleXADataSource
这应该是和事物处理相关的类名.
接下来就可以配置DataSouce了:
在增加窗口里填上JNDI Name,选择刚才配置的DriverType,
然后在UserName 和 Password填入信息即可提交.
在DataSouce Selection Box中选中刚配置的JNDI,
在点选 Vendor Specific Properties添加URL内容,例如:
url : jdbc:oracle:thin:@w22:1521:myora
在修改其他相关参数即可.
还可以编写XML文档用部署工具来配置DataSouce,这在稍后介绍.
Logging: 可以激活配置相关的日志文件.
Application: 可以修改一些应用服务的路径和查看已经配置的Application的一些运行情况.由于是学习版,应用程序的卸载功能没有实现.
后台参数配置修改需要重启服务器才能生效, 可以在General选项管理Server.
3 iPlanet Application Server的部署工具
从开始菜单运行IAS Deployment Tool可以用来在Application Server发布企业级应用服务程序.当然这些发布工作也可以通过和 Jbuilder整合来更方便的进行.操作界面如下图所示:
发布台可以发布*.ear,*.war,*.jar包
发布过程:
首先需要通过Tools----Register Server注册一个服务,user和pwd为安装过程中输入的信息.
如果是已经打好的包文件,比如iPlanet_home\ias\ias-samples下的样例包可直接Open发布,下部的Result和 Message窗口会显示相关信息.如成功发布,一般都需重启服务.样例可以通过已经安装的样例入口访问,也可以和其它自己发布的服务一样通过http://host:port/NASApp/发布服务名/ 形式访问.
如果只是一些JSP和类文件,可以通过发布工具打包并发布:
new 一个Application or Module,输入Name后,可以马上通过向导生成,也可以先OK生成,在通过点选左边生成的空包Insert内容.注意在Insert的过程中要通过 resolve 按钮转化目录结构,一般是去掉目录,直到所选择的文件又红变成蓝色即可.
加入所有文件后可以同过Edit Descriptor来描述,配置服务.
注意的是在配置实体Bean的时候需要提供工厂类:
com.netscape.server.ejb.SQLPersistenceManagerFactory
点选保存会生成相关的XML文件并保存包. 然后发布生成的包
注册DataSouce:
Tools----Register DataSouce;可以直接Open一个XML文件来注册,也可以把输入的参数Save 为一个XML文件,样例XML文件如下:
<?xml version="1.0" encoding="UTF-8"?>
<ias-resource>
<resource>
<jndi-name>jdbc/myora</jndi-name>
<jdbc>
<URL>jdbc:oracle:thin:@localhost:1521:IAS</URL>
<user>j2eeguide</user>
<password>j2eeguide</password>
<driver-name>ora-type4</driver-name>
<conn-pooling>
<initialPoolSize>1</initialPoolSize>
<waitQueueEnabled>true</waitQueueEnabled>
<reclaimTime>600</reclaimTime>
<maxPoolSize>30</maxPoolSize>
<maxIdleTime>120</maxIdleTime>
<queueLength>30</queueLength>
<trace>disable</trace>
<stat>disable</stat>
<waitTimeInQueue>120</waitTimeInQueue>
<tableBasedSanity>false</tableBasedSanity>
<isSanityRequired>true</isSanityRequired>
<incrementPoolSize>1</incrementPoolSize>
<minPoolSize>1</minPoolSize>
</conn-pooling>
</jdbc>
</resource>
</ias-resource>
其中driver-name必须是在管理工具已经配置的Drivers Type.
第三部分 开发调试
1. 与JBuilder7的整合
iPlanet与Jbuilder的整合也非常完美.选择Jbuilder的Tools----Configure Serves
在点选左边Box中的iPlanet Application Server 6.X+,在右边激活它,并配置Home,其它选项回自动配置,如果在Custom中选择 Add iPlanet Tools to Tools Menu,你就会发现在Jbuilder的Tools底部多了三个我们刚刚熟悉功能选项.
开发时,在Project Properties的Server选择iPlanet Application Server 6.X+就可以,项目中就会自动生成定义iPlanet的配置文件了.
目前的学习版只支持EJB1.1规范
2. Jsp,Servlet和EJB的开发
iPlanet对应用程序部署实际上在他的工作目录将包展开
缺省的目录是在 iPlanet_hom/ias/APPS下,
对于Jsp, Servlet,如果在后台配置了Dynamic Class Reloading,修改后直接覆盖,在访问即可看到新的结果.
对于EJB部分也可以直接覆盖,但通常需要重启服务,才可以看到新的讯息.
3. 调试
如果在后台配置了logging,可以在iPlanet_home/ias/logs查看运行日志
也可以在命令方式下运行iPlanet_home/ias/bin/kas -debug,一些bug和调试信息会打印到控制台中.
如果是发布到Web Server中的程序,它会输出到相应的log文件中,Log目录类似于: D:\iPlanet\Servers\https-w22\logs
第四部分 参考资料
1. iPlanet Web Server在它的manual\https下有比较详尽的文档.
2. iPlanet Application Server 可能是学习版的缘故,只有在线资料,也比较详细,如
http://docs.sun.com/source/816-5784-10/contents.htm
http://docs.sun.com/source/816-5786-10/contents.htm
其实ias下它自带的例子也是很好的学习参考资料.
