为 Liberty 资源设置管理元数据
可使用 admin-metadata.xml 文件为服务器、集群、应用程序和运行时资源设置管理元数据。管理元数据允许您将标记、所有者、联系人和注释之类的信息与资源相关联。此元数据可简化资源管理,并简化在大型拓扑中查找有关资源的信息的过程。例如,服务器需要更改时,显示服务器所有者的服务器元数据可帮助您更迅速地找到要联系的相应人员。dmin-metadata.xml 文件使用 XML 格式,并且在缺省情况下不存在。必须创建该文件并将其放置在服务器配置目录或 Liberty(运行时)etc 目录中。将 admin-metadata.xml 文件放置在受支持目录中之后,可在 管理中心 中查看元数据或通过应用程序编程接口 (API) 扩充元数据。
过程
结果
发生以下事件时,将在集合体存储库中部署或取消部署服务器配置目录中的服务器元数据:
- 服务器通过集合体 join 命令连接至集合体控制器
- 控制器或成员服务器启动
- 通过集合体 remove 命令从集合体控制器移除成员
- admin-metadata.xml 文件更改
服务器启动后,此产品监视 admin-metadata.xml 文件,并动态更新集合体存储库中的服务器元数据以反映所有文件更改。
要点: 删除 admin-metadata.xml 文件时,确保服务器正在运行。如果在服务器运行时删除 admin-metadata.xml 文件,那么产品会从存储库中移除元数据。如果在服务器停止时从该文件中删除某些元素,那么产品会在服务器启动时从存储库中移除这些元素。但是,如果在服务器停止时删除 admin-metadata.xml 文件,那么服务器启动时,产品不会从存储库中移除元数据。
发生以下事件时,将在集合体存储库中部署或取消部署集群元数据:
- 集群成员连接至控制器,例如,集群成员启动时
- 集群成员的 admin-metadata.xml 文件发生更改
- 最后一个集群成员被移除,例如,最后一个集群成员停止时
发生以下事件时,将在集合体存储库中部署应用程序元数据:
- 应用程序安装在服务器或集群上
- 应用程序的 admin-metadata.xml 文件发生更改
发生以下事件时,将在集合体存储库中部署或取消部署运行时元数据:
- 服务器通过集合体 join 命令连接至集合体控制器
- 运行时安装目录 (${wlp.install.dir}) 注销,导致取消部署
- 未通过文件监视器或 AdminMetadataManager MBean 进行动态更新
此产品不会监视 etc 目录中的 admin-metadata.xml 文件。必须重新启动服务器以更新集合体存储库中的运行时元数据。
示例 admin-metadata.xml 文件
以下示例显示服务器和运行时元数据的 admin-metadata.xml 文件:
服务器配置目录中的示例 admin-metadata.xml
<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>This server is the best server.</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>This cluster is the best cluster.</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>
运行时 etc 目录中的示例 admin-metadata.xml
<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>
下一步做什么
可在管理中心中查看管理元数据。例如,假定名为 controller1 的集合体控制器在其服务器配置目录 $WLP_USER_DIR/servers/controller1 中具有以下 admin-metadata.xml 文件:
<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>The first of three replica controllers. At least three replica controllers are needed for high availability.</note>
</server>
</admin-metadata>
控制器在其 <featureManager> 配置中具有 <feature>adminCenter-1.0</feature> 时,管理中心浏览工具会显示有关 controller1 服务器的详细元数据:

有关在浏览工具中查看管理元数据的信息,请参阅在管理中心中设置和查看管理元数据。
而且,可使用 AdminMetadataManagerMBean 中的方法在集合体存储库中添加、检索、设置和移除应用程序元数据。