NetBackup™ Commands Reference Guide

Last Published:
Product(s): NetBackup & Alta Data Protection (10.4)
  1. Introduction
    1.  
      A propos des commandes de NetBackup
    2.  
      Navigation dans les niveaux de menu
    3.  
      Conventions des commandes NetBackup
    4.  
      Remarques sur les commandes de NetBackup Media Manager
    5.  
      Mises à jour IPv6
  2. Annexe A. NetBackup Commands
    1.  
      acsd
    2.  
      backupdbtrace
    3.  
      backuptrace
    4.  
      bmrc
    5.  
      bmrconfig
    6.  
      bmrepadm
    7.  
      bmrprep
    8.  
      bmrs
    9.  
      bmrsrtadm
    10.  
      bp
    11.  
      bparchive
    12.  
      bpbackup
    13.  
      bpbackupdb
    14.  
      bpcatarc
    15.  
      bpcatlist
    16.  
      bpcatres
    17.  
      bpcatrm
    18.  
      bpcd
    19.  
      bpchangeprimary
    20.  
      bpcleanrestore
    21.  
      bpclient
    22.  
      bpclimagelist
    23.  
      bpclntcmd
    24.  
      bpclusterutil
    25.  
      bpcompatd
    26.  
      bpconfig
    27.  
      bpdbjobs
    28.  
      bpdbm
    29.  
      bpdgclone
    30.  
      bpdown
    31.  
      bpduplicate
    32.  
      bperror
    33.  
      bpexpdate
    34.  
      bpfis
    35.  
      bpflist
    36.  
      bpgetconfig
    37.  
      bpgetdebuglog
    38.  
      bpimage
    39.  
      bpimagelist
    40.  
      bpimmedia
    41.  
      bpimport
    42.  
      bpinst
    43.  
      bpkeyfile
    44.  
      bpkeyutil
    45.  
      bplabel
    46.  
      bplist
    47.  
      bpmedia
    48.  
      bpmedialist
    49.  
      bpminlicense
    50.  
      bpnbat
    51.  
      bpnbaz
    52.  
      bppficorr
    53.  
      bpplcatdrinfo
    54.  
      bpplclients
    55.  
      bppldelete
    56.  
      bpplinclude
    57.  
      bpplinfo
    58.  
      bppllist
    59.  
      bpplsched
    60.  
      bpplschedrep
    61.  
      bpplschedwin
    62.  
      bppolicynew
    63.  
      bpps
    64.  
      bprd
    65.  
      bprecover
    66.  
      bprestore
    67.  
      bpretlevel
    68.  
      bpschedule
    69.  
      bpschedulerep
    70.  
      bpsetconfig
    71.  
      bpstsinfo
    72.  
      bpstuadd
    73.  
      bpstudel
    74.  
      bpstulist
    75.  
      bpsturep
    76.  
      bptestbpcd
    77.  
      bptestnetconn
    78.  
      bpup
    79.  
      bpverify
    80.  
      cat_convert
    81.  
      cat_export
    82.  
      cat_import
    83.  
      configureCerts
    84.  
      configureMQ
    85.  
      configureWebServerCerts
    86.  
      create_nbdb
    87.  
      csconfig cldinstance
    88.  
      csconfig cldprovider
    89.  
      csconfig meter
    90.  
      csconfig reinitialize
    91.  
      csconfig throttle
    92.  
      duplicatetrace
    93.  
      importtrace
    94.  
      jbpSA
    95.  
      jnbSA
    96.  
      ltid
    97.  
      mklogdir
    98.  
      msdpcldutil
    99.  
      nbauditreport
    100.  
      nbcallhomeproxyconfig
    101.  
      nbcatsync
    102.  
      NBCC
    103.  
      NBCCR
    104.  
      nbcertcmd
    105.  
      nbcertupdater
    106.  
      nbcldutil
    107.  
      nbcmdrun
    108.  
      nbcomponentupdate
    109.  
      nbcplogs
    110.  
      nbcredkeyutil
    111.  
      nbdb_admin
    112.  
      nbdb_backup
    113.  
      nbdb_move
    114.  
      nbdb_ping
    115.  
      nbdb_backup
    116.  
      nbdb_move
    117.  
      nbdb2adutl
    118.  
      nbdb_restore
    119.  
      nbdbms_start_stop
    120.  
      nbdc
    121.  
      nbdecommission
    122.  
      nbdelete
    123.  
      nbdeployutil
    124.  
      nbdevconfig
    125.  
      nbdevquery
    126.  
      nbdiscover
    127.  
      nbdna
    128.  
      nbemm
    129.  
      nbemmcmd
    130.  
      nbepicfile
    131.  
      nbfindfile
    132.  
      nbfirescan
    133.  
      nbfp
    134.  
      nbftadm
    135.  
      nbftconfig
    136.  
      nbgetconfig
    137.  
      nbhba
    138.  
      nbholdutil
    139.  
      nbhostidentity
    140.  
      nbhostmgmt
    141.  
      nbhypervtool
    142.  
      nbidpcmd
    143.  
      nbimageshare
    144.  
      nbinstallcmd
    145.  
      nbjm
    146.  
      nbkmiputil
    147.  
      nbkmscmd
    148.  
      nbkmsutil
    149.  
      nboraadm
    150.  
      nborair
    151.  
      nboracmd
    152.  
      nbpem
    153.  
      nbpemreq
    154.  
      nbmariadb
    155.  
      nbmlb
    156.  
      nbperfchk
    157.  
      nbplupgrade
    158.  
      nbrb
    159.  
      nbrbutil
    160.  
      nbreplicate
    161.  
      nbrepo
    162.  
      nbrestorevm
    163.  
      nbseccmd
    164.  
      nbserviceusercmd
    165.  
      nbsetconfig
    166.  
      nbshvault
    167.  
      nbsmartdiag
    168.  
      nbsnapimport
    169.  
      nbsnapreplicate
    170.  
      nbsqladm
    171.  
      nbsqlite
    172.  
      nbstl
    173.  
      nbstlutil
    174.  
      nbstop
    175.  
      nbsu
    176.  
      nbsvrgrp
    177.  
      netbackup_deployment_insights
    178.  
      resilient_clients
    179.  
      restoretrace
    180.  
      stopltid
    181.  
      tldd
    182.  
      tldcd
    183.  
      tpautoconf
    184.  
      tpclean
    185.  
      tpconfig
    186.  
      tpext
    187.  
      tpreq
    188.  
      tpunmount
    189.  
      verifytrace
    190.  
      vltadm
    191.  
      vltcontainers
    192.  
      vlteject
    193.  
      vltinject
    194.  
      vltoffsitemedia
    195.  
      vltopmenu
    196.  
      vltrun
    197.  
      vmadd
    198.  
      vmchange
    199.  
      vmcheckxxx
    200.  
      vmd
    201.  
      vmdelete
    202.  
      vmoprcmd
    203.  
      vmphyinv
    204.  
      vmpool
    205.  
      vmquery
    206.  
      vmrule
    207.  
      vmupdate
    208.  
      vnetd
    209.  
      vssat
    210.  
      vwcp_manage
    211.  
      vxlogcfg
    212.  
      vxlogmgr
    213.  
      vxlogview
    214.  
      W2KOption

