BES 快速入门及常见
问题处理
2011-4-7
北京宝兰德软件技术服务有限公司
BES Software and Service Corporation
目录
目录 ............................................................................................................................................. 2
1. 简述 ................................................................................................................................... 3
2. 名词术语 ........................................................................................................................... 3
3. 产品体系结构 ................................................................................................................... 3
3.1. 集群体系结构 ........................................................................................................... 3
3.2. 应用服务器实例体系结构 ....................................................................................... 3
4.
5.
BES 的管理架构和基本操作 .......................................................................................... 4
BES 安装说明 .................................................................................................................. 5
6. 产品激活 ........................................................................................................................... 6
7. 公共配置文件、基础库部署 ........................................................................................... 6
8. 数据源管理 ....................................................................................................................... 7
8.1. 数据库连接池管理 ................................................................................................... 7
8.2.
JDBC 资源管理(JNDI) ............................................................................................. 8
8.3.
JNDI 客户端配置 ..................................................................................................... 9
9. Web 集群管理 ................................................................................................................ 10
9.1. 创建集群 ................................................................................................................. 11
9.2. 创建集群实例 ......................................................................................................... 11
9.3. 创建 Apache 服务................................................................................................... 12
9.4. 配置 apache 服务 .................................................................................................... 12
9.5. 实例属性配置 ......................................................................................................... 13
10. 应用部署 ......................................................................................................................... 13
10.1.
10.2.
集群部署 ......................................................................................................... 13
独立实例部署 ................................................................................................. 15
11. 常见问题处理 ................................................................................................................. 16
11.1.
11.2.
11.3.
11.4.
Web 应用乱码常见解决办法 ........................................................................ 16
WAS 上 EJB 迁移 .......................................................................................... 18
WEB 应用(war)部署不成功 .......................................................................... 19
主机域名配置 ................................................................................................. 19
2 / 20
BES Software and Service Corporation
1. 简述
本文为 BES 快速入门手册,旨在帮助 BES 用户进行安装、简单的配置和部署管理应用。
本文将按照需要而进行更新。
2. 名词术语
DMS:域管理控制器
Domain:域
Node:节点
Node Agent:节点代理
Instance: 实例
Cluster:集群
Cluster Instance:集群实例
3. 产品体系结构
3.1. 集群体系结构
BES 集群的体系结构图:
一个集群下的所有集群实例可以分属于不同的节点(Node),但是必须同属于一个域
(Domain),它们具有相同的配置并且部署相同的应用。HTTP(S)客户端的负载均衡可以采
用四层交换实现,也可以采用 BES 内部 Apache 实现。
3.2. 应用服务器实例体系结构
3 / 20
BES Software and Service Corporation
应用服务器实例就是在单个 Java 虚拟机(JVM)进程中运行的应用服务器。可以使用
iastool 命令或者管理控制台对服务器实例进行配置管理。
应用服务器实例的体系结构:
4. BES 的管理架构和基本操作
BES 的管理架构图如下:
由域控制器节点代理实例构成了 BES 的 3 层管理架构,基于该架构上的域内节点和
实例可以灵活地构成应用所需要的集群。
4 / 20
BES Software and Service Corporation
每个节点都有一个节点代理进程,节点代理进程负责管理此节点下所有实例。域管理控
制器(DMS)负责管理所有节点。命令行工具和管理控制台通过与域管理控制器的信息交
互,来配置管理 DMS 下面的所有实例。
常见的操作和管理命令包括:
登录命令行控制台:
iastool --passport admin
创建 DMS 名为 domain1 的域
iastool create
--domain
--passport
admin
--user admin
--password admin --adminport 1900 domain1
启动域 domain1 (必须命令行启动)
iastool start --domain --passport admin domain1
停止域 domain1
iastool stop --domain --passport admin domain1
创建节点名为 Node1 的节点
创建节点名为 Node2 的节点
iastool create --node --passport admin --domainname domain1
Node1
iastool create --node --passport admin --domainname domain1
Node2
启动节点 Node1 (必须命令行启动)
iastool start --node --passport admin --domainname domain1
Node1
创建实例名 Server1 的实例
iastool create --instance --passport admin --node Node1 Server1
启动实例 Server1
停止实例 Server1
iastool start --instance --passport admin Server1
iastool stop --instance --passport admin Server1
创建集群名为 Cluster1 的集群:
iastool create --cluster --passport admin --user admin --password
admin Cluster1
在集群 Cluster1 下创建集群实例 c1s1(将
iastool create --instance --passport admin --ajpport 60001 --node
此实例创建在节点 Node1 下)
Node1--cluster Cluster1 c1s1
在集群 Cluster1 下创建集群实例 c1s2(将
iastool create --instance --passport admin --ajpport 60002 --node
此实例创建在节点 Node2 下)
Node2--cluster Cluster1 c1s2
部署应用
admin --password admin --domain domain1 --target server01
iastool deploy --passport admin --host localhost --port 1900 --user
解部署应用
--user admin --password admin --domain domain1 --target
D:\tmp\J2EE5WebTest.war
iastool undeploy --passport admin --host localhost --port 1900
详细信息可以参考《BES 用户手册》
server01 J2EE5WebTest
5. BES 安装说明
字符界面安装:
在 Windows 下,通过命令行执行:BES8.1.0.7590-WINDOWS32.exe -i console
在 Unix 下执行:./BES8.1.0.7590-HPUX_V3.bin –i console
安装完成后便可以使用上节描述的创建域控制器、节点等命令创建所需要的域、控制器,
然后在管理控制台创建、配置实例和集群。
注意:
5 / 20
BES Software and Service Corporation
1.操作系统必须具备 JDK1.5 或更高的 Java 环境,此外需要在 PATH 环境变量中引入 java
目录。
2.同一个域里面的主机的主机名配置最好包含全部域里面主机的配置,在 unix 的
/etc/hosts,windows 的 C:\WINDOWS\system32\drivers\etc\hosts 文件里面添加上其他主机的
域名(主机名)、IP 地址配置。
比如,需要在主机 136.192.24.162,136.192.24.201 上部署相同功能的应用,可以将这 2
台主机安装成一个管理域。这时候需要调整 2 台主机/etc/hosts 文件如下:
jstest2
rx8640
详细信息可以参考《BES Installation Guide》。
6. 产品激活
BES 在完成安装后,自带试用 license,72 小时停止一次系统,180 天失效,可以测试和
学习使用。对于生产环境而言,需要使用所购买序列号来激活产品,激活后的产品具有无限
期使用、不会自动重启、无连接和用户数限制。
BES 产品激活步骤如下:
1) 转到$BES_HOM/bin 目录下。使用./lmadm gen-regcode, 按照提示,将生成的注
册码文件和从销售拿到的序列号发给我们。
2) 我们会按照提供的(序列号、注册码文件)生成激活文件,发送给您。
3) 使用./lmadm import-lic –sourcepath=
将激活文件导入。
4) 导入激活文件成功后,可以通过 ./lmadm view-lic 查看 license 情况。
备注:
前期版本的 BES 使用的注册命令是 registerationtool, 而不是 lmadm
7. 公共配置文件、基础库部署
BES 的 classloader 提供了丰富的类加载办法,可以将不同位置下的类进行加载。 对于在
一台主机上所有的实例都需要使用到的配置文件和公共使用的基础库,可以放到 BES 的 lib
子目录(比如/home/bes/BES/lib)下,这些类库会被自动加载。
对于放到 BES 的 lib 目录下的配置文件,因为目前的 BSS 应用使用 InputStream input =
ClassLoader.getSystemResourceAsStream(filePath);这样的接口来加载配置文件,这种方式下
需要调整 BES 实例启动的 classpath。因此需要修改$BES_HOME/config/process.config 如
下:
6 / 20
BES Software and Service Corporation
„„
8. 数据源管理
在 BES 上,如果要通过 BES 的连接池管理来访问数据库,需要配置合适的 JNDI 资源。
这包括 2 个步骤:首先建立数据库连接池;然后使用该连接池创建部署到实例上的 JDBC 源
(JNDI 资源)。
8.1. 数据库连接池管理
通过下述接口可以管理 BES 的连接池。指定访问连接池的名称, 连接到的数据库 IP 地址,
用户名,密码,数据库名称,驱动类型.等参数。
对于 RAC 方式访问 oracle 数据库,可以直接添加自定义的 URL 属性。
7 / 20
BES Software and Service Corporation
8.2. JDBC 资源管理(JNDI)
通过下述接口可以对 BES 上的 JDBC 源(JNDI 资源)进行管理。创建 JNDI 时,可以同时指
定连接池的名称,需要部署到集群、实例的名称. 如添加 数据源 “jdbc/oracle/sm” 将其部署
到 SM 集群下.
8 / 20