Arguments de ligne de commande d'Installation Manager

Utilisez le tableau suivant pour en savoir plus sur les arguments de ligne de commande d'IBM® Installation Manager.

Les arguments de ligne de commande sont constitués de commandes et d'options. Vous pouvez utiliser des commandes sans spécifier d'option. La plupart des commandes n'utilisent pas de tiret. Il existe plusieurs commandes qui commencent par un tiret pour des raisons de compatibilité descendante avec les versions antérieures d'Installation Manager. Vous devez spécifier une commande lors de l'utilisation d'une option. Les options commencent par un tiret.
Remarque : Les astérisques (*) ne peuvent pas être utilisés dans la ligne de commande d'Installation Manager. Si un astérisque est entré, l'erreur qui en découle identifie erronément check.properties comme un arguement non reconnu de la ligne de commande.

Le Tableau 1 contient la liste des commandes et le Tableau 2 contient la liste des options.

Commandes

Commandes Description
encryptString, eS <chaîne_à_chiffrer>
Chiffre la chaîne saisie. Utilisez encryptString avec -passwordKey pour augmenter la sécurité du chiffrement.

Dans l'interface utilisateur, la commande suivante ouvre la fenêtre String Encryption Utility : IBMIM encryptString mot_de_passemot_de_passe correspond à la chaîne chiffrée. Dans cette fenêtre String Encryption Utility, la zone String to be encrypted contient la chaîne à chiffrer. La zone Encrypted version of the string contient la valeur chiffrée à copier dans le fichier de réponses. Dans l'utilitaire de chiffrement de chaîne, vous pouvez modifier la zone String to be encrypted, puis cliquer sur OK pour générer une nouvelle chaîne chiffrée.

Dans l'interface de ligne de commande, la commande suivante renvoie la chaîne chiffrée sur la ligne de commande : IBMIM -noSplash -encryptString mot_de_passemot_de_passe correspond à la chaîne chiffrée.

Lors de l'enregistrement d'un fichier de réponses, les chaînes chiffrées des mots de passe sont créées et stockées dans le fichier de réponses, Exemple d'une chaîne chiffrée d'un fichier de réponses IBM Rational ClearCase :
<profile installLocation='C:Program Files\IBM\RationalSDLC' id="IBM Rational SDLC'>
<data key='user.CC_ServerProcessPassword,com.ibm.rational.clearcase.nt_i386' value='1ML/Coqkg33e5616BcUnYg=='
</profile>

Une fois le fichier de réponses enregistré, utilisez encryptString pour générer et coller différentes chaînes chiffrées dans le fichier de réponses. Par exemple, vous enregistrez un fichier de réponses. Vous devez installer un produit IBM sur cinq ordinateurs à l'aide de ce fichier de réponses. Chacun des cinq ordinateurs exige une valeur de mot de passe différente pour une clé de données du fichier de réponses. Avant de procéder à l'installation sur l'un des ordinateurs, générez la chaîne chiffrée pour le mot de passe à utiliser sur cet ordinateur. Copiez la chaîne chiffrée dans le fichier de réponses. Commencez l'installation en mode silencieux en utilisant le fichier de réponses mis à jour.

exportInstallData, eID <fichier_données_installation>
Exporte les données d'installation vers le fichier spécifié à un format .zip, où <fichier_données_installation> est le nom du fichier généré contenant les données exportées.
help, -help, -h, -? <commande>
Affiche une brève description des arguments de ligne de commande d'Installation Manager.

Pour des raisons de compatibilité descendante, cette commande peut être utilisée avec un tiret : -help.

input, -input <fichier_de_réponses> 
Indique un fichier de réponses XML comme entrée pour Installation Manager ou pour le programme d'installation d'Installation Manager. Le fichier de réponses contient des commandes qu'Installation Manager ou que le programme d'installation d'Installation Manager exécute.

Vous ne pouvez pas utiliser input avec installAll ou avec updateAll

