PERFORM LIBACTION (Définition ou suppression de toutes les unités et chemins pour une bibliothèque)

Editer en ligne

Cette commande permet de définir ou supprimer en une fois toutes les unités et leurs chemins pour une seule bibliothèque.

Cette commande peut être utilisée lorsque vous configurez un environnement de bibliothèque ou modifiez une configuration matérielle existante qui nécessite le changement de nombreuses définitions d'unité. Après avoir défini une bibliothèque, exécutez la commande PERFORM LIBACTION pour définir les unités et leurs chemins d'accès à la bibliothèque. Vous pouvez également supprimer toutes les unités et tous les chemins en exécutant la commande avec ACTION=DELETE.

Dans un environnement de bibliothèque partagée, cette commande ne peut être émise que dans les cas suivants :

Lorsque le gestionnaire de bibliothèque et le client de bibliothèque (ou un système hôte d'agent de stockage) détectent les mêmes unités de bande.
Lorsque le gestionnaire de bibliothèque détecte toutes les unités de bande que le client de bibliothèque ou l'agent de stockage a, même si ce client ou agent a plus d'unités de bande que le gestionnaire de bibliothèque.

Cette commande est valable uniquement pour les bibliothèques de type SCSI et VTL. Pour utiliser cette commande avec ACTION=DEFINE, l'option SANDISCOVERY doit être prise en charge et activée.

Pour obtenir des informations détaillées et actuelles sur la prise en charge des bibliothèques, voir le site Web relatif aux unités prises en charge pour votre système d'exploitation :

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

A (DEFine)

B (RESet)

Paramètres

nom_bibliothèque (obligatoire)

Indique le nom de la bibliothèque à définir ou supprimer. Ce nom peut comporter jusqu'à 30 caractères, sauf si vous exécutez PERFORM LIBACTION avec ACTION=DEFINE et en utilisant la valeur PREFIX par défaut. Dans ce cas, le nom ne doit pas comporter plus de 25 caractères.

Restrictions :

Dans un environnement de bibliothèque partagée, la commande PERFORM LIBACTION ne peut être émise que dans les cas suivants, sous peine d'échec :

Vous pouvez émettre la commande PERFORM LIBACTION lorsque le gestionnaire de bibliothèque et le client de bibliothèque (ou un système hôte d'agent de stockage) sont tous deux configurés pour détecter le même nombre d'unités de bande.
Si le client de bibliothèque ou l'agent de stockage détecte moins d'unités de bande que le gestionnaire de bibliothèque, la commande PERFORM LIBACTION ne définit que les chemins menant aux unités détectées par le gestionnaire de bibliothèque. Il peut en résulter des échecs de montage, car le client de bibliothèque ou le agent de stockage n'a pas accès à toutes les unités de bande définies.
Vous pouvez émettre la commande PERFORM LIBACTION lorsque le gestionnaire de bibliothèque peut détecter toutes les unités de bande que le client de bibliothèque ou l'agent de stockage a, même si ce client ou agent a plus d'unités de bande que le gestionnaire de bibliothèque.
Si le gestionnaire de bibliothèque ne peut pas détecter toutes les unités de bande que le client de bibliothèque ou l'agent de stockage détecte, la commande PERFORM LIBACTION ne peut pas définir de chemin pour ces unités de bande non détectées.

ACTion

Indique l'action pour la commande PERFORM LIBACTION. Les valeurs admises sont les suivantes :

DEFine

Indique que les unités et leurs chemins sont définis pour la bibliothèque spécifiée. La reconnaissance de réseau de stockage SAN doit être activée avant que vous n'indiquiez cette valeur de paramètre.

DELete

Indique que les unités et leurs chemins sont supprimés pour la bibliothèque spécifiée.

RESet

Indique que les unités et leurs chemins sont définis pour la bibliothèque spécifiée.

DRIVEsonly

Indique que seules les unités sont mises à jour en ligne pour la bibliothèque spécifiée.

Les valeurs admises sont les suivantes :

No: Indique que les unités et les chemins sont mis à jour en ligne.
Yes: Indique que seules les unités sont mises à jour en ligne.

QUIesce

Indique que les unités sont mises à jour hors ligne.

DEVIce

Indique le nom de l'unité de bibliothèque qui est utilisée lorsque vous définissez des chemins lorsqu'un chemin vers la bibliothèque n'est pas encore défini. Lorsqu'un chemin est déjà défini, le paramètre DEVICE est ignoré. Cette valeur ne doit pas comporter plus de 64 caractères. Ce paramètre est facultatif.

PREFix

Indique le préfixe utilisé pour toutes les définitions d'unité. Par exemple, une valeur PREFIX DR crée les unités DR0, DR1, DR2, pour autant d'unités créées. Lorsqu'une valeur n'est pas spécifiée pour le paramètre PREFIX, le nom de bibliothèque est utilisé comme préfixe pour les définitions d'unité. Cette valeur ne doit pas comporter plus de 25 caractères.

SOURCe

Indique le nom du serveur source à utiliser lorsque vous définissez ou supprimez des définitions de chemin d'accès d'unité sur un client de bibliothèque ou un client hors réseau local. Utilisez ce paramètre uniquement si les unités de la bibliothèque sont configurées pour le serveur local. Si aucune valeur n'est spécifiée pour le paramètre SOURCE, le nom du serveur local, qui représente la valeur par défaut, est utilisé. Ce nom de source ne doit pas comporter plus de 64 caractères.

Si vous définissez le paramètre SOURCE, vous ne pouvez réinitialiser que les chemins depuis les valeurs SOURCE spécifiées. Le paramètre SOURCE n'est pas compatible avec les options RESET DRIVESONLY=YES ni QUIESCE.

Lorsqu'un nom de source autre que le nom du serveur local est indiqué avec ACTION=DEFINE, les définitions de chemin d'unité sont définies avec la valeur de jeton UNDISCOVERED. Les définitions de chemin sont ensuite mises à jour dynamiquement par les clients de bibliothèque prenant en charge la reconnaissance de réseau de stockage SAN lors du premier montage de l'unité.

PREView

Indique la sortie de toutes les commandes traitées pour PERFORM LIBACTION avant l'exécution de la commande. Le paramètre PREVIEW n'est pas compatible avec le paramètre DEVICE. Si vous exécutez la commande PERFORM LIBACTION pour définir une bibliothèque, vous ne pouvez pas spécifier à la fois le paramètre PREVIEW et le paramètre DEVICE.

Les valeurs admises sont les suivantes :

No: Indique qu'une prévisualisation des commandes exécutées pour PERFORM LIBACTION ne s'affiche pas.
Yes: Indique qu'une prévisualisation des commandes exécutées pour PERFORM LIBACTION s'affiche.

Exemple : Définition d'une bibliothèque partagée

Supposez que vous travaillez dans un réseau de stockage SAN et que vous avez configuré un gestionnaire de bibliothèque nommé LIBMGR1. Vous définissez maintenant une bibliothèque SHAREDTSM dans un serveur client de bibliothèque nommé LIBCL1.

Exécutez DEFINE LIBRARY à partir du serveur du client de bibliothèque, LIBCL1:

define library sharedtsm libtype=shared primarylibmanager=libmgr1

Lancez ensuite PERFORM LIBACTION à partir du gestionnaire de bibliothèque, LIBMGR1, pour définir les chemins d'unités du client de bibliothèque :

perform libaction sharedtsm action=define source=libcl1

Remarque: l'option SANDISCOVERY doit être prise en charge et activée sur le serveur du client de bibliothèque.

Exemple : Définition d'une bibliothèque avec quatre unités

Définition d'une bibliothèque SCSI nommée KONA :

define library kona libtype=scsi

Exécutez ensuite la commande PERFORM LIBACTION pour définir les unités et les chemins d'accès à la bibliothèque:

perform libaction kona action=define device=/dev/lb3 
prefix=dr

Le serveur exécute alors les commandes suivantes :

define path server1 kona srct=server destt=library 
device=/dev/lb3
define drive kona dr0
define path server1 dr0 srct=server destt=drive library=kona 
device=/dev/mt1
define drive kona dr1
define path server1 dr1 srct=server destt=drive library=kona 
device=/dev/mt2
define drive kona dr2
define path server1 dr2 srct=server destt=drive library=kona 
device=/dev/mt3
define drive kona dr3
define path server1 dr3 srct=server destt=drive library=kona 
device=/dev/mt4

perform libaction kona action=define device=/dev/tsmscsi/lb3 
prefix=dr

Le serveur exécute alors les commandes suivantes :

define path server1 kona srct=server destt=library 
device=/dev/tsmscsi/lb3
define drive kona dr0
define path server1 dr0 srct=server destt=drive library=kona 
device=/dev/tsmscsi/mt1
define drive kona dr1
define path server1 dr1 srct=server destt=drive library=kona 
device=/dev/tsmscsi/mt2
define drive kona dr2
define path server1 dr2 srct=server destt=drive library=kona 
device=/dev/tsmscsi/mt3
define drive kona dr3
define path server1 dr3 srct=server destt=drive library=kona 
device=/dev/tsmscsi/mt4

perform libaction kona action=define device=lb0.0.0.2 
prefix=dr

Le serveur exécute alors les commandes suivantes :

define path server1 kona srct=server destt=library 
device=lb0.0.0.2
define drive kona dr0
define path server1 dr0 srct=server destt=drive library=kona 
device=mt0.1.0.2
define drive kona dr1
define path server1 dr1 srct=server destt=drive library=kona 
device=mt0.2.0.2
define drive kona dr2
define path server1 dr2 srct=server destt=drive library=kona 
device=mt0.3.0.2 
define drive kona dr3
define path server1 dr3 srct=server destt=drive library=kona 
device=mt0.4.0.2

Commandes associées

Tableau 1. Commandes associées à PERFORM LIBACTION
Commande	Description
BIBLIOTHEQUE D'AUDIT	Assure qu'une bibliothèque automatisée est dans un état cohérent.
DEFINIR LA CONDUITE	Affectation d'une unité à une bibliothèque.
DÉFINIR LA BIBLIOTHÈQUE	Définition d'une bibliothèque automatisée ou manuelle.
DÉFINIR LE CHEMIN	Définit un chemin d'accès d'une source vers une destination.
DEFINIR LE SERVEUR	Définition d'un serveur pour les communications de serveur à serveur.
SUPPRESSION D'UNE UNITÉ	Suppression d'une unité dans une bibliothèque.
SUPPRESSION DE BIBLIOTHEQUE	Suppression d'une bibliothèque.
SUPPRIMER CHEMIN	Supprime un chemin d'une source vers une destination.
COMMANDE QUERY DRIVE	Affichage d'informations concernant les unités.
BIBLIOTHEQUE DE REQUETE	Affichage d'informations sur une ou plusieurs bibliothèques.
CHEMIN DE REQUETE	Affiche des informations sur le chemin d'accès d'une source vers une destination.
MISE A JOUR DE DRIVE	Modifie les attributs d'une unité.
MISE A JOUR DE BIBLIOTHEQUE	Modifie les attributs d'une bibliothèque.
MISE A JOUR DE CHEMIN	Modifie les attributs associés à un chemin.