12 Référence des utilitaires

Ce chapitre présente les utilitaires ACSLS suivants :

  • acs_renumber.sh vous permet de modifier l'identifiant d'un ACS donné dans votre complexe de bibliothèques sans avoir à reconfigurer les bibliothèques connectées.

  • La macro acsss permet de démarrer et d'arrêter ACSLS et d'assurer le contrôle et la surveillance pour la maintenance et le dépannage.

  • bdb.acsss permet de sauvegarder la base de données ACSLS et les fichiers de contrôle ACSLS.

  • Utilitaires de configuration (config) dynamique permet d'apporter, de façon dynamique, des modifications de configuration aux bibliothèques (et composants) ACSLS pendant qu'ACSLS reste en ligne et s'exécute. Ces utilitaires de configuration sont :

  • config acs permet d'ajouter, de façon dynamique, un ACS ou de reconfigurer un ACS existant et ses composants.

  • config drives - permet d'ajouter ou de supprimer des lecteurs et de modifier les types de lecteur, sur des panneaux de lecteurs existants, le tout de façon dynamique.

  • config lsm permet de reconfigurer dynamiquement un LSM existant et tous ses composants. Ces composants incluent les CAP, panneaux et lecteurs.

  • config ports permet de reconfigurer, de façon dynamique, des connexions de port à un ACS.

  • db_export.sh permet d'exporter les informations de la base de données ACSLS et les fichiers de contrôle ACSLS en préparation pour l'installation d'une mise à niveau ou la réinstallation d'ACSLS.

  • db_import.sh permet d'importer les informations de la base de données ACSLS et les fichiers de contrôle ACSLS exportés quand vous avez exécuté l'utilitaire db_export.sh.

  • del_vol permet de supprimer un volume d'un LSM hors ligne.

  • drives_media.sh affiche tous les types de lecteurs, type de médias et les compatibilités entre les lecteurs et les médias qui sont pris en charge par la version actuelle d'ACSLS.

  • ejecting.sh permet de réaliser des opérations d'éjection en masse, avec rapidité et efficacité.

  • free_cells.sh vous permet de surveiller et de gérer les cellules libres dans les bibliothèques contrôlées par ACSLS.

  • getHba.sh gère les ports HBA Fibre Channel.

  • get_license_info a été supprimé à compter des versions ACSLS 7.3.1 et 8.0.1 car ACSLS ne requiert plus la validation de la licence d'utilisation. free_cells.sh vous permet d'afficher et de gérer le nombre de cellules libres dans les bibliothèques contrôlées par ACSLS.

  • greplog permet de filtrer le journal acsss_eventen incluant ou en excluant les messages contenant des mots-clés donnés.

  • install_scsi_Linux.shcrée des liens /dev/mchanger qui peuvent être utilisés lors de la configuration des bibliothèques pour ACSLS.

  • lib_type.sh renvoie le type de LSM des LSM connectés à l'ID ACS.

  • licensekey.sh a été supprimé à compter des versions ACSLS 7.3.1 et 8.0.1 car ACSLS ne requiert plus la validation de la clé de licence.

  • moving.sh permet de déplacer plusieurs cartouches vers un ou plusieurs LSM.

  • probeFibre.sh affiche le numéro de modèle, le niveau de révision et l'adresse de LUN cible de chaque périphérique connecté derrière un HBA Fibre Channel Emulex (LP10000) ou QLogic (QLA2300).

  • rdb.acsss permet de restaurer la base de données ACSLS et les fichiers de contrôle ACSLS.

  • showDevs.sh affiche le détail de chaque périphérique mchanger configuré sur Solaris.

  • showDrives.sh présente une liste de tous les lecteurs configurés connectés à ACSLS.

  • stats_reportréunit les informations statistiques sur les volumes de la bibliothèque.

  • userAdmin.sh permet d'administrer les mots de passe des utilisateurs de l'interface graphique d'ACSLS. Vous pouvez ajouter, supprimer et répertorier les utilisateurs et modifier leurs mots de passe.

  • volrpt crée un rapport de volume.

  • watch_vols affecte automatiquement la propriété et l'association de pool aux volumes à mesure de leur insertion au moyen du CAP.

Présentation

Suivez ces directives générales pour exécuter les utilitaires ACSLS :

  • En général, les utilitaires décrits dans ce chapitre sont destinés à être exécutés par l'utilisateur acsss. Pour hériter des privilèges et des dépendances environnementales requis pour les exécuter, vous devez vous connecter en tant qu'utilisateur acsss.

    Si vous préférez utiliser su, veillez à utiliser su - acsss.

  • Il est recommandé d'utiliser bdb.acsss pour sauvegarder la base de données sur bande après :

    • La configuration du matériel de bibliothèque

    • L'importation de la base de données. Après avoir procédé à la mise à niveau vers une nouvelle version d'ACSLS, n'utilisez pas les sauvegardes de base de donnée créées avec des versions précédentes. Créez une nouvelle sauvegarde dès que vous avez procédé à la mise à niveau.

    • Toute récupération de la base de données.

  • Pour garantir la récupération d'une base de données cohérente et précise, utilisez toujours la sauvegarde de base de données la plus récente.

En cas d'échec d'un utilitaire, conservez tous les journaux des événements. Ces journaux aident le support à résoudre d'éventuels problèmes.

Scripts de démarrage/d'arrêt existants

Les scripts de démarrage et d'arrêt qui étaient utilisés dans ACSLS 7.x ne sont pas pris en charge dans ACSLS 8.x.

ACSLS 8.x fournit un nouveau mécanisme pour démarrer et arrêter l'application de gestion de la bibliothèque, qui est intégré à l'utilitaire de gestion des services (SMF) de Solaris. Il remplace rc.accsss et kill.acsss utilisés dans ACSLS. Ce mécanisme permet également de surveiller le statut de l'application.

Vous pouvez démarrer et arrêter ACSLS 8.x avec la commande acsss. La commande acsss assure les fonctions de démarrage d'arrêt et de surveillance d'ACSLS. L'utilitaire réside dans le répertoire $ACS_HOME et est accessible à tout utilisateur.

Commandes d'utilitaire

La section suivante décrit les utilitaires ACSLS.

acs_renumber.sh

Cet outil simple vous permet de modifier l'identifiant d'un ACS donné dans votre complexe de bibliothèques sans avoir à reconfigurer les bibliothèques connectées. Comme chaque LSM, CAP, lecteur et volume de la bibliothèque est identifié par rapport à un ACS, cet utilitaire met à jour les différentes tables de la base de données de sorte que chaque ressource de la bibliothèque est aligné avec les nouvel ID ACS que vous affectez.

Les nouvelles bibliothèques logiques utiliseraient le modèle actuellement actif. Par exemple, si vous renumérotez l'ACS 0 en ACS 1, alors 1001 et 1002 resteraient tels quels mais une nouvelle bibliothèque logique dans l'ACS 1 serait 2001. Si vous renumérotez ensuite l'ACS 6 en ACS 0, 7001 resterait tel quel mais une nouvelle bibliothèque logique dans l'ACS 0 serait 1003. Il n'y a plus de correspondance réelle, encore que les nouveaux ajouts sont prévisibles en fonction de l'ACS.

Remarque :

Les modifications apportées par cet utilitaire s'appliquent uniquement au serveur ACSLS et non aux applications client qui utilisent ces ressources. En conséquence, il peut être nécessaire de reconfigurer d'éventuelles bases de données client après avoir modifié l'ID de l'ACS sur le serveur.

Remarque :

ACSLS doit être désactivé avant l'exécution de ce script.

Pour modifier le numéro affecté d'un ACS, exécutez acs_renumber.sh. Dans une session interactive, vous êtes d'abord averti que les modifications apportées impactent d'éventuelles applications client avant d'être invité à confirmer que vous voulez poursuivre.

$ acs_renumber.sh 

        N O T I C E  

  Changes made by this script will 
  impact client applications that 
  use ACSLS. Specifically, drive   
  i.d. mappings and LSM id's will change.
                          
Continue...? (y or n): 

Si vous répondez y (oui), la routine sauvegarde automatiquement la base de données existante avant l'apport de toute modification. Ainsi, s'il devait être nécessaire d'annuler les modifications, vous pourriez rétablir la configuration précédente. (Vous pouvez également annuler les modifications en répétant la routine acs_renumber.sh.)

La routine affiche une liste des ACS actuellement configurés et, pour chacun, vous demande s'il faut le renuméroter. Si vous répondez par l'affirmative, elle vous demande d'indiquer la nouvelle valeur à affecter.

Current ACS list:

   ACS-0 (SL8500)

Do you wish to renumber ACS-0? (y or n):

What is the new value for ACS-0? 5 

Après avoir accepté votre entrée (dans cet exemple, votre réponse était 5), la routine vous demande de confirmer la modification en attente.

Change ACS-0 to ACS-5. 

   Correct? (y or n): 

Si vous répondez y, la routine commence par mettre à jour toutes les tables de base de données connexes et sauvegarde automatiquement la base de données afin de fournir un point de reprise pour toutes les modifications que vous avez apportées.

Updating tables:    Changing ACS-0 to ACS-5

  acstable: 1 records   
  captable: 4 records 
  celltable: 13424 records  
  drivetable: 128 records 
  handtable: 16 records 
  lmutable: 0 records 
  lsmtable: 8 records 
  paneltable: 280 records 
  porttable: 1 records 
  ptptable: 16 records 
  scr_distr_table: 0 records 
  volumetable: 0 records

Complete! 
Current ACS list:

   ACS-5 (SL8500)

Now backing up the database changes... 

La macro acsss

La macro acsss est la commande de démarrage, d'arrêt et de statut principale qui permet de lancer et d'interrompre les divers services associés à ACSLS. Selon l'installation, une application ACSLS est un ensemble composé d'un maximum de sept services sur un système Solaris ou Linux.

  • acsdb - gère la base de données de la bibliothèque ACSLS.

  • acsls - logiciel de contrôle de bibliothèque qui exécute les opérations de la bibliothèque.

  • weblogic - serveur Web pour l'interface graphique ACSLS.

  • surrogate - lien de communication entre les services Java et ACSLS.

  • rmi-registry - service de consultation pour les objets Java nommés et les méthodes.

  • smce - émulation de changeur de média SCSI des bibliothèques logiques.

  • stmf - structure en mode cible pour les bibliothèques logiques ACSLS.

Les services acsls et acsdb sont communs à toutes les installations. Les services weblogic, surrogate et rmi-registry sont présents si la prise en charge de l'interface graphique (GUI) ACSLS a été configurée. Les services smce et stmf s'appliquent uniquement si des bibliothèques logiques ont été configurées (sur Solaris).

Tous les services sont exécutés par l'utilisateur ACSLS à l'aide d'une seule macro, acsss, qui démarre et arrête ces services dans un ordre défini requis par les dépendances entre les différents composants. La macro émet des commandes à l'utilitaire de gestion des services (SMF) sur Solaris et à l'utilitaire de service init.d sur Linux.

Format

acsss <command>

La saisie de la macro acsss sans commande affiche une liste d'options.

Options

Commande Fonction
enable Il s'agit de la méthode par défaut pour lancer tous les services associés à ACSLS. Une fois activés, les différents services demeurent activés et seront automatiquement réactivés après un redémarrage système.
temp-enable Commande similaire à acsss enable, mais les services ne sont pas redémarrés après un redémarrage système.
maint-enable Commande destinée aux opérations de maintenance qui n'impliquent pas la base de données ACSLS. Cette option active l'infrastructure GUI, ce qui permet aux utilisateurs GUI de rester connectés alors que le logiciel ACSLS est désactivé. Cette méthode est utile dans les cas d'installation de patches logiciels mineurs. Ni le service acsls ni le service smce ne sont activés.
db C'est le mode de contrôle à privilégier pour les opérations de maintenance de la base de données, y compris db_export, db_import et acsss_config. Il active le moteur de base de données ACSLS et désactive tous les autres services d'ACSLS, y compris son interface GUI.
disable Il s'agit de la méthode par défaut pour mettre fin au fonctionnement d'ACSLS. Cette commande n'entraîne pas un arrêt complet et permet aux sessions de connexion à l'interface GUI de rester actives pour la tenue d'opérations de maintenance une fois les services acsls et smce désactivés. L'état résultant est identique à celui de la commande acsss maint-enable. Cette méthode est la plus sûre pour arrêter le serveur car ACSLS et la bibliothèque sont placés dans un état de veille avant que les services ne soient désactivés.
force-disable Commande similaire à acsss disable, mais l'opération n'attend pas un état de veille avant de désactiver les services acsls et smce.
shutdown Commande entraînant un arrêt complet de tous les services ACSLS. Elle est destinée aux cas d'installation et de désinstallation de logiciel, ainsi qu'à d'autres cas de maintenance qui nécessitent l'arrêt de la base de données (acsdb) ou de l'infrastructure GUI (rmi-registry et surrogate).
status Fournit un rapport d'état succinct des différents services d'ACSLS.
a-status Renvoie l'état opérationnel du service acsdb.
d-status Renvoie l'état opérationnel du service acsls.
g-status Affiche le statut de l'interface graphique d'ACSLS.
l-status Fournit un résumé d'état détaillé des différents services d'ACSLS et inclut des pointeurs vers des données de journal, afin de permettre une analyse approfondie dans le cadre d'un dépannage. Les journaux référencés sont utiles dans les cas où le service ne parvient pas à démarrer ou s'arrêter.
p-status Similaire à acsss status, cette commande de rapport inclut une liste des ID processus surveillés par chaque contrat de service.
w-status Affiche l'état du service WebLogic.
timeout Indique le délai d'expiration du démarrage de SMF pour le service acsls sur Solaris.
legal Affiche les mentions légales relatives à ACSLS en anglais ou en français.

Dans la plupart des cas, vous n'utilisez que les trois commandes principales : enable, disable et status. Les commandes restantes sont pratiques dans le cas de la maintenance du logiciel.

