Commande installp

Objectif

Installe les produits logiciels disponibles dans un module d'installation compatible.

Syntaxe

Installer avec Apply Only ou avec Apply and Commit

installp [ -R path ] [ -a | -a -c [ -N ] ] [ -e LogFile ] [ -V Number ] [ -d Device ] [ -E ] [ -Y ] [ -b ] [ -S ] [ -B ] [ -D ] [  -I ] [ -p ] [ -Q ] [ -q ] [  -v ] [  -X ] [ -F | -g ] [ -O { [ r ] [ s ] [ u ] } ] [ -t  SaveDirectory ] [ -w ] [ -z BlockSize ] { FilesetName [ Level ]... | -f ListFile | all }

Engager des mises à jour appliquées

installp [ -R path ] -c [ -e LogFile ] [ -V Number ] [ -b ] [  -g ] [ -p ] [  -v ] [ -X ] [ -O { [ r ] [ s ] [ u ] } ] [ -w ] { FilesetName [ Level ]... | -f ListFile | all } 

Rejeter les mises à jour demandées

installp [ -R path ] -r [ -e LogFile ] [ -V Number ] [ -b ] [ -g ] [ -p ] [ -v ] [ -X ] [ -O { [ r ] [ s ] [ u ] } ] [ -w ] { FilesetName [ Level ]... | -f ListFile } 

Pour désinstaller (supprimer) un logiciel installé

installp [ -R path ] -u [ -e LogFile ] [ -V Number ] [ -b ] [ -g ] [ -p ] [ -v ] [ -X ] [ -O { [ r ] [ s ] [ u ] } ] [ -w ] { FilesetName [ Level ]... | -f ListFile } 

Pour nettoyer une installation qui a échoué

installp [ -R  path ] -C [ -b ] [ -e LogFile ] 

Liste de tous les logiciels installables sur le support

installp { -l | -L } [ -e LogFile ] [ -d  Device ] [ -B ] [  -I ] [ -q ] [-E ] [ -z BlockSize ] [ -O { [ s ] [ u ] } ] 

Pour dresser la liste de tous les problèmes signalés par les clients et corrigés par le logiciel ou pour afficher toutes les informations supplémentaires

installp { -A| -i } [ -e LogFile ] [ -d Device ] [ -B ] [ -I ] [ -q ] [ -z BlockSize ] [ -O { [ s ] [ u ] } ] { FilesetName [ Level ]... | -f ListFile | all } 

Liste des mises à jour installées qui sont appliquées mais non validées

installp -s [ -e LogFile ] [ -O { [ r ] [ s ] [ u ] } ] [ -w ] { FilesetName [ Level ]... | -f ListFile | all }

Liste des logiciels installables spécifiques à la plate-forme sur le support

installp { -l | -L } { -M Platform } [ -e LogFile ] [ -d Device ] [ -B ] [ -I ] [ -q ] [ -z BlockSize ] [ -O { [ s ] [ u ] } ]

Valider la signature du logiciel

installp -G -d Device { FilesetName [ Level ]... | -f ListFile | all }

Descriptif

La commande " installp permet d'installer et de mettre à jour des logiciels.

Un ensemble de fichiers est l'unité de base installable la plus basse. Par exemple, " bos.net.tcp.client 4.1.0.0 est un jeu de fichiers. Une mise à jour de l'ensemble de fichiers est une image avec un niveau de modification différent ou un niveau de correctif différent. Par exemple, " bos.net.tcp.client 4.1.0.2 et " bos.net.tcp.client 4.1.1.0 sont tous deux des mises à jour de jeux de fichiers pour " bos.net.tcp.client 4.1.0.0.

Lorsqu'un niveau de base (ensemble de fichiers) est installé sur le système, il est automatiquement validé. Vous pouvez supprimer un ensemble de fichiers quel que soit l'état (tel que validé, rompu, validé avec des mises à jour appliquées et validé avec des mises à jour validées).

