Dépannage des problèmes de configuration de la bibliothèque de bandes dans NetWorker

Summary: Cet article a pour but d’aider les supporters et les clients à déterminer les causes de l’incapacité d’un robot détecté à se configurer correctement.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Symptoms

Si la configuration de la bibliothèque fonctionnait auparavant sans problème et rencontre soudainement un problème, envisagez les modifications possibles qui peuvent entraver la détection et la configuration :

  • Mise à niveau du firmware ou du pilote du robot ou des lecteurs de bandes
  • Ajout, remplacement ou retrait de matériel de bande ou d’autres composants de bibliothèque
  • Modification de la version du logiciel NetWorker ou des correctifs du système d’exploitation
  • Toute modification apportée au transport de stockage entre l’hôte et le robot

Si la bibliothèque n’a jamais fonctionné, vérifiez que le matériel est pris en charge dans le Guide de compatibilité matérielle NetWorker. N’oubliez pas qu’il est possible qu’une bibliothèque soit partiellement fonctionnelle ; La découverte seule ne garantit pas la facilité d’utilisation ou la prise en charge.

  • Échecs de détection et de configuration du juke-box à l’aide de NetWorker Management Console
  • Échecs de détection et de configuration du juke-box via jbconfig
  • Échecs de l’utilisation de jbedit pour modifier la configuration d’un juke-box
  • La détection et la configuration d’une bibliothèque de bandes NetWorker se composent de deux phases utilisateur :
    • Détection des périphériques, énumération des propriétés et création d’attributs « Non configurés »
    • Création et association d’objets NSR Jukebox et de lecteur de bande NSR Device
  • Les problèmes de configuration d’une bibliothèque de bandes qui ne proviennent pas de problèmes de détection ou d’accès indiquent généralement une incohérence dans les ressources détectées de la bibliothèque ou des lecteurs :
    • Numéros de série des disques (tels qu’ils ont été détectés dans les disques ou mis en cache dans le robot)
    • Périphériques en conflit déjà configurés avec les mêmes poignées de pilote
    • Problèmes internes spécifiques de réponse aux commandes SCSI
    • Incohérence des informations sur le robot et de la réalité physique
  • La configuration automatique avec jbconfig est limitée à l’hôte local sur lequel la commande est exécutée et nécessite toujours la détection du numéro de série et la correspondance des descripteurs de fichiers
  • jbconfig (option 4) est un moyen manuel de tenter de remplacer la détection automatique lorsque ces fonctionnalités ne sont pas prises en charge ou rencontrent des problèmes
  • jbedit est un outil en ligne de commande qui peut être utilisé pour modifier les configurations de bibliothèque existantes

 

Cause

Causes bien connues des problèmes de configuration de la bibliothèque :

Tenez compte des éléments ou facteurs susceptibles d’affecter la capacité de NetWorker à configurer une bibliothèque de bandes :

  • Incapacité à détecter et à accéder correctement aux ressources du robot ou de la bande
  • Pilotes de robots, firmwares ou problèmes conduisant à des informations robotiques internes incohérentes
  • Les fonctionnalités du robot telles que le partitionnement, qui peuvent perturber la disponibilité ou l’identification des ressources
  • Dynamic World Wide Naming, qui masque délibérément les WWN et SN des disques
  • Ressources de la base de données de configuration NetWorker préexistantes et conflictuelles
  • Défauts de code après la modification des versions logicielles

 

Resolution

Pour résoudre les problèmes de configuration de bibliothèque, après avoir pris en compte les dernières modifications connues (le cas échéant), procédez au dépannage en déléguant le processus à ses constituants primitifs et en les testant individuellement.

Toutes les données requises sont actuellement collectées par NSRGet lorsqu’il est exécuté avec le commutateur -o :d. NetWorker : Comment utiliser l’outil de collecte de données NSRGet de NetWorker (en anglais)

AVERTISSEMENT : Certaines de ces commandes peuvent entraîner des réinitialisations SCSI pouvant entraîner le rembobinage des unités de bande. Ne les utilisez pas si des bandes actives sont accessibles à l’hôte.