bdb.acsss

L'utilitaire bdb.acsss sauvegarde le contenu de la base de données ACSLS et les fichiers de contrôle ACSLS nécessaires pour recréer l'environnement ACSLS. La sauvegarde est stockée dans un fichier tar, sur un périphérique de bande que vous avez nommé ou dans le répertoire de sauvegarde défini par défaut.

Cet utilitaire effectue les sauvegardes de la base de données ACSLS sans nécessiter l'arrêt d'ACSLS (sauvegarde à chaud).

Sans l'option -f, un fichier /export/backup/<time_stamp>.tar est créé. time_stamp est l'heure à laquelle la commande bdb.acsss a été exécutée. Pour vérifier le contenu de la bande après l'exécution de l'utilitaire bdb.acsss, modifiez les exemples suivants pour les adapter à vos périphériques de bande.

Pour Solaris :

tar tvbf 2048 /dev/rmt/0mn

Après l'exécution de la commande tar tvbf, la bande avance vers le bloc suivant. Veillez à rembobiner ou repositionner la bande si vous voulez lancer l'utilitaire rdb.acsss après l'exécution de la commande tar tvbf.

Format

bdb.acsss [-f backup_file | tape_device]

Si vous saisissez la commande bdb.acsss sans option, une sauvegarde par défaut est exécutée et vous permet de rétablir la base de données au point où cette sauvegarde a été effectuée.

Options

  • -f backup_file

    spécifie un fichier UNIX destiné à contenir la sauvegarde de la base de données ACSLS. Vous devez disposer des autorisations en écriture sur le fichier et le répertoire.

  • -f tape_device

    spécifie tout périphérique de bande connecté et configuré pour le serveur ACSLS.

Utilisation

Utilisez l'utilitaire bdb.acsss pour sauvegarder la base de données ACSLS sur bande ou sur un fichier de réseau externe pour créer des sauvegardes qui pourront être utilisées, le cas échéant, pour rétablir la base de données.

Il est recommandé d'utiliser bdb.acsss pour sauvegarder manuellement la base de données sur bande après :

  • L'exécution de l'utilitaire acsss_config.

  • L'importation de la base de données. Après avoir procédé à la mise à niveau vers une nouvelle version d'ACSLS, n'utilisez pas les sauvegardes de base de donnée créées avec des versions précédentes.

  • Un audit l'ensemble de la bibliothèque.

  • Toute récupération de la base de données.

Exemple 1 :

$ bdb.acsss -f /export/backup/my_backup

Dans cet exemple, un fichier nommé my_backup a été créé dans le répertoire
/export/backup. Vous pouvez maintenant choisir de conserver le fichier, dans son emplacement, ou de le déplacer vers un autre système de fichiers, un autre serveur ou un périphérique CD inscriptible.

Ce fichier peut ensuite être utilisé pour rétablir la base de données à l'état qu'elle avait quand la sauvegarde a été effectuée. Par exemple, si la sauvegarde a été effectuée à 13h le vendredi et qu'une restauration est effectuée à 6h le lundi, la base de données reprendra l'état qu'elle avait à 13h le vendredi.

Dans cette même option -f, vous pouvez indiquer un périphérique de bande au lieu d'un nom de fichier pour que la sauvegarde soit effectuée sur le périphérique de bande désigné.

Exemple 2 :

$bdb.acsss -f /dev/rmt/0mn

Dans cet exemple, une archive de bande sur le périphérique de bande /dev/rmt/0mn a été créée. Elle peut être stockée pour une utilisation ultérieure dans un emplacement hors site.

Voir aussi :

Utilitaires de configuration (config) dynamique

L'utilitaire de configuration dynamique (config) vous permet d'implémenter les modifications de configuration apportées aux bibliothèques (et aux composants) ACSLS pendant qu'ACSLS reste en ligne et en cours d'exécution. Ces modifications de configuration sont enregistrées dans le fichier acsss_config.log.

Les utilitaires de configuration dynamique suivants sont pris en charge :

  • config acs

  • config drives

  • config lsm

  • config ports

L'utilitaire config fournit les avantages suivants :

  • ACSLS peut continuer à s'exécuter et vous permet d'effectuer des demandes de montage pour des composants de bibliothèque non affectés.

  • Vous pouvez reconfigurer les composants de bibliothèque spécifiés sans modifier les autres informations de configuration. Par exemple, lorsque vous spécifiez :

    • un ACS, les configurations des autres ACS ne sont pas affectées.

    • un LSM, les configurations des autres LSM ne sont pas affectées.

    • un panneau de lecteur, les lecteurs sur un panneau, les montages et les démontages pour tous les lecteurs existants ne sont pas affectés.

Il est important de tenir compte des points suivants :

  • ACSLS doit être en cours d'exécution pour utiliser l'utilitaire de configuration dynamique.

  • Vous devez utiliser acsss_config pour créer votre configuration ACSLS initiale. Voir Définition des variables contrôlant le comportement d'ACSLS.

  • La notification des événements consigne toutes les modifications de configuration dynamique.

  • Avant d'exécuter une configuration dynamique, assurez-vous que tous les composants à ajouter ou reconfigurer sont prêts.

  • Le fichier acsss_config.log fournit des détails relatifs aux messages affichés.

  • Si vous n'avez pas confirmé la modification de configuration, vous pouvez annuler l'opération avec [[CTRL]]+C.

  • La configuration dynamique effectue une sauvegarde automatique avant et après la modification de configuration.

  • Une fois la modification de configuration confirmée, elle ne peut pas être annulée. Si vous voulez annuler une modification de configuration, arrêtez ACSLS et restaurez la sauvegarde effectuée immédiatement avant l'apport de la modification de configuration.

    Vous disposez de 10 minutes pour confirmer une modification de configuration avant qu'elle n'expire.

  • Vous ne pouvez pas retirer le seul (ou dernier) ACS restant.

  • Ne retirez pas le dernier CAP dans un ACS ou le dernier lecteur défini pour ACSLS.

Limites de la configuration dynamique

L'utilitaire de configuration dynamique comporte deux limites importantes :

  • Vous ne pouvez pas supprimer un ACS, ni supprimer ou modifier un port (connexion) pour une bibliothèque.

  • Avec une bibliothèque connectée via SCSI/Fibre Channel, vous pouvez uniquement mettre à jour les configurations de lecteur dans les utilitaires config acs et config lsm . Les configurations de CAP ou de panneau ne sont pas mises à jour. Les utilitaires config drives et config acs new fonctionnent avec des bibliothèques connectées via SCSI/Fibre Channel sans aucune limite. L'utilitaire config ports n'est pas pris en charge sur une bibliothèque connectée via SCSI/Fibre Channel.

Solution :

Pour ces modifications de configuration non prises en charge au moyen de la configuration dynamique, vous devez arrêter ACSLS et utiliser acsss_config.

Ce que vous ne devez pas faire

  • N'utilisez pas la configuration dynamique pour afficher les informations de statut pour une bibliothèque et ses composants car cela implique des E/S massives pour la bibliothèque.

    Utilisez plutôt les commandes query ou display.

  • Essayez de ne pas lancer plusieurs tâches de configuration à la fois.

    Une seule tâche de configuration peut être effectuée à la fois. Ceci :

    • Minimise les problèmes de performance causés par les E/S entre ACSLS et la bibliothèque qu'il configure.

    • Evite les interactions complexes entre plusieurs tâches de configuration.

config acs

Avec l'utilitaire config acs, vous pouvez :

  • Ajouter un ACS ou reconfigurer un ACS existant et ses composants.

  • Configurer ou reconfigurer des bibliothèques sans affecter tous les numéros d'ACS dans l'ordre.

    Exemple : vous voulez effectuer une migration de la bibliothèque 9310 à une bibliothèque SL8500 puis retirer la 9310. La 9310 est numérotée comme ACS 0 et la SL8500 comme ACS 1. A l'aide de config acs, vous pouvez maintenant migrer tous les lecteurs et cartouches vers la SL8500 et retirer ultérieurement la 9310 sans avoir à renuméroter votre SL8500.

    • Ajoutez la bibliothèque SL8500 avec config acs acs_id sans arrêter ACSLS.

    • Déplacez les lecteurs de la 9310 vers la SL8500 et mettez à jour les configurations de lecteur dans les deux ACS avec config acs acs_id.

    • Retirez les cartouches de la 9310 et insérez-les dans la SL8500.

    • Enfin, planifiez une coupure pour arrêter ACSLS et retirer la 9310 de la configuration à l'aide de l'utilitaire acsss_config. Ne configurez pas la 9310. N'oubliez pas d'indiquer que la SL8500 est l'ACS 1 (pas la valeur par défaut qui est zéro).

  • Configurer un ACS partitionné.

  • Ajouter ou retirer des LSM car l'utilitaire config lsm vous permet uniquement de reconfigurer un LSM existant.

Chaque ACS doit avoir au moins un CAP. Il peut s'agir d'un CAP partagé avec une autre partition. Une unité au moins doit être configurée dans tout le système ACSLS.

Par exemple, si ACSLS prend en charge quatre bibliothèques, trois d'entre elles peuvent contenir zéro (0) lecteurs. Toutefois, la quatrième bibliothèque doit contenir au moins une unité.

Format

  • Pour ajouter un nouvel ACS, entrez la commande suivante :

    config acs new

  • Pour reconfigurer un ACS existant, entrez la commande suivante :

    config acs acs_id

Ajout d'un nouvel ACS

Pour ajouter un nouvel ACS :

  1. Entrez la commande suivante :

    config acs new

  2. Indiquez le numéro d'ACS du nouvel ACS.

    ACSLS vous permet de configurer ou reconfigurer des bibliothèques sans affecter tous les numéros d'ACS dans l'ordre.

    Les numéros d'ACS déjà utilisés et les cinq premiers numéros d'ACS disponibles sont affichés.

    Entrez le numéro d'ACS pour votre nouvel ACS.

  3. Indiquez si l'ACS se trouve dans une SL8500 ou SL3000 partitionnée.

    • Si vous entrez y (oui), vous êtes invité à indiquer l'ID partition pour l'ACS. Cet ID partition doit correspondre à l'ID partition sur SL Console.

    • S'il ne s'agit pas d'une bibliothèque partitionnée ou s'il s'agit d'une bibliothèque connectée via SCSI/Fibre Channel, saisissez n (non).

    ACSLS ne prend pas en charge les bibliothèques partitionnées connectées via SCSI/Fibre Channel, telle que la SL500. Aussi, les bibliothèques partitionnées connectées via SCSI/Fibre Channel n'ont pas d'ID partition.

  4. Entrez le nombre de connexions à l'ACS, suivi par l'ID périphérique ou l'ID hôte.

    Vous pouvez avoir quinze connexions au maximum.

    Remarque :

    Assurez-vous que tous les ports sont connectés au même ACS.

    La nouvelle configuration de l'ACS est affichée.

  5. Confirmez l'ajout du nouvel ACS.

    Après la confirmation, les informations de configuration sont affichées et la base de données est mise à jour.

Reconfiguration d'un ACS existant

L'ACS doit, si possible, être en ligne ou en mode diagnostic quand vous reconfigurez l'ACS.

Pour reconfigurer l'ACS :

  1. Entrez la commande suivante :

    config acs acs_id

    L'ancienne et la nouvelle configurations sont affichées.

  2. Confirmez la nouvelle configuration.

    Après confirmation, la base de données est mise à jour.

    Si la configuration demeure inchangée, la configuration s'affiche sans vous demander confirmation et l'utilitaire se ferme. En voici quelques exemples :

    • Seuls les types et ou numéros de série de lecteur changent.

    • Le numéro de série du LSM change.

    • Seul le type du LSM change et passe de 4410 à 9310.

    • Le nombre des robots de la SL8500 change.

    Cependant, si ces changements interviennent sans autres modifications nécessitant une confirmation, confirmez la nouvelle configuration. La base de données est ensuite mise à jour.

    L'ACS et ses composants sont supprimés de la base de données.

Limite de config acs

  • Avec les bibliothèques connectées via SCSI, l'utilitaire config acs ne met à jour que la configuration des lecteurs. Il faut lancer un chargement initial pour qu'une bibliothèque connectée via SCSI puisse reconnaître les lecteurs qui sont ajoutés, retirés ou modifiés. Tous les lecteurs doivent être prêts lors du chargement initial de la bibliothèque.

  • Pour une bibliothèque connectée via SCSI, l'utilitaire config acs ne mettra pas à jour les configurations de panneaux ou de CAP. Pour les mettre à jour, vous devez arrêter ACSLS et utiliser acsss_config.

config drives

L'utilitaire config drives vous permet de reconfigurer tous les lecteurs sur un panneau de lecteurs existant. Cela inclut l'ajout de lecteurs, la mise à jour des types de lecteur et les numéros de série des lecteurs existants, ainsi que la suppression des lecteurs ayant été retirés de la base de données.

Utilisez l'utilitaire config drives pour apporter des modifications dynamiques aux configurations de lecteurs, notamment l'installation, le remplacement ou le retrait de lecteurs d'un panneau de lecteurs existant. D'autres modifications apportées aux configurations matérielles de la bibliothèque de bande, telles que les changements de nombre et/ou d'emplacement des cellules de stockage, le nombre ou la taille des CAP ou le remplacement d'un panneau de cellules de stockage par un panneau de lecteurs doivent être effectuées à l'aide de l'utilitaire config lsm ou config acs.

Remarques :

  • Le LSM contenant le panneau présentant la configuration de lecteurs modifiée doit être en ligne ou en mode diagnostic.

  • Sur le panneau de lecteurs à reconfigurer, tous les lecteurs doivent être prêts.

  • Il faut lancer un chargement initial pour qu'une bibliothèque connectée via SCSI puisse reconnaître les lecteurs qui sont ajoutés, retirés ou modifiés. Tous les lecteurs doivent être prêts lors du chargement initial de la bibliothèque.

  • Quand de nouveaux lecteurs remplacent des lecteurs existants, le basculement des LSM et des types de lecteurs en ligne ou l'exécution de config drives mettra automatiquement à jour les types et numéros de série des lecteurs.

