24.2. JGroups와의 클러스터 통신

절차

1. 기본 스택을 OPENSHIFT 하위 시스템에서 udp 에서 tcp 로 변경합니다.

   <channel name="ee" stack="tcp" cluster="ejb"/>

2. 기본 MPING 프로토콜 대신 TCPPING 프로토콜을 사용하도록 TCP 스택을 구성합니다. 다음 코드에서 initial_hosts 속성은 클러스터 내의 모든 노드 목록과 상관 관계가 있으며 7600 은 구성 및 환경에 따라 다를 수 있는 기본 RuntimeClass -tcp 포트를 나타냅니다.

   <stack name="tcp">
     <transport type="TCP" socket-binding="jgroups-tcp"/>
     <protocol type="TCPPING">
       <property name="initial_hosts">192.168.1.5[7600],192.168.1.9[7600]</property>
       <property name="port_range">0</property>
     </protocol>
     <protocol type="MERGE3"/>
     <protocol type="FD_SOCK" socket-binding="jgroups-tcp-fd"/>
     <protocol type="FD_ALL"/>
     <protocol type="VERIFY_SUSPECT"/>
     <protocol type="pbcast.NAKACK2"/>
     <protocol type="UNICAST3"/>
     <protocol type="pbcast.STABLE"/>
     <protocol type="pbcast.GMS"/>
     <protocol type="MFC"/>
     <protocol type="FRAG3"/>
   </stack>

   참고

   initial_hosts 에 설정된 포트 번호 7600 은 RuntimeClass -tcp 소켓 바인딩 정의에 정의된 포트 번호와 동일해야 합니다. socket-binding에 port-offset 기능을 사용하는 경우 initial_hosts 에서 오프셋 후 동일한 값을 지정해야 합니다.

3. NotReady 구성 요소에서 사용하는 개인 인터페이스의 IP 주소를 설정합니다. IP 주소는 initial_hosts 에 지정된 IP 주소 중 하나와 상관 관계가 있어야 합니다.

   <interface name="private">
     <inet-address value="${jboss.bind.address.private:192.168.1.5}"/>
   </interface>

4. 클러스터 내의 다른 노드를 구성하려면 위의 단계를 반복합니다. 노드가 구성되면 각 노드를 시작하고 클러스터된 애플리케이션을 배포합니다.

절차

1. 여러 클러스터에 동일한 프로필이 사용되는 경우 system 속성 값을 initial_hosts 로 설정합니다.

   <protocol type="TCPPING">
     <property name="initial_hosts">${jboss.cluster.tcp.initial_hosts}</property>
   
   Set the system property at the `server-group` level:
   <server-groups>
     <server-group name="a-server-group" profile="ha">
     <socket-binding-group ref="ha-sockets"/>
     <system-properties>
       <property name="jboss.cluster.tcp.initial_hosts" value="192.168.1.5[7600],192.168.1.9[7600]" />
     </system-properties>

2. 호스트 컨트롤러의 XML 구성 내에서 개인 인터페이스의 IP 주소를 설정합니다. 개인 인터페이스의 IP 주소는 initial_hosts 에 나열된 IP 주소 중 하나와 상관 관계가 있어야 합니다.

   <interfaces>
       ....
     <interface name="private">
       <inet-address value="${jboss.bind.address.private:192.168.1.5}"/>
     </interface>
   </interfaces>

1. 키 저장소를 생성합니다.

   $ keytool -genkeypair -alias jgroups_key -keypass my_password -storepass my_password -storetype jks -keystore jgroups.keystore -keyalg RSA

2. 관리 CLI를 사용하여 elytron 하위 시스템에 키 저장소를 추가합니다.

   /subsystem=elytron/key-store=jgroups-token-store:add(type=jks,path=/path/to/jgroups.keystore,credential-reference={clear-text=my_password}, required=true)

3. JGroups 스택 정의에서 키 저장소를 사용하도록 AUTH 를 구성합니다.

   ...
   <protocol type="pbcast.STABLE"/>
   <auth-protocol type="AUTH">
     <cipher-token algorithm="RSA" key-alias="jgroups_key" key-store="jgroups-token-store">
       <shared-secret-reference clear-text="my_password"/>
       <key-credential-reference clear-text="my_password"/>
     </cipher-token>
   </auth-protocol>
   <protocol type="pbcast.GMS"/>
   ...