Library Configuration : Préparation

  • Naming Persistence : Afin de s’assurer que la configuration de la bibliothèque reste valide, les hôtes accédant aux lecteurs doivent s’assurer que les noms des périphériques sont liés de manière permanente et immuables, ce qui empêche la possibilité de futurs problèmes d’ordonnancement des lecteurs (voir Résolution des problèmes d’ordonnancement des lecteurs de bibliothèque de bandes dans NetWorker)
  • Nettoyage des ressources de l’appareil : Dans la section Périphériques , assurez-vous que tous les lecteurs de bandes autonomes qui seront configurés en tant que lecteurs de bibliothèque ont été supprimés
  • Rechercher des périphériques : Dans la section Périphériques , cliquez avec le bouton droit de la souris sur le conteneur Nœuds de stockage , sélectionnez Rechercher des périphériques, puis sélectionnez Tous les nœuds à analyser.
Remarque : Si la requête ne parvient pas à détecter complètement les périphériques ou si des erreurs ont été détectées sur des adresses spécifiques, il peut être utile d’utiliser le champ Exclure pour les éviter.

Library Configuration : divers

  • Propriétés du disque : NetWorker a besoin de plusieurs éléments d’information provenant d’un périphérique afin de créer ses associations dans l’objet de configuration NSR Jukebox : Le numéro de série et l’identificateur de périphérique. Ceux-ci peuvent être acquis manuellement à l’aide des commandes suivantes :
    cdi_inq -f <tape drive driver handle> -v
    inquire -lc
    Si les numéros de série entre les commandes inquire et cdi_inq ne correspondent pas, cela est généralement une preuve de nom universel dynamique.
  • Propriétés du robot : Étant donné que les lecteurs et les robots sont logiquement séparés dans leurs opérations, afin de coordonner les opérations de chargement des cartouches de bande avec les opérations de lecture/écriture de périphérique, le robot doit associer le numéro de série d’un lecteur à l’adresse de l’élément correspondant du robot. Pour acquérir ces associations :
    sjisn <i.t.l or changer driver handle>
  • Nœud de stockage NSR : Si vous configurez la bibliothèque dans NetWorker dans l’interface utilisateur de la console de gestion, le processus de détection des périphériques ajoute les lecteurs ou robots découverts aux ressources du nœud de stockage en tant que périphériques « non configurés » (icône orange représentant une clé à molette dans l’interface utilisateur). Elles ne peuvent pas être supprimées, car il ne s’agit pas de ressources distinctes, et elles seront remplacées par des ressources utilisables après le processus de configuration.
    nsrdb (le dossier peut être compressé pendant l’exécution de NetWorker)
    dvdetect -dlv -D9
    (lors du dépannage des problèmes de détection de l’interface utilisateur)
  • NSR Jukebox : Une fois que la bibliothèque 'Unconfigured' est sélectionnée et que 'Configure' est exécuté dans l’interface utilisateur, le NSR Jukebox est construit en utilisant les associations ci-dessus : element :serial number :device handle, et les autres données de la bibliothèque collectées à partir du robot telles que le slot, la cartouche et le déplacement du port d’E/S.
    nsrdb: Le dossier peut être compressé pendant l’exécution de NetWorker
    nsrjb: Fournit une version plus simple et lisible par l’utilisateur de la configuration de la bibliothèque
    jbconfig: Peut être utilisé pour configurer manuellement un juke-box
    jbedit: Fournit une version plus simple et lisible par l’utilisateur de la configuration de la bibliothèque

Library Configuration : Inhibiteurs
Voici plusieurs tests de base à essayer une fois que la détection et l’accès ont été confirmés précédemment :

  • Vérification ou suppression d’un nœud de stockage NSR : Il existe plusieurs propriétés dans la ressource qui peuvent empêcher la détection et la configuration correctes d’un juke-box, telles que :
    • L’un des champs Non configuré ou Liste de
    • Champ Skip scsi targets
    • Tous les champs de nom ou d’enregistrement

La ressource Nœud de stockage NSR peut être supprimée en toute sécurité en arrêtant NetWorker, en se connectant à la base de données des ressources sur la ligne de commande. Sauvegardez toujours d’abord la base de données de ressources, à la fois en créant une sauvegarde des données d’amorçage et en créant un fichier tar/.zip du dossier nsrdb

cd <nsr/res directory>
nsradmin -d nsrdb
del type: nsr storage node (and answer yes to the storage node in question)
Remarque : Il peut être utile de renommer l’intégralité du dossier nsrdb (NE PAS supprimer), pour tester de partir d’une page blanche.

