endptEnabler 명령

endptEnabler 명령은 엔터프라이즈 아카이브(EAR) 파일 내에서 웹 서비스 세트를 사용으로 설정하는 데 사용됩니다. endptEnabler 명령은 웹 서비스에 사용 가능한 EJB(Enterprise JavaBeans) 모듈을 포함하는 EAR 파일에 대해 실행해야 합니다.

각 라우터 모듈은 특정 전송을 위한 웹 서비스 엔드포인트를 제공합니다. 예를 들어, 웹 서비스가 HTTP 전송을 통해 요청을 수신할 수 있도록 HTTP 라우터 모듈을 추가할 수 있습니다. 또는 웹 서비스가 JMS 큐나 토픽으로부터 요청을 수신할 수 있도록 JMS(Java™ Message Service) 라우터 모듈을 추가할 수 있습니다.

대화식 모드에서 endptEnabler 명령은 애플리케이션 내에서 하나 이상의 서비스를 사용 가능하게 하기 위한 필수 단계를 안내합니다. endptEnabler 명령은 나중에 서비스를 제거하거나 추가해야 하는 경우를 대비하여 원래 EAR 파일의 백업 사본을 작성합니다. EAR 파일이 웹 서비스를 위해 사용 가능한 엔터프라이즈 Bean JAR(Java archive) 파일을 포함하는 경우, EAR 파일이 배치되기 전에 endptEnabler 명령을 실행해야 합니다. 그렇지 않으면 명령을 실행할 필요가 없습니다.

문제점 방지 문제점 방지: endptEnabler.sh의 쉘 스크립트에서, 스크립트는 EXIT 0으로 끝납니다. 이 리턴 코드를 사용하여 스크립트의 실행 결과를 판별하지 마십시오. gotcha

endptEnabler 사용법 구문

WebSphere® Application Server bin 디렉토리에서 endptEnabler 명령을 호출하십시오. 명령 구문은 다음 예에서 제공됩니다.
endptEnabler
    [-verbose|-v]
    [-quiet|-q]
    [-help|-h|-?]
    [-properties|-p properties-filename]
    [-transport|-t default-transports]
    [-enableHttpRouterSecurity]
    [-enableClientCertSecurity]
    [ear-filename]
    [-classpath|-cp]
모든 매개변수는 선택사항이며 다음 목록에서 설명합니다.
-verbose, -v
이 매개변수는 endptEnabler 도구가 EAR 파일을 처리할 때 진행 상태 메시지를 자세히 표시합니다. 이 명령행 옵션은 verbose 글로벌 특성에 맵핑됩니다.
-quiet, -q
이 매개변수는 endptEnabler 도구가 EAR 파일을 처리할 때 모듈당 진행 상태 메시지가 표시되지 않게 합니다. 이 명령행 옵션은 quiet 글로벌 특성에 맵핑됩니다.
-help, -h, -?
이 매개변수는 다양한 옵션을 설명하는 간략한 도움말 메시지를 표시합니다.
-properties, -p <properties-filename>
이 매개변수는 properties-filename 특성에서 특성을 읽고 endptEnabler 도구의 작동을 제어합니다.
-transport, -t <default-transports>
이 매개변수는 EAR 파일에 포함되어 있는 각 엔터프라이즈 Bean JAR 파일에 대해 라우터 모듈이 작성되는 전송의 기본 목록을 지정합니다. 이 명령행 옵션은 defaultTransports 글로벌 특성에 맵핑됩니다. 다음은 이 매개변수의 예입니다.
-transport http (the default)
-transport jms
-t http,jms
-enableHttpRouterSecurity
이 매개변수는 모든 EJB가 엔터프라이즈 Bean JAR 파일에서 보안되는 경우 인증된 모든 사용자가 HTTP 라우터 모듈을 보호하도록 보안 정책을 추가할 수 있게 합니다. 이 명령행 옵션은 http.enableRouterSecurity 글로벌 특성에 맵핑됩니다.
-enableClientCertSecurity
이 매개변수는 기본 인증이나 양식 로그인 대신 인증서 인증을 위한 web.xml 파일에 다음 로그인 구성 스탠자를 추가할 수 있게 합니다. 이 명령행 옵션은 http.enableClientCertSecurity 글로벌 특성에 맵핑됩니다.
<login-config>
  <auth-method>CLIENT-CERT</auth-method>
</login-config>
우수 사례 우수 사례: -enableClientCertSecurity 매개변수를 -enableHttpRouterSecurity 매개변수와 함께 사용하십시오. bprac
<ear-filename>
이 매개변수는 처리할 EAR 파일의 이름을 지정합니다.