Lorsqu'une mise à jour de l'ensemble de fichiers est appliquée au système, la mise à jour est installée. Lors de l'installation, la version actuelle de ce logiciel est sauvegardée dans un répertoire spécial sur le disque, de sorte que vous puissiez revenir à cette version ultérieurement si nécessaire. Lorsqu'une nouvelle version d'un produit logiciel est appliquée au système, cette version devient la version active du logiciel.

Les mises à jour appliquées au système peuvent être validées ou rejetées ultérieurement. La commande 'installp -s peut être utilisée pour obtenir une liste des mises à jour appliquées qui peuvent être validées ou rejetées.

Lorsqu'un niveau de base est supprimé à l'aide de l'indicateur '-u, les fichiers qui font partie du produit logiciel et toutes ses mises à jour sont supprimés du système. La plupart des informations de configuration du système relatives au produit sont également nettoyées, mais le nettoyage dépend du produit et n'est pas toujours complet.

Lorsqu'une mise à jour d'un produit logiciel est rejetée avec l'indicateur " -r, la version actuelle du produit logiciel est remplacée par la version précédente immédiate de la mise à jour. Les fichiers enregistrés pour la mise à jour rejetée et toutes les mises à jour appliquées sont supprimés du système.

Un produit logiciel qui doit être supprimé du système peut être dans n'importe quel état. Les mises à jour de produits peuvent être à l'état appliqué ou engagé, et elles sont également supprimées.

Si une installation précédemment interrompue laisse un logiciel dans un état d'application ou d'engagement, il est nécessaire de procéder à un nettoyage à l'aide de l'indicateur " -C avant toute nouvelle installation. Bien que la commande " installp -C accepte les noms de produits logiciels sur la ligne de commande sans renvoyer d'erreur, une tentative est toujours faite pour nettoyer tous les produits lorsque l'indicateur " -C est utilisé. Une tentative de nettoyage des installations incomplètes est effectuée en supprimant les parties précédemment terminées. Une tentative est également effectuée pour revenir à la version précédente du logiciel, s'il en existe une, en tant que version actuellement active. Si le produit logiciel ne peut pas être ramené à la version précédente, il est marqué comme cassé et des résultats imprévisibles peuvent se produire si l'utilisateur tente de l'utiliser. Par conséquent, il est conseillé à l'utilisateur de réinstaller tous les produits logiciels romés ou les mises à jour.

L'indicateur " -t spécifie un autre emplacement pour un répertoire de sauvegarde contenant les fichiers qui sont remplacés par une mise à jour. Cette option est principalement utile dans les deux cas suivants.

• Si vous disposez de suffisamment d'espace disque local pour enregistrer les fichiers remplacés, mais que vous ne souhaitez pas étendre de manière permanente les systèmes de fichiers root et '/usr

  Dans ce cas, vous pouvez choisir de créer un système de fichiers distinct pour le répertoire de sauvegarde de remplacement. Lorsque vous êtes satisfait du système mis à jour et que toutes les mises à jour appliquées sont validées, vous pouvez récupérer de l'espace disque en supprimant le système de fichiers de sauvegarde.

• Vous ne disposez pas de suffisamment d'espace disque local pour enregistrer les fichiers remplacés, mais vous avez accès à un espace disque suffisant sur un système distant. Dans ce cas, vous pouvez spécifier un répertoire monté à partir d'un système de fichiers distant.

  Si un système de fichiers distant est utilisé, valider les mises à jour dès que possible. Vous pouvez vouloir lancer l'action d'installation en tant qu'opération " apply et " commit avec les drapeaux " -ac. Si vous voulez " apply uniquement pour pouvoir rejeter les mises à jour non désirées, testez les mises à jour nouvellement installées dès que possible, puis validez-les ou rejetez-les.

  Prenez en compte les considérations suivantes lors de l'utilisation d'un autre répertoire de sauvegarde:

