Guide de référence des commandes NetBackup™

DESCRIPTION

Utilisez la commande msdpcldutil pour créer, mettre à jour, supprimer et répertorier les volumes cloud immuables pour le stockage AWS S3, le stockage cloud compatible S3 et le stockage blob Azure.

Cet utilitaire n'est pris en charge que sur Red Hat Linux.

Définissez les variables d'environnement suivantes avant d'utiliser msdpcldutil pour le stockage immuable 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 est la clé d'accès AWS associée à un utilisateur IAM. MSDPC_SECRET_KEY est la clé secrète associée à la clé d'accès. MSDPC_REGION est la région AWS dans laquelle le compartiment est créé ou accessible. MSDPC_PROVIDER est le nom du fournisseur de stockage cloud compatible avec S3.

Définissez les variables d'environnement suivantes avant d'utiliser msdpcldutil pour le stockage cloud compatible avec 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

Outre les paramètres affichés, vous pouvez désormais spécifier MSDPC_CMS_CRED_NAME pour exécuter les commandes msdpcldutil pour AWS comme indiqué :

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 correspond au nom d'informations d'authentification spécifié qui contient les informations d'authentification.

MSDPC_ALIAS correspond à l'alias cloud créé à l'aide de csconfig.

Définissez les variables d'environnement suivantes avant d'utiliser msdpcldutil pour le stockage immuable Azure blob :

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/

Comme pour Amazon, vous pouvez utiliser MSDPC_CMS_CRED_NAME pour le stockage Azure.

export MSDPC_CMS_CRED_NAME=your_credential_name

Définissez les variables d'environnement suivantes pour configurer les paramètres de proxy. Les paramètres incluent HTTP, HTTPS, SOCKS et l'authentification 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

Il n'est pas nécessaire de définir les variables d'environnement si le serveur de médias NetBackup est déployé sur une instance Amazon EC2. Vous pouvez utiliser l'authentification basée sur le rôle IAM. La clé d'accès, la clé secrète, la région, le terminal client et le fournisseur sont définis automatiquement.

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

Utilisez l'option - enable_sas avec le stockage Recovery Vault Azure et AzureGov. Lorsque vous spécifiez cette option, les variables d'environnement sont utilisées comme suit :

Utilisez l'option -enable_sts avec le stockage Recovery Vault Amazon et AmazonGov.

MSDPC_ACCESS_KEY correspond au nom des informations d'authentification, et non à celui du compte.

MSDPC_ALIAS est l'alias du volume de stockage associé aux informations d'authentification et MSDPC_MASTER_SERVER est le serveur principal. Lorsque vous spécifiez ces deux variables d'environnement, elles sont utilisées pour demander les informations d'authentification au CMS NetBackup. Dans ce cas, la variable MSDPC_SECRET_KEY est ignorée.

Si vous ne spécifiez pas MSDPC_ALIAS et MSDPC_MASTER_SERVER, spécifiez MSDPC_ACCESS_TOKEN. Elle permet de demander directement les informations d'authentification à Recovery Vault. Vous pouvez éventuellement spécifier MSDPC_RVLT_SERVICE_URI pour désigner le terminal client du service Recovery Vault. La valeur par défaut est nrv.veritas.com.

Une erreur se produit si les variables d'environnement MSDPC_ALIAS, MSDPC_MASTER_SERVER et MSDPC_ACCESS_TOKEN ne sont pas spécifiées pour Recovery Vault.

Outre ces paramètres, vous pouvez spécifier directement MSDPC_CMS_CRED_NAME, qui correspond au nom des informations d'authentification.

Si vous ne définissez pas les variables d'environnement et si l'authentification basée sur le rôle IAM ne s'applique pas, msdpcldutil passe en mode interactif. Vous pouvez entrer les paramètres à l'invite de ligne de commande comme suit :

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

Pour que l'opération aboutisse, assurez-vous au préalable de créer l'alias à l'aide de la commande csconfig.

Utilisez l'option -enable_sp pour le principal du service avec le stockage Azure blob et AzureGov. Lorsque vous spécifiez cette option, les variables d'environnement sont utilisées comme suit :

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 correspond aux informations d'authentification du principal du service que NetBackup stocke dans le service de gestion des informations d'authentification.

MSDPC_ALIAS correspond au nom de l'alias dans CloudStore. Le type d'autorisation de l'alias doit être CREDS_SERVICE_PRINCIPAL. Vous pouvez afficher ou ajouter des alias à l'aide de csconfig -instance à l'endroit où le type d'autorisation s'affiche sous creds_broker.

Utilisez l'option -enable_iama pour IAM Roles Anywhere avec le stockage Amazon et AmazonGov. Lorsque vous spécifiez cette option, les variables d'environnement sont utilisées comme suit :

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 correspond aux informations d'authentification IAM Role Anywhere que NetBackup stocke dans le service de gestion des informations d'authentification.

MSDPC_ALIAS correspond au nom de l'alias dans CloudStore. Le type d'autorisation de l'alias doit être CREDS_IAM_ROLE_ANYWHERE. Vous pouvez afficher ou ajouter des alias à l'aide de csconfig -instance à l'endroit où le type d'autorisation s'affiche sous creds_broker.

Utilisez msdpcldutil support deletecv pour supprimer le volume cloud MSDP sur le serveur de stockage MSDP, que son état soit immuable ou non. Lors de la suppression, utilisez MSDPC_ACCESS_KEY et MSDPC_SECRET_KEY pour définir le mot de passe du cloud, qui dispose de privilèges d'administrateur cloud.

Si le serveur principal et le serveur de stockage actuel ne sont pas le même ordinateur, vous devez définir MSDPC_MASTER_USER et MSDPC_MASTER_PASSWD pour configurer les mots de passe. Si vous ne définissez pas les variables d'environnement, vous pouvez résoudre ce problème en saisissant manuellement les mots de passe à la place.

Avant la suppression, vous pouvez utiliser msdpcldutil support listcv pour afficher les informations détaillées sur les volumes. La commande msdpcldutil support deletecv cloud_clean supprime tous les fichiers associés à ce volume dans le cloud.

La suppression MSDP différée vous permet de conserver les données chargées dans le cloud pour les travaux ayant échoué pendant une certaine période. Lorsque le travail ayant échoué est réexécuté, NetBackup suit les métadonnées pour les données correctement chargées et charge seulement les fragments manquants. La suppression MSDP différée est activée par défaut. Elle conserve les métadonnées des travaux ayant échoué pendant 2 jours par défaut. Vous pouvez la mettre à jour ou la désactiver à l'aide de la commande msdpcldutil lazy-delete.

OPTIONS

EXEMPLES

Exemple 1 : Créer un volume cloud immuable.

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

Exemple 2 : Mettre à jour le mode du volume cloud immuable.

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

Exemple 3 : Mettre à jour les périodes de conservation, minimale comme maximale, du volume cloud immuable.

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

Exemple 4 : Mettre à jour la période d'activité du volume cloud immuable.

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

Exemple 5 : Vérifier les autorisations Amazon de l'utilisateur actuel.

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

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

Exemple 6 : Activer, désactiver et mettre à jour la configuration de la suppression différée.

/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