服务器配置与管理-九游会官网登录入口网页

o2oa内置h2数据库，但系统真正上线使用时，建议使用更高性能的数据库。开发者可以通过将o2oa数据库切换到第三方商用级数据库，如mysql等。本文以mysql数据库为例进行说明，其他数据库操作方式类似。

一、先决条件：

1、下载o2oa安装部署程序包（下载地址：https://www.o2oa.net/download.html）或者获取源代码编译成为安装部署程序包（服务器编译请参考：）

2、拥有通过文件系统修改 o2server 目录中的文件的权限，我们将会修改o2oa的配置文件。

3、指定的外部数据库已经安装，并且在部署o2oa的服务器可以正常通过客户端访问与操作数据库（非常重要，请保证网络与端口的通畅）。（本文以mysql数据库的配置为例，其他数据库的访问配置，请参考o2server/configsample目录相应后缀的配置文件，如_oracle、_sqlserver......）

mysql安装过程：

下载和安装数据库的知识并不在本博客讲述的范围，请大家百度相关的技术文章完成mysql数据库的安装。建议版本在mysql5.7 ，推荐mysql8（如果使用mysql5.7需要替换系统默认的mysql驱动包）。

mysql各版本下载请参见：

mysql安装步骤请参见：

mysql修改数据库连接数：

二、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、开启和配置外部数据库信息

[
    {
        "url":"jdbc:mysql://127.0.0.1:3306/x?autoreconnect=true&usessl=false&useunicode=true&characterencoding=utf-8&uselegacydatetimecode=false&servertimezone=gmt+8",
        "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

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+8
java.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.(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 )

[
	{
		"url":"jdbc:mysql://127.0.0.1:3306/x?autoreconnect=true&usessl=false&useunicode=true&characterencoding=utf-8&uselegacydatetimecode=false&servertimezone=gmt+8",      
		"username" : "root",
		"password" :"password",
		"includes": [],
		"excludes": [],
		"enable" : true,
    "driverclassname" : "com.mysql.jdbc.driver"
	}
]

5.重启服务器使用旧版本驱动包.