1. 키 저장소를 생성합니다.

   다음 명령에서 VERSION을 적절한 JGroups JAR 버전으로 바꾸고 PASSWORD 를 키 저장소 암호로 바꿉니다.

   $ java -cp EAP_HOME/modules/system/layers/base/org/jgroups/main/jgroups-VERSION.jar org.jgroups.demos.KeyStoreGenerator --alg AES --size 128 --storeName defaultStore.keystore --storepass PASSWORD --alias mykey

   이렇게 하면 JGroups 구성에서 참조되는 기본Store.keystore 파일이 생성됩니다.

2. 키 저장소가 생성되면 두 가지 방법 중 하나를 사용하여 SYM_PROTOCOL 에 정의됩니다.

   • 구성에서 직접 키 저장소를 지정합니다.
   • Elytron 하위 시스템을 사용하여 키 저장소를 참조합니다.

1. jgroups 하위 시스템에서 SYM_ENCRYPT 프로토콜을 구성합니다.

   적용 가능한 서버 구성 파일에서 적절한 속성 설정을 사용하여 SYM_ENCRYPT 프로토콜을 추가합니다. 이 프로토콜은 이전에 생성된 키 저장소를 참조합니다. SYM_ENCRYPT 프로토콜은 pbcast.NAKACK2 프로토콜 전에 즉시 구성해야 합니다.

   <subsystem xmlns="urn:jboss:domain:jgroups:6.0">
     <stacks>
       <stack name="udp">
         <transport type="UDP" socket-binding="jgroups-udp"/>
         <protocol type="PING"/>
         <protocol type="MERGE3"/>
         <protocol type="FD_SOCK"/>
         <protocol type="FD_ALL"/>
         <protocol type="VERIFY_SUSPECT"/>
         <protocol type="SYM_ENCRYPT">
           <property name="provider">SunJCE</property>
           <property name="sym_algorithm">AES</property>
           <property name="encrypt_entire_message">true</property>
           <property name="keystore_name">/path/to/defaultStore.keystore</property>
           <property name="store_password">PASSWORD</property>
           <property name="alias">mykey</property>
         </protocol>
         <protocol type="pbcast.NAKACK2"/>
         <protocol type="UNICAST3"/>
         <protocol type="pbcast.STABLE"/>
         <protocol type="pbcast.GMS"/>
         <protocol type="UFC"/>
         <protocol type="MFC"/>
         <protocol type="FRAG3"/>
       </stack>
     </stacks>
   </subsystem>

1. 관리 CLI를 사용하여 대칭 암호화를 사용하여 에 생성된 기본Store.keystore 를 참조하는 elytron 하위 시스템에 키 저장소를 생성합니다.

   /subsystem=elytron/key-store=jgroups-keystore:add(path=/path/to/defaultStore.keystore,credential-reference={clear-text=PASSWORD},type=JCEKS)

2. 적절한 속성 설정을 사용하여 jgroups 하위 시스템에 SYM_ENCRYPT 프로토콜을 추가합니다. SYM_ENCRYPT 프로토콜은 다음 설정에서 볼 수 있듯이 pbcast.NAKACK2 프로토콜 바로 앞에 구성해야 합니다.

   <subsystem xmlns="urn:jboss:domain:jgroups:6.0">
     <stacks>
       <stack name="udp">
         <transport type="UDP" socket-binding="jgroups-udp"/>
         <protocol type="PING"/>
         <protocol type="MERGE3"/>
         <protocol type="FD_SOCK"/>
         <protocol type="FD_ALL"/>
         <protocol type="VERIFY_SUSPECT"/>
         <encrypt-protocol type="SYM_ENCRYPT" key-alias="mykey" key-store="jgroups-keystore">
           <key-credential-reference clear-text="PASSWORD"/>
           <property name="provider">SunJCE</property>
           <property name="encrypt_entire_message">true</property>
         </encrypt-protocol>
         <protocol type="pbcast.NAKACK2"/>
         <protocol type="UNICAST3"/>
         <protocol type="pbcast.STABLE"/>
         <protocol type="pbcast.GMS"/>
         <protocol type="UFC"/>
         <protocol type="MFC"/>
         <protocol type="FRAG3"/>
       </stack>
     </stacks>
   </subsystem>

   참고

   위의 예제에서는 일반 텍스트 암호를 사용하지만 구성 파일 외부에서 암호를 정의하도록 자격 증명 저장소를 정의할 수도 있습니다. 이 저장소 구성에 대한 자세한 내용은 How to Configure Server Security Guide의 Credential Store 섹션을 참조하십시오.

