# 宝兰德BES中间件信创环境部署手册

北京致远互联软件股份有限公司 2025年01月

# 修订记录

修订内容	修订时间
增加宝兰德BES955多实例部署章节	2025-3-28
调整宝兰德BES952版本部署章节	2025-1-24

# 适配的信创环境

宝兰德中间件与协同服务集成部署适用环境如下：

分类	支持范围	备注
协同产品版本	A8-N 或 G6-N 9.0SP1
服务器CPU	飞腾、鲲鹏、海光、龙芯（MIPS）、兆芯
服务器操作系统	麒麟V10、统信UOS 2.0	产品支持部署到Linux X86系统
服务器中间件	宝兰德952版本、955版本	仅BES集群多实例版能用信创部署工具（单实例版本需要手工配置部署）
服务器数据库	达梦8、（人大）中电科金仓V8 R3 R6（Oracle模式）、神舟通用7、南大通用Gbase8s致远专版	支持使用MySQL、SQLServer、Oracle数据库

# 环境资源准备清单

进行信创环境主系统部署时，需要准备相应物料， 详细准备清单见同版本信创环境部署手册。

# 部署结构和硬件配置

产品支持多种部署模式，不同模式所需资源不同，可以根据用户需求自由选择对应的方案。

详细信息见同版本信创环境部署手册 ，本手册专注介绍宝兰德中间件下的部署。

# 注意事项

操作系统建议安装图形化界面。

操作系统、中间件、数据库的安装参考对应厂商的手册，本文不做阐述。

宝兰德不同版本部署略有不同，请根据具体的版本寻找对应章节部署。

# BES955多实例部署协同应用

宝兰德955中间件分集群版介质和单实例介质，集群版介质又称为多实例模式，本章节介绍多实例介质部署协同的步骤。

注意：仅宝兰德多实例支持协同的信创部署工具部署，宝兰德单实例版本需要手动部署，具体手册见单实例部署专项章节。

# BES955 多实例准备

使用宝兰德前，通过 java -version 命令检查当前系统是否已经安装 openjdk8。如未安装请自行安装或联系系统厂商准备合适的 jdk8（小版本号推荐 1.8.0_372），并配置 JAVA_HOME、PATH、CLASSPATH 环境变量。

安装部署前，先确保当前系统已经安装了最基础的命令：

# RedHat 系统（如 CentOS）可以通过 yum、dnf 预装组件
yum update -y
yum install tar unzip curl telnet vim -y

# 基于 Debian 的系统（如 Ubuntu）使用 apt 预装组件
sudo apt update -y
sudo apt install tar unzip curl telnet vim -y

# BES955 多实例初始化

创建中间件目录：

参考宝兰德手册，先创建一个中间件的空目录，本案例将中间件放置到 /data/BES955/AdminServer。

# 创建一个中间件的空目录
mkdir -p /data/BES955/AdminServer
# 将中间件安装介质 xxx.tar.gz 上传到系统中
# 找到放置中间件介质的目录，使用如下命令解压文件到中间件下（注：不同环境的 tar.gz 介质名称不同，根据情况自行做调整）
tar -zxvf BES-AppServer-Enterprise-9.5.5.6210-RHEL6-X64.tar.gz -C /data/BES955/AdminServer/
# 到中间件 bin 目录下
cd /data/BES955/AdminServer/bin
# 执行初始化操作
./initstore

# 以上完成后，继续保持在 bin 目录，执行 ./startManagement 命令启动管理控制台
./startManagement
# 随后根据提示，查看启动的 server.log 日志
tail -f /data/BES955/AdminServer/logs/server.log

初始化操作完成后，启动中间件管理控制台，出现 Started compress log service 则表示启动成功。

# BES955 多实例访问中间件控制台

执行命令 netstat -ntlp ，检查中间件控制台端口是否启动，BES955 控制台默认占用 6900 端口（注意防火墙开通端口访问权限）：

通过浏览器访问中间件管理控制台，默认访问页面信息如下：

访问链接：http://宝兰德中间件IP:6900/console
登录用户：admin
登录密码：B#2008_2108#es

首次登录，若有提示修改密码，密码千万不要修改，在完成协同部署启动前，保持系统默认，信创部署工具会使用此密码！

BES955 多实例初次部署不要打中间件补丁：

初始化宝兰德后，不要立刻打中间件补丁，建议先做协同的部署及验证，确保能部署成功、启动成功！

多个项目打了宝兰德全部补丁包，结果出现数据库无法连接、连接后无法启动、启动过程中类冲突的问题！

# BES955 多实例实例准备

以上完成后，我们需要先给协同服务创建一个主机和实例才能做部署协同的操作。本章节操作均在宝兰德管理控制台里进行。

# BES955 新增主机

宝兰德管理控制台 - 菜单“主机管理”，点击“添加”按钮添加主机信息：

名称：可自定义，如 seeyon
主机名 IP：填写宝兰德服务器的真实 IP 地址（请勿填写 127.0.0.1）
用户名与密码：填写登录服务器操作系统的用户及密码，宝兰德会使用 SSH 登录。

在主机列表，点击主机名称可以回到编辑页面，点击 Ping 可以测试是否能连通服务器。Ping 不通的情况，请检查配置，确保 Ping 通再进行后续操作。

# BES955 新建节点

主机添加完成后，可进行节点配置，宝兰德管理控制台 - 找到菜单“节点管理”，进入节点列表界面，点击“新建”按钮添加节点：

节点名称：可自定义，如 seeyon_node1
管理端口：默认是 3100，如果已被占用，可填写其他可用端口
节点目录：指向宝兰德中间件程序目录下的 node（与 bin 目录同级），默认 node 目录不存在，首次启动会自动创建
JAVA_HOME：如果当前系统已经配置过 JAVA_HOME 环境变量，不填写
其它信息：保持默认

# BES955 启动节点

新建节点完成后，即可启动，由宝兰德自动创建节点并启动：

启动完成后，访问宝兰德服务器，能看到 node 目录自动创建成功：

# BES955 新建实例

以上步骤完成后，点击“实例管理”菜单，进入实例列表界面，点击“新建”，填写实例信息：

实例名称：自定义，如 seeyon_a
实例类型：选择“独立实例”
实例目录：不要修改，实例目录会自动指向 node 节点目录的下一层，实例目录由宝兰德自动创建
其它信息：保持默认

# BES955 启动实例

新建实例完成后，勾选刚新建的实例，点击“启动”。实例需要处于启动创建，才能做后续的协同部署操作！

实例位置可以通过当前实例列表的“实例位置”查询到。如提示启动失败，需要到实例目录下查看 log 日志，或者直接在列表上点击“下载日志”：

记住这个实例目录地址，后续中间件下所有的维护都围绕这个目录进行！

# BES955多实例程序部署

# BES955 多实例 - XinChuang部署工具准备

准备 XinChuang.zip 包：

从致远商务公布的安装程序下载地址中，下载对应版本的 XinChuang.zip 部署包，并解压到系统中：

mv 2.V9.0SP1_XinChuang.zip /data/
cd /data
unzip 2.V9.0SP1_XinChuang.zip

关于 XinChuang 部署工具：

XinChuang 包中有一个信创部署工具，是致远自研产品，工具将很多人工操作的步骤写到程序中，由工具程序来自动完成。包括并不仅限于：配置 JVM、调整 jar 包、设置产品标识、部署协同程序、导入数据库脚本等，极大提升部署效率，减少错误率。

