NetBackup™ 命令参考指南

描述

使用 msdpcldutil 命令可为 AWS S3 存储、S3 兼容云存储和 Azure Blob 存储创建、更新、删除和列出云不可篡改的卷。

此实用程序仅在 Red Hat Linux 上受支持。

在将 msdpcldutil 用于 AWS S3 不可篡改存储之前，请设置以下环境变量：

export MSDPC_ACCESS_KEY=your_access_key_id
export MSDPC_SECRET_KEY=your_secret_key
export MSDPC_REGION=your_region
export MSDPC_PROVIDER=amazon

MSDPC_ACCESS_KEY 是与 IAM 用户关联的 AWS 访问密钥。MSDPC_SECRET_KEY 是与访问密钥关联的密钥。MSDPC_REGION 是在其中创建或访问存储桶的 AWS 区域。MSDPC_PROVIDER 是与 S3 兼容的云存储提供商的名称。

在将 msdpcldutil 用于 S3 兼容云存储之前，请设置以下环境变量：

export MSDPC_ACCESS_KEY=your_access_key_id
export MSDPC_SECRET_KEY=your_secret_key
export MSDPC_REGION=your_region
export MSDPC_PROVIDER=s3-compatible
export MSDPC_ENDPOINT=your_s3_endpoint_url

对于 AWS，除了显示的参数外，现在还可以提供 MSDPC_CMS_CRED_NAME 以运行 msdpcldutil 命令，如下所示：

export MSDPC_PROVIDER=vamazon
export MSDPC_REGION=your_region
export MSDPC_CMS_CRED_NAME=your_credential_name
export MSDPC_MASTER_SERVER=your_primary server_name
export MSDPC_ALIAS=your_storage_server_name_your_alias_name

MSDPC_CMS_CRED_NAME 是提供的凭据名称，用于存储凭据。

MSDPC_ALIAS 是使用 csconfig 创建的云别名。

在对 Azure Blob 不可篡改存储使用 msdpcldutil 之前，请先设置以下环境变量：

export MSDPC_ACCESS_KEY=your_storage_account
export MSDPC_SECRET_KEY=your_access_key
export MSDPC_REGION=your_region
export MSDPC_PROVIDER=azure
export MSDPC_ENDPOINT=https://your_storage_account.blob.core.windows.net/

与 Amazon 类似，对于 Azure 存储，可以使用 MSDPC_CMS_CRED_NAME。

export MSDPC_CMS_CRED_NAME=your_credential_name

设置以下环境变量以配置代理设置。这些设置包括 HTTP、HTTPS、SOCKS 和 NTLM 身份验证：

MSDPC_PROXY_URL=[http/https/socks/socks4/socks5/socks4a]://ProxyHost:
ProxyPort
MSDPC_PROXY_AUTH=NTLM or none
MSDPC_PROXY_DOMAIN=$NTLM domain name
MSDPC_PROXY_USER=$proxy_user
MSDPC_PROXY_PASSWD=$proxy_password

如果 NetBackup 介质服务器部署在 Amazon EC2 实例上，则不需要设置环境变量。可以使用基于 IAM 角色的身份验证。将自动设置访问密钥、密钥、区域、端点和提供商。

export MSDPC_ACCESS_KEY=
export MSDPC_SECRET_KEY=
export MSDPC_REGION=
export MSDPC_ENDPOINT=
export MSDPC_PROVIDER=

将 –enable_sas 选项与 Recovery Vault Azure 和 AzureGov 存储结合使用。提供此选项时，将按如下所示使用环境变量：

对于 Recovery Vault Amazon 和 AmazonGov 存储，使用 -enable_sts 选项。

MSDPC_ACCESS_KEY 是凭据名称，而不是帐户名称。

MSDPC_ALIAS 是与凭据关联的存储卷的别名。MSDPC_MASTER_SERVER 是主服务器。提供这两个环境变量时，这些变量用于在 NetBackup CMS 中查询凭据。在这种情况下，将忽略 MSDPC_SECRET_KEY。

如果不提供 MSDPC_ALIAS 和 MSDPC_MASTER_SERVER，则提供 MSDPC_ACCESS_TOKEN。它用于直接查询 Recovery Vault 以获取凭据。可以选择提供 MSDPC_RVLT_SERVICE_URI 以指定 Recovery Vault 服务端点。默认为 nrv.veritas.com。

如果没有为 Recovery Vault 提供 MSDPC_ALIAS、MSDPC_MASTER_SERVER 和 MSDPC_ACCESS_TOKEN 环境变量，则会导致错误。

除了这些参数外，还可以直接提供 MSDPC_CMS_CRED_NAME，它是凭据名称。

