升级和运维

官网下载新版本的datagear-[version].zip软件包，按照安装和开始章节介绍的步骤完成安装， 然后停止旧版程序，启动新版程序即可， 系统会自动升级【操作系统用户主目录】/.datagear内的文件和内置Derby数据库。

旧版本的程序目录内除了运行日志，没有其他数据，可在新版本安装完成并正常运行后删除。

如果修改了旧版本的config/application.properties配置文件，应在其删除前将配置项同步至新版配置文件中。
建议升级前备份【操作系统用户主目录】/.datagear文件夹，避免升级失败无法恢复旧版本。
3.0.0+版本的自动升级功能仅支持2.13.0+的旧版本， 如果当前版本低于2.13.0，请先下载2.13.0版本程序，启动待自动升级完成后（系统页面可打开），停止（之后可删除）， 然后再启动3.0.0+版本程序即可完成升级。

2.13.0版本软件包下载地址：

datagear-2.13.0.zip

datagear-2.13.0.war

如果需要将DataGear系统从一台主机迁移至另一台主机，执行如下操作即可：

系统部署数据库默认采用了内置的Derby数据库， 在系统启动时，会自动检查和安装内置数据库，并且会根据当前版本号自动对其进行升级。 内置数据库能满足大部分常用场景，并且简化了系统安装，用户无需预先准备数据库环境，也无需在系统升级时手动检查和升级数据库。

如果希望变更部署数据库（比如 MySQL、Oracle、PostgreSQL、SQL Server等），则需要预先准备数据库环境，并在每次安装/升级版本时手动初始化数据库结构。 详细步骤如下所示：

1、手动初始化数据库

参考官网首页的【下载源代码】仓库中的datagear-management/src/main/resources/org/datagear/management/ddl/datagear.sql内置Derby数据库初始化SQL脚本， 编写新数据库语法规范的SQL初始化脚本，然执行它们初始化数据库。 如果是初次安装，需要编写所有SQL脚本，如果是升级，则仅需要编写旧版本至新版本的升级SQL脚本。

2、手动设置数据库版本号表

手动执行如下SQL语句，设置系统当前版本号：

UPDATE DATAGEAR_VERSION SET VERSION_VALUE='当前版本号'

或者

INSERT INTO DATAGEAR_VERSION(VERSION_VALUE) VALUES('当前版本号')

上述SQL语句中的当前版本号应替换为实际系统版本号，比如：6.0.0

3、配置数据库连接

在程序目录的config/application.properties文件中添加datasource.driverClassName、datasource.url、datasource.username、datasource.password配置项，配置新数据库连接。

例如，对于 MySQL 数据库，配置内容如下所示：

datasource.driverClassName=com.mysql.cj.jdbc.Driver
datasource.url=jdbc:mysql://localhost:3306/datagear
datasource.username=datagear
datasource.password=datagear

4、安装数据库驱动库

将新数据库的JDBC驱动库文件复制到程序目录的lib/文件夹内，例如，MySQL 的JDBC驱动库：

lib/mysql-connector-java-8.0.23.jar

变更部署数据库完成，启动程序后即可使用。