Format

config drive panel_id or config drives panel_id

Utilisation

Pour reconfigurer tous les lecteurs d'un panneau de lecteurs existant :

  1. Entrez la commande suivante :

    config drive panel_id or config drives panel_id

    L'ancienne et la nouvelle configurations de lecteurs sont affichées pour le panneau.

  2. Confirmez les modifications apportées à la configuration.

    Après confirmation, la base de données est mise à jour.

    • Si la configuration n'a pas changé, la configuration s'affiche sans vous demander confirmation et l'utilitaire se ferme.

    • Si seuls les types ou numéros de série des lecteurs ont changé, la base de données ACSLS est mise à jour sans demande de confirmation.

config lsm

Cet utilitaire vous permet de reconfigurer un LSM existant et tous ses composants. Ces composants incluent les CAP, panneaux et lecteurs.

Si vous voulez ajouter ou supprimer un LSM dans un ACS, vous devez exécuter l'utilitaire config acs.

Procédures pour la modification des panneaux :

  • Si des panneaux sont retirés ou modifiés ou ont été vidés de leurs cartouches, le LSM peut rester en ligne.

  • Si des panneaux sont retirés ou modifiés et contiennent des cartouches, il est recommandé de faire passer le LSM concerné en mode diagnostic jusqu'à la reconfiguration du LSM et l'audit des panneaux affectés. Si vous ne procédez pas ainsi, les montages et démontages peuvent échouer.

  • Si vous avez ajouté des panneaux et placé manuellement des cartouches dans ces panneaux, lancez un audit pour synchroniser la base de données.

Format

config lsm lsm_id

Utilisation

Pour reconfigurer le LSM :

  1. Entrez la commande suivante :

    config lsm lsm_id

    L'ancienne et la nouvelle configurations sont affichées.

    La valeur "y" à côté du panneau vous indique que le(s) type(s) de panneau a ou ont été modifié(s). Pour plus de détails, consultez le fichier acsss_config.log.

  2. Confirmez la nouvelle configuration.

    Après confirmation, la base de données est mise à jour.

    Si la configuration demeure inchangée, la configuration s'affiche sans vous demander confirmation et l'utilitaire se ferme.

    Les modifications mineures sont appliquées automatiquement sans confirmation. En voici quelques exemples :

    • Seuls les types et ou numéros de série de lecteur changent.

    • Le numéro de série du LSM change.

    • Seul le type du LSM change et passe de 4410 à 9310.

    • Le nombre des robots de la SL8500 change.

    Cependant, si ces changements interviennent sans autres modifications nécessitant une confirmation, confirmez la nouvelle configuration. La base de données est ensuite mise à jour.

Limite de config lsm

  • Avec les bibliothèques connectées via SCSI, l'utilitaire config lsm ne met à jour que la configuration des lecteurs. Il faut lancer un chargement initial pour qu'une bibliothèque connectée via SCSI puisse reconnaître les lecteurs qui sont ajoutés, retirés ou modifiés. Tous les lecteurs doivent être prêts lors du chargement initial de la bibliothèque.

  • Il ne mettra pas à jour les configurations de panneaux ou de CAP. Pour les mettre à jour, vous devez arrêter ACSLS et utiliser acsss_config.

config ports

L'utilitaire config ports vous permet d'ajouter, de façon dynamique, des connexions de port à un ACS.

Remarque :

Tous les nouveaux ports doivent être connectés au même ACS que les ports existants.

Exécutez config acs acs_id puis config ports acs_id.

Pour remplacer un ACS par un autre ou modifier les adresses de connexion des ports, vous devez arrêter ACSLS et utiliser acsss_config.

Format

config ports acs_id or config port acs_id

Utilisation

Pour ajouter des ports :

  1. Entrez la commande suivante :

    config port acs_id or config ports acs_id

    La connexion de port actuelle pour l'ACS spécifiée s'affiche.

  2. Entrez le nombre de connexions de port pour l'ACS spécifié.

    Vous pouvez avoir quinze connexions au maximum.

  3. Indiquez l'ID du périphérique ou de l'hôte.

    Remarque :

    Assurez-vous que les nouveaux ports sont connectés au même ACS que les ports existants.

    L'ancienne et la nouvelle configurations sont affichées.

    Une modification de l'ordre des ports n'est pas considérée comme une modification de configuration. Les connexions sont affichées dans l'ordre dans lequel elles sont actuellement enregistrées dans la base de données.

  4. Confirmez la nouvelle configuration.

    Après confirmation, la base de données est mise à jour.

    Si la configuration demeure inchangée, la configuration s'affiche et l'utilitaire se ferme.

Limite de config ports

L'utilitaire config ports acs_id n'est pas pris en charge sur une bibliothèque connectée via SCSI/Fibre Channel.

L'utilitaire config ports ne supprimera pas ou ne modifiera pas un port (connexion) pour une bibliothèque. Vous devez arrêter ACSLS et utiliser acsss_config.

db_export.sh

L'utilitaire db_export.sh exporte les données des tables de la base de données ACSLS et les fichiers de contrôle ACSLS en préparation pour l'installation d'une mise à niveau ou la réinstallation d'ACSLS.

Remarque :

L'utilitaire db_export.sh ne peut pas s'exécuter si ACSLS est en cours d'exécution. Lancez acsss disable avant d'exécuter db_export.sh.

Format

db_export.sh -f [ db_file | tape_device ]

Options

  • -f db_file

    spécifie un fichier UNIX destiné à contenir une sauvegarde de la base de données ACSLS. Vous devez disposer des autorisations en écriture sur le fichier et le répertoire.

Remarques :

  • Si vous exportez la base de données vers un fichier, le fichier doit résider dans un répertoire non volatile. Si vous avez l'intention de réinstaller ACSLS, la réinstallation détruira les répertoires $ACS_HOME or $ACSDB_BKUP (tels que /export/backup) . Placez le fichier exporté ailleurs que dans votre système de fichiers.

  • Si vous indiquez le nom du fichier sans spécifier de chemin, db_export enregistre le fichier de base de données sous ce nom dans le répertoire de travail actuel. Il enregistre les fichiers de contrôle ACSLS dans un fichier nommé <filename>.misc dans le même répertoire.

  • Si vous exportez votre base de données vers une version antérieure d'ACSLS qui ne prend pas en charge certains de vos lecteurs de bande, bibliothèques de bande ou types de média de cartouche, retirez les bibliothèques de bande non prises en charge de votre configuration, ainsi que les lecteurs de bande et cartouches de vos bibliothèques avant d'exporter votre base de données.

  • -f tape_device

    spécifie tout périphérique de bande connecté et configuré pour le serveur ACSLS.

Si aucune option n'est spécifiée, le système prend par défaut le périphérique de bande.

Utilisation

Utilisez l'utilitaire db_export.sh pour préparer une réinstallation d'ACSLS ou une installation de mise à niveau d'ACSLS.

Voir aussi :

db_import.sh

L'utilitaire db_import.sh importe les données des tables de la base de données ACSLS et les fichiers de contrôle ACSLS que vous avez exportés à l'aide de l'utilitaire db_export.sh. Les fichiers de contrôle ACSLS sont situés dans $ACS_HOME/data/external et englobent des variables pouvant être définies par l'utilisateur et la configuration pour ACSLS. Ils spécifient les paramètres de contrôle d'accès, les préférences de travail, les modules de stockage de bibliothèque (LSM) de magasin étendu, les paramètres volrpt personnalisés, les attributs de volume (pour l'utilitaire watch_vols), etc. L'utilitaire db_import.sh fournit également des capacités de récupération après sinistre et de conservation des variables dynamiques personnalisées lors du transfert vers un autre système d'exploitation ou à partir d'une version antérieure.

Format

db_import.sh -f [ db_file | tape_device ]

Options

  • -f db_file

    spécifie un fichier UNIX créé par db_export.sh.

  • -f tape_device

    spécifie tout périphérique de bande connecté et configuré pour le serveur ACSLS.

Si aucune option n'est spécifiée, le système prend par défaut le périphérique de bande.

Utilisation

Utilisez l'utilitaire db_import.sh pour importer la base de données ACSLS que vous avez exportée à l'aide de l'utilitaire db_export.sh.

Remarque :

L'utilitaire db_import ne s'exécutera pas si ACSLS est en cours d'exécution. Lancez acsss disable avant d'exécuter db_import.sh.

Voir aussi :

del_vol

L'utilitaire del_vol recherche un volume dans la bibliothèque. S'il ne trouve pas le volume, del_vol le marque comme étant manquant ou absent ou le supprime de la base de données, selon votre demande.

