NetBackup™ 命令参考指南
- 介绍
- 附录 A. NetBackup 命令
- acsd
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- bpcleanrestore
- bpclient
- bpclimagelist
- bpclntcmd
- bpclusterutil
- bpcompatd
- bpconfig
- bpdbjobs
- bpdbm
- bpdgclone
- bpdown
- bpduplicate
- bperror
- bpexpdate
- bpfis
- bpflist
- bpgetconfig
- bpgetdebuglog
- bpimage
- bpimagelist
- bpimmedia
- bpimport
- bpinst
- bpkeyfile
- bpkeyutil
- bplabel
- bplist
- bpmedia
- bpmedialist
- bpminlicense
- bpnbat
- bpnbaz
- bppficorr
- bpplcatdrinfo
- bpplclients
- bppldelete
- bpplinclude
- bpplinfo
- bppllist
- bpplsched
- bpplschedrep
- bpplschedwin
- bppolicynew
- bpps
- bprd
- bprecover
- bprestore
- bpretlevel
- bpschedule
- bpschedulerep
- bpsetconfig
- bpstsinfo
- bpstuadd
- bpstudel
- bpstulist
- bpsturep
- bptestbpcd
- bptestnetconn
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureMQ
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig reinitialize
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- mklogdir
- msdpcldutil
- nbauditreport
- nbcallhomeproxyconfig
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcmdrun
- nbcomponentupdate
- nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdb2adutl
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbepicfile
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhsmcmd
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nblogparser
- nbmariadb
- nbmysql
- nbmlb
- nborair
- nboracmd
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbpgsql
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqlcmd
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- resilient_clients
- restoretrace
- stopltid
- tiermover
- tldd
- tldcd
- tpautoconf
- tpclean
- tpconfig
- tpext
- tpreq
- tpunmount
- verifytrace
- vltadm
- vltcontainers
- vlteject
- vltinject
- vltoffsitemedia
- vltopmenu
- vltrun
- vmadd
- vmchange
- vmcheckxxx
- vmd
- vmdelete
- vmoprcmd
- vmphyinv
- vmpool
- vmquery
- vmrule
- vmupdate
- vnetd
- vssat
- vwcp_manage
- vxlogcfg
- vxlogmgr
- vxlogview
- W2KOption
名称
nbpgsql — 用于对 NetBackup PostgreSQL 客户端执行备份、查询、还原和删除操作
大纲
-o backup -S primary_server_name -P policy_name -s schedule_name -l postgresql_library_path -z lvm_snapshot_size [-C client_server_name] [-portnum postgresql_server_port] [-u postgresql_server_user] [-instance postgresql_instance_name] [-pgid provider_generated_id]
-o backup -S primary_server_name -P policy_name -s schedule_name -l postgresql_library_path -z lvm_snapshot_size [-C client_server_name] [-b backup_type] [-d backup_directory_path] [-dbname database_name] [-delwal delete_wal_logs] [-g pg_basebackup_compression_level] [-portnum postgresql_server_port] [-u postgresql_server_user] [-instance postgresql_instance_name] [-pgid provider_generated_id]
-o restore -S primary_server_name -P policy_name -t target_restore_directory [-u postgresql_server_user] [-C client_server_name] [-id backup_image_id] [-pitr point-in_time_recovery_time]
-o query -S primary_server_name [-u postgresql_server_user] [-P policy_name] [-C client_server_name] [-instance postgresql_instance_name]
-o delete -S primary_server_name -id backup_image_id
On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin
On Windows systems, the directory path to this command is install_path\NetBackup\bin
描述
此命令对 NetBackup PostgreSQL 客户端调用备份、查询、还原和删除操作。删除操作会从 NetBackup 目录库中删除备份信息，但保留存储介质中的备份。
选项
- -b backup_type
指定用于备份操作的备份类型。默认情况下，选择快照备份类型。-b 接受的值为：
pg_basebackup：PostgreSQL 实用程序执行实例备份。Cohesity 建议在非 LVM 部署的情况下使用此选项。指定 pg_basebackup 类型时，NetBackup 执行流备份。指定 -d 选项时，这些备份将更改为非流备份。此选项适用于 UNIX 和 Windows 系统。
pg_dumpall：PostgreSQL 实用程序执行实例的逻辑备份。Cohesity 建议在非 LVM 部署的情况下使用此选项。指定 pg_dumpall 类型时，NetBackup 执行流备份。指定 -d 选项时，这些备份将更改为非流备份。此选项适用于 UNIX 和 Windows 系统。
pg_dump：PostgreSQL 实用程序执行单个数据库的逻辑备份。指定 pg_dump 类型时，NetBackup 执行流备份。指定 -d 选项时，这些备份将更改为非流备份。此选项适用于 UNIX 和 Windows 系统。
vss：仅适用于 Windows 客户端的快照备份类型。
lvm：仅适用于 UNIX 客户端的快照备份类型。
- -C client_server_name
指定 NetBackup 客户端名称。将此选项与 -o query 选项一起使用时，该操作将从指定的 NetBackup 客户端检索和列出所有备份。
- -d backup_directory_path
用于在 -b 选项为 pg_basebackup、pg_dumpall 或 pg_dump 时配置备份目录路径。指定 -d 选项时，pg_basebackup、pg_dumpall 或 pg_dump 的备份将更改为非流备份。将在备份目录路径中生成一致的备份文件，并在备份后进行清理。确保目录路径为空。删除指定目录中的所有信息。
- -dbname database_name
将此选项与 -b pg_dump 一起使用，指定要备份的数据库的名称。此选项备份单个数据库。
- -delwal value
此参数用于在备份期间删除 WAL 文件。接受的值为 0 或 1。 使用1 启用 WAL 文件删除；使用 0 禁用 WAL 文件删除。
- -g postgresql_compression_level
使用 -b pg_basebackup 备份操作时配置压缩级别。接受的值范围为 1 至 9，其中 1 为最低压缩比，9 为最高压缩比。
- -id backup_image_id
指定备份映像 ID。将此选项与 -o delete 操作一起使用时，将指定从 NetBackup 目录库中删除的备份映像 ID。不会删除备份映像。
在 -o restore 操作中使用 -id 参数还原增量式备份时，文件将从上一次完全备份进行还原，直到提供其备份映像 ID 的备份为止。
不能将 -id 和 -pitr 选项一起使用。
如果既未提供 -id 参数，也未提供 -pitr 参数，则将客户端时间视为时间点恢复时间。
- -instance postgresql_instance_name
用于指定 PostgreSQL 服务器实例名称。将此选项与 -o query 选项一起使用时，将检索并列出指定实例名称的所有备份。
- -l postgresql_library_path
指定 PostgreSQL 库目录。此选项仅适用于 UNIX 客户端。
- -o operation_type
指定要执行的操作。有效的操作类型包括：
backup：用于备份 PostgreSQL 实例和数据库。
query：用于查询 NetBackup 目录库的 PostgreSQL 备份。
restore：用于还原 PostgreSQL 实例和数据库备份。
delete：用于删除 PostgreSQL 备份的目录库信息。
- -P policy_name
用于指定 NetBackup DataStore 策略名称。将此选项与 -o query 选项一起使用时，该命令将检索并列出具有指定策略名称的所有备份。
- -pgid provider_generated_id
为备份配置 NetBackup 提供程序生成的 ID。
对于 PostgreSQL 实例，-pgid 的格式必须采用如下所示的形式：POSTGRESQL_INSTANCE_client_server_name_port。
对于单个 PostgreSQL 数据库备份，-pgid 的格式必须采用如下所示的形式：POSTGRESQL_DATABASE_database_name_client_server_name_port
在 NetBackup Web UI 中按照此格式列出备份的恢复点。
- -pitr "YYYY-MM-DD hh:mm:ss"
配置时间点恢复时间。此值表示恢复执行到的时间点。
不能将 -id 和 -pitr 参数一起使用。
使用参数 -pitr 且指定的时间与备份映像的时间匹配时，-id 和 -pitr 的作用类似。但是，当时间介于备份和增量式备份之间时，文件将从上一次完全备份还原，直至该增量式备份。如果在提供的时间之后未执行增量式备份，则备份文件将还原到上次备份。
如果既未提供 -id 参数，也未提供 -pitr 参数，则将该时间视为时间点恢复时间。
- -portnum postgresql_server_port
指定 NetBackup 用于备份和还原操作的 PostgreSQL 实例端口号。默认情况下，端口号为 5432。
- -S primary_server_name
指定 NetBackup 主服务器名称。
- -s schedule_name
指定为 DataStore 策略配置的日程表名称。
- -t target_restore_directory
配置要将备份还原到的目标目录。
- -u postgresql_server_user
指定 PostgreSQL 服务器用户的名称。默认用户为 postgres。将此选项与 -o query 选项一起使用时，此选项将检索并列出所指定用户的所有备份。
对于 UNIX 计算机，此参数是用于备份、还原和查询操作的可选参数。该参数不可用于删除操作。对于 Windows 计算机，此参数是用于备份的可选参数。该参数不可用于还原、查询和删除操作。
- -z lvm_snapshot_size
配置 LVM 快照大小。此选项仅适用于 UNIX 客户端。
示例
示例 1：执行 pg_basebackup 流备份。
# nbpgsql -o backup -S Primary_Server1 -P Policy1 -s Schedule1 -l /path/to/pgsql/lib -C Client_Server1 -b pg_basebackup -g 5 -portnum 5432 -u postgres -instance postgres-linux-5432 -pgid POSTGRESQL_INSTANCE_Client_Server1_5432
示例 2：执行 pg_basebackup 非流压缩备份。
# nbpgsql -o backup -S Primary_Server1 -P Policy1 -s Schedule1 -l /path/to/pgsql/lib -C Client_Server1 -b pg_basebackup -d /backup/dir/path -g 5 -portnum 5432 -u postgres -instance postgres-linux-5432 -pgid POSTGRESQL_INSTANCE_Client_Server1_5432
示例 3：在 UNIX 上使用 -pitr 参数执行还原。
# nbpgsql -o restore -S Primary_Server1 -P Policy1 -t /target/restore/directory -u postgres -C Client_Server1 -pitr “2023-12-18 11:43:15”
示例 4：在 Windows 上执行查询。
nbpgsql -o query -S Primary_Server1 -P Policy1 -C Client_Server1 -instance postgres-linux-5432