Configuration de l’installation (swconfig)

La commande swconfig vous permet de configurer, de déconfigurer et de reconfigurer des produits logiciels installés sur un hôte local, en exécutant un script de configuration spécial. Ces scripts sont uniquement exécutés sur l’hôte sur lequel tournera le logiciel. Un groupe de fichiers peut également inclure un script de déconfiguration permettant d’annuler une configuration. Pour plus de détails sur les scripts, voir le Chapitre 11, « Utilisation des scripts de commande ».

La (dé)configuration est normalement exécutée dans le cadre des commandes swinstall et swremove. Cependant, la commande swconfig permet d’effectuer une configuration indépendamment de ces commandes. Ainsi, elle permet de configurer ou de déconfigurer des hôtes partageant les logiciels installés sur un autre hôte. swconfig est en outre utile lorsque la configuration a échoué, qu’elle a été différée ou qu’elle doit être modifiée.

La commande swconfig peut être exécutée uniquement à partir de l’interface ligne de commande. Aucune interface utilisateur graphique ou caractère n’est offerte pour cette commande.

La commande swconfig offre les fonctions suivantes :

Elle configure l’hôte sur lequel le logiciel sera exécuté. Un groupe de fichiers peut inclure un script de configuration permettant d’exécuter ces actions sur l’hôte.
La commande swconfig permet aussi au logiciel de déconfigurer l’hôte sur lequel il ne s’exécutera plus. En d’autres termes, un groupe de fichiers peut inclure un script de déconfiguration qui annulera les actions du script de configuration.
Les scripts de configuration et de déconfiguration sont généralement exécutés par swinstall et swremove respectivement. Ils ne sont toutefois pas exécutés lorsqu’un répertoire racine secondaire est spécifié. Vous devez plutôt utiliser la commande swconfig après que ce logiciel a été mis à la disposition des hôtes clients, en vue de configurer ces derniers. De la même manière, vous devez exécuter swconfig sur les hôtes clients pour les déconfigurer.
La configuration automatique peut également être différée pour les logiciels installés dans le répertoire racine / (par exemple, lorsque vous installez des versions multiples), à l’aide de l’option par défaut defer_configure.
Elle supporte uniquement la configuration de logiciels compatibles, régie par l’option par défaut allow_incompatible.
Si le fonctionnement d’un groupe de fichiers dépend d’un autre produit logiciel, ce dernier doit avoir l’état configured et est régi par l’option enforce_dependencies.
swconfig configure une seule version à la fois d’un groupe de fichiers, en fonction de l’option par défaut allow_multiple_versions.
Par défaut, lorsque la commande swinstall installe un logiciel à partir d’un répertoire racine /, elle configure également ce logiciel (régi par l’option par défaut defer_configuration). Le logiciel ne peut pas être configuré à partir d’un répertoire racine secondaire (c’est-à-dire que le répertoire racine secondaire doit devenir le répertoire racine principal d’un hôte avant que le logiciel puisse être configuré).
Le script de configuration d’un fournisseur peut être utile pour exécuter les opérations requises dans les mises à jour de logiciels, comme c’est le cas pour les nouvelles installations. Le script doit également être en mesure de faire de nouvelles installations, et doit essayer de concevoir un processus approprié pour le contrôle des erreurs, si des données risquent d’être détruites lors de l’installation de versions plus anciennes.
swconfig effectue une analyse afin de déterminer si le logiciel demandé existe, qu’il est dans l’état approprié (installed) et que les prérequis sont (ou peuvent être) satisfaits.
swconfig fait passer les logiciels de l’état “installed” à “configured”.




	REMARQUE : Si un groupe de fichiers de réamorçage est inclus dans la session swinstall (comme lors de la mise à jour du système d’exploitation (CORE) HP-UX à une nouvelle version), les scripts de configuration sont exécutés avec les processus de démarrage après le réamorçage du système.

Syntaxe

La syntaxe de swconfig est la suivante :

swconfig [-p][-u][-v][-c catalogue] [-C fichier_session]
[-f fichier_logiciel] [-S fichier_session] [-t fichier_cible]
[-x option=valeur] [-X fichier_options]
[sélection_de_logiciels] [@ sélection_cible]

Exemples de configuration

Pour configurer le produitA, situé dans le dépôt par défaut sur l’hôte local, tapez la commande suivante :

swconfig produitA

