Liberty 집합체 복제본 세트 구성

집합체 복제본 세트를 구성할 수 있습니다. 복제본 세트는 Liberty 관리 도메인에 대해 고가용성 관리 기능을 제공합니다.

분산 플랫폼용IBM i 플랫폼의 경우

시작하기 전에

collectiveController-1.0 기능은 WebSphere® Application Server Liberty Network Deployment 및 WebSphere Application Server Liberty for z/OS®에서만 사용할 수 있습니다. 이 기능은 WebSphere Application Server Liberty, WebSphere Application Server Liberty - Express 또는 WebSphere Application Server Liberty Core에서는 사용할 수 없습니다. WebSphere Application Server Liberty Network Deployment 설치를 가지고 있는 경우에는 해당 collectiveController-1.0 기능을 사용하여 WebSphere Application Server Liberty, WebSphere Application Server Liberty - Express 또는 WebSphere Application Server Liberty Core 설치의 집합체 멤버에 대해 작업할 수 있습니다. 집합체 멤버는 모든 WebSphere Application Server Liberty 릴리스에서 제공될 수 있습니다.

이 태스크 정보

복제본 세트는 함께 작업하도록 구성되는 집합체 제어기 세트입니다. 각 복제본에는 해당 세트에 포함된 기타 복제본이 처리한 저장소 업데이트가 모두 포함되어 있습니다. 따라서 멤버 또는 클라이언트는 집합체와 상호작용할 때마다 특정 집합체 제어기와 연결하지 않아도 되며 복제본 세트에서 구성되는 집합체 제어기는 모두 동일한 데이터를 제공할 수 있습니다.

집합체 제어기 작성 및 구성에 대한 자세한 지시사항은 Liberty 집합체 구성의 내용을 참조하십시오.

다음의 프로시저를 완료하여 집합체 복제본 세트를 구성할 수 있습니다.

  1. 기존 복제본 세트에 복제본 추가를 수행하십시오.
  2. 초기 복제본 세트의 기본 구성 수정을 수행하십시오.

동일한 호스트에서 세 개의 집합체 제어기로 구성된 복제본 세트를 작성하는 예제는 예: 복제본 세트 작성 및 활성화를 참조하십시오.