Vous pouvez utiliser un chemin de fichier ou une adresse URL pour la valeur <fichier de réponses>. Ces exemples présentent des chemins de fichier et des chaînes d'adresse URL :
  • Chemin de fichier :
    • Windows : input C:\response_files\myresponsefile.xml
    • Linux and UNIX : input /response_files/myresponsefile.xml
  • URL : input http://server/response_files/myresponsefile.xml
Pour plus d'informations sur le stockage des données d'identification pour les adresses URL nécessitant une authentification, voir Stockage des données d'identification
A faire : Vous pouvez enregistrer un fichier de réponses, éditer un exemple de fichier de réponses ou créer manuellement un fichier de réponses.

Pour des raisons de compatibilité descendante, cette commande peut être utilisée avec un tiret : -input.

record, -record  <fichier_de_réponses>
Indique l'emplacement du fichier de réponses.

Pour des raisons de compatibilité descendante, cette commande peut être utilisée avec un tiret : -record.

saveCredential, sC   
-url <adresse> 
-userName <nom_utilisateur> userPassword < mot_de_passe> 
-keyring <fichier_de_clés> [-password <mot_de_passe>]  
[-proxyHost <hôte_de_proxy> -proxyPort <port> [-useSocks]]   
[-verbose] 
Sauvegarde les données d'identification spécifiées vers le fichier de clés.
Définition des arguments
  • keyring - Chemin d'accès complet du fichier de clés
  • password - Mot de passe utilisé pour ouvrir le fichier de clés
  • proxyHost - Nom d'hôte du serveur proxy
  • proxyPort - Port du serveur proxy
  • url - URL authentifiée
  • userName - Nom d'utilisateur
  • userPassword - Mot de passe de l'utilisateur
  • useSocks - Utiliser une connexion de proxy SOCKS
  • verbose - Affiche le contenu des données d'identification stockées dans le fichier de clés
version, -version
Imprime la version de l'application, puis se ferme.

Pour des raisons de compatibilité descendante, cette commande peut être utilisée avec un tiret : -version.

Options

Options Description
-accessRights, -aR <mode>

where mode=[admin, nonAdmin]

Définit si Installation Manager fonctionne en mode administrateur ou non administrateur. En mode non administrateur, utilisez l'argument —accessRights avec le paramètre nonAdmin : -accessRights nonAdmin. En mode administrateur, utilisez —accessRights avec le paramètre admin : -accessRights admin.
Si —accessRights n'est pas utilisé, la valeur par défaut est définie en fonction des droits de l'utilisateur en cours.
Remarque :
Pour les utilisateurs Microsoft® Windows® XP qui sont membres du groupe Administrateurs, la valeur par défaut est toujours -accessRights admin. Pour que ces utilisateurs puissent exécuter le mode non administrateur, spécifiez l'argument -accessRights nonAdmin de façon explicite.

Installation Manager signale une erreur lorsque l'utilisateur ne dispose pas des droits système appropriés.

Avertissement : Ne modifiez pas cet argument lors de l'installation, de la modification, de la mise à jour, de l'annulation ou de la désinstallation de cette même instance d'Installation Manager. Par exemple, User1 installe Installation Manager dans le répertoire C:\user1\InstallationManager avec des droits d'accès administrateur. Lors de l'exécution d'une commande pour modifier Installation Manager dans le répertoire C:\user1\InstallationManager, Utilisateur1 ne doit pas utiliser l'argument -accessRights nonAdmin.

Pour plus d'informations sur l'installation en tant qu'administrateur ou non administrateur, voir Installation en mode administrateur ou non administrateur.

-dataLocation, -dL <emplacement_données>
Indique l'emplacement du répertoire de données Installation Manager. Cet emplacement stocke des informations sur les packages installés. Définissez cet emplacement lors de l'installation d'Installation Manager.
Avertissement : Ne modifiez pas cet argument une fois Installation Manager installé. Sa modification risque d'endommager les données d'installation, ce qui peut empêcher toute modification, mise à jour, annulation ou désinstallation des packages installés.