Pour déconfigurer les sélections de logiciels dans le fichier logiciel qui sont installés dans le répertoire par défaut de l’hôte local, tapez la commande suivante :

swconfig -u -f logiciel

Pour reconfigurer le produit Omniback à l’aide de l’option par défaut, tapez :

swconfig -x reconfigure=true Omniback

Pour configurer une version précise d’Omniback, tapez :

swconfig Omniback,r=2.0

Pour configurer les produits C et Pascal sur l’hôte local :

swconfig cc pascal

Pour configurer Product1, utiliser les fichiers de réponse, s’il en existe, générés par un script de requête, et sauvegarder les fichiers de réponse dans /tmp/resp1:

swconfig -x ask=true -c /tmp/resp1 Product1

Pour reconfigurer le produit HP Omniback :

swconfig -x reconfigure=true Omniback

Pour configurer la version d’HP Omniback installée dans /opt/Omniback_v2.0 :

swconfig Omniback,l=/opt/Omniback_v2.0

Pour déconfigurer les sélections_logiciels répertoriées dans le fichier /tmp/install.products sur les hôtes figurant dans le fichier /tmp/install.hosts :

swconfig -u -f /tmp/install.products \
-t /tmp/install.hosts

Options de la commande

La commande swconfig supporte les options suivantes. (A l’exception de l’option -u, toutes les options de swconfig sont un sous-ensemble de celles de swinstall.)

Option		Description
-p		Vous pouvez prévisualiser une tâche de configuration à partir de la ligne de commande en l’exécutant en phase d’analyse. Cette option, que vous pouvez combiner à toutes les autres options, permet de comprendre l’effet d’une commande avant que le système ne l’exécute.
-u		Fait en sorte que swconfig déconfigure le logiciel au lieu de le configurer.
-v		Transfère les résultats en mode prolixe vers stdout et affiche à l’écran toutes les activités. Cette option vous permet de voir les résultats de la commande en cours d’exécution.
-c `catalogue`		Indique le chemin d’accès d’un catalogue exporté, contenant les copies du ou des fichier(s) de réponse créé(s) par un script de requête (si -x ask=as_needed ou -x ask=true). Les fichiers de réponse sont également enregistrés dans la base de données des produits installés.
-C `fichier_session`
		Exécute la commande et sauvegarde dans un fichier les valeurs courantes d’option et d’opérande pour une réutilisation lors d’une session ultérieure.
-f `fichier_logiciel`
		Plutôt que d’entrer vos sélections de logiciels sur la ligne de commande, vous pouvez spécifier le nom d’un fichier contenant la liste des logiciels désirés. Dans ce fichier, les lignes blanches et les lignes commençant par le signe # (commentaire) ne sont pas prises en compte. Vous devez indiquer chaque sélection sur une ligne. Pour obtenir un exemple de fichier de sélections de logiciels, reportez-vous à la section « Opérandes des commandes ».
-S `fichier_session`
		Exécute la commande à partir des valeurs sauvegardées lors d’une session précédente.
-t `fichier_cible`		Spécifie des répertoires racines partagés multiples sur l’hôte local. L’option -t extrait une liste de ces cibles dans un fichier séparé au lieu de les lire à partir de la ligne de commande.
-x `option=valeur`		Spécifie une valeur ayant préséance sur une valeur par défaut ou une valeur contenue dans un fichier d’options (voir l’option -X `fichier_options`). Reportez-vous à la section « Modification des options par défaut » pour obtenir plus de détails sur la modification de valeurs par défaut.
-X `fichier_options`
		Spécifie un nouveau fichier d’options. Les valeurs par défaut des options système sont contenues dans le fichier `/var/adm/sw/defaults`. Vous pouvez également préciser un fichier d’options personnelles, soit `$HOME/.swdefaults`. Les valeurs contenues dans ce fichier d’options ont priorité sur les valeurs figurant dans le fichier des valeurs par défaut du système. Pour obtenir la liste complète des options système, consultez le fichier `/usr/lib/sw/sys.defaults`. Il contient toutes les valeurs et tous les comportements possibles pour chaque option de chaque commande. Reportez-vous à l’Annexe A, « Options et mots clés par défaut » pour obtenir la liste complète et la description de ces valeurs par défaut.

Opérandes de la commande