ear-filename 매개변수가 명령행에 입력되지 않는 경우, 대화식 모드가 사용됩니다. 대화식 모드에서, 처리하는 중에 EAR 파일 이름, 라우터 모듈 이름 및 기타 중요한 값이 프롬프트됩니다. 다음은 endptEnabler 대화식 모드의 예제 대화 상자입니다.

이 대화 상자에서, 사용자 입력은 고정된 너비의 글꼴로 표시되며, endptEnabler 출력은 굵은체로 표시됩니다.

endptEnabler<enter>   
WSWS2004I: IBM WebSphere Application Server Release 5 
WSWS2005I: Web Services Enterprise Archive Endpoint Enabler Tool. 
WSWS2007I: (C) COPYRIGHT International Business Machines Corp. 1997, 2003 
WSWS2006I: Please enter the name of your EAR file: AddressBook.ear<enter>   

WSWS2003I: Backing up EAR file to: AddressBook.ear~   

WSWS2016I: Loading EAR file: AddressBook.ear 
WSWS2017I: Found EJB Module: AddressBookEJB.jar

WSWS2029I: Enter http router name for EJB Module AddressBookEJB 
[AddressBookEJB_HTTPRouter.war]:<enter>
WSWS2030I: Enter http context root for EJB Module AddressBookEJB 
[/AddressBookEJB]:<enter>
WSWS2024I: Adding http router for EJB Module AddressBookEJB.jar. 
WSWS2036I: Saving EAR file AddressBook.ear... 
WSWS2037I: Finished saving the EAR file. 
WSWS2018I: Finished processing EAR file AddressBook.ear.

ear-filename 매개변수가 명령행에 입력된 경우, 비대화식 모드가 사용됩니다. 비대화식 모드에서, 라우터 모듈 이름과 기타 중요한 값이 사용자 지정 특성이나 기본값으로 판별됩니다.

-classpath, -cp
이 매개변수를 사용하면 endptEnabler 명령에 대한 클래스 경로에서 별도의 JAR 파일을 지정할 수 있습니다. EJB 파일이 EAR 파일 안에 존재하지 않는 별도의 JAR 파일에 있는 Java 유형을 참조하는 경우 이 매개변수를 사용하십시오. 이 매개변수에 대해 복수의 값을 지정할 수 있습니다. 예를 들어 다음과 같습니다.
endptEnabler -classpath C:\MyWork\Utility.jar;D:\SharedFiles\Hello.zip;HelloWorld.jar

이 매개변수를 지정하지 않을 때, 다음 메시지와 유사한 오류가 발생할 수 있습니다.

WSWS2021I: Skipping the enterprise bean module module_name 
because it contains no web services.

endptEnabler 특성

endptEnabler 명령을 사용하면 -properties 명령행 옵션으로 특성 세트를 지정하여 런타임 동작을 제어할 수 있습니다. 이들 특성은 글로벌 및 모듈당 특성 중 하나로 조직화됩니다. EAR 파일에서 여러 엔터프라이즈 Bean JAR 모듈을 처리함에 따라 글로벌 특성은 도구의 전체 동작에 영향을 미칩니다. 모듈당 특성은 특정 엔터프라이즈 Bean JAR 모듈의 처리에 영향을 미칩니다.

표 1. endptEnabler 명령에 대한 글로벌 특성. 엔터프라이즈 아카이브(EAR) 파일 내에서 웹 서비스 세트를 사용으로 설정할 때 endptEnabler 명령의 이들 글로벌 특성을 사용하십시오.
특성 이름 설명 기본값
verbose 상세한 진행상태 메시지를 표시합니다. False
quiet 간단한 진행상태 메시지만 표시합니다. False
http.enableRouterSecurity 모든 EJB 모듈이 엔터프라이즈 Bean JAR 파일에서 보안되는 경우 인증된 모든 사용자가 HTTP 라우터 모듈을 보호하도록 보안 정책을 추가할 수 있게 합니다. False
http.enableClientCertSecurity 기본 인증이나 양식 로그인 대신 인증서 인증을 위한 web.xml 파일에 다음 로그인 구성 스탠자를 추가할 수 있게 합니다.
<login-config>
  <auth-method>CLIENT-CERT</auth-method>
