Spécification des systèmes cible dans un fichier XML

Utilisez un fichier XML pour spécifier les systèmes cible sur lesquels mettre à jour ou installer l'agent.

Présentation du fichier XML

L'utilitaire de mise à jour et de déploiement de l'agent requiert un fichier XML pour déterminer les ordinateurs sur lesquels mettre à jour ou installer les agents. Ce fichier doit également spécifier les identifiants de connexion et d'autres informations dont l'utilitaire a besoin.

Le fichier impose les exigences suivantes :

L'exemple suivant présente un seul élément <Target> et un élément <Globals>. L'élément <Globals> n'est pas utile avec un seul élément <Target>. L'élément <Globals> peut être utile avec plusieurs éléments <Target>.

<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>

<Target id="9.184.112.152">
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="passWord"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="GZIPPath" Value="/usr/contrib/bin/"/>
</Target>

<Globals>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>

</AgentDeploymentAndUpdate>

Syntaxe du fichier XML

Chaque élément <Parameter> est valide à la fois dans les éléments <Target> et <Globals>. Grâce à cette souplesse, si les paramètres s'appliquent à tous les ordinateurs cibles, vous pourriez utiliser les éléments <Target> pour spécifier seulement les attributs d'ID et placer chaque élément <Parameter> dans l'élément <Globals>.

La spécification d'un paramètre avec Value="" équivaut à ne pas spécifier le paramètre.

Ces tables décrivent la syntaxe du fichier.

Attribut cible Valeur
id Le nom ou l'adresse IP d'un ordinateur cible.
Paramètre Valeur
AgentInstallLocation Pour les systèmes IBM AIX, HP-UX et Windows uniquement - il n'y a aucun effet sur les autres plateformes

Emplacement où placer le nouvel agent Si cette option n'est pas spécifiée, le répertoire temporaire par défaut du système est utilisé.

BFAgentPort Pour les systèmes IBM AIX et HP-UX uniquement

Le port que l'agent doit utiliser. Utilisé lors de la génération des fichiers de réponse.

BFASolarisAdminFile Pour les systèmes Solaris niquement

Emplacement sur le système cible où stocker les fichiers de réponse pour l'installation silencieuse. Si cette option n'est pas spécifiée, le répertoire temporaire par défaut du système est utilisé.

BFASolarisResponseFile Pour les systèmes Solaris niquement

Emplacement sur le système cible où stocker les fichiers de réponse. Si cette option n'est pas spécifiée, le répertoire temporaire par défaut du système est utilisé.

ConnectionType UNIX ou Linux : SSH ou RSH

Windows : SSH, RSH, SMB ou CIFS

(RSH est le shell distant. SMB est le bloc de messages du serveur (Server Message Block). CIFS est le système de fichiers Internet communs (Common Internet File System.)

ConnectionPort (Facultatif) Numéro de port à utiliser pour le type de connexion spécifiée (avec le paramètre ConnectionType) si la cible n'utilise pas le port par défaut. Si la cible utilise le port par défaut, vous n'avez pas à spécifier ce paramètre.
ExistingAgentPath Requis pour les systèmes IBM AIX, HP-UX et Windows.

Emplacement de l'agent existant sur l'ordinateur cible. L'utilitaire crée une sauvegarde du fichier BFAgent.conf à l'emplacement que vous spécifiez, puis le restaure après l'installation ou la mise à niveau. Pour les autres systèmes, l'emplacement d'installation du système par défaut est utilisé.

GZIPPath Systèmes IBM AIX, HP-UX et Solaris.

Répertoire dans lequel le programme d'installation de l'agent peut trouver la commande gzip (qui extrait le programme d'installation).

IsSudoEnabled Défini sur Oui si sudo est activé sur les systèmes cible et si vous avez l'intention de l'utiliser. Définissez SudoPassword sur le mot de passe sudo correct. S'il n'est pas défini, l'utilitaire tente d'utiliser Password pour la connexion à sudo.
KeyFile Fichier présent sur l'ordinateur sur lequel vous exécutez l'utilitaire qui stocke les clés utilisées pour le chiffrement et le déchiffrement des mots de passe.
LocalTempLocation Pour les systèmes IBM AIX, HP-UX et Windows seulement.

Emplacement sur le système cible où stocker les fichiers de réponse. Si cette option n'est pas spécifiée, le répertoire temporaire par défaut du système est utilisé. Sur les systèmes Solaris, utilisez BFASolarisResponseFile ou BFASolarisAdminFile.

ManagedScriptsDir Défini sur le répertoire dans lequel l'utilitaire s'exécute. Ce répertoire se trouve sur l'ordinateur sur lequel vous exécutez l'utilitaire agentupdate.
SourceDirectory Répertoire qui stocke les programmes d'installation (sous forme de fichiers .exe, .rpm, et .gz) pour les ordinateurs cibles. Ce répertoire se trouve sur l'ordinateur sur lequel vous exécutez l'utilitaire agentupdate.
StartCommand (Facultatif) La commande personnalisée dont vous disposez pour lancer les agents Rational Build Forge sur l'ordinateur cible.

Assurez-vous que la commande est incluse dans la variable PATH/path ou fournissez le chemin complet dans le fichier XML.

StopCommand (Facultatif) La commande personnalisée dont vous disposez pour arrêter les agents Rational Build Forge sur l'ordinateur cible.

Assurez-vous que la commande est incluse dans la variable PATH/path ou fournissez le chemin complet dans le fichier XML.

SudoPassword Mot de passe à utiliser pour sudo. Reportez-vous à IsSudoEnabled.
Password Le mot de passe à utiliser pour UserName lors de la connexion à l'ordinateur cible.
Important : Vous définissez initialement le paramètre Password en texte en clair dans le fichier XML. Chiffrez le mot de passe à l'aide de l'option de ligne de commande –encrypt comme démontré dans Exécution de l'utilitaire agentupdate.
TemporaryLocation Emplacement sur l'ordinateur cible dans lequel stocker le programme d'installation avant d'exécuter l'utilitaire.
UseManagedScripts Défini sur Oui ou Non. S'il est défini sur Oui, l'utilitaire recherche les commandes StartCommand et StopCommand dans le répertoire ManagedScriptsDir.
UserName Le nom d'utilisateur utilisé pour la connexion à l'ordinateur cible.

Exemples de fichiers XML

Ces exemples présentent l'utilisation des fichiers XML.


Feedback