A propos du fichier stager.cmd

A propos du fichier `stager.cmd`

Le fichier stager.cmd vous permet de spécifier des directives afin de remplacer les comportements par défaut. Vous pouvez configurer l'outil de transfert de manière à ce que les fichiers soient immédiatement transférés, qu'ils ne soient jamais transférés, qu'ils soient partiellement transférés et pour spécifier d'autres actions de transfert. Par exemple, la spécification de l'attribut never-stage est utile aux applications qui accèdent à de petits enregistrements issus de fichiers volumineux, car l'accès aux données se fait directement à partir du média d'archivage, sans transfert du fichier en ligne.

Cette section décrit les directives de transfert. Pour plus d'informations sur les directives de transfert, reportez-vous à la section stager.cmd(4) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual. Si vous utilisez le logiciel SAM-QFS Manager, vous pouvez contrôler le transfert à partir de la page de récapitulatif du système de fichiers ou de la page Détails du système de fichiers. Vous pouvez parcourir le système de fichiers et consulter l'état de chaque fichier, utiliser des filtres pour afficher certains fichiers et sélectionner des fichiers particuliers à transférer. Vous pouvez sélectionner la copie à transférer ou laisser ce choix au système.

Exemple 15-1 Fichier stager.cmd

L'exemple suivant présente un fichier stager.cmd dans lequel toutes les directives possibles ont été définies.

# This is stager.cmd file /etc/opt/SUNWsamfs/stager.cmd
drives=dog 1
bufsize=od 8 lock
logfile=/var/adm/stage.log
maxactive=500

Création d'un fichier `stager.cmd`

Dans le fichier /etc/opt/SUNWsamfs/stager.cmd, ajoutez les directives permettant de contrôler le transfert sur votre site, conformément aux informations fournies dans les sections suivantes :
Enregistrez et fermez le fichier stager.cmd.
Propagez les modifications apportées au fichier et redémarrez le système.
```
# samd config
```

Directive `drives` : spécification du nombre de lecteurs pour le transfert

Par défaut, l'outil de transfert utilise tous les lecteurs disponibles lors du transfert de fichiers. Si tous les disques sont occupés par l'outil de transfert, cela peut interférer avec les activités de l'archiveur. La directive drives spécifie le nombre de lecteurs disponibles pour l'outil de transfert. Le format de cette directive est :

drives = library count

Argument	Définition
library	Nom de famille d'une bibliothèque tel qu'il apparaît dans le fichier `mcf`.
count	Nombre maximum de lecteurs à utiliser. Par défaut, il s'agit du nombre de lecteurs configuré dans le fichier `mcf` pour cette bibliothèque.

Exemple 15-2 Directive drives

L'exemple suivant spécifie qu'un seul lecteur de la bibliothèque de la famille dog est utilisé pour le transfert des fichiers :

drives = dog 1

Directive `bufsize` : définition de la taille de la mémoire tampon du transfert

Par défaut, un fichier en cours de transfert est lu dans un tampon dans la mémoire avant d'être restauré dans le cache disque à partir du média d'archivage. La directive bufsize permet de spécifier une taille de mémoire tampon et, le cas échéant, de verrouiller la mémoire tampon. Ces actions permettent d'améliorer les performances. Vous pouvez faire des essais avec différentes valeurs de buffer-size. Le format de la directive est :

bufsize = media buffer-size [lock]

Argument	Définition
media	Spécifiez le type de média d'archivage à partir de la liste de la page de manuel `mcf`(4).
buffer-size	Nombre compris entre 2 et 8 192. La valeur par défaut est 16. Cette valeur est multipliée par la valeur `dev_blksize` du type de média. La taille de mémoire tampon ainsi obtenue est utilisée. La valeur `dev_blksize` est spécifiée dans le fichier `defaults.conf`. Plus le nombre spécifié pour `buffer-size` est élevé, plus la mémoire utilisée est grande. Pour plus d'informations, reportez-vous à la page de manuel defaults.conf(4) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.
`lock`	L'argument `lock` indique que l'outil de transfert doit utiliser des mémoires tampon verrouillées lors du transfert de copies d'archive. Si `lock` est spécifié, l'outil de transfert applique des verrous de fichier au tampon de transfert pendant toute la durée de la copie. Cela permet d'éviter la surcharge associée au verrouillage et au déverrouillage du tampon pour chaque requête d'E/S et de réduire le temps CPU du système. L'argument `lock` doit être spécifié uniquement sur des systèmes volumineux avec des quantités de mémoire importantes. Une mémoire insuffisante peut entraîner un problème de saturation de mémoire. L'argument `lock` n'est efficace que si l'E/S en accès direct est activée pour le fichier en cours de transfert. Par défaut, `lock` n'est pas spécifié et le système de fichiers définit les verrouillages sur tous les tampons d'E/S en accès direct, y compris ceux destinés au transfert. Pour plus d'informations sur l'activation de l'E/S en accès direct, reportez-vous aux sections setfa(1) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual et sam_setfa(3) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual ou à l'option `-O forcedirectio` de la section mount_samfs(1M) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.

Directive `logfile` : spécification d'un fichier journal

Vous pouvez demander que le logiciel SAM-QFS collecte des informations sur les événements de transfert de fichier et qu'il les écrive dans un fichier journal. Par défaut, aucun fichier journal n'est écrit. La directive logfile spécifie un fichier journal dans lequel l'outil de transfert peut écrire des informations de journalisation. L'outil de transfert écrit une ou plusieurs lignes dans le fichier journal pour chaque fichier transféré. Cette ligne comprend des informations telles que le nom du fichier, la date et l'heure du transfert et le nom de série de volume (VSN). Le format de la directive est :