Nom

nbemmcmd — met à jour et affiche les informations dans la base de données EMM

Synopsis

nbemmcmd [-addhost] [-changesetting] [-deletehost] [-errorsdb] [-getemmserver] [-help] [-listhosts] [-listmedia] [-listsettings] [-machinealias] [-renamehost] [-resethost] [-servercontrol] [-setemmserver] [-updatehost]

nbemmcmd -addhost [-activenodename string] [-brief] [-clustername string] [-displayname string] [-machinedescription string] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp [-masterserver string] [-netbackupversion level[.major_level[minor_level]]] [-operatingsystem hpux | linux | rs6000 | solaris | windows] [-scanability unsigned_integer]

nbemmcmd -changesetting -machinename string [-ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA 0|1|no|yes] [-AUDIT_ RETENTION_PERIOD number_of_days] [-COMMON_SERVER_FOR_DUP default | preferred | required] [-DISABLE_AUTOMATIC_HOST_NAME_ADD 0|1|no|yes] [-DISABLE_BACKUPS_SPANNING_DISK 0|1|no|yes] [-DISABLE_DISK_STU_JOB_THROTTLING 0|1|no|yes] [-DISABLE_STANDALONE_DRIVE_EXTENSIONS 0|1|no|yes] [-DISALLOW_NONNDMP_ON_NDMP_DRIVE 0|1|no|yes] [-DO_NOT_EJECT_STANDALONE 0|1|no|yes] [-DONT_USE_SLAVE 0|1|no|yes] [-DRIVE_ERROR_THRESHOLD unsigned_integer] [-DRIVE_NAME_SEED 0|1|no|yes] [-emmname string] [-emmport unsigned_integer] [-MAX_REALLOC_TRIES unsigned_integer] [-MEDIA_ERROR_THRESHOLD unsigned_integer] [-MEDIA_REQUEST_DELAY unsigned_integer] [-MPMS_DISABLE_EVENTS 0|1|no|yes] [-MPMS_DISABLE_RANK unsigned_integer] [-MUST_USE_LOCAL_DRIVE 0|1|no|yes] [-NBUFS_DESTINATION_DSU string] [-NBUFS_DUP_TSU_TO_DSU 0|1|no|yes] [-NBUFS_RETENTION_LEVEL unsigned_integer] [-NON_ROBOTIC_MEDIA_ID_PREFIX string] [-PREFER_NDMP_PATH_FOR_RESTORE 0|1|no|yes] [-PREFER_SPAN_TO_SCRATCH 0|1|no|yes] [-RETURN_UNASSIGNED_MEDIA_TO_SCRATCH_POOL 0|1|no|yes] [-SCSI_PROTECTION NONE | SPR | SR] [-SHAREDISK_MOUNT_POINT string] [-TIME_WINDOW unsigned_integer] [-UNRESTRICTED_SHARING 0|1|no|yes] [-USE_POTENTIAL_FREESPACE_FOR_ALLOCATION 0|1|no|yes] [-VALIDATE_HOST_NAME 0|1|no|yes] [-VAULT_CLEAR_MEDIA_DESC 0|1|no|yes]

nbemmcmd -deletealldevices [-allrecords] | [-machinename string] | [-machinetype api | app_cluster | appliance | client | cluster | disk_array | foreign_media | master | media | nbwss_endpoint | ndmp | remote_master | replication_host | virtual_machine] [-emmname string] [-emmport unsigned_integer]

nbemmcmd -deletehost [-brief] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp | master | media | ndmp-mediaid string

nbemmcmd -errorsdb [-brief] [-prune [-days no_of_days] [-hours no_of_hours] [-minutes no_of_minutes]]

nbemmcmd -getemmserver [-masterserver string] [-timeout unsigned_integer]

