L'utilitaire propose plusieurs options de ligne de commande et variables d'environnement pour contrôler son comportement.
Ce tableau présente les options de ligne de commande dans l'ordre alphabétique.
Option | Obligatoire | Description |
---|---|---|
–debug | Non | Active la sortie de débogage étendue. Vous pouvez aussi activer le débogage en définissant la variable d'environnement DEBUG sur n'importe quelle valeur. Pour plus d'informations à propos de la préséance, voir Ordre de préséance des paramètres de fichier XML, options de ligne de commande et variables d'environnement. |
–encrypt | Non | Remplace les mots de passe en texte en clair du fichier XML par des formes chiffrées de ces mots de passe. |
–genkey <key_file> | Non | Génère une clé secrète pour le chiffrement et le déchiffrement des mots de passe. Lorsque vous spécifiez l'option –genkey, vous devez également spécifier l'option –keyfile <key_file> pour stocker la clé dans le fichier spécifié. |
–keyfile <key_file> | Non | Contient la clé pour le chiffrement et le déchiffrement des mots de passe. Vous pouvez aussi spécifier ce fichier en sélectionnant le paramètre de fichier XML KeyFile. Pour plus d'informations à propos de la préséance, voir Ordre de préséance des paramètres de fichier XML, options de ligne de commande et variables d'environnement. |
–logFile <log_file> | Non | Spécifie le fichier dans lequel l'utilitaire consigne les messages. Par défaut, le nom est RemoteAgentDeployerUpdater_Log.txt. |
–maxThreads | Non | Définit le nombre maximum d'unités d'exécution utilisées par l'utilitaire au cours de son fonctionnement. Par défaut, cette valeur est définie sur deux fois le nombre de processeurs présents dans le matériel de l'hôte. |
–preview | Non | Répertorie, sans les exécuter, les commandes que l'utilitaire exécuterait pour chaque cible. |
–sourceDir <path> | Non | Spécifie le répertoire dans lequel les programmes d'installation de l'agent (sous forme de fichiers .exe, .rpm, et .gz) pour les différentes plateformes sont enregistrés. L'utilitaire agentupdate détermine le système d'exploitation pour chaque cible, puis utilise le programme d'installation correspondant à partir de ce répertoire. Remarque : Cet utilitaire utilise les programmes d'installation de l'agent. Il n'utilise pas le code source de l'agent.
Vous pouvez aussi spécifier ce répertoire en définissant le paramètre de fichier XML SourceDirectory ou la variable d'environnement SOURCEDIR. Pour plus d'informations à propos de la préséance, voir Ordre de préséance des paramètres de fichier XML, options de ligne de commande et variables d'environnement. |
–targets <XML_file> | Oui | Spécifie le chemin et le nom de fichier pour le fichier XML que vous avez créé afin d'indiquer les ordinateurs cibles sur lesquels mettre à jour ou installer les agents IBM Rational Build Forge. |
Cette table décrit les variables d'environnement.
Variable d'environnement | Obligatoire | Description |
---|---|---|
DEBUG | Non | Active la sortie de débogage étendue. Vous pouvez aussi activer le débogage en spécifiant l'option de ligne de commande –debug. Pour plus d'informations à propos de la préséance, voir Ordre de préséance des paramètres de fichier XML, options de ligne de commande et variables d'environnement. |
SOURCEDIR | Non | Spécifie le répertoire dans lequel les programmes d'installation de l'agent (sous forme de fichiers .exe, .rpm, et .gz) pour les différentes plateformes sont enregistrés. L'utilitaire agentupdate détermine le système d'exploitation pour chaque cible, puis utilise le programme d'installation correspondant à partir de ce répertoire. Remarque : Cet utilitaire utilise les programmes d'installation de l'agent. Il n'utilise pas le code source de l'agent.
Vous pouvez aussi spécifier ce répertoire en définissant le paramètre de fichier XML SourceDirectory ou l'option de ligne de commande –sourceDir. Pour plus d'informations à propos de la préséance, voir Ordre de préséance des paramètres de fichier XML, options de ligne de commande et variables d'environnement. |