Vérification manuelle des ressources cdi_inq/inquire/sjisn/sjirjc. Étant donné que la configuration automatique d’une bibliothèque de bandes nécessite la coordination des données provenant à la fois des lecteurs et du robot, et la validation croisée de certaines de ces valeurs, vérifiez si des anomalies apparaissent quelque part dans les sorties :

sjirjc <changer address>

Confirmez que le nombre de disques, le nombre d’éléments d’importation/exportation et le nombre de logements sont attendus.

sjisn <changer address>

Comparez les totaux de lecteurs aux totaux inquire, sjirdtag et sjirjc ; Comparez les numéros de série et les chaînes de modèle pour demander la sortie.

sjirdtag <changer address>

Comparez les totaux des disques et des logements à d’autres sorties ; Recherchez pres_val=0 pour indiquer des problèmes.

cdi_inq -f <changer driver handle> -v

Comparez le numéro de série et la chaîne de modèle pour vous renseigner et obtenir les résultats sjisn.

Si les numéros de série ne peuvent pas être détectés, ou si les chaînes série ou le nombre de disques ne correspondent pas, la configuration échoue.

  • Problèmes liés au matériel, au firmware ou au code NetWorker : S’il existe des problèmes de niveau inférieur dans l’un des rapports des périphériques, ou dans le code qui les gère, vous pouvez activer le débogage avec les variables d’environnement suivantes et exécuter à nouveau les commandes ci-dessus (ou NSRGet -o :d) pour vérifier les indices ou préparer l’escalade :
    SJI_DEBUG=9
    LUS_DEBUG=9
    CDI_DEBUG=9
    JBDEBUG=9
    SCSI_DEBUG=9

Configuration de bibliothèque : jbconfig (automatique)

  • Si la bibliothèque ne parvient pas à être détectée à l’aide des mécanismes normaux de l’interface utilisateur, essayez d’utiliser la commande jbconfig - cela peut fonctionner à un niveau semi-décentralisé, mais fournit toujours presque les mêmes résultats que l’interface utilisateur (et offre la possibilité de nommer la bibliothèque, ce qui n’est pas présent dans la configuration normale de l’interface utilisateur).
  • Sélectionnez l’option 2 dans la boîte de dialogue jbconfig pour tester l’autodétection et la configuration ; vous êtes invité à indiquer les appareils de gestion des périphériques partagés ou les périphériques NDMP : les hôtes distants et NDMP ne sont pas gérés automatiquement, et vous devez utiliser les sorties sjisn et inquire pour fournir les paires hôte/handle, par élément.

Configuration de la bibliothèque : jbconfig (manuel)

  • Si jbconfig échoue avec l’option 2 - vous pouvez réessayer avec l’option 4, et si le type de bibliothèque n’apparaît pas dans la liste, utilisez simplement #54 (jukebox SCSI standard). Cette option nécessite que tous les paramètres soient saisis manuellement :
    • Adresse SCSI de la bibliothèque ou descripteur du fichier de pilote, tel que renvoyé par demande sur l’hôte de commande du robot
    • Identificateur de pilote pour chaque paire d’éléments hôte :disque, conformément à la sortie sjisn robot-local, par rapport à la sortie de demande collectée à partir de chaque nœud de stockage partageant des disques
    • Modèle de disque(s) configuré(s) dans le juke-box
  • Si les sorties sjisn et inquire ne révèlent pas les numéros de série, le robot ou les entraînements peuvent ne pas prendre en charge les numéros de série ; Dans ce cas, la seule option restante consiste à vider la bibliothèque, à déplacer manuellement une seule cartouche de bande sur chaque lecteur à la suite et à exécuter MT -F <device handle> status jusqu’à ce que le handle local correct, par hôte, soit trouvé pour cet élément de lecteur. C’est rare et inattendu dans le matériel moderne.

Si aucune des suggestions ci-dessus ne vous aide, contactez le support de votre fournisseur de système d’exploitation ou de bibliothèque si les preuves recueillies lors du débogage suggèrent des anomalies internes ; sinon, collectez la sortie de débogage lors de la tentative de configuration et escaladez les résultats dans NetWorker Support pour rechercher la possibilité d’un défaut de code.

 

Affected Products

NetWorker, NetWorker Series
Article Properties
Article Number: 000031488
Article Type: Solution
Last Modified: 23 Oct 2025
Version:  6
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.