Instalación de agentes a partir de la línea de mandatos

La instalación de un agente a partir de la línea de mandatos implica la ejecución de un archivo de proceso por lotes o script de shell y la especificación de la información acerca de cómo el agente se conecta con el servidor.

Antes de empezar

Para entornos de producción, cree una cuenta de usuario que se dedique a ejecutar el agente en el sistema en el que se ha instalado el agente.

Asegúrese de que el sistema en el que se ha instalado el agente tiene Java™ Runtime Environment (JRE) o Java Development Kit (JDK) versión 7 o posterior.

Si el equipo tiene un JRE o JDK de IBM®, actualice el JRE o el JDK a la versión 7.0.0 SR4 con el nivel de actualización de servicios (SR) especificado o con a un nivel de actualización de servicio posterior:

Acerca de esta tarea

Los agentes que se ejecutan en sistemas UNIX se pueden instalar directamente desde la aplicación web de IBM UrbanCode Deploy; consulte Instalación remota de agentes.

Para evaluaciones simples, el usuario administrativo puede ejecutar el agente en el sistema en el que está ubicado el servidor. Pero, si tiene previsto ejecutar despliegues en distintos sistemas, instale un agente independiente en cada sistema. Si, por ejemplo, su entorno de prueba consiste en tres sistemas, instale un agente en cada uno. Siga el mismo procedimiento para cada entorno que utilice la aplicación.

Cada agente necesita los derechos apropiados para comunicarse con el servidor de IBM UrbanCode Deploy (si el agente se comunica con IBM UrbanCode Deploy mediante un relé de agente, consulte Instalación remota de agentes).

Como mínimo, cada agente debe tener permiso para:

