1. 版本升级注意事项

本文介绍升级版本中的注意事项,请仔细阅读后执行后续升级操作。

1.1. Version<=4.2版本升级到此版本

  1. Metadb版本不支持9.x版本,升级前请确认使用的Metadb版本信息。

    1. 使用衡石内置数据库,参考 数据库服务升级
    2. 使用外部数据库,自行升级数据库版本,建议升级版本为13.xx。
  2. JDK版本不在支持1.8版本,容器、K8s部署方式忽略此问题,VM 单机、集群部署方式升级操作前 必要执行 init-os all

    1. 内网环境联系售后人员获取JDK静态资源
      cd /opt/hengshi/lib
      export hs_version="openjdk-11.0.17_8.1"
      wget https://download.hengshi.com/hs-jdk/${hs_version}.tar.gz
      tar -zxf ${hs_version}.tar.gz && rm ${hs_version}.tar.gz
      ln -sf ${hs_version} jdk
      
    2. 注意 如有要求使用特定JDK版本,请在conf/hengshi-sense-env.sh 配置下列参数
      export HS_JDK_HOME="JDK安装目录"  # bin目录上级目录位置
      
  3. 提供内置的Doris引擎,如需存在使用Doris引擎作为内置默认引擎需求,请参考Doris引擎配置

1.2. 版本回滚到Version<4.4版本

  1. 4.4版本对Greenplum引擎进行逻辑层面的优化,不兼容Version<4.4版本程序启动运行,执行版本回滚操作前,执行下列操作
    cd /opt/hengshi
    bin/clean_engine.sh -d true
    
    执行结束后,继续进行版本回滚操作

1.3. 使用外部PostgreSQL数据库替代Metadb注意事项

请参考替换衡石metadb,准备工作中 使用超级管理员账号对用户进行授权操作 步骤。

1.4. 配置二级路径注意事项

本版本中不再支持使用CONTEXT_PATH实现二级路径访问。
如果需要二级路径访问请参考二级访问路径配置

1.5. 清理minio注意事项

4.5.4及之前版本有些删除app的场景没有删除图片,导致minio产生了一些无用的图片。因此对minio无用的图片进行清理,完善删除逻辑,重新进行存储布局。
从4.5.4及之前版本升级到当前版本,升级前请做好以下准备工作:

  1. 做好minio备份(包括云上环境)及metadb备份。
  2. 升级时需等待清理逻辑执行完成,可以通过观察日志了解清理的进度,可以通过MinioImageClean过滤出相关信息。经测试,清理11G的无用照片大概需要4分钟左右。

1.6. LDAP 认证方式修改默认配置

LDAP 认证方式启用用户属性默认配置为false,升级时不再同步用户属性。所以在升级前请确认是否需要同步用户属性,如果需要同步请将该配置设为true。

从4.5.11及之前版本升级到当前版本时需要检查该配置项。

1.7. 会话Cookie修改默认名称注意事项

会话Cookie的默认名称为_USER_SESSION_ID,升级后需要重新登录。如客户系统有使用原Cookie名称 sid 的逻辑,需要修改为新的名称_USER_SESSION_ID, 或者设置参数 export SESSION_COOKIE_NAME=sid(原cookie名称)。

说明
升级影响范围是4.5.15及之前版本,其他版本升级时不需要关注。

results matching ""

    No results matching ""

    单机升级