• Il est recommandé d'utiliser le même emplacement de sauvegarde alternatif à chaque invocation de la commande " installp.
• Si un autre répertoire de sauvegarde est utilisé pour une opération d'application, assurez-vous que le système de fichiers qui contient ce répertoire reste monté. Il est fortement recommandé que les montages nécessaires soient effectués automatiquement lors d'un réamorçage.
• Si un autre répertoire de sauvegarde est manquant dans une opération de validation, la validation a lieu, un avertissement indiquant que le répertoire de sauvegarde n'a pas pu être supprimé. Dans ce cas, vous devez supprimer les répertoires sauvegardés qui ne sont plus utilisés afin de récupérer cet espace disque.
• Si un autre répertoire de sauvegarde est manquant sur le rejet, l'opération de rejet ne peut pas être effectuée car les fichiers sauvegardés sont manquants. Une erreur est générée et l'ensemble de l'opération de rejet est annulé. Si le répertoire de sauvegarde manquant n'est pas causé par une situation temporaire (par exemple, l'impossibilité de contacter un répertoire distant sur le réseau), vos seules options sont de valider les mises à jour ou de les laisser en permanence dans un état appliqué.
• Lors d'une sauvegarde système, veillez à sauvegarder les répertoires de sauvegarde de remplacement qui ne résident pas dans le groupe de volumes root.
• Le processus d'installation protège les utilisateurs d'un répertoire de sauvegarde distant contre la possibilité que deux systèmes différents utilisent le même répertoire distant. Cependant, utilisez des noms de chemin de répertoire qui identifient facilement et de manière unique le système de chaque utilisateur. Par exemple, vous pouvez ajouter le nom d'hôte du système dans le nom de chemin.
• Ne créez pas une sauvegarde " mksysb d'un système avec un répertoire de sauvegarde distant, puis essayez de restaurer l'image " mksysb sur un système autre que le système d'origine. Dans ce cas, l'utilisation d'une image " mksysb pour installer plusieurs systèmes similaires entraîne la possession multiple du même répertoire d'enregistrement à distance.

La commande 'installp -A peut être utilisée pour obtenir une liste des numéros de rapport d'analyse de programme autorisé (APAR) et des résumés de tous les problèmes signalés par les clients qui sont corrigés dans le progiciel spécifié. La commande 'installp -i peut être utilisée pour afficher des informations supplémentaires contenues dans des fichiers qui peuvent faire partie du progiciel spécifié.

Pour dresser la liste de tous les produits logiciels et de leurs mises à jour sur le support d'installation spécifié, utilisez la commande 'installp -l La sortie suivante ressemble à la sortie de la commande " installp avec l'indicateur " -l

# Fileset Name             Level                    I/U Q Content
#================================================================
  X11.adt.include          4.1.0.0                  I  N usr
#   AIX windows Application Development Toolkit Include F
   
  X11.adt.lib              4.1.0.0                  I  N usr
#   AIX windows Application Development Toolkit Libraries
#
  X11.adt.motif            4.1.0.0                  I  N usr
#    AIX windows Application Development Toolkit Motif
   
#
  X11.adt.bitmaps          4.1.0.0                  I  N usr
#    AIX windows Application Development Toolkit Bitmap Fi
   
#
  X11.adt.ext              4.1.0.0                  I  N usr
#    AIX windows Application Development Toolkit for X Ext
#
  X11.adt.imake            4.1.0.0                  I  N usr
#    AIX windows Application Development Toolkit imake
#
  X11.apps.rte             4.1.0.0                  I  N usr
#    AIX windows Runtime Configuration Applications
#
  X11.apps.msmit           4.1.0.0                  I  N usr
#    AIX windows msmit Application

Les descriptions de zones sont les suivantes:

La sortie de la commande " installp -s, qui est utilisée pour obtenir une liste des mises à jour de jeux de fichiers logiciels appliquées et des mises à jour qui sont disponibles pour être validées ou rejetées, ressemble à la sortie suivante :

Installp Status
---------------
Name                       Part    Level                     State
--------------------------------------------------------------------
bos.net.tcp.client         USR     4.1.0.2                   APPLIED
bos.net.tcp.client         ROOT    4.1.0.2                   APPLIED
bos.rte.commands           USR     4.1.0.1                   APPLIED
bos.rte.misc_cmds          USR     4.1.0.1                   APPLIED
bos.rte.tty                USR     4.1.0.1                   APPLIED

Les descriptions de zones sont les suivantes:

Les produits logiciels et les mises à jour à installer peuvent être identifiés de l'une des manières suivantes :

• En utilisant le mot-clé " all, qui indique que tous les logiciels contenus sur le support d'installation spécifié doivent être installés.
• En utilisant une liste de noms de produits logiciels, qui indique le logiciel à installer. Chaque nom de produit logiciel peut éventuellement être suivi d'un niveau.
• En utilisant l'indicateur " -f suivi d'un nom de fichier, où chaque ligne du fichier est une entrée qui contient le nom du produit logiciel, éventuellement suivi d'un niveau, ou est une ligne de commentaire qui commence par un # et qui est ignorée.
  Note : Le programme 'installp utilise la commande 'sysck pour vérifier les fichiers après les avoir restaurés. La commande 'sysck ' ne reconnaît pas les caractères spéciaux '~', '`, '', '\, '"', '$, '^', '&, '( )', '|, '{}', '[]', '<> et '? dans les noms de fichiers. Si le nom d'un fichier contient l'un de ces caractères, l'installation échoue.

Le paramètre FilesetName peut être utilisé pour spécifier un produit logiciel entier ou tout jeu de fichiers installable séparément dans le progiciel. Par exemple, " bos.net est le nom d'un progiciel, et les ensembles de fichiers installables séparément dans ce progiciel sont " bos.net.ncs.client, " bos.net.nfs.client et " bos.net.tcp.client. Si l'utilisateur spécifie " bos.net pour le paramètre FilesetName, tous les jeux de fichiers installables séparément qui sont répertoriés sont installés. Si l'utilisateur spécifie " bos.net.tcp.client pour le paramètre FilesetName, seul ce jeu de fichiers est installé.

Le paramètre Niveau indique le niveau du produit logiciel ou de la mise à jour à installer. Le paramètre Niveau est de la forme vv.rr.mmmm.ffff.

Si un utilisateur installe un paquet d'installation à partir d'un support d'installation qui ne contient que des paquets d'installation, il n'est pas nécessaire de spécifier le niveau. Il est rare qu'il y ait plus d'un paquet d'installation du produit logiciel avec des niveaux différents sur le même support d'installation. Cependant, lorsque cela se produit, " installp installe le produit logiciel spécifié au dernier niveau du produit logiciel lorsque Level n'est pas spécifié avec FilesetName. Pour les supports d'installation qui contiennent uniquement des paquets de mise à jour ou qui contiennent à la fois des paquets d'installation et de mise à jour, tous les paquets de mise à jour applicables qui sont présents sur le support d'installation pour le FilesetName spécifié sont également installés lorsque Level n'est pas spécifié. Pour les supports d'installation qui contiennent à la fois des paquets d'installation et de mise à jour, l'utilisateur peut demander l'installation des seuls paquets d'installation en utilisant l'indicateur " -I ou des seuls paquets de mise à jour en utilisant l'indicateur " -B Si l'utilisateur souhaite n'installer que certaines des mises à jour sur le support d'installation pour un produit logiciel spécifique, il doit spécifier le FilesetName et le Level pour chacune des mises à jour à installer pour ce produit logiciel.

Vous pouvez utiliser l'exemple suivant pour installer TCP/IP et l'une de ses mises à jour qui sont toutes deux contenues dans le répertoire '/usr/sys/inst.images

installp -a -d/usr/sys/inst.images bos.net.tcp.client 4.1.0.0
bos.net.tcp.client 4.1.0.2

Un rapport récapitulatif est fourni à la fin de la sortie " installp. Il indique l'état de chacun des produits logiciels qui devaient être installés. L'exemple suivant est un exemple de rapport récapitulatif pour la commande " installp précédente :

Installp Summary
----------------
Name                    Level        Part        Event        Result
--------------------------------------------------------------------
bos.net.tcp.client      4.1.0.0      USR        APPLY        SUCCESS
bos.net.tcp.client      4.1.0.0      ROOT       APPLY        SUCCESS
bos.net.tcp.client      4.1.0.2      USR        APPLY        SUCCESS

Valeurs du rapport récapitulatif

Le rapport récapitulatif identifie le nom de l'option de produit et la partie du produit. Parmi les autres informations fournies figurent l'action demandée (événement) et le résultat de cette action.

Valeurs des événements

La colonne Événement du rapport de synthèse identifie l'action demandée à la commande " installp. Les valeurs suivantes s'affichent dans cette colonne:

Tableau 4. Valeurs de l'événement

Evénement	Définition
APPLIQUER	Tentative d'application de l'ensemble de fichiers spécifié.
VALIDER	Une tentative de validation de la mise à jour de l'ensemble de fichiers spécifiée a été effectuée.
REJETER	Une tentative de rejet de la mise à jour de l'ensemble de fichiers spécifié a été effectuée.
NETTOYER	Tentative de nettoyage de l'ensemble de fichiers spécifié.
RETIRER	Une tentative de suppression de l'ensemble de fichiers spécifié a été effectuée.

Valeurs des résultats

La colonne Résultat du rapport récapitulatif indique le résultat de l'exécution de l'action demandée par le " installp. Elle peut comporter les valeurs suivantes :

Tableau 5. Valeurs du résultat

Résultat	Définition
SUCCESS	L'action spécifiée a abouti.
FAILED	L'action indiquée a échoué.
CANCELLED	Bien que la vérification de la préinstallation ait été transmise pour l'option spécifiée, il a été nécessaire d'annuler l'action spécifiée avant son début. Interrompre le processus d'installation avec Ctrl + c peut parfois provoquer une action annulée, bien que, en général, une interruption Ctrl + c entraîne des résultats imprévisibles.

Indicateurs

package:fileset:v.r.m.f:PTF:enter the following command:state:supersede:\
sup_ptf:sup_state:latest_sup:quiesce:Descr:\
netls_vendor_id:netls_prod_id:netls_prod_ver:relocatable:build date 

Statut de sortie

Un rapport récapitulatif est fourni à la fin de la sortie " installp. Il indique l'état de chacun des produits logiciels qui devaient être installés. Pour les produits logiciels qui n'ont pas pu être installés ou dont l'installation a échoué, l'utilisateur peut rechercher la cause dans les informations plus détaillées qui sont continuellement affichées à partir de la commande 'installp pendant le processus d'installation.

Security

Contrôle des privilèges

Seul l'utilisateur root peut exécuter cette commande.

Remarque :

Si la règle Trusted Execution (TE) est activée avec la règle TSD_LOCK ou la règle TSD_FILE_LOCK , la commande installp échoue. Pour continuer l'installation, désactivez manuellement la règle TSD_LOCK ou la règle TSD_FILE_LOCK . La commande installp s'exécute correctement avec les règles TE si la règle TSD_LOCK ou la règle TSD_FILE_LOCK n'est pas activée.

Utilisateurs RBAC

Attention aux utilisateurs RBAC: Cette commande peut effectuer des opérations privilégiées. Seuls les utilisateurs privilégiés peuvent exécuter des opérations privilégiées. Pour plus d'informations sur les autorisations et les privilèges, voir Base de données des commandes privilégiées dans Sécurité. Pour obtenir la liste des privilèges et des autorisations associés à cette commande, voir la commande 'lssecattr ou la sous-commande 'getcmdattr

Exemples

1. Pour dresser la liste de tous les produits logiciels et options installables contenus dans une cartouche d'installation, entrez la commande suivante :

   installp -L -d /dev/rmt0.1

2. Pour dresser la liste de tous les problèmes signalés par les clients et corrigés par tous les logiciels d'une bande d'installation, entrez la commande suivante :

   installp -A -d /dev/rmt0.1 all

3. Pour installer (engagement automatique) tous les jeux de fichiers du progiciel " bos.net (situé dans le répertoire " /usr/sys/inst.images ) et étendre les systèmes de fichiers si nécessaire, entrez la commande suivante :

   installp -aX -d/usr/sys/inst.images bos.net