Pour plus d'informations sur les types de fichier et d'informations stockés à l'emplacement des données de l'agent, voir Emplacement des données de l'agent.

-ignoreRepositoryDigest
Indique à Installation Manager d'ignorer le fichier de synthèse du référentiel, repository.xml, lors de l'accès aux référentiels. Le fichier repository.config est utilisé à la place.
-keyring <fichier> [-password <mot_de_passe>]
Si spécifié, indique à Eclipse de créer un fichier de clés s'il n'en existe pas déjà. L'argument -password <mot_de_passe> est facultatif. Si le mot de passe n'est pas spécifié, Eclipse utilise un mot de passe par défaut. Vous pouvez renforcer le chiffrement en spécifiant un mot de passe pour ouvrir le fichier de clés.

Le contenu de ce fichier de clés est chiffré. Vous devez disposer de droits en écriture pour le fichier de clés.

Installation Manager utilise l'infrastructure Eclipse pour enregistrer des données d'identification dans un fichier de clés. Pour plus d'informations sur les fichiers de clés, voir le manuel Eclipse workbench user's guide disponible sur http://www.eclipse.org.

--launcher.ini <fichier .ini>
Exemples :
  • --launcher.ini silent-install.ini
  • --launcher.ini silent-uninstall.ini
  • --launcher.ini user-silent-install.ini
  • --launcher.ini user-silent-uninstall.ini
Spécifie l'emplacement du fichier .ini du produit à utiliser. Si cet argument n'est pas spécifié, Installation Manager recherche un fichier dans le même répertoire que celui du programme de lancement ayant le même nom et l'extension ".ini". Par exemple, si installc est le programme de lancement, Installation Manager recherche installc.ini.

Le fichier silent-install.ini contient les paramètres d'initialisation pour l'installation en mode silencieux. Le fichier silent-install.ini se trouve dans le même répertoire que le fichier installc et doit être présent.

Le fichier user-silent-install.ini est utilisé pour une installation en mode non administrateur. Le fichier user-silent-uninstall.ini est utilisé pour une procédure de désinstallation en mode non administrateur.

Important : La version des fichiers silent-install.ini et user-silent-install.ini fournie dans les fichiers d'installation d'Installation Manager utilise l'argument de ligne de commande input. Pour utiliser installAll ou updateAll avec ces fichiers .ini, vous devez supprimer deux lignes : la ligne -input et la ligne pointant vers le fichier de réponses. Exemple des deux lignes à supprimer :
-input
@osgi.install.area\install.xml
Si la ligne -input et la ligne du fichier de réponses ne sont pas supprimées, les arguments de ligne de commande installAll et updateAll ne fonctionnent pas.

Les fichiers .ini du répertoire d'installation d'Installation Manager n'utilisent pas l'argument de ligne de commande -input.

Exemple d'un fichier silent-install.ini provenant des fichiers d'installation d'Installation Manager :
-toolId
isilentInstall				
-accessRights
admin
-vm
jre_5.0.4.sr11_20091106a\jre\bin\java.exe
-nosplash
--launcher.suppressErrors
-silent
-input
@osgi.install.area\install.xml
-vmargs
-Xquickstart
-Xgcpolicy:gencon
Exemple d'un fichier silent-install.ini provenant du répertoire d'Installation Manager :
-accessRights
admin
-vm
C:\Program Files\IBM\Installation Manager\eclipse\jre_5.0.3.sr8a_20080811b\jre\bin\java.exe
-nosplash
--launcher.suppressErrors
-silent
-vmargs
-Xquickstart
-Xgcpolicy:gencon

Si vous exécutez une commande utilisant l'argument -input et que le fichier .ini que vous utilisez contient également l'argument -input, le fichier de réponses spécifié par l'argument -input de la commande est utilisé. Le fichier de réponses spécifié par l'argument -input dans le fichier .ini est ignoré. Exemple d'une commande utilisant l'argument -input : ./install --launcher.ini silent-install.ini -input <nom et chemin d'accès du fichier en entrée>

