DEFINE LIBRARY (Définition d'une bibliothèque VTL)

Cette syntaxe permet de définir une bibliothèque équipée d'un changeur de support contrôlé par l'interface de connexion SCSI qui est représentée par une bibliothèque VTL.

Classe de privilège

Pour exécuter cette commande, vous devez disposer du privilège système ou du privilège de stockage illimité.

Syntaxe

Lire le diagramme de syntaxeIgnorer le diagramme de syntaxe graphiqueDEFine LIBRarynom_bibliothèqueLIBType=VTLSHAREd=NoSHAREd=YesNoRESETDrives=NoRESETDrives=YesNo1AUTOLabel=NoAUTOLabel=NoYesOVERWRITERELABELSCRatch=YesRELABELSCRatch=NoYesSERial=AUTODetectSERial=AUTODetectnuméro_série
Remarques :
  • 1 La valeur par défaut du paramètre RESETDRIVES est conditionnelle. Si le paramètre SHARED a pour valeur NO, la valeur du paramètre RESETDRIVES est NO. Si le paramètre SHARED a pour valeur YES, la valeur du paramètre RESETDRIVES est YES.

Paramètres

nom_bibliothèque (obligatoire)
Indique le nom de la bibliothèque à définir. Ce nom peut comporter jusqu'à 30 caractères.
LIBType=VTL (obligatoire)
Indique que la bibliothèque est équipée d'un changeur de support contrôlé par l'interface de connexion SCSI représentée par une bibliothèque VTL. Pour monter des volumes sur des unités résidant dans ce type de bibliothèque, le serveur utilise un changeur de support.

La définition du type de bibliothèque VTL suppose que votre environnement n'inclut pas de médias mixtes et que des chemins sont définis entre toutes les unités de la bibliothèque et tous les serveurs définis, y compris les agents de stockage, qui utilisent la bibliothèque. Si l'une de ces caractéristiques n'est pas vérifiée, la performance globale peut régresser aux mêmes niveaux que le type de bibliothèque SCSI ; particulièrement pendant les temps de contrainte élevée.

SHAREd
Indique si cette bibliothèque est partagée avec d'autres serveurs dans un réseau de stockage SAN. Ce paramètre est obligatoire lorsque vous définissez une bibliothèque sur un gestionnaire de bibliothèque.
YES
Indique que la bibliothèque peut être partagée par d'autres serveurs. Si vous choisissez la valeur YES, le serveur de gestionnaire de bibliothèque monte les volumes demandés par les autres serveurs et contrôle l'attribution des unités et des volumes aux autres serveurs.
NO
Indique que la bibliothèque ne peut pas être partagée par d'autres serveurs. Le paramètre SHARED=NO est nécessaire lorsque la bibliothèque est contrôlée en transmettant des commandes via un serveur de fichiers NAS.
RESETDrives
Indique si le serveur anticipe une réservation d'unité avec réserve permanente lorsque le serveur est redémarré ou qu'une nouvelle connexion avec un client de bibliothèque ou d'un agent de stockage est établie. Si, par exemple, un agent de stockage devient indisponible mais conserve le chemin d'accès à une unité, la réserve permanente permet au serveur de rompre la réservation de l'agent de stockage et d'accéder à l'unité.

Systèmes d'exploitation WindowsSystèmes d'exploitation AIXSi la réserve permanente n'est pas prise en charge, le serveur effectue une réinitialisation du chemin d'accès à l'unité cible.

Systèmes d'exploitation LinuxSi la réserve permanente n'est pas prise en charge, le serveur ne peut pas réinitialiser le chemin d'accès à l'unité cible.

Les limitations suivantes s'appliquent pour la réservation permanente :
  • Si vous utilisez le pilote de périphérique IBM Storage Protect , la réserve permanente n'est prise en charge que sur certaines unités de bande. Pour plus d'informations, voir la note technique 1470319 .
  • Si vous utilisez le pilote de périphérique IBM®, la réserve persistante doit être activée au niveau du pilote de périphérique. Pour plus d'informations sur la configuration du pilote de périphérique, voir IBM Tape Device Drivers Installation and User's Guide .
  • Si vous utilisez une bandothèque virtuelle qui émule une unité prise en charge, elle pourrait ne pas prendre en charge la réserve permanente.
Systèmes d'exploitation WindowsSystèmes d'exploitation AIX
Yes
Indique qu'une anticipation d'unité via la réserve permanente ou une réinitialisation de la est utilisée. YES est la valeur par défaut pour une bibliothèque définie avec SHARED=YES.
No
Indique qu'une anticipation d'unité via la réserve permanente ou une réinitialisation de la cible n'est pas utilisée. NO est la valeur par défaut pour une bibliothèque définie avec SHARED=NO. Le paramètre RESETDRIVES doit être défini sur YES dans un environnement en cluster lorsque SHARED=NO.
Systèmes d'exploitation Linux
Yes
Indique qu'une anticipation d'unité via la réserve permanente est utilisée. YES est la valeur par défaut pour une bibliothèque définie avec SHARED=YES.

No
Indique qu'une anticipation d'unité via la réserve permanente n'est pas utilisée. NO est la valeur par défaut pour une bibliothèque définie avec SHARED=NO.
Remarque: Un gestionnaire de bibliothèque ne peut pas interrompre une réservation d'unité si le système disposant de la réservation d'unité n'est pas configuré pour utiliser la réservation permanente.
AUTOLabel
Indique si le serveur tente d'attribuer automatiquement un libellé aux volumes de bande. Ce paramètre est facultatif. La valeur par défaut est NO.

Pour utiliser cette option, vous devez insérer les bandes en définissant CHECKLABEL=BARCODE avec la commande CHECKIN LIBVOLUME.

Restriction: Si vous définissez une bandothèque comportant des unités connectées à un périphérique de stockage en réseau (NAS), vous devez utiliser la commande LABEL LIBVOLUME pour étiqueter les volumes de cette bandothèque.
No
Indique que le serveur ne tente pas d'attribuer de label aux volumes.
Yes
Le serveur n'attribue un label qu'aux volumes n'en ayant pas.
OVERWRITE
Indique que le serveur tente d'écraser un label existant. Le serveur n'écrase des labels existants que si le label existant et le label de code à barres ne sont encore définis dans aucun pool de stockage ni dans aucune liste d'historique de volume.
RELABELSCRatch
Indique si le serveur réétiquette les volumes supprimés et revenus à zéro. Lorsque ce paramètre est défini sur YES, une opération LABEL LIBVOLUME est lancée et le label de volume existant est écrasé.

Si vous disposez de volumes virtuels et réels dans votre bibliothèque VTL, les deux types voient leurs labels réattribués une fois ce paramètre activé. Si la bibliothèque VTL contient des volumes réels, la définition de cette option pourrait affecter les performances.

Restriction: Si vous définissez une bandothèque comportant des unités connectées à un périphérique de stockage en réseau (NAS), vous devez utiliser la commande LABEL LIBVOLUME pour étiqueter les volumes de cette bandothèque.
Yes
Indique que le serveur réattribue les volumes qui ont été supprimés et qui sont redevenus utilisables. La valeur par défaut est YES.
No
Indique que le serveur ne réattribue pas les volumes qui ont été supprimés et qui sont redevenus utilisables.
SERial
Indique le numéro de série pour la bibliothèque en cours de définition. Ce paramètre est facultatif. La valeur par défaut est AUTODETECT.

Lorsque SERIAL=AUTODETECT est défini et que vous définissez le chemin d'accès à la bibliothèque, le numéro de série utilisé sera celui signalé par la bibliothèque.

Si SERIAL=numéro_série, le numéro entré est comparé à celui détecté par le serveur.

Attention: En fonction des capacités de l'unité, SERIAL=AUTODETECT peut ne pas être pris en charge. Dans ce cas, le numéro de série est signalé comme étant à blanc.

Exemple : Définition d'une bibliothèque VTL

Définissez une bibliothèque nommée VTLLIB de type VTL.
define library vtllib libtype=vtl
La bibliothèque doit disposer d'un chemin d'accès. Le nom d'unité de la bibliothèque est :
  • Systèmes d'exploitation AIX/dev/lb0
  • Systèmes d'exploitation Linux/dev/tsmscsi/lb0
  • Systèmes d'exploitation Windowslb3.0.0.0
Définissez le chemin d'accès :
Systèmes d'exploitation AIX
define path server1 vtllib srctype=server desttype=library 
   device=/dev/lb0
Systèmes d'exploitation Linux
define path server1 vtllib srctype=server desttype=library 
   device=/dev/tsmscsi/lb0
Systèmes d'exploitation Windows
define path server1 vtllib srctype=server desttype=library 
   device=lb3.0.0.0