4. Pour réinstaller et valider l'option du produit logiciel NFS qui est déjà installée sur le système au même niveau (à partir de la bande), entrez la commande suivante :

   installp -acF -d/dev/rmt0.1 bos.net.nfs.client 4.1.0.0

5. Pour installer (appliquer uniquement) certaines mises à jour contenues sur la disquette du logiciel TCP/IP, entrez la commande suivante :

   installp -a bos.net.tcp.client 4.1.0.2 bos.net.tcp.server 4.1.0.1

6. Pour supprimer un jeu de fichiers nommé " bos.net.tcp.server, entrez la commande suivante :

   installp -u bos.net.tcp.server

7. Pour spécifier un répertoire de stockage alternatif sur un système de fichiers distant pour une mise à jour BOSNET TCP/IP avec '-t/temp_space, entrez la commande suivante : .

   mount Server_Name:/Save_Area /temp_space
      
   installp -a -t /temp_space/My_Hostname  \ 
   bosnet.nfs.client 4.1.1.0

   Le répertoire de sauvegarde devient " /temp_space/My_Hostname/usr/lpp/bos.net/bos.net.nfs.client/4.1.1.0.save.

8. Pour capturer un fichier journal de toutes les sorties de la commande " installp, utilisez la commande " script comme dans l'exemple suivant. La sortie est écrite dans le fichier 'typescript du répertoire actuel.

   script
   installp ...
   <Ctrl>d

   ou

   installp ... 2>&1 | tee /tmp/inst.out

   Dans le second exemple, la sortie est écrite à l'écran et une copie est sauvegardée.
