操作方法-使用NBU备份集恢复

• 以omm用户身份登录GaussDB 100任意服务器。
• 进入$ROACH_HOME目录。

  cd $ROACH_HOME

• 执行如下命令，将集群A的全量备份恢复到集群B中。

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

  各参数配置原则如表2所示。

  表2 参数配置原则

  参数名	配置说明	举例
  --master-port	该参数用于指定Roach主代理所在主机的端口，用于Roach进程在主代理主机和其他代理主机间通信。该参数仅需配置一个无业务冲突的端口即可。 说明： 集群中执行Roach命令的主机被认为是主代理。	9500
  --media-destination	该参数用于指定本次恢复的数据存储路径。 建议将media destination和metadata destination设为不同路径。这样，即使backup key被删除，元数据信息也不会丢失。 说明： mediadata是指集群中存储的业务数据，也就是数据库文件。	$HOME/roachbackup/mediadata
  --media-type	该参数用于指定本次恢复的介质。 取值范围为：NBU 在当前场景下请设置为NBU。	NBU
  --metadata-destination	该参数用于指定本次恢复的元数据存储路径。 建议将media destination和metadata destination设为不同路径。这样，即使backup key被删除，元数据信息也不会丢失。 说明： metadata是指Roach在备份恢复操作中收集的配置管理类数据，也叫元数据。例如：集群节点个数、节点配置信息；数据库表个数、表的存储路径、表定义等。	$HOME/roachbackup/metadata/
  --backup-key	该参数用于指定本次恢复的备份文件信息。 每次备份成功后都会生成一个以时间戳命名的备份文件夹，该时间戳（文件夹名称）就是backup key。	20181129_114629
  --restore-new-cluster	该参数用于恢复到新集群	--restore-new-cluster
  --nbu-backup-host	该参数设定旧集群备份节点的hostname	sample_hostname
  --nbu-policy	该参数用于恢复时使用的NBU policy。 说明： 如果恢复命令参数中设定该参数，roach配置文件中的设定将不再起作用。	sample_nbupolciy
  --nbu-schedule	该参数用于指定恢复时使用的NBU schedule。 说明： 如果恢复命令参数中设定该参数，roach配置文件中的设定将不再起作用。 如果使用默认schedule，可以不用设置该参数。	sample_schedule
  --clean	该参数用于停止和清理集群	--clean
  --nbu-backup-host	执行NBU备份的主机名称。在恢复操作中，此参数仅在从NBU备份集恢复到新集群时使用。	不涉及

  例如：

  python  GaussRoach.py -t restore --master-port 9500 --media-destination $HOME/roachbackup/mediadata --media-type NBU --metadata-destination $HOME/roachbackup/metadata/ --backup-key 20181129_114629 --restore-new-cluster --nbu-backup-host host001 --nbu-policy NBUPolicy --clean
  
  恢复验证
  Parsing the configuration file.
  Cleaning cluster.
  Stopping cluster.
  Successfully stopped cluster.
  Successfully cleaned cluster.
  Performing presetup activities...
  
  LFG1000753142 : ##################################################100%
  LFG1000753141 : ##################################################100%
  LFG1000753139 : ##################################################100%
  
  Successfully restore data,  takes time: 00:02:02.
  Performing restore completed.

• 执行如下命令，启动集群B。

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

  例如：

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

  说明：

  • 恢复时所使用的Media destination，Metadata destination路径必须与旧集群上执行备份时的目录一致。保证新集群上此目录属主为集群用户。
  • 如果已确定旧集群上别分集的backup key，那么直接使用以上步骤来进行恢复。
  • 如果不能确定恢复所使用的backup key，在旧集群上使用show命令进行查询，或者在新集群上执行如下命令查询需要使用的备份集的backup key：

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

  • 如果终端断连接引起Roach恢复异常退出，用户可再次执行恢复，此时建议用户在后台执行恢复操作。
  • NBU恢复到新集群暂时不支持GTS。