跳到主要内容

升级 3.x 版本到 4.x

CloudCanal 4.x 版本提供了主子账号、按资源授权鉴权、RABC、多集群等能力,但是也存在比较大的版本改造,从 3.x 版本升级上来需要做一些升级动作。

本文档即介绍如何将 CloudCanal 3.x 版本升级到 4.x 版本。

创建新增元数据库

  • 登录 MySQL 元数据库

    # e.g.,docker
    mysql -h127.0.0.1 -uroot -P25000 -p123456
  • 创建新增元数据库,如 clougence_rdp

    set names utf8;

    create database clougence_rdp;

清空 console_schema_history 数据

  • 登录 MySQL 元数据库

    # e.g.,docker
    mysql -h127.0.0.1 -uroot -P25000 -p123456
  • 清空 console_schema_history 数据

    use cloudcanal_console;

    truncate table console_schema_history;

升级 CloudCanal 版本

  • 按照部署文档升级 CloudCanal 3.x -> 4.x

确认账号状态

  • 进入元数据库,如 cloudcanal_console, 确认是否存在多个主账号

    select distinct(uid) from console_user where email <> 'inner@clougence.com';
  • 如果只存在1个主账号,则进行 单主账号升级

    +------------------+
    | uid |
    +------------------+
    | 6258151610403310 |
    +------------------+
    1 row in set (0.00 sec)
  • 如果存在多个主账号,则进行 多主账号升级

    +------------------+
    | uid |
    +------------------+
    | 6258151610403310 |
    | 2737757397011281 |
    +------------------+
    2 rows in set (0.00 sec)

单主账号升级

  • 登录元数据库获取单主账号 uid, 如 6258151610403310

    select distinct(uid) from console_user where email <> 'inner@clougence.com';
  • 登录 console 部署节点

    ssh root@xx.xx.xx.xx
  • 切换到 clougence 用户

    su - clougence
  • 进入脚本目录

    cd /home/clougence/cloudcanal/console/bin
  • 停止 console

    ./stopConsole.sh
  • 执行脚本,跟上主账号 uid, 如 6258151610403310

    ./startConsoleAndUpToRdpPrivateSimple.sh 6258151610403310

多主账号升级

  • 多主账号系统,升级将提升其中一个账号为新系统主账号,其他账号降级为该主账号子账号

  • 新系统主账号选择建议以 CloudCanal 机器节点添加者为主,如果存在多个,则 机器节点核心配置修改

    mysql> select distinct(uid) from worker;
    +------------------+
    | uid |
    +------------------+
    | 6258151610403310 |
    +------------------+
    1 row in set (0.01 sec)
  • 确认主账号 uid , 如 6258151610403310

  • 进入脚本目录

    cd /home/clougence/cloudcanal/console/bin
  • 停止 console

    ./stopConsole.sh
  • 执行脚本,替换参数 primaryUid 值为主账号 uid

    ./startConsoleAndUpToRdpPrivateDeep.sh 6258151610403310

[可选]机器节点核心配置修改

  • 如果存在 CloudCanal 机器节点添加者多个的情况,需要修改非新系统主账号添加的机器节点核心配置

TIPS

  • 多主账号升级因为需要订正资源归属,升级不可逆,所以具有一定风险