프로시저

  1. 기본 복제본 세트에 복제본을 추가하십시오.

    복제본 세트의 수명 동안 용량을 늘리는 등의 이유로 인해 하나 이상의 복제본을 기존 세트에 추가해야 하는 경우도 있습니다.

    복제본 세트의 기존 복제본은 구성을 업데이트하지 않아도 됩니다. server.xml 파일에서의 구성이 복제본 세트를 형성하는 복제본을 더 정확하게 반영하도록 해당 복제본을 업데이트할 수 있지만 이 업데이트는 불필요하며 해당 동작에 영향을 미치지 않습니다.

    참고: 세트에 있는 기존 복제본의 server.xml 파일에서 replicaSet 값을 변경하지 않아도 됩니다. 기존 복제본의 구성을 변경할 필요가 없습니다. 세트에 있는 모든 복제본의 구성 값이 일치하도록 세트에 있는 기존 복제본의 구성에서 replicaSet 값을 업데이트하려는 경우 기존 복제본의 구성에서 isInitialReplicaSet 값을 false로 설정해야 합니다. 이는 replicaSet 값을 변경하고 나면 해당 값은 변경된 복제본 세트를 설명하므로 더 이상 초기 복제본 세트를 설명하지 않기 때문입니다.
    참고: 복제본을 참조할 때는 일관성을 유지하고 동일한 host:port 값을 사용해야 합니다. 호스트 이름이 사용되는 경우에는 호스트 이름을 항상 사용해야 합니다. IP 주소가 사용되는 경우에는 IP 주소를 항상 사용해야 합니다.

    복제본을 추가하려면 다음의 단계를 수행하십시오.

    1. 기존 복제본 세트가 실행 중이며 대부분의 복제본을 사용할 수 있는지 확인하십시오.
    2. 새 집합체 제어기가 될 서버를 작성하십시오.
      wlp/bin/server create MyNewController
    3. 새 서버를 집합체 제어기로 변환하도록 복제하십시오.
      wlp/bin/collective replicate MyNewController 
         --host=host_of_running_controller
         --port=https_port_of_running_controller 
         --user=user_for_running_controller 
         --password=user_password --keystorePassword=password_for_new_controller  

      replicate 명령은 XML 출력을 콘솔 화면에 씁니다. 사용자는 이 출력을 server.xml 파일에 복사합니다.

      [8.5.5.2 이상]명령의 출력을 콘솔 화면 대신 파일에 쓰려면 --createConfigFile=output_file_path 매개변수를 지정하십시오. 그런 다음 include 명령문을 server.xml 파일에 추가하여 집합체 구성에 출력된 파일을 포함하십시오.
      <include location=output_file_path />
    4. replicate 명령의 출력을 사용하여 새 복제본의 server.xml 파일을 구성하십시오.
      replicate 명령의 XML 출력을 server.xml 파일에 복사하십시오. 다음과 같이 복제본 구성을 수정할 수 있습니다.
      • 필수 설정:
        값을 명시적으로 설정해야 합니다. replicate 명령에 의해 인쇄되는 XML은 이 구성을 포함하고 있으므로 이 설정에 대해 충분합니다.
        [8.5.5.4 이상]hostAuthInfo
        [8.5.5.4 이상]원격 클라이언트가 서버를 시작하기 위해 필요한 특성이 포함된 호스트 인증 정보입니다. 다음 두 방법 중 하나로 복제본에 대한 RPC 신임을 설정하십시오.
        • rpcUser를 복제본이 상주하는 호스트의 운영 체제 로그인 사용자 ID로 설정하고 rpcUserPassword를 사용자 ID의 운영 체제 로그인 비밀번호로 설정하십시오. 예를 들어, 사용자 test1 및 비밀번호 test1pwd를 사용하여 복제본 컴퓨터에 로그인하는 경우에는 hostAuthInfo 요소를 다음으로 변경하십시오.
          <hostAuthInfo rpcUser="test1" rpcUserPassword="test1pwd" />
        • 복제본 호스트가 집합체 제어기에 등록되어 있는 경우에는 복제본이 해당 호스트에서 RPC 신임을 상속할 수 있도록 hostAuthInfo useHostCredentialstrue로 설정하십시오.
          <hostAuthInfo useHostCredentials="true" />

        hostAuthInfo 설정에 대한 정보는 Liberty 서버 호스트 정보 대체의 내용을 참조하십시오.

        replicaSet
        복제본 세트의 각 replicaHostsreplicaPorts에 대한 host:port가 포함된 공백으로 구분된 목록입니다(지금 세트에 추가 중인 집합체 제어기에 대한 값은 제외).
        예를 들면 다음과 같습니다.
        original.host.com:10001 some.other.host.com:10003
        이 세트의 값 중 하나 이상이 이미 기존 복제본 세트의 복제본이어야 합니다.
      • 선택적 설정:
        이 설정은 기본값으로 설정되지만 변경할 수 있습니다.
        isInitialReplicaSet
        False
        replicaHost
        각 개별 복제본에 대한 호스트 이름
        replicaPort
        각 개별 복제본에 대한 포트

        이 포트는 집합체 제어기의 http 또는 https 포트는 아니지만 복제본 세트의 복제본 간 통신에 사용되는 고유 포트입니다.

        repositoryDir
        저장소 데이터를 저장하는 데 사용되는 디렉토리 위치
      새 복제본 server.xml 파일에 추가하는 항목의 예는 다음과 같습니다.
      <collectiveController replicaHost="localhost" 
         replicaPort="10012" 
         replicaSet="localhost:10010 localhost:10011" 
         isInitialReplicaSet="false"/> 
      replicate 명령에 의해 인쇄되는 XML을 사용하려면 서버의 보안 구성을 업데이트하고 collectiveRootKeys 키 저장소 비밀번호를 지정해야 합니다. 서버의 보안 구성은 원래 집합체 제어기의 구성과 동일해야 하며 collectiveRootKeys 키 저장소 비밀번호는 원래 집합체 제어기의 collectiveRootKeys 키 저장소 비밀번호에 사용되는 비밀번호여야 합니다. Liberty 집합체 구성에서 작성되는 제어기에서 복제본이 작성된 경우 새 제어기의 구성은 다음 항목을 포함해야 합니다.
      <quickStartSecurity userName="adminUser" userPassword="adminPassword" />
        <!-- collective root signers keystore -->
        <keyStore id="collectiveRootKeys" password="yourPassword"
          location="${server.config.dir}/resources/collective/rootKeys.jks" />
    5. 새 집합체 제어기를 시작하여 새 복제본을 시작하십시오.
    6. 원래 집합체 제어기가 새 복제본에 연결되었는지 확인하십시오. 복제본 및 원래 집합체 제어기의 messages.log 파일에서 CWWKX6009I 메시지를 찾으십시오.
      팁: replicateaddReplica 명령을 실행하는 스크립트의 경우 addReplica 명령 실행 전에 원래 집합체 제어기 및 복제본이 연결되도록 replicate 명령 실행 후 10초의 대기를 추가하십시오.
    7. 집합체 유틸리티에 대한 addReplica 오퍼레이션을 호출하여 새 복제본을 활성화하십시오. addReplica 세트에 대한 인수는 추가할 복제본의 복제본 엔드포인트("replicaHost:replicaPort" 형식)여야 합니다.
      wlp/bin/collective addReplica localhost:10012 
        --host=host_of_running_controller
        --port=port_of_running_controller
        --user=user_for_running_controller 
        --password=user_password
  2. 옵션: 필요한 경우, 초기 복제본 세트의 기본 구성을 수정할 수 있습니다.이 단계는 권장되지만 필수는 아닙니다.

    초기 복제본 세트 구성은 초기 집합체 제어기가 작성되는 경우에 발생합니다. 기본 복제본 구성을 수정해야 하는 경우 server.xml 파일에서 다음 특성을 변경할 수 있습니다.

    선택적 설정: 이 값은 기본값으로 설정되지만 변경할 수 있습니다.
    replicaHost
    각 개별 복제본에 대한 호스트 이름
    replicaPort
    각 개별 복제본에 대한 포트

    이 포트는 집합체 제어기의 http 또는 https 포트는 아니지만 복제본 세트의 복제본 간 통신에 사용되는 고유 포트입니다.

    repositoryDir
    저장소 데이터를 저장하는 데 사용되는 디렉토리 위치