nbemmcmd -listhosts [-brief] [-verbose] [-parsable] [-list_snap_vault_filers -machinename string] [-list_snap_vault_media_servers -masterserver string] [-list_sts_hosts -machinename string] [-list_sts_media_servers -masterserver string] [-list_app_clusters -masterserver string] [-servers_in_emm_cluster -clustername string] [-servers_in_app_cluster -clustername string] [-nbservers [-masterserver string]] [-display_server -machinename string -machinetype string] [-netbackupversion level[.major_level[minor_level]]]

nbemmcmd -listmedia [-allrecords] [-mediaid string] [-mediatype unsigned_integer] [-poolname string] [-robotnumber unsigned integer] [-vaultcontainer string]

nbemmcmd -listsettings -machinename string [-brief] [-emmname string] [-emmport unsigned_integer]

nbemmcmd -machinealias [-addalias -alias string -machinename string] [-deletealias -alias string] [-deleteallaliases -machinename string] [-getaliases -machinename string] -machinetype api | app_cluster | cluster | master | media | ndmp

nbemmcmd -releasecache -machinename string [-brief] [-emmname string] [-emmport unsigned_integer]

nbemmcmd -renamehost [-brief] -machinename string -machinetype api | app_cluster | cluster | master | media | ndmp -newmachinename string

nbemmcmd -resethost -machinename string

nbemmcmd -servercontrol [-brief] [-resume] [-suspend]

nbemmcmd -setemmserver [-brief] -emmservername string [-masterserver string] -newemmservername string [-timeout unsigned_integer]

nbemmcmd -updatehost [-activenodename string] [-add_server_to_app_cluster] [-brief] [-clustername string] [-delete_server_from_app_cluster] [-displayname string] [-machinedescription string] -machinename string [-machinestateop clr_admin_pause | clr_admin_pause_and_set_active | clr_disk_active | clr_ltid_restart | clr_master_server_connectivity | clr_tape_active | reset_all | set_admin_pause | set_disk_active | set_master_server_connectivity | set_tape_active] [-machinetype pi | app_cluster | cluster | master | media | ndmp] [-masterserver string] [-netbackupversion level[.major_level[minor_level]]] [-operatingsystem hpux | linux | rs6000 | solaris | windows]

 

On UNIX systems, the directory path to this command is /usr/openv/netbackup/bin/admincmd/

On Windows systems, the directory path to this command is install_path\NetBackup\bin\admincmd\

DESCRIPTION

La commande nbemmcmd permet à des utilisateurs de mettre à jour un nombre limité d'informations de base de données EMM. En outre, cette commande vous permet de gérer les entrées d'hôte, les options et d'autres éléments divers dans la base de données EMM.

OPTIONS

Les commandes suivantes contiennent un grand choix d'options qui vous permettent de gérer la base de données EMM. Les noms des options sont longs pour fournir à l'utilisateur une meilleure compréhension de la façon dont les options doivent être utilisées. En raison de la longueur de nom d'option, vous devez seulement saisir la ou les premières lettres de la commande qui lui font une seule option. Par exemple, pour utiliser l'option -changesetting, saisissez -c car aucune autre option de commande ne commence par la lettre c.

-addhost

Cette option ajoute l'hôte spécifié à la base de données EMM. Vous pouvez ajuster les entrées suivantes à l'aide de l'option de commande ci-dessous :

-activenodename chaîne

Identifie le nœud actif dans un cluster.

-brief

Génère une sortie moins détaillée de la commande.

-clustername chaîne

Identifie le cluster auquel appartient cet ordinateur.

-displayname chaîne

Définit le nom affiché de l'ordinateur.

-machinedescription chaîne

Décrit l'ordinateur ou le système en cours d'utilisation.

-machinename chaîne

Spécifie le nom de l'ordinateur à mettre à jour.

-machinetype api | app_cluster | cluster | master | media | ndmp

Définit la manière dont l'ordinateur est utilisé.

-masterserver chaîne

Définit le serveur maître hôte dans un domaine particulier.

-netbackupversion niveau[.niveau_majeur[niveau_mineur]]

Spécifie la version exécutée par l'hôte ajouté. La variable level est comprise entre 0 et 99. Les variables major_level et minor_level sont des champs facultatifs à un chiffre. Aucun espace n'est autorisé entre les variables major_level et minor_level.

Par exemple, saisissez les informations suivantes pour spécifier NetBackup 7.0 :

-netbackupversion 7.0 or -netbackupversion 7
-operatingsystem hpux | linux | rs6000 | solaris | windows

Ajoute un hôte avec un système d'exploitation désigné.

-scanability entier_non_signé

Cette option s'applique uniquement aux serveurs NetBackup Enterprise qui utilisent la fonction Shared Storage Option (SSO).

Un facteur de capacité d'analyse peut s'étendre de zéro à neuf, avec une valeur par défaut de cinq. Ce facteur permet d'assigner des hôtes d'analyse en priorité si l'hôte d'analyse d'un lecteur change. Les hôtes d'analyse comprenant des facteurs de capacité d'analyse plus élevés sont choisis en premier.

Attention :

Un lecteur ne devient disponible à l'utilisation qu'à partir du moment où un hôte d'analyse peut lui être assigné. Si tous les hôtes qui s'enregistrent pour un lecteur particulier utilisentscan_factor = 0, ce lecteur est inutilisable. Le lecteur demeure inutilisable jusqu'à ce qu'un hôte avec un scan_factor différent de zéro s'enregistre pour le lecteur. Si tous les hôtes ayant un facteur d'analyse différent de zéro ont un lecteur arrêté (DOWN), le lecteur devient à nouveau indisponible.

