Guide d'installation Solaris 9 9/04

Mots-clés Solaris Flash

Comme les mots-clés JumpStart, les mots-clés Solaris Flash définissent des éléments relatifs à l'installation. Chaque mot-clé est une commande qui contrôle un aspect de la procédure à travers laquelle le logiciel Solaris Flash installe le logiciel sur un système clone.

Suivez les directives suivantes pour formater les mots-clés et les valeurs :

Les mots-clés et les valeurs sont séparés par un signe égal et chaque ligne ne doit comporter qu'une seule paire mot-clé+valeur.
Les mots-clés ne sont pas sensibles à la casse.
La longueur des lignes n'est pas limitée.

Mots-clés généraux

Les mots-clés section_begin et section_end balisent le début et la fin de chaque section d'une archive Solaris Flash. Exemple : la section des fichiers de l'archive inclut un mot-clé section_begin, mais possède une valeur différente. Les sections d'archive utilisateur sont délimitées par les mots-clés section_begin et section_end possédant des valeurs propres à chaque section. Vous trouverez une description des valeurs de ces mots-clés dans le tableau suivant.

Tableau 23–2 Valeurs des mots-clés section_begin et section_end


Section de l'archive	Valeur des mots-clés `section_begin` et `section_end`
Cookie de l'archive	`cookie` (cette section n'est pas délimitée par les mots-clés `section_begin` et `section_end`)
Identification de l'archive	`identification`
Sections utilisateur	`nom_section` (exemple : X-user_section_1 est un mot-clé `section_name`)
Fichiers de l'archive	`archive`

Mots-clés de la section d'identification

Les tableaux suivants décrivent les mots-clés à utiliser dans la section d'identification de l'archive, ainsi que les valeurs que vous pouvez leur attribuer.

La délimitation de toutes les sections s'effectue à l'aide des mots-clés figurant dans le Tableau 23–3.

Tableau 23–3 Mots-clés de la section d'identification : mots-clés généraux


Mots-clés	Définition des valeurs	Valeur	Requis
`section_begin` `section_end`	Ces mots-clés sont utilisés pour délimiter les sections de l'archive et leur emploi n'est pas limité à la section d'identification. Vous trouverez une description de ces mots-clés dans la rubrique Mots-clés généraux.	Texte	Oui

Les mots-clés suivants, utilisés dans la section d'identification de l'archive, décrivent le contenu de la section des fichiers de l'archive.

Tableau 23–4 Mots-clés de la section d'identification : contenu de la section de fichiers d'archive


