执行以下步骤备份集群到磁盘：

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

  cd $ROACH_HOME

• 查看集群状态是否是Normal。

  gs_om -t status

  集群状态是Normal（即cluster_state : Normal）时，可以继续执行备份。

• 执行备份。

  python GaussRoach.py -t backup --master-port <master_port> --media-destination <media_destination_path> --media-type Disk --metadata-destination <metadata_path>

  --metadata-destination参数指定的元数据路径和--media-destination参数指定的介质数据存储路径不存在时，如果该路径的上层目录已存在且属主是数据库安装用户，Roach工具会自动创建该路径且路径属主是数据库安装用户（即使用gs_preinstall执行预安装时参数-U指定的用户）；--metadata-destination参数指定的元数据路径和--media-destination参数指定的介质数据存储路径是已存在路径时，需要确保该路径的属主是数据库安装用户（即使用gs_preinstall执行预安装时参数-U指定的用户）。

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

  表1 参数配置原则

  参数名	配置说明	举例
  --master-port	该参数用于指定Roach主代理所在主机的端口，用于Roach进程在主代理主机和其他代理主机间通信。该参数仅需配置一个无业务冲突的端口即可。 说明： 集群中执行Roach命令的主机被认为是主代理。	6000
  --media-type	该参数用于指定本次备份的介质。 取值范围为： DISK NBU OBS 在当前场景下请设置为DISK。	DISK
  --media-destination	该参数用于指定本次备份的介质数据存储路径。 建议将media destination和metadata destination设为不同路径。这样，即使backup key被删除，元数据信息也不会丢失。 说明： mediadata是指集群中存储的业务数据，也就是数据库文件。	/home/userA/media
  --metadata-destination	该参数用于指定本次备份的元数据存储路径。 建议将media destination和metadata destination设为不同路径。这样，即使backup key被删除，元数据信息也不会丢失。 说明： metadata是指Roach在备份恢复操作中收集的配置管理类数据，也叫元数据。例如：集群节点个数、节点配置信息、数据库表个数、表的存储路径、表定义等。	/home/userA/metadata
  --archivelog	该参数在需要备份archive log时使用。 说明： 如要进行恢复到时间点，备份是必须要备份archivelog，因为roach会检测备份时是否对archivelog进行了备份。	--archivelog
  --compression-mode	设置压缩备份模式。 取值范围为： zstd zlib lz4	zstd
  --compression-level	设置压缩备份的级别。 取值范围为[1-9]。	3

  例如：

  python GaussRoach.py -t backup --master-port 6000 --media-destination /home/userA/backup --media-type Disk --metadata-destination /home/userA/metadata

  备份验证

  备份操作完成后，运行Roach主代理的屏幕上显示如下信息。

  Parsing the configuration file.
  Performing presetup activities...
  
  lfgp000801493 : ##################################################100%
  lfgp000801494 : ##################################################100%
  lfgp000801495 : ##################################################100%
  
  Successfully backup data, backup key: 20180717_112418, takes time: 00:00:34.
  Performing post backup cleanup activities...
  Cleanup completed

  说明：

  • 如果命令执行失败，Roach会直接显示备份失败。如果是终端断连引起Roach备份异常退出，用户可再次执行备份，此时建议用户在后台执行备份恢复操作。
  • 可选参数可与备份命令一起设置。
  • 备份操作完成后，Roach工具显示恢复操作所需的backup key。

必选参数

用户必须设置以下必选参数来保证备份操作的成功完成。

• Master port（主代理端口）
• Media type（介质类型）
• Media destination（目的介质）
• Metadata destination（目的元数据）

说明：

建议将media destination和metadata destination设为不同路径。这样，即使backup key被删除，元数据信息也不会丢失。