La décision d'utiliser un facteur d'analyse égal à zéro pour un serveur réduit le niveau d'élasticité de votre configuration SSO. Sachez que des serveurs peuvent être utilisés comme hôtes d'analyse pour un lecteur. Si un lecteur perd un hôte d'analyse, il devient indisponible pour tous les serveurs.

-changesetting -machinename chaîne

Modifie les paramètres de configuration d'un hôte spécifié et ajoute les paramètres qui n'existaient pas précédemment.

Pour modifier ces options de configuration, utilisez -changesetting avec le nom d'option et l'indicateur d'activation (1 ou yes) ou de désactivation (0 ou no). Par exemple, la commande suivante désactive la capacité d'Enterprise Media Manager (EMM) à ajouter un nom d'hôte automatiquement :

# nbemmcmd -changesetting -DISABLE_AUTOMATIC_HOST_NAME_ADD no
-ALLOW_MULTIPLE_RETENTIONS_PER_MEDIA 0 | 1 | no | yes

Permet à NetBackup de combiner des niveaux de conservation sur des médias. Par défaut, chaque volume peut contenir des sauvegardes d'un seul niveau de conservation.

-AUDIT_RETENTION_PERIOD number_of_days

L'option -AUDIT_RETENTION_PERIOD est obsolète. Utilisez les commandes indiquées pour définir ou obtenir la période de conservation des enregistrements d'audit :

nbseccmd -setsecurityconfig -auditretentionperiod number_of_days ou nbseccmd -getsecurityconfig -auditretentionperiod

-COMMON_SERVER_FOR_DUP default | preferred | required

Détermine la manière dont NetBackup recherche les serveurs de médias souhaités dupliquer les données.

Le serveur de médias utilisé pour lire l'image est le "serveur de médias de lecture". Le serveur de médias utilisé pour écrire l'image est le "serveur de médias d'écriture". Par défaut, lorsque l'image source est sur un périphérique de bande, le serveur de médias de lecture est celui qui enregistre l'image de sauvegarde. De plus, lorsque l'image source se trouve sur un pool de disques avec plusieurs serveurs de médias, n'importe lequel de ces serveurs de médias peut être le serveur de médias de lecture. Le choix du serveur de médias d'écriture est limité à ceux ayant accès à l'unité de stockage ou au groupe d'unités de stockage spécifié en tant qu'emplacement de la duplication.

Les paramètres possibles pour cette option sont les suivants :

  • Par défaut. NetBackup n'effectue pas de recherche approfondie sur les éventuels serveurs communs (serveur de médias de lecture et d'écriture identique). Si les serveurs de médias communs sont occupés ou indisponibles, NetBackup utilise un serveur de médias d'écriture différent du serveur de médias de lecture. Utilisez cette option lorsque vous ne souhaitez pas qu'une recherche approfondie affecte les performances de Resource Broker. Ce scénario peut se produire lorsqu'une grande file d'attente de travaux de duplication attend que des ressources deviennent disponibles.

  • Préféré. Rechercher un serveur de médias commun à utiliser. Si un ou plusieurs serveurs de médias communs sont trouvés, mais que leurs ressources (par exemple des DSU ou des lecteurs de bande) sont occupées, procédez comme suit : exécutez le travail de duplication malgré tout en utilisant deux serveurs de médias distincts (en transmettant les images par le réseau).

  • Requis. NetBackup effectue une recherche exhaustive afin de trouver un serveur commun. Si les serveurs de médias communs sont occupés, NetBackup met la demande de ressource en file d'attente et attend que les ressources soient disponibles. NetBackup exécute le travail avec deux serveurs de médias distincts, en transmettant les images par le réseau, si ce qui suit est vrai : aucun serveur commun n'existe dans le domaine NetBackup ou un serveur commun existe mais est arrêté.

-DISABLE_AUTOMATIC_HOST_NAME_ADD 0|1|no|yes

Désactive la capacité d'EMM à ajouter un nom d'hôte automatiquement s'il semble être valide. Un exemple de nom d'hôte non valide est un nom identique à celui d'un autre hôte.

-DISABLE_BACKUPS_SPANNING_DISK 0|1|no|yes

Désactive la capacité de poursuivre une opération de sauvegarde sur disque lorsqu'un système de fichiers arrive à saturation sur un volume d'unité de stockage sur disque. Cette désactivation utilise des fragments d'image sur plusieurs volumes d'unités de stockage.

-DISABLE_DISK_STU_JOB_THROTTLING 0|1|no|yes

Désactive l'action de limitation du travail de l'unité de stockage sur disque qui se produit lorsque les unités de stockage sur disque approchent leur borne haute. La limitation des unités de stockage sur disque réduit le nombre de travaux démarrés simultanément pour approcher la borne haute avec plus de précision. Par défaut : limite les unités de stockage sur disque qui approchent leur borne haute.

-DISABLE_STANDALONE_DRIVE_EXTENSIONS 0|1|no|yes

Désactive les opérations de lecteur non robotique. Lors d'une sauvegarde, NetBackup n'essaie pas automatiquement d'utiliser n'importe quel média libellé ou non qui se trouve dans un lecteur non robotique. La condition par défaut est que les extensions de lecteurs autonomes sont activées.

-DISALLOW_NONNDMP_ON_NDMP_DRIVE 0|1|no|yes

Cette option est lue par la logique MDS du serveur EMM. NetBackup utilise un lecteur disponible en fonction du type de demande, comme suit :

Pour une demande non-NDMP de n'importe quelle sorte, NetBackup recherche un lecteur non-NDMP disponible. Si aucun lecteur non-NDMP n'est disponible, mais qu'un lecteur NDMP est disponible, le lecteur NDMP le plus lent est utilisé. Les demandes non NDMP incluent tous les types de demandes à l'exception des demandes liées aux unités de stockage (sauvegardes et enregistrements de doublons) et des restaurations d'images NDMP.

