분산 플랫폼용z/OS 플랫폼용

동적 라우팅 명령

setup, genPluginCfg 및 genKeystore dynamicRouting 명령 조치는 플러그인 구성 및 키 저장소 파일을 생성하는 데 사용됩니다. genPluginCfg dynamicRouting 명령 조치는 초기 설정 후 언제든지 plugin-cfg.xml 파일을 재생성하는 데 사용됩니다. 예를 들어, Dynamic Routing 기능이 새 제어기에서 사용으로 설정되거나 새 웹 서버가 추가되는 경우입니다. genKeystore dynamicRouting 명령 조치는 키 저장소 파일을 생성하는 데 사용됩니다. 각각의 dynamicRouting 명령 조치는 온라인 도움말을 지원합니다.

Dynamic Routing 기능에 대한 명령은 다음과 같습니다.

setup

setup dynamicRouting 명령은 하나의 PKCS12 또는 JKS 형식 키 저장소와 하나 이상의 WebSphere® 플러그인 구성 파일을 생성합니다. 해당 키 저장소에는 WebSphere 플러그인과 동적 라우팅 서비스 간 보안 통신을 허용하는 memberRoot 및 controllerRoot 서명자 인증서와 개인 인증서가 포함되어 있습니다. 동일한 키 저장소를 사용하여 Liberty 집합체 멤버의 애플리케이션에 HTTPS 요청을 전송할 수도 있습니다. 플러그인 구성 파일에는 WebSphere 플러그인에서 지능형 관리를 사용으로 설정하는 <IntelligentManagement> 스탠자가 포함되어 있습니다. <IntelligentManagement> 스탠자에는 집합체를 나타내는 하나의 <ConnectorCluster> 스탠자가 포함되어 있습니다. <ConnectorCluster> 스탠자에는 Dynamic Routing 기능이 사용으로 설정되는 각각의 제어에 대한 하나의 <Connector> 스탠자가 포함되어 있습니다.

명령 도움말을 보려면 다음을 표시하는 <Controller root>/bin/dynamicRouting help setup을 실행하십시오.

설명

setup dynamicRouting 명령은 동적 라우팅 서비스와 클라이언트 간 보안 통신을 사용으로 설정하기 위해 필요한 개인 인증서 및 서명자 인증서가 포함된 키 저장소를 생성합니다. 또한 이 명령은 WebSphere 플러그인에서 지능형 관리를 사용으로 설정할 <IntelligentManagement> 스탠자가 포함된 WebSphere 플러그인 구성 파일을 생성합니다.

사용법

dynamicRouting setup [options]

옵션

--host=name
필수입니다. 대상 집합체 제어기의 호스트 이름입니다.
--password[=pwd]
필수입니다. 대상 집합체 제어기 관리자의 비밀번호입니다. 값이 정의되지 않은 경우에는 값을 정의하라는 프롬프트가 표시됩니다.
--port=num
필수입니다. 대상 집합체 제어기의 HTTPS 포트 번호입니다.
--user=name
필수입니다. 대상 집합체 제어기의 관리자입니다.
--pluginInstallRoot=path
필수입니다. 웹 서버 호스트에서 WebSphere 플러그인 루트 디렉토리의 완전한 경로입니다.
--webServerNames=webServerName[,webServerName1]
필수입니다. WebSphere 플러그인 구성 파일을 생성해야 하는 웹 서버의 쉼표로 구분된 이름입니다.
--keystorePassword[=pwd]
필수입니다. 생성되는 키 저장소의 비밀번호입니다. 지정된 경우 값이 정의되어 있지 않으면 값을 정의하라는 프롬프트가 표시됩니다.
--keystoreType=type
Optional. 생성되는 키 저장소의 유형입니다. 기본 유형은 JKS입니다. 올바른 값은 JKS 및 PKCS12입니다.
--certificateSubject=DN
참고: 이 옵션은 무시됩니다. 인증서가 생성되는 방법의 개선 때문에 인증서 제목 지정이 더 이상 유용하지 않습니다. 이 옵션이 유지되므로 dynamicRouting setup 명령을 사용하는 기존 스크립트는 업데이트될 필요가 없습니다.

SSL 인증서는 JVM 특성 com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates를 true로 설정하여 자동으로 신뢰할 수 있습니다.