Si tous les emplacements référencés pour le volume ne peuvent pas être vérifiés (par exemple parce que le LSM est hors ligne ou que le lecteur n'est pas prêt), vous êtes invité à confirmer le marquage du volume comme absent ou à le supprimer, sauf si -n (no_confirm_flag) est activé. Si le volume est supprimé, le volume et les informations qui lui sont associées, telles que l'appartenance à un pool de travail et les verrous actuels et en attente, sont supprimés de la base de données.

Les informations relatives au volume sont affichées sauf si l'option -q (quiet_flag) a été entrée. Si plusieurs options sont saisies, elles peuvent être formatées comme des options distinctes ou sous forme de chaîne continue.

Avant de marquer un volume comme absent ou de le supprimer, l'utilitaire del_vol vous demande de confirmer, sauf si l'option -n est indiquée.

  • Si le volume se trouve dans la bibliothèque, il reste actif dans la base de données.

  • Si le volume ne peut pas être localisé dans la bibliothèque, il est marqué comme absent sauf si vous spécifiez que le volume doit être supprimé.

  • Si les cellules ou les lecteurs où le volume pourrait être localisé sont inaccessibles (parce que les bibliothèques ou les lecteurs sont hors ligne ou ne fonctionnent pas), le volume est marqué comme manquant, sauf si vous spécifiez que le volume doit être supprimé.

Remarques :

  • Cet utilitaire ne supprime pas un volume qui est trouvé dans la bibliothèque.

  • Vous pouvez exécuter l'utilitaire del_vol pour supprimer un enregistrement de volume sans attendre l'expiration d'un statut Absent ou Ejecté.

  • ACSLS doit être en cours d'exécution (activé) pour prendre en charge l'utilitaire del_vol.

Format

del_vol [-n] [-d] [-f] [-q] vol_id

Options

  • -n

    mode sans confirmation ; marque le volume comme absent ou supprime un volume qui ne peut pas être trouvé sans demander confirmation à l'utilisateur.

  • -q

    mode silencieux ; ne pas imprimer toutes les informations extraites de la base de données.

  • -d

    supprime le volume sans attendre l'expiration d'un statut Absent ou Ejecté.

  • -f

    vous permet de réinsérer des cartouches qui étaient coincées dans un lecteur de bande. Avec l'option -f,vous pouvez supprimer un volume ou le marquer comme absent sans vérifier si le volume se trouve réellement dans la bibliothèque. Ceci vous permet de supprimer de la base de données un volume qui se trouvait dans un lecteur de bande défectueux. A l'aide de cette option, vous pouvez retirer le volume du lecteur, le supprimer de la base de données, puis réinsérer le volume pour une utilisation normale dans la bibliothèque pendant que le lecteur est en cours de réparation.

  • vol_id

    Numéro de série du volume à supprimer.

    Remarque :

    Si le numéro de série du volume contient un symbole dollar ($), placez-le entre guillemets simples. Par exemple : del_vol ’AB$001’

Utilisation

Vous pouvez utiliser del_vol pour retirer une cartouche d'un LSM hors ligne et la réinsérer dans un LSM en ligne, afin qu'elle soit automatiquement montée.

  • Retirez la cartouche du LSM hors ligne.

  • Utilisez del_vol pour marquer la cartouche comme étant absente.

  • Insérez la cartouche dans le LSM en ligne.

ACSLS et la base de données doivent être en état de fonctionnement (ne pas être en veille) pour que vous puissiez lancer cet utilitaire.

Remarque :

Si vous supprimez par erreur une cartouche de la base de données, vous devez auditer le panneau secondaire contenant la cellule d'accueil de la cartouche supprimée pour entrer de nouveau la cartouche dans la base de données. L'exécution de del_vol pendant que le système est en phase de récupération peut produire des résultats imprévisibles. La séquence de récupération intervient également lorsque vous faites passer un LSM en ligne (vary LSM online).

Exemple

Pour supprimer la cartouche U01102 sans imprimer les informations connexes :

del_vol -q U01102

drives_media.sh

Cette routine affiche tous les types de lecteurs, type de médias et la compatibilité entre les lecteurs et les médias qui sont pris en charge par la version actuelle d'ACSLS. Les informations sont généralement présentées sous forme de sortie standard.

Reportez-vous au Guide d'informations sur le produit ACSLS pour obtenir la liste des bibliothèques, types de lecteurs, types de médias et des compatibilités entre les lecteurs et les médias pris en charge.

Format

drives_media.sh [ -f, -h ]

Options

  • -f

    les informations sont écrites dans trois fichiers :

    • /tmp/drive_types.txt

    • /tmp/media_types.txt

    • /tmp/media_compatibility.txt.

  • -h

    affiche le message de syntaxe.

ejecting.sh

L'utilitaire ejecting.sh facilite les opérations d'archivage sécurisé d'éjections en masse. En travaillant à partir d'une liste de CAP et de volumes spécifiés, cet utilitaire exécute plusieurs opérations d'éjection en parallèle jusqu'à ce que le travail global soit terminé. Sauf si l'utilisateur demande à ce que les volumes soient éjectés dans un ordre prévis, cet utilitaire éjecte chaque volume vers son CAP le plus proche indiqué.

Chaque fois que possible, les CAP de proximité présentant un espace libre sont utilisés à la place des CAP les plus proches, si l'opération peut réduire une manipulation de CAP inutile par l'opérateur. L'approche générale réduit le déplacement des cartouches, élimine la migration de LSM par PTP et réduit la charge de travail globale de l'opérateur.

Tous les travaux d'éjection sont surveillés et récapitulés dans la fenêtre shell à partir de laquelle l'opération a été lancée. Voir l'option -x ci-dessous pour l'utilisation de plusieurs fenêtres XTERM. Les utilisateurs sont avisés chaque fois qu'un CAP spécifique est plein et prêt pour que l'opérateur puisse retirer les cartouches du CAP. L'opérateur est averti quand l'opération globale est terminée.

Un ensemble de journaux présentant les résultats de toutes les opérations d'éjection des dix derniers jours est conservé dans le répertoire $ACS_HOME/log/ejectingLogs. Chaque journal est identifié par un horodatage effectué à la fin de l'opération.

Format

Standard : ejecting.sh [-dmox] -c <CAP list> -v <volume list file>

Spécification de stratégie : ejecting.sh [dmox] -p <policy file>

Format hérité : ejecting.sh <CAP ID> <volume list file>

Options

  • -c <CAP list>

    Liste des ID CAP séparés par des espaces sur la ligne de commande. Tous les CAP de la liste des CAP doivent être dans le même ACS.

    Exemple : -c 0,1,0 0,1,1 0,5,0 0,5,1 0,9,0

    Les expressions avec caractère générique utilisant un astérisque (*) sont valides pour spécifier des LSM ou tous les CAP dans un LSM ou les deux.

    Exemples :

    • -c 0,1,* (Tous les CAP dans le LSM-1)

    • -c 0,*,0 (Le CAP-0 dans chaque LSM)

    • -c 0,*,* (Tous les CAP dans chaque LSM)

    Seuls les CAP qui sont en ligne et disponibles sont sélectionnés pour l'opération. Si des expressions avec caractère générique sont spécifiées, seuls les CAP dotés d'une priorité autre que zéro sont sélectionnés.

    L'ACS doit être une expression numérique et ne peut pas être référence par un caractère générique.

    Dans le cadre des bibliothèques d'envergure, la sélection des CAP peut grandement influencer la vitesse et l'efficacité des opérations d'archivage sécurisé. La spécification d'un trop grand nombre de CAP peut ajouter un travail inutile pour l'opérateur chargé de maintenir une multitude de CAP partiellement remplis. La spécification d'un trop petit nombre de CAP pour une charge de travail donnée peut provoquer des goulets d'étranglement et donc accroître le temps d'attente des robots. En règle générale, concernant les listes de volumes importantes, les CAP que vous sélectionnez doivent être répartis dans le complexe de bibliothèques sur différents rails et modules de bibliothèque. Lors de la sélection d'un petit nombre de CAP pour un grand nombre de volumes, divisez la bibliothèque en régions et choisissez un CAP situé au centre de chaque région.

  • -v <volume file>

    Il s'agit d'une spécification de fichier utilisant un nom de chemin d'accès complet ou relatif à un fichier texte simple. Le fichier doit contenir une liste des ID volumes, VOL-IDs (VOLSERS), représentant les volumes à éjecter. Seuls les volumes qui se trouvent dans le même ACS que les CAP spécifiés seront affectés. Les volumes montés ne seront pas éjectés.

  • -p <policy file>

    Le fichier de stratégie est une spécification utilisant un nom de chemin d'accès complet ou relatif. Ce fichier texte contient une stratégie définie pour les CAP et les volumes. Le format du fichier inclut le mot "caps:" suivi d'une liste des CAP à utiliser pour l'opération ; et le mot "vols:" suivi du nom de chemin complet du fichier de la liste des volumes.

    Exemple :

    caps: 0,1,0 0,1,1 0,5,0 0,5,1 0,9,0 0,9,1

    vols: /export/backup/volumes_to_eject.txt

  • -d

    L'option display indique à ejecting.sh d'afficher les affectations de volume au CAP avant d'exécuter l'opération d'éjection. Vous pouvez choisir d'afficher la liste complète des volumes et des CAP vers lesquels ils seront déplacés ou de n'afficher qu'un récapitulatif indiquant combien de volumes seront migrés de chaque LSM à chaque CAP.

    Après avoir consulté l'affichage, vous pouvez choisir de poursuivre ou d'abandonner l'opération.

  • -m

    Etiquette le travail avec un code de message opérateur compris entre "04" et "99". Dans les bibliothèques prises en charge, ce code numérique sera affiché sur la console de l'opérateur.

  • -o

    Il arrive parfois que les opérations d'archivage sécurisé requièrent que les volumes soient empilés dans un ordre donné. Avec cette option, la routine déplace les volumes spécifiés vers les CAP répertoriés en fonction de l'ordre dans lequel ils sont trouvés dans la liste des volumes et selon l'ordre des CAP indiqué. L'ordre des CAP est répété du premier au dernier, jusqu'à ce que tous les volumes aient été éjectés.

    Remarque :

    Comme l'ordre des volumes prend la priorité sur l'ordre des CAP, cette option ne tente pas d'optimiser le déplacement des volumes en limitant les routes PTP des LSM.
  • -x

    Utilisez une fenêtre XTERM dédiée pour chaque éjection de CAP. Cette option peut s'avérer utile pour le suivi des travaux d'éjection lors d'une opération d'éjection en masse. Une session XTERM s'affiche à chaque lancement d'éjection de CAP et se ferme dès que l'éjection correspondante est terminée.

    Si vous utilisez un terminal Windows, assurez-vous que le logiciel compatible avec X11-est installé. X11 est standard sur Solaris ou Linux. Vous devez ouvrir le contrôle d'accès d'affichage pour le serveur ACSLS à partir de la machine locale.

    Exemple : xhost + <acsls_server_hostname>

    Cet utilitaire recherche vos informations d'identification de connexion (who am i) pour déterminer où envoyer l'affichage. Vous devez vous connecter directement à partir de votre console ou machine bureau locale au serveur ACSLS afin de voir l'affichage.

Format existant

ejecting.sh <CAP ID> <volume file>

Le format existant de cet utilitaire a été préservé. Il comprend un ID CAP et un nom de chemin d'accès à un fichier contenant une liste simple des volumes. Il compose ensuite une série de commandes eject optimisées pour la taille du CAP, et affiche les commandes en résultant dans une sortie standard. L'affichage inclut autant de commandes eject que nécessaire pour l'éjection de tous les volumes de la liste au moyen du CAP spécifié.

L'opérateur peut ajouter une barre verticale dans la sortie ejecting.sh pour la diriger vers cmd_proc et exécuter l'opération.

Exemple :

ejecting.sh 0,1,0 /export/backup/myVolumeList | cmd_proc -lq

Autrement, la sortie peut être redirigée vers un fichier qui peut ensuite être redirigé vers cmd_proc.

Exemple :

ejecting.sh 0,1,0 /export/backup/myVolList > /tmp/eject.dat cmd_proc -lq < /tmp/eject.dat

Journaux de l'utilitaire ejecting.sh

Chaque instance de l'utilitaire ejecting.sh est consignée dans le répertoire, $ACS_HOME/log/ejectingLogs/. Chaque fichier journal est nommé avec un horodatage de date. Par exemple :

ejecting.log.14-Oct_13:13:10

Chaque fichier ejecting.log récapitule l'opération d'éjection globale telle qu'elle est apparue dans la fenêtre shell de l'opérateur. Il présente également les éventuelles erreurs détectées.

Un fichier ejecting.log peut contenir une liste des volumes ignorés par l'utilitaire car :

  • L'ID volume n'est pas valide.

  • Le volume ne se trouve pas dans l'ACS spécifié.

  • Le volume est en cours d'utilisation.

Les fichiers qui s'accumulent dans le répertoire ejectingLogs/ sont purgés après dix jours. Les journaux postérieurs à dix jours sont supprimés par chaque nouvel appel de l'utilitaire ejecting.sh.

free_cells.sh

L'utilitaire free_cells.sh vous permet de surveiller et de gérer les cellules libres dans les bibliothèques gérées par ACSLS. Cet utilitaire indique le nombre de cellules libres d'un LSM, d'un ACS et du serveur ACSLS.

Cet utilitaire se trouve dans le répertoire $ACS_HOME/utils.

Format

free_cells.sh

Option

  • -a

    affiche les cellules libres, les cellules allouées et le nombre total de cellules dans chaque ACS et LSM ainsi que celles gérées par le serveur ACSLS.

Exemples

Cellules libres dans chaque LSM

  • Le LSM n'est pas une bibliothèque L5500 (seul le nombre total de cellules libres est affiché)

    • Aucune option sélectionnée

      LSM 1,3
      Nombre total de cellules libres = 2 345

    • Option -a (indique les cellules allouées et le nombre total de cellules)

      LSM 1,3
      Nombre total de cellules libres = 3 345
      Cellules allouées = 3 155
      Nombre total de cellules = 6 500

  • Le LSM est une bibliothèque L5500 (les cellules libres LTO et non LTO sont affichées séparément)

    • Aucune option sélectionnée

      LSM 0,2
      Cellules libres LTO = 573
      Cellules libres non LTO = 467
      Nombre total de cellules libres = 1 040

    • Option -a (indique également les cellules allouées et le nombre total de cellules)

      LSM 0,2
      Cellules libres LTO = 573
      Cellules libres non LTO = 467
      Nombre total de cellules libres = 1 040
      Cellules allouées = 4 460
      Nombre total de cellules = 5 500

Cellules libres dans chaque ACS

S'il n'y a qu'un LSM dans l'ACS, seul l'ACS est répertorié comme présenté dans les exemples suivants.

  • L'ACS ne comporte aucune bibliothèque L5500

    • Aucune option sélectionnée (affiche uniquement le nombre total de cellules libres)

      ACS 1
      Nombre total de cellules libres = 5 342

    • Option -a (affiche également les cellules allouées et le nombre total de cellules)

      ACS 1
      Nombre total de cellules libres = 5 342
      Cellules allouées = 5 658
      Nombre total de cellules = 11 000

  • L'ACS comporte une bibliothèque L5500 (affiche séparément les cellules libres LTO et non LTO)

    • Aucune option sélectionnée

      ACS 0
      Cellules libres LTO = 1 573
      Cellules libres non LTO = 968
      Nombre total de cellules libres = 2 541

    • Option -a (affiche également les cellules allouées et le nombre total de cellules)

      ACS 0
      Cellules libres LTO = 1 573
      Cellules libres non LTO = 968
      Nombre total de cellules libres = 2 541
      Cellules allouées = 2 959
      Nombre total de cellules = 5 500

Cellules libres gérées par le serveur ACSLS

  • L'ACS ne comporte aucune bibliothèque L5500

    Dans ce cas, seul le nombre total de cellules libres est affiché.

    • Aucune option sélectionnée

      Serveur ACSLS
      Nombre total de cellules libres = 7 883

    • Option -a

      Serveur ACSLS
      Nombre total de cellules libres = 7 883
      Cellules allouées = 14 117
      Nombre total de cellules = 22 000

  • L'ACS comporte des bibliothèques L5500

    Dans le cas où il y a des bibliothèques L5500 gérées, seuls le nombre de cellules libres LTO et le nombre total de cellules libres sont affichés. Les cellules libres non LTO ne sont pas affichées car la bibliothèque L5500 est la seule bibliothèque qui sépare les cellules LTO des cellules non LTO.

    • Aucune option sélectionnée

      Serveur ACSLS
      Cellules libres LTO = 1 573
      Nombre total de cellules libres = 7 883

    • Option -a

      Serveur ACSLS
      Cellules libres LTO = 1 573
      Nombre total de cellules libres = 7 883
      Cellules allouées = 14 117
      Nombre total de cellules = 22 000

getHba.sh

L'utilitaire getHba.sh gère les ports HBA Fibre Channel.

Format

getHba.sh

L'utilitaire getHba.sh est exécuté au moment de l'installation et est appelé par install_acsss.sh qui est appelé par install.sh. L'utilitaire peut être exécuté directement chaque fois qu'un nouvel HBA est ajouté au système ou chaque fois que les ports HBA sont réorganisés. Cet utilitaire identifie le port HBA à faire passer du mode initiateur au mode cible, pour détecter un point d'accès client aux bibliothèques logiques ACSLS.

Il est recommandé d'utiliser cet utilitaire pour configurer vos connexions FC avant l'exécution de getHba.sh. Ainsi, l'utilitaire getHba.sh peut vous présenter des informations utiles sur les connexions existantes.

L'utilitaire évalue d'abord si un adaptateur en mode cible a déjà été configuré. S'il n'existe aucun port cible, le flux de l'utilitaire se poursuit comme expliqué ci-après. Si l'utilitaire détecte un éventuel port cible existant, il affiche les options de menu suivantes :

Sélectionnez l'action voulue :

  1. Keep the existing HBA port configuration.

  2. Configure an additional target-mode port.

  3. Restore an existing target port to initiator mode.

    Option Description
    1 Ferme cet utilitaire.
    2 L'utilitaire affiche la liste des ports qui fonctionnent actuellement en mode initiateur. Quand un port indique "Connected to a remote HBA", cela signifie qu'il y a un initiateur à l'autre extrémité, donc un candidat potentiel pour devenir un port cible ACSLS. Quand un port indique "Connected to a target device", cela signifie qu'il y a probablement une bibliothèque de bande ou un disque connecté, de sorte que ce port serait un mauvais choix pour les opérations en mode cible.
    3 Identifie chaque port configuré pour les opérations en mode cible et vous demande confirmation pour restaurer ce port au mode initiateur.

Exemple pour l'option 2

Indiquez quel port HBA doit être passé en mode Cible. Sélectionnez-le dans la liste suivante :

  1. HBA Port WWN 2100001b32055d85 Not connected.

  2. HBA Port WWN 2101001b32255d85 Connected to a remote HBA.

  3. HBA Port WWN 2102001b32055d85 Connected to a target device.

  4. None of these.

Remarque :

Si vous n'avez pas l'intention d'utiliser la fonction de bibliothèque logique, sélectionnez "none of these".

Après la sélection, vous êtes invité à la confirmer.

2 
HBA Port WWN 2101001b32055d85 /pci@0,0/pci10de,377@f/pci1077,143@0 
Is this correct? (y or n): 

Vous pouvez donc changer d'avis. Si vous répondez "n" (non), la liste des ports disponibles s'affiche de nouveau avec une invite pour la sélection. Si vous répondez "y" (oui), un message vous demande si vous voulez reconfigurer d'autres ports.

L'utilitaire poursuivra en ajoutant un groupe cible et un membre de groupe cible et vous êtes invité à redémarrer le server pour que les modifications apportées au mode cible prennent effet.

Création du groupe cible : 2101001b32255d85

Exemple pour l'option 3

Cette option vous permet d'annuler la configuration d'une cible existante et de rétablir le mode natif du HBA en tant qu'initiateur.

# cd $ACS_HOME/install 
# ./getHba.sh 
A Target-mode port has already been configured: 
      Target: wwn.2100001B32050A28  
          Connected to ...  
               Initiator: wwn.210100E08BA61A29 
      Please select a desired action: 
      1) Keep the HBA port configuration as it is. 
      2) Configure an additional target-mode port. 
      3) Restore a target port to initiator mode. 
      3 
      Target: wwn.2100001b32050a28 
