[8.5.5.5 或更新版本]

設定 Liberty 資源的管理 meta 資料

您可以使用 admin-metadata.xml 檔,來設定伺服器、叢集、應用程式和執行時期資源的管理 meta 資料。管理 meta 資料可讓您將標籤、擁有者、聯絡人和附註等之類的資訊,與資源產生關聯。meta 資料可簡化資源的管理,且在大型拓蹼中更容易找到資源的相關資訊。舉例來說,如果伺服器需要變更,顯示伺服器擁有者的伺服器 meta 資料有助於您更快找到真正的聯絡人。admin-metadata.xml 檔使用 XML 格式,且依預設,並不存在。您必須建立這個檔案,並將它放在伺服器配置目錄中或 Liberty 設定檔(執行時期)etc 目錄中。將 admin-metadata.xml 檔放在支援的目錄之後,您可以在「管理中心」中檢視 meta 資料,或透過應用程式設計介面 (API) 來擴增 meta 資料。

程序

  1. 判斷您是否需要 admin-metadata.xml 檔,以便為執行時期環境中的特定伺服器或所有伺服器設定 meta 資料。
    server
    伺服器配置目錄中的 admin-metadata.xml 檔用來設定伺服器、其叢集和其應用程式的 meta 資料。檔案路徑是 ${wlp.install.dir}/usr/servers/server_name/admin-metadata.xml,或者如果在 server.env 檔案或指令視窗中設定了 $WLP_USER_DIR 變數,則檔案路徑是 $WLP_USER_DIR/servers/server_name/admin-metadata.xml
    runtime
    執行時期 etc 目錄中的 admin-metadata.xml 檔用來設定執行時期資源的 meta 資料。凡是使用執行時期環境的伺服器都可以看到這個檔案。檔案路徑是 ${wlp.install.dir}/etc/admin-metadata.xml。依預設,etc 目錄不存在;您必須建立 etc 目錄。
  2. admin-metadata.xml 檔中配置管理 meta 資料。
    1. 在您於步驟 1 決定的位置中,建立一個名稱是 admin-metadata.xml 的文字檔。如果檔案已存在,請在編輯器中開啟該檔案。
    2. 在編輯器中,指定下列任何資源物件的管理 meta 資料:
      • <server> - 設定單一伺服器的 meta 資料。
      • <cluster> - 設定單一叢集的 meta 資料。
      • <application> - 設定應用程式(數量不拘)的 meta 資料。
      • <runtime> - 設定單一執行時期的 meta 資料。
      限制: 您不能在 admin-metadata.xml 檔中設定主機 meta 資料。必須使用「管理中心」或 AdminMetadataManager MBean API 或 Script,來管理主機 meta 資料。

      針對每一個資源物件,指定最多四種類型的 meta 資料:

      • tag - 將零或多個標籤指派給資源物件。您將使用標籤來搜尋資源。
      • owner - 將單一擁有者指派給資源物件。擁有者通常是負責 meta 資料的人員或實體。擁有者可以提供 meta 資料的索引鍵。
      • contact - 將零或多個聯絡人指派給資源物件。聯絡人是可以提供資源物件相關資訊的人員或實體。
      • note - 將單一附註指派給資源物件。附註是任意文字。

      如需檔案內容的指引,請參閱範例:伺服器配置目錄中的 admin-metadata.xml範例:執行時期 etc 目錄中的 admin-metadata.xml

      含有大寫字元的標籤會先轉換成小寫,再部署至群體儲存庫。因此,admin-metadata.xml 檔中的 <tag>MyTag</tag> 在「管理中心」中會顯示成 mytag

    3. 儲存檔案的變更。

結果

當發生下列事件時,會將伺服器配置目錄中的伺服器 meta 資料部署至群體儲存庫,或從中取消部署:

  • 透過群體 join 指令,將伺服器加入群體控制器中
  • 控制器或成員伺服器啟動
  • 透過群體 remove 指令,將成員從群體控制器移除
  • admin-metadata.xml 檔案變更

    在伺服器啟動之後,產品會監視 admin-metadata.xml 檔,並動態更新群體儲存庫中的伺服器 meta 資料,以反映任何的檔案變更。

    重要: [2015 年 5 月更新]刪除 admin-metadata.xml 檔時,請確定伺服器正在執行。當伺服器正在執行時,如果刪除 admin-metadata.xml 檔,產品會將 meta 資料從儲存庫移除。當伺服器停止時,如果從檔案中刪除某些元素,當伺服器啟動時,產品會將那些元素從儲存庫移除。不過,如果是在伺服器停止時刪除 admin-metadata.xml 檔,則當伺服器啟動時,不會將 meta 資料從儲存庫移除。[2015 年 5 月更新]

當發生下列事件時,會將叢集 meta 資料部署至群體儲存庫,或從中取消部署:

  • 叢集成員連接控制器(例如:當叢集成員啟動時)
  • 叢集成員的 admin-metadata.xml 檔已變更
  • 移除最後一個叢集成員(例如:當最後一個叢集成員停止時)

當發生下列事件時,會將應用程式 meta 資料部署至群體儲存庫:

  • 將應用程式安裝在伺服器或叢集上
  • 應用程式的 admin-metadata.xml 檔已變更

當發生下列事件時,會將執行時期 meta 資料部署至群體儲存庫,或從中取消部署:

  • 透過群體 join 指令,將伺服器加入群體控制器中
  • 取消登錄執行時期安裝目錄 (${wlp.install.dir}),導致取消部署
  • 未透過檔案監視器或 AdminMetadataManager MBean 進行動態更新

    產品不會監視 etc 目錄中的 admin-metadata.xml 檔。您必須重新啟動伺服器,以更新群體儲存庫中的執行時期 meta 資料。

註: 使用「管理中心」對儲存庫中的 meta 資料所做的變更並不會移除,除非將資源從群體完整移除。

範例 admin-metadata.xml

下列範例顯示 伺服器執行時期 meta 資料的 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>

下一步

您可以在「管理中心」中檢視管理 meta 資料。舉例來說,假設群體控制器名稱是 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 伺服器的詳細 meta 資料:

「探索」工具伺服器詳細資料視圖,其中顯示 controller1 admin-metadata.xml 檔中的管理 meta 資料
限制: 在「探索」工具中,目前只會顯示伺服器、叢集和應用程式資源的標籤。不會顯示執行時期資源的標籤。

如需在「探索」工具中檢視管理 meta 資料的相關資訊,請參閱在管理中心中設定和檢視管理 meta 資料

此外,您可以在 AdminMetadataManagerMBean 中使用方法,在群體儲存庫中新增、擷取和設定應用程式 meta 資料,以及將它從群體儲存庫移除。


指示主題類型的圖示 作業主題

資訊中心條款 | 意見


「時間戳記」圖示 前次更新: 2015 年 6 月 22 日
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=tagt_wlp_admin_metadata
檔名:tagt_wlp_admin_metadata.html