只要使用信创部署工具安装协同，后续协同版本升级，也可以用信创部署工具一键平滑升级。 故能用信创部署工具的环境，一定都用工具做部署、升级！

信创部署工具部署类型：

信创部署工具位于 XinChuang/deploytools 目录下，支持图形界面部署和命令行静默部署两种方式，如果有图形化界面，建议优先使用图形界面方式：

图形化部署：使用命名含 GUI 的 deployGUI-for-版本号-产品线.sh 程序启动
命令行部署：使用命名含 cli 的 deploycli-for-版本号-产品线.sh 程序启动

# BES955 多实例 - 图形化部署

带图形化的 Linux 或信创操作系统可以使用图形化安装。

首先确定协同程序路径，比如固定在/data/Seeyon 目录，通过 mkdir -p /data/Seeyon 命令创建。

确保宝兰德中间件已经准备就绪，并且按照要求进行了实例目录的启动。

确保宝兰德管理控制台的默认密码未被修改过，信创部署工具使用宝兰德默认的密码进行接口登录并部署。

确认好客户使用什么数据库，如果是当前版本标准产品支持的数据库，则只需要初始化一个空库（即使是老客户转信创也建议先建空库测试启动），信创工具会自动写入 SQL 数据。

以上准备就绪后，参考如下命令启动图形化部署工具：

# 到 XinChuang 部署目录 deploytools
cd /data/2.V9.0SP1_XinChuang/deploytools
# 先赋予可执行权限（如果是 G6 则操作 G6N 结尾的可执行文件）
chmod +x deployGUI-for-V9.0SP1-A8N.sh
# 再启动 GUI 可执行程序（如果是 G6 则操作 G6N 结尾的可执行文件）
./deployGUI-for-V9.0SP1-A8N.sh

图形化参数说明：

安装 / 升级：全新部署勾选“安装”选项，协同升级则选“升级”选项。
CPU：目前支持 ARM、MIPS、x86 三类，根据当前系统实际情况选择
系统：只有 CPU 类型为 ARM 时才需要选择，支持选项：统信 uos、麒麟 kylin
中间件：根据实际情况选择，宝兰德 BES955 多实例就选 Bes
协同路径：需要提前创建空目录，比如本例设置为 /data/Seeyon
中间件路径：对应宝兰德 BES955 多实例的实例目录，通过宝兰德管理控制台 - 实例管理能查询到实例位置（不包含 IP 端口部分），如下图所示目录位于 /data/BES955/AdminServer/node/seeyon_node1/instances/seeyon_a

协同产品线、在线人数： 根据实际情况选择，在线人数尽量预估准确，不同在线人数，工具会给不同的 JVM 配置

数据库： 下拉列表中能选到的就是标准支持的库，只要准备好空库，工具会自动向空库中写入协同初始化 SQL；如数据库不在标准支持范围，则下拉列表选择“不初始化数据库”，这类“不初始化数据库”场景，在工具部署完成后，需要手动初始化数据。

JDBCDriver： 根据选择的数据库自动生成，无需修改

JDBC URL： 需要修改 IP、端口、库名（数据库空库需要提前创建，见前面章节说明）

数据库用户、密码： 根据实际情况填写

以上填写完整后，先进行“验证参数”，通过后再“部署”，部署需要一定时间，请耐心等待。

如数据库选择“不初始化数据库”，安装结束后提示“未找到对应数据库版本驱动 JAR，请手动放置数据库驱动”的提示，可以忽略，部署是成功的。

完成部署后，手工关闭安装程序退出。

信创部署工具日志文件位于：2.V9.0SP1_XinChuang/deploytools/logs 目录下，如遇到部署异常可通过日志分析问题。

部署完成后重启实例： 部署完成后，回到宝兰德控制台实例菜单，需要重启下实例才能让部署的配置生效：

# BES955 多实例 - 命令行部署

如操作系统无图形化界面，则使用命令行静默安装。

第一步：修改 installConfig.properties：

通过修改信创部署目录 XinChuang/deploytools/cfgHome/installConfig.properties 配置文件，配置必要的参数。

# 到 XinChuang 部署目录 deploytools/cfgHome
cd /data/2.V9.0SP1_XinChuang/deploytools/cfgHome/
# 修改 installConfig.properties 文件参数
vim installConfig.properties

installConfig.properties 配置文件中的参数与图形化部署界面一模一样，这里面的参数直接参考上一个图形化安装章节填写。

再次提醒：请不要凭感觉填写配置，认真参考“图形化部署”章节，熟悉每一个配置和注意事项后再操作！

如下是一个示例截图，本示例选择安装 A8-N 集团版、数据库选择 MySQL、提前创建好协同的程序目录 mkdir -d data/Seeyon 、中间件部署路径指向宝兰德 BES955 多实例的实例目录：

第二步：修改 deploycli 脚本，设置状态为 install

找到我们本次要命令行启动执行的 sh 脚本文件，修改配置：

# 到 XinChuang 部署目录 deploytools
cd /data/2.V9.0SP1_XinChuang/deploytools
# 修改命令行启动脚本文件（如果是 G6 则操作 G6N 结尾的可执行文件）
vim deploycli-for-V9.0SP1-A8N.sh

修改 sh 脚本文件里末尾的参数，将默认的 upgrade （更新升级）改为 install （安装部署）：

第三步：执行命令行部署 sh 脚本：

# 到 XinChuang 部署目录 deploytools
cd /data/2.V9.0SP1_XinChuang/deploytools
# 先赋予可执行权限，再执行 sh 脚本
chmod +x deploycli-for-V9.0SP1-A8N.sh
./deploycli-for-V9.0SP1-A8N.sh

提示“安装成功”即可退出命令模式，进行后续部署配置操作：

信创部署工具日志文件位于：2.V9.0SP1_XinChuang/deploytools/logs 目录下，如遇到部署异常可通过日志分析问题。

部署完成后重启实例： 部署完成后，回到宝兰德控制台实例菜单，需要重启下实例才能让部署的配置生效：

# BES955 多实例 - 纯手工部署

已经通过信创部署工具安装的客户，请直接跳过本小节！

如果以上确定都不行，则参考如下方式进行文件手动部署（由于手动部署后的所有配置也要修改，手动配置错误率极高，我们非常不推荐此方式）：

第一步：新建协同程序的存放目录，比如 mkdir -p /data/Seeyon/V5，后续协同程序将全放这下面

第二步：将 2.V9.0SP1_XinChuang/V5/ApacheJetspeed.7z 解压到 /data/Seeyon/V5

# 确保当前系统安装了 7z 解压工具，解压文件到 协同 程序目录下
7z x ApacheJetspeed.7z -o/data/Seeyon/V5
# 如果 7z 不可用，尝试 7za 命令，或者检查是否按照了 7z 解压工具
7za x ApacheJetspeed.7z -o/data/Seeyon/V5

以上解压后，协同的目录层级格式务必是 /data/Seeyon/V5/ApacheJetspeed/webapps 这样的结构，如果不是，请尝试重新操作！

第三步：剪切、拷贝各种 jar，特别注意不同版本、不同 jar 是剪切还是拷贝都有严格要求，务必参考要求执行：

