![[8.5.5.5 o posterior]](../ng_v8555.gif)
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
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: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.
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.
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:

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.