Pasos para supervisar la salida de un script

Configure el agente para que reciba datos de un origen de datos de script.

1. En la página Origen de datos inicial del agente o la página Ubicación de origen de datos, seleccione la opción Mandato o script en el área Categorías de datos de supervisión.
2. En el área Orígenes de datos, pulse Salida de un script.
3. Pulse Siguiente.
4. En la página Lista de mandatos, pulse Añadir para visualizar una ventana Información de mandato.
   Nota: Al marcar el recuadro de selección Habilitar la recopilación de datos utilizando SSH se habilita SSH para este grupo de atributos. Si este recuadro de selección no está seleccionado, el grupo de atributos se ejecuta de forma local.

   Nota: Si existe un mandato que pueda ejecutarse en el sistema operativo en el que Agent Builder se está ejecutando, se habilita la opción Probar. Puede utilizar Probar para probar un mandato que haya definido.
5. En el área Información de mandato en la ventana Información de mandato, escriba un nombre de mandato con los argumentos necesarios en el campo Mandato y un separador en el campo Separador.
   Nota:

   1. Los scripts de Windows se inician con frecuencia sin especificar la extensión .bat o .cmd en la línea de mandatos. Para la ejecución remota, debe instalarse un entorno de shell y se debe especificar .bat o .cmd en el mandato de origen de datos de script para que se ejecute el script. Cygwin es un ejemplo de entorno de shell que está disponible para Windows. Linux, Red Hat y AIX. Para verificar que existe un entorno de shell, SSH o inicie sesión en el host remoto y especifique el mandato:

      PATH=$PATH:. <mandato>

      Si el mandato se ejecuta, entonces es que existe un entorno de shell.
   2. Especifique el nombre entre comillas para que el intérprete de mandatos no lo analice. Por ejemplo, this is a test.bat argument se convierte en:

      "this is a test.bat" argument

   3. Se pueden utilizar variables de entorno y variables de configuración en el script proporcionado por el usuario, pero no pueden formar parte de la línea de mandatos que inicia el script. Las siguientes variables son excepciones a esta regla:

      AGENT_BIN_DIR

      El directorio en el que el agente coloca los archivos binarios o scripts

      AGENT_ETC_DIR

      El directorio donde el agente coloca los archivos de configuración

      AGENT_LIB_DIR

      El directorio donde el agente coloca las bibliotecas compartidas o las bibliotecas de enlace dinámico

      CANDLEHOME

      El directorio de instalación de Tivoli Monitoring en Linux o UNIX

      CANDLE_HOME

      El directorio de instalación de Windows Tivoli Monitoring

   4. Si se utiliza la opción de recopilación de datos SSH, la línea de mandatos se ejecuta en relación al directorio de inicio del usuario en el sistema remoto. Si carga scripts o ejecutables en el sistema remoto, se copian en la ubicación especificada en la variable de entorno del agente CDP_SSH_TEMP_DIRECTORY. La ubicación es, de forma predeterminada, el directorio de inicio del usuario en el sistema remoto. En algunos sistemas, es posible que tenga que definir la línea de mandatos con una vía de acceso relativa, por ejemplo, ./Script.sh.
6. En el área Sistemas operativos, seleccione uno o varios sistemas operativos. Al recopilar datos de un sistema remoto utilizando SSH, Sistemas operativos es una propiedad del sistema en el que el agente está instalado. No es el sistema operativo del sistema remoto. Se recomienda seleccionar el recuadro de selección Todos los sistemas operativos cuando se utilizan las características de recopilación de datos SSH.
7. Opcional: Si se necesita uno o varios archivos definidos por el usuario para ejecutar el mandato, pulse Añadir en el área de archivos de mandatos para especificar los archivos de su sistema.
   Los archivos se copian en la carpeta del proyecto del agente en scripts/sistema operativo, donde sistema operativo es una variable que depende de lo que haya seleccionado en la ventana Información de mandato. Estos archivos también se empaquetan y se distribuyen con el agente. Si desea editar la definición de un archivo de mandatos que ya ha añadido, o del que ha cambiado el contenido, seleccione el archivo y pulse Editar. Consulte Edición de una definición de archivo de mandatos.