Do you wish to restore this port to initiator mode? (y or n): y 
Removing 'qlt' binding in /etc/driver_aliases 
Are there additional ports you wish to reconfigure? (y or n): n 
A reboot will be necessary for these changes to take effect. 

get_license_info

Cet utilitaire a été supprimé à compter des versions ACSLS 7.3.1 et 8.0.1 car ACSLS ne requiert plus la validation de la licence d'utilisation. free_cells.sh vous permet d'afficher et de gérer le nombre de cellules libres dans les bibliothèques contrôlées par ACSLS.

greplog

Servez-vous de l'utilitaire greplog pour filtrer le journal acsss_event en incluant ou en excluant les messages contenant des mots-clés donnés. La syntaxe de cette routine est similaire à celle de la fonction grep d'UNIX. L'utilitaire greplog est spécifiquement destiné à être utilisé avec le fichier acsss_event.log, mais peut fonctionner avec tout type de fichiers de messages dans lesquels les enregistrements sont séparés par une ligne vierge.

Format

greplog -[v|i] <keyword> <logfile>

Options

  • -v

    Facultative. Cette option affiche tous les messages du journal à l'exception de ceux contenant le mot-clé.

  • -i

    Facultative. Cette option ignore la casse des caractères dans le mot-clé spécifié.

  • -keyword

    renvoie le message complet de plusieurs lignes contenant le mot-clé.

  • -logfile

    liste des fichiers journaux.

Utilisation

Comme cet utilitaire est spécifiquement conçu pour les fichiers journaux, greplog renvoie le message complet sur plusieurs lignes contenant le mot-clé plutôt qu'une ligne unique avec ce mot. Avec l'option -i, greplog ignore la casse des caractères dans un mot-clé spécifié. Avec l'option -v, greplog affiche tous les messages du journal à l'exception de ceux contenant le mot-clé. greplog est spécifiquement destiné à être utilisé avec le fichier acsss_event.log, mais peut fonctionner avec tout type de fichiers de messages dans lesquels les enregistrements sont séparés par une ligne vierge.

install_scsi_Linux.sh

L'utilitaire install_scsi_Linux.sh crée des liens /dev/mchanger* qui peuvent être utilisés lors de la configuration des bibliothèques pour ACSLS. Ces noms de périphérique mchanger sont désormais construits à l'aide d'un numéro de série indiqué par la bibliothèque, pour fournir à ACSLS un identifiant fiable qui reste, quelles que soient les modifications apportées au SAN ou les réinitialisations serveur (les deux étant susceptibles de modifier les chemins de périphérique sous-jacents pour une bibliothèque).

Les informations sur les liens /dev/mchanger qui en résultent et sur les bibliothèques associées sont affichées dans la sortie de script, à l'aide de l'utilitaire showDevs.sh. Cet utilitaire peut être exécuté en mode autonome (après la création des liens mchanger) pour afficher les informations relatives à la bibliothèque.

Format

install_scsi_Linux.sh

Exemple de sortie :

========================================================================== 
# install/install_scsi_Linux.sh 
[root@acslsdevx1 install]# ./install_scsi_Linux.sh 
Installing SCSI device(s) for Oracle StorageTek ACSLS. 
Adding ACSLS rules for udev ... 
Starting udev:                                             [  OK  ] 
Successfully built the following... 
   /dev/mchanger-3500104f00079f9d2: STK SL500 V-1485 336-cells 10-drives 
   /dev/mchanger-3500104f0007a8532: STK SL500 V-1485 205-cells 6-drives 
   /dev/mchanger-3500104f000cc6a67: STK SL150 V-0182 59-cells 4-drives 
Installation of SCSI device(s) successfully completed. 
# 
=========================================================================== 
# utils/showDevs.sh 
   /dev/mchanger-3500104f00079f9d2: STK SL500 V-1485 336-cells 10-drives 
   /dev/mchanger-3500104f0007a8532: STK SL500 V-1485 205-cells 6-drives 
     /dev/mchanger-3500104f000cc6a67: STK SL150 V-0182 59-cells 4-drive  
# 
============================================================================ 

lib_type.sh

Cette routine renvoie le type de LSM des LSM connectés à l'ID ACS spécifié. Si plusieurs LSM d'un type commun existent dans la configuration, un seul type est alors renvoyé pour tous ces LSM.

Format

lib_type.sh <ACS ID>

licensekey.sh

a été supprimé à compter des versions ACSLS 7.3.1 et 8.0.1 car ACSLS ne requiert plus la validation de la clé de licence.

moving.sh

L'utilitaire moving.sh utility déplace plusieurs cartouches vers un ou plusieurs LSM. Cet utilitaire lit un fichier qui répertorie les cartouches à déplacer. Ces cartouches peuvent être :

  • Des cartouches dans un ou plusieurs LSM

    • Des cartouches sur un panneau à déplacer vers d'autres panneaux dans le même LSM ou d'autres LSM.

    • Tout groupe de cartouches que vous sélectionnez.

Les limites de l'utilitaire moving.sh sont les suivantes :

  • Tous les LSM et cartouches de destination dans le fichier vol_list_file doivent se trouver dans le même ACS.

  • Si un LSM de destination est hors ligne ou ne comporte pas de cellules libres, aucune cartouche n'est déplacée vers ce LSM.

Remarques :

  • L'utilitaire moving.sh s'exécute uniquement si ACSLS est en cours d'exécution.

  • En interne, l'utilitaire moving.sh ne déplace qu'une cartouche à la fois pour éviter d'impacter les performances de la bibliothèque (montages et démontages).

  • Vous pouvez lancer plusieurs utilitaires de déplacement en parallèle après avoir créé des listes de volumes distinctes. Assurez-vous que :

    • le LSM de destination est le même. Vérifiez que vous disposez de suffisamment de cellules libres dans le LSM pour accueillir toutes les cartouches.

    • vous procédez au déplacement au sein d'une bibliothèque SL8500 ; il n'y a que deux ascenseurs, de sorte que l'exécution de plus de deux utilitaires à la fois n'optimisera pas les performances.

Format

moving.sh -f vol_list_file -t lsm_id or list of lsm_ids

Où :

  • -f vol_list_file

    Nom du fichier contenant la liste des volumes à déplacer.

    Remarque :

    Les ID volume doivent respecter les règles suivantes : un ID cartouche par ligne ; les valeurs vol_ids doivent être des ID volume ACSLS valides ; si les ID incluent des espaces de début ou de fin, veillez à les mettre entre guillemets simples ou doubles.
  • -t lsm_id s

    spécifie un ou plusieurs ID LSM vers lesquels les cartouches seront déplacées. Chaque ID LSM doit être séparé par une espace et appartenir au même ACS.

Utilisation

Exécutez l'utilitaire moving.sh pour déplacer une liste de cartouches vers d'autres LSM ou d'un panneau vers d'autres panneaux dans le même LSM.

Vous pouvez utiliser un rapport de volume personnalisé ou lancer la commande display volume pour créer un fichier contenant la liste des volumes à déplacer à partir d'un LSM.

Vous pouvez exécuter l'utilitaire moving.sh :

  • Si une bibliothèque SL8500 est initialement partitionnée ou repartitionnée, et qu'un ou plusieurs rails (LSM) sont retirés d'une partition existante (ACS), moving.sh permet de déplacer les cartouches du LSM à retirer de la partition vers le(s) LSM qui reste(nt) dans la partition.

  • Quand un ou des LSM sont retirés d'un ACS, moving.sh permet de déplacer les cartouches vers les LSM qui restent dans l'ACS.

    Par exemple, si des SL8500 sont retirés d'un complexe de bibliothèques (ACS), moving.sh déplace les cartouches des SL8500 qui sont retirés vers les LSM qui resteront dans la bibliothèque. Il en va de même si des LSM 9310 sont retirés d'un ACS des 9310.

  • Quand un ou des module(s) de stockage d'extension sont retirés d'une bibliothèque SL8500, les cartouches peuvent être déplacées des panneaux à retirer vers les panneaux qui restent dans la bibliothèque.

  • Pour optimiser la performance de la bibliothèque, déplacez les cartouches inactives vers un LSM comportant peu ou aucun des lecteurs qui sont utilisés pour archiver des cartouches. Vous libérez ainsi de l'espace dans des LSM avec des lecteurs pour les nouvelles cartouches actives.

Création du fichier de liste des volumes

Avant de commencer, vous devez créer un fichier contenant la liste des volumes à déplacer à partir d'un LSM. Vous pouvez utiliser l'utilitaire volrpt (rapport de volume personnalisé) ou lancer la commande display volume.

  • Création d'un fichier vol_list_file

    volrpt -d -f custom_volrpt_input -l  lsm_id > vol_list_file

    Où le fichier custom_volrpt_input est :

    VOLUME_ID  6

    Exemple de sortie :

    $ volrpt -d -f my_custom -l 0,2 > my_file_list 
    $ cat my_file_list 
    ABC744  
    ABC748  
    ABC756  
    ACS151  
    EN0823  
    O00373  
    
  • Utilisation de la commande display volume pour créer un fichier vol_list_file

    1. Affichez la liste des volumes.

      Exemple :

      display volume * -home acs,lsm,panel,*,* -f vol_id

      Dans cet exemple, tous les volumes du panneau identifié par le paramètre -home sont sélectionnés. La ligne et la colonne sont indiquées par des caractères génériques. Seul le vol_id figure dans la sortie.

      Exemple de sortie :

      ACSSA> display volume * -home 0,3,5,*,* -f vol_id 
      2007-02-12 15:31:45              Display Volume 
      Vol_id 
      PG0350 
      PG0353  
      PG0356  
      PG0358  
      PQ0616  
      
    2. Créez et nommez votre fichier vol_list_file.

    3. Faites un couper-coller de la liste des volumes (créée par la commande display) dans ce fichier.

    4. Editez la sortie.

      Le fichier vol_list_file ne peut pas contenir des lignes vierges et des espaces de fin. Utilisez la commande vi suivante pour les éliminer.

      :%s/ˆ[ ]*//g  
      

      Si vous ne les supprimez pas, vous obtenez un message d'erreur similaire à celui de l'exemple suivant.

      $ moving.sh -f my_file_list -t 0,2 
        Error in file my_file_list. 
        Invalid entry 
       ABC748 
       ABC756 
      ACS151 
      EN0823 
      

      Ce message d'erreur a été généré car il y avait un espace en trop avant les volumes ABC748 et 756.

Procédures pour déplacer un groupe de cartouches

Les procédures suivantes expliquent comment :

  • déplacer des cartouches avant de retirer un LSM d'un ACS,

  • déplacer des cartouches avant de modifier ou de retirer des panneaux.

Déplacement des cartouches avant de retirer un LSM d'un ACS

Après qu'une bibliothèque est reconfigurée ou repartitionnée, et qu'un LSM est retiré d'un ACS, toutes les cartouches dans le LSM deviennent inaccessibles. En conséquence, avant que le LSM soit retiré, toutes ces cartouches doivent être déplacées vers le(s) LSM qui resteront dans l'ACS. Utilisez la procédure suivante :

  • Quand un rail (LSM) est retiré d'une partition existante dans une SL8500 partitionnée.

  • Quand un ou des LSM sont retirés d'un ACS. L'ACS peut inclure des 9310 ou une bibliothèque SL8500.

  1. Planifiez votre nouvelle configuration.

    • Organisez les cartouches et les lecteurs à des fins de performance.

    • Videz un LSM un peu avant d'apporter des modifications à la configuration de la bibliothèque.

    • Détermine how many cartridges you have in the LSMs that you are emptying, and how many free cells in the LSMs to which you are moving cartridges.

      Utilisez free_cells.sh -a pour connaître le nombre de cartouches dans ces LSM (cellules allouées) et cellules libres.

  2. Planifiez le déplacement et la reconfiguration.

    • Planifiez le déplacement de façon à minimiser l'impact sur votre système.

      Le déplacement des cartouches prend du temps et la reconfiguration d'une bibliothèque ou le repartitionnement d'une SL8500 implique une interruption.

    • Assurez-vous de disposer de suffisamment de cellules libres dans le(s) LSM cible pour les cartouches à déplacer. Si nécessaire, éjectez des cartouches pour libérer de l'espace.

  3. Faites passer tous les lecteurs du LSM à retirer à l'état hors ligne.

    Vous empêcherez ainsi :

    • Les conflits entre les robots dans le LSM.

    • Les montages pour ce LSM.

      Autrement, les cartouches montées dans ce LSM pourraient être transférées en mode float vers les nouvelles cellules d'accueil dans le LSM, et remplir le LSM que vous tentez de vider.

  4. Faites passer le LSM en cours de vidage au mode diagnostic pour limiter l'accès à cmd_proc uniquement à l'aide de la commande suivante :

    vary lsm lsm_id diagnostic

    Exemple : vary lsm 0,1 diagnostic

  5. Exécutez un rapport volrpt personnalisé pour afficher toutes les cartouches dans le LSM en cours de vidage dans un fichier, à l'aide de la commande suivante :

    volrpt -f custom_volrpt_input -l from_lsm_id > move_vols_list

    Où la valeur custom-volrpt_input est :

    VOLUME_ID   6

    Exemple : volrpt -f   volrpt_input   -l   0,1 > move_vols_list

    Pour plus d'informations, voir Création d'un journal de statistiques sur les volumes.

  6. Retirez les cartouches du LSM en cours de vidage à l'aide de la commande suivante :

    moving.sh -f move_vols_list -t dest_lsm_id(s)

  7. Vérifiez que le LSM est vide avec volrpt car des cartouches peuvent avoir été insérées ou transférées en mode float dans le LSM.

    volrpt -l from_lsm_id

    S'il n'est pas vide, exécutez de nouveau un rapport volrpt personnalisé pour sélectionner les volumes qui sont maintenant dans le LSM. Puis, relancez moving.sh (étapes 3 et 4).

    Remarque :

    N'exécutez pas moving.sh sur la liste des volumes initiale.
  8. Faites passer le LSM en cours de vidage en mode hors ligne pour empêcher le déplacement de volumes vers celui-ci.

    vary lsm lsm_id offline

    Remarque :

    Retirez le LSM de la partition et/ou de l'ACS.
  9. Reconfigurez l'ACS à l'aide de l'utilitaire config acs acs_id ou acsss_config.

