[8.5.5.5 o posterior]

Definición de metadatos administrativos para los recursos de Liberty

Puede utilizar el archivo admin-metadata.xml para definir metadatos de administración para los recursos de servidor, clúster, aplicación y tiempo de ejecución. Los metadatos administrativos le permiten asociar información como, por ejemplo, códigos, propietarios, contactos y notas con recursos. Los metadatos pueden simplificar la gestión de recursos y facilitarla para encontrar información sobre los recursos en topologías grandes. Por ejemplo, los metadatos del servidor que muestran el propietario de un servidor pueden ayudarle a encontrar más fácilmente la persona correcta con la que debe ponerse en contacto si el servidor requiere cambios. El archivo admin-metadata.xml utiliza el formato XML y no existe de forma predeterminada. Debe crear el archivo y colocarlo en un directorio de configuración del servidor o en el directorio etc del perfil Liberty (tiempo de ejecución). Después de colocar el archivo admin-metadata.xml en un directorio soportado, puede ver los metadatos en Centro de administración o aumentar los metadatos a través de interfaces de programación de aplicaciones (API).

Procedimiento

  1. Determine si desea que el archivo admin-metadata.xml defina metadatos para un servidor concreto o para todos los servidores del entorno de ejecución.
    servidor
    Un archivo admin-metadata.xml de un directorio de configuración del servidor define los metadatos para el servidor, su clúster y sus aplicaciones. La vía de acceso del archivo es ${wlp.install.dir}/usr/servers/nombre_servidor/admin-metadata.xml o, si la variable $WLP_USER_DIR está establecida en una ventana de mandatos o el archivo server.env, $WLP_USER_DIR/servers/nombre_servidor/admin-metadata.xml.
    tiempo de ejecución
    Un archivo admin-metadata.xml del directorio etc de tiempo de ejecución define los metadatos para los recursos de tiempo de ejecución. El archivo es visible para todos los servidores que utilizan el entorno de ejecución. La vía de acceso de archivo es ${wlp.install.dir}/etc/admin-metadata.xml. El directorio etc no existe de forma predeterminada; debe crear el directorio etc.
  2. Configure los metadatos de administración en el archivo admin-metadata.xml.
    1. Cree un archivo de texto denominado admin-metadata.xml en la ubicación determinada en el paso 1. Si el archivo ya existe, ábralo con un editor de texto.
    2. En un editor, especifique metadatos administrativos para cualquiera de los siguientes objetos de recurso:
      • <server> - No definir los metadatos de más de un servidor.
      • <cluster> - No definir los metadatos de más de un clúster.
      • <application> - Definir cualquier número de metadatos de aplicación.
      • <runtime> - No definir los metadatos de más de un tiempo de ejecución.
      Restricción: no se pueden definir metadatos de host en un archivo admin-metadata.xml. Debe gestionar los metadatos de host utilizando Centro de administración o las API o scripts del MBean AdminMetadataManager.

      Para cada objeto de recurso, especifique hasta cuatro tipos de metadatos:

      • tag - Asignar cero o más etiquetas a un objeto de recurso. Puede utilizar una etiqueta para buscar recursos.
      • owner - No asignar más de un propietario a un objeto de recurso. Un propietario suele ser una persona o entidad responsable de los metadatos. El propietario puede proporcionar una clave para los metadatos.
      • contact - Asignar cero o más contactos a un objeto de recurso. Un contacto es una persona o entidad que puede suministrar información acerca del objeto de recurso.
      • note - No asignar más de una nota a un objeto de recurso. Una nota es un texto arbitrario.

      Para obtener detalles sobre el contenido del archivo, consulte las secciones Ejemplo: admin-metadata.xml en un directorio de configuración de servidor y Ejemplo: admin-metadata.xml en el directorio etc de tiempo de ejecución.

      Las etiquetas que contienen caracteres en mayúsculas se convierten a minúsculas antes del despliegue en el repositorio de colectivo. Por tanto, <tag>MyTag</tag> en un archivo admin-metadata.xml se visualiza como mytag en Centro de administración.

    3. Guarde los cambios de archivo.

Resultados

Los metadatos de servidor del directorio de configuración del servidor se despliegan en el repositorio de colectivo o se retiran del mismo cuando se producen los sucesos siguientes:

  • El servidor se une al controlador de colectivo a través del mandato join colectivo
  • El controlador o servidor miembro se inicia
  • Un miembro se elimina del controlador de colectivo a través del mandato remove de colectivo
  • El archivo admin-metadata.xml cambia

    El producto supervisa el archivo admin-metadata.xml después de que se inicie el servidor y actualiza dinámicamente los metadatos del servidor en el repositorio de colectivo para reflejar los cambios del archivo.

    Importante: [Actualizado en mayo de 2015] Asegúrese de que el servidor se esté ejecutando cuando suprima un archivo admin-metadata.xml. Si se suprime un archivo admin-metadata.xml mientras el servidor está en ejecución, el producto elimina los metadatos del repositorio. Si se suprimen algunos elementos del archivo cuando el servidor está detenido, el producto elimina esos elementos del repositorio cuando se inicia el servidor. No obstante, si se suprime el archivo admin-metadata.xml mientras el servidor está detenido, los metadatos no se eliminarán del repositorio cuando se inicie el servidor. [Actualizado en mayo de 2015]