La commande swconfig accepte la syntaxe standard des sélections_logiciels. Pour obtenir plus de détails sur la syntaxe de sélections de logiciels et un exemple de fichier de sélections de logiciels, reportez-vous à la section « Sélections de logiciels ».

Modification des options par défaut

Outre l’option de ligne de commande précisée précédemment, vous pouvez également changer plusieurs comportements et options, en modifiant les valeurs par défaut et d’option étendue se trouvant dans le fichier des valeurs par défaut /var/adm/sw/defaults.

ou dans le fichier des valeurs par défaut spécifique à l’utilisateur :

$HOME/.swdefaults

Les valeurs de ces fichiers sont spécifiées selon la syntaxe commande.option=valeur. Par exemple:

swconfig.agent_auto_exit=true

Tableau 3-1 Configuration des options par défaut

agent_auto_exit=true	logdetail=false
agent_timeout_minutes=10000	logfile=/var/adm/sw/swconfig.log
allow_incompatible=false	loglevel=1
allow_multiple_versions=false	mount_all_filesystems=true
ask=false	reconfigure=false
autoremove_job=false	rpc_binding_info=ncacn_ip_tcp:2121 ncadg_ip_udp:[2121]
autoselect_dependencies=true	rpc_timeout=5
autoselect_dependents=false	select_local=true
controller_source=	software=
enforce_dependencies=true	targets=
job_title=	verbose=1
log_msgid=0	write_remote_files=false

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

Utilisation des fichiers session

Chaque appel à la commande swconfig définit une session de configuration. Les options d’appel, la source d’informations, les sélections de logiciels et les hôtes cibles de cette session sont sauvegardés avant le démarrage de la tâche d’installation ou de copie. Ceci vous permet d’exécuter de nouveau la commande lorsque la session est interrompue avant la fin.

Chaque configuration de session est automatiquement sauvegardée dans le fichier : $HOME/.sw/sessions/swconfig.last. Ce fichier est écrasé à chaque appel de swconfig.

Vous pouvez sauvegarder une configuration de session dans un fichier donné en exécutant swconfig avec l’option -C fichier_session.

Si vous ne précisez pas de chemin particulier pour le fichier session, son emplacement par défaut sera $HOME/.sw/sessions/.

Pour exécuter à nouveau un fichier session, désignez-le comme argument de l’option -S fichier_session de swconfig.

Notez que lorsque vous exécutez de nouveau un fichier session, les valeurs du fichier session ont préséance sur les valeurs du fichier des valeurs par défaut du système. De la même manière, toutes les options ou les paramètres de la ligne de commande que vous avez donnés en appelant swconfig ont préséance sur les valeurs figurant dans le fichier session.

Variables d’environnement

Les programmes SD sont affectés par les variables d’environnement extérieures et celles définies à l’usage des scripts de commande. Pour une description des variables d’environnement externes, voir le Chapitre 11, « Utilisation des scripts de commande ».

Processus de configuration

Le processus de configuration se divise en trois phases :

La phase de sélection, au cours de laquelle l’hôte local interprète la liste des logiciels à configurer ;
La phase d’analyse, au cours de laquelle le processus s’assure que le logiciel sélectionné peut être configuré correctement (existence, prérequis, etc.) ;
La phase de configuration (configuration réelle du logiciel), au cours de laquelle les scripts de configuration ou de déconfiguration sont exécutés et l’état du logiciel passe de “installed” à “configured” (ou “unconfigured”).

Phase de sélection

Pour obtenir des informations complètes sur la façon de lancer une session, de spécifier des hôtes, de sélectionner des logiciels et de spécifier des produits, reportez-vous au Chapitre 2, « Installation et copie de logiciels ».

Phase d’analyse

Cette phase se déroule sur l’hôte local, avant le chargement des fichiers. Elle exécute des vérifications en vue de déterminer si l’installation doit avoir lieu ou non. La phase de chargement ne peut être amorcée si des erreurs surviennent durant la phase d’analyse.




	REMARQUE : Aucun aspect de l’environnement de l’hôte local n’est changé (sauf là où cela est indiqué) au cours de cette phase. L’exécution de l’option de “prévisualisation” (-p) sur ces tâches n’aura aucun effet négatif.

Vous pouvez exécuter l’option de prévisualisation pour vérifier s’il y a des erreurs ou des avertissements. Vous pouvez également, à ce stade, revenir à la phase de sélection et modifier vos choix. Si des erreurs surviennent à la phase d’analyse, seuls les produits pour lesquels des erreurs ont été décelées seront exclus. Si le système émet uniquement des Avertissements, la tâche se poursuit.