Déplacement des cartouches avant la suppression des cellules d'une partition

Remarque :

La SL3000 peut être partitionnée au niveau lecteur et cellule et la SL8500 au niveau lecteur et baie de cellules grâce au partitionnement étendu. Si des cellules sont réaffectées d'une partition à une autre, les cartouches dans ces cellules seront orphelines et ne seront plus accessibles par la partition dans laquelle elles se trouvaient auparavant. L'hôte gérant l'autre partition pourrait écrire sur les données de ces cartouches.

Pour prévenir les cartouches orphelines quand les limites de partition changent : avant de repartitionner la bibliothèque, déplacez-les vers des cellules qui resteront dans la partition. Comme SL3000 est un LSM unique, la commande move existante d'ACSLS ne fonctionne pas. Il vous suffit de déplacer ces cartouches ailleurs dans la bibliothèque. Vous pouvez aussi les déplacer vers une autre cellule qui sera également retirée de la partition.

Pour déplacer vos cartouches, utilisez l'une des méthodes suivantes :

  • Utilisez StorageTek Library Console (SL Console).

    Auditez la bibliothèque pour auditer les emplacements des volumes.

    Pour des informations détaillées et connaître les procédures, reportez-vous au Guide de l'utilisateur de la SL8500 ou de la SL3000.

  • Utilisez la procédure ACSLS suivante :

  1. Utilisez volrpt ou Utilisation des options de commande display pour afficher les emplacements de volume.

  2. Affichez la liste des cellules disponibles (vides) dans un panneau spécifique à l'aide de la commande suivante :

    display cell a,l,p,*,* -status empty -f status

    Pour plus d'informations, voir Utilisation des options de commande display.

  3. Déplacez les cartouches vers une cellule spécifique en indiquant une cellule libre au lieu de l'ID LSM. Pour déplacer une cellule, utilisez la commande move :

    move AAAAAA a,l,p,r,c

Déplacement des cartouches avant de modifier ou de retirer des panneaux

Vous devez déplacer les cartouches avant de modifier un panneau de cellules en panneau de lecteurs dans une 9310 ou de retirer un module d'extension du stockage dans une SL8500.

Etapes 1 - 4, procédures identiques à celles de la section Déplacement des cartouches avant de retirer un LSM d'un ACS.

Etape 5 : sélectionnez les cartouches dans le panneau en cours de vidage et générez une sortie dans un fichier.

  1. Lancez un rapport volrpt personnalisé pour afficher toutes les cartouches dans le LSM en cours de vidage dans un fichier. Incluez le numéro du panneau (dans l'ID cellule d'accueil).

    volrpt -f custom_volrpt_input -l from_lsm_id > move_vols_list_1

    Où la valeur custom-volrpt_input est :

    VOLUME_ID  6 
    CELL_ID        14  
    

    Sélectionnez les volumes dans le(s) panneau(x) en cours de vidage et générez une sortie des ID volumes dans votre move_vols_list_2.

  2. Sélectionnez les cartouches dans un panneau en cours de vidage à l'aide de la commande display volume.

    display volume * -home acs,lsm,panel,*,* -f volume > move_vols_list_2

    Dans cet exemple, tous les volumes du panneau identifié par le paramètre -home sont sélectionnés. La ligne et la colonne sont indiquées par des caractères génériques. Seule la valeur vol_id est générée et écrite dans le fichier.

    Modifiez la sortie en supprimant les éventuelles espaces et ligne vierge de fin.

Remarque :

Si le LSM de destination est identique au LSM source et que plusieurs panneaux sont en cours de vidage, certains volumes sont redéplacés vers ces panneaux. Vous devrez alors sélectionner les volumes à retirer des panneaux et les déplacer de nouveau pour vider les panneaux.

Etapes 6 - 9, procédures identiques à celles de la section Déplacement des cartouches avant de retirer un LSM d'un ACS.

Etape 10. Reconfigurez le LSM en utilisant config lsm lsm_id ou acsss_config.

Exemples

  • Déplacement des cartouches du LSM 0,4 vers les LSM 0,0 et 0,1

    Pour déplacer des cartouches du LSM 0,4 vers les LSM 0,0 et 0,1, créez un fichier contenant la liste des cartouches présentes dans le LSM 0,4 à l'aide de volrpt, puis exécutez l'utilitaire moving.sh comme suit :

    Exemple de sortie :

    $ moving.sh -f vol_list.txt -t 0,0 0,1 
    Number of free cells in LSM 0,0 : 308 
    Number of free cells in LSM 0,1 : 362 
    ----------------------------------------- 
    Total number of free cells : 670 
    Total number of volumes to move : 7 
    
    Cartridge CAB001 moved to 0,0,3,0,0 
    Cartridge CAB002 moved to 0,0,4,0,0 
    Cartridge CAB003 moved to 0,0,5,0,0 
    Cartridge CAB004 moved to 0,0,6,0,0 
    Cartridge CAB005 moved to 0,0,7,0,0 
    Cartridge CAB006 moved to 0,0,8,0,0 
    Cartridge CAB007 moved to 0,0,9,0,0 
    
    Summary 
    ======= 
    Number of free cells remaining in LSM 0,0 : 301 
    Number of free cells remaining in LSM 0,1 : 362 
    ------------------------------------------------ 
    Total number of free cells remaining : 663 
    Number of cartridges moved : 7  
    Number of cartridges not moved : 0 
    
  • Déplacement des cartouches des LSM 0,4  0,5  0,6 et 0,7 vers les LSM 0,0  0,1  0,2 et 0,3,

    Pour optimiser les performances, en déplaçant chaque LSM vers le LSM adjacent :

    • Préparez des fichiers contenant la liste des cartouches présentes dans les LSM 0,4  0,5  0,6 et 0,7 avec volrpt.

    • Lancez quatre utilitaires moving.sh en même temps mais dans des terminaux de commande UNIX distincts.

      Il n'y a aucun conflit entre les instances de moving.sh car les LSM source et de destination et les PTP utilisés sont tous différents :

      Exemple de sortie :

      moving.sh -f vol_list_0-4.txt -t 0,0  
      moving.sh -f vol_list_0-5.txt -t 0,1 
      moving.sh -f vol_list_0-6.txt -t 0,2 
      moving.sh -f vol_list_0-7.txt -t 0,3 
      

Gestion des cartouches à des fins de performance

L'utilitaire moving.sh peut être utilisé pour déplacer des cartouches inactives vers des LSM d'archivage. Un LSM d'archivage est un LSM qui contient peu, voire pas de lecteurs et stocke des cartouches dont la probabilité d'être montées est faible. Le rail du haut dans une bibliothèque SL8500 est un bon choix pour un LSM d'archivage car il n'a pas d'accès direct au CAP.

Les cartouches inactives qui n'ont pas besoin d'être dans une bibliothèque peuvent être éjectées, tandis que celles qui doivent rester disponibles pour des montages automatiques devraient être déplacées vers des LSM d'archivage.

Pour déplacer des cartouches inactives vers un LSM d'archivage, procédez comme suit :

  1. Identifiez les cartouches inactives. Par exemple, pour sélectionner les cartouches qui n'ont pas fait l'objet d'un accès dans les trois derniers mois :

  2. Exécutez volrpt pour obtenir un rapport personnalisé de toutes les cartouches dans le LSM concerné et générer une sortie des résultats dans un fichier.

    volrpt -f custom_volrpt_input -l from_lsm_id > move_vols_list_1

    Où la valeur custom-volrpt_input est :

    VOLUME_ID 6

    ACCESS_DATE 15

  3. Sélectionnez les cartouches pour lesquelles la date access_date est antérieure à trois mois et générer les résultats dans un fichier avec la liste des volumes à déplacer.

  4. Déplacez les cartouches inactives vers le LSM d'archivage.

    moving.sh move_vols_list_2 archival_lsm_id

Voir :

probeFibre.sh

Cet utilitaire affiche toutes les bibliothèques connectées en direct ou via un SAN derrière un HBA Fibre Channel moderne.

L'utilitaire probeFibre.sh affiche le numéro du modèle, l'ID LUN et le nom de port universel (WWPN) de chaque bibliothèque connectée via Fibre Channel. L'utilitaire probeFibre.sh peut être exécuté avant que les périphériques mchanger soient créés pour chaque bibliothèque.

Cet utilitaire nécessite un accès root.

Format

probeFibre.sh [-v] [-p]

Options

Aucun argument.

affiche le fournisseur, le modèle, l'ID LUN et le WWPN pour chaque périphérique de bibliothèque.

  • -v

    produit une sortie structurée qui inclut le numéro de modèle de l'adaptateur de bus hôte (HBA) et le WWPN de chaque port initiateur, ainsi que les périphériques de bibliothèque détectés sur chaque port (y compris le WWNN).

  • -p

    produit une sortie incluant vendor:model:version:driver:target:lun:wwpn avec chaque champ séparé par un deux-points.

rdb.acsss

