![[8.5.5.5 或更新版本]](../ng_v8555.gif)
設定 Liberty 資源的管理 meta 資料
您可以使用 admin-metadata.xml 檔,來設定伺服器、叢集、應用程式和執行時期資源的管理 meta 資料。管理 meta 資料可讓您將標籤、擁有者、聯絡人和附註等之類的資訊,與資源產生關聯。meta 資料可簡化資源的管理,且在大型拓蹼中更容易找到資源的相關資訊。舉例來說,如果伺服器需要變更,顯示伺服器擁有者的伺服器 meta 資料有助於您更快找到真正的聯絡人。admin-metadata.xml 檔使用 XML 格式,且依預設,並不存在。您必須建立這個檔案,並將它放在伺服器配置目錄中或 Liberty 設定檔(執行時期)etc 目錄中。將 admin-metadata.xml 檔放在支援的目錄之後,您可以在「管理中心」中檢視 meta 資料,或透過應用程式設計介面 (API) 來擴增 meta 資料。
程序
結果
當發生下列事件時,會將伺服器配置目錄中的伺服器 meta 資料部署至群體儲存庫,或從中取消部署:
- 透過群體 join 指令,將伺服器加入群體控制器中
- 控制器或成員伺服器啟動
- 透過群體 remove 指令,將成員從群體控制器移除
- admin-metadata.xml 檔案變更
在伺服器啟動之後,產品會監視 admin-metadata.xml 檔,並動態更新群體儲存庫中的伺服器 meta 資料,以反映任何的檔案變更。
重要:刪除 admin-metadata.xml 檔時,請確定伺服器正在執行。當伺服器正在執行時,如果刪除 admin-metadata.xml 檔,產品會將 meta 資料從儲存庫移除。當伺服器停止時,如果從檔案中刪除某些元素,當伺服器啟動時,產品會將那些元素從儲存庫移除。不過,如果是在伺服器停止時刪除 admin-metadata.xml 檔,則當伺服器啟動時,不會將 meta 資料從儲存庫移除。
當發生下列事件時,會將叢集 meta 資料部署至群體儲存庫,或從中取消部署:
- 叢集成員連接控制器(例如:當叢集成員啟動時)
- 叢集成員的 admin-metadata.xml 檔已變更
- 移除最後一個叢集成員(例如:當最後一個叢集成員停止時)
當發生下列事件時,會將應用程式 meta 資料部署至群體儲存庫:
- 將應用程式安裝在伺服器或叢集上
- 應用程式的 admin-metadata.xml 檔已變更
當發生下列事件時,會將執行時期 meta 資料部署至群體儲存庫,或從中取消部署:
- 透過群體 join 指令,將伺服器加入群體控制器中
- 取消登錄執行時期安裝目錄 (${wlp.install.dir}),導致取消部署
- 未透過檔案監視器或 AdminMetadataManager MBean 進行動態更新
產品不會監視 etc 目錄中的 admin-metadata.xml 檔。您必須重新啟動伺服器,以更新群體儲存庫中的執行時期 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 資料:

如需在「探索」工具中檢視管理 meta 資料的相關資訊,請參閱在管理中心中設定和檢視管理 meta 資料。
此外,您可以在 AdminMetadataManagerMBean 中使用方法,在群體儲存庫中新增、擷取和設定應用程式 meta 資料,以及將它從群體儲存庫移除。