Guide de référence des commandes Veritas NetBackup™
- Introduction
- Annexe A. Commandes NetBackup
- acsd
- add_media_server_on_clients
- backupdbtrace
- backuptrace
- bmrc
- bmrconfig
- bmrepadm
- bmrprep
- bmrs
- bmrsrtadm
- bp
- bparchive
- bpbackup
- bpbackupdb
- bpcatarc
- bpcatlist
- bpcatres
- bpcatrm
- bpcd
- bpchangeprimary
- 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
- bptpcinfo
- bpup
- bpverify
- cat_convert
- cat_export
- cat_import
- configureCerts
- configureCertsForPlugins
- configureMQ
- configurePorts
- configureWebServerCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- csconfig reinitialize
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- nbcomponentupdate
- Commande nbcplogs
- nbcredkeyutil
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_backup
- nbdb_move
- nbdb2adutl
- nbdb_restore
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nbpem
- nbpemreq
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- stopltid
- 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
- Index
Nom
vmchange — modification des informations du média dans la base de données EMM
Synopsis
[-h serveur_emm | hôte_base_données_volumes] -vg_res -rt type_robot -rn numéro_robot -rh hôte_contrôle_robot -v groupe_volumes
[-h serveur_emm | hôte_base_données_volumes] -res -m id_média -mt type_média -rt type_robot -rn numéro_robot -rh hôte_contrôle_robot -v groupe_volumes -rc1 logement_robot
[-h EMM_server | volume_database_host] -exp date -m media_id
[-h EMM_server | volume_database_host] -barcode barcode -m media_id [-rt robot_type]
[-h EMM_server | volume_database_host] -m media_id -vltcid vault_container_id
[-h EMM_server | volume_database_host] -barcode barcode -vltcid vault_container_id
[-h EMM_server | volume_database_host] -d "media_description" -m media_id
[-h EMM_server | volume_database_host] -p pool_number -m media_id
[-h EMM_server | volume_database_host] -maxmounts max_mounts -m media_id
[-h EMM_server | volume_database_host] -clean cleanings left -m media_id
[-h EMM_server | volume_database_host] -n num_mounts -m media_id
[-h EMM_server | volume_database_host] -new_mt media_type -m media_id
[-h EMM_server | volume_database_host] -new_rt robot_type -m media_id -rn robot_number
[-h EMM_server | volume_database_host] -new_v volume_group [-m media_id |{-b barcode -mt media_type -rt robot_type}]
[-h EMM_server | volume_database_host] -vltname vault_name -m media_id
[-h EMM_server | volume_database_host] -vltsent date -m media_id
[-h EMM_server | volume_database_host] -vltreturn date -m media_id
[-h EMM_server | volume_database_host] -vltslot vault_slot -m media_id
[-h EMM_server | volume_database_host] -vltsession vault_session_id -m media_id
-api_eject -map map_id:mapid:...:mapid | any -w [-h EMM_server | volume_database_host] -res -ml media_id:media_id: ...:media_id -rt robot_type -rn robot_number -rh robot_control_host [-v volume_group]
-multi_eject -w [-h EMM_server | volume_database_host] -res -ml media_id:media_id: ...:media_id -rt robot_type -verbose -rn robot_number -rh robot_control_host
-multi_inject -w [-h EMM_server | volume_database_host] -res -rt robot_type -verbose -rn robot_number -rh robot_control_host
[-h EMM_server | volume_database_host] -res -robot_info -verbose -rn robot_number -rt robot_type -rh robot_control_host
Sur les systèmes UNIX, le chemin d'accès à cette commande est /usr/openv/volmgr/bin/
Sur les systèmes Windows, le chemin d'accès à cette commande est chemin_installation\Volmgr\bin\
DESCRIPTION
Cette option permet de modifier les informations de volume de la base de données Enterprise Media Manager.
Tout utilisateur disposant des autorisations nécessaires peut exécuter cette commande.
Pour plus d'informations sur les autorisations NetBackup, consultez le Guide de sécurité et de chiffrement NetBackup.
OPTIONS
- -h serveur_EMM | hôte_base_données_volumes
Cette option s'applique uniquement à NetBackup Enterprise Server.
Nom de l'hôte de base de données Enterprise Media Manager contenant les informations des volumes. Si aucun hôte n'est spécifié, le serveur EMM configuré est utilisé par défaut.
- -vg_res
Modifie l'emplacement du groupe de volumes.
- -rt type_robot
Spécifie le type de robot dans lequel le volume se trouve.
Le serveur Enterprise NetBackup prend en charge les types de robots suivants :
aucun, acs, tld
Le serveur NetBackup prend en charge les types de robots suivants :
aucun, tld
- -rn robot_number
Un numéro de robot correspond à un numéro d'identification logique unique assigné au robot dans lequel le volume se trouve.
- -rh hôte_contrôle_robot
Nom de l'hôte contrôlant le robot sur lequel le volume se trouve.
- -v groupe_volumes
Un groupe de volumes correspond à un regroupement logique identifiant un ensemble de volumes se trouvant sur le même emplacement physique.
- -res
Modifie l'emplacement du volume.
- -m media_id
Spécifie l'ID de média du volume à modifier.
- -mt type_média
Spécifie le type de média du volume à modifier.
Le serveur Enterprise NetBackup prend en charge les types de médias suivants :
4mm, 8mm, 8mm2, 8mm3, dlt, dlt2, dlt3, dtf, hcart, hcart2, hcart3, qcart, 4mm_clean, 8mm_clean, 8mm2_clean, 8mm3_clean, dlt_clean, dlt2_clean, dlt3_clean, dtf_clean, hcart_clean, hcart2_clean, hcart3_clean
Les types de médias suivants sont pris en charge par le serveur NetBackup :
4mm, 8mm, dlt, hcart, qcart, 4mm_clean, 8mm_clean, dlt_clean, hcart_clean
- -rc1 logement_robot
La coordonnée de robot n° 1 correspond au numéro de logement du robot dans lequel le volume se trouve.
Les éléments suivants s'appliquent uniquement à NetBackup Enterprise Server.
Vous ne devez pas entrer les informations de logement des types de robot d'interface de programmation. Le logiciel du robot effectue un suivi des emplacements des logement de ces robots.
- -exp date
Date d'expiration de ce volume.
Le format requis des valeurs de date et d'heure des commandes NetBackup dépend des paramètres régionaux. Le fichier
/user/openv/msg/.conf(UNIX) et le fichierinstall_path\VERITAS\msg\LC.CONF(Windows) contiennent des informations telles que le format de date et d'heure pour tous les paramètres régionaux pris en charge. Les fichiers contiennent des instructions spécifiques concernant l'ajout et la modification de la liste des paramètres régionaux et des formats pris en charge.Consultez la section relative à la spécification des paramètres régionaux de l'installation NetBackup du Guide de l'administrateur NetBackup, volume II.
- -barcode code_barres
Spécifie le code-barres du volume.
- -d "description_média"
Description du média du volume. Si la description contient des espaces, vous devez l'entourer de guillemets doubles.
- -p numéro_pool
Index du pool de volumes contenant ce volume. Vous pouvez récupérer l'index de pool avec la commande vmpool -listall.
- -maxmounts montages_max
Nombre maximal de montages autorisés pour ce volume. Cette option est utilisée uniquement pour les médias n'étant pas des médias de nettoyage.
- -n nombre_montages
Pour les médias qui ne sont pas des médias de nettoyage, la variable nombre_montages correspond au nombre de montages de ce volume.
- -clean nettoyages_restants
Pour nettoyer les médias, la variable nettoyages_restants correspond au nombre de nettoyages restant de cette bande de nettoyage.
- -new_mt type_média
Spécifie le type de média du volume à modifier. Pour obtenir la liste des types de média, reportez-vous à l'option -mt.
- -new_rt type_robot
Spécifie le type de robot. Pour obtenir la liste des types de robot, reportez-vous à l'option -rt.
- -new_v groupe_volumes
Un groupe de volumes correspond à un regroupement logique permettant d'identifier un ensemble de volumes se trouvant sur le même emplacement physique.
- -b code_barres
Spécifie le code-barres du volume.
- -vltcid id_conteneur_centre_sauvegarde
Modifie le conteneur dans lequel un volume est stocké. La variable vault_container_id (une chaîne contenant jusqu'à 29 caractères alphanumériques) spécifie le nouveau conteneur du volume. Utilisez l'option -m ou -barcode pour spécifier le volume.
- -vltname nom_centre_sauvegarde
Spécifie le nom du centre de sauvegarde logique configuré pour le robot ayant éjecté le volume.
- -vltsent date
Spécifie la date à laquelle le volume a été envoyé hors site.
Le format de la variable date dépend des paramètres régionaux de l'utilisateur. Pour les paramètres régionaux du système d'exploitation UNIX, la syntaxe de la date est la suivante :
mm/dd/yyyy [hh[:mm[:ss]]]
- -vltreturn date
Spécifie la date de retour du volume au fournisseur de centre de sauvegarde demandée au volume. Pour des volumes de sauvegarde de catalogue, cette date correspond à la date de retour du volume demandée par le fournisseur de centre de sauvegarde.
Le format requis des valeurs de date et d'heure des commandes NetBackup dépend des paramètres régionaux. Le fichier
/user/openv/msg/.conf(UNIX) et le fichierinstall_path\VERITAS\msg\LC.CONF(Windows) contiennent des informations telles que le format de date et d'heure pour tous les paramètres régionaux pris en charge. Les fichiers contiennent des instructions spécifiques concernant l'ajout et la modification de la liste des paramètres régionaux et des formats pris en charge.Consultez la section relative à la spécification des paramètres régionaux de l'installation NetBackup du Guide de l'administrateur NetBackup, volume II.
- -vltslot logement_centre_sauvegarde
Spécifie le numéro de logement du fournisseur de centre de sauvegarde pour le logement occupé par ce volume.
- -vltsession id_session_centre_sauvegarde
Spécifie l'ID de la session de centre de sauvegarde ayant éjecté ce média.
- -api_eject
Ejecte des volumes du robot spécifié. Le délai d'éjection est d'une semaine.
- -map map_id:mapid: ...:mapid | any
Pour les robots ACS, cette option permet de spécifier les ports d'accès à plusieurs médias (MAP) pour utiliser les opération d'éjection. La variable map_id (également connue comme ID CAP) peut renvoyer la valeur all ou ALL, . Vous pouvez également spécifier une liste de ports d'accès aux médias séparés par deux points (:) au format ACS, LSM, CAP. Lorsque l'option -map est utilisée, les médias sont éjectés vers les ports d'accès aux médias spécifiés en utilisant l'algorithme de port d'accès aux médias le plus proche. L'algorithme suppose que les gestionnaires de volume logique sont connectés à une ligne.
- -w
Indicateur d'attente. Vous devez utiliser cet indicateur lors des opération d'éjection d'un ou plusieurs élements ou dans les commandes d'éjection.
- -verbose
Sélectionne le mode détaillé.
- -ml id_média:id_média: ...:id_média
Spécifie la liste des médias à éjecter du robot.
- -multi_eject
Utilise le port d'accès de média de la bibliothèque robotique pour éjecter plusieurs volumes. Cette option est uniquement valide pour les robots TLD. Le délai d'éjection est de 30 minutes.
- -multi_inject
Utilise le port d'accès de média de la bibliothèque robotique pour injecter plusieurs volumes. Cette option est uniquement valide pour les robots TLD. L'utilisateur doit exécuter la commande vmupdate après cette opération de mise à jour de la base de données EMM.
- -robot_info
Récupère les informations sur une bibliothèque robotique. Cette option est uniquement valide pour les robots TL8.
Champ 1 = nombre de logements
Champ 2 = nombre de ports d'insertion/éjection
Champ 3 = nombre de lecteurs
Champ 4 = type et sous-type de robot (par exemple, tld -> 0)
Champ 5 = lecteur de codes-barres. Si un lecteur de codes-barres existe sur ce périphérique robotique, ce champ indique que le robot possède un lecteur de codes-barres.
Champ 6 = logement de départ
Champ 7 = logement de fin
Champ 8 = chaîne d'investigation principale (par exemple, HP~~~~~~C6240-8000~~~~~~2912)
AVERTISSEMENTS
Certaines bandothèques implémentent plusieurs fonctionnalités pour leurs ports d'accès au média. Par exemple, certaines bandothèques contiennent des fonctions d'insertion et d'éjection en avant-plan entrant en conflit avec l'utilisation du port d'accès au média de NetBackup Certaines bandothèques nécessitent une interaction en avant-plan lors de l'utilisation du port d'accès au média (par exemple : Spectra Logic Gator).
Si vous utilisez une option d'éjection, si le média n'est pas retiré et si cela entraîne un délai, le média est renvoyé (injecté) au robot. Dans ce cas, effectuez un inventaire du robot et éjectez le média renvoyé au robot.
Pour comprendre les fonctions de port d'accès au média de la bandothèque, reportez-vous au guide de l'opérateur. Les bandothèques telles que celles qui sont notées peuvent ne pas être entièrement compatibles avec les fonctions NetBackup d'injection et d'éjection si elles ne sont pas correctement gérées. Les autres bibliothèques peuvent être totalement incompatibles. De plus, NetBackup effectue une validation limitée de ces paramètres d'option.
EXEMPLES
Exemple 1 - Modifier la date d'échéance du volume AJS100 :
# vmchange -exp 12/31/12 23:59:59 -m AJS100
Exemple 2 - Définir le pool (qui contient le volume AJS999) sur le pool 1 (pool NetBackup) :
# vmchange -p 1 -m AJS999
Exemple 3 - Ejecter des volumes abc123 et abc124 du robot ACS numéro 700. Les emplacements de ces deux volumes se trouvent désormais à des emplacements autonomes.
# vmchange -res -api_eject -w -ml abc123:abc124 -rt acs -rn 700 -rh verbena -map 0,0,0
Exemple 4 - Modifier l'ID de conteneur du volume ABC123 :
# vmchange -vltcid Container001 -m ABC123