1. jgroups 하위 시스템에서 ASYM_ENCRYPT 프로토콜을 구성합니다.

   적용 가능한 서버 구성 파일에서 적절한 속성 설정을 사용하여 ASYM_ENCRYPT 프로토콜을 추가합니다. 다음 설정에서 볼 수 있듯이 ASYM_ENCRYPT 프로토콜은 pbcast.NAKACK2 프로토콜 바로 앞에 구성해야 합니다.

   <subsystem xmlns="urn:jboss:domain:jgroups:6.0">
     <stacks>
       <stack name="udp">
         <transport type="UDP" socket-binding="jgroups-udp"/>
         <protocol type="PING"/>
         <protocol type="MERGE3"/>
         <protocol type="FD_SOCK"/>
         <protocol type="FD_ALL"/>
         <protocol type="VERIFY_SUSPECT"/>
         <protocol type="ASYM_ENCRYPT">
           <property name="encrypt_entire_message">true</property>
           <property name="sym_keylength">128</property>
           <property name="sym_algorithm">AES/ECB/PKCS5Padding</property>
           <property name="asym_keylength">512</property>
           <property name="asym_algorithm">RSA</property>
         </protocol>
         <protocol type="pbcast.NAKACK2"/>
         <protocol type="UNICAST3"/>
         <protocol type="pbcast.STABLE"/>
         <!-- Configure AUTH protocol here -->
         <protocol type="pbcast.GMS"/>
         <protocol type="UFC"/>
         <protocol type="MFC"/>
         <protocol type="FRAG3"/>
       </stack>
     </stacks>
   </subsystem>

1. 키 쌍을 포함할 키 저장소를 생성합니다. 다음 명령은 mykey 항목을 사용하여 키 저장소를 생성합니다.

   $ keytool -genkeypair -alias mykey -keyalg RSA -keysize 1024 -keystore defaultKeystore.keystore -dname "CN=localhost" -keypass secret -storepass secret

2. 관리 CLI를 사용하여 defaultStore.keystore 를 참조하는 elytron 하위 시스템에서 키 저장소를 생성합니다.

   /subsystem=elytron/key-store=jgroups-keystore:add(path=/path/to/defaultStore.keystore,credential-reference={clear-text=PASSWORD},type=JCEKS)

3. 적절한 속성 설정을 사용하여 jgroups 하위 시스템에 ASYM_ENCRYPT 프로토콜을 추가합니다. 다음 설정에서 볼 수 있듯이 ASYM_ENCRYPT 프로토콜은 pbcast.NAKACK2 프로토콜 바로 앞에 구성해야 합니다.

   <subsystem xmlns="urn:jboss:domain:jgroups:6.0">
     <stacks>
       <stack name="udp">
         <transport type="UDP" socket-binding="jgroups-udp"/>
         <protocol type="PING"/>
         <protocol type="MERGE3"/>
         <protocol type="FD_SOCK"/>
         <protocol type="FD_ALL"/>
         <protocol type="VERIFY_SUSPECT"/>
         <encrypt-protocol type="ASYM_ENCRYPT" key-alias="mykey" key-store="jgroups-keystore">
           <key-credential-reference clear-text="secret" />
           <property name="encrypt_entire_message">true</property>
         </encrypt-protocol>
         <protocol type="pbcast.NAKACK2"/>
         <protocol type="UNICAST3"/>
         <protocol type="pbcast.STABLE"/>
         <!-- Configure AUTH protocol here -->
         <protocol type="pbcast.GMS"/>
         <protocol type="UFC"/>
         <protocol type="MFC"/>
         <protocol type="FRAG3"/>
       </stack>
     </stacks>
   </subsystem>

   참고

   위의 예제에서는 일반 텍스트 암호를 사용하지만 구성 파일 외부에서 암호를 정의하도록 자격 증명 저장소를 정의할 수도 있습니다. 이 저장소 구성에 대한 자세한 내용은 How to Configure Server Security Guide의 Credential Store 섹션을 참조하십시오.