-DO_NOT_EJECT_STANDALONE 0|1|no|yes

Si cette entrée est activée, les bandes contenues dans les lecteurs autonomes ne sont pas éjectées à la fin d'une sauvegarde sur cet hôte (les bandes sont éjectées si une sauvegarde atteint la fin de la bande). Utilisez cette option lorsque vous souhaitez maintenir un lecteur autonome prêt après la réussite de sauvegardes.

-DONT_USE_SLAVE 0|1|no|yes

Désélectionne l'utilisation de règles de dénomination de lecteurs utilisées pour assigner automatiquement des noms aux lecteurs.

-DRIVE_ERROR_THRESHOLD entier_non_signé

Modifie le seuil ou le nombre d'erreurs de lecteur qui peuvent se produire avant que NetBackup ne modifie l'état du lecteur sur ARRÊTÉ. Par défaut : 2.

-DRIVE_NAME_SEED 0|1|no|yes

Sélectionne l'utilisation de règles de dénomination de lecteurs pour une dénomination automatique des lecteurs.

-emmname chaîne

Spécifie le nom du serveur de base de données EMM. Ce serveur contient la base de données qui regroupe les informations de médias et de configuration des périphériques.

-emmport entier_non_signé

Spécifie le port EMM.

-machinename chaîne

Nomme l'ordinateur dont les paramètres ont été modifiés.

-MAX_REALLOC_TRIES entier_non_signé

Spécifie le nombre maximal de tentatives de NetBackup pour la réassignation des médias pour de futures sauvegardes.

-MEDIA_ERROR_THRESHOLD entier_non_signé

Modifie le seuil ou le nombre d'erreurs de médias qui peuvent se produire avant que le média ne soit figé. Par défaut : 2.

-MEDIA_REQUEST_DELAY entier_non_signé

Spécifie le nombre de secondes pendant lesquelles NetBackup attend qu'un lecteur soit prêt. S'applique seulement aux lecteurs non robotiques. Paramètre par défaut : 0 secondes. Par exemple, supposons que le délai soit de 150 secondes :

MEDIA_REQUEST_DELAY = 150

Ajoutez ces informations au fichier bp.conf sur les serveurs NetBackup ou saisissez une valeur pour Retard de requête de médias dans les propriétés de l'hôte de médias.

-MPMS_DISABLE_EVENTS 0|1|no|yes, -MPMS_DISABLE_RANK 0|1|no|yes, -MUST_USE_LOCAL_DRIVE 0|1|no|yes

Si le client est également un serveur maître et que cette option est activée, les sauvegardes pour ce client doivent être effectuées sur un lecteur local. Si le client n'est pas un serveur principal, cette entrée n'a aucun effet.

Ajoutez cette option au fichier bp.conf sur les serveurs maîtres. Ou vérifiez le paramètre Le lecteur local doit être utilisé dans la boîte de dialogue de propriétés de l'hôte du serveur général.

-NBUFS_DESTINATION_DSU chaîne, -NBUFS_DUP_TSU_TO_DSU 0|1|no|yes, -NBUFS_RETENTION_LEVEL entier_non_signé, -NON_ROBOTIC_MEDIA_ID_PREFIX chaîne

Spécifie le préfixe d'ID du média utilisé pour créer des médias non robotiques. Ce préfixe s'applique à l'hôte spécifié par l'option -machinename. Le préfixe d'ID du média correspond à une chaîne de caractères alphanumériques comprenant un à trois caractères.

-PREFER_NDMP_PATH_FOR_RESTORE 0|1|no|yes (valeur par défaut : 1 ou no)

Utilisé pour spécifier comment NetBackup sélectionne des lecteurs pour des restaurations NDMP. Par défaut, NetBackup sélectionne les lecteurs dans l'ordre indiqué ci-après :

  • NetBackup recherche un serveur de bandes NDMP local sur le système de fichiers NDMP défini pour recevoir les données de restauration.

  • NetBackup recherche un serveur de bandes NDMP, qu'il soit local ou non sur le client de restauration.

  • NetBackup recherche un serveur de médias NetBackup à utiliser comme serveur de bandes NDMP.

Si vous spécifiez -PREFER_NDMP_PATH_FOR_RESTORE 0 ou -PREFER_NDMP_PATH_FOR_RESTORE yes, NetBackup applique l'ordre suivant :

  • NetBackup recherche un serveur de bandes NDMP local sur le système de fichiers NDMP défini pour recevoir les données de restauration.

  • NetBackup recherche un serveur de médias NetBackup à utiliser comme serveur de bandes NDMP.

  • NetBackup recherche un serveur de bandes NDMP, qu'il soit local ou non sur le client de restauration.

-PREFER_SPAN_TO_SCRATCH 0|1|no|yes (valeur par défaut : 1 ou yes)

Indique comment NetBackup doit sélectionner le média supplémentaire lorsque les opérations de média de bande sont réparties sur plusieurs médias. Lorsque ce paramètre est défini sur le paramètre par défaut yes, NetBackup sélectionne de nouveaux médias dans le pool de travail au lieu de médias partiellement pleins. Lorsque ce paramètre est défini sur no, NetBackup tente de sélectionner un média partiellement plein pour terminer l'opération spécifiée. Le paramètre no permet à NetBackup d'utiliser le nombre maximal de médias partiellement pleins. Définissez le nombre maximal de médias partiellement pleins à l'aide de la commande vmpool -create ou vmpool -update.