# 剪切文件（将 协同 下 WEB-INF/lib 的指定 jar 移动到中间件实例目录/lib 下）
mv /data/Seeyon/V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib/{seeyon-ctp-jdbcproxydriver.jar,druid.jar,log4j-1.2-api.jar,log4j-jcl.jar,log4j-api.jar,log4j-core.jar,jmx_prometheus_javaagent.jar}
/data/BES955/AdminServer/node/seeyon_node1/instances/seeyon_a/lib/
# 拷贝文件（将 协同 下 WEB-INF/lib 的指定 jar 复制一份到中间件实例目录/lib 下）
cp /data/Seeyon/V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib/{websocket-api.jar,guava.jar,seeyon-ctp-dbpool.jar,seeyon-ctp-log-log4j.jar,disruptor.jar,woodstox-core-asl.jar,stax2-api.jar,stax-api.jar,commons
logging.jar} /data/BES955/AdminServer/node/seeyon_node1/instances/seeyon_a/lib/
# 将 XinChuang 部署包的驱动 jar 拷贝到中间件 lib 下，注：仅 MySQL、SQLServer、Oracle 数据库适合，其余信创数据库请联系数据库厂商提供驱动 jar
cp /data/2.V9.0SP1_XinChuang/deploytools/file/jdbc/mysql-connector-j-8.0.33.jar
/data/BES955/AdminServer/node/seeyon_node1/instances/seeyon_a/lib/

以上手工操作务必一步步按顺序执行，不要错过任何一步。

# BES955 多实例-调整中间件配置

# BES955 多实例检查系统配置

宝兰德管理控制台 - 实例管理菜单 - 点击实例名称，进入配置页面，第一个页面“系统属性”需要如下两个属性：

名称	值
`com.bes.enterprise.web.util.scan.StandardJarScanFilter.jarsToSkip-test`	`*`
`com.bes.enterprise.web.compiler.ignoreHtmlComment`	`false`

注意： 信创部署工具会自动配置参数，如果使用信创部署工具部署，发现下面的参数依然不存在，可能是宝兰德默认密码被修改导致，信创工具必须用宝兰德默认密码进行部署！

# BES955 多实例检查JVM

宝兰德管理控制台 - 实例管理菜单 - 点击实例名称，切到 JVM 配置页签，按如下配置检查调整参数：

堆最大值和堆最小值保持一致，避免出现堆内存动态波动，根据不同在线人数需要配置不同的大小，单位 M
堆最大值和堆最小值通俗说就是协同占用的内存，内存占用不能超过当前操作系统总内存的 75%！
元空间最大值和初始值保持一致，均设置为 2048，单位 M
垃圾回收算法，必须选择 G1GC

以上完成后，修改页面下方的“JVM 选项”（如不存在则添加或修改，存在则忽略）：

增加参数：-Djava.awt.headless，值为true
增加参数：-XX:ReservedCodeCacheSize，值为1G
增加参数：-XX:GCLogFileSize，值为10m
增加参数：-XX:NumberOfGCLogFiles，值为8
增加参数：-XX:+UseGCLogFileRotation
增加参数：-XX:+PrintGCDetails
增加参数：-XX:+PrintGCTimeStamps
增加参数：-XX:+PrintGCDateStamps
增加参数：-Xloggc:/seeyon/V5/ApacheJetspeed/logs (此处目录需要替换为当前环境的部署目录，并且若logs不存在，需要手动创建)
增加参数：-Dsun.zip.disableMemoryMapping，值为true
增加参数：jdbcproxydriver.driverclass，值则根据当前JDBC数据库的驱动名，用什么数据库就赋什么值：
- 达梦值为dm.jdbc.driver.DmDriver
- 人大金仓值为com.kingbase8.Driver
- 神通值为com.oscar.Driver
- 南大通用值为Gbase com.gbasedbt.jdbc.Drive
- MySQL值为com.mysql.jdbc.Driver
- Oracle值为oracle.jdbc.driver.OracleDriver
- SQLServer值为com.microsoft.sqlserver.jdbc.SQLServerDriver
其它非标数据库，以对应数据库的项目化部署手册为准。

注：本地实测 -Djava.awt.headless=true 配置后无效果，可以联系宝兰德技术核实情况

以下为JVM示例截图：

# BES955 多实例检查 default-web.xml

以上完成后，先启动一下实例，以便让配置生效，再强制停止实例，继续后续操作。

检查宝兰德实例目录下的配置文件 default-web.xml：

# 命令参考
vim /data/BES955/AdminServer/node/seeyon_node1/instances/seeyon_a/conf/default-web.xml