9. Pour prévisualiser l'installation du jeu de fichiers " bos.net.tcp.client à partir du CD à l'aide de la commande " installp, entrez la commande suivante :

    installp -pacgXd /dev/cd0 bos.net.tcp.client

10. Pour installer TCP/IP et l'une de ses mises à jour contenues dans le " /usr/sys/inst.images, utilisez la commande " installp comme dans l'exemple suivant.

    Un rapport récapitulatif est fourni à la fin de la sortie de la commande 'installp, qui répertorie l'état de chacun des produits logiciels à installer. L'exemple suivant est un exemple de rapport récapitulatif pour la commande " installp précédente :

    Installp Summary
    ----------------
    Name                 Level        Part       Event        Result
    -----------------------------------------------------------------
    bos.net.tcp.client   4.1.0.0      USR        APPLY        SUCCESS
    bos.net.tcp.client   4.1.0.0      ROOT       APPLY        SUCCESS
    bos.net.tcp.client   4.1.0.2      USR        APPLY        SUCCESS

    Remarque : ce résumé est également enregistré dans " /var/adm/sw/installp.summary jusqu'à la prochaine invocation de " installp Le fichier d'en-tête " inuerr.h du répertoire " /usr/include décrit les champs qui composent les enregistrements du fichier " installp.summary ".
11. Pour obtenir la liste des produits logiciels (situés dans le répertoire " /usr/sys/inst.images ) qui peuvent être installés sur des machines à processeur POWER, entrez la commande suivante :

    installp -l -MR -d /usr/sys/inst.images

12. Pour mettre à jour tous les jeux de fichiers d'un CD qui sont installés sur le système, entrez la commande suivante :

    lslpp -lc | awk -F ":" '{print $2}' | tail -n +2 > /tmp/lslpp
    installp -agXd /dev/cd0 -e /tmp/install.log -f /tmp/lslpp

    où le " -e enregistre la sortie dans le fichier " /tmp/install.log.
13. Pour valider la signature de tous les jeux de fichiers inclus dans le progiciel " bos.net, entrez la commande suivante :

    installp -Gd /usr/sys/inst.images bos.net

    Le progiciel " bos.net se trouve dans le répertoire " /usr/sys/inst.images

Fichiers