-RETURN_UNASSIGNED_MEDIA_TO_SCRATCH_POOL 0|1|no|yes

Cette option globale d'EMM s'applique à tous les hôtes qui utilisent le serveur EMM. Il ne s'agit pas d'une option d'hôte.

YES : Media Manager renvoie automatiquement au pool de volumes de travail les médias expirés et non assignés qui étaient à l'origine dans ce pool.

NO : désactive le renvoi automatique des médias vers le pool de travail. Utilisez l'une des interfaces d'administration de Media Manager pour déplacer les médias.

-SCSI_PROTECTION NONE | SPR | SR

Permet une protection d'accès exclusive pour les lecteurs de bande. La protection d'accès empêche les autres adaptateurs de bus hôte d'exécuter des commandes pour contrôler les lecteurs lors de la réservation. Les trois paramètres possibles pour cette option sont les suivants :

AUCUN : aucune protection

SPR : réserve persistante SCSI

SR  réserve SCSI SPC-2 (condition par défaut)

-TIME_WINDOW entier_non_signé

Vous permet de définir un intervalle de temps au cours duquel des erreurs peuvent être suivies. Vous pouvez utiliser cette valeur avec un seuil d'erreur (par exemple, media_error_threshold) pour contrôler le nombre d'erreurs de médias qui se produisent dans cet intervalle de temps. Le paramètre par défaut est de 12 heures.

-UNRESTRICTED_SHARING 0|1|no|yes

Active le partage de médias sans restriction pour tous les serveurs de médias.

USE_POTENTIAL_FREESPACE_FOR_ALLOCATION 0|1|no|yes

Permet l'allocation de mémoire de l'espace libre disponible. Les déclencheurs de borne haute représentent normalement le nettoyage sur des unités de stockage et des pools de disques de BasicDisk. Quand la Borne haute est atteinte dans une politique de cycle de vie du stockage, elle peut empêcher l'utilisation de tout espace mémoire supplémentaire.

Par exemple, la Borne haute est 90 %, mais l'espace libre potentiel est de 50 %. Si l'espace libre qui reste sur le disque est uniquement disponible après la Borne haute, la sauvegarde échoue. Activez ce paramètre (1) pour permettre l'utilisation de l'espace libre de 40% entre l'espace libre potentiel et la Borne haute.

Le paramètre par défaut est non (0).

-VALIDATE_HOST_NAME 0|1|no|yes

Active la validation des caractères du nom d'hôte selon la norme NetBackup. Si cette option est désactivée, vous pouvez utiliser un nom comme "_host1", qui ne suit pas la norme.

-VAULT_CLEAR_MEDIA_DESC 0|1|no|yes

Cette option est une option globale d'EMM qui s'applique à chaque hôte qui utilise le serveur EMM. Il ne s'agit pas d'une option d'hôte. Quand le média NetBackup est renvoyé par le centre de sauvegarde hors site pendant une rotation des bandes type, il est expiré et est prêt à être réutilisé par de nouvelles sauvegardes. Pour éviter toute confusion, il peut être utile d'effacer les informations de description des anciens médias lorsqu'une bande expirée est renvoyée au robot. Si cette entrée est spécifiée, le champ de description du média est effacé lorsque d'autres informations du centre de sauvegarde sont effacées de la base de données de volume de Media Manager.

-deletealldevices

Supprime tous les périphériques de bande.

-allrecords

Supprime tous les périphériques de bande sur tous les ordinateurs. Vous ne pouvez pas utiliser cette option avec l'option -machinename.

-emmname chaîne

Nom du serveur EMM.

-emmport entier_non_signé

Numéro de port du serveur EMM

-machinename chaîne

Supprime tous les périphériques de bande qui sont connectés au serveur de médias spécifié. Vous ne pouvez pas utiliser cette option avec l'option -allrecords.

-machinetype api | cluster_applications | appliance | client | cluster | baie_disques | médias_étranger | principal | média | terminal_nbwss | ndmp | principal_distant | hôte_réplication | machine_virtuelle

Spécifie le type de nom de l'ordinateur. Vous ne pouvez pas utiliser cette option avec l'option -allrecords.

-deletehost

Supprime un enregistrement d'ordinateur EMM en utilisant le nom de l'ordinateur et le type d'ordinateur requis.

-brief

Génère une sortie moins détaillée de la commande.

-machinename chaîne

Supprime l'hôte spécifié de la base de données EMM.

-Machinetype api | app_cluster | cluster | master | media | ndmp

Identifie par son type l'ordinateur à supprimer.

-errorsdb
-brief

Génère une sortie moins détaillée de la commande.

-prune [-days nombre_jours] [-hours nombre_heures] [-minutes nombre_minutes]

Supprime les entrées de la base de données d'erreur. Les arguments facultatifs de jours, d'heures et de minutes déterminent les entrées de la base de données à supprimer. Cette option supprime toutes les entrées antérieures à la date et à l'heure spécifiées.

-getemmserver

Affiche les informations sur tous les hôtes dans un domaine particulier d'EMM. Utilisez cette commande afin d'assurer un niveau de cohérence dans un domaine nouvellement installé ou modifié.

-brief

Génère une sortie moins détaillée de la commande.

-masterserver chaîne

Spécifie le nom d'un serveur maître pour un domaine EMM. L'ordinateur actuel est utilisé si vous n'entrez pas cette option lorsque vous utilisez cette commande.

-timeout entier_non_signé

Spécifie une valeur de délai temporaire en secondes à utiliser pendant la durée de cette commande.

-help

Affiche les informations d'utilisation relatives à la commande spécifiée en entrant les éléments suivants :

