[8.5.5.5 或更高版本]

为 Liberty 资源设置管理元数据

可使用 admin-metadata.xml 文件为服务器、集群、应用程序和运行时资源设置管理元数据。管理元数据允许您将标记、所有者、联系人和注释之类的信息与资源相关联。此元数据可简化资源管理,并简化在大型拓扑中查找有关资源的信息的过程。例如,服务器需要更改时,显示服务器所有者的服务器元数据可帮助您更迅速地找到相应的人员。dmin-metadata.xml 文件使用 XML 格式,并且在缺省情况下不存在。必须创建该文件并将其放置在服务器配置目录或 Liberty 概要文件(运行时)etc 目录中。将 admin-metadata.xml 文件放置在受支持目录中之后,可在 管理中心 中查看元数据或通过应用程序编程接口 (API) 扩充元数据。

过程

  1. 确定您是希望 admin-metadata.xml 文件对特定服务器还是运行时环境中的所有服务器设置元数据。
    server
    服务器配置目录中的 admin-metadata.xml 文件为服务器、其集群及其应用程序设置元数据。文件路径为 ${wlp.install.dir}/usr/servers/server_name/admin-metadata.xml,如果在 server.env 文件或命令窗口中设置了 $WLP_USER_DIR 变量,那么文件路径为 $WLP_USER_DIR/servers/server_name/admin-metadata.xml
    运行时
    运行时 etc 目录中的 admin-metadata.xml 文件为运行时资源设置元数据。此文件对使用该运行时环境的所有服务器可视。文件路径为 ${wlp.install.dir}/etc/admin-metadata.xml。缺省情况下 etc 目录不存在;您必须创建 etc 目录。
  2. admin-metadata.xml 文件中配置管理元数据。
    1. 步骤 1 中确定的位置创建名为 admin-metadata.xml 的文本文件。如果该文件已存在,请对该文件打开编辑器。
    2. 在编辑器中,对以下任何资源对象指定管理元数据:
      • <server> - 最多设置一个服务器元数据。
      • <cluster> - 最多设置一个集群元数据。
      • <application> - 设置任意数目的应用程序元数据。
      • <runtime> - 最多设置一个运行时元数据。
      限制: 不能在 admin-metadata.xml 文件中设置主机元数据。必须使用 管理中心、AdminMetadataManager MBean API 或脚本管理主机元数据。

      对于每个资源对象,请指定最多四种类型的元数据:

      • tag - 对资源对象指定零个或多个标记。可使用标记来搜索资源。
      • owner - 最多对资源对象指定一个所有者。所有者通常为负责元数据的个人或实体。所有者可为元数据提供键。
      • contact - 对资源对象指定零个或多个联系人。联系人是能够提供有关该资源对象的信息的个人或实体。
      • note - 最多对资源对象指定一个注释。注释为任意文本。

      有关文件内容的指南,请参阅 服务器配置目录中的示例 admin-metadata.xml运行时 etc 目录中的示例 admin-metadata.xml

      部署至集合体存储库之前,包含大写字符的标记将转换为小写。因此,admin-metadata.xml 文件中的 <tag>MyTag</tag>管理中心 中显示为 mytag

    3. 保存文件更改。

结果

发生以下事件时,将在集合体存储库中部署或取消部署服务器配置目录中的服务器元数据:

  • 服务器通过集合体 join 命令连接至集合体控制器
  • 控制器或成员服务器启动
  • 通过集合体 remove 命令从集合体控制器移除成员
  • admin-metadata.xml 文件更改

    服务器启动后,此产品监视 admin-metadata.xml 文件,并动态更新集合体存储库中的服务器元数据以反映所有文件更改。

    要点: [2015 年 5 月更新]删除 admin-metadata.xml 文件时,确保服务器正在运行。如果在服务器运行时删除 admin-metadata.xml 文件,那么产品会从存储库中移除元数据。如果在服务器停止时从该文件中删除某些元素,那么产品会在服务器启动时从存储库中移除这些元素。但是,如果在服务器停止时删除 admin-metadata.xml 文件,那么服务器启动时,产品不会从存储库中移除元数据。[2015 年 5 月更新]

发生以下事件时,将在集合体存储库中部署或取消部署集群元数据:

  • 集群成员连接至控制器,例如,集群成员启动时
  • 集群成员的 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 服务器的详细元数据:

浏览工具服务器详细信息视图,显示 controller1 admin-metadata.xml 文件中的管理元数据
限制: 此时,浏览工具中仅显示对应服务器、集群和应用程序资源的标记。不会显示对应运行时资源的标记。

有关在浏览工具中查看管理元数据的信息,请参阅在管理中心中设置和查看管理元数据

而且,可使用 AdminMetadataManagerMBean 中的方法在集合体存储库中添加、检索、设置和移除应用程序元数据。


用于指示主题类型的图标 任务主题

信息中心的条款和条件 | 反馈


时间戳记图标 最近一次更新时间: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=tagt_wlp_admin_metadata
文件名:tagt_wlp_admin_metadata.html