8. Pulse Aceptar. Se visualiza la página Lista de mandatos.
9. Para probar el mandato, utilice los pasos siguientes:
   1. Pulse Probar para abrir la información del mandato y visualizar la ventana Probar mandato. Para probar el script en un sistema remoto, seleccione un sistema en la lista Nombre de conexión o pulse Añadir para añadir el nombre de host de un sistema.
   2. Utilice la ventana Probar mandato para cambiar el mandato, el separador predeterminado y los separadores de atributos, así como para ver cómo estos cambios afectan a los datos que se devuelven.
      1. Escriba el mandato y el separador en los campos si todavía no están especificados.
         Nota: Puede especificar otros separadores utilizando la ventana Información de atributos en el momento de creación de atributos o mediante Agent Editor para modificar un atributo existente. Para obtener más información sobre Agent Editor, consulte Utilización del editor del agente para modificar el agente y más información sobre la manipulación de orígenes de datos y atributos, consulte Edición del origen de datos y propiedades de atributos
      2. Antes de empezar la prueba, puede establecer variables de entorno y propiedades de configuración. Para obtener más información, consulte (Prueba de grupo de atributos).
      3. Pulse Aceptar para volver a la ventana Probar valores.
      4. Pulse Iniciar agente. Una ventana indica que el agente se está iniciando.
      5. Para simular una solicitud de Tivoli Enterprise Portal o SOAP para los datos de agente, pulse Recopilar datos. Agent Builder ejecuta su mandato. Si ha especificado un sistema remoto, proporcione un ID de usuario y contraseña. Incluso si el código de retorno no es 0, Agent Builder analiza los resultados del mandato del mismo modo que el agente.
      6. La ventana Valores de prueba recopila y muestra los datos de la memoria caché del agente desde que se inició por última vez. Los nombres iniciales de los atributos son Atributo_1, Atributo_2, etcétera; sin embargo, puede modificar las propiedades de los atributos pulsando la cabecera de columna apropiada.
      7. Pulse Comprobar resultados para ver el código de retorno del mandato, los datos sin analizar y los mensajes de error que se han devuelto.
      8. El agente se puede detener pulsando Detener agente.
      9. Pulse Aceptar para volver a la ventana Información de mandato.

         Si cambia el mandato o el separador, el mandato apropiado se actualiza para reflejar estos cambios.

         Si esta ventana se ha abierto al crear el origen de datos de script, los atributos se han añadido al nuevo origen de datos de script.

         Si esta ventana se ha abierto desde un origen de datos de script existente, los cambios en los atributos se realizan en el origen de datos de script. Se añaden los atributos adicionales, pero los atributos de sobra no se eliminan. Estas opciones solo afectan a los atributos analizados desde la salida de script. Los atributos derivados no se ven afectados. Si alguno de estos atributos deja de ser válido basándose en los atributos a los que hacen referencia, puede actualizar o eliminar los atributos derivados manualmente. Se visualiza la fórmula del atributo derivado y no el valor del resultado actual.

   Nota: Si el grupo de atributos ya existe, para iniciar una prueba, complete el siguiente procedimiento

   1. Seleccione el grupo de atributos en la página Definición de orígenes de datos de Agent Editor.
   2. Seleccione el script que desea probar de la lista de mandatos
   3. Pulse Probar y siga el procedimiento del paso 9
10. Si se ha saltado la prueba del mandato en el paso 9, siga estos pasos:
    1. En la página Lista de mandatos con la información de mandatos completada, pulse Siguiente.
    2. En la página Información de atributo, complete el nombre de atributo y la información del tipo utilizando (Tabla 1). Seleccione Añadir atributos adicionales para añadir más atributos
    3. En la página Información de atributo, utilice el separador Información de atributos de script para elegir un separador de datos específico para este atributo.
       El separador estándar ; está seleccionado de forma predeterminada. Puede elegir un número de otros separadores como, por ejemplo, una cadena, un número de caracteres, un separador o un espacio. También puede elegir la utilización de un separador de cadena diferente para el comienzo y finalización de los datos. Finalmente, también puede elegir Resto del registro para asignar el resto del registro al atributo. Para obtener más información sobre el análisis de script y los separadores, consulte Separadores y análisis de script.
11. Realice una de las acciones siguientes:
    • Si utiliza el Asistente de agente, pulse Siguiente.
    • Pulse en Finalizar para guardar el origen de datos y abrir Agent Editor.
12. Es posible añadir atributos y proporcionar la información para los mismos. Para obtener más información, consulte el apartado Creación de atributos.
    Además de los campos aplicables en todos los orígenes de datos (tal como se describe en Campos y opciones para definir atributos), la página Definición de orígenes de datos para el origen de datos de script tiene las siguientes opciones:

    Lista de mandatos

    Proporciona acceso a los mandatos y scripts para iniciarlos durante la recopilación de datos.

    Añadir

    Permite al usuario añadir un mandato que este grupo de atributos debe iniciar.

    Editar

    Permite al usuario editar una entrada de mandato existente.

    Eliminar

    Permite al usuario suprimir una entrada de mandato existente.

    Probar

    Permite al usuario acceder al entorno de prueba de este grupo de atributos.

    Habilitar la recopilación de datos utilizando SSH

    Al marcar este recuadro de selección se habilita SSH para este grupo de atributos. Si este recuadro de selección no está seleccionado, el grupo de atributos se ejecuta de forma local.

    Si desea más información sobre la configuración de la conexión remota SSH para orígenes de datos de script, consulte Configuración de una conexión remota de Secure Shell (SSH).