nbemmcmd -help command
-listhosts

Cette option vide la structure du tableau pour chaque hôte connu.

-display_server -machinename chaîne -machinetype chaîne

Affiche uniquement l'ordinateur spécifié par son nom et son type.

-list_app_clusters -masterserver chaîne

Liste tous les clusters d'application du serveur maître spécifié.

-list_snap_vault_filers -machinename chaîne

Répertorie tous les filers SnapVault du nom d'ordinateur spécifié. Voir ci-dessous la description de l'option -machinename.

-list_snap_vault_media_servers -masterserver chaîne

Liste tous les serveurs de médias SnapVault du serveur maître spécifié.

-list_sts_hosts -machinename chaîne

Liste tous les hôtes OpenStorage connectés au nom d'ordinateur spécifié.

-list_sts_media_servers -masterserver chaîne

Liste tous les serveurs de médias OpenStorage connectés au serveur maître spécifié.

-machinename api | cluster_application | cluster | maître | média | ndmp

Définit le type d'ordinateur à lister.

-nbservers -masterserver chaîne

Affiche seulement les serveurs de médias et les serveurs maîtres. L'option -listhosts affiche par défaut tous les serveurs.

-netbackupversion niveau[.niveau_majeur[niveau_mineur]]

Spécifie la version de l'ordinateur. La variable level est comprise entre 0 et 99. Les variables major_level et minor_level sont des champs facultatifs à un chiffre. Il ne doit y avoir aucun espace entre les variables major_level et minor_level.

Par exemple, saisissez les informations suivantes pour spécifier NetBackup 7.0 :

-netbackupversion 7.0 or -netbackupversion 7
-servers_in_emm_cluster -clustername chaîne

Liste tous les serveurs dans le cluster spécifié.

-server_in_app_cluster -clustername chaîne

Liste tous les serveurs de clusters d'application du cluster spécifié.

-brief

Génère une sortie moins détaillée de la commande.

-parsable

Rend la sortie de la commande analysable.

-verbose | -v

Contrôle l'affichage des informations d'hôte. Plusieurs lignes de la sortie sont imprimées, une pour chaque paramètre d'un hôte.

-listmedia
-allrecords

Affiche tous les enregistrements de médias.

-mediaid chaîne

Spécifie l'ID du média de l'enregistrement de médias EMM.

-mediatype entier_non_signé

Interroge les volumes par type de média.

Les types de média valides pour le serveur Enterprise NetBackup sont les 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 valides pour le serveur NetBackup sont les suivants :

4mm, 8mm, dlt, hcart, qcart, 4mm_clean, 8mm_clean, dlt_clean, hcart_clean.

-poolname chaîne

Interroge les volumes par numéro de pool, un index dans le pool de volumes. Utilisez vmpool -listall pour déterminer l'index d'un nom de pool particulier.

-robotnumber entier_non_signé

Interroge les volumes par numéro de robot. Un numéro de robot correspondant un numéro d'identification logique unique assigné au robot dans lequel le volume se trouve.

-vaultcontainer chaîne

Répertorie les volumes enregistrés dans le conteneur. La variable string correspond à vault_container_id, une chaîne comprenant jusqu'à 29 caractères alphanumériques.

-listsettings
-machinename chaîne

Spécifie l'ordinateur pour lequel lister les paramètres.

-brief

Génère une sortie moins détaillée de la commande.

-emmname chaîne

Spécifie le nom d'hôte du serveur EMM pertinent. Si -emmname n'est pas indiqué, le nom par défaut se trouve dans le fichier bp.conf.

-emmport entier_non_signé

Spécifie le numéro de port du serveur EMM depuis lequel les appels sont émis. Si la commande -emmport n'est pas spécifiée, le port par défaut est spécifié dans le fichier bp.conf.

-machinealias

Les paramètres suivants servent à maintenir la liste des alias d'un ordinateur particulier. Utilisez-les pour afficher les alias en cours, en ajouter de nouveaux ou en supprimer pour un ordinateur spécifique.

-addalias -alias alias -machinename nom -machinetype type

Ajoute un alias à un ordinateur. Identifiez le nom et le type de l'ordinateur auquel appliquer l'alias.

Par exemple, pour créer un serveur de médias avec l'alias "blue", utilisez la commande suivante :

machinealias -machinename 10.10.10.1 -machinetype media 
-addalias -alias blue
-deletealias -alias nom -machinetype type

Supprime un alias de la base de données. Cette opération requiert que vous identifiez l'alias à supprimer en utilisant la commande -alias string et le type de l'ordinateur avec cette option.

-deleteallaliases -alias nom -machinetype type

Supprime tous les alias d'un ordinateur donné. Pour exécuter cette opération, identifiez le nom et le type d'ordinateur.

-getaliases

Récupère tous les alias d'un ordinateur donné. Pour exécuter cette opération, identifiez le nom et le type d'ordinateur.

-alias chaîne

Spécifie la chaîne qui identifie l'alias d'un ordinateur.

-machinename chaîne

Spécifie le nom d'un ordinateur.

-Machinetype api | app_cluster | cluster | master | media | ndmp

Définit le rôle de l'ordinateur.

-releasecache

Libère la mémoire cache utilisée par le serveur EMM.

-brief

Génère une sortie moins détaillée de la commande.

-emmname chaîne

Spécifie le nom d'hôte du serveur EMM pertinent. Si -emmname n'est pas indiqué, le nom par défaut se trouve dans le fichier bp.conf.

-emmport entier_non_signé

Spécifie le numéro de port du serveur EMM depuis lequel les appels sont émis. Si la commande -emmport n'est pas spécifiée, le port par défaut est spécifié dans le fichier bp.conf.

