版本升级#

升级过程对服务的影响:

如果创建的表是单副本，用户可以选择：
- 通过pre-upgrade和post-upgrade，升级前自动添加副本，升级结束会自动删除新添加的副本。这样行为和多副本保持一致
- 如果允许单副本表在升级过程中不可用，可以在pre-upgrade的时候添加--allow_single_replica选项，在内存紧张的环境下，可以避免添加副本可能造成的OOM
升级过程中，会把待升级的tablet上的leader分片迁移到其它tablets上，升级结束会迁移回来。迁移过程中，写请求会有少量的数据丢失，如果不能容忍少量写丢失，需要在升级过程中停掉写操作。

Note

下文均使用常规后台进程模式启动组件，如果想要使守护进程模式启动组件，请使用bash bin/start.sh start <component> mon的方式启动。守护进程模式中，bin/<component>.pid将是mon进程的pid，bin/<component>.pid.child为组件真实的pid。mon进程并不是系统服务，如果mon进程意外退出，将无法继续守护。

1. 升级nameserver#

停止nameserver
```
bash bin/start.sh stop nameserver
```
备份旧版本bin目录
替换新版本bin
启动新版本nameserver
```
bash bin/start.sh start nameserver
```
对剩余nameserver重复以上步骤

2. 升级tablet#

升级前准备pre-upgrade：为了避免对线上服务的影响，需要在升级tablet前，进行pre-upgrade操作，把该tablet上的leader分片迁移到其它tablets上（详细命令说明可以参考：OpenMLDB运维工具）
```
python tools/openmldb_ops.py --openmldb_bin_path=./bin/openmldb --zk_cluster=172.24.4.40:30481 --zk_root_path=/openmldb --cmd=pre-upgrade --endpoints=127.0.0.1:10921
```
如果允许单副本表在升级过程中不可用，可以添加--allow_single_replica来避免添加新的副本。
停止tablet
```
bash bin/start.sh stop tablet
```
备份旧版本bin目录
替换新版本bin
启动新版本tablet
```
bash bin/start.sh start tablet
```

如果auto_failover处于关闭状态，需要手动执行recoverdata来恢复数据

python tools/openmldb_ops.py --openmldb_bin_path=./bin/openmldb --zk_cluster=172.24.4.40:30481 --zk_root_path=/openmldb --cmd=recoverdata

升级后处理post-upgrade：把pre-upgrade迁移出的leader分片迁移回该tablet

python tools/openmldb_ops.py --openmldb_bin_path=./bin/openmldb --zk_cluster=172.24.4.40:30481 --zk_root_path=/openmldb --cmd=post-upgrade --endpoints=127.0.0.1:10921

升级结果确认#

showopstatus命令查看是否有操作为kFailed, 如果有查看日志排查原因

python tools/openmldb_ops.py --openmldb_bin_path=./bin/openmldb --zk_cluster=172.24.4.40:30481 --zk_root_path=/openmldb --cmd=showopstatus --filter=kFailed

showtablestatus查看所有表状态是否正常

python tools/openmldb_ops.py --openmldb_bin_path=./bin/openmldb --zk_cluster=172.24.4.40:30481 --zk_root_path=/openmldb --cmd=showtablestatus

一个tablet节点升级完成后，对其他tablet重复上述步骤。

所有节点升级完成后恢复写操作, 执行showtablestatus命令查看Rows是否增加。

3. 升级 apiserver#

停止 apiserver
```
bash bin/start.sh stop apiserver
```
备份旧版本bin目录
替换新版本bin
启动apiserver
```
bash bin/start.sh start apiserver
```

4. 升级 taskmanager#

下载新版的OpenMLDB Spark发行版，替换老的Spark目录（即$SPARK_HOME指向的目录）
停止 taskmanager
```
bash bin/start.sh stop taskmanager
```
备份旧版本bin和taskmanager目录
替换新版本bin和taskmanager
启动taskmanager
```
bash bin/start.sh start taskmanager
```

5. 升级SDK#

升级Java SDK#

更新pom文件中java sdk的版本号，包括openmldb-jdbc和openmldb-native

升级Python SDK#

安装新版本的python sdk
```
pip install openmldb=={NEW_VERSION}
```