如果未设置环境变量且不存在基于 IAM 角色的身份验证，则 msdpcldutil 进入交互模式。可以在命令行提示符下输入参数，如下所示：

Enter Provider id: amazon
Enter region: us-east-2
Enter Access key: xxxxxxxxx
Enter secret key:
Enter Credential Name: primary_server_name
Enter alias: primary_server_name_cloud-lsu

确保先前使用 csconfig 命令创建了别名，否则此操作将失败。

对于具有 Azure blob 和 AzureGov 存储的服务主体，使用 -enable_sp 选项。提供此选项时，将按如下所示使用环境变量：

export MSDPC_CMS_CRED_NAME=your_cms_credential_name
export MSDPC_ALIAS=your_alias_name
export MSDPC_REGION=your_region
export MSDPC_PROVIDER=azure
export MSDPC_ENDPOINT=https://your_storage_account.blob.core.windows.net/

MSDPC_CMS_CRED_NAME 是 NetBackup 存储在凭据管理服务中的服务主体凭据。

MSDPC_ALIAS 是 CloudStore 中的别名。别名必须具有授权类型 CREDS_SERVICE_PRINCIPAL。可以使用 csconfig -instance 查看或添加别名，其中授权类型显示在 creds_broker 下。

对于具有 Amazon 和 AmazonGov 存储的 IAM Role Anywhere，使用 -enable_iama 选项。提供此选项时，将按如下所示使用环境变量：

export MSDPC_CMS_CRED_NAME=your_cms_credential_name
export MSDPC_ALIAS=your_alias_name
export MSDPC_REGION=your_region
export MSDPC_PROVIDER=amazon

MSDPC_CMS_CRED_NAME 是 NetBackup 存储在凭据管理服务中的 IAM Role Anywhere 凭据。

MSDPC_ALIAS 是 CloudStore 中的别名。别名必须具有授权类型 CREDS_IAM_ROLE_ANYWHERE。可以使用 csconfig -instance 查看或添加别名，其中授权类型显示在 creds_broker 下。

使用 msdpcldutil support deletecv 可删除 MSDP 存储服务器上的 MSDP 云卷，而无论其不可篡改状态为何。删除时，可使用 MSDPC_ACCESS_KEY 和 MSDPC_SECRET_KEY 设置云的密码，该密码具有云管理员权限。

如果主服务器和当前存储服务器不是同一台计算机，则必须设置 MSDPC_MASTER_USER 和 MSDPC_MASTER_PASSWD 以配置密码。如果未设置环境变量，可以通过手动输入密码来解决此问题。

在删除之前，可以使用 msdpcldutil support listcv 查看有关卷的详细信息。msdpcldutil support deletecv cloud_clean 命令将删除云中与此卷相关的所有文件。

通过 MSDP 延迟删除，可以将失败作业的已上传数据在云中保留一段时间。再次运行失败的作业时，NetBackup 将跟踪成功上传数据的元数据，然后仅上传缺少的分段。默认情况下，MSDP 延迟删除处于启用状态。默认情况下，失败作业的元数据会保留 2 天。可以使用 msdpcldutil lazy-delete 命令对其进行更新或禁用。

选项

示例

示例 1：创建云不可篡改的卷。

/usr/openv/pdde/pdcr/bin/msdpcldutil create -b bucketname -v volumename --mode ENTERPRISE --min 1D --max 30D

示例 2：更新云不可篡改的卷模式。

/usr/openv/pdde/pdcr/bin/msdpcldutil update mode -b bucketname -v volumename --mode COMPLIANCE --live 2021-12-31 --inherit enable

示例 3：更新云不可篡改的卷最小和最大保留期限。

/usr/openv/pdde/pdcr/bin/msdpcldutil update range -b bucketname -v volumename --min 1D --max 90D

示例 4：更新云不可篡改的卷有效持续时间。

/usr/openv/pdde/pdcr/bin/msdpcldutil update live -b bucketname -v volumename -l 2022-01-31

示例 5：查看当前用户的 Amazon 权限。

/usr/openv/pdde/pdcr/bin/msdpcldutil platform checkperm --role 
backup-admin --bucket bucketname

/usr/openv/pdde/pdcr/bin/msdpcldutil platform checkperm --role 
cloud_admin

示例 6：启用、禁用和更新延迟删除配置。

/usr/openv/pdde/pdcr/bin/msdpcldutil lazy-delete list -b bucketname

/usr/openv/pdde/pdcr/bin/msdpcldutil lazy-delete enable -b 
bucketname -d 3

/usr/openv/pdde/pdcr/bin/msdpcldutil lazy-delete disable -b bucketname

/usr/openv/pdde/pdcr/bin/msdpcldutil lazy-delete update  -b 
bucketname -d 5