O2OA使用手册
第1章 功能简介及概述
第6章 平台部署与配置
  • 6.1 O2OA(v9.5)开发平台更新说明(二):数据视图与内容管理双优化
  • 6.2 安装部署-私有化部署服务器架构推荐
  • 6.3 安装部署-在Linux系统中部署O2OA 平台
  • 6.4 安装部署-在Windows系统中部署O2OA 平台
  • 6.5 安装部署-通过Docker Hub快速部署docker镜像
  • 6.6 安装部署-在宝塔/PHPStudy中部署O2OA 平台
  • 6.7 安装部署-O2OA 平台之HTTP端口规划
  • 6.8 安装部署-平台服务器版本升级操作说明
  • 6.9 安装部署-O2OA 平台集群部署配置及操作说明
  • 6.10 安装部署-在线部署自定义应用的WAR包和JAR包
  • 6.11 服务器配置与管理-​O2OA主要配置文件说明
  • 6.12 服务器配置与管理-服务器端口冲突和端口修改
  • 6.13 服务器配置与管理-如何修改服务器内存占用率?
  • 6.14 服务器配置与管理-如何访问和操作H2内置数据库
  • 6.15 服务器配置与管理-​如何在O2OA中使用MySQL数据库?
  • 6.16 服务器配置与管理-如何修改平台支持的数据库驱动包
  • 6.17 服务器配置与管理-O2OA使用openGauss(华为高斯数据库)配置
  • 6.18 服务器配置与管理-O2OA 平台平台数据库配置信息样例
  • 6.19 服务器配置与管理-配置O2OA服务器连接O2云
  • 6.20 服务器配置与管理-O2OA实现服务器随操作系统自动启动
  • 6.21 服务器配置与管理-文件存储服务器配置
  • 6.22 服务器配置与管理-工作日节假日配置
  • 6.23 服务器配置与管理-消息提醒配置说明
  • 6.24 服务器配置与管理-自定义消息提醒
  • 6.25 服务器配置与管理-定制消息通知的内容
  • 6.26 服务器配置与管理-消息通知过滤
  • 6.27 服务器配置与管理-为待办创建配置邮件通知
  • 6.28 服务器配置与管理-待办待阅数据的查询操作和管理
  • 6.29 服务器配置与管理-​自动执行平台数据的备份与恢复
  • 6.30 服务器配置与管理-数据导出导入与系统数据备份
  • 6.31 ​服务器配置与管理-定期自动执行数据备份与恢复
  • 6.32 系统安全-O2OA作为认证中心实现基于OAUTH2单点认证
  • 6.33 系统安全-O2OA基于Nginx的SSL跳转、转发配置
  • 6.34 O2OA 平台如何基于nginx上下文分发的方式快速集群部署
  • 6.35 系统安全-访问日志相关配置
  • 6.36 系统架构-平台集群化部署之基于Nginx端口分发机制实现集群部署
  • 6.37 系统安全-审计日志相关配置
  • 6.38 系统安全-平台日志文件说明
  • 6.39 系统架构-基于nginx快速集群部署-上下文分发
  • 6.40 系统安全-O2OA日志输出设置log4j2.xml
  • 6.41 系统安全-用户密码初始化规则的设定(默认密码是什么)
  • 6.42 系统安全-启用HTTPS(百度云版)
  • 6.43 系统安全-启用HTTPS(腾讯云版)
  • 6.44 系统安全-自签名SSL证书验证HTTPS功能
  • 6.45 系统安全-登录密码RSA加密
  • 6.46 系统安全-用户登录IP限制
  • 6.47 O2OA 平台前端安全配置建议(一)
  • 6.48 系统安全-在用户登录过程中启用图形验证码
  • 6.49 系统协作集成-金山文档
  • 6.50 系统安全-平台部署之使用非root用户运行服务
  • 6.51 O2OA(v9.5)开发平台更新说明(一):流程平台
  • 6.52 系统协作集成-集成永中Office
  • 6.53 系统安全-O2Server启用国密加密设置
  • 6.54 系统协作集成-集成金格在线Office
  • 6.55 系统安全-日志应用使用说明
  • 6.56 O2OA(v9.5)开发平台更新说明(三):聚焦安全与系统维护的全面升级
  • 6.57 系统安全-用户重置密码操作(重置后密码是什么)
  • 6.58 系统安全-超级管理员(xadmin)密码修改
  • 6.59 O2OA(v9.5)开发平台更新说明(四):手机端焕新登场、功能再升级、体验再飞跃!
  • 6.60 系统安全-使用Web端运行服务器管理命令
  • 6.61 O2OA(v9.5)开发平台更新说明(五):应用功能优化与问题修复
  • 6.62 系统安全-o2server无法正常显示验证码解决办法
  • 第16章 开发知识及常见问题
  • 16.1 O2OA如何实现文件跨服务器的备份
  • 16.2 O2OA 平台服务器故障排查
  • 16.3 开发知识-让后端代理/接口脚本编写也能像前端一样用上debugger
  • 16.4 常见问题-SQLServer中创建新数据库使用哪个中文编码?
  • 16.5 O2OA 平台流程引擎中如何修改,定制流程的流转记录
  • 16.6 mysql数据库备份
  • 16.7 domain不正确的时候如何强制设置成正确的
  • 16.8 配置文件中使用密文存储密码
  • 16.9 常见问题-连接MySQL出现 Public Key Retrieval is not allowed 的错误
  • 16.10 常见问题-查看表结构
  • 16.11 常见问题-7.2及以上版本开启web代理后请求中没有正确使用web端口问题解决方式
  • 16.12 linux环境libreoffice安装及使用
  • 16.13 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 16.14 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 16.15 藕粉社区问答系列1
  • 16.16 藕粉社区问答系列2
  • 16.17 藕粉社区问答系列3
  • 16.18 快速入门-平台相关资料汇总
  • 16.19 快速入门-服务器总体介绍汇总
  • 16.20 快速入门-流程表单载入基础数据
  • 16.21 快速入门-常用表单脚本样例汇总
  • 16.22 快速入门-自定义表数据分页样例
  • 16.23 云服务器-阿里云ECS服务器的端口启用
  • 16.24 开发知识-React篇:在O2OA 平台框架中使用React
  • 16.25 开发知识-React篇:在O2OA门户页面中使用React
  • 16.26 开发知识-Vue篇:在Vue应用中集成O2OA
  • 16.27 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 16.28 开发知识-Vue篇:在O2门户页面中使用Vue
  • 16.29 平台中使用Druid数据库连接及监控
  • 16.30 开发知识-在PAAS平台上部署O2OA 平台
  • 16.31 开发知识-如何使用Tomcat架设webdav服务器
  • 16.32 开发知识-单个端口模式的Nginx和系统配置
  • 16.33 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 16.34 开发知识-O2OA 平台启用Eruda进行移动端调试
  • 16.35 开发知识-神通数据库安装
  • 16.36 开发知识-人大金仓数据安装
  • 16.37 开发知识-中标麒麟安装达梦数据库(DM8)
  • 16.38 开发知识-中标麒麟安装人大金仓详细步骤
  • 16.39 开发知识-使用VNC连接中标麒麟V7操作系统
  • 16.40 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 16.41 开发知识-数据优化知识点
  • 16.42 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 16.43 消息队列-配置activeMQ、kafka消息队列
  • 16.44 常见问题-数据导出或者导入时发生OOM异常
  • 16.45 常见问题-如何让用户首次登录必须改掉初始密码
  • 16.46 常见问题-如何在模块部署中控制模块的访问权限
  • 16.47 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 16.48 常见问题-如何使用服务管理调用WebService
  • 16.49 常见问题-如何使用脚本调用外部服务
  • 16.50 常见问题-如何使用脚本控制流程自动流转
  • 16.51 常见问题-如何通过脚本调用系统内服务
  • 16.52 常见问题-接口代码疑惑解答汇总
  • 16.53 常见问题:Maven编译o2server错误: Java Heap Space
  • 16.54 常见问题-集群配置后启动报错:NullPointerException
  • 16.55 常见问题-服务器错误:can not decrypt token
  • 16.56 常见问题-IOS移动办公无法收到验证码
  • 16.57 常见问题-服务器和日志时间相差12小时的问题
  • 16.58 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 16.59 藕粉社区问答系列4
  • 16.60 开发知识-React篇:在React应用中集成O2OA

  • 服务器配置与管理-​如何在O2OA中使用MySQL数据库?

    时间:2022-10-11   
    内容导读

    本篇介绍如何在 O2OA 平台把内置数据库切换为 MySQL 外部数据库。文中先列先决条件:安装包就绪、有改配置目录的权限、目标库已装且服务器能连通。随后按顺序说明把节点配置里内置数据库的开关关掉,再从样例目录复制外部数据源配置到 config 目录,填写连接地址、账号与口令后启用,注意数据库要先自建、编码按正文要求设置、文件名须去掉类型后缀,改完必须重启服务,并提示驱动不匹配时的处理方向。

    O2OA 平台支持 Mysql、Oracle、SQLServer 等第三方数据库,也支持达梦、人大金仓、神州通用等国产数据库。本篇主要介绍如何在 O2OA 中配置第三方数据库。

    O2OA 内置 H2 数据库,但系统正式上线运行时,建议改用性能更高的数据库。开发者可将 O2OA 数据库切换至 Mysql 等第三方商用级数据库。本文以 MySQL 数据库为例说明,其他数据库的操作方式类似。

    一、先决条件

    1、下载 O2OA 安装部署程序包(下载地址:https://www.o2oa.net/download.html)或者获取源代码编译成为安装部署程序包(服务器编译请参考:《源码编译-O2Server 服务器源码编译教程》)

    2、拥有通过文件系统修改 o2server 目录下文件的权限,因为配置过程中需要修改 O2OA 的配置文件。

    3、指定的外部数据库已安装,且部署 O2OA 的服务器能够通过客户端正常访问并操作该数据库(非常重要,请保证网络与端口通畅)。(本文以 MySQL 数据库的配置为例,其他数据库的访问配置可参考 o2server/configSample 目录下相应后缀的配置文件,如 _Oracle、_SQLServer 等。)

    MySQL 安装过程

    下载和安装数据库的知识并不在本博客讲述的范围,请大家百度相关的技术文章完成 Mysql 数据库的安装。建议版本在 Mysql5.7+,推荐 Mysql8(如果使用 MySQL5.7需要替换系统默认的 MySQL 驱动包)。

    Mysql 各版本下载请参见:https://blog.csdn.net/kerafan/article/details/78001849

    Mysql 安装步骤请参见:http://www.cnblogs.com/sshoub/p/4321640.html

    Mysql 修改数据库连接数:https://blog.csdn.net/zhya910702/article/details/48372433

    二、O2OA 配置修改

    1、停用内置 H2 数据库

    配置文件路径:o2server/config/node_127.0.0.1.json

    若没有该文件或 config 文件夹,请自行创建 config 文件夹,并从 o2server/configSample/ 目录中复制 node_127.0.0.1.json 到 o2server/config 目录下。

    只有 config 目录下修改配置文件才会生效。

    {
      "enable": true,
      ...
      "application": {
        ...
      },
      "web": {
        ...
      },
      "storage": {
        ...
      },
      "data": {             #内置数据库相关配置,可以修改端口以及是否启用
        "enable": true,     #修改enable的值为false
        "tcpPort": null,
        "webPort": null,
        "includes": [],
        "excludes": []
      },
      "dumpData":{
        ...
      },
      "dumpStorage":{
       ...
      }
    }

    2、开启和配置外部数据库信息

    配置文件路径:o2server/config/externalDataSources.json

    若没有该文件,请从 o2server/configSample/ 目录中复制 externalDataSources.json 到 o2server/config 目录下。

    只有 config 目录下修改配置文件才会生效。

    将其中的 url、username、password 以及 enable 修改为上述 Mysql 的相关信息,例如:

    [
        {
            "url": "jdbc:mysql://127.0.0.1:3306/X?autoReconnect=true&useSSL=false&useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8",
            "username": "root",
            "password": "password",
            "includes": [],
            "excludes": [],
            "enable": true
        }
    ]

    URL 参数说明如下:

    useUnicode: 是否使用Unicode字符集,如果参数characterEncoding设置为gb2312或gbk,本参数值必须设置为true false 1.1g 
    characterEncoding: 当useUnicode设置为true时,指定字符编码。比如可设置为gb2312或gbk false 1.1g 
    autoReconnect: 当数据库连接异常中断时,是否自动重新连接? false 1.1 
    autoReconnectForPools: 是否使用针对数据库连接池的重连策略 false 3.1.3 
    failOverReadOnly: 自动重连成功后,连接是否设置为只读? true 3.0.12 
    maxReconnects: autoReconnect设置为true时,重试连接的次数 3 1.1 
    initialTimeout: autoReconnect设置为true时,两次重连之间的时间间隔,单位:秒 2 1.1 
    connectTimeout: 和数据库服务器建立socket连接时的超时,单位:毫秒。 0表示永不超时,适用于JDK 1.4及更高版本 0 3.0.1 
    socketTimeout: socket操作(读写)超时,单位:毫秒。 0表示永不超时 0 3.0.1 
    serverTimezone: 服务器时区(避免数据与正确时间相关8小时的问题)

    注:数据库连接 URL 中的数据库 X 需预先创建,O2Server 会自动创建数据表,但不会自动创建数据库。

         数据库编码请设置为 utf8mb4

    o2server/configSample 目录中也提供了一些常见数据库的连接示例,如下图所示:

    1676528571203197.png


    开发者可将相应后缀的文件 COPY 到 config 目录中修改,但需注意配置文件名称要去掉数据库类型后缀才会生效,正确的外部数据库配置文件名称为 externalDataSources.json。

    设置完成后,必须要重启 o2server 服务。

    3、驱动不匹配问题(MySQL 示例)

    启动后,命令控制台显示数据库驱动类已经过期,如下图所示,Mysql8.0.22启动后显示。但是 MySQL Workbench 链接数据库是 OK 的:

    Loading class `com.mysql.jdbc.Driver'. This is deprecated. The new driver class is `com.mysql.cj.jdbc.Driver'. The driver is automatically registered via the SPI and manual loading of the driver class is generally unnecessary.

    或者报错:

    Loading    class    `com.mysql.jdbc.Driver'.    This    is    deprecated.    The    new    driver    class    is    `com.mysql.cj.jdbc.Driver'.    The    driver    is    automatically    registered    via    the    SPI    and    manual    loading    of    the    driver    class    is    generally    unnecessary.九月    01,    2020    10:22:44    上午    com.alibaba.druid.pool.DruidDataSource    error严重:    init    datasource    error,    url:    jdbc:mysql://127.0.0.1:3306/X?autoReconnect=true&useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8java.sql.SQLNonTransientConnectionException:    Could    not    create    connection    to    database    server.    Attempted    reconnect    3    times.    Giving    up.                                at    com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:110)                                at    com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:97)                                at    com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:89)                                at    com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:63)                                at    com.mysql.cj.jdbc.exceptions.SQLError.createSQLException(SQLError.java:73)                                at    com.mysql.cj.jdbc.ConnectionImpl.connectWithRetries(ConnectionImpl.java:905)                                at    com.mysql.cj.jdbc.ConnectionImpl.createNewIO(ConnectionImpl.java:830)                                at    com.mysql.cj.jdbc.ConnectionImpl.<init>(ConnectionImpl.java:455)                                at    com.mysql.cj.jdbc.ConnectionImpl.getInstance(ConnectionImpl.java:240)                                at    com.mysql.cj.jdbc.NonRegisteringDriver.connect(NonRegisteringDriver.java:199)                                at    com.alibaba.druid.filter.FilterChainImpl.connection_connect(FilterChainImpl.java:156)                                at    com.alibaba.druid.filter.stat.StatFilter.connection_connect(StatFilter.java:218)                                at    com.alibaba.druid.filter.FilterChainImpl.connection_connect(FilterChainImpl.java:150)                                at    com.alibaba.druid.pool.DruidAbstractDataSource.createPhysicalConnection(DruidAbstractDataSource.java:1646)                                at    com.alibaba.druid.pool.DruidAbstractDataSource.createPhysicalConnection(DruidAbstractDataSource.java:1710)                                at    com.alibaba.druid.pool.DruidDataSource.init(DruidDataSource.java:939

    可以修改 Mysql 连接的数据库驱动类名。

    可在 externalDataSources.json 文件中添加 driverClassName 属性,修改数据库驱动类名。以 Mysql8 为例:

    [
        {
            "url": "jdbc:mysql://127.0.0.1:3306/X?useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC",
            "username": "root",
            "password": "password",
            "driverClassName": "com.mysql.cj.jdbc.Driver",
            "includes": [],
            "excludes": [],
            "enable": true
        }
    ]

    设置完成后,重启 o2server 即可。

    4、使用旧版本 MySQL(MySQL5.7+)

    如果使用低版本的 MySQL,需要手工替换驱动程序。

    1、在 o2server/commons/ext 目录(根据 O2OA 版本不同,该目录可能名为 ext_java11)下删除 mysql 驱动程序 jar 包,例如 mysql-connector-java-8.0.15.jar,它是系统自带的驱动程序包。

    2、将低版本的驱动程序 jar 包(例如 mysql-connector-java-5.1.43.jar)拷贝到 o2server/custom/jars 目录下。

    3、修改 o2server/commons/ext 目录(根据 O2OA 版本不同,该目录可能名为 ext_java11)中的 jar 包注册文件,如下图所示:

    1676528697963320.png

    修改 mainifest.cfg 文件内容,删除原有的 jar 包名称,添加新的 jar 包名称并保存。

    如下图所示:

    1676528741125355.png

    若不修改 mainifest.cfg,刚放入 ext 目录中的文件会在系统启动时被系统文件检查机制删除,导致系统启动时找不到指定的 jar 包而报错。

    4、在externalDataSources.json配置文件中标识使用的驱动程序类,MySQL5使用 com.mysql.jdbc.Driver,按指定版本数据库的 JDBC 连接要求修改好配置文件。如果数据库连接字符串不知道怎么写,可以百度一下。

    [
        {
            "url": "jdbc:mysql://127.0.0.1:3306/X?autoReconnect=true&useSSL=false&useUnicode=true&characterEncoding=UTF-8&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8",
            "username": "root",
            "password": "password",
            "includes": [],
            "excludes": [],
            "enable": true,
            "driverClassName": "com.mysql.jdbc.Driver"
        }
    ]

    5、重启服务器,使用旧版本驱动包。

    1676528794572343.png

    相关问题讨论

    如何在 O2OA 中使用 Mysql 等数据库?

    O2OA 平台支持第三方数据库,如 Mysql,Oracle,SQLServer 以及国产达梦,人大金仓,神州通用数据库等。

    查看原帖讨论 · 9,407 次浏览

    请问 o2oa 是不是在 MySQL 数据库下没办法创建自建表啊?

    O2OA 内置 H2数据库,但系统真正上线使用时,建议使用更高性能的数据库。

    查看原帖讨论 · 18,698 次浏览

    o2oa 连接 mysql 数据时报 com.mysql.cj.jdbc.Driver 的问题求解

    4、在 externalDataSources.json 配置文件中标识使用的驱动程序类,MySQL5使用 com.mysql.jdbc.Driver,按指定版本数据库的 JDBC 连接要求修改好配置文件。

    查看原帖讨论 · 18,599 次浏览

    相关内容

    兰德网络O2OA平台软件

    兰德网络 O2OA 平台软件

    开源、自主可控的协同办公底座

    研发与运营

    纵横翱途(杭州)科技有限公司

    企业级协同应用 · 工作流引擎 · AI 智能体

    www.o2oa.net | 400-888-0545