1. Metadb POSTGRESQL 升级

背景说明：随着 HENGSHI SENSE 服务版本的不断升级，HENGSHI SENSE 内部 Metadb(postgresql)组件版本也在不断升级，可以选择继续维持当前版本、也可以选择升级到内置最新版本。

本文介绍如何升级Metadb数据操作，以及升级过程中出现问题如果回滚数据库版本操作。

• 单机/集群部署升级
• 容器部署升级
• k8s部署升级

1.1. 单机/集群 部署

1.1.1. 升级前验证

cd /opt/hengshi
bin/hengshi-sense-bin start metadb ##启动metadb操作

出现此提示，表示您的metadb版本低于当前HENGSHI SENSE默认内置版本，请进行下面的升级操作

1.1.2. 版本升级

cd /opt/hengshi
bin/hengshi-sense-bin upgrade metadb ## 升级操作

出现上面提示显示您的metadb数据库已经升级完成

1.1.3. 版本回滚

1. 升级过程中出现异常信息，请执行下述操作完成版本回滚操作

   cd /opt/hengshi 
   rm -rf pg_data 
   mv pg_data_bak pg_data
   cd /opt/hengshi/lib 
   rm -rf pgsql
   ln -s postgresql-9.6.2 pgsql
   

1.2. 容器 部署

1.2.1. 升级前验证

请联系售后人员，确认当前metadb版本信息，升级metadb版本信息。

1.2.2. 版本升级

1. 升级Metadb服务版本，需要使用升级镜像 hengshi-sense:metadb-upgrade 进行升级操作
2. 修改.env文件，HS_IMAGE_TAG=$TAG 将$TAG 配置成 metadb-upgrade 升级镜像tag
3. 修改docker-compose.yaml 文件，在metadb 服务下 增加如下配置 ，注意 9.6.2信息是当前 metadb版本编号

   environment:
      OLDER_METADB_VERSION: 9.6.2
   

4. 执行升级操作

   cd single 
   docker-compose run --rm metadb upgrade metadb
   

   
5. 出现上面提示表示您的metadb数据库升级完成

1.2.3. 版本回滚

1. 升级过程中出现异常信息，请执行下述操作完成版本回滚操作
2. 确认env配置文件信息，HSHOME地址信息

   cd $HSHOME #进去到HSHOME 配置的目录下
   cd hsdata
   rm -rf pg_data 
   mv pg_data_bak pg_data
   

3. 回滚完成后恢复 .env 文件中镜像tag到旧版本

1.3. k8s 部署

1.3.1. 升级前验证

请联系售后人员，确认当前metadb版本信息，升级metadb版本信息。

1.3.2. 版本升级

1. 升级Metadb服务版本，需要使用升级镜像 hengshi-sense:metadb-upgrade 进行升级操作
2. 修改metadb.yaml中image: registry.hengshi.org/hengshi-sense:rc镜像版本为hengshi-sense:metadb-upgrade
3. 修改configmap.yaml配置参数 增加如下配置，注意 9.6.2信息是当前 metadb版本编号

   OLDER_METADB_VERSION: 9.6.2
   

4. 执行下列升级操作

   kubectl -n hengshi apply metadb.yaml
   kubectl -n hengshi exec -it metadb-0 -- /docker-entrypoint.sh upgrade metadb single
   

   
5. 出现上面提示表示您的metadb数据库升级完成

1.3.3. 版本回滚

1. 升级过程中出现异常信息，请执行下述操作完成版本回滚操作

   kubectl -n hengshi exec -it metadb-0 -- /bin/bash
   cd /opt/hengshi
   rm -rf pg_data 
   mv pg_data_bak pg_data
   

2. 回滚完成后恢复 metadb.yaml 文件中镜像tag到旧版本