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 사용법 구문
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 모듈의 처리에 영향을 미칩니다.
특성 이름 | 설명 | 기본값 |
---|---|---|
verbose | 상세한 진행상태 메시지를 표시합니다. | False |
quiet | 간단한 진행상태 메시지만 표시합니다. | False |
http.enableRouterSecurity | 모든 EJB 모듈이 엔터프라이즈 Bean JAR 파일에서 보안되는 경우 인증된 모든 사용자가 HTTP 라우터 모듈을 보호하도록 보안 정책을 추가할 수 있게 합니다. | False |
http.enableClientCertSecurity | 기본 인증이나 양식 로그인 대신 인증서
인증을 위한 web.xml 파일에 다음 로그인 구성
스탠자를 추가할 수 있게 합니다.
|
False |
http.routerModuleNameSuffix | 기본 HTTP 라우터 모듈 이름을 구성하는 데 사용되는 접미부를 지정합니다. .war 확장자가 endptEnabler 명령에 의해 추가됩니다. | _HTTPRouter |
jms.routerModuleNameSuffix | 기본 JMS 라우터 모듈 이름을 구성하는 데 사용되는 접미부를 지정합니다. .jar 확장자가 endptEnabler 명령에 의해 추가됩니다. | _JMSRouter |
jms.defaultDestinationType | EAR 파일에 추가된 모든 JMS 라우터 모듈에 사용할 기본 대상 유형을 지정합니다. 이 유형은 큐 아니면 토픽입니다. | 큐 |
defaultTransports | 라우터 모듈이 작성되는 전송의 기본 목록을 지정합니다. 목록은 http 및 jms 값을 포함할 수 있습니다. 복수 값은 쉼표로 구분됩니다. 예는 http, jms 및 http,jms입니다. | http |
다음 표는 endptEnabler 명령에서 지원하는 모듈당 특성을 기술합니다. ejbJarName 변수는 .jar 확장자 없이 EAR 파일에서 엔터프라이즈 Bean JAR 모듈의 이름을 참조합니다.
특성 이름 | 설명 | 기본값 |
---|---|---|
|
특정 엔터프라이즈 Bean JAR 파일에 대해 라우터 모듈이 작성되는 전송을 나열합니다. 목록은 http 및 jms 값을 포함할 수 있습니다. 복수 값은 쉼표로 구분됩니다. 예는 http, jms 및 http,jms입니다. | http |
|
그렇지 않으면 다른 특성을 기반으로 추가되는 경우에도 HTTP 라우터 모듈의 추가를 무시하는 플래그를 지정합니다. 올바른 값은 true 및 false입니다. | false |
|
특정 엔터프라이즈 Bean JAR 파일에 대한 HTTP 라우터 모듈 이름을 지정합니다. | ejbJarName_HTTPRouter |
|
특정 엔터프라이즈 Bean JAR 파일에 대한 HTTP 라우터 모듈과 연관된 컨텍스트 루트를 지정합니다. | /ejbJarName |
|
그렇지 않으면 다른 특성을 기반으로 추가되는 경우에도 JMS 라우터 모듈의 추가를 무시하는 플래그를 지정합니다. 올바른 값은 true 및 false입니다. | false |
|
특정 엔터프라이즈 Bean JAR 파일에 대한 JMS 라우터 모듈 이름을 지정합니다. | ejbJarName_JMSRouter |
|
JMS 라우터 모듈 내에서 MDB(메시지 구동 Bean)에 대해 구성되는 활성화 스펙의 JNDI(Java Naming and Directory Interface) 이름을 지정합니다. | 널 |
|
JMS 라우터 모듈 내부의 MDB에 대해 구성할 리스너 포트의 이름을 지정합니다. activationSpecJndiName 특성이 지정되지 않은 경우에만 리스너 포트가 구성됩니다. | 널 |
|
JMS 라우터 내부의 MDB와 연관된 JMS 대상 유형을 지정합니다. 올바른 값은 queue 및 topic입니다. | 큐 |
|
포트의 URL 패턴을 지정합니다. 표시된 로컬 이름을 갖는 포트를 갖는 표시된 이름을 갖는 EJB 모듈이 있는 경우, 이 특성에서 HTTP URL 패턴을 지정할 수 있습니다. 이 특성은 HTTP 라우터 모듈에만 적용됩니다. JMS 라우터 모듈에는 효과가 없습니다. | 널 |
특성 예
StockQuoteEJB.transports=http,jms
StockQuoteEJB.http.routerModuleName=StockQuoteEJB_HTTP
StockQuoteEJB.http.contextRoot=/StockQuote
StockQuoteEJB.jms.routerModuleName=StockQuoteEJB_JMS
StockQuoteEJB.jms.destinationType=queue
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