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 attribut=[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_options] 
[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 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. 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_chemin_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élection 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 définissant des options de ligne de commande supplémentaires lors de l'appel (en utilisant l'option -x) ou en lisant des valeurs prédéfinies dans un fichier. Le tableau suivant montre les valeurs et options par défaut de la commande swmodify.

Tableau 3-7 Options de commande et valeurs par défaut swmodify

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

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

Informations connexes

Reportez-vous à l'Annexe A 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.GRP_FICHIERS

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.GRP_FICHIERS

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_grp_fichiers