Los metadatos de clúster se despliegan en el repositorio colectivo, o se cancela el despliegue del repositorio colectivo cuando se produce alguno de estos sucesos:

  • Un miembro del clúster se conecta al controlador, como por ejemplo cuando se inicia un miembro de clúster
  • El archivo admin-metadata.xml cambia para un miembro de clúster
  • Se elimina el último miembro del clúster, como cuando se detiene el último miembro del clúster

Los metadatos de aplicación se despliegan en el repositorio de colectivo cuando se producen los sucesos siguientes:

  • Una aplicación se instala en un servidor o un clúster
  • El archivo admin-metadata.xml cambia para una aplicación

Los metadatos de tiempo de ejecución se despliegan en el repositorio de colectivo o se retiran del mismo cuando se producen los sucesos siguientes:

  • Un servidor se une al controlador de colectivo a través del mandato join de colectivo
  • Se anula el directorio de instalación de tiempo de ejecución (${wlp.install.dir}), lo que da como resultado una anulación del despliegue
  • No hay ninguna actualización dinámica a través del supervisor de archivos o el MBean AdminMetadataManager

    El producto no supervisa el archivo admin-metadata.xml del directorio etc. Debe reiniciar el servidor para actualizar los metadatos de tiempo de ejecución en el repositorio de colectivo.

Nota: los cambios efectuados en los metadatos del repositorio utilizando Centro de administración no se eliminan a menos que el recurso se elimine completamente del colectivo.

Archivos admin-metadata.xml de ejemplo

Los ejemplos siguientes muestran archivos admin-metadata.xml para metadatos de servidor y tiempo de ejecución:

Ejemplo: admin-metadata.xml en un directorio de configuración de servidor

<admin-metadata>
    
    <server owner="John Doe">
        <tag>servertag1</tag>
        <tag>servertag2</tag>
        <tag>servertag3</tag>
        <contact>Mike</contact>
        <contact>Fred</contact>
        <contact>Susan</contact>
        <note>Este servidor es el mejor.</note>
    </server>		
    <cluster name="cluster1" owner="Tom Wood">
        <tag>clustertag1</tag>
        <tag>clustertag2</tag>
        <tag>clustertag3</tag>
        <contact>Roger</contact>
        <contact>Steve</contact>
        <contact>David</contact>
        <note>Este clúster es el mejor.</note>
    </cluster>
	
    <application name="app1" owner="Sam Hardison">
        <tag>app1tag1</tag>
        <tag>app1tag2</tag>
        <tag>app1tag3</tag>
        <contact>Jack</contact>
        <contact>Tom</contact>
        <contact>Michael</contact>
        <note>Liberty 8.5.5.x with IBM JDK</note>
    </application>	
	
    <application name="app2" owner="Michael Dell">
        <tag>app2tag1</tag>
        <tag>app2tag2</tag>
        <tag>app2tag3</tag>
        <contact>Susan</contact>
        <contact>Roger</contact>
        <contact>Fred</contact>
        <note>Liberty 8.5.5.x with IBM JDK</note>
    </application>	

</admin-metadata>	

Ejemplo: admin-metadata.xml en el directorio etc de tiempo de ejecución

<admin-metadata>
	
    <runtime owner="Admin Boss">
        <tag>runtimetag1</tag>
        <tag>runtimetag2</tag>
        <tag>runtimetag3</tag> 
        <contact>Steven</contact> 
        <note>Liberty 8.5.5.x with IBM JDK</note>
    </runtime>

</admin-metadata>

Qué hacer a continuación

Puede ver los metadatos de administración en Centro de administración. Por ejemplo, supongamos que un controlador de colectivo denominado controller1 tiene el siguiente archivo admin-metadata.xml en su directorio de configuración del servidor, $WLP_USER_DIR/servers/controller1:

<admin-metadata>
    <server owner="John Doe">
        <tag>controller</tag>
        <tag>replica_controller</tag>
        <contact>Michal</contact>
        <contact>Felix</contact>
        <contact>Travis</contact>
        <contact>Philippa</contact>
        <contact>Amy</contact>
        <note>El primero de tres controladores de réplica. Son necesarios tres controladores de réplica como mínimo para la alta disponibilidad.</note>
    </server>	</admin-metadata>	

Cuando el controlador tiene <feature>adminCenter-1.0</feature> en su configuración de <featureManager>, la herramienta de exploración de Centro de administración muestra los metadatos en los detalles del servidor controller1:

Vista Detalles del servidor de la herramienta Explorar que muestra los metadatos administrativos en el archivo admin-metadata.xml de controller1
Restricción: En este momento, sólo aparecen códigos en la herramienta Explorar para los recursos de servidor, clúster y aplicación. Los códigos para los recursos de tiempo de ejecución no se muestran.

Para obtener información sobre la visualización de metadatos administrativos en la herramienta Explorar, consulte Establecimiento y consulta de los metadatos administrativos en el Centro de administración.

Además, puede utilizar métodos de AdminMetadataManagerMBean para añadir, recuperar y establecer metadatos de aplicación en el repositorio de colectivo, así como para eliminarlos del mismo.


Icono que indica el tipo de tema Tema de tarea

Términos y condiciones para centros de información | Comentarios


Icono de indicación de fecha y hora Última actualización: 15 de junio de 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=tagt_wlp_admin_metadata
Nombre de archivo:tagt_wlp_admin_metadata.html