Ejemplo de configuración de subnodo

Cómo configurar un agente de muestra con un subnodo definido.

Ejemplo:

En este ejemplo se muestra cómo configurar un agente de muestra que tiene un subnodo llamado Subnodo de ejemplo de tipo exs y las tres propiedades de configuración siguientes:
  • Cfg agente (el nombre de propiedad real es K00_AGENT_CFG) solo se define en el nivel de agente.
  • Cfg subnodo (el nombre de propiedad real es K00_SUBNODE_CFG) solo se define en el subnodo de ejemplo.
  • Cfg alterable temporalmente (el nombre de propiedad real es K00_OVERRIDABLE_CFG) se define en el nivel de agente y se ha copiado en el subnodo de ejemplo.
La Figura 1 muestra estas propiedades de configuración en la página Información de configuración de tiempo de ejecución de Agent Editor.
Figura 1. Definiciones de propiedades de configuración en Agent Builder
Panel de Agent Editor que tiene abierta la página Información de configuración de tiempo de ejecución y visualiza la información de configuración de tiempo de ejecución
Cuando este agente de ejemplo se configura, la primer página que se muestra es la sección superior ,la cual contiene la propiedad Cfg agente como se muestra en (Figura 2). Puesto que se trata de una propiedad de nivel de agente, se muestra una vez durante la configuración del agente. Cualquier instancia del Subnodo de ejemplo puede ver el valor de esta propiedad, pero todas las instancias ven el mismo valor.
Figura 2. Sección Superior con configuración a nivel de agente para la propiedad Agent Cfg
Ventana Configuración de agente en la que se ha seleccionado Superior y se ha entrado un valor en el campo Cfg agente
Si configura desde la línea de mandatos de Tivoli Enterprise Monitoring Server, se puede establecer la propiedad Cfg agente con el mandato siguiente:
tacmd configureSystem -m HOSTNAME:00 -p "TOP.K00_AGENT_CFG=a value"
La siguiente sección que se visualiza es la sección Principal tal como se muestra en la Figura 3. También es una sección a nivel de agente y contiene la propiedad a nivel de agente Overridable Cfg. Esta propiedad difiere de la propiedad Cfg agente en que esta propiedad se ha copiado en el Subnodo de ejemplo en Agent Builder. Esto significa que se puede especificar un valor predeterminado de la propiedad en la página Principal. Sin embargo, cualquier instancia de Subnodo de ejemplo puede alterar temporalmente el valor que se especifica aquí por otro diferente.
Figura 3. Sección Principal con valor predeterminado de nivel de agente para la propiedad Overridable Cfg
Ventana Configuración del agente en la que se ha seleccionado Principal y se ha especificado valor predeterminado en el campo Cfg alterable temporalmente
Si realiza la configuración desde la línea de mandatos de Tivoli Enterprise Monitoring Server, esta propiedad se puede establecer utilizando el mandato siguiente:
tacmd configureSystem -m HOSTNAME:00 -p "MAIN.K00_OVERRIDABLE_CFG=default value"

Puede colocar ambas propiedades en la misma sección a nivel de agente. Puede decidir el número de secciones personalizadas a nivel de agente que desea crear y cómo distribuir entre las mismas las propiedades personalizadas.

La siguiente sección que se visualiza es la sección Subnodo de ejemplo tal como se muestra en la Figura 4. Dado que este agente se configura por primera vez, no hay instancias de subnodo definidas y no se muestran subsecciones de instancia de subnodo. Se muestra la subsección de valores iniciales de propiedades, aunque es opcional y puede que algunos tipos de subnodo no se muestren. Puesto que se muestra la subsección de valores iniciales de propiedades, se pueden especificar valores predeterminados para cualquiera de las propiedades de configuración. La propiedad Cfg alterable temporalmente ya tiene un valor predeterminado que se ha obtenido de la propiedad de nivel de agente del mismo nombre.
Figura 4. Página de sección Subnodo de ejemplo sin subnodos
Ventana Configuración del agente con Subnodo de ejemplo seleccionado y los campos Cfg subnodo y Cfg alterable temporalmente visualizados
Las instancias de subnodo se definen realizando las acciones siguientes en la página de sección vacía de Subnodo de ejemplo (Figura 5):
  1. En la sección Subnodo de ejemplo inicial, en el campo Subnode Cfg, escriba la siguiente serie predeterminada para la propiedad: sub-default value.
  2. Pulse Nuevo. Una subsección de Subnodo de ejemplo se visualiza después de la subsección de propiedades iniciales.
  3. En el campo Subnodo de ejemplo, escriba el siguiente ID de instancia de subnodo: do.
  4. Pulse Nuevo. Una segunda subsección de Subnodo de ejemplo se muestra después de la primera.
  5. En el segundo campo Subnodo de ejemplo, escriba el siguiente ID de instancia de subnodo: re.
  6. En el campo Cfg subnodo, escriba el siguiente valor para la propiedad Cfg subnodo: sc override.
  7. En el campo Cfg alterable temporalmente, escriba el siguiente valor para la propiedad Cfg alterable temporalmente: oc override.
Figura 5. Página de sección Subnodo de ejemplo con dos instancias de subnodo definidas
Ventana Configuración de agente con dos instancias de subnodo definidas debajo del subnodo de ejemplo

Las dos nuevas subsecciones hacen que el agente cree dos instancias de subnodo cuando se inicia. Puesto que las propiedades de la subsección de subnodo do no se han modificado, dicha instancia de subnodo utiliza los valores de propiedad predeterminados. Como se han especificado distintos valores para las propiedades de la subsección re, la instancia de subnodo re utiliza dichos valores especificados.

Puede definir un valor predeterminado desde la línea de mandatos del Tivoli Enterprise Monitoring Server con el siguiente mandato:
tacmd configureSystem -m HOSTNAME:00 -p "exs.K00_SUBNODE_CFG=sub-default value" 
El formato para definir valores predeterminados de subnodo es exactamente igual que el formato para definir propiedades a nivel de agente, excepto en que el nombre de sección identifica una sección de subnodo.
Puede crear las instancias de subnodo desde la línea de mandatos del Tivoli Enterprise Monitoring Server con el siguiente mandato:
tacmd configureSystem -m HOSTNAME:00 -p "exs:do.K00_OVERRIDABLE_CFG=default value" \
 "exs:re.K00_SUBNODE_CFG=sc override" "exs:re.K00_OVERRIDABLE_CFG=oc override"

El ID de la instancia de subnodo se inserta entre el nombre de sección y el nombre de propiedad. Cuando utiliza la línea de mandatos para crear una instancia de subnodo al menos una propiedad debe especificarse, incluso si todas las propiedades utilizan valores predeterminados. De lo contrario, no es necesario especificar los valores predeterminados en la línea de mandatos cuando se definen las instancias de subnodo.

Todas las propiedades de configuración del agente se pueden definir en un solo mandato. El siguiente mandato es equivalente a todos los mandatos individuales anteriores:
tacmd configureSystem -m HOSTNAME:00 -p "TOP.K00_AGENT_CFG=a value" \
 "MAIN.K00_OVERRIDABLE_CFG=default value" \
 "exs.K00_SUBNODE_CFG=sub-default value" \
 "exs:do.K00_OVERRIDABLE_CFG=default value" \
 "exs:re.K00_SUBNODE_CFG=sc override" "exs:re.K00_OVERRIDABLE_CFG=oc override"