Modification de l'IPD (swmodify)

SD-UX consigne les installations de logiciels, de produits et de groupes de fichiers sur le système à l'aide de la Base de données de produits installés (IPD) pour les logiciels installés et à l'aide des fichiers de catalogue pour les logiciels présents dans des dépôts.

Étant donné que l’IPD et les fichiers catalogues sont créés et constamment modifiés par d’autres opérations SD-UX (swinstall, swcopy et swremove), vous ne pouvez pas y accéder directement en vue d’en modifier le contenu. Ainsi, lorsque vous voulez modifier les informations contenues dans l’IPD ou les fichiers catalogues d’un dépôt, vous devez utiliser la commande swmodify.

La commande swmodify ajoute, modifie ou supprime les objets logiciels et/ou attributs définis dans un dépôt logiciel, ou un répertoire racine primaire ou secondaire. Il s’agit d’une interface directe avec les fichiers catalogues d’un dépôt ou la base de données des produits installés dans la racine. Il n’y a aucune modification des fichiers constituant l’objet, le traitement effectué ne portant que sur les informations de description de cet objet.

Avec swmodify, vous pouvez :

ajouter aux objets existants de nouveaux kits, produits, sous-produits, groupes de fichiers, scripts de commande ou définitions de fichiers
supprimer la description des objets logiciels d'un fichier de catalogue de dépôt ou d'une IPD racine
modifier les valeurs d'attribut d'un objet existant.
définir les attributs de nouveaux objets ajoutés.

Les fichiers équivalent aux IPD pour un dépôt sont appelés fichiers catalogues. Lorsqu’un dépôt est créé ou modifié au moyen de swcopy, le système crée des fichiers catalogues (par défaut dans /var/spool/sw/catalog) décrivant le dépôt et son contenu.

Contenu de l'IPD

Située dans le répertoire /var/adm/sw/products l’IPD est constituée d’une série de fichiers et de sous-répertoires contenant des informations diverses sur tous les produits installés dans le répertoire racine (/). Ces informations comprennent les “étiquettes” ou noms de produit, zones de titre sur une ligne, paragraphes de texte descriptif, longs fichiers README, informations de copyright, informations de fournisseur et numéros de référence pour chacun des produits installés. En outre, l’IPD contient des informations sur les versions et une zone architecture spécialement destinée à l’utilisateur et comprenant les quatre attributs uname (nom du système d’exploitation, édition, version et type de matériel). Voici comment se présente un fichier appelé INFO, contenu dans l’IPD et portant sur un produit appelé “Accounting” :

fileset tag ACCOUNTNG data_model_revision 2.4 instance_id 1 control_directory ACCOUNTNG size 292271 revision B.11.00 description Vendor Name: Hewlett-Packard Company Product Name: Accounting Fileset Name: ACCOUNTING Text: "HP-UX System Accounting feature set. Use these features to gather billing data for such items as disk space usage, connect time or CPU resource usage. " timestamp 797724879 install_date 199504121614.39 install_source hpfclc.fc.hp.com:/release/11.00_gsL/goodsystem state configured ancestor HPUX10.20.ACCOUNTNG corequisite OS-Core.CMDS-MIN,r>=B.11.00,a=HP-UX_B.11.00_32/64,fa=HP-UX_B.11.00_32/64,v=HP

Les fichiers catalogues sont semblables aux fichiers IPD à ceci près qu’ils sont destinés aux logiciels enregistrés dans un dépôt. Lorsque vous créez ou modifiez un dépôt à l’aide de la commande swcopy, ces fichiers sont créés et classés dans ce dépôt (ou dans le dépôt par défaut /var/spool/sw). Les fichiers catalogues décrivent le dépôt et son contenu.

Lorsqu'elles sont exécutées, les commandes swinstall, swconfig, swcopy et swremove mettent à jour, modifient et suppriment automatiquement les informations de l'IPD et des fichiers catalogue. Les commandes swlist et swverify lisent les informations de l'IPD et les utilisent pour modifier les réactions des commandes.

L’IPD possède aussi un fichier swlock qui permet de gérer simultanément les demandes de lecture et d’écriture dans des objets logiciels.

