NetBackup™ Commands Reference Guide
- Introduction
- Annexe A. NetBackup Commands
- 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_backup
- nbdb_move
- nbdb2adutl
- nbdb_restore
- nbdbms_start_stop
- nbdc
- nbdecommission
- nbdelete
- nbdeployutil
- nbdevconfig
- nbdevquery
- nbdiscover
- nbdna
- nbemm
- nbemmcmd
- nbepicfile
- nbfindfile
- nbfirescan
- nbfp
- nbftadm
- nbftconfig
- nbgetconfig
- nbhba
- nbholdutil
- nbhostidentity
- nbhostmgmt
- nbhypervtool
- nbidpcmd
- nbimageshare
- nbinstallcmd
- nbjm
- nbkmiputil
- nbkmscmd
- nbkmsutil
- nboraadm
- nborair
- nboracmd
- nbpem
- nbpemreq
- nbmariadb
- nbmlb
- nbperfchk
- nbplupgrade
- nbrb
- nbrbutil
- nbreplicate
- nbrepo
- nbrestorevm
- nbseccmd
- nbserviceusercmd
- nbsetconfig
- nbshvault
- nbsmartdiag
- nbsnapimport
- nbsnapreplicate
- nbsqladm
- nbsqlite
- nbstl
- nbstlutil
- nbstop
- nbsu
- nbsvrgrp
- netbackup_deployment_insights
- 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
Nom
vmchange — modification des informations du média dans la base de données EMM
Synopsis
[-h EMM_server | volume_database_host] -vg_res -rt robot_type -rn robot_number -rh robot_control_host -v volume_group
[-h EMM_server | volume_database_host] -res -m media_id -mt media_type -rt robot_type -rn robot_number -rh robot_control_host -v volume_group -rc1 rob_slot
[-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
On UNIX systems, the directory path to this command is /usr/openv/volmgr/bin/
On Windows systems, the directory path to this command is install_path\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.
- -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 :
none, 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.
- -vg_res
Modifie l'emplacement du volume.
- -m id_média
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 :
dlt, dlt2, dlt3, hcart, hcart2, hcart3, dlt_clean, dlt2_clean, dlt3_clean, hcart_clean, hcart2_clean, hcart3_clean
Le serveur NetBackup prend en charge les types de médias suivants :
dlt, hcart, 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 logements 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.
- -barcode 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.
- -vault nom_centre_sauvegarde
Spécifie le nom du centre de sauvegarde logique configuré pour le robot ayant éjecté le volume.
- -vltreturn 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]]]
- -vltsent 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 ACS du robot spécifié. Le délai d'éjection est d'une semaine.
- -ml id_média:id_média: ...:id_média
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 considère que les gestionnaires de volumes logiques 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
Cette option utilise le port d'accès au média de la bandothèque pour éjecter plusieurs volumes. Cette option est uniquement valide pour les robots TLD. Le délai d'éjection est de 30 minutes.
- -multi_eject
Cette option utilise le port d'accès au média de la bandothèque 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.
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 - 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