L'utilitaire rdb.acsss restaure la base de données ACSLS et les fichiers de contrôle ACSLS à l'aide d'une sauvegarde créée par la fonction de sauvegarde automatique ou par l'utilitaire bdb.acsss. Les fichiers de contrôle ACSLS sont situés dans $ACS_HOME/data, et définissent plusieurs variables d'environnement pour ACSLS. Ils spécifient les paramètres de contrôle d'accès, les préférences de volume de travail, les modules de stockage de bibliothèque (LSM) de magasin étendu, les paramètres volrpt personnalisés, les attributs de volume (pour l'utilitaire watch_vols), etc.

Si vous procédez à la restauration à partir d'une sauvegarde sur bande, veillez à rembobiner ou positionner le périphérique de bande avant de restaurer la base de données et les fichiers de contrôles ACSLS à partir de la bande. Utilisez une des commandes suivantes pour rembobiner ou positionner la bande à l'emplacement exact où résident les fichiers de sauvegarde avant d'exécuter rdb.acsss.

mt -f /dev/rmt/0mn rewind 
mt -f /dev/rmt/0mn nbsf 1 

Format

rdb.acsss

Options de menu

Quand vous exécutez rdb.acsss, un menu affiche quatre options, comme illustré dans l'exemple ci-dessous.

Please enter the number followed by Return for your choice from 
the following menu. 
Press? followed by the Return key for help. 
   1: Restore from a list of current local disk backup files 
   2: Restore from a previous tape or file backup 
   3: Restore database only (do not include ACSLS control files) 
   4: Restore only ACSLS non-database control files 
   E: Exit 
  1. Restore from a current local disk backup

    Tous les fichiers de sauvegarde ACSLS actuels figurant sur le disque local sont affichés.

    Explication : la base de données est restaurée en fonction de la sauvegarde. Les fichiers de contrôle ACSLS sont restaurés à partir de la sauvegarde uniquement. Les sauvegardes sont enregistrées dans le répertoire de sauvegarde par défaut ($ACSDB_BKUP). La base de données est restaurée en fonction de n'importe quelle sauvegarde de base de données répertoriée et sélectionnée. En général, il y a 8 dates affichées mais ce nombre varie en fonction de la période de conservation de la base de données définie dans csss_config.

    Utilisation : utilisez cette option pour restaurer une base de données altérée. Avec cette option, toutes les sauvegardes sont affichées et vous pouvez restaurer n'importe quelle sauvegarde de base de données affichée.

    Exemple :

    Menu choice: 1 
    rcvr_previous.sh 2642:  ACSLS database recovery started. 
    You have taken backups on the following days. Please enter the corresponding date and time to the backup that you wish to recover from. ACSLS database and control files will be restored to that time. 
    2011-10-02 04:38:48 
    2011-10-03 00:00:01 
    2011-10-04 00:00:01 
    2011-10-05 00:00:01 
    2011-10-05 11:49:06 
    Please enter the recovery date and time (YYYY-MM-DD HH:MM:SS): 
    HINT: You may copy and paste to enter the date and time. 
    

    Vous devez indiquer la date et l'heure voulue de la sauvegarde appropriée et la base de données est restaurée en fonction.

  2. Restore from previous tape or file backup

    Explication : sélectionnez cette option pour récupérer une base de données qui a été copiée vers un système de fichiers différent (NFS par exemple) ou sur une unité de sauvegarde (telle qu'une bande). Les fichiers de contrôle ACSLS sont restaurés.

    Utilisation : utilisez cette option pour un événement catastrophe telle qu'une défaillance matérielle quand la base de données doit être restaurée sur le serveur ou sur un nouveau serveur. La plate-forme (version du SE/mise à jour et la version ACSLS/niveau PUT) doit être identique.

    Option 2: 
    Menu choice: 2. 
    rcvr_manual.sh 2635: ACSLS recovery started 
    To recover the ACSLS environment either: 
    - Mount a ACSLS backup tape in a tape device and  
      specify this tape device with '-f tape_device', or 
    - Specify a file name containing a ACSLS backup with '-f   backup_file'.  
    

    La base de données ACSLS sera rétablie à partir du fichier spécifié.

    Entrez -f [ backup_file | tape_device ] :

    Exemple 1 : spécification d'un fichier avec -f backup_file

    Please mount tape (if used) and enter backup source: -f /export/backup/my_backup.bak

    Cette commande restaurerait une base de données nommée my_backup.bak. La base de données et les fichiers de contrôle ACSLS seraient restaurés et ACSLS reprendrait l'état qu'il avait quand la sauvegarde a été effectuée.

    Exemple 2 : restauration d'une sauvegarde créée sur un périphérique de bande

    La restauration d'une sauvegarde créée sur un périphérique de bande utilise la même option mais fonctionne un peu différemment. Quand une sauvegarde est créée sur un périphérique de bande, l'archive tar est créée sur la bande mais n'a pas de nom. Lors de la restauration d'une sauvegarde à partir d'une bande, seul le périphérique de bande est indiqué.

    CONSEIL : vous devez utiliser un périphérique de bande sans rembobinage.

    Please mount tape (if used) and enter backup source: -f /dev/rmt/0mn

    Ceci permet d'accéder au périphérique /dev/rmt/0mn et de vérifier qu'il s'agit d'une sauvegarde de base de données valide. Si elle existe et est valide, elle est restaurée.

    Procédure pour rembobiner une bande :

    La bande doit être rembobinée ou positionnée à l'emplacement correct où résident les fichiers de sauvegarde avant toute tentative d'exécution de rdb.acsss.

    Remarque :

    Après l'exécution de la commande tar tvbf, la bande avance vers le bloc suivant. Assurez-vous d'avoir rembobiné/repositionné la bande si vous voulez lancer l'utilitaire rdb.acsss après l'exécution de la commande tar tvbf.
    1. La bande peut être rembobinée/repositionnée à l'aide de la commande suivante :

      mt -f /dev/rmt/0mn rewind or mt -f /dev/rmt/0mn nbsf 1 ---> SOLARIS

    2. Pour vérifier le contenu de la bande après l'exécution de l'utilitaire bdb.acsss, utilisez les commandes suivantes :

      tar tvbf 2048 /dev/rmt/0mn ---> SOLARIS

  3. Restore database only (do not include ACSLS control files)

    Explication : cette option permet de ne restaurer que les données. Dans certains environnements, vous pouvez avoir besoin de restaurer la base de données ACSLS et ses données sans nécessairement avoir à restaurer les fichiers de contrôle ACSLS.

    Option 3:  
    Menu choice: 3 
    To recover the ACSLS database data only, either: 
    - Mount an ACSLS backup tape in a tape device and specify this tape device with '-f tape_device', or 
    - Specify a file name containing an ACSLS backup with '-f backup_file'.  
    The ACSLS database data will be recovered from the file specified.  
       ****This option does not include the ACSLS control files****  
    Please enter -f [ backup_file | tape_device ]:  
    
  4. Restore only ACSLS non-database control files

    Explication : restaure uniquement les fichiers de contrôle ACSLS. Avant de restaurer un fichier résidant dans le répertoire $ACS_HOME/data/internal, les sauvegardes des fichiers existants sont effectuées, avec l'extension .bak.

    $ACS_HOME/data/internal/dynamic_variables/dv_config.dat.bak 
    $ACS_HOME/data/internal/dynamic_variables/dv_trace.dat 
    $ACS_HOME/data/internal/release.vars.bak  
    

    Ce n'est pas le cas des fichiers situés dans $ACS_HOME/data/external. Aucune sauvegarde des fichiers de contrôle ACSLS n'est effectuée avant la récupération.

    Option 4: 
    Menu choice: 4 
    To recover the ACSLS non-database control files either: 
    - Mount an ACSLS backup tape in a tape device and 
     specify this tape device with '-f tape_device', or 
    - Specify a file name containing an ACSLS backup with '-f backup_file'.  
    ACSLS non-database control files will be recovered from the file specified.  
    Please enter -f [ backup_file | tape_device ]:  
    

    Exemple :

    Please enter -f [ backup_file | tape_device ]: -f $ACSDB_BKUP/my_file.bak 
    
    • -f $ACSDB_BKUP/my_file.bak récupère les fichiers de contrôle ACSLS à partir du fichier spécifié.

    • -f /dev/rmt/0mn récupère les fichiers de contrôle ACSLS à partir du périphérique de bande spécifié.

  5. Exit

    Quand vous quittez l'utilitaire rdb.acsss, une sauvegarde est effectuée dans le répertoire par défaut $ACSDB_BKUP.

showDevs.sh

L'utilitaire showDevs.sh affiche les attributs de périphérique critiques associés à chaque instance mchanger dans le répertoire /dev. Ces attributs incluent le numéro de modèle et le niveau de révision de la bibliothèque, la capacité des cellules et le nombre de lecteurs connectés. Il est possible d'afficher d'autres attributs à l'aide des options ci-dessous.

Format

showDevs.sh [-w][-s]

Options

Cet utilitaire peut être exécuté avec plusieurs options.

No argument.

Cette option affiche chaque mchanger, modèle et niveau de code de bibliothèque, et nombre de cellules et de lecteurs.

  • -w

    Nom universel - affiche le WWPN des bibliothèques connectées, ainsi que les informations de base.

  • -s

    Numéro de série - affiche le numéro de série de la bibliothèque, ainsi que les informations de base.

    Remarque :

    Pour afficher les informations de HBA côté serveur (notamment le WWPN des ports HBA) et le WWPN de toutes les bibliothèques connectées, lancez l'utilitaire probeFibre.sh en tant qu'utilisateur root.

showDrives.sh

Cet utilitaire présente une liste de tous les lecteurs configurés connectés à ACSLS. La liste simple des emplacements de lecteur est triée par type de lecteur. Si l'option détaillée (-v) est utilisée, l'utilitaire affiche un récapitulatif présentant l'état du lecteur, le statut du lecteur et le statut logique affecté de chaque lecteur.

Format

showDrives.sh [-v]

stats_report

L'utilitaire stats_report génère des rapports de statistiques de volume de bibliothèque. Pour exécuter cet utilitaire, vous devez être connecté comme utilisateur acsss.

Format

stats_report [vol_statsX.log ...]

Où :

vol_statsX.log -

  1. A l'aide de cet argument facultatif, vous pouvez spécifier un ou des noms de fichiers journaux de statistiques de volume archivés.

    (Les fichiers archivés ont le format vol_statsX.log (où 0 <= X <= 8 ).)

    Utilisation d'un fichier archivé comme entrée :

    $stats_report  vol_stats0.log 
    

    Les rapports orientés heure et lecteur sont générés avec le nom du fichier d'entrée utilisateur ajouté au (et affiché avant) le nom du fichier rapport.

    Par exemple, si vous spécifiez vol_stats0.log, les rapports seront générés dans le répertoire $ACS_HOME/log comme suit :

    vol_stats0_drive_centric.txt and vol_stats0_time_centric.txt

  2. Pour générer un rapport pour tous les fichiers de statistiques de volume archivés en même temps, suivez la procédure ci-après :

    1. Générez le journal complet à partir de fichiers individuels

         $cd $ACS_HOME/log 
         $cat vol_stats8.log .... vol_stats0.log 
         acsss_stats.log  >  vol_statsXXXX.log 
            where vol_statsXXXX.log 
      

      La chaîne vol_stats est requise (mais XXXX peut représenter n'importe quelle valeur comme FULL, etc.) est le fichier concaténé de l'ensemble vol_statsX.log (où 0 <= X <= 8) et acsss_stats.log dans l'ordre inverse.

    2. Exécutez stats_report

      $stats_report vol_statsXXXX.log

      Les rapports sont générés en tant que fichiers vol_statsXXXX_drive_centric.txt et vol_statsXXXX_time_centric.txt.

      Si le nom de fichier ne contient aucun argument, les rapports orientés heure et lecteur sont générés à partir de $ACS_HOME/log/acsss_stats.log.

Utilisation

  • Le stats_report utilise le fichier acsss_stats.log actuel pour préparer deux rapports de statistiques de volume. Activez la collecte des statistiques de volume en définissant la variable LIB_VOL_STATS. Cette opération peut être réalisée avec le processus acsss_config (option 3) ou au moyen de la commande dv_config -p LIB_VOL_STATS. ACSLS produit automatiquement et conserve 9 fichier acsss_stats.log quand le journal atteint la taille par défaut de 500 Ko.

  • La taille des fichiers journaux et le nombre d fichiers à conserver sont contrôlés par les variables LIB_STATS_FILE_NUM et VOL_STATS_FILE_SIZE. Ces variables sont définies à l'aide de la méthode LIB_VOL_STATS décrite ci-dessus.

  • Les deux types de rapport sont :

    • drive_centric.txt

      Ce rapport contient une liste triée des lecteurs. Chaque enregistrement de lecteur comporte toutes les cartouches montées dans le lecteur, le demandeur, l'heure de la demande et la durée du montage.

    • time_centric.txt

      Remarque :

      Ce rapport contient l'utilisation des ressources de lecteur répertoriées en fonction d'une échelle de temps horaire. Chaque enregistrement de période inclut le demandeur, le lecteur spécifique, le nombre de montages pendant cette période pour ce lecteur et la durée d'utilisation du lecteur au cours de l'heure.

      Si l'utilisation du lecteur dépasse 60 minutes pour une période, cela indique que le montage s'est étalé sur deux périodes et donc ne sera pas indiqué dans la seconde période. Le premier rapport créé par stats_report est une vue de lecteur.

Remarques :

  • S'il y a un enregistrement DISMOUNT dans le journal sans enregistrement MOUNT correspondant, la raison peut être :

    • Le journal a été remplacé, ou

    • L'opération a été journalisée en raison d'un problème de consignation inconnu.

      Dans ce cas, l'enregistrement est omis du rapport généré.

  • S'il y a un enregistrement MOUNT dans le journal sans enregistrement DISMOUNT correspondant, la raison peut être :

    • L'opération DISMOUNT ne s'est pas encore produite, ou

    • L'opération n'a pas été journalisée en raison d'un problème de consignation inconnu.

      Dans ce cas, la durée du montage est définie sur -1 (indication des cas mentionnés ci-dessus). Ces enregistrements sont omis du calcul de la durée totale de montage dans le rapport orienté heure.

  • Dans les cas du passage à l'heure d'été ou d'hiver, les scénarios pour lesquels la durée de montage calculée est négative peuvent être plus nombreux. Pour les supprimer, la valeur absolue de la durée du montage est sélectionnée.

userAdmin.sh

L'utilitaire userAdmin.sh piloté par menus permet d'administrer les mots de passe des utilisateurs de l'interface graphique d'ACSLS. Il se trouve dans le répertoire $ACS_HOME/install. Vous pouvez ajouter, supprimer et répertorier les utilisateurs et modifier leurs mots de passe. WebLogic doit être en cours d'exécution pour permettre l'accès à l'utilitaire. Si WebLogic n'est pas en cours d'exécution, l'utilitaire démarre l'application et attend qu'elle soit en ligne avant d'afficher le menu.

Cet utilitaire doit être exécuté par l'utilisateur root et nécessite une authentification acsls_admin. Le compte utilisateur acsls_admin est configuré pendant l'installation d'ACSLS 8.4.

Lors de l'ajout d'un utilisateur ou de la modification du mot de passe d'un utilisateur, vous êtes invité à entrer le nom de l'utilisateur et à lui affecter un mot de passe. Le mot de passe est vérifié en fonction des critères de taille et de caractères autorisés de WebLogic.

Quand un utilisateur est supprimé, son compte peut toujours avoir une session d'interface graphique active. Quand l'utilisateur se déconnecte ou met fin à sa session, il ne pourra pas se reconnecter. Le redémarrage de l'interface graphique est le seul moyen de forcer l'arrêt immédiat d'une session. Une option permet de redémarrer l'interface graphique d'ACSLS (qui met fin à toutes les sessions).

Vous ne pouvez pas utiliser cet utilitaire pour modifier les mot de passe de l'utilisateur acsls_admin. Pour modifier ou réinitialiser le mot de passe pour l'utilisateur acsls_admin, vous devez :

  1. Lancer l'utilitaire wlinstall.sh.

    $installDir/wlinstall/wlinstall.sh 
    
  2. Exécutez userAdmin.sh pour rétablir les comptes utilisateur restants.

Format

userAdmin.sh 

Exemples

# ./userAdmin.sh 
     ACSLS GUI User Administration 
     Weblogic is online. 
Please enter the acsls_admin password: 
Authenticating.........Connected! 
Menu: 
1) Add a user account. 
2) Remove a user account. 
3) Change a user password. 
4) List users. 
5) Restart ACSLS GUI. 
6) Exit. 
Please select by number: 1 
--- Add a User --- 
Please enter the id of the user you wish to add: acsss 
Do you wish to add a GUI account for user 'acsss'? (y/n) y 
Please assign a password for 'acsss'. 
     Passwd: Please confirm password: 
     Passwd: 
Connecting.......... 
User accounts has been added. 
Please select by number: 2 
--- Remove a User --- 
Please enter the name of the user you wish to remove: accounts
 Do you wish to remove the ACSLS GUI account for user 'accounts'? (y/n) y 