Utilisation de swmodify

Syntaxe

swmodify [-d] [-p] [-r] [-u] [-v [-V] [-a attribute=[valeur]]
[-c catalogue][-C fichier session] [-f fichier_logiciel]
[-P fichier_chemin_d'accès] [-s fichier_spécification_produit]
[-S fichier_session] [-x option=valeur][-X fichier_option]
[sélections_logiciels] [@ sélection_cible]

Options et opérandes

-d		Effectue des modifications dans un dépôt (pas dans un répertoire racine principal ni secondaire). Votre `sélection_cible` doit désigner un dépôt.
-p		Permet de prévisualiser une session de modification sans changer quoi que ce soit dans la `sélection_cible`.
-r		Effectue des modifications dans un répertoire racine secondaire (pas dans le répertoire racine principal). Votre `sélection_cible` doit désigner un répertoire racine secondaire.
-u		Si aucune option -a `attribut=valeur` n’est spécifiée, supprimez les `sélections_de_logiciels` dans votre `sélection_cible`. Cette action supprime les définitions des objets logiciels du catalogue de dépôt ou de la base de données des produits installés. En revanche, si vous spécifiez des options -a `attribut`, supprimez-les de la `sélection_cible` concernée.
-v		Active le mode prolixe sur la sortie standard (`stdout`). (Le fichier de consignation de swmodify n’est pas affecté par cette option.)
-V		Donne la liste de toutes les versions de SD spécifiées par la valeur `layout_versions` qui sont supportées par cette commande.
-a `attribut=valeur`
		Ajoute, modifie ou supprime la `valeur de l’attribut`. Sinon, ajoute/modifie l’attribut des `sélections_logiciels` en lui affectant une `valeur` donnée. Vous pouvez spécifier plusieurs options -a. Chaque modification d’attribut sera appliquée à toutes les `sélections_de_logiciels`. Les options -s et -a sont mutuellement exclusives : l’option -s ne peut être précisée lorsque l’option -a est spécifiée. L’option -a ne permet pas de modifier les attributs suivants : `tag`, `revision`, `instance_id`, `vendor_tag`, `corequisite` ou `prerequisite`.
-c `catalogue`		Écrit l'ensemble de la structure du catalogue dans le répertoire spécifié par le paramètre `catalogue`. Tous les attributs sont enregistrés jusqu'au niveau du fichier et des scripts de contrôle. Voir « Requêtes d'informations utilisateur (swask) ».
-C `fichier_session`
		Exécute la commande et sauvegarde les valeurs courantes de l'option et de l'opérande dans le fichier_session. Ces valeurs pourront être réutilisées dans une autre session. Voir « Fichiers session ».
-f `fichier_logiciel`
		Lit une liste de sélections de logiciels dans le fichier désigné en ignorant ou en complétant les indications de la ligne de commande. Voir « Fichiers de logiciels ».
-P `fichier_chemins_d'accès`
		Permet de spécifier un fichier contenant les chemins des fichiers à ajouter à l’IPD ou à supprimer de celle-ci.
-s `fichier_spécification_produit`
		Le fichier de spécification de produits (PSF) contient les définitions de produits, de sous-produits, de groupes de fichiers et/ou de fichiers à ajouter ou à modifier à l'aide de la commande swmodify. Si un `fichier_spécification_produit` (PSF) est spécifié, swmodify sélectionne chacune des `sélections_de_logiciels` spécifiées parmi le jeu complet défini dans le fichier PSF. Si vous n’avez pas spécifié de `sélections_de_logiciels`, swmodify sélectionnera tous les logiciels définis dans le PSF. Les objets d’un logiciel sélectionné à partir d’un fichier PSF sont ensuite ajoutés, modifiés ou supprimés dans la `sélection_cible`. Si aucun fichier PSF n’est précisé, vous devez spécifier les `logiciels` à sélectionner. swmodify choisit les `sélections_logiciels` parmi ceux définis dans la `sélection_cible` spécifiée (ou celle par défaut). Le fichier de spécification de produit (PSF) de swmodify utilise le même format PSF pour swpackage que celui défini dans « Création d’un fichier de spécification de produit (PSF) ».
-S `fichier_session`
		Exécute la commande avec les valeurs sauvegardées lors d’une session d’installation précédente et définies dans `fichier_session`. Voir « Fichiers session ».
-x `option=valeur`
		Initialise une `option` de commande à `valeur`. Cette valeur remplace la valeur par défaut ou celle sauvegardée dans le fichier options. Voir « Modification des options de commande ».
-X `fichier_options`
		Lit les options de session et les comportements dans `fichier_options`. Voir « Modification des options de commande ».
`sélections_logiciels`
		Les objets logiciels dont les informations vont être modifiées. Voir « Sélections de logiciels ».
`sélection_cible`		Une `sélection_cible` unique et locale. (Voir « Sélections de cible ».) Si vous faites des modifications dans le répertoire racine principal, vous n’avez pas besoin de préciser de `sélection_cible` puisque le système utilise par défaut le répertoire cible `/`. Si vous faites des modifications dans un dépôt de logiciels, la `sélection_cible` spécifie le chemin du dépôt. Si vous précisez l’option -d mais aucune `sélection_cible`, le système utilise par défaut le `répertoire_dépôt`.




	REMARQUE : D’une manière générale, vous devez être prudent si vous utilisez ensemble les options -u et -a. Si vous spécifiez -u et -a également, cette dernière -a supprimera l’`attribut` des `sélections_logiciels` concernées (ou supprimera la `valeur` de l’ensemble de valeurs affectées à l’`attribut`).

Modification des options de commande

Vous pouvez modifier le comportement de cette commande en précisant différentes options complémentaires de ligne de commande lorsque vous l'appelez (grâce à l'option -x) ou en lisant les valeurs prédéfinies dans un fichier. Le tableau suivant montre les valeurs et options par défaut de la commande swmodify.

Tableau 3-6 Options de commande et valeurs par défaut swverify

admin_directory=/var/adm/sw
compress_index=false
control_files=
distribution_target_directory= /var/spool/sw
files=
installed_software_catalog=products
layout_version=1.0
log_msgid=0
logdetail=false

logfile=/var/adm/sw/swmodify.log
loglevel=1
patch_commit=false
run_as_superuser=true
software=
source_file=
targets=
verbose=1

Informations connexes

Reportez-vous à l’Annexe A, « Options des commandes » pour obtenir la liste complète et la description de ces valeurs par défaut.

Tâches et exemples swmodify

Voici quelques exemples d’utilisation de la commande swmodify pour modifier des fichiers catalogues ou des IPD :

Ajout d'informations à l'IPD

Pour ajouter les descriptions de fichiers /tmp/a, /tmp/b et /tmp/c à un groupe de fichiers existant :

swmodify -x files=/tmp/a /tmp/b /tmp/c PRODUIT.GROUPEFICH

Si un script de commande ajoute de nouveaux fichiers au système de fichiers installé, il peut utiliser swmodify pour en consigner la création.

Modification des informations d'IPD existantes

Pour créer des définitions d’un nouveau kit pour des produits contenus dans un dépôt existant, tapez :

swmodify -d -s nouv_définitions_kit \
\* @ /mfg/master_depot

Si un produit fournit un processus de configuration plus complexe, il se peut qu’il fasse appel à un script pour définir l’état du groupe de fichiers à configured lorsque le processus se termine normalement.

Pour modifier les valeurs des attributs d’un groupe de fichiers, tapez :

swmodify -a state=installed PRODUIT.GROUPEFICH

Pour modifier les attributs d’un dépôt, tapez :

swmodify -a title=Master Depot \
-a description=/tmp/mfg.description \
@ /mfg/master_depot

Définition de nouveaux objets

Vous pouvez importer une application existante (non installée par SD-UX) en créant un fichier de spécification de produits (PSF) simple décrivant le produit, puis en exécutant swmodify pour charger cette définition dans l’IPD.

Pour créer une définition d’un nouveau groupe de fichiers (si le fichier PSF contient des définitions de fichiers, ajoutez ces fichiers au nouveau groupe de fichiers) :

swmodify -s nouv_définitions_groupefich