8.3. 관리형 도메인 시작

도메인 및 호스트 컨트롤러는 JBoss EAP와 함께 제공된 domain.sh 또는 domain.batch 스크립트 를 사용하여 시작할 수 있습니다. 사용 가능한 모든 시작 스크립트 인수의 전체 목록은 --help 인수를 사용하거나 서버 런타임 인수 섹션을 참조하십시오.

도메인 컨트롤러는 도메인의 모든 서버 그룹에 있는 슬레이브 서버보다 먼저 시작해야 합니다. 먼저 도메인 컨트롤러를 시작한 다음 도메인에서 연결된 다른 호스트 컨트롤러를 시작합니다.

도메인 컨트롤러 시작

전용 도메인 컨트롤러에 대해 사전 구성된 host-master.xml 구성 파일을 사용하여 도메인 컨트롤러를 시작합니다.

EAP_HOME/bin/domain.sh --host-config=host-master.xml

$ EAP_HOME/bin/domain.sh --host-config=host-master.xml

도메인 설정에 따라 호스트 컨트롤러가 연결할 수 있도록 추가 구성을 설정해야 합니다. 다음 예제 도메인 설정도 참조하십시오.

호스트 컨트롤러 시작

슬레이브 호스트 컨트롤러에 대해 사전 구성된 host-slave.xml 구성 파일을 사용하여 호스트 컨트롤러를 시작합니다.

EAP_HOME/bin/domain.sh  --host-config=host-slave.xml

$ EAP_HOME/bin/domain.sh  --host-config=host-slave.xml

도메인 설정에 따라 도메인 컨트롤러와 충돌하지 않고 추가 구성을 연결해야 합니다. 다음 예제 도메인 설정도 참조하십시오.

도메인 컨트롤러로 호스트 작업 구성

호스트는 <domain -controller> 선언에 < local/ > 요소가 포함된 경우 도메인 컨트롤러로 지정됩니다.

<domain-controller>
  <local/>
</domain-controller>

<domain-controller>
  <local/>
</domain-controller>

도메인 컨트롤러 역할을 하는 호스트는 도메인의 다른 호스트에서 액세스할 수 있는 관리 인터페이스를 노출해야 합니다. HTTP(S) 관리 인터페이스를 노출할 필요는 없지만 관리 콘솔에 액세스할 수 있으므로 사용하는 것이 좋습니다.

<management-interfaces>
  <native-interface security-realm="ManagementRealm">
    <socket interface="management" port="${jboss.management.native.port:9999}"/>
  </native-interface>
  <http-interface security-realm="ManagementRealm" http-upgrade-enabled="true">
    <socket interface="management" port="${jboss.management.http.port:9990}"/>
  </http-interface>
</management-interfaces>

<management-interfaces>
  <native-interface security-realm="ManagementRealm">
    <socket interface="management" port="${jboss.management.native.port:9999}"/>
  </native-interface>
  <http-interface security-realm="ManagementRealm" http-upgrade-enabled="true">
    <socket interface="management" port="${jboss.management.http.port:9990}"/>
  </http-interface>
</management-interfaces>

EAP_HOME/domain/configuration/host-master.xml 파일은 도메인 컨트롤러로 작동하도록 이러한 설정으로 이미 사전 구성되어 있습니다.

도메인 컨트롤러에 연결

도메인에 자신을 등록할 수 있도록 도메인 컨트롤러에 연결하려면 호스트 컨트롤러를 제공해야 합니다. 이는 구성의 &lt ;domain-controller& gt; 요소에서 구성됩니다.

<domain-controller>
  <remote security-realm="ManagementRealm">
    <discovery-options>
      <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote}" host="${jboss.domain.master.address}" port="${jboss.domain.master.port:9999}"/>
    </discovery-options>
  </remote>
</domain-controller>

<domain-controller>
  <remote security-realm="ManagementRealm">
    <discovery-options>
      <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote}" host="${jboss.domain.master.address}" port="${jboss.domain.master.port:9999}"/>
    </discovery-options>
  </remote>