예: 복제본 세트 작성 및 활성화

이 예제에서는 복제본 세트를 작성한 후 활성화하는 방법에 대해 설명합니다. 복제본 세트는 고가용성을 위해 서로 다른 호스트에 세 개 이상의 복제본을 가지고 있어야 합니다. 이 예제에서는 동일한 호스트에 복제본이 있으므로 복제본의 고유 포트 번호를 지정해야 합니다. 복제본이 서로 다른 호스트에 있으면 복제본이 동일한 포트 번호를 사용할 수 있습니다.

  1. 복제본 세트를 작성하십시오.

    복제본 세트를 작성하려면 집합체 제어기의 수를 늘리고 집합체 제어기가 서로 통신할 수 있도록 구성하십시오. 추가된 집합체 제어기는 원래 제어기와 동일한 보안 구성을 가지며 하나의 제어기에 작성된 모든 정보는 자동으로 다른 모든 활성 제어기에 복제되므로 각각의 새 집합체 제어기를 복제본이라고 합니다. 일단 구성되고 나면 복제본 세트에 있는 모든 집합체 제어기가 원래 제어기와 동일한 조작을 수행할 수 있습니다.

    1. 집합체 제어기가 없으면 집합체 제어기를 작성하십시오. Liberty 집합체 구성의 1단계를 참조하십시오.
    2. 기존 집합체 제어기가 실행 중인지 확인하십시오. 이름이 myController인 기존 제어기의 경우 status 명령을 실행하십시오.
      wlp/bin/server status myController
      집합체 제어기가 실행되고 있지 않으면 start 또는 run 명령을 사용하여 집합체 제어기를 시작하십시오.
      wlp/bin/server start myController
    3. 새 집합체 제어기가 될 서버를 작성하십시오.
      wlp/bin/server create myController2
    4. 기존 집합체 제어기 구성을 새 집합체 제어기에 복제하십시오. 새 집합체 제어기를 복제본이라고 합니다.

      기존 집합체 제어기의 관리 보안 도메인 구성을 사용하고 복제본의 새 키 저장소 비밀번호를 설정하는 replicate 명령을 실행하십시오. 기존 집합체 제어기의 server.xml 파일에서 --host, --port, --user--password 매개변수에 대한 값을 찾으십시오. --keystorePassword의 경우 키 저장소에 사용할 값(예: myController2)을 설정하십시오. 이 필수 매개변수 및 선택적 매개변수에 대한 정보를 보려면 명령행에서 collective help replicate를 실행하십시오.

      wlp/bin/collective replicate myController2 --host=host_of_existing_controller --port=https_port_of_existing_controller --user=user_for_existing_controller --password=user_password --keystorePassword=password_for_new_controller  

      인증서 체인을 승인하라는 프롬프트가 표시되면 y(예)를 입력하십시오.

      replicate 명령은 XML 출력을 콘솔 화면에 씁니다. 사용자는 이 출력을 server.xml 파일에 복사합니다.

      [8.5.5.2 이상]명령의 출력을 콘솔 화면 대신 파일에 쓰려면 --createConfigFile=output_file_path 매개변수를 지정하십시오. 그런 다음 include 명령문을 server.xml 파일에 추가하여 집합체 구성에 출력된 파일을 포함하십시오.
      <include location=output_file_path />
    5. replicate 명령의 XML 출력을 복제본의 server.xml 파일에 추가하고 필요에 따라 매개변수 값을 편집하십시오.
      • httpEndpoint 요소가 호스트의 고유 포트 번호인 복제본 httpPorthttpsPort 값을 설정하는지 확인하십시오. 예를 들어, myController라는 원래 제어기와 복제본이 모두 동일한 로컬 호스트에 있고 myController가 다음 httpEndpoint 요소를 가지고 있다고 가정해 봅니다.
        <httpEndpoint id="defaultHttpEndpoint"
                      host="*"
                      httpPort="9080"
                      httpsPort="9443" />
        myController2의 값을 다음으로 변경하십시오.
        <httpEndpoint id="defaultHttpEndpoint"
                      host="*"
                      httpPort="9085"
                      httpsPort="9448" />
      • [8.5.5.4 이상]hostAuthInfo에 대한 RPC 신임을 설정하십시오. 다음 두 방법 중 하나로 복제본에 대한 RPC 신임을 설정할 수 있습니다.
        • hostAuthInfo RPC 사용자 및 비밀번호 값을 설정하십시오. rpcUser를 복제본이 상주하는 호스트의 운영 체제 로그인 사용자 ID로 설정하고 rpcUserPassword를 사용자 ID의 운영 체제 로그인 비밀번호로 설정하십시오. 예를 들어, 사용자 test1 및 비밀번호 test1pwd를 사용하여 복제본 컴퓨터에 로그인하는 경우에는 hostAuthInfo 요소를 다음으로 변경하십시오.
          <hostAuthInfo rpcUser="test1" rpcUserPassword="test1pwd" />
        • 복제본 호스트가 집합체 제어기에 등록되어 있는 경우에는 복제본이 해당 호스트에서 RPC 신임을 상속할 수 있도록 hostAuthInfo useHostCredentialstrue로 설정하십시오.
          <hostAuthInfo useHostCredentials="true" />

        hostAuthInfo 설정에 대한 정보는 Liberty 서버 호스트 정보 대체의 내용을 참조하십시오.

      • replicaPort가 복제본 세트에서 고유한 복제본의 포트 번호를 설정하며 replicaSet가 복제본 세트를 식별하는 host:port 값을 설정하는지 확인하십시오. 예를 들어, myController라는 원래 제어기와 복제본이 모두 동일한 로컬 호스트에 있으면 myController2의 값을 null에서
        <collectiveController replicaPort="null"
                              replicaSet="localhost:null"
                              isInitialReplicaSet="false" />
        10011(복제본 포트의 경우) 및 10010(복제본 세트 포트의 경우)으로 변경하십시오.
        <collectiveController replicaPort="10011"
                              replicaSet="localhost:10010"
                              isInitialReplicaSet="false" />
      • 보안 구성에서 원래 제어기가 사용하는 것과 동일한 값을 설정하는지 확인하십시오. 예를 들어, myControllermyController2 복제본이 모두 다음을 사용합니다.
        <quickStartSecurity userName="adminUser" userPassword="adminPassword" />
      • 집합체 루트 서명자 키 저장소 요소가 원래 제어기가 사용하는 것과 동일한 비밀번호를 설정하는지 확인하십시오. 예를 들어, collectiveRootKeys 키 저장소 비밀번호를 myController server.xml 파일로부터 복사하여 myController2 복제본 server.xml 파일에 붙여넣으십시오. 이 예제에서는 생성되는 비밀번호를 보여줍니다.
        <!-- collective root signers keystore -->
        <keyStore id="collectiveRootKeys" password="{xor}Lz4sLCgwLTs="
                  location="${server.config.dir}/resources/collective/rootKeys.jks" />
    6. 새 집합체 제어기를 시작하여 새 복제본을 시작하십시오.
      wlp/bin/server start myController2
    7. 원래 집합체 제어기가 새 복제본과 통신할 수 있는지 확인하십시오.
      1. 원래 제어기 메시지 로그($WLP_USER_DIR/servers/myController/logs/messages.log)에서 편집기를 여십시오.
      2. 다음 메시지를 찾으십시오(사용자의 환경에서는 IP 주소가 다를 수 있음).
        CWWKX6009I: The collective controller successfully connected to replica 127.0.0.1:10011. Current active replica set is [127.0.0.1:10010]. The configured replica set is [127.0.0.1:10010]. The connected standby replicas are [127.0.0.1:10011].
    8. 새 복제본이 원래 집합체 제어기와 통신할 수 있는지 확인하십시오.
      1. 복제본 메시지 로그($WLP_USER_DIR/servers/myController2/logs/messages.log)에서 편집기를 여십시오.
      2. 다음 메시지를 찾으십시오(사용자의 환경에서는 IP 주소가 다를 수 있음).
        CWWKX6009I: The collective controller successfully connected to replica 127.0.0.1:10010. Current active replica set is []. The configured replica set is []. The connected standby replicas are [127.0.0.1:10011, 127.0.0.1:10010].
  2. 새 복제본을 활성화하십시오.

    집합체 제어기의 관리 보안 도메인 구성을 사용하고 replicaHost:replicaPort 양식으로 활성화할 복제본의 엔드포인트를 지정하는 addReplica 명령을 실행하십시오. 집합체 제어기의 server.xml 파일에서 --host, --port, --user--password 매개변수에 대한 값을 찾으십시오. 복제본의 server.xml 파일에서 replicaHost:replicaPort에 대한 값을 찾으십시오. 이 매개변수에 대한 정보를 보려면 명령행에서 collective help addReplica를 실행하십시오.

    wlp/bin/collective addReplica replicaHost:replicaPort --host=host_of_existing_controller --port=port_of_existing_controller --user=user_for_existing_controller --password=user_password

    기존 집합체 제어기와 복제본이 같은 호스트(localhost)에 있는 이 예제의 경우 다음을 실행하십시오.

    wlp/bin/collective addReplica localhost:10011 --host=localhost --port=9443 --user=adminUser --password=adminPassword

    인증서 체인을 승인하라는 프롬프트가 표시되면 y(예)를 입력하십시오.

  3. 추가적인 복제본에 대해 1단계 및 2단계를 반복하십시오. 예를 들어, 세 번째 복제본을 복제본 세트에 추가하십시오. 새 복제본의 이름을 myController3로 지정하고 replicaPort="10012"를 지정하십시오. 복제본 세트는 고가용성을 위해 세 개 이상의 복제본을 가지고 있어야 합니다.
    세 번째 복제본이 복제본 세트에 추가되고 나면 원래 집합체 제어기와 새 복제본이 동기화되었는지 확인할 수 있습니다.
    • 원래 제어기 메시지 로그에서 다음의 메시지를 찾으십시오. 사용자의 환경에서는 이 메시지의 IP 주소가 다를 수 있습니다.
      CWWKX6015I: A request to change the active collective controller replica set was received and is now processing. The current active replica set is {127.0.0.1:10010,127.0.0.1:10011}. The requested new active replica set is {127.0.0.1:10010,127.0.0.1:10011,127.0.0.1:10012}.
      
      CWWKX6016I: The active collective controller replica set changed successfully. The current active replica set is {127.0.0.1:10010,127.0.0.1:10011,127.0.0.1:10012}. The previous active replica set was {127.0.0.1:10010,127.0.0.1:10011}.
      
      CWWKX6011I: The collective controller is ready, and can accept requests. The leader is 127.0.0.1:10010. Current active replica set is [127.0.0.1:10012, 127.0.0.1:10011, 127.0.0.1:10010]. The configured replica set is [127.0.0.1:10010, 127.0.0.1:10011, 127.0.0.1:10012].
      
      CWWKX6014I: This collective controller replica finished synchronizing the data with the other replicas.
    • 추가된 복제본의 메시지 로그에서 다음의 메시지를 찾으십시오. 사용자의 환경에서는 이 메시지의 IP 주소가 다를 수 있습니다.
      CWWKX6016I: The active collective controller replica set changed successfully. The current active replica set is {127.0.0.1:10010,127.0.0.1:10011,127.0.0.1:10012}. The previous active replica set was {127.0.0.1:10010,127.0.0.1:10011}.
      
      CWWKX6011I: The collective controller is ready, and can accept requests. The leader is 127.0.0.1:10010. Current active replica set is [127.0.0.1:10012, 127.0.0.1:10011, 127.0.0.1:10010]. The configured replica set is [127.0.0.1:10010, 127.0.0.1:10011, 127.0.0.1:10012].
      
      CWWKX8112I: The server's host information was successfully published to the collective repository.
      
      CWWKX8114I: The server's paths were successfully published to the collective repository.
      
      CWWKX8116I: The server STARTED state was successfully published to the collective repository.

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

Information Center 이용 약관 | 피드백


시간소인 아이콘 마지막 업데이트 날짜: Wednesday, 2 September 2015
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-libcore-mp&topic=tagt_wlp_configure_replicas
파일 이름: tagt_wlp_configure_replicas.html