-renamehost

Cette commande, avec le nom requis de l'ordinateur et les nouvelles options de nom d'ordinateur, renomme le nom actuel de l'ordinateur.

-machinename chaîne

Définit le nom actuel de l'ordinateur.

-newmachinename chaîne

Définit le nouveau nom de l'ordinateur.

-resethost

Utilisez cette commande pour réinitialiser les Propriétés de l'hôte pour un hôte mis à jour. La section Propriétés de l'hôte affiche les informations supplémentaires que collecte le service web hôte.

Exécutez cette commande si vous avez rétrogradé la version de NetBackup sur un ordinateur ou que vous avez supprimé un hôte de votre environnement NetBackup. Vous ne devez exécuter cette commande que si rétrogradez vers NetBackup 8.0 ou une version antérieure. Vous aurez peut-être à redémarrer la Console d'administration de NetBackup pour que les modifications entrent en vigueur.

Avant d'exécuter la commande nbemmcmd - resethost, vous devez exécuter la commande bpnbat -login -loginType WEB. Cette commande authentifie votre connexion aux services web. Après avoir exécuté la commande bpnbat, exécutez la commande nbemmcmd - resethost.

-machinename chaîne

Définit le nom de l'ordinateur qui a été rétrogradé ou supprimé de l'environnement de NetBackup.

-servercontrol

Cette commande interrompt et reprend le contrôle d'un serveur spécifié. Cette option vous permet de réaliser la maintenance de votre base de données sans risque de corruption des données existantes en évitant qu'un travail ne s'exécute pendant cette période.

-resume

Reprend le contrôle d'un serveur spécifié.

-suspend

Interrompt le contrôle d'un serveur spécifié.

-setemmserver

Cette commande modifie le nom du serveur EMM pour les hôtes du domaine dont le nom est identique à l'ancien nom du serveur EMM. Cette commande présente les options suivantes :

-emmservername chaîne

Spécifie le nom du serveur EMM à modifier.

-newemmservername chaîne

Spécifie la nouvelle valeur ou la valeur de remplacement pour le serveur EMM.

-masterserver chaîne

Spécifie le nom d'un serveur maître pour un domaine EMM. L'ordinateur actuel est utilisé si vous n'entrez pas cette option lorsque vous utilisez cette commande.

-timeout entier_non_signé

Spécifie une valeur de délai temporaire en secondes à utiliser pendant la durée de cette commande.

-updatehost -machinename string

Cette commande, lorsqu'elle est utilisée avec les options suivantes, vous permet de modifier un enregistrement d'ordinateur qui a été spécifié à l'aide de l'option -machinename requise.

-add_server_to_app_cluster

Cette option indique que l'ordinateur doit être ajouté au cluster d'application qui est spécifié dans l'option -clustername.

-activenodename chaîne

Identifie le nœud actif dans un cluster.

-clustername chaîne

Identifie un cluster auquel appartient cet ordinateur.

-delete_server_from_app_cluster

Indique que l'ordinateur doit être supprimé du cluster d'application qui est spécifié dans l'option -clustername.

-displayname chaîne

Affiche le nom assigné d'un ordinateur qui correspond à l'identifiant numéroté de cet ordinateur.

-machinename chaîne

Spécifie le nom d'ordinateur à mettre à jour.

-machinestateop clr_admin_pause | clr_admin_pause_and_set_active | clr_disk_active | clr_ltid_restart | clr_master_server_connectivity | clr_tape_active | reset_all | set_admin_pause | set_disk_active | set_master_server_connectivity | set_tape_active

Définit ou efface l'état spécifié de l'ordinateur.

-Machinetype api | app_cluster |cluster | master | media | ndmp

Définit le rôle de l'ordinateur.

-masterserver chaîne

Définit le serveur maître de l'hôte dans le domaine.

-netbackupversion niveau[.niveau_majeur[niveau_mineur]]

Ajoute un hôte et spécifie la version qu'il exécute. La variable level est comprise entre 0 et 99. Les variables major_level et minor_level sont des champs facultatifs à un chiffre. Il ne devrait y avoir aucune espace entre les variables major_level et minor_level.

Par exemple, saisissez les informations suivantes pour spécifier NetBackup 7.0 : -netbackupversion 7.0

-operatingsystem hpux | linux | rs6000 | solaris | windows

Cette option vous permet de mettre à jour le système d'exploitation de l'ordinateur.

EXEMPLES

Exemple 1 - Affichez les informations sur tous les hôtes dans un domaine EMM donné.

# nbemmcmd -getemmserver
These hosts were found in this domain: throttle, upwords
Checking with host: throttle...
Checking with host: upwords...
Server Type   Host Version              Host Name         EMM Server
MEDIA         UNKNOWN RELEASE (0)       throttle          throttle
MASTER        7.6                       upwords           upwords

One or more hosts had mismatched EMM Servers.
Run-time failure: The consistency check either failed or was 
incomplete. Command did not complete successfully.

Exemple 2 - Renommer le serveur EMM pour certains hôtes du domaine dont le nom correspond à l'ancien nom du serveur EMM.

# nbemmcmd -setemmserver -emmservername throttle -newemm upwords
These hosts were found in this domain: throttle, upwords
Checking with host: throttle...
Checking with host: upwords...
Server Type    Host Version             Host Name         EMM Server
MEDIA          UNKNOWN RELEASE (0)      throttle          throttle
EMM server name was changed.
MASTER         7.6                      upwords           upwords
One media hosts had EMM Server name changed. Command was completed 
successfully.