</domain-controller>

EAP_HOME/domain/configuration/host-slave.xml 파일은 도메인 컨트롤러에 연결하기 위해 이러한 설정으로 이미 사전 구성되어 있습니다. 호스트 컨트롤러를 시작할 때 jboss.domain.master.address 속성을 제공해야 합니다.

EAP_HOME/bin/domain.sh --host-config=host-slave.xml -Djboss.domain.master.address=IP_ADDRESS

$ EAP_HOME/bin/domain.sh --host-config=host-slave.xml -Djboss.domain.master.address=IP_ADDRESS

도메인 컨트롤러 검색에 대한 자세한 내용은 Domain Controller Discovery 및 Cryostat 섹션을 참조하십시오.

도메인 설정에 따라 도메인 컨트롤러에서 인증할 수 있도록 호스트 컨트롤러에 대한 인증을 제공해야 할 수도 있습니다. 보안 값으로 관리 사용자를 생성하고 해당 값으로 호스트 컨트롤러 구성을 업데이트하는 방법에 대한 자세한 내용은 두 시스템에 관리형 도메인 설정을 참조하십시오.

<host xmlns="urn:jboss:domain:4.0" name="host1">

<host xmlns="urn:jboss:domain:4.0" name="host1">

EAP_HOME/bin/domain.sh --host-config=host-slave.xml  -Djboss.host.name=HOST_NAME

$ EAP_HOME/bin/domain.sh --host-config=host-slave.xml  -Djboss.host.name=HOST_NAME

관리형 도메인을 설정할 때 도메인 컨트롤러에 연결하는 데 필요한 정보를 사용하여 각 호스트 컨트롤러를 구성해야 합니다. JBoss EAP에서 각 호스트 컨트롤러는 도메인 컨트롤러를 찾기 위한 여러 옵션으로 구성할 수 있습니다. 호스트 컨트롤러는 성공할 때까지 옵션 목록을 반복합니다.

이를 통해 백업 도메인 컨트롤러에 대한 연락처 정보로 호스트 컨트롤러를 사전 구성할 수 있습니다. 기본 도메인 컨트롤러에 문제가 있는 경우 백업 호스트 컨트롤러를 마스터로 승격하여 호스트 컨트롤러가 승격되면 새 마스터로 자동으로 페일오버할 수 있습니다.

다음은 도메인 컨트롤러를 찾기 위한 여러 옵션으로 호스트 컨트롤러를 구성하는 방법의 예입니다.

<domain-controller>
  <remote security-realm="ManagementRealm">
    <discovery-options>
      <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote}" host="172.16.81.100" port="${jboss.domain.master.port:9999}"/>
      <static-discovery name="backup" protocol="${jboss.domain.master.protocol:remote}" host="172.16.81.101" port="${jboss.domain.master.port:9999}"/>
    </discovery-options>
  </remote>
</domain-controller>

<domain-controller>
  <remote security-realm="ManagementRealm">
    <discovery-options>
      <static-discovery name="primary" protocol="${jboss.domain.master.protocol:remote}" host="172.16.81.100" port="${jboss.domain.master.port:9999}"/>
      <static-discovery name="backup" protocol="${jboss.domain.master.protocol:remote}" host="172.16.81.101" port="${jboss.domain.master.port:9999}"/>
    </discovery-options>
  </remote>
</domain-controller>

정적 검색 옵션에는 다음과 같은 필수 속성이 포함됩니다.

위의 예에서 첫 번째 검색 옵션은 성공할 것으로 예상되는 옵션입니다. 두 번째는 장애 조치(failover) 상황에서 사용할 수 있습니다.

기본 도메인 컨트롤러에서 문제가 발생하면 --backup 옵션으로 시작한 호스트 컨트롤러를 도메인 컨트롤러로 작동할 수 있습니다.

호스트 컨트롤러를 도메인 컨트롤러로 승격

이제 이 호스트 컨트롤러가 도메인 컨트롤러 역할을 합니다.