La séquence des tâches d’analyse sur l’hôte est la suivante :

Lancer l’analyse.
Traiter les sélections de logiciels.
Le système obtient des informations de la base de données des produits installés et vérifie la compatibilité.
Il s’assure que tous les logiciels sont compatibles avec les attributs uname de l’hôte. Cette vérification est régie par l’option par défaut allow_incompatible. Si cette option est définie à “false”, le système donne un message d’erreur ; en revanche, si elle est définie à “true”, il émet un avertissement.
Vérifier l’état des versions actuellement installées.
Si le produit n’existe pas ou si son état est “corrupt”, la tâche génère un message d’erreur indiquant que le produit ne peut pas être configuré, et qu’il faut utiliser swinstall pour l’installer et le configurer.
Si les versions actuellement installées n’ont pas l’état “configured” et si l’option -u est définie (déconfiguration), le système émet un message indiquant que le fichier ou le groupe de fichiers sélectionné est déjà déconfiguré.
Si les versions actuellement installées ont l’état “configured” (et que l’on procède à la configuration), l’option de reconfiguration aura un effet sur la vérification. Le système produit un message indiquant que le groupe de fichiers est déjà configuré et qu’il sera (reconfigure=true) ou ne sera pas (reconfigure=false) reconfiguré.
Vérifier si une autre version peut être configurée.
Cette vérification est régie par l’option allow_multiple_versions. Si cette option est définie à “false”, le système génère une erreur indiquant qu’une autre version de ce produit est déjà configurée et que le groupe de fichiers ne sera pas configuré. En revanche, si elle est définie à “true”, la deuxième version sera également configurée.
Vérifier les états de dépendances requis.
Le système émet une erreur ou un avertissement si une dépendance ne peut être satisfaite. Cette fonction est régie par l’option enforce_dependencies. Si cette option est définie à “true”, le groupe de fichiers ne sera pas configuré. En revanche, si elle est définie à “false”, le groupe de fichiers sera tout de même configuré.
Si un produit est prérequis, il est probable que la configuration échoue.
Si un produit est corequis, il est probable que la configuration de ce groupe de fichiers réussisse, mais il se peut que le produit ne puisse pas être utilisé tant que le produit corequis n’est pas installé et configuré.

Phase de configuration

La phase de configuration, qui se déroule sur l’hôte local, s’amorce une fois que les sélections ont subi la phase d’analyse.

La séquence des tâches de configuration est indiquée ci-après. Les produits sont classés par ordre de dépendances de prérequis, le cas échéant. Les opérations portant sur les groupes de fichiers sont aussi classées dans cet ordre.

(Dé)configurer chacun des produits.
Exécuter le script de (dé)configuration de chaque groupe de fichiers.
Modifier l’état de la base de données des produits installés pour “installed” ou “configured”.

Exécution des scripts de configuration

Au cours de cette phase, swconfig exécute les scripts de configuration ou de déconfiguration du fournisseur. Les tâches de configuration visent à configurer l’hôte pour le logiciel qu’il recevra et à configurer le produit pour qu’il contienne des informations spécifiques à l’hôte. Par exemple, il se peut qu’un logiciel doive changer la définition du fichier .rc de l’hôte ou l’environnement par défaut défini dans /etc/profile. Il se peut que vous deviez vous assurer que les mots de passe appropriés sont définis pour cet hôte ou encore effectuer certaines compilations. La déconfiguration exécute ces étapes dans l’ordre inverse.

Les scripts sont exécutés, et les valeurs de retour sont vérifiées.
Si une erreur survient, le groupe de fichiers demeure à l’état “installed”. Si un avertissement est émis, le groupe de fichiers sera tout de même configuré.
Les scripts sont exécutés par ordre de prérequis.

Les scripts de configuration sont également soumis à des lignes directrices spécifiques. Par exemple, ils sont exécutés uniquement sur l’hôte sur lequel le logiciel tournera ; par conséquent, ils ne sont pas aussi restrictifs que les scripts de personnalisation. Les scripts de configuration et de déconfiguration ne sont pas interactifs, à l’exception des scripts de requête.

Pour plus de détails sur les scripts, voir le Chapitre 11, « Utilisation des scripts de commande ».