系统运维

# 优炫数据库项目化部署手册

北京致远互联软件股份有限公司

2025年2月修订

# 前言

优炫数据库标准产品未支持，目前可项目化支持适配，适配方案不保证所有功能绝对可用，并且OA版本后续升级的成本比其他标准支持的数据库要高。

项目化支持，意味着可能存在项目化适配成本，可能存在缺陷，并且后续产生的BUG可能需要额外项目化成本解决

适配OA版本：9.0SP1，暂不涉及客开代码适配

数据库基础信息：

我们需要设置优炫数据库兼容Postgresql，设置之后就可以按照如下参数部署：

数据库url格式=jdbc:postgresql://127.0.0.1:52025/zyoa?currentSchema=oa
JDBC驱动名driverClassName=org.postgresql.Driver
JDBC连接获取数据库名DatabaseMetaData.getDatabaseProductName()=PostgreSQL
驱动jar：使用优炫数据库安装程序下的JDBC驱动jar，PG模式下，优炫推荐postgresql-42.2.2.jar

总部项目化支持成本预估：

  • 新客户：理论不涉及客开，总部项目环境运维支持成本2人天，项目实施成本自行预估

  • 老客户转优炫数据库：理论不涉及客开，总部项目环境运维支持成本4人天（主要成本是转库后字段异常的问题分析），项目实施成本自行预估（主要是验证及问题协调解决）

  • 未来OA升级：客开+项目运维成本7人天（标准工具不认识优炫库，涉及升级程序修改、兼容、测试等），项目实施成本自行预估（主要是验证及问题协调解决）

# 优炫数据库注意事项

致远OA对数据库的要求：

  • 大小写不敏感（如存在此配置，需勾选）
  • UTF8字符集
  • 支持单机或主备，不支持读写分离
  • 兼容Postgresql数据库

需要设置兼容PG数据库：

1、打开数据库实例目录（数据库启动命令-D 后的路径 如： -D/home/uxdata） 即进入/home/uxdata/目录。
2、打开 uxsinodb.conf文件，找到节点：shared_preload_libraries
3、增加内容[,postgres_adaptor],然后保存。完整字符串为：shared_preload_libraries = 'orafce,postgres_adaptor'。
4、重启数据库服务。ux_ctl restart  -D /home/uxdata

优炫数据库一个帐号支持多模式，必须将OA表数据所在的模式设置在最前面（比如schema=oa是OA相关的表数据，必须设置search_path将oa放在第一个）

如果是致远老客户，涉及升级OA，一般是先用非信创的SeeyonInstall升级到OA目标版本，再做转库。转库的字段映射请让优炫厂商参考致远的字段对照表去做，避免转库字段错误。

以下是标准产品不同数据类型、字段的映射关系，可以提供给第三方数据库厂商参考，如厂商不需要，可忽略本步操作：

MySQL ORACLE SQLSERVER POSTGRESQL JAVA POJO类型 场景
BIGINT INTEGER BIGINT INT8 java.lang.Long 主键
DATE DATE DATETIME TIMESTAMP(0) java.util.Date 日期
DATETIME DATE DATETIME TIMESTAMP(0) java.util.Date 日期时间
DECIMAL NUMBER NUMERIC NUMERIC java.lang.Double 小数
INT INTEGER INT INT4 java.lang.Integer 整数
LONGBLOB BLOB IMAGE BYTEA java.lang.String 二进制对象
LONGTEXT CLOB NTEXT TEXT java.lang.String 大文本
SMALLINT NUMBER(4) SMALLINT INT2 java.lang.Integer 数字枚举
VARCHAR VARCHAR2 NVARCHAR VARCHAR java.lang.String 文本

# 部署示例

OA版本：A8-N V9.0SP1

金蝶V10

# 部署流程

1、中间件（东方通、金蝶、宝兰德）提前准备，优炫数据库提前准备（如果是新客户就准备一个空库，如果是老客户就做好转库）

2、参考信创环境部署手册，准备对应的XinChuang.zip信创部署包，使用信创部署工具将OA相关基础配置写入中间件中，数据库选择“不初始化数据库”，初始化结束后将-N的加密授权注册更新并放置到OA程序base/license目录下。

再次提醒：标准支持的中间件用信创部署工具去部署，减少部署复杂度，降低部署失败概率！！！

3、如果是新客户，由优炫厂商安装好数据库并新建一个空库后，执行数据库初始化操作，继续使用上一步的XinChuang.zip部署包。

初始化数据库脚本在XinChuang文件夹下的deploytools\file\sql\init目录中找到对应版本的PostgreSQL（A8N-1是企业版，A8N-2是集团版），如企业版命名为：A8N-1_ALL_IN_ONE_POSTGRESQL.SQL。

将SQL拷贝到优炫数据库对应空库下，执行脚本初始化即可。

4、配置数据库JDBC相关信息：

到信创中间件的JVM配置中增加自定义参数：-Djdbcproxydriver.driverclass=org.postgresql.Driver

  • 金蝶V10到管理控制台-配置管理-server-config-JVM配置-JVM选项中添加或修改此参数
  • 东方通到管理控制台界面-启动参数配置-服务器参数中添加或修改此参数，如果在服务器端改jvm，路径是/TongWeb7.0/bin/external.vmoptions
  • 宝兰德到管理控制台-实例管理菜单-点击实例名称，进入配置页面，点击JVM配置

1733396451991.png

到信创中间件管理控制台，新建JDBC配置：

  • 新建JNDI名称必须是jdbc/ctpDataSource
  • 数据库驱动类名com.seeyon.ctp.monitor.perf.jdbcmonitor.proxyobj.JMProxyDriver
  • 数据库连接URL地址以优炫厂商提供为准，一般格式为jdbc:postgresql://127.0.xx.xx(数据库ip):52025(端口)/test_oa（数据库名）?currentSchema=oa(模式名)

注意：

  • 优炫的端口是52025
  • 务必填写currentSchema参数，优炫数据库支持多schema模式，我们需要知道OA在哪个模式才能保证代码正确运行。

1733396400583.png

优炫驱动Jar（PG模式下，优炫推荐postgresql-42.2.2.jar）要将其放置到中间件的lib下，不要手动选择驱动jar位置，放置后需要重启一次中间件才生效：

  • 金蝶V10驱动jar放置到TongWeb/lib目录下
  • 东方通驱动jar放置到aas/lib目录下
  • 宝兰德多实例版本驱动jar放置到宝兰德实例lib下

5、最后是参考信创环境部署手册，去部署应用/ROOT、/static、/seeyon、/sportal，部署完成后正常启动测试即可

编撰人：het

快速跳转

← PolarDB for Mysql数据库项目化部署方案 →