단일 Liberty 집합체의 동적 라우팅 설정

환경이 변경될 때 WebSphere 플러그인 구성 파일을 다시 생성하지 않고도 Liberty 집합체의 멤버에 대해 HTTP 요청을 라우팅하도록 동적 라우팅 기능을 구성할 수 있습니다.

시작하기 전에

Liberty 집합체의 동적 라우팅 설정의 제품 설치 단계를 완료하십시오.

이 태스크 정보

Intelligent Management를 사용하여 HTTP 요청을 Liberty 집합체로 라우팅하려면, 집합체의 하나 이상의 집합체 제어기에서 dynamicRouting-1.0 기능을 사용으로 설정해야 합니다. 이 기능은 집합체 저장소에서 라우팅 정보를 동적으로 검색하고 이 정보를 WebSphere® 플러그인으로 전달하는 동적 라우팅 서비스를 제공합니다. 이 기능은 dynamicRouting 명령도 제공합니다. 헤당 setup, genPluginCfggenKeystore 명령 조치를 함께 사용하면 WebSphere 플러그인의 Intelligent Management를 사용하는 플러그인 구성 파일, 그리고 플러그인 및 동적 라우팅 서비스 간의 보안 통신에 필요한 키 저장소를 생성할 수 있습니다.

[17.0.0.1 and later]라우팅 규칙 기능을 사용하면 WebSphere 플러그인에 대한 수신 요청이 지정된 서버 세트로 라우팅될 수 있습니다. 또한 요청은 선택적으로 거부되거나 경로 재지정될 수 있습니다. 규칙이 수신 요청에 적용되는지 여부에 대한 선택은 수신 요청의 속성의 일치를 통해 이루어집니다.

프로시저

  1. 제어기의 server.xml에서 featureManager 태그에 다음 코드를 추가하여 제어기에서 동적 라우팅을 사용으로 설정하십시오.
    <feature>dynamicRouting-1.0</feature>
  2. 동적 라우팅 기능에 의해 사용되는 모든 제어기를 시작하십시오.
  3. 제어기 중 하나에서 dynamicRouting setup 명령을 실행하여 키 저장소 및 플러그인 구성 파일을 생성하십시오. 예:
    ./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=passw0rd --keystorePassword=webAS --pluginInstallRoot=/opt/HTTPServer_Plugins/ --webServerNames=webserver1
    참고: --user 인수의 지정된 값이 사용자 레지스트리에 존재하며 관리 역할이 지정되어 있는지 확인하십시오.

    추가 정보는 동적 라우팅 명령의 내용을 참조하십시오.

  4. 생성된 plugin-key.jksplugin-cfg.xml 파일을 웹 서버 호스트의 임시 디렉토리에 복사하십시오.
  5. 웹 서버 호스트에서 IHS 패키지에 포함되어 있는 gskcmd를 실행하여 키 저장소를 CMS 형식으로 변환하고 개인 인증서를 기본값으로 설정하십시오. CMS 형식은 WebSphere 플러그인에서 지원되는 형식입니다. 예:
    gskcmd -keydb -convert -pw webAS -db /tmp/plugin-key.jks -old_format jks -target /tmp/plugin-key.kdb -new_format cms -stash
    gskcmd -cert -setdefault -pw <<password>> -db /tmp/plugin-key.kdb -label default

    z/OS의 경우에는 z/OS에서 CMS 형식으로 키 저장소 변환의 내용을 참조하십시오.

  6. gskcmd에 의해 작성된 plugin-key.kdb, plugin-key.rdbplugin-key.sth 파일을 임시 디렉토리에서 --pluginInstallRootargument_value/config/web_server_name/ 디렉토리로 복사하십시오.
  7. plugin-cfg.xml을 웹 서버 httpd.conf 파일의 WebSpherePluginConfig 지시문에 지정된 디렉토리로 복사하십시오. plugin-cfg.xml<IntelligentManagement> 스탠자와 함께 생성됩니다. 동적 라우팅이 집합체에서 사용으로 설정된 경우, 각 집합체 제어기마다 하나의 <Connector> 스탠자가 존재합니다.
    예:
    <IntelligentManagement>
     <Property name="webserverName" value="webServer1"/>
     <ConnectorCluster enabled="true" maxRetries="-1" name="default" retryInterval="60">
      <Property name="uri" value="/ibm/api/dynamicRouting"/>
      <Connector host="controller1.acme.com" port="9444" protocol="https">
      <Property name="keyring" value="/opt/HTTPServer_Plugins/config/webserver1/plugin-key.kdb"/>
     </Connector>
     </ConnectorCluster>
    </IntelligentManagement>
  8. 웹 서버를 시작하고 집합체에 설치된 애플리케이션으로 라우팅을 시작하십시오.
  9. 옵션: <dynamicRouting> 요소를 제어기 server.xml에 추가하여 동적 라우팅의 특성을 지정하십시오.

    connectorClusterName 특성은 동적 라우팅이 집합체와 연관시키는 이름을 지정합니다. connectorClusterName 특성이 지정되지 않으면 집합체의 이름이 사용됩니다. retryInterval 특성은 연결 실패 시에 제어기로 재연결하기 전에 대기하는 시간의 길이를 지정합니다. maxRetries 특성은 실패한 집합체 제어기에 재연결을 시도하는 횟수를 지정합니다.

    예:
    <dynamicRouting maxRetries="4" retryInterval="20" connectorClusterName="collective1"/>
     <TraceSpecification name="default" specification=":DEBUG"/>
    </dynamicRouting>
    생성된 plugin-cfg.xml에는 <ConnectorCluster> 특성이 있습니다.
    <IntelligentManagement>
     <TraceSpecification name="default" specification=":DEBUG"/>
      <Property name="webserverName" value="webServer1"/>
      <ConnectorCluster enabled="true" maxRetries="4" name="collective1" retryInterval="20">
      <Property name="uri" value="/ibm/api/dynamicRouting"/>
      <Connector host="controller1.acme.com" port="9444" protocol="https">
      <Property name="keyring" value="/opt/HTTPServer_Plugins/config/webServer1/plugin-key.kdb"/>
      </Connector>
     </ConnectorCluster>
    </IntelligentManagement>
  10. [17.0.0.1 and later]선택사항: 특정 요청이 처리되는 방법을 지정하는 라우팅 규칙을 작성하십시오.

    라우팅 규칙은 다음을 수행하도록 지정할 수 있습니다.

    • 특정 요청을 거부합니다.
    • 특정 요청을 경로 재지정합니다.
    • 특정 요청이 사용 가능한 서버의 서브세트로 이동되도록 허용합니다.
    • 한 서버 세트의 특정 요청을 다른 서버 세트로 장애 복구합니다.

    Liberty 동적 라우팅의 라우팅 규칙Liberty 동적 라우팅의 라우팅 규칙 구성의 내용을 참조하십시오.

결과

dynamicRouting-1.0 기능을 사용하여 Intelligent Management는 이제 동적으로 HTTP 요청을 Liberty 집합체로 라우팅할 수 있습니다.


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

파일 이름: twlp_wve_enabledynrout_single.html