# 中创中间件项目化部署手册
# 适配版本(参考)
此手册适用于中创中间件安装部署致远应用(A8-N V8.1SP1以上版本)。
关联支持项目:PMP-JFZC-2024-5091、JSFW-2024-00310、PMP-JFZC-2024-532、PMP-JFZC-2024-4493
项目化支持,意味着可能存在项目化适配成本,可能存在缺陷,并且后续产生的BUG可能需要额外项目化成本解决
# 中创产品准备
中创中间件依赖完整的jdk工具,不能只使用jre运行时环境,否则启动完成后,访问会报错
根目录创建文件夹/cvicse,将中创中间件产品包上传至服务器/cvicse目录下并解压。
unzip InforSuiteAS_StE_V10.0.5.0.1.zip -d /cvicse
# 中创的授权文件
中创的正常使用需要授权文件(一般为license.infor),在购买中间件时应及时获取授权文件,在安装后将授权文件放置在/cvicse/InforSuiteAS_StE_V10.0.5.0.1/as目录下。
# 修改JVM配置
修改jvm配置,进入/cvicse/InforSuiteAS_StE_V10.0.5.0.1/as/domains/domain1/config目录,修改domaim.xml文件,在9009端口下添加。
(1)覆盖javax,org.apache开头的特定包,使应用使用自带的API包。
<jvm-options>-Dcom.cvicse.loong.enterprise.overrideablejavaxpackages=javax.ws.rs,javax.validation,org.apache.taglibs.standard</jvm-options>
(2) 增加jdbcproxydriver.driverclass数据库驱动类名配置。
(针对所用数据库配置指定信息):
人大金仓:-Djdbcproxydriver.driverclass=com.kingbase8.Driver
达梦:-Djdbcproxydriver.driverclass=dm.jdbc.driver.DmDriver
神通:-Djdbcproxydriver.driverclass=com.oscar.Driver
Gbase8s:-Djdbcproxydriver.driverclass=com.gbasedbt.jdbc.Driver
<jvm-options>-Djdbcproxydriver.driverclass=com.gbasedbt.jdbc.Driver</jvm-options>
# 配置inforsuite-web.xml
在/Seeyon/A8/V5/ApacheJetspeed/webapps/seeyon/WEB-INF目录下添加inforsuite-web.xml文件,内容如下。
<?xml version="1.0" encoding="UTF-8"?>
<inforsuite-web-app>
<!--调整类加载优先级,优先加载应用下的类-->
<class-loader delegate="false"/>
<!--关闭Url重写-->
<session-config>
<session-properties>
<property name="enableURLRewriting" value="false" />
</session-properties>
</session-config>
<!--配置请求编码-->
<locale-charset-info>
<parameter-encoding default-charset="UTF-8" />
</locale-charset-info>
</inforsuite-web-app>
# 信创部署工具安装A8-N版本
参考A8-N8.1sp2信创环境部署手册中该章节操作。
https://open.seeyoncloud.com/v5doc/34/627/638/643.html#_8-信创部署工具安装a8-n版本 (opens new window)
# 调整产品jar包
# 8.x版本
(1)剪切/Seeyon/A8/V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib下的xalan.jar、wstx-asl.jar、seeyon-ctp-jdbcproxydriver.jar、seeyon-ctp-dbpool.jar、serializer.jar到中创安装目录as\lib下
注意:检查seeyon-ctp-jdbcproxydriver.jar包中
com\seeyon\ctp\monitor\perf\jdbcmonitor\proxyobjProxyDriverList.properties是否有相关数据库配置(此检查为适配Gbase8s数据库,标准支持的数据库无需检查)
例如:Gbase8s数据库配置
(2)剪切/Seeyon/A8/V5/Apachejetspeed/lib下的seeyon-statistics.jar到中创安装目录as\lib下
(3)复制/Seeyon/A8/V5/ApacheJetspeed/webapps/seeyon/WEB-INF/lib下的druid.jar、guava.jar到中创安装目录as\lib下。
(4)删除/Seeyon/A8/V5/ApacheJetspeed/webapps/ROOT/META-INF/context.xml
(5)将所用数据库驱动jar包,放入/cvicse/InforSuiteAS_StE_V10.0.5.0.1/as/lib目录下。
# 9.x版本
(1)剪切 webapps/seeyon/WEB-INF/lib/下的seeyon-ctp-dbpool.jar seeyon-ctp-jdbcproxydriver.jar seeyon-statistics.jar druid.jar commons-lang3.jar commons-codec.jar commons-logging.jar commons-modeler.jar log4j-1.2-api.jar log4j-jcl.jar log4j-api.jar log4j-core.jar jmx_prometheus_javaagent.jar到中创安装目录as/lib下
(2)复制 webapps/seeyon/WEB-INF/lib/下的stax-api.jar stax2-api.jar woodstox-core-asl.jar disruptor.jar seeyon-ctp-log-log4j.jar mocnoyeeswz.jar seeyon-util.jar ctp-db-pwd-coder.jar ctp-db-pwd-clzzloader.jar seeyon-ctp-file.jar guava.jar到中创安装目录as/lib下
提示:如果在webapps/seeyon/WEB-INF/lib/没有找到对应的jar,可以检查是否在ApacheJetspeed/lib下,然后拷贝过去 9.0sp1最新版本已经没有 seeyon-ctp-giant-panda.jar,可以不用拷贝
(3)删除/Seeyon/A8/V5/ApacheJetspeed/webapps/ROOT/META-INF/context.xml
# sqlite驱动问题
部署seeyon过程报错
信创环境下注意需要替换sqlite驱动
- 首先删除 webapps/seeyon/WEB-INF/lib/sqlite-jdbc.jar 或挪走备份
- 然后尝试放置低版本的驱动 sqlite-jdbc-3.7.2.jar 到中间件的 as/lib下
- 部分cpu架构下,如果无法使用 sqlite-jdbc-3.7.2.jar,则需要自行编译 参考https://open.seeyoncloud.com/v5doc/142/1190/731.html
# 放置license
将产品授权license注册后(注册使用标准产品安装包中的updateDog),放置在协同安装路径/Seeyon/A8/V5/base/license下。
序号 软加密文件名(区分大小写) 版本
1 a6v5.seeyonkey A6+企业版
2 a8v5.seeyonkey A8+企业版/A8+集团版
3 g6v5.seeyonkey G6+单组织版/G6+多组织版
4 a8nv5.seeyonkey A8-N企业版/A8-N集团版
5 g6nv5.seeyonkey G6-N单组织版/G6-N多组织版
# 6 g6suv5.seeyonkey 督查督办单组织版/督查督办多组织版
# 启动中创
进入/cvicse/InforSuiteAS_StE_V10.0.5.0.1/as/bin目录,启动中创中间件。
启动命令:sh asadmin start-domain
停止命令:sh asadmin stop-domain
# 中创的配置
在中创应用服务器软件 10.0.5.2 版本以后,默认访问端口8060,通过 url:https://ip:8060 访问,默认的用户名:inforsAdmin;密码:Cvicse@as123。 在 10.0.5.2 版本之前,默认的访问端口是 8060,通过http://ip:8060 来访问。用户名:admin;密码:Cvicse@as123。
首次登录之后需修改默认密码。
# 数据源的配置
数据库驱动类名: com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver
JDBC连接串格式:
Kingbase(人大金仓v8) jdbc:kingbase8://数据库ip:54321/数据库名
达梦v8: jdbc:dm://数据库ip:5236/数据库名
Gbase8s: jdbc:gbasedbt-sqli://数据库ip:9088/test:GBASEDBTSERVER=test;
神通数据库: jdbc:oscar://数据库ip:2003/数据库名
# 中创10.0.5.2版本以前
# Gbase8s数据库
(1)登录中创管理控制台-->【资源】-->【JDBC】-->【JDBC连接池】-->【新建】
,输入池名称:seeyon,选择资源类型:java.sql.Driver,数据库驱动程序供应商选择对应数据库名:GBase(这里以GBase为例),点击下一步。
(2)修改数据库驱动类名称:com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver,下滑至最后输入user,password,Url,点击保存。
(3)连接池试通:检测创建好的连接池是否正确。
(4)【资源】-->【JDBC】-->【JDBC资源】-->【新建】,输入JNDI名称:jdbc/ctpDataSource,选择池名称:seeyon,点击确定完成创建。
# 亚信数据库
亚信数据库(antdb-7.1.0)基于mysql8.0.32 由于mysql属于标准支持,因此不需要配置驱动类代理
(1)登录中创管理控制台-->【资源】-->【JDBC】-->【JDBC连接池】-->【新建】 输入池名称:seeyon,选择资源类型:java.sql.Driver,数据库驱动程序供应商选择对应数据库名:mysql8,点击下一步。
(2)修改数据库驱动类名称:com.mysql.cj.jdbc.Driver,下滑至最后输入user,password,Url,点击保存。
jdbc:mysql://数据库地址:端口/数据库名?autoReconnection=true&characterEncoding=UTF-8&serverTimezone=GMT&useSSL=false
(3)连接池试通:检测创建好的连接池是否正确。
(4)【资源】-->【JDBC】-->【JDBC资源】-->【新建】,输入JNDI名称:jdbc/ctpDataSource,选择池名称:seeyon,点击确定完成创建。
# 中创10.0.5.2版本以后
(1)登录中创管理控制台-->【资源】-->【JDBC】-->【JDBC连接池】-->【新建】 输入池名称:seeyon,选择资源类型:java.sql.Driver,数据库驱动程序供应商必须写 seeyon,点击下一步。
(2)数据库驱动程序类名称会自动显示:com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver 然后继续修改连接池属性及user,password,Url,点击保存。
(3)连接池试通:检测创建好的连接池是否正确。
(4)【资源】-->【JDBC】-->【JDBC资源】-->【新建】,输入JNDI名称:jdbc/ctpDataSource,选择池名称:seeyon,点击确定完成创建。
# OBS配置
对于使用OBS的环境,需配置OBS相关参数。
开启远程对象存储 #是否开启远程对象存储(默认值:false)
Access Key #对象存储的Access Key
Security Key #对象存储的Security Key
endPoint #对象存储的URL
桶名 #对象存储的桶名
路径 #需要把文件保存到远端对象存储的路径(多个路径用","分隔);使用CtpFile操作文件时,如果文件全路径中包含如下路径,就会保存到远程对象存储中,否则只会存储到本地
注意:
当前版本仅适配华为云对象存储;
OBS模式已按照插件方式开发,需要在加密狗中授权OBS模式,然后对应的配置才会生效,否则配置不生效
# 部署应用
部署致远协同应用需注意,应用授权
- 管理控制台,【应用程序】->【部署】
- 选择要部署的应用文件夹,上下文根:ROOT(上下文/),seeyon(上下文/seeyon)、static(上下文/static),sportal(上下文/sportal),虚拟服务选择server,类加载勾选取消,点击确认。
# 应用启动及访问
【应用程序】->【访问】。
点击访问跳转到如下页面,点击链接访问即可。
# 常见问题
【启动问题】中创部署协同V9.0启动不了,最开始报错存在dynamicColumnRequestListenerRegister关键字异常 临时解决方案:https://open.seeyoncloud.com/#/faq/faq/v1/share?url=Z2JySmU+MjMxNg== 正式解决方案: 联系中创技术获取补丁包,替换中间件目录下的 as/modules/web-core.jar ,同时清理域目录下的缓存(如图),再启动