Connecting.......... 
The account for accounts has been removed for future logins.> 
To disable any current login session for accounts, you
 must restart the ACSLS GUI. 
Please select by number: 3 
--- Change Password --- 
Enter the user name: acsss 
Passwd: Please confirm password: 
Passwd: 
Connecting.......... 
Password changed for acsss! 
Please select by number: 4 
--- List Users --- 
Connecting.......... 

Configured WebLogic users: 
      OracleSystemUser 
      acsls_admin 
      acsss 
Please select by number: 5 
Do you wish to restart the ACSLS GUI (affects all users)? (y/n) y
 Restarting: 
    Disabling WebLogic ........................... 
    Enabling WebLogic ................................ 
Please select by number: e 
# 

volrpt

L'utilitaire volrpt crée un rapport de volume.

Format

volrpt [-s vol|loc|use] [-d] [-f filename] [-z] [-a|-l|-v identifier_list] [-i]

Options

  • -s

    spécifie l'ordre de tri. Si vous ne spécifiez pas cette option, le tri s'effectue par défaut par ID volume. Si vous spécifiez cette option, vous devez indiquer l'une des valeurs suivantes :

    • vol

      tri par ID volume.

    • loc

      tri par emplacement d'accueil de volume.

    • use

      tri par utilisation de volume (nombre de montages).

  • -d

    indique que la sortie ne contient aucun saut de page ou informations d'en-tête. La sortie peut être utilisée comme entrée dans d'autres programmes tels que pr.

  • -f filename

    filename spécifie un modèle de rapport personnalisé.

  • -z

    champs d'identifiant remplis par des zéros.

  • -a

    limite le rapport à l'ACS spécifié. Vous pouvez spécifier plusieurs ACS (utilisez des espaces pour séparer les valeurs acs_ids).

  • -l

    limite le rapport au LSM spécifié. Vous pouvez spécifier plusieurs LSM (utilisez des espaces pour séparer les valeurs lsm_ids).

  • -v

    limite le rapport aux volumes (ou plages de volumes) spécifiés. Vous pouvez indiquer un seul vol_id, une liste de vol_ids séparés par des espaces ou une plage de volume sous la forme vol_id-vol_id.

  • identifier_list

    décrite par les options -v, -a et -l. Il s'agit d'une liste d'ACS, de LSM et de volumes (ou plages de volumes).

  • -i

    indique tous les volumes, y compris les cartouches absentes et éjectées.

    Si cette option n'est pas spécifiée, les cartouches absentes ou éjectées ne sont pas affichées.

Utilisation

Utilisez l'utilitaire volrpt pour créer un rapport des cartouches de la bibliothèque, comprenant leurs emplacement physique, historique, attributs et utilisation. Vous pouvez également utiliser volrpt pour vérifier la base de données après l'avoir restaurée. Vous pouvez utiliser les options -a, -l ou -v pour spécifier les ACS, LSM ou cartouches pour le rapport. Si vous n'indiquez aucune de ces options, volrpt ne crée un rapport que sur l'ACS 0.

Remarque :

Considérations spéciales relatives aux espaces de début et de fin. Quand vous spécifiez des arguments pour des volumes qui contiennent des espaces de début et de fin, vous devez placer ces arguments entre guillemets simples. Pour garantir que le guillemet simple sera transmis d'un composant shell à un autre, il doit être balisé avec le caractère d'échappement. Sous UNIX, le caractère d'échappement standard est la barre oblique inverse (\).

Exemples :

Pour formuler une commande volrpt sur la machine locale où vous voulez référencer un ID volume avec une espace de fin, soumettez la commande comme suit :

volrpt -v \'0000\'-\'9999\’

Pour soumettre la même commande via un shell (rsh) distant, placez l'intégralité de l'argument entre guillemets doubles :

rsh <acsls_hostname> -l acsss bin/volrpt -v "\' 0000\'-\' 9999\'"

L'exemple suivant présente un rapport de volume standard qui contient des champs pour l'ID volume, l'emplacement, le type d'étiquette, le type de média et l'historique de l'utilisation.

VOLUME REPORT UTILITY 
2002-06-30 14:01:21 
TOTAL VOLUMES: 400 SEQUENCE: sort by volume identifier 
Volume Home    LabelVolume    Times|---Entered---||--Last Used--|
 Label Location AttrType/Media MountedDateTime      DateTime 
CLN000 0,0,1,0,3 ExtC/STK1U    108/22/0109:30     10/04/01 14:26 
RB0000 0,1,2,1,10Ext.D/STK1R    310/01/0108:16     10/01/01 08:18 
RB1400 0,0,10,1,3Ext.S/STK1R    24310/01/0109:30     10/06/01 11:04 
RB1401 0,0,10,3,5Virt.D/STK1R    1210/01/0103:29     10/05/01 23:11 
  ”     "     " "  "  "" 
  "      "     "  "  "  "" 
  "      "     "  "  "  "" 
TB1440 0,1,3,1,9 Ext.D/STK2P    4308/12/0109:1109/28/0117:52 
  "      "     "  "  "  "" 
  "      "     "  "  "  "" 
  "      "     "  "  "  "" 

Dans la colonne Volume Type/Media : C indique les cartouches de nettoyage ; D les cartouches de données ; P une cartouche de nettoyage qui a été reportée comme usée par un lecteur de bande ; et S des cartouches de travail.

Utilisez l'option -f filename pour créer un rapport personnalisé ; voir Création d'un journal de statistiques sur les volumes pour plus d'informations.

$ACS_HOME/data/external/volrpt/owner_id.volrpt est un exemple de fichier d'entrée que vous pouvez exécuter ou utiliser comme modèle pour créer des rapports de volume personnalisés. Vous pouvez également enregistrer vos rapports de volume personnalisés dans le répertoire $ACS_HOME/data/external/volrpt.

Vous pouvez rediriger le rapport de volume vers un fichier avec une redirection UNIX standard :

volrpt > file

Exemples

Par défaut, volrpt indique uniquement le premier ACS dans la liste. Pour indiquer les cartouches dans l'ACS 0 et l'ACS 1, entrez la commande suivante :

volrpt -a 0 1

Pour indiquer les cartouches dans les LSM 0,1 et 2,1, triées par emplacement de cellule d'accueil, entrez la commande suivante :

volrpt -s loc -l 0,1 2,1

Remarques :

  • volrpt affiche le rapport de volume spécifié s'il s'est terminé avec succès. volrpt imprime un message pour stderr et se ferme si vous avez spécifié l'option -f et volrpt ne peut pas trouver le fichier spécifié ou vous avez spécifiez plus d'un fichier d'entrée. Pour les erreurs de champ dans le fichier d'entrée, volrpt imprime un message pour stderr et ignore la ligne comportant l'erreur mais ne se ferme pas.

  • Si les cartouches sont introuvables dans la liste des ID volume, la plage, ou le composant de bibliothèque spécifié, volrpt renvoie un message indiquant qu'aucun volume n'a été trouvé (no volumes found).

  • Si aucun paramètre n'est spécifié, il utilise par défaut l'ACS 0.

  • Si un ou des composants de bibliothèque sont spécifiés par l'option -a, -l, ou -v, mais que les volumes sont introuvables, des messages similaires aux suivants s'affichent.

    • Option -a (ACS)

      Messages :

      si un seul acs_id est indiqué et qu'aucun volume n'est présent, le message d'erreur suivant s'affiche : No Volumes found for ACS: (<acsid>)

      Exemple :

      $ volrpt -a 2 
      No Volumes found for ACS: (2)  
      

      si plusieurs acs_ids sont fournis mais qu'aucun d'entre eux de contient des volumes, le message d'erreur suivant s'affiche :

      No Volumes found for ACS: (<acsid1>)(<acsid2>)

      Exemple :

      $ volrpt -a 0 1  
      No Volumes found for LSM: (0) (1)  
      
    • Option -l (LSM)

      Messages :

      si un seul lsm_id est indiqué et qu'aucun volume n'est présent, le message d'erreur suivant s'affiche : No Volumes found for LSM: (<lsmid>)

      Exemple :

      $ volrpt -l 1,1  
      No Volumes found for LSM: (1,1)  
      

      si plusieurs lsm_ids sont fournis mais qu'aucun d'entre eux ne contient des volumes, le message d'erreur suivant s'affiche : No Volumes found for LSM: (<lsmid1>)(<lsmid2>)

      Exemple :

      $ volrpt -l 1,1 1,2 
      No Volumes found for LSM: (1,1) (1,2) 
      
    • Option -v (VOLUME)

      Messages :

      si un seul volid est indiqué et qu'aucun volume n'est présent, le message d'erreur suivant s'affiche : Volume(s) not: (<volid>)

      Exemple :

      $ volrpt -v BBB112 
      No Volumes found: (BBB112) 
      

      si plusieurs volids sont fournis mais qu'aucun d'entre eux ne contient des volumes, le message d'erreur suivant s'affiche : Volume(s) not found: (<volid1>)(<volid2>)

      Exemple :

      $ volrpt -v BBB112 BBB114 
      No Volumes found: (BBB112) (BBB114) 
      

      L'option -v peut également être utilisée pour la plage de volumes et produit des messages similaires si aucun volume n'est présent.

      si une seule plage de volumes est indiquée et qu'aucun volume n'est présent, le message d'erreur suivant s'affiche : Volume(s) not: (<volrange>).

      Exemple :

      $ volrpt -v BBB112-BBB116 
      No Volumes found: (BBB112-BBB116) 
      

      si plusieurs plages de volumes sont indiquées et qu'aucun volume n'est présent, le message d'erreur suivant s'affiche : Volume(s) not: (<volrange1>) (<volrange2>)

      Exemple :

      $ volrpt -v BBB112-BBB116 BBB220-BBB224 
      No Volumes found: (BBB112-BBB116) (BBB220-BBB224) 
      

      Si un ACS ou un LSM n'a pas été configuré

    Quand volrpt est utilisé avec une valeur acs_id ou lsm_id qui n'existe pas, il affiche un message en fonction de l'identifiant concerné.

    • -a (ACS)

      Identifiant ACS (<acsid>) non configuré

    • -l (LSM)

      Identifiant LSM (<lsmid>) non configuré

Voir Création d'un journal de statistiques sur les volumes.

watch_vols

Cet utilitaire applique des stratégies prédéfinies à des volumes qui sont :

  • nouvellement insérés

  • détectés par audit ou Cartridge Recovery

  • réactivés par un audit, Cartridge Recovery ou une insertion

    Ces stratégies sont définies dans le fichier :

    $ACS_HOME/data/external/vol_attr.dat

    Ce fichier contient une liste des ID volume définis par l'utilisateur ou des plages de volume et une stratégie spécifiée par l'utilisateur pour chaque volume enregistré. Pour chaque volume ou plage de volumes figurant dans ce fichiers, vous pouvez définir la propriété du volume, l'association de pool, l'emplacement de LSM préféré, et/ou l'affectation de bibliothèque logique quand un volume est inséré. Des instructions spécifiques pour définir les stratégies sont expliquées en détail dans le fichier vol_attr.dat.

    L'utilitaire watch_vols se sert de acsss_stats.log pour identifier l'existence de volumes récemment insérés ou de volumes détectés ou réactivés au cours d'un audit ou par Cartridge Recovery. Pour activer cette fonction, vous devez activer les statistiques de volume avec acsss_config (option 3). Quand les statistiques de volume sont activées, watch_vols surveille la fin du journal acsss_stats.log, en recherchant les volumes correspondant aux entrées définies dans vol_attr.dat. Chaque fois qu'une correspondance est trouvée, la stratégie définie pour ce volume est automatiquement appliquée.

Les ID volume doivent respecter les règles suivantes :

  • Un vol_id ou une plage de volumes par ligne.

  • Les valeurs vol_ids doivent être des ID volume ACSLS valides.

  • Si les vol_ids incluent des espaces de début ou de fin, ils doivent être représentés sous forme de trait de soulignement (_). Par exemple : _V234_.

Format

watch_vols [start|stop]

Utilisation

Vous pouvez vérifier le statut d'exécution de l'utilitaire en appelant watch_vols sans aucun paramètre. Si vous avez des doutes sur le statut de l'utilitaire watch_vols (en cours d'exécution ou arrêté), la commande watch_vols sans argument affiche le statut actuel.

Il existe deux options pour watch_vols, start et stop.

  • watch_vols start

    Quand le paramètre start est appelé, watch_vols vérifie les stratégies définies dans vol_attr.dat. S'il y a des erreurs dans le format ou la syntaxe, watch_vols affiche l'erreur et vous invite à apporter la correction nécessaire pour vol_attr.dat. Une fois que la stratégie définie est acceptée par watch_vols, l'utilitaire appelle un démon qui s'exécute en arrière-plan. Le démon continue de s'exécuter si ACSLS est en cours d'exécution. Il démarre automatiquement chaque fois qu'ACSLS est redémarré.

    La table des stratégies dans vol_attr.dat peut être mise à jour à tout moment. Il n'est pas nécessaire d'arrêter watch_vols pour mettre à jour la stratégie. Il vous suffit de lancer watch_vols start pour valider les mises à jour apportées au programme d'exécution.

  • watch_vols stop

    Cette commande arrête l'application de toute stratégie ultérieure pour les volumes spécifiés.

Un journal de toutes les activités watch_vols est conservé dans le fichier journal :

$ACS_HOME/log/watch_vols_event.log

Chaque modification apportée à la propriété du volume, à la valeur pool_id, ou à l'emplacement d'accueil LSM est consignée dans ce fichier.

Exemple

Vous effectuez une opération d'insertion et vous voulez déplacer des volumes spécifiques vers un LSM cible quand ils sont insérés.

  1. Auditez le LSM cible avec watch_vols disabled.

  2. Une fois le LSM cible audité, exécutez start watch_vols.

  3. Insérez les volumes dont les stratégies sont définies dans vol_attr.dat.

    L'utilitaire watch_vols déplace alors les volumes spécifiés vers le LSM de destination après leur insertion.