[8.5.5.5 이상]

Liberty 자원에 대한 관리 메타데이터 설정

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

프로시저

  1. admin-metadata.xml 파일이 런타임 환경의 모든 서버 또는 특정 서버에 대한 메타데이터를 설정하길 원하는지 판별하십시오.
    서버
    서버 구성 디렉토리에 있는 admin-metadata.xml 파일은 서버, 해당 클러스터 및 해당 애플리케이션에 대한 메타데이터를 설정합니다. 파일 경로는 ${wlp.install.dir}/usr/servers/server_name/admin-metadata.xml입니다. $WLP_USER_DIR 변수가 server.env 파일 또는 명령 창에서 설정되는 경우에는 $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 파일에서는 호스트 메타데이터를 설정할 수 없습니다. Admin Center이나 AdminMetadataManager MBean API 또는 스크립트를 사용하여 호스트 메타데이터를 관리해야 합니다.

      각각의 자원 오브젝트에 대해 최대 네 가지 유형의 메타데이터를 지정하십시오.

      • tag - 자원 오브젝트에 0개 이상의 태그를 지정합니다. 사용자는 태그를 사용하여 자원을 검색합니다.
      • owner - 자원 오브젝트에 하나 이하의 소유자를 지정합니다. 소유자는 일반적으로 메타데이터를 담당하는 개인 또는 엔티티입니다. 소유자는 메타데이터의 키를 제공할 수 있습니다.
      • contact - 자원 오브젝트에 0개 이상의 담당자를 지정합니다. 담당자는 자원 오브젝트에 대한 정보를 제공할 수 있는 개인 또는 엔티티입니다.
      • note - 자원 오브젝트에 하나 이하의 참고를 지정합니다. 참고는 임의의 텍스트입니다.

      파일 컨텐츠에 대한 지침은 예: 서버 구성 디렉토리의 admin-metadata.xml예: 런타임 etc 디렉토리의 admin-metadata.xml의 내용을 참조하십시오.

      대문자가 포함된 태그는 집합체 저장소에 배치하기 전에 소문자로 변환됩니다. 따라서 admin-metadata.xml 파일의 <tag>MyTag</tag>Admin Center에서 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 Center을 사용하여 저장소에서 메타데이터에 대해 작성된 변경사항은 제거되지 않습니다.

예제 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 서버에 대한 세부사항에 표시합니다.

controller1 admin-metadata.xml 파일의 관리 메타데이터를 표시하는 탐색 도구 서버 세부사항 보기
제한사항: 이때 탐색 도구에서 태그는 서버, 클러스터 및 애플리케이션 자원에 대해서만 표시됩니다. 런타임 자원에 대한 태그는 표시되지 않습니다.

탐색 도구에서 관리 메타데이터를 보는 것에 대한 정보는 Admin Center에서 관리 메타데이터 설정 및 보기의 내용을 참조하십시오.

또한 AdminMetadataManagerMBean에 있는 메소드를 사용하여 집합체 저장소에서 애플리케이션 메타데이터를 추가하고 검색하고 설정할 수 있으며 집합체 저장소에서 제거할 수도 있습니다.


주제의 유형을 표시하는 아이콘 태스크 주제

Information Center 이용 약관 | 피드백


시간소인 아이콘 마지막 업데이트 날짜: 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