</login-config>
False
http.routerModuleNameSuffix 기본 HTTP 라우터 모듈 이름을 구성하는 데 사용되는 접미부를 지정합니다. .war 확장자가 endptEnabler 명령에 의해 추가됩니다. _HTTPRouter
jms.routerModuleNameSuffix 기본 JMS 라우터 모듈 이름을 구성하는 데 사용되는 접미부를 지정합니다. .jar 확장자가 endptEnabler 명령에 의해 추가됩니다. _JMSRouter
jms.defaultDestinationType EAR 파일에 추가된 모든 JMS 라우터 모듈에 사용할 기본 대상 유형을 지정합니다. 이 유형은 큐 아니면 토픽입니다.
defaultTransports 라우터 모듈이 작성되는 전송의 기본 목록을 지정합니다. 목록은 httpjms 값을 포함할 수 있습니다. 복수 값은 쉼표로 구분됩니다. 예는 http, jmshttp,jms입니다. http

다음 표는 endptEnabler 명령에서 지원하는 모듈당 특성을 기술합니다. ejbJarName 변수는 .jar 확장자 없이 EAR 파일에서 엔터프라이즈 Bean JAR 모듈의 이름을 참조합니다.

표 2. endptEnabler 명령에 대한 모듈당 특성. 특정 엔터프라이즈 Bean JAR 모듈의 처리에 영향을 주는 endptEnabler 명령의 이들 특성을 사용하십시오.
특성 이름 설명 기본값
<ejbJarName>.transports
특정 엔터프라이즈 Bean JAR 파일에 대해 라우터 모듈이 작성되는 전송을 나열합니다. 목록은 httpjms 값을 포함할 수 있습니다. 복수 값은 쉼표로 구분됩니다. 예는 http, jmshttp,jms입니다. http
<ejbJarName>.http.skip
그렇지 않으면 다른 특성을 기반으로 추가되는 경우에도 HTTP 라우터 모듈의 추가를 무시하는 플래그를 지정합니다. 올바른 값은 truefalse입니다. false
<ejbJarName> 
.http.routerModuleName
특정 엔터프라이즈 Bean JAR 파일에 대한 HTTP 라우터 모듈 이름을 지정합니다. ejbJarName_HTTPRouter
<ejbJarName>.http.contextRoot
특정 엔터프라이즈 Bean JAR 파일에 대한 HTTP 라우터 모듈과 연관된 컨텍스트 루트를 지정합니다. /ejbJarName
<ejbJarName>.jms.skip
그렇지 않으면 다른 특성을 기반으로 추가되는 경우에도 JMS 라우터 모듈의 추가를 무시하는 플래그를 지정합니다. 올바른 값은 truefalse입니다. false
<ejbJarName>.jms.
routerModuleName
특정 엔터프라이즈 Bean JAR 파일에 대한 JMS 라우터 모듈 이름을 지정합니다. ejbJarName_JMSRouter
<ejbJarName>.jms.
activationSpecJndiName
JMS 라우터 모듈 내에서 MDB(메시지 구동 Bean)에 대해 구성되는 활성화 스펙의 JNDI(Java Naming and Directory Interface) 이름을 지정합니다.
<ejbJarName>.jms.
listenerInputPortName
JMS 라우터 모듈 내부의 MDB에 대해 구성할 리스너 포트의 이름을 지정합니다. activationSpecJndiName 특성이 지정되지 않은 경우에만 리스너 포트가 구성됩니다.
<ejbJarName>.jms.destinationType
JMS 라우터 내부의 MDB와 연관된 JMS 대상 유형을 지정합니다. 올바른 값은 queuetopic입니다.
<ejbJarName>.<port_local_name>
.http.urlPattern=
<url_pattern_name>
포트의 URL 패턴을 지정합니다. 표시된 로컬 이름을 갖는 포트를 갖는 표시된 이름을 갖는 EJB 모듈이 있는 경우, 이 특성에서 HTTP URL 패턴을 지정할 수 있습니다. 이 특성은 HTTP 라우터 모듈에만 적용됩니다. JMS 라우터 모듈에는 효과가 없습니다.

특성 예

EAR 파일에 웹 서비스를 포함하는 StockQuoteEJB.jar이라는 엔터프라이즈 Bean JAR 파일이 있다고 가정하십시오. 다음 특성 세트를 사용하여 EAR 파일을 처리할 때 endptEnabler 명령 런타임 동작을 제어할 수 있습니다.
StockQuoteEJB.transports=http,jms

StockQuoteEJB.http.routerModuleName=StockQuoteEJB_HTTP

StockQuoteEJB.http.contextRoot=/StockQuote

StockQuoteEJB.jms.routerModuleName=StockQuoteEJB_JMS

StockQuoteEJB.jms.destinationType=queue

endptEnabler 예

다음 명령은 endptEnabler 명령을 사용할 수 있는 방법의 예입니다.
endptEnabler MyApp.ear

endptEnabler -t jms,http MyApp.ear

endptEnabler -v -properties MyApp.props MyApp.ear

endptEnabler -q -t jms MyApp.ear

endptEnabler -v -t http,jms

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



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