检查 <servlet></servle> 标签内是否有如下配置，如果没有，将如下 XML 配置拷贝到标签内(一般使用信创工具部署都会包含此配置）：

<init-param>
  <param-name>trimSpaces</param-name>
  <param-value>false</param-value>
</init-param>

# BES955 多实例检查线程池配置

1、宝兰德控制台，进入当前实例，再访问菜单 - Web 容器 - 线程池 - 检查名为“http-thread-pool”的线程池配置： 最大线程大小：修改为 4096。

2、保持在当前实例，访问菜单 - Web 容器 - HTTP 监听器 - 检查名为“http-listener-1”的监听器配置

“http-listener-1”下的HTTP 属性配置，找到最大 POST 大小，将其改成 -1，不限制长度。

以上全部配置完成后，强制停止实例，再启动一下实例，确保全部配置生效。

# BES955 多实例检查JDBC 数据源

1、检查 JVM 是否已经配置好 -Djdbcproxydriver.driverclass 参数：

宝兰德管理控制台 - 实例管理菜单 - 点击实例名称，切到 JVM 配置页签，底部“JVM 选项”搜索 Djdbcproxydriver.driverclass ，如果是标准产品支持的数据库，则一定要有此参数，如不存在，则必须参考[检查JVM]章节将参数和正确的值配置进去。

2、检查驱动 jar 是否已经正确放置：

如使用信创部署工具连接MySQL、SQLServer、Oracle 这三家非国产数据库，可以不做驱动的调整。

其余国产化数据库必须从数据库厂商获取相匹配的JDBC驱动jar，并将其放置到宝兰德实例目录 /lib 下（如果 /lib 下有旧的驱动 jar 注意删除掉）！放置驱动 jar 后必须重启一次宝兰德服务！

XinChuang 安装包中虽然有达梦、金仓等国产化数据库驱动 jar，但与客户版本不匹配，只能用作执行初始化 SQL 语句，实测启动协同时遇到复杂 SQL 就会有大量莫名报错，故务必使用厂商的驱动 jar。

3、检查 jdbc/ctpDataSource 是否存在，不存在则手动配置：

访问宝兰德管理控制台 - 资源管理 - JDBC - 单数据源管理：检查是否存在“jdbc/ctpDataSource”的数据库连接

如果存在 jdbc/ctpDataSource 选项，则是通过前面信创部署工具自动部署初始化的，只需要进入选项，Ping 检查下数据库连接是否成功

如果不存在 jdbc/ctpDataSource 选项，则表示当前数据源要自行自己手动配置

如果存在 jdbc/ctpDataSource 选项，则进入选项，Ping 检查下连接配置，如果连接正常，则进行后续章节操作。

不存在 jdbc/ctpDataSource 场景，需要手动新建数据源：

新建数据源页面，添加如下配置：

名称必须是：jdbc/ctpDataSource
资源类型：java.sql.Drvier
数据库驱动类名，不要用数据库默认的驱动类，必须设置为驱动代理类：com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver
连接配置：按数据库的规则填写即可
数据库 URL、账号密码，可联系数据库厂商提供，以下是不同库的 URL 连接示例：

数据库类型	连接 URL 示例
达梦	`jdbc:dm://10.3.4.206:5236/SEEEYON`
人大金仓	`jdbc:kingbase8://10.3.4.192:54321/SEEYON?clientEncoding=UTF-8`
神通数据库	`jdbc:oscar://10.6.8.130:2003/SEEYON` (这里填写神通数据库创建时的填写的数据库名)
南大通用	`jdbc:gbasedbtsqli://127.0.0.1:9088/gbasev5:GBASEDBTSERVER=seeyonoa;DB_LOCALE=zh_CN.utf8;SQLMODE=Oracle;DELIMIDENT=y;CASE_SENSITIVE=N;IFX_LOCK_MODE_WAIT=10`
MySQL	`jdbc:mysql://127.0.0.1:3306/seeyon?autoReconnection=true`
Oracle	`jdbc:oracle:thin:@127.0.0.1:1521:seeyon`
SQLServer	`jdbc:sqlserver://127.0.0.1:1433;DatabaseName=v3x;maxStatements=0;SelectMethod=cursor;socketTimeout=1800000;trustServerCertificate=true`

信创数据库均有详细的注意事项，如遇问题，先取信创部署手册中数据库的要求排查。

4、检查 JDBC 数据库池设置：

无论手动还是自动配置 JDBC，均做好数据库连接池配置检查：

初始连接数据：生产上线，设置为 50，启动初始化就创建 50 个连接程序消费
最小连接数：生产上线，设置为 50，让程序至少保持 50 个活动连接
最大连接数：生产上线，设置为 500，能满足大部分并发场景
验证 SQL 录入：select 1 from ctp_config;

5、检查 JDBC 数据源部署目标

确保实例放在了右侧，这个配置表示“已选择”的实例使用这个数据库连接配置：

6、检查调整高级配置

事务隔离级别选择：READ_COMMITTED
自动提交：必须勾选启用
释放连接时回滚：必须勾选启用
其它配置可保持现状，后续如果出现数据库问题，可根据宝兰德技术的处理意见做其它配置调整。

7、保存和检查 JDBC 连接

保存后，再进入 jdbc/ctpDataSource，底部有 Ping 按钮，可以测试连接数据库是否正常：

如果报错，则取中间件目录下的日志 tail -f /data/BES955/AdminServer/logs/server.log 分析。

# BES955 多实例部署应用目录

以上所有步骤完成后，进入应用部署步骤，本章节介绍将协同应用程序部署到中间件。

提醒：协同的所有应用（root、seeyon、static、sportal）需要部署在同一个实例下，不支持在多个实例下分开部署！

# BES955 多实例-部署应用准备

手工检查协同路径下文件是否生效：

1、（使用信创部署工具，可忽略本步操作）删除协同路径下 /ApacheJetspeed/webapps/ROOT/META-INF/context.xml 文件：如果手工检查发现文件还存在，则删除 context.xml。

2、（使用信创部署工具，可忽略本步操作）确保 web.xml 中已经添加了 metadata-complete="true" 参数配置，协同路径 ApacheJetspeed/webapps/seeyon/WEB-INF/web.xml 文件需要此配置，信创部署工具默认会添加，如检查发现参数不存在，则添加：

3、（使用信创部署工具，可忽略本步操作），协同路径 ApacheJetspeed/webapps/seeyon/WEB-INF/ 目录下新建 bes-web.xml 并且增加相关配置：

# vim 命令如文件不存在，保存后会自动创建文件
vim /data/Seeyon/V5/ApacheJetspeed/webapps/seeyon/WEB-INF/bes-web.xml
# bes-web.xml 中增加如下配置信息：
<bes-web-app>
  <class-loader delegate="false" />
  <property name="requestCharacterEncoding" value="utf-8" />
</bes-web-app>

4、（使用信创部署工具，可忽略本步操作）将 XinChuang 部署包 deploytools/file/productiden 中的文件，按产品线（A8V5-1：A8 企业版、A8V5-2： A8 集团版、A8N-1：A8-N 企业版、A8N-2：A8-N 集团版、G6N-1：G6-N 单组织、G6N-2：多组织、G6SU-1：督查督办单组织、G6SU-2：督查督办多组织）解压成 ApacheJetspeed 文件夹，覆盖协同 V5 目录下的 ApacheJetspeed。

cd /data/2.V9.0SP1_XinChuang/deploytools/file/productiden
7z x A8N-2.7z
cp -r ApacheJetspeed/* /data/Seeyon/V5/ApacheJetspeed/

放置 license：

加密狗需要在X86带图形化的页面注册，注册使用标准产品安装包中的 updateDog，注册时务必绑定当前宝兰德服务器的 Mac 地址，注册成功后，将加密文件放置到部署包 V5/base/license 下：

# 第一步：部署 ROOT 应用：

宝兰德管理控制台 - 应用管理 - 常用应用：选择部署

部署模式选择“本地模式”，其余不要调整，点击下一步：

部署目标，把左侧的可选目标放到右侧。然后应用目录，通过弹窗的形式选到协同路径下 /V5/ApacheJetspeed/webapps/ROOT 目录为止（如下图所示），选好后点下一步：

部署属性，应用名称必须是 ROOT ，应用前缀必须是 / ，其余不用调整，部署顺序默认 100，部署超时设置默认 600，点击下一步，保存。

# 第二步：部署 static 应用：

宝兰德管理控制台 - 应用管理 - 常用应用：继续选择部署

参考“部署 ROOT 应用”章节，部署模式选择“本地模式”，其余不要调整，点击下一步

参考“部署 ROOT 应用”章节，部署目标，把左侧的可选目标放到右侧。然后应用目录，通过弹窗的形式选到协同路径下 /V5/ApacheJetspeed/webapps/static 目录为止（注意是 static，不是 ROOT 了），选好后点下一步

部署属性，应用名称必须是 static ，应用前缀必须是 /static ，其余不用调整，部署顺序默认 100，部署超时设置默认 600，点击下一步，保存。

# 第三步：部署 seeyon 应用：

宝兰德管理控制台 - 应用管理 - 常用应用：继续选择部署

参考“部署 ROOT 应用”章节，部署模式选择“本地模式”，其余不要调整，点击下一步

参考“部署 ROOT 应用”章节，部署目标，把左侧的可选目标放到右侧。然后应用目录，通过弹窗的形式选到协同路径下 /V5/ApacheJetspeed/webapps/seeyon 目录为止（注意是 seeyon，不是 ROOT 了），选好后点下一步

部署属性，应用名称必须是 seeyon ，应用前缀必须是 /seeyon ，部署顺序改成 101，部署超时设置 3600，其余不用调整，点击下一步，保存。

保存后，seeyon 应用会执行启动部署，需要花费一定时间。seeyon 应用是最容易部署失败的，失败效果如下：

如启动失败，到宝兰德实例目录下的 logs 目录，查看部署启动日志 server.log，分析报错原因。

通过实例的 server.log 如果看到“完成初始化 seeyon 资源信息”，就算部署启动成功：

常见部署问题：

1、首次部署 /seeyon 点击“下一步”卡住：这个是正常现象，正在启动协同，如果卡住超过 10 分钟则不是正常现象，要看日志排查！

2、首次部署 /seeyon 时，宝兰德控制台页面突然无法访问：原因是部署启动 /seeyon 报错了，需要到中间件实例 logs/server.log 和协同程序 ApacheJetspeed/logs_sy 目录下根据日志分析排除故障，然后 kill 宝兰德进程，重新启动宝兰德再重新部署 /seeyon。

3、首次部署 /seeyon 时，超过 10 分钟无反应：参考问题 2，排查日志。并且关注中间件日志和协同日志是否在暴增，注意及时停止服务，清理异常的日志，防止磁盘空间占满。

4、如果通过信创部署工具部署，并且配置检查都没问题，启动还莫名报错，重点检查宝兰德是否打过补丁，如果是，则还原宝兰德955初始版重新部署启动。

# 第四步：部署 sportal 应用：

宝兰德管理控制台 - 应用管理 - 常用应用：继续选择部署

参考“部署 ROOT 应用”章节，部署模式选择“本地模式”，其余不要调整，点击下一步

参考“部署 ROOT 应用”章节，部署目标，把左侧的可选目标放到右侧。然后应用目录，通过弹窗的形式选到协同路径下 /V5/ApacheJetspeed/webapps/sportal 目录为止（注意是 sportal，不是 ROOT 了），选好后点下一步

部署属性，应用名称必须是 sportal ，应用前缀必须是 /sportal ，部署顺序改成 102、部署顺序改成 102、部署顺序改成 102，部署超时设置 3600、部署超时设置 3600、部署超时设置 3600，其余不用调整，点击下一步，保存。

通过实例的 server.log 如果看到“sportal was successfully deployed”，就算部署启动成功。

# 全部应用部署后效果

以下是 4 个应用部署后的效果：

# BES955 多实例访问协同服务系统

部署完成后，即可访问协同系统。

宝兰德管理控制台 - 实例管理 - 查看当前实例，找到“http-listener-1_port”的值，这个就是协同访问端口，默认是 18080 端口：

通过浏览器访问 http://服务器IP:18080/seeyon ，如果显示登录页面则部署成功，通过内置的 init-admin 帐号登录系统，进行组织、帐号权限配置：

协同服务地址：http://服务器IP:18080/seeyon
首次登录帐号：init-admin
首次登录密码：123456

# BES955 多实例日常运维操作

# BES955 多实例启停中间件服务

启动宝兰德中间件服务：

# 启动命令：如果确认宝兰德没启动，到中间件 bin 目录下执行启动
cd /data/BES955/AdminServer/bin
# 执行 ./startManagement 命令启动管理控制台
./startManagement
# 随后根据提示，查看启动的 server.log 日志，出现 Started compress log service 则表示成功
tail -f /data/BES955/AdminServer/logs/server.log

停止宝兰德中间件服务：

# 停止命令：同样到中间件 bin 目录下执行如下命令
cd /data/BES955/AdminServer/bin
# 停止时需要验证管理员帐号密码，使用登录管理控制台的用户和密码即可
./stopManagement

判断宝兰德自身服务是否启动的方法：

1、客户端可以通过“访问中间件控制台”章节，浏览器访问中间件控制台，如果连不上，则要到服务器判断服务是否启动。

2、服务器端，通过 ps -ef | grep java | grep server 命令检查宝兰德中间件服务是否处于启动状态，如果路径中包含宝兰德的 server 目录，则表示是宝兰德服务：

# BES955 多实例查看中间件控制台日志

中间件的日志位于：中间件安装目录 /logs/server.log

# 如果按照本手册安装，日志存放于如下地址：
cat /data/BES955/AdminServer/logs/server.log
tail -f /data/BES955/AdminServer/logs/server.log

# BES955 多实例协同服务服务启动步骤

如果要让协同系统可部署、可使用，需要让中间件下的实例处于启动状态：

1、先启动宝兰德 server，参考“启停中间件 Server”，确保宝兰德服务处于启动状态：

2、宝兰德控制台，节点管理菜单 - 启动节点，确保节点处于启动状态：

3、宝兰德控制台，再确保集群处于启动状态（非必须，仅集群菜单下有配置，并且实例依赖集群才启用）

4、宝兰德控制台，实例管理菜单 - 启动实例，确保实例处于启动状态：

5、以上完成后看协同启动日志 tail -f /data/Seeyon/V5/ApacheJetspeed/logs_sy/ctp.log （路径根据项目实际情况调整），如有异常，可以配合实例日志一起分析 tail -f /data/BES955/AdminServer/node/seeyon_node1/instances/seeyon_a/logs/server.log （路径根据项目实际情况调整）。

# BES955 多实例协同服务服务停止步骤

参考“协同服务服务启动步骤”操作：先强制停止实例、再停节点。

也可以访问服务器通过 kill java 进程来停止。

# BES955 多实例获取中间件日志和协同日志

部署完成后，日常分析问题时，中间件日志一般表示实例的日志，存放于实例目录 logs/server.log 文件里：

tail -f /data/BES955/AdminServer/node/seeyon_node1/instances/seeyon_a/logs/server.log

协同服务的日志存放于协同服务目录 logs_sy 下：

tail -f /Seeyon/A8/V5/ApacheJetspeed/logs_sy/ctp.log

与 ctp.log 同级的其它日志也是关键日志文件。

# 宝兰德 BES955 多实例协同服务部署 HTTPS

如果是协同服务单机部署，配置协同服务的 https 有多种方式，如果没有特殊要求，建议采用 Nginx 前置代理 + SSL 方案：保持中间件及容器中的协同不变（默认 http），单独部署一个前置 Nginx 服务，由 Nginx 配置 SSL 并且代理到协同内部服务器。

如果是信创中间件，配置 https 后还需要发起支持单申请一个补丁包，解决在线编辑预览外网 https 不可用问题，参考支持单号：JSFW-2024-02417

Nginx 部署、参数配置及 SSL 配置可以完全参考协同集群部署手册

# 以下标记 * 号的参数根据项目情况按需调整，其余不用动
server {
    listen 443 ssl;  # *监听 443 端口，启用 SSL
    server_name oa.seeyoncloud.com;  # *https 服务器名称设置为域名访问地址
    charset utf-8;
    ssl_certificate ssl/oa.crt;  # *SSL 证书文件路径
    ssl_certificate_key ssl/oa.key;  # *SSL 证书密钥文件路径
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;

    location / {
        proxy_pass http://192.168.94.130:8088/;  # *将请求代理到内部 协同 服务
        proxy_set_header Host $http_host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header REMOTE-HOST $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_redirect http:// $scheme://;

        # 设置超时时间
        proxy_connect_timeout 300;
        proxy_read_timeout 300;
        proxy_send_timeout 300;
    }

    # 自定义错误页面
    error_page 500 502 503 504 /50x.html;
    location = /50x.html {
        root html;
    }
}

# 宝兰德 BES955 多实例协同程序升级

如果早期使用信创部署工具安装部署的协同，后期协同存在升级需求，则只需要下载协同最新版本的 XinChuang，使用信创部署工具一键升级即可。

# BES952部署协同应用

本章节适用于宝兰德BES952版本！

将 BES952 中间件程序包上传后解压至服务器。

# BES952中间件JDK变量设置

通过java -version命令确保当前系统安装了较新的JDK8，并且配置了JAVA_HOME等环境变量。

JAVA_HOME设置openjdk的绝对路径，设置的目录下需存在bin/java文件:

# 通过vi或vim命令修改/etc/profile，设置系统范围的环境变量
vi /etc/profile

# 在vi或vim编辑模式下，将以下四行命令放置到profile文件里，随后通过vi或vim标准方法保存
JAVA_HOME=/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.262.b10-0.el7_8.x86_64/
CLASSPATH=.:$JAVA_HOME/lib/tools.jar
PATH=$JAVA_HOME/bin:$PATH
export JAVA_HOME CLASSPATH PATH

# 重新加载/etc/profile文件，使更改立即生效
source /etc/profile

# BES952初始化及启停服务

初始化：进入中间件安装目录下bin下(路径根据实际路径修改)，执行./initstore命令：

cd /home/BES-CLUSTER-9.5.2/bin
./initstore

将控制台进程设置为开机自启动：

启动控制台：

systemctl start bescluster95.service

通过systemctl status bescluster95.service可以查看服务状态为active(running)

通过netstat -ntlp|grep 6900可以看到6900端口已启动

另外宝兰德还支持如下命令启动、停止方式：

其它启动服务方法：
./startManagement
停止控制台服务
./stopManagement

服务启动后，浏览器访问：http://宝兰德服务器IP:6900/console

默认用户名：admin

默认密码：B#2008_2108#es

登录后不要修改默认密码，后续信创部署工具部署必须用默认密码才能执行！

# BES952实例准备

在完成前面小章节操作，确保能访问宝兰德管理控制台之后，再还行安装部署协同服务操作！

# BES952密码说明

首次登录，若有提示修改密码，由于信创部署工具内部依赖默认密码（B#2008_2108#es），本次请先取消修改。

待部署或升级成功后，再进入到个人信息中进行密码修改

# BES952新增主机

安装部署协同前，先新建主机：

名称：可任意填写，自定义，如seeyon

主机名IP：填写IP地址（请勿填写127.0.0.1）

用户名与密码：填写SSH远程访问服务器的用户及密码（此步操作等于是宝兰德控制台服务通过SSH自动连接服务器）

主机创建完成后，可点击主机再次进入，点击ping测试是否成功，如果成功即表示可以通过上述配置的IP地址及用户密码成功登录该主机：

# BES952节点管理

安装部署协同前，还需要完成创建节点、安装、修改、启动节点。

创建节点：

录入节点信息，选择上一步录入的主机，及节点存放位置（可单独指定，当前配置是存放于BES中间件目录下）。

节点名称：自定义，如seeyon_node1

节点目录：即是节点安装的绝对路径，指向宝兰德中间件程序目录下的node（与bin目录同级），默认node目录不存在，首次启动会自动创建。通俗说：将节点目录设置在宝兰德程序里，命名为node，后续部署需要。

安装节点：

节点属性修改保存后，点击安装节点。

修改节点属性：

修改节点属性，timeout设置调大：

启动节点：

# BES952实例管理

安装部署协同前，还需要完成实例的创建，协同最终是安装到创建的实例目录中。

创建实例：

创建实例后，在实例列表，启动实例。

实例列表会显示实例的地址，务必记住这个地址，后续信创部署工具部署时需要！

# BES952使用信创部署工具

从致远商务公布的安装程序下载地址中，下载对应版本的XinChuang.zip部署包，并解压到系统中：

# 同样将XinChuang.zip解压到/data/目录进行操作
mv 2.V9.0SP1_XinChuang.zip /data/
cd /data
unzip 2.V9.0SP1_XinChuang.zip

XinChuang包中有一个信创部署工具，是致远自研产品，工具将很多人工操作的步骤写到程序中，由工具程序来自动完成。

包括并不仅限于：配置JVM、调整jar包、设置产品标识、部署协同程序、导入数据库脚本等，极大提升部署效率，减少错误率。

只要使用信创部署工具安装协同，后续协同版本升级，也可以用信创部署工具一键平滑升级。

故能用信创部署工具的环境，一定都用工具做部署、升级！

信创部署工具位于XinChuang/deploytools目录下，支持图形界面部署和命令行静默部署两种方式，如果有图形化界面，建议优先使用图形界面方式。

图形化部署：使用命名含GUI的 deployGUI-for-版本号-产品线.sh程序启动
命令行部署：使用命名含cli的 deploycli-for-版本号-产品线.sh程序启动

# BES952信创部署工具图形化安装

本小节适用于带图形化的Linux或信创操作系统。

安装前，首先确定一个协同程序的安装路径，通过 mkdir -p /data/Seeyon命令创建目录，以后协同程序就在/data/Seeyon目录下维护。

安装前，还要确保宝兰德中间件已经准备就绪，并且按照要求进行了实例目录的启动。

安装前，确保宝兰德管理控制台的默认密码未被修改过，信创部署工具使用宝兰德默认的密码进行接口登录并部署安装前，确认好客户使用什么数据库，如果是当前版本标准产品支持的数据库，则只需要初始化一个空库（即使是老客户转信创也建议先建空库测试启动），信创工具会自动写入SQL数据。

以上准备就绪后，参考如下命令启动图形化部署工具：

# 到XinChuang部署目录deploytools
cd /data/2.V9.0SP1_XinChuang/deploytools
# 先赋予可执行权限（如果是G6则操作G6N结尾的可执行文件）
chmod +x deployGUI-for-V9.0SP1-A8N.sh
# 再启动GUI可执行程序（如果是G6则操作G6N结尾的可执行文件）
./deployGUI-for-V9.0SP1-A8N.sh

图形化参数说明：

安装/升级：全新部署勾选“安装”选项，已经通过工具安装过协同，本次升级版本则选“升级”选项。

CPU：目前支持ARM、MIPS、x86三类，根据当前系统实际情况选择

系统：只有CPU类型为ARM时才需要选择，支持选项：统信uos、麒麟kylin

中间件：根据实际情况选择，宝兰德BES952就选 Bes

协同路径：可自定义，比如本例设置为 /data/Seeyon ，此目录需要提前创建，未创建目录会报错

中间件路径：对应宝兰德BES952的实例目录，通过宝兰德管理控制台-实例管理能查询到实例位置（不包含IP端口部分），如大改格式是xxx/node/seeyon_node1/instances/seeyon_a

协同产品线、在线人数：根据实际情况选择，在线人数尽量预估准确，不同在线人数，工具会给不同的JVM配置

数据库：下拉列表中能选到的就是标准支持的库，只要准备好空库，工具会自动向空库中写入协同初始化SQL；如数据库不在标准支持范围，则下拉列表选择“不初始化数据库”，这类“不初始化数据库”场景，在工具部署完成后，需要手动初始化数据。

JDBCDriver：根据选择的数据库自动生成，无需修改

JDBC URL：需要修改IP、端口、库名（数据库空库需要提前创建，见前面章节说明）

数据库用户、密码：根据实际情况填写

以上填写完整后，先进行“验证参数”，通过后再“部署”，部署需要一定时间，请耐心等待。

如数据库选择“不初始化数据库”，安装结束后提示“未找到对应数据库版本驱动JAR，请手动放置数据库驱动”的提示，可以忽略，部署是成功的。完成部署后，手工关闭安装程序退出。

信创部署工具日志文件位于：2.V9.0SP1_XinChuang/deploytools/logs 目录下，如遇到部署异常可通过日志分析问题。

部署完成后重启实例： 部署完成后，回到宝兰德控制台实例菜单，需要重启下实例，才能让刚才部署的配置生效。

# BES952信创部署工具命令行安装

命令行部署，又叫静默部署，如果无法使用上一章节“图形化安装”，则尝试使用本章节命令行静默安装的模式。

第一步：修改installConfig.properties

通过修改信创部署目录XinChuang/deploytools/cfgHome/installConfig.properties配置文件，配置必要的参数：

到XinChuang部署目录deploytools/cfgHome，修改installConfig.properties文件参数

vim installConfig.properties

installConfig.properties配置文件中的参数与图形化部署界面一模一样，这里面的参数直接参考上一个图形化安装章节填写。

再次提醒：请不要凭感觉填写配置，认真参考“图形化部署”章节，熟悉每一个配置和注意事项后再操作！

第二步：修改deploycli脚本，设置状态为install

找到我们本次要命令行启动执行的sh脚本文件，修改一点配置：

# 到XinChuang部署目录deploytools
cd /data/2.V9.0SP1_XinChuang/deploytools
# 修改命令行启动脚本文件（如果是G6则操作G6N结尾的可执行文件）
vim deploycli-for-V9.0SP1-A8N.sh

修改sh脚本文件里末尾的参数，将默认的upgrade（更新升级）改为install （安装部署）：

第三步：执行命令行部署sh脚本：

先赋予可执行权限，再执行sh脚本：

# 到XinChuang部署目录deploytools
 cd /data/2.V9.0SP1_XinChuang/deploytools
 # 先赋予可执行权限（如果是G6则操作G6N结尾的可执行文件）
chmod +x deploycli-for-V9.0SP1-A8N.sh
 # 再启动GUI可执行程序（如果是G6则操作G6N结尾的可执行文件）
./deploycli-for-V9.0SP1-A8N.sh

部署完成后重启实例： 部署完成后，回到宝兰德控制台实例菜单，需要重启下实例，才能让刚才部署的配置生效。

# BES952检查JVM配置

通过信创部署工具部署后，需要做如下检查，如无相关参数，则要检查是否部署正确。

如果无法通过部署工具操作，则通过手动解压XinChuang安装协同后，同步在宝兰德中间下做如下配置。

访问宝兰德管理控制台-协同的实例：

检查实例系统属性：

com.bes.enterprise.web.util.scan.StandardJarScanFilter.jarsToSkip-test *

com.bes.enterprise.web.compiler.ignoreHtmlComment false

修改实例的JVM配置：

根据实际可用内存调整堆设置，元空间初始值和最大值配置成一致，建议2048M

修改页面下方JVM选项

增加参数：-Djava.awt.headless，值为true

增加参数：-XX:ReservedCodeCacheSize，值为1G。

增加参数：-XX:GCLogFileSize=10m

增加参数：-XX:NumberOfGCLogFiles=8

增加参数：-XX:+UseGCLogFileRotation

增加参数：-XX:+PrintGCDetails

增加参数：-XX:+PrintGCTimeStamps

增加参数：-XX:+PrintGCDateStamps

增加参数：-Xloggc:/seeyon/V5/ApacheJetspeed/logs (此处目录需要替换为当前环境的部署目录，并且若logs不存在，需要手动创建)

增加参数：-Dsun.zip.disableMemoryMapping=true

增加参数：jdbcproxydriver.driverclass数据库驱动类名配置(针对所用数据库配置指定信息)：

人大金仓：-Djdbcproxydriver.driverclass=com.kingbase8.Driver

达梦：-Djdbcproxydriver.driverclass=dm.jdbc.driver.DmDriver

神通：-Djdbcproxydriver.driverclass=com.oscar.Driver

南大通用：-Djdbcproxydriver.driverclass=com.gbasedbt.jdbc.Driver

修改完成上述参数保存后，启动实例，此时在节点instances目录将生成实例目录。

再使用控制台-实例管理-停止实例，修改实例配置default-web.xml文件：

vim /home/BES-CLUSTER-9.5.2/node/seeyon_node1/instances/seeyon_a/conf/default-web.xml

添加如下配置：

<init-param>
	<param-name>trimSpaces</param-name>
	<param-value>false</param-value>
</init-param>

实例jar包更新（信创部署工具安装的场景，无需本步操作）

进入到信创包ApacheJetspeed/lib下：

将9.0SP1协同安装路径/Seeyon/A8/V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib/下log4j-api.jar、log4j-core.jar、log4j-1.2-api.jar、log4j-jcl.jar、seeyon-ctp-jdbcproxydriver.jar、druid.jar、jmx_prometheus_javaagent.jar剪切到实例的/lib/目录下。

将9.0SP1协同安装路径/Seeyon/A8/V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib/下commons-logging.jar、seeyon-ctp-dbpool.jar、seeyon-ctp-log-log4j.jar、disruptor.jar、woodstox-core-asl.jar、stax2-api.jar、stax-api.jar、guava.jar、sqlite-jdbc.jar、websocket-api.jar复制到实例的/lib/目录下。

如果ApacheJetspeed\webapps\seeyon\WEB-INF\lib下没有，就到ApacheJetspeed/lib目录下拷贝!

确保删除/Seeyon/A8/V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib/seeyon-ctp-jdbcproxydriver.jar是删除的。

拷贝对应数据库驱动文件到实例的lib目录：

达梦数据库：

cp DmJdbcDriver18.jar /home/BES-CLUSTER-9.5.2/node/seeyon_node1/instances/seeyon_a/lib/

人大金仓数据库（注意区分R3和R6版本驱动，使用对应数据库版本驱动）：

cp kingbase8-8.6.0.jar /home/BES-CLUSTER-9.5.2/node/seeyon_node1/instances/seeyon_a/lib/

注意：若数据库非mysql、Oracle、SQLserver、达梦、神通、人大金仓、南大通用、数据库驱动需要手动拷贝。

# BES952检查线程池配置

调整实例最大线程池大小为4096。

修改post请求体大小限制，改为 -1

以上操作完成后启动实例。

# BES952检查JDBC数据源

参数导航：选择资源管理-JDBC-单数据源，点击部署-新建，数据源：

JDBC标准名称（JNDI）：jdbc/ctpDataSource

下图为达梦数据库配置：

数据库驱动供应商选择：DM（达梦）

资源类型：java.sql.Driver

数据库驱动类类名：
达梦、人大金仓、神通、南大通用数据库驱动类名均修改为：
com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver

连接配置：正确输入数据库服务器ip，端口、数据库名，用户名密码

URL(示例)：jdbc:dm://10.3.4.206:5236/SEEEYON

下图为人大金仓数据库配置：

数据库驱动供应商选择：Kingbase(人大金仓)

资源类型：java.sql.Driver

数据库驱动类类名：com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver

连接配置：正确输入数据库服务器ip，端口、数据库名，用户名密码

URL(示例): jdbc:kingbase8://192.168.225.40:54321/v81_r6?clientEncoding=UTF-8

注意：选择数据库驱动厂商后默认的kingbase需要改为kingbase8，在驱动类名和url两处都需要修改，url数据库名后加上：?clientEncoding=UTF-8

数据源配置输入完成后，点击下一步，修改连接数。

下一步选择部署目标，添加到右侧即可：

下一步：高级配置

事务隔离级别：READ_COMMITTED

自动提交：必须勾选

释放连接时回滚：必须勾选

ps:宝兰德去年发布的中间件版本9.5.5开始，其提供的数据库连接池参数：自动提交和释放连接时回滚默认不再勾选,请主动进行勾选上

最后一步，保存。

再次点击数据源展开数据源配置页面，点击下方ping按钮，测试数据源连通性。

若配置检及jar包拷贝无误，但是ping数据库连接始终错误，错误信息如下：

# BES952部署应用

在完成以上部署和配置检查后，进行最后的协同应用部署：

特别说明：协同的所有应用（root、seeyon、static、sportal）需要部署在一个实例下，不支持在多个实例下分开部署

应用调整：

1. （自动）删除ApacheJetspeed/webapps/ROOT/META-INF/context.xml

 cd ApacheJetspeed/webapps/ROOT/META-INF

 rm context.xml

2. （自动）修改 ApacheJetspeed/webapps/seeyon/WEB-INF/web.xml 文件

 cd ApacheJetspeed/webapps/seeyon/WEB-INF

 vim web.xml

 加入以下行配置

 metadata-complete="true"

（自动）新建bes-web.xml新建文件

 cd ApacheJetspeed/webapps/seeyon/WEB-INF

 vim bes-web.xml

输入以下内容

 <bes-web-app>
 <class-loader delegate="false" />
 <property name="requestCharacterEncoding" value="utf-8" />
 </bes-web-app>

（自动）放置产品标识文件：

将部署包 deploytools/file/productiden 中的文件，按产品线（A8V5-1：A8 企业版、A8V5-2： A8 集团版、A8N-1：A8-N 企业版、A8N-2：A8-N 集团版、G6N-1：G6-N单组织、G6N-2：多组织、G6SU-1：督查督办单组织、G6SU-2：督查督办多组织）拷贝对应文件夹下对应版本的 ApacheJetspeed 文件夹，覆盖 V5 目录下的 ApacheJetspeed。

放置license：

将产品授权 license 注册后（注册使用标准产品安装包中的 updateDog），放置在部署包 V5/base/license 下。

部署ROOT

BES 中间件菜单【应用管理-常用应用】

依次选择A8N 应用 webapps 目录下 ROOT 应用。

部署模式选本地模式，点击下一步

选择部署目标到右侧，应用目录选择ROOT目录位置，点击下一步

输入应用名称:ROOT，应用前缀输入/，部署顺序默认100，点击下一步，保存。

部署static应用：

参考ROOT部署步骤，选择部署包ApacheJetspeed/webapps 目录下static应用。

应用名称为static，应用前缀为/static，其它默认即可。

部署seeyon应用：

应用前缀修改为/seeyon，部署顺序101 ，部署超时改为3600，点击保存开始部署。

部署sportal应用：

应用前缀修改为/sportal，部署顺序102 ，部署超时改为3600，点击保存开始部署。

跟踪部署过程。

 cd \$节点目录/节点名/instances/实例名/logs/

 tail -f server.log

显示 successfully deployed in ** ms.即部署完成，可通过浏览器访问应用。

用户访问端口默认为18080，访问地址：http://中间件服务器ip:18080，可通过实例管理-基本信息-系统属性（http-listener-1_port）修改为指定端口。

后续启动与停止：

1.应用部署成功后可以登录管理控制台进行节点、实例的启停，启动实例会关联启动应用。 2.如果需要开机自动启动节点、实例及应用，在节点管理注册服务即可；如不需要服务启动则在此处删除服务。

3. 系统代码更新

应用系统代码更新后，需在启动实例服务前，清除中间件缓存。

 cd \$节点目录/节点名/instances/实例名/work

 rm -rf \*

如图所示，路径根据实际修改：

# BES952常见问题

问题1：访问页面报http 500错误或者界面报错查看localhost无法找到jsp.index.jsp

解决：

需要按版本拷贝版本标识文件，V8.1_XinChuang/deploytools/file/productiden A8N-1/A8N-2中 ApacheJetspeed拷贝到V8.1_XinChuang/V5下,文件拷贝后重新部署应用。

问题2：部署后访问首页报错：出现异常:java.lang.NullPointerException:null

Server.log日志记录如下异常：

解决：达梦数据库初始化数据库时没有执行commit，数据库丢失数据。删除数据库，重新初始化数据库，记得commit;

问题3：部署后应用启动报错，server.log记录如下异常信息：

Caused by: java.lang.NumberFormatException: For input string: \"8

\"

at java.lang.NumberFormatException.forInputString(NumberFormatException.java:65) \~\[?:1.8.0_292\]

at java.lang.Integer.parseInt(Integer.java:580) \~\[?:1.8.0_292\]

at java.lang.Integer.parseInt(Integer.java:615) \~\[?:1.8.0_292\]

at dm.jdbc.driver.DmdbDatabaseMetaData.do_getDatabaseMajorVersion(Unknown Source) \~\[DmJdbcDriver18.jar:- 8.1.0.147 - Production\]

at dm.jdbc.driver.DmdbDatabaseMetaData.getDatabaseMajorVersion(Unknown Source) \~\[DmJdbcDriver18.jar:- 8.1.0.147 - Production\]

at com.bes.enterprise.gjc.spi.DelegatingDatabaseMetaData.getDatabaseMajorVersion(DelegatingDatabaseMetaData.java:268) \~\[bes-jdbcra.jar:9.5.2\]

at com.bes.enterprise.gjc.spi.DelegatingDatabaseMetaData.getDatabaseMajorVersion(DelegatingDatabaseMetaData.java:268) \~\[bes-jdbcra.jar:9.5.2\]

解决：达梦数据库驱动文件有问题，重新拷贝DmJdbcDriver18.jar到实例的lib目录下（如：/home/BES-CLUSTER-9.5.2/node/seeyon_node1/instances/seeyon_a/lib/），重启实例。

问题4：mysql8.0以上数据库配置后报连不上数据库

解决：宝蓝德9.5.2数据库兼容性问题，mysql数据库更换为5.7版本即可

编撰人：zhangshuang、het、chenxy

快速跳转

宝兰德BES中间件信创环境部署手册

← 音视频服务集群部署手册信创端_督查督办插件升级手册 →

# 宝兰德BES中间件信创环境部署手册

# 修订记录

# 适配的信创环境

# 环境资源准备清单

# 部署结构和硬件配置

# 注意事项

# BES955多实例部署协同应用

# BES955 多实例准备

# BES955 多实例初始化

# BES955 多实例访问中间件控制台

# BES955 多实例实例准备

# BES955 新增主机

# BES955 新建节点

# BES955 启动节点

# BES955 新建实例

# BES955 启动实例

# BES955多实例程序部署

# BES955 多实例 - XinChuang部署工具准备

# BES955 多实例 - 图形化部署

# BES955 多实例 - 命令行部署

# BES955 多实例 - 纯手工部署

# BES955 多实例-调整中间件配置

# BES955 多实例检查系统配置

# BES955 多实例检查JVM

# BES955 多实例检查 default-web.xml

# BES955 多实例检查线程池配置

# BES955 多实例 检查JDBC 数据源

# BES955 多实例部署应用目录

# BES955 多实例-部署应用准备

# 第一步：部署 ROOT 应用：

# 第二步：部署 static 应用：

# 第三步：部署 seeyon 应用：

# 第四步：部署 sportal 应用：

# 全部应用部署后效果

# BES955 多实例访问协同服务 系统

# BES955 多实例日常运维操作

# BES955 多实例启停中间件服务

# BES955 多实例查看中间件控制台日志

# BES955 多实例协同服务 服务启动步骤

# BES955 多实例协同服务 服务停止步骤

# BES955 多实例获取中间件日志和 协同 日志

# 宝兰德 BES955 多实例协同服务 部署 HTTPS

# 宝兰德 BES955 多实例 协同 程序升级

# BES952部署协同应用

# BES952中间件JDK变量设置

# BES952初始化及启停服务

# BES952实例准备

# BES952密码说明

# BES952新增主机

# BES952节点管理

# BES952实例管理

# BES952使用信创部署工具

# BES952信创部署工具图形化安装

# BES952信创部署工具命令行安装

# BES952检查JVM配置

# BES952检查线程池配置

# BES952检查JDBC数据源

# BES952部署应用

# BES952常见问题

快速跳转

# BES955 多实例检查JDBC 数据源

# BES955 多实例访问协同服务系统

# BES955 多实例协同服务服务启动步骤

# BES955 多实例协同服务服务停止步骤

# BES955 多实例获取中间件日志和协同日志

# 宝兰德 BES955 多实例协同服务部署 HTTPS

# 宝兰德 BES955 多实例协同程序升级