Utilice un archivo XML para especificar los sistemas destino donde instalar o actualizar el agente.
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>
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. |
Estos ejemplos muestran cómo utilizar los archivos XML.
Este ejemplo tiene un solo destino. La dirección IP del destino es 9.164.259.143. El elemento <Target> no incluye los parámetros opcionales SourceDirectory ni TemporaryLocation. Sin embargo, el elemento <Globals> contiene un parámetro SourceDirectory. El programa de utilidad utiliza el valor de dicho parámetro para el destino.
<?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>
Este ejemplo tiene cuatro destinos. Sin embargo, ninguno de ellos necesita parámetros específicos para él. Por lo tanto, todos los parámetros se especifican en la sección <Globals>, incluso UserName, Password y 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>
Puede especificar un rango de direcciones IP para sistemas de destino. El ejemplo siguiente funciona en las direcciones IP 9.184.112.152 a 9.184.112.160 utilizando las mismas credenciales de inicio de sesión en cada sistema: usuario root, contraseña 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 todos los destinos tienen las mismas propiedades (tipo de conexión, puerto de conexión, nombre de usuario, contraseña), dichas propiedades pueden especificarse en la sección Globals del archivo.
<?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>