Procedimiento

  1. Descarga y extraiga el instalador del agente en el sistema en el que desea instalar el agente:
    • Para descargar el instalador del servidor, pulse el botón Ayuda en la parte superior derecha de la página y, a continuación, pulse Herramientas. A continuación, pulse el Agente de IBM UrbanCode Deploy y descargue y extraiga el archivo.
    • Para buscar el instalador en el servidor con la línea de mandatos, diríjase a la siguiente ubicación y copie el archivo en el sistema de destino:carpeta_instalación/opt/tomcat/webapps/ROOT/tools/ibm-ucd-agent.zip
      Nota: Si va a instalar el agente en z/OS, la codificación de caracteres para varios archivos de tipo de texto en el paquete de instalación debe convertirse en codificación IBM-1047 antes de que se puedan utilizar. Extraiga los archivos de instalación y convierta los siguientes archivos en codificación IBM-1047:
      • install-agent.sh
      • install.with.groovy.xml
      • opt/apache-ant-1.8.4/bin/ant
      • opt/apache-ant-1.8.4/bin/antRun
      • opt/groovy-1.8.8/bin/groovy
      • opt/groovy-1.8.8/bin/startGroovy
      • install/AgentInstaller.groovy
      Para convertir los archivos, emita mandatos similares al texto siguiente en un indicador de mandatos:
      iconv -f UTF-8 -t IBM-1047 nombre_archivo >nombre_archivo.bac
      mv nombre_archivo.bac nombre_archivo
      Después de convertir los archivos, mueva los archivos de instalación a z/OS y siga con la instalación.
  2. Después de descargar y expandir el paquete de instalación, abra el directorio de instalación.
  3. Desde este directorio, ejecute install-agent.bat (Windows) o install-agent.sh (UNIX o Linux).
    Nota: Si instala el agente como un servicio de Windows, la cuenta de usuario debe tener los siguientes privilegios:
    • SE_INCREASE_QUOTA_NAME "Ajustar cuotas de memoria para un proceso"
    • SE_ASSIGNPRIMARYTOKEN_NAME "Sustituir una señal a nivel de proceso"
    • SE_INTERACTIVE_LOGON_NAME "Iniciar la sesión localmente"
    Se visualiza el instalador de agentes de IBM UrbanCode Deploy y el sistema solicita la siguiente información. Puede aceptar los valores predeterminados (visualizados entre paréntesis) pulsando la tecla Intro. Si se indican dos opciones, como Y/n, la opción en mayúsculas será el valor predeterminado.
    Introduzca el directorio en el que debería instalarse el agente.
    Por ejemplo: C:\Archivos de programa\IBM\UCDeploy-agent (Windows) o /opt/IBM/ibm-ucd/agent (UNIX). Si el directorio no existe, introduzca Y para indicar al instalador que debe crearle uno. Si introduce un directorio existente, el programa le dará la opción de actualizar el agente. Para obtener información sobre cómo actualizar, consulte Actualización de IBM UrbanCode Deploy.
    Nota: No utilice ninguna expansión de shell ni abreviatura, como el carácter del tilde (~).
    Introduzca el directorio de inicio del JRE/JDK utilizado para ejecutar el agente.
    Si ya se ha instalado Java, IBM UrbanCode Deploy sugiere la ubicación de Java como valor predeterminado. Para aceptar el valor predeterminado, pulse la tecla Intro o, de los contrario, sustituya el valor predeterminado e introduzca la vía de acceso correcta.
    ¿El agente se conectará con un relé de agente en lugar de hacerlo directamente con el servidor?
    El valor predeterminado es N. Si especifica Y, el sistema le solicitará que configure los siguientes parámetros:
    Nombre de host o dirección del relé de agente con el que se conectará el agente
    Introduzca el nombre de host o la dirección IP del relé de agente. Proporcione el valor que ha utilizado al instalar el relé de agente.
    Puerto de comunicación de control del relé de agente
    Introduzca el puerto que el agente utiliza para comunicaciones basadas en JMS con el relé de agente. El valor predeterminado es 7916.
    Puerto de proxy HTTP para el relé de agente
    Introduzca el puerto que el agente utiliza para comunicaciones HTTP con el relé de agente. El valor predeterminado es 20080.
    Nota: Puede especificar otro relé para utilizarlo en el caso de que falle el primero. Configure relés de migración tras error añadiendo relés adicionales al parámetro locked/agent.brokerUrl=failover\: en el archivo /agent-install/conf/agent/installed.properties. La sintaxis de configuración de relé es IP_agente_o_nombre_host\:puerto_JMS. Separe los relés con comas. El ejemplo siguiente muestra el parámetro configurado para dos relés: locked/agent.brokerUrl=failover\:(ah3\://relay1\:7916,ah3\://relay2\:7916). Se supone que todos los relés utilizan el mismo puerto de proxy HTTP. Inicialmente, el parámetro contiene la ubicación del relé configurado durante la instalación de agente.
    Introduzca el nombre de host o la dirección del servidor al que se conectará el agente.
    El valor predeterminado es localhost. Si el agente se conecta con servidores en clúster, especifique el nombre de host del equilibrador de carga.
    Introduzca el puerto de comunicación del agente del servidor
    El valor predeterminado es 7918.
    ¿La comunicación del agente del servidor utiliza la autenticación mutua con SSL?
    El valor predeterminado es N.

    Si utiliza SSL, actívela también para el servidor o el agente no podrá conectarse con el servidor. Esto también se aplica si utiliza la autenticación mutua. Si cambia los números de puerto para la comunicación del agente, debe proporcionarlos al instalar los agentes.

    Introduzca el nombre de este agente.
    Escriba un nombre exclusivo. El servidor utiliza este nombre para identificar este agente. Los nombres están limitados a 256 caracteres y no se pueden modificar.
    Especifique equipos a los que añadir este agente, separados por comas.
    El valor predeterminado es NONE.

    Se pueden añadir agentes a equipos la primera vez que se conectan al servidor. La primera vez que el agente se conecte al servidor, será asignado a los equipos especificados. Separe los equipos con comas; los espacios finales no se tendrán en cuenta. Los nombres de equipos que no existan también se omitirán.

    ¿Desea instalar el agente como un servicio de Windows?
    (Sólo Windows). El valor predeterminado es N. Cuando se instala como un servicio, IBM UrbanCode Deploy sólo captura el valor para la variable PATH. Siempre se utilizan los valores que se capturan durante la instalación, incluso si se cambian posteriormente. Para obtener versiones de Windows recientes, debe ejecutar el mandato como administrador.

Qué hacer a continuación

Inicie el agente tal como se describe en la sección Inicio de agentes. Si el agente se ha configurado de forma correcta, IBM UrbanCode Deploy lo reconoce automáticamente; no es necesario llevar a cabo más acciones para empezar a utilizarlo.

Comentarios