Mots-clés	Définition des valeurs	Valeur	Requis
`archive_id` (facultatif)	Ce mot-clé ne décrit que le contenu de l'archive. Cette valeur n'est utilisée par le logiciel d'installation que pour valider le contenu de l'archive pendant son installation. En l'absence de ce mot-clé, le contrôle d'intégrité n'est pas réalisé. Exemple : le mot-clé `archive_id` peut être `FlAsH-ARcHive-2.0`.	Texte	Non
`files_archived_method`	Ce mot-clé décrit la méthode d'archivage utilisée dans la section des fichiers. Si ce mot-clé est présent, il possède la valeur `cpio`. Si ce mot-clé n'est pas présent, la section des fichiers est supposée être au format CPIO, avec des en-têtes ASCII. Ce format correspond à l'option `cpio` `-c`. Si `files_compressed_method` est présent, la méthode de compression est appliquée au fichier d'archive créé par la méthode d'archivage.	Texte	Non
`files_archived_size`	Cette valeur de mot-clé est de la même taille, en octets, que la section des fichiers archivés.	Numérique	Non
`files_compress_method`	Ce mot-clé décrit l'algorithme de compression utilisé dans la section des fichiers. Si ce mot-clé est présent, il peut posséder l'une des valeurs suivantes : `none` (la section des fichiers de l'archive n'est pas compressée) ; `compress` (la section des fichiers est compressée à l'aide de la commande `compress`). En l'absence de ce mot-clé, la section des fichiers de l'archive est supposée ne pas être compressée. La méthode de compression indiquée par ce mot-clé est appliquée au fichier de l'archive qui a été créé par la méthode d'archivage indiquée par le mot-clé `files_archived_method`.	Texte	Non
`files_unarchived_size`	Ce mot-clé décrit la taille totale, en octets, de l'archive extraite. La valeur est utilisée pour vérifier la taille du système de fichiers.	Numérique	Non

Les mots-clés figurant ci-dessous fournissent des informations concernant l'ensemble de l'archive. Ils servent généralement d'aide lors de la sélection de l'archive et pour sa gestion. Ces mots-clés, tous facultatifs, vous permettent de distinguer les archives individuelles. Utilisez les options de la commande flar create pour inclure ces mots-clés (voir Exemple 21–12).

Tableau 23–5 Mots-clés de la section d'identification : archive décrite par l'utilisateur


Mots-clés	Définition des valeurs	Valeur	Requis
`creation_date`	La valeur de ce mot-clé est un horodateur textuel qui représente l'heure à laquelle vous avez créé l'archive. Vous pouvez utiliser la commande `flar create` avec l'option `-i` pour créer la date. Si vous ne spécifiez pas de date de création à l'aide de la commande `flar create`, la date se réfère par défaut au temps moyen de Greenwich (GMT). La valeur doit figurer dans le format complet du calendrier de base ISO-8601, sans unité (ISO-8601,§5.4.1(a)). Le format est `SSAAMMJJhhmmss`. Exemple : 20000131221409 représente le 31 janvier 2000, à 22 heures, 14 minutes et 9 secondes (heure GMT).	Texte	Non
`creation_master`	La valeur de ce mot-clé est le nom du système maître que vous avez utilisé pour créer l'archive. Vous pouvez utiliser l'option `flar create` `-m` pour créer cette valeur. Si vous ne spécifiez pas de valeur, celle-ci sera définie par la commande `uname -n`.	Texte	Non
`content_name`	Ce mot-clé identifie l'archive. La valeur est générée par l'option `flar create` `-n`. Pour créer cette valeur, respectez les directives suivantes : Le nom de description ne peut pas excéder 256 caractères. La description doit indiquer la fonction et le but de l'archive.	Texte	Oui
`content_type`	La valeur de ce mot-clé attribue une catégorie à l'archive. Utilisez l'option `flar create` `-T` pour générer cette valeur.	Texte	Non
`content_description`	La valeur de ce mot-clé décrit le contenu de l'archive et n'est pas limitée en longueur. Pour la créer, utilisez l'option `flar create` `-E`.	Texte	Non
`content_author`	La valeur de ce mot-clé identifie le créateur de l'archive. Pour la créer, utilisez l'option `flar create-a`. Nous vous suggérons d'utiliser le nom complet et l'adresse e-mail du créateur.	Texte	Non
`content_architectures`	La valeur de ce mot-clé est une liste des architectures de noyaux (séparées par des virgules) prises en charge par l'archive. Si ce mot-clé est présent, le logiciel d'installation valide l'architecture du noyau du système clone dans la liste des architectures que l'archive prend en charge. L'installation échoue si l'archive ne prend pas en charge l'architecture du noyau du système clone. Si ce mot-clé est absent, le logiciel d'installation ne valide pas l'architecture du noyau du système clone.	Liste de texte	Non

Les mots-clés figurant ci-dessous décrivent également l'archive dans son intégralité. Par défaut, les valeurs affichent uname quand l'archive flash est créée. Si vous créez une archive flash dans laquelle le répertoire racine n'est pas /, le logiciel d'archivage insère la chaîne UNKNOWN dans les mots-clés, excepté pour les mots-clés creation_node, creation_release et creation_os_name.

Pour creation_node, le logiciel utilise le contenu du fichier nodename.
Pour creation_release et creation_os_name, le logiciel tente d'utiliser le contenu du répertoire root /var/sadm/system/admin/INST_RELEASE. S'il ne parvient pas à lire ce fichier, il assigne la valeur UNKNOWN.

Quelle que soit leur source, vous ne pouvez pas remplacer les valeurs de ces mots-clés.

Tableau 23–6 Mots-clés de la section d'identification : archive décrite par le logiciel


Mot-clé	Valeur
`creation_node`	Retourné par `uname` `-n`
`creation_hardware_class`	Retourné par `uname` `-m`
`creation_platform`	Retourné par `uname` `-i`
`creation_processor`	Retourné par `uname` `-p`
`creation_release`	Retourné par`uname` `-r`
`creation_os_name`	Retourné par `uname` `-s`
`creation_os_version`	Retourné par `uname` `-v`

Mots-clés de la section utilisateur

Vous pouvez définir vos propres mots-clés, en sus de ceux définis par l'archive Solaris Flash. Solaris Flash ignore les mots-clés définis par l'utilisateur, mais vous pouvez formuler des scripts ou des programmes capables de traiter la section d'identification et d'utiliser ces mots-clés. Pour créer des mots-clés utilisateur, respectez le format suivant :

La première lettre du mot-clé doit être X.
Utilisez ensuite les caractères de votre choix, excepté le saut de ligne, le signe égal et les caractères nuls.
Les conventions d'attribution de noms suggèrent d'appliquer, pour les mots-clés utilisateur, la méthode de délimitation par tirets bas utilisée pour les mots-clés prédéfinis. Vous pouvez avoir recours à une autre convention fédérée similaire à celle qui est employée dans l'attribution de noms des packages Java.

Exemple : le mot-clé utilisateur X-department est correct.

L'Exemple 21–12 illustre l'utilisation d'options pour inclure des mots-clés utilisateur à la section d'identification.