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
- Utilitaire cat_export
- Utilitaire cat_import
- configurePorts
- configureTPCerts
- create_nbdb
- csconfig cldinstance
- csconfig cldprovider
- csconfig meter
- csconfig throttle
- duplicatetrace
- importtrace
- jbpSA
- jnbSA
- ltid
- manageClientCerts
- mklogdir
- nbauditreport
- nbcatsync
- NBCC
- NBCCR
- nbcertcmd
- nbcertupdater
- nbcldutil
- nbcloudrestore
- nbcomponentupdate
- Commande nbcplogs
- nbdb_admin
- nbdb_backup
- nbdb_move
- nbdb_ping
- nbdb_restore
- nbdb_unload
- nbdbms_start_server
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbfindfile
- nbfirescan
- nbftadm
- nbftconfig
- Commande nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbinstallcmd
- nbjm
- nbkmsutil
- Commande nboraadm
- nborair
- nbpem
- nbpemreq
- nbperfchk
- nbplupgrade
- nbrb
- Commande nbrbutil
- nbregopsc
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbsetconfig
- Commande nbsnapimport
- Commande nbsnapreplicate
- nbsqladm
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- resilient_clients
- restoretrace
- Commande stopltid
- tl4d
- tl8d
- tl8cd
- tldd
- tldcd
- tlhd
- tlhcd
- tlmd
- 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
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 serveur_emm | hôte_base_données_volumes] -exp date -m id_média
[-h serveur_emm | hôte_base_données_volumes] -barcode code_barres -m id_média [-rt type_robot]
[-h serveur_emm | hôte_base_données_volumes] -m id_média -vltcid id_conteneur_centre_sauvegarde
[-h serveur_emm | hôte_base_données_volumes] -barcode code_barres -vltcid id_conteneur_centre_sauvegarde
[-h serveur_emm | hôte_base_données_volumes] -d "description_média" -m id_média
[-h serveur_emm | hôte_base_données_volumes] -p numéro_pool -m id_média
[-h serveur_emm | hôte_base_données_volumes] -maxmounts montages_max -m id_média
[-h serveur_emm | hôte_base_données_volumes] -clean nettoyages_restants -m id_média
[-h serveur_emm | hôte_base_données_volumes] -n nombre_montages -m id_média
[-h serveur_emm | hôte_base_données_volumes] -new_mt type_média -m id_média
[-h serveur_emm | hôte_base_données_volumes] -new_rt type_robot -m id_média -rn numéro_robot
[-h serveur_emm | hôte_base_données_volumes] -new_v groupe_volumes [-m id_média |{-b code_barres -mt type_média -rt type_robot}]
[-h serveur_emm | hôte_base_données_volumes] -vltname nom_centre_sauvegarde -m id_média
[-h serveur_emm | hôte_base_données_volumes] -vltsent date -m id_média
[-h serveur_emm | hôte_base_données_volumes] -vltreturn date -m id_média
[-h serveur_emm | hôte_base_données_volumes] -vltslot logement_centre_sauvegarde -m id_média
[-h serveur_emm | hôte_base_données_volumes] -vltsession id_session_centre_sauvegarde -m id_média
-api_eject -map id_port_accès_média:id_port_accès_média:...:id_port_accès_média | tout -w [-h serveur_emm | hôte_base_données_volumes] -res -ml id_média:id_média: ...:id_média -rt type_robot -rn numéro_robot -rh hôte_contrôle_robot [-v groupe_volumes]
-multi_eject -w [-h serveur_emm | hôte_base_données_volumes] -res -ml id_média:id_média: ...:id_média -rt type_robot -verbose -rn numéro_robot -rh hôte_contrôle_robot
-multi_inject -w [-h serveur_emm | hôte_base_données_volumes] -res -rt type_robot -verbose -rn numéro_robot -rh hôte_contrôle_robot
[-h serveur_emm | hôte_base_données_volumes] -res -robot_info -verbose -rn numéro_robot -rt type_robot -rh hôte_contrôle_robot
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, reportez-vous au 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 robot_type
Spécifie le type du robot dans lequel le volume se trouve.
Le serveur Enterprise NetBackup prend en charge les types de robots suivants :
none, acs, tl4, tl8, tld, tlh, tlm
Le serveur NetBackup prend en charge les types de robots suivants :
none, tl4, tl8, tld
- -rn numéro_robot
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
Le seveur NetBackup prend en charge les types de médias suivants :
4mm, 8mm, dlt, hcart, qcart, 4mm_clean, 8mm_clean, dlt_clean, hcart_clean
- -rc1 logement_robot
Les coordonnées de robot n° 1 correpondent au numéro de logement du robot sur 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.Pour plus d'informations, consultez la section "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 qui ne sont 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 au fournisseur de centre de sauvegarde demandée au volume. Pour des volumes de sauvegarde de catalogue, cette date correspond à la date de retour au fournisseur de centre de sauvegarde demandée au 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.Pour plus d'informations, consultez la section "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 ACS, TLH ou TLM du robot spécifié. Pour les robots ACS et TLM, le délai d'éjection correspond à une semaine. Pour les robots TLH, le robot peut à tout moment supprimer des médias.
- -map id_port_accès_média:id_port_accès_média: ...:id_port_accès_média | tout
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, . Ces valeurs correspondent à tous les ports d'accès aux médias du robot. 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.
Pour les robots TLM, utilisez la variable map_id "ANY" pour les opérations d'éjection vers le port d'accès au média configuré pour chaque type de média sur le serveur DAS/SDLC.
Pour les robots TLH, sélectionnez le port d'accès au média standard ou le le port d'accès au média global, selon la configuration matérielle de la bibliothèque.
- -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
Cette option utilise le port d'accès au média de la bandothèque pour éjecter plusieurs volumes. Seuls les robots TL8 et TLD prennent en charge cette option. Le délai d'éjection est de 30 minutes.
- -multi_inject
Cette option utilise le port d'accès au média de la bandothèque pour injecter plusieurs volumes. Seuls les robots TL8 et TLD prennent en charge cette option. 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
Extrait les informations concernant une bandothèque. Seuls les robots TL8 et TLD prennent en charge cette option.
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 (par exemple : Spectra Logic Bullfrog). 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 - Modification de 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