Especificación de sistemas destino en un archivo XML

Utilice un archivo XML para especificar los sistemas destino donde instalar o actualizar el agente.

Visión general del archivo XML

El programa de utilidad de despliegue y agente de actualización necesita un archvo XML para determinar los sistemas en los que deben instalarse o actualizarse agentes. Este archivo también debe especificar las credenciales de inicio de sesión y otros elementos que el programa de utilidad necesita.

El archivo tiene los requisitos siguientes:

El ejemplo siguiente muestra un único elemento <Target> y un elemento <Globals>. El elemento <Globals> no supone ninguna ventaja cuando sólo hay un elemento <Target>. El elemento <Globals> puede ser útil cuando tiene varios elementos <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>

Sintaxis del archivo XML

Cada elemento <Parameter> es válido tanto en los elementos <Target> como en el elemento <Globals>. Con esta flexibilidad, si los parámetros se aplican a todos los sistemas de destino, puede utilizar elementos <Target> para especificar sólo los atributos de identificación y poner todos los elementos <Parameter> en el elemento <Globals>.

Especificar un parámetro con Value="" es lo mismo que no especificar el parámetro.

Estas tablas describen la sintaxis del archivo.

Atributo de destino Valor
id El nombre o dirección IP de un sistema de destino.
Parámetro Valor
AgentInstallLocation Sólo para sistemas IBM AIX, HP-UX y Windows; no tiene efecto en otras plataformas

Ubicación donde colocar el nuevo agente. Si no se especifica, se utiliza el directorio temporal predeterminado del sistema.

BFAgentPort Sólo para sistemas IBM AIX y HP-UX

El puerto que deberá utilizar el agente. Utilizado al generar los archivos de respuestas.

BFASolarisAdminFile Sólo para sistemas Solaris

Ubicación donde almacenar los archivos de respuestas para la instalación silenciosa en el sistema destino. Si no se especifica, se utiliza el directorio temporal predeterminado del sistema.

BFASolarisResponseFile Sólo para sistemas Solaris

Ubicación donde almacenar los archivos de respuestas en el sistema destino. Si no se especifica, se utiliza el directorio temporal predeterminado del sistema.

ConnectionType UNIX o Linux: SSH o RSH

Windows: SSH, RSH, SMB, o CIFS

(RSH es el shell remoto. SMB es Server Message Block. CIFS es Common Internet File System.)

ConnectionPort (Opcional) Número de puerto que utilizar para el tipo de conexión especificada (con el parámetro ConnectionType) si el destino no utiliza el puerto predeterminado. Si el destino utiliza el puerto predeterminado, no necesita especificar este parámetro.
ExistingAgentPath Necesario para sistemas IBM AIX, HP-UX y Windows.

Ubicación del agente existente en el sistema de destino. El programa de utilidad crea una copia de seguridad del archivo BFAgent.conf en la ubicación especificada y la restaura después de completar la instalación o actualización. Para otrs sistemas se utiliza la ubicación de instalación predeterminada del sistema.

GZIPPath Sistemas IBM AIX, HP-UX y Solaris.

Directorio donde el instalador del agente puede encontrar el mandato gzip (que extrae el instalador).

IsSudoEnabled Defínalo en yes si sudo está habilitado en los sistemas de destino y tiene previsto utilizarlo. Defina SudoPassword con la contraseña de sudo correcta. Si no se define, el programa de utilidad intenta utilizar Password para el inicio de sesión de sudo.
KeyFile Archivo que se encuentra en el sistema donde ejecuta el programa de utilidad que almacena las claves utilizadas para el cifrado y descifrado de contraseñas.
LocalTempLocation Sólo para sistemas IBM AIX, HP-UX y Windows.

Ubicación donde almacenar los archivos de respuestas en el sistema destino. Si no se especifica, se utiliza el directorio temporal predeterminado del sistema. Para sistemas Solaris, utilice BFASolarisResponseFile o BFASolarisAdminFile.

ManagedScriptsDir Definido como el direcorio donde se ejecuta el programa de utilidad. Este directorio está en el sistema donde se ejecuta el programa de utilidad agentupdate.
SourceDirectory Directorio donde se almacenan los instaladores (en formato .exe, .rpm, y .gz) para los sistemas de destino. Este directorio está en el sistema donde se ejecuta el programa de utilidad agentupdate.
StartCommand (Opcional) El mandato personalizado para iniciar los agentes de Rational Build Forge en el sistema de destino.

Asegúrese de que el mandato se incluye en la variable PATH/path o proporcione la vía de acceso completa en el archivo XML.

StopCommand (Opcional) El mandato personalizado para detener los agentes de Rational Build Forge en el sistema de destino.

Asegúrese de que el mandato se incluye en la variable PATH/path o proporcione la vía de acceso completa en el archivo XML.

SudoPassword Contraseña que utilizar para sudo. Consulte IsSudoEnabled.
Password La contraseña que utilizar para UserName cuando se inicia sesión en el sistema de destino.
Importante: Inicialmente se define el parámetro Password en texto no cifrado en el archivo XML. Cifre la contraseña mediante la opción de línea de mandatos –encrypt tal y como se muestra en Ejecución del programa de utilidad agentupdate.
TemporaryLocation Ubicación del sistema destino dnde almacenar el instalador antes de ejecutar el programa de utilidad.
UseManagedScripts Defínal en yes o no. Si se define en yes, el programa de utilidad intentará encontrar StartCommand y StopCommand en el directorio ManagedScriptsDir.
UserName El nombre de usuario que utilizar cuando se inicia sesión en el sistema de destino.

Archivos XML de ejemplo

Estos ejemplos muestran cómo utilizar los archivos XML.


Comentarios