--launcher.suppressErrors
Supprime la boîte de dialogue d'erreur de la machine virtuelle Java™ (JVM).
-log, -l <fichier_journal>
(Facultatif) Spécifie un fichier journal dans lequel sont enregistrés les résultats de l'installation en mode silencieux. Le fichier journal est un fichier XML.

Lorsque votre installation en mode silencieux se termine, le fichier journal contient l'élément racine <result> </result>. En revanche, si des erreurs se produisent lors de l'installation, le fichier journal de l'installation en mode silencieux contiendra des éléments d'erreur et des messages.

N'utilisez pas -log lors de l'enregistrement d'un fichier de réponses.

-mode wizard
Exécute l'assistant d'installation avec le fichier de réponses spécifié. Vous devez utiliser input lorsque vous utilisez -mode wizard.
-nosplash
Supprime l'écran d'accueil.
-passwordKey, -pK <clé_mot_de_passe>
Utilise <CléMotDePasse> pour chiffrer ou déchiffrer des mots de passe.
-showProgress, -sP
Affiche une barre de progression sur la console.
-showVerboseProgress, -sVP
Affiche un texte de progression sur la console. Par exemple, le texte Vous devez redémarrer votre ordinateur pour terminer l'installation s'affiche lorsque le redémarrage de l'ordinateur est nécessaire.
-silent, -s
  • -silent -installAll
  • -silent -updateAll
Indique que le programme d'installation d'Installation Manager ou Installation Manager est exécuté en mode silencieux.

Utilisez -silent -installAll pour installer tous les packages disponibles en mode silencieux.

Utilisez -silent -updateAll pour mettre à jour tous les packages installés en mode silencieux.

N'utilisez pas la commande input avec les commandes installAll et updateAll. Avec installAll, les fonctions par défaut d'un package sont installées. Pour spécifier les fonctions à installer, vous devez utiliser input <fichier_de_réponses>. Le fichier de réponses contient des informations relatives aux fonctions à installer.
Remarque : Lors de l'enregistrement d'un fichier de réponses, vous pouvez sélectionner les fonctions à installer.
-skipInstall, -sI <emplacement_données>
Enregistre un fichier de réponses sans installer le produit IBM. La valeur emplacement_données indique l'emplacement du répertoire contenant les dossiers et les fichiers d'installation. Bien que le produit IBM ne soit pas installé, les fichiers et dossiers requis pour l'installation sont créés et stockés dans le répertoire spécifié. Le répertoire doit être inscriptible.

Vérifiez que le chemin de fichier existe dans l'argument. Installation Manager ne crée pas de répertoires pour des fichiers de réponses.

Avertissement : Ne spécifiez pas de répertoire emplacement_données existant pour la nouvelle valeur d'emplacement emplacement_données. Pour connaître les emplacements par défaut du répertoire emplacement_données, voir Emplacement des données de l'agent.
Important : Lorsque vous enregistrez un fichier de réponses à l'aide de l'argument -skipInstall, vous devez conserver le répertoire, les dossiers et les fichiers qui sont créés. En conservant le répertoire emplacement_données, vous pouvez modifier l'installation ultérieurement. Lorsque vous enregistrez un nouveau fichier de réponses pour modifier l'installation, vous spécifiez le même répertoire pour emplacement_données. Pour plus d'informations sur l'enregistrement de fichiers de réponses, voir Utilisation des fichiers de réponses pour installer, mettre à jour, modifier, annuler et désinstaller un logiciel.

Utilisez une valeur emplacement_données différente pour chaque version de produit IBM que vous installez.

Vous devez d'abord enregistrer une installation de produit IBM avec -skipInstall avant d'enregistrer une mise à jour.

-vm
Spécifie le programme de lancement Java. En mode silencieux, utilisez toujours java.exe sous Windows et java sous Linux® et UNIX®.