Sun Java System Application Server Enterprise Edition 8.2 관리 설명서

18장 domain.xml의 점으로 구분된 이름 속성

이 부록에서는 MBean과 해당 속성을 지정하는 데 사용할 수 있는 점으로 구분된 이름 속성에 대해 설명합니다. domain.xml 파일의 모든 요소에는 해당하는 MBean이 있습니다. 이 이름을 사용하는 구문에서는 점으로 이름을 구분해야 하기 때문에 이 이름을 점으로 구분된 이름이라고 합니다.

*(별표)는 위치와 상관없이 점으로 구분된 이름의 일부로 사용할 수 있으며 정규 표현식에서 와일드카드 문자의 역할을 합니다. 와일드카드 문자를 사용하면 점으로 구분된 이름의 일부분을 축약할 수 있는 이점을 얻을 수 있습니다. 예를 들어, this.is.really.long.hierarchy와 같이 점으로 구분된 이름이 긴 경우 th*.hierarchy로 축약할 수 있습니다. 하지만 .은 항상 이름을 구분하는 역할을 합니다. *를 사용하면 점으로 구분된 이름의 전체 목록이 표시됩니다.

이 부록은 다음 내용으로 구성되어 있습니다.

최상위 수준 요소

domain.xml 파일의 모든 최상위 수준 요소에 대해서 다음 조건을 준수해야 합니다.

모든 서버, 구성, 클러스터 또는 노드 에이전트에는 고유한 이름이 있어야 합니다.
서버, 구성, 클러스터 또는 노드 에이전트 이름을 domain으로 지정할 수 없습니다.
서버 인스턴스 이름을 agent로 지정할 수 없습니다.

다음 표에서는 최상위 수준 요소와 해당하는 점으로 구분된 이름 접두어를 설명합니다.

요소 이름	점으로 구분된 이름 접두어
applications	`domain.applications`
resources	`domain.resources`
configurations	`domain.configs`
servers	`domain.servers` 이 요소에 포함된 모든 서버는 server-name으로 액세스할 수 있습니다. 여기에서 server-name은 서버 하위 요소에 대한 이름 속성 값입니다.
clusters	`domain.clusters` 이 요소에 포함된 모든 클러스터는 cluster-name 으로 액세스할 수 있습니다. 여기에서 cluster-name 은 클러스터 하위 요소의 이름 속성 값입니다.
node-agents	`domain.node-agents`
lb-configs	`domain.lb-configs`
system-property	`domain.system-property`

두 가지 수준의 별칭을 사용할 수 있습니다.

첫 번째 수준의 별칭을 사용하여 domain.servers 또는 domain.clusters 접두어를 검색하지 않고 서버 인스턴스 또는 클러스터의 속성에 액세스할 수 있습니다. 따라서, server1 양식과 같이 점으로 구분된 이름은 점으로 구분된 이름 domain.servers.server1로 매핑되며 여기서 server1은 서버 인스턴스입니다.
두 번째 수준의 별칭을 사용하여 클러스터나 독립 실행형 서버 인스턴스 대상의 구성 응용 프로그램 및 자원을 참조합니다.

다음 표에서는 도메인의 최상위 수준 이름에 대한 별칭인 서버 이름이나 클러스터 이름으로 시작하는 점으로 구분된 이름을 설명합니다.

점으로 구분된 이름	별칭	설명
`target.applications.*`	`domain.applications.*`	별칭은 `target`에서만 참조하는 응용 프로그램으로 변환됩니다.
`target.resources.*`	`domain.resources.*`	별칭은 모든 `jdbc-connection-pool`, `connector-connection-pool`, `resource-adapter-config` 및 `target`에서 참조되는 다른 모든 자원으로 변환됩니다.

다음 표에서는 서버나 클러스터에서 참조하는 구성 내의 최상위 수준 이름으로 별칭 지정된 서버 이름이나 클러스터 이름으로 시작하는 점으로 구분된 이름을 설명합니다.

점으로 구분된 이름	별칭
`target.http-service`	`config-name.http-service`
`target.iiop-service`	`config-name.iiop-service`
`target.admin-service`	`config-name.admin-service`
`target.web-container`	`config-name.web-container`
`target.ejb-container`	`config-name.ejb-container`
`target.mdb-container`	`config-name.mdb-container`
`target.jms-service`	`config-name.jms-service`
`target.log-service`	`config-name.log-service`
`target.security-service`	`config-name.security-service`
`target.transaction-service`	`config-name.transaction-service`
`target.monitoring-service`	`config-name.monitoring-service`
`target.java-config`	`config-name.java-config`
`target.availability-service`	`config-name.availability-service`
`target.thread-pools`	`config-name.thread-pools`

별칭을 지정하지 않는 요소

클러스터화된 인스턴스는 별칭을 지정해서는 안 됩니다. 클러스터화된 인스턴스의 시스템 등록 정보를 가져올 때 점으로 구분된 이름 속성으로 clustered-instance-name.system-property가 아닌 domain.servers.clustered-instance-name.system-property를 사용해야 합니다.

asadmin 명령

asadmin get, set 및 list 명령을 차례대로 실행하면 Application Server의 추상 계층에 대한 탐색 메커니즘이 제공됩니다. 계층에는 구성 및 모니터링의 두 가지 계층이 있으며 이 명령은 두 가지 계층 모두에서 작동합니다. list 명령은 읽기 전용 또는 수정 가능한 속성을 갖는 관리 구성 요소의 점으로 구분된 정규화된 이름을 제공합니다.

구성 계층은 수정 가능한 속성을 제공하지만, 모니터링 계층은 읽기 전용의 관리 구성 요소 속성만을 제공합니다. 구성 계층은 어느 정도 도메인의 스키마 문서를 기반으로 합니다. list 명령을 사용하면 원하는 계층의 특정 관리 구성 요소에 연결할 수 있습니다. 그런 다음 get 및 set 명령을 호출하면 이름 및 값을 얻거나 관리 구성 요소의 속성 값을 설정할 수 있습니다. 와일드카드(*) 옵션을 사용하면 점으로 구분된 정규화된 해당 이름과 일치하는 모든 항목을 불러올 수 있습니다. get, set 및 list 명령의 사용 예는 다음 설명서 페이지를 참조하십시오.

get(1)

set(1)

list(1)