gs_backup

背景信息

openGauss部署成功后，在数据库运行的过程中，会遇到各种问题及异常状态。openGauss提供了gs_backup工具帮助openGauss备份、恢复重要数据、显示帮助信息和版本号信息。

前提条件

  • 可以正常连接openGauss数据库。
  • 在进行还原时，需要保证各节点备份目录中存在备份文件。
  • 需以操作系统用户omm执行gs_backup命令。

语法

  • 备份数据库主机

1. gs_backup -t backup --backup-dir=BACKUPDIR [-h HOSTNAME] [--parameter] [--binary] [--all] [-l LOGFILE] - 恢复数据库主机

1. gs_backup -t restore --backup-dir=BACKUPDIR [-h HOSTNAME] [--parameter] [--binary] [--all] [-l LOGFILE] [--force] - 显示帮助信息

1. gs_backup -? | --help - 显示版本号信息

1. gs_backup -V | --version

参数说明

gs_backup参数可以分为如下几类：

  • 备份数据库主机参数：

  • -h

    指定存储备份文件的主机名称。

    取值范围：主机名称。如果不指定主机名称，则备份当前集群。 - –backup-dir=BACKUPDIR

    备份文件保存路径。 - –parameter

    备份参数文件，不指定–parameter、–binary、–all参数时默认只备份参数文件。 - –binary

    备份app目录下的二进制文件。 - –all

    备份app目录下的二进制文件、pg_hba.conf和postgresql.conf文件。 - -l

    指定日志文件及存放路径。

    默认值：$GAUSSLOG/om/gs_backup-YYYY-MM-DD_hhmmss.log - 恢复数据库主机参数：

  • -h

    指定需要恢复主机的名称。

    取值范围：主机名称。如果不指定主机，则恢复对应的备份节点。 - –backup-dir=BACKUPDIR

    恢复文件提取路径。 - –parameter

    恢复参数文件，不指定–parameter、–binary、–all参数时默认只恢复参数文件。 - –binary

    恢复二进制文件。 - –all

    恢复二进制和参数文件。 - -l

    指定日志文件及存放路径。

    默认值：$GAUSSLOG/om/gs_backup-YYYY-MM-DD_hhmmss.log - –force

    节点的静态文件丢失之后强行restore，仅限–all或者–binary参数使用时才生效。 - 其他参数：

  • -?, –help

    显示帮助信息。 - -V, –version

    显示版本号信息。 - -t

    指定操作类型。

    取值范围：backup或者restore。

示例

  • 使用gs_backup脚本备份数据库主机。

1. gs_backup -t backup --backup-dir=/opt/software/gaussdb/backup_dir -h plat1 --parameter 2. Parsing configuration files. 3. Successfully parsed the configuration file. 4. Performing remote backup. 5. Remote backup succeeded. 6. Successfully backed up cluster files. - 使用gs_backup脚本恢复数据库主机。

1. gs_backup -t restore --backup-dir=/opt/software/gaussdb/backup_dir -h plat1 --parameter 2. Parsing configuration files. 3. Successfully parsed the configuration file. 4. Performing remote restoration. 5. Successfully restored cluster files.