logfile=filename [event]

Argument

Définition

filename

Indiquez un chemin d'accès complet.

event

Indiquez un ou plusieurs événements de transfert. Si vous indiquez plusieurs événements, séparez-les par des espaces. Les événements suivants peuvent être indiqués :

all - Consigne tous les événements de transfert.

start - Consigne le début du transfert d'un fichier.

finish - Consigne la fin du transfert d'un fichier. Cet événement est activé par défaut.

cancel - Consigne l'annulation d'un transfert par l'opérateur. Cet événement est activé par défaut.

error - Consigne les erreurs de transfert. Cet événement est activé par défaut.

Exemple 15-3 Spécification d'un fichier journal de l'outil d'archivage

La directive suivante crée le fichier /var/adm/stage.log :

logfile=/var/adm/stage.log

Exemple 15-4 Fichier journal de l'outil d'archivage

S 2003/12/16 14:06:27 dk disk01 e.76d 2557.1759 1743132 /sam1/testdir0/filebu 1 root other root 0 -
F 2003/12/16 14:06:27 dk disk01 e.76d 2557.1759 1743132 /sam1/testdir0/filebu 1 root other root 0 -
S 2003/12/16 14:06:27 dk disk02 4.a68 1218.1387 519464 /sam1/testdir1/fileaq 1 root other root 0 -
S 2003/12/16 14:06:43 dk disk01 13.ba5 3179.41 750880 /sam1/testdir0/filecl 1 root other root 0 -
F 2003/12/16 14:06:43 dk disk01 13.ba5 3179.41 750880 /sam1/testdir0/filecl 1 root other root 0 -
S 2003/12/16 14:06:59 dk disk01 17.167b 1155.1677 1354160 /sam1/testdir0/filedb 1 root other root 0  /
-
F 2003/12/16 14:06:59 dk disk01 17.167b 1155.1677 1354160 /sam1/testdir0/filedb 1 root other root 0  /
-
S 2003/12/16 14:06:59 dk disk02 f.f82 3501.115 1458848 /sam1/testdir1/filecb 1 root other root 0 -
S 2003/12/16 14:07:15 dk disk01 1f.473 1368.1419 636473 /sam1/testdir0/fileed 1 root other root 0 -
S 2003/12/16 14:07:15 dk disk02 16.f15 3362.45 1065457 /sam1/testdir1/filecz 1 root other root 0 -
S 2003/12/16 14:07:31 dk disk01 23.201d 3005.1381 556807 /sam1/testdir0/fileeq 1 root other root 0 -
S 2003/12/16 14:07:47 dk disk01 26.c4d 2831.1113 1428718 /sam1/testdir0/fileez 1 root other root 0 -
S 2003/12/16 14:07:47 dk disk02 1b.835 3736.59 1787855 /sam1/testdir1/filedp 1 root other root 0 -

Le tableau suivant décrit le contenu des champs du fichier journal de l'outil d'archivage.

Champ	Exemple de valeur	Description du contenu
1	S	Activité de transfert : `S` pour démarrage, `C` pour annulé, `E` pour erreur, `F` pour terminé.
2	2003/12/16	Date de l'action de transfert, au format aaaamm`/`jj.
3	14:06:27	Heure de l'action de transfert, au format hhmm`:`ss.
4	dk	Type de média d'archivage. Pour plus d'informations sur les types de médias, reportez-vous à la section mcf(4) du manuel Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual.
5	disk01	VSN.
6	e.76d	Au format hexadécimal, emplacement physique du début du fichier archive sur le média (fichier `tar`) et décalage du fichier sur le fichier archive.
7	2557.1759	Numéro d'inode et numéro de génération. Le numéro de génération est un numéro supplémentaire utilisé en plus du numéro d'inode pour assurer le caractère unique, car les numéros d'inode peuvent être utilisés plusieurs fois.
8	1743132	Longueur du fichier.
9	`/sam1/testdir0/filebu`	Nom du fichier.
10	1	Numéro de copie d'archive.
11	root	ID utilisateur du fichier.
12	other	ID de groupe du fichier.
13	root	ID de groupe du demandeur.
14	0	Nombre ordinal d'équipement du lecteur à partir duquel le fichier a été transféré.
15	`-`	Dans ce champ, un `V` indique que la vérification des données est en cours d'utilisation pour le fichier.

Directive `maxactive` : spécification du nombre de requêtes de transfert

La directive maxactive permet de spécifier le nombre de requêtes de transfert pouvant être activées à un moment donné. Le format de la directive est :

maxactive=number

La valeur par défaut de number est 4 000. Le nombre minimum autorisé est 1. Le nombre maximum autorisé est 500 000.

L'exemple suivant spécifie qu'un maximum de 500 requêtes de transfert peuvent être placées simultanément dans la file d'attente :

maxactive=500

Ignorer les liens de navigation
Quitter l'aperu
	Guide de configuration et d'administration de Sun Storage Archive Manager 5.3 Sun QFS and Sun Storage Archive Manager 5.3 Information Library (Français)

Création d'un fichier stager.cmd

Directive drives : spécification du nombre de lecteurs pour le transfert

Directive bufsize : définition de la taille de la mémoire tampon du transfert

Directive logfile : spécification d'un fichier journal

Directive maxactive : spécification du nombre de requêtes de transfert