참고: setup 및 genKeystore 명령에 의해 생성되는 키 저장소는 JKS 또는 PKCS12 형식으로 되어 있습니다. 해당 키 저장소는 웹 서버 시스템의 디렉토리에 복사해야 하며 gskcmd를 실행하여 CMS 형식의 저장소로 변환해야 합니다. CMS 형식의 저장소 파일 (.kdb)는 <value of the --pluginInstallRoot argument>/config/<web server name> 디렉토리로 이동해야 합니다. .rdb 및 .sth 파일도 동일한 디렉토리로 이동해야 합니다.

모든 필수 인수를 사용하여 실행될 때 명령의 출력은 다음과 같습니다.

./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=password --keystorePassword=keypass --pluginInstallRoot=/opt/HTTPServer_Plugins --webServerNames=webServer1,webServer2

Generating WebSphere plug-in configuration files for web servers webServer1, webServer2

Auto-accepting the certificate chain for target server. 
Certificate subject DN: CN=admin, OU=controller1, O=ibm, C=us 

Successfully completed MBean request to the controller. 
Successfully generated WebSphere plug-in configuration files plugin-cfg-webServer1.xml, plugin-cfg-webServer2.xml
Generating keystore for web servers webServer1, webServer2
Successfully completed MBean request to the controller. 
Successfully generated keystore plugin-key.jks.

Generated WebSphere plug-in configuration files plugin-cfg-webServer1.xml, plugin-cfg-webServer2.xml for web servers webServer1, webServer2. 
Also generated keystore file plugin-key.p12 that enables secure communication between the Dynamic Routing service and clients. 

Copy the WebSphere plug-in configuration file to the directory specified
in the WebSpherePluginConfig directive in the IBM HTTP Server httpd.conffile. 
Copy keystore file plugin-key.jks to a directory on the 
web server host, and run "gskcmd" to convert the keystore to CMS format and
to set personal certificate as the default.
For example:

gskcmd -keydb -convert -pw  <<password>> -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 

Copy resulting /tmp/plugin-key.kdb, .sth, .rdb files to the directory /opt/HTTPServer_Plugins/config/webServer1/

genPluginCfg

이 조치는 플러그인 구성 파일을 생성합니다. 각각의 플러그인 구성 파일에는 플러그인의 지능형 관리 기능을 사용으로 설정하는 <IntelligentManagement> 스탠자가 포함되어 있습니다. <IntelligentManagement> 스탠자에는 집합체를 나타내는 하나의 <ConnectorCluster> 스탠자가 포함되어 있습니다. <ConnectCluster> 스탠자에는 Dynamic Routing 기능이 사용으로 설정되는 각 제어기에 대한 하나의 <Connector> 스탠자가 포함되어 있습니다. 쉼표로 구분된 웹 서버 이름이 --webServerNames 인수에 지정됩니다. 예를 들어, --webServerNames=webServer1,webServer2가 지정되는 경우 plugin-cfg-webServer1.xml 및 plugin-cfg-webServer2.xml 파일이 생성됩니다.

온라인 도움말을 보려면 <Controller root>/bin/dynamicRouting help genPluginCfg를 실행하십시오. 그러면 다음 항목이 표시됩니다.

설명

WebSphere 플러그인에서 지능형 관리를 사용으로 설정할 <IntelligentManagement> 스탠자가 포함된 WebSphere 플러그인 구성 파일을 생성합니다.

사용법

dynamicRouting genPluginCfg [options]

옵션

--host=name
필수입니다. 대상 집합체 제어기의 호스트 이름입니다.
--password[=pwd]
필수입니다. 대상 집합체 제어기 관리자의 비밀번호입니다. 값이 정의되지 않은 경우에는 값을 정의하라는 프롬프트가 표시됩니다.
--port=num
필수입니다. 대상 집합체 제어기의 HTTPS 포트 번호입니다.
--user=name
필수입니다. 대상 집합체 제어기의 관리자입니다.
--pluginInstallRoot=path
필수입니다. 웹 서버 호스트에서 WebSphere 플러그인 루트 디렉토리의 완전한 경로입니다.
--webServerNames=webServerName[,webServerName1]
필수입니다. WebSphere 플러그인 구성 파일을 생성해야 하는 웹 서버의 쉼표로 구분된 이름입니다.

SSL 인증서는 JVM 특성 com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates를 true로 설정하여 자동으로 신뢰할 수 있습니다.

모든 필수 인수를 사용하여 실행될 때 명령의 출력은 다음과 같습니다.

./dynamicRouting setup --port=9444 --host=controller1.acme.com --user=admin --password=password --keystorePassword=keypass --pluginInstallRoot=/opt/HTTPServer_Plugins --webServerNames=webServer1,webServer2

