前提条件

集群A与新集群B的集群版本、拓扑结构、安装包、数据库用户、DN主备关系相同。

注意事项

恢复集群时会自动停止新集群。

操作步骤

1. 以omm用户身份登录GaussDB 100所有服务器。

2. （可选）使用磁盘备份集恢复至新集群时，需要拷贝原集群各节点的备份文件到新集群对应节点的相同路径下。

   全量恢复时，仅需拷贝全量备份文件；增量备份时，需要同时拷贝全量备份文件和增量备份文件。

   示例：假设集群A（原集群）和集群B（新集群）都有3个节点。

   • 拷贝集群A node1的备份$HOME/roachbackup至集群B node1下$HOME路径中。
   • 拷贝集群A node2的备份$HOME/roachbackup至集群B node2下$HOME路径中。
   • 拷贝集群A node3的备份$HOME/roachbackup至集群B node3下$HOME路径中。

3. 进入$ROACH_HOME目录。

   cd $ROACH_HOME

   恢复集群至新集群。
   

4. • 使用磁盘备份集恢复至新集群

     python GaussRoach.py -t restore --mode cluster --clean --master-port master_port --media-destination media_destination_path --media-type DISK --meta>metadata_path --backup-key backup_key --restore-new-cluster

   • 使用NBU备份集恢复至新集群

     python GaussRoach.py -t restore --mode cluster --master-port master_port --media-destination media_destination_path --media-type NBU --meta>metadata_path  --backup-key backup_key --restore-new-cluster --clean --nbu-backup-host old_hostname

   backup-key可以指向某次全量备份、累积增量备份或者差分增量备份。指向某次全量备份时，进行的是全量恢复。指向累积增量备份或者差分增量备份时，进行的是对应的增量恢复，此时需要注意的是，如果某全量备份已删除，用户无法使用基于该全量备份生成的增量备份来执行恢复操作。

   

   • 从NBU执行恢复操作时，需确保恢复操作和备份操作使用的NBU Policy和NBU Schedule相同。
   • 恢复时所使用的Media destination，Metadata destination路径必须与原集群上执行备份时的目录一致。此外，需要保证新集群上此目录属主为集群安装用户。
   • 如果已确定原集群上备份集的backup key，那么直接使用该步骤中的命令进行恢复；如果不能确定恢复所使用的backup key，可在原集群上使用show命令进行查询，或者在新集群上执行如下命令查询需要使用的备份集的backup key：

     python GaussRoach.py -t show --all-backups --media-type NBU --meta>$HOME/roachbackup/metadata/ --nbu-backup-host host001 --nbu-policy NBUPolicy

   • 如果终端断连引起Roach恢复异常退出，用户可再次执行恢复，此时建议用户在后台执行恢复操作。

   恢复验证

   恢复操作成功完成后，运行Roach主代理的屏幕上显示如下信息：

   Parsing the configuration file.
   Cleaning cluster.
   Stopping cluster.
   Successfully stopped cluster.
   Successfully cleaned cluster.
   Performing presetup activities...
   SIA1000141083 : ##################################################100%  4.188M/s
   SIA1000141082 : ##################################################100%  4.018M/s
   SIA1000141081 : ##################################################100%  4.018M/s
   Successfully restore data,  takes time: 00:02:08.
   Performing restore completed.

5. 启动新集群。

   python GaussRoach.py -t start --restore-new-cluster --media-type media-type

   示例
   

• 使用磁盘备份集恢复至新集群。

  python GaussRoach.py -t restore --mode cluster --clean --master-port 9500 --media-destination $HOME/roachbackup/mediadata --media-type Disk --meta>--backup-key 20181129_114629 --restore-new-cluster

• 使用NBU备份集恢复至新集群。

  python GaussRoach.py -t restore --mode cluster --master-port 9500 --media-destination $HOME/roachbackup/mediadata --media-type NBU --meta>--backup-key 20181129_114629 --restore-new-cluster --nbu-backup-host host001 --nbu-policy NBUPolicy --clean