Utilisez un fichier XML pour spécifier les systèmes cible sur lesquels mettre à jour ou installer l'agent.
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>
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. |
Ces exemples présentent l'utilisation des fichiers XML.
Cet exemple ne comprend qu'une cible. L'adresse IP cible est 9.164.259.143. L'élément <Target> ne comprend pas les paramètres facultatifs SourceDirectory ou TemporaryLocation. Toutefois, l'élément <Globals> possède un paramètre SourceDirectory. L'utilitaire utilise la valeur de ce paramètre pour la cible.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="SourceDirectory" Value="..\test"/>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>
<Target id="9.164.259.143">
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="toor"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="AgentInstallLocation" Value="/usr/local/bin/bfagent"/>
</Target>
</AgentDeploymentAndUpdate>
Cet exemple comprend quatre cibles. Toutefois, aucune de ces cibles ne requiert de paramètres spécifiques. Par conséquent, tous les paramètres sont spécifiés dans la section <Globals>, y compris UserName, Password et ConnectionType.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="SourceDirectory" Value="..\test"/>
<Parameter Name="ConnectionType" Value="ssh"/>
<Parameter Name="UserName" Value="root"/>
<Parameter Name="Password" Value="toor"/>
<Parameter Name="TemporaryLocation" Value="/tmp"/>
<Parameter Name="ExistingAgentPath" Value="/usr/local/bin/bfagent"/>
<Parameter Name="AgentInstallLocation" Value="/usr/local/bin/bfagent"/>
<Parameter Name="KeyFile" Value="..\test\keyfile.txt"/>
</Globals>
<Target id="9.164.259.143">
</Target>
<Target id="9.164.102.169">
</Target>
<Target id="9.164.102.196">
</Target>
<Target id="9.106.189.157">
</Target>
</AgentDeploymentAndUpdate>
Vous pouvez spécifier une plage d'adresses IP pour les systèmes cible. L'exemple suivant fonctionne sur les adresses IP 9.184.112.152 à 9.184.112.160 en utilisant les mêmes identifiants de connexion sur chaque système : identifiant de connexion root, mot de passe password.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Target id=”9.184.112.152-160”>
<Parameter Name="ConnectionType" Value="ssh">
<Parameter Name="ConnectionPort" Value=""/>
<Parameter Name="UserName" Value="root">
<Parameter Name="Password" Value="passWord">
</Target>
</AgentDeploymentAndUpdate>
Si toutes les cibles possèdent les mêmes propriétés (type de connexion, port de connexion, nom d'utilisateur, mot de passe), ces propriétés peuvent être spécifiées dans la section Globals du fichier.
<?xml version="1.0" encoding="UTF-8"?>
<AgentDeploymentAndUpdate>
<Globals>
<Parameter Name="ConnectionType" Value="ssh">
<Parameter Name="ConnectionPort" Value="">
<Parameter Name="UserName" Value="root">
<Parameter Name="Password" Value="passWord">
</Globals>
<Target id=”9.184.112.152-160”>
</Target>
<Target id=”9.184.80.12-16”>
</Target>
</AgentDeploymentAndUpdate>