이 조치는 플러그인 구성 파일을 생성합니다.
 
Generating WebSphere plug-in configuration file for web server webServer1

Auto-accepting the certificate chain for target server. 
Certificate subject DN: CN=admin, OU=controller1, O=ibm, C=us 

Successfully completed MBean request to the controller. 
File /home/user1/Liberty/wlp/bin/plugin-cfg.xml exists. 
Saving to /home/user1/Liberty/wlp/bin/plugin-cfg.xml.old. 
Successfully generated WebSphere plug-in configuration file plugin-cfg.xml

Generated WebSphere plug-in configuration file plugin-cfg.xml for web server webServer1. 
Copy the WebSphere plug-in configuration file to the directory specified in the WebSpherePluginConfig directive in the IBM HTTP Server httpd.conf file.

genKeystore

이 조치는 PKCS12 또는 JKS 형식의 키 저장소를 생성합니다. --keystoreType 조치를 사용하여 키 저장소 형식을 지정하십시오. PKCS12 키 저장소 생성은 IBM Java 사용 시에만 지원됩니다. 해당 키 저장소에는 WebSphere 플러그인과 동적 라우팅 서비스 간 보안 통신을 허용하는 memberRoot 및 controllerRoot 서명자 인증서와 개인 인증서가 포함되어 있습니다. 동일한 키 저장소를 사용하여 Liberty 집합체 멤버의 애플리케이션에 HTTPS 요청을 전송할 수도 있습니다.

온라인 도움말을 보려면 <Controller root>/bin/dynamicRouting help genKeystore를 실행하십시오. 그러면 다음 항목이 표시됩니다.

설명

동적 라우팅 서비스와 클라이언트 간 보안 통신을 사용으로 설정하기 위해 필요한 개인 인증서 및 서명자 인증서가 포함된 키 저장소를 생성합니다.

사용법

dynamicRouting genKeystore [options]

옵션

--host=name
필수입니다. 대상 집합체 제어기의 호스트 이름입니다.
--password[=pwd]
필수입니다. 대상 집합체 제어기 관리자의 비밀번호입니다. 값이 정의되지 않은 경우에는 값을 정의하라는 프롬프트가 표시됩니다.
--port=num
필수입니다. 대상 집합체 제어기의 HTTPS 포트 번호입니다.
--user=name
대상 집합체 제어기의 관리자를 지정합니다. (필수)
--keystorePassword[=pwd]
필수입니다. 생성되는 키 저장소의 비밀번호입니다. 지정된 경우 값이 정의되어 있지 않으면 값을 정의하라는 프롬프트가 표시됩니다.
--keystoreType=type
Optional. 생성되는 키 저장소의 유형입니다. 기본 유형은 JKS입니다. 올바른 값은 JKS 및 PKCS12입니다.
--certificateSubject=DN
참고: 이 옵션은 무시됩니다. 인증서가 생성되는 방법의 개선 때문에 인증서 제목 지정이 더 이상 유용하지 않습니다. 이 옵션이 유지되므로 dynamicRouting genKeystore 명령을 사용하는 기존 스크립트는 업데이트될 필요가 없습니다.

SSL 인증서는 JVM 특성 com.ibm.websphere.dynamicRouting.utility.autoAcceptCertificates를 true로 설정하여 자동으로 신뢰할 수 있습니다.

모든 필수 인수를 사용하여 실행될 때 명령의 출력은 다음과 같습니다.

./dynamicRouting genKeystore --port=9444 --host=contoller1.acme.com --user=admin --password=password --keystorePassword

Enter password --keystorePassword: 
Re-enter password --keystorePassword: 

Auto-accepting the certificate chain for target server. 
Certificate subject DN: CN=admin, OU=mycontroller, O=ibm, C=us

Generating keystore...
Successfully completed MBean request to the controller. 
Successfully generated keystore plugin-key.jks.

Generated keystore file plugin-key.jks that enables secure communication between the Dynamic Routing service and clients.If you are using Intelligent Management in the WebSphere plug-in,
copy keystore file plugin-key.jks to a directory on the web server host,and run "gskcmd" to convert the keystore to CMS format and to set personal certificate as the default.
For example:

gskcmd  -keydb -convert -pw <<password>> -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 

Copy resulting /tmp/plugin-key.kdb, .sth, .rdb files to the keyring directory specified in the WebSphere plug-in configuration file.

주제의 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: Friday, 16 September 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-dist&topic=rwlp_wve_dynroutcollect
파일 이름: rwlp_wve_dynroutcollect.html