Liberty 자원에 대한 관리 메타데이터 설정
admin-metadata.xml 파일을 사용하여 서버, 클러스터, 애플리케이션 및 런타임 자원에 대한 관리 메타데이터를 설정할 수 있습니다. 관리 메타데이터를 사용하면 태그, 소유자, 연락처 및 참고와 같은 정보를 자원과 연관시킬 수 있습니다. 이 메타데이터는 자원 관리를 단순화하고 대형 토폴로지 내에서 자원에 대한 정보를 쉽게 찾을 수 있게 해 줍니다. 예를 들어, 서버의 소유자를 표시하는 서버 메타데이터는 서버를 변경해야 하는 경우에 연락해야 하는 사람을 빠르고 정확하게 찾을 수 있게 도와줍니다. admin-metadata.xml 파일은 XML 형식을 사용하며 기본적으로 존재하지 않습니다. 파일을 작성하고 이를 서버 구성 디렉토리 또는 Liberty(런타임) etc 디렉토리에 배치해야 합니다. admin-metadata.xml 파일을 지원되는 디렉토리에 배치하고 나면 Admin Center에서 메타데이터를 보거나 API(Application Programming Interface)를 통해 메타데이터를 보강할 수 있습니다.
프로시저
결과
다음과 같은 이벤트가 발생하면 서버 구성 디렉토리의 서버 메타데이터가 집합체 저장소에 배치되거나 집합체 저장소에서 배치 해제됩니다.
- 서버가 집합체 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>
다음에 수행할 작업
Admin Center에서 관리 메타데이터를 볼 수 있습니다. 예를 들어, 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>가 있는 경우, Admin Center 탐색 도구는 메타데이터를 controller1 서버에 대한 세부사항에 표시합니다.

탐색 도구에서 관리 메타데이터를 보는 것에 대한 정보는 Admin Center에서 관리 메타데이터 설정 및 보기의 내용을 참조하십시오.
또한 AdminMetadataManagerMBean에 있는 메소드를 사용하여 집합체 저장소에서 애플리케이션 메타데이터를 추가하고 검색하고 설정할 수 있으며 집합체 저장소에서 제거할 수도 있습니다.