EJB 클라이언트는 서버에서
JNDI(Java™ Naming
and Directory Interface) 검색을 통해 원격 Enterprise Java
Beans에 액세스하는 RMI-IIOP(Remote Method Invocation over Internet
Inter-ORB Protocol) Java SE(Java
Platform, Standard Edition) 애플리케이션입니다. IBM® Thin
Client for EJB는 더 적은 풋프린트를 제공하며
Java SE 환경과 Eclipse RCP(Rich Client
Platform) 환경에 배치하기 간편합니다. WebSphere® Application Server
설치나 Application Client for WebSphere Application Server 설치를 사용하여 IBM Thin Client for EJB
라이브러리를 애플리케이션과 함께 번들할 수 있습니다. IBM Thin
Client for EJB는 Java SE 런타임 선택의 폭을 넓히기도
합니다. WebSphere Application Server 제품과 함께
패키징된 JRE(Java Runtime Environment), Oracle 웹 사이트에서
다운로드하는 JRE 또는 HP 웹 사이트에서 다운로드하는 JRE에서
실행할 수 있습니다.
시작하기 전에
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
IBM ORB
구현 라이브러리는 IBM Thin Client for EJB가 비IBM 제품 플랫폼에서
비IBM 제품 JRE로 실행 중인 경우에 필요합니다. 예를 들어, IBM Thin Client for EJB를
Windows, Linux 또는 Solaris에서 Sun
Microsystems JRE로 그리고 HP-UX에서 HP JRE로 실행하는
경우입니다. IBM 제공 Solaris 하이브리드 및
HP 하이브리드 JRE는 비IBM 제품 환경으로 간주되지 않습니다.
IBM Thin Client for EJB는
JNDI 검색을 사용하여 WebSphere Application Server에서
버전 2.x 및 버전 3.x EJB에 액세스할 수 있지만, 자원 인젝션을 통해
버전 3.x EJB에 액세스할 수는 없습니다.
자원 인젝션은 클라이언트 애플리케이션이 Java EE(Java Platform, Enterprise Edition)
애플리케이션 클라이언트 컨테이너 내에서 실행하는 Java EE(Java Platform, Enterprise Edition)
애플리케이션 클라이언트인 경우에
지원됩니다.
EJB 씬 클라이언트 환경을 설정하기 전에 EJB Thin Client for WebSphere Application Server에 대한
Java 아카이브(JAR) 파일을
얻으십시오. EJB Thin Client for
WebSphere Application Server를 얻으려면
WebSphere Application Server 또는
애플리케이션 클라이언트를 설치하십시오. EJB Thin Client for WebSphere Application Server 파일, ![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
com.ibm.ws.ejb.thinclient_8.5.0.jar
com.ibm.ws.ejb.thinclient.zos_8.5.0.jar은 app_server_root\runtimes 디렉토리에
있습니다.
z/OS에서 실행 중인 클라이언트에
com.ibm.ws.ejb.thinclient.zos_8.5.0.jar을 사용하십시오. ![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
분산
플랫폼에서 실행하는 클라이언트에 com.ibm.ws.ejb.thinclient.jar을
사용하십시오. 사용할 클라이언트
판별은 연결 중인 서버의 플랫폼이 아닌 클라이언트 플랫폼에 따라
다릅니다.
WebSphere Application Server 제품을 포함한
IBM Thin
Client for EJB의 Java 아카이브(JAR) 파일, ![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
com.ibm.ws.ejb.thinclient_8.5.0.jar
com.ibm.ws.ejb.thinclient.zos_8.5.0.jar,
endorsed_apis_8.5.0.jar 파일을
다른 시스템에 복사하여 제품과의 통신을 가능하게 하는 경량 클라이언트 환경을
작성하십시오. IBM Thin
Client for EJB의 사본은 Thin Client for EJB를 얻은
WebSphere 제품과 동일한
라이센스 계약 이용 약관을 따릅니다. 올바른 사용법 및 기타 제한사항에 대한 라이센스 계약을 참조하십시오.
app_server_root\runtimes\endorsed\endorsed_apis_8.5.0.jar 파일을
기본 디렉토리, JAVA_JRE\lib\endorsed로 복사하십시오.
또는 java.endorsed.dirs 특성을 사용하여
선택한 디렉토리를 지정할 수 있습니다. 대체 디렉토리를 사용하도록 선택하는 경우
우수 사례는 endorsed_apis JAR 파일만 포함시키는 것입니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
WebSphere Application Server을 갖는 IBM Thin Client
for EJB는 JDK 지원을 갖는 분산 운영 체제에서
실행합니다. IBM Thin Client for EJB를 비IBM
제품 JRE를 갖는 독립형 Java SE 애플리케이션으로 사용할 때,
다음 방법 중 하나를 통해 JRE에 대한 기본 ORB 구현을 대체해야 합니다.
- com.ibm.ws.orb_8.5.0.jar 파일을 Java 시스템 클래스 경로에 포함시키십시오.
- Java Endorsed Standards 대체 메커니즘을
사용하여 JRE의 기본 ORB 구현을 대체하십시오.
- java.endorsed.dirs 경로를
com.ibm.ws.orb_8.5.0.jar 파일을 포함한 디렉토리로 설정하십시오.
IBM Thin
Client for EJB를 Eclipse RCP 애플리케이션으로 실행할 때에는
기본 JRE ORB 구현을 대체하는 두 번째 방법을 사용하는 것이 좋습니다.
주의: IBM Thin
Client for EJB를 실행 중이며 -Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager 명령행
옵션을 사용하는 경우에는 ClassDefNotFoundError 오류가
발생합니다. WsLogManager의 사용은 IBM Thin Client for EJB에서 지원되지 않지만 다른 Java 로깅 관리자를 사용할 수 있습니다.
이 태스크 정보
다음 단계를 완료하여 IBM Thin Client
for EJB를 실행하십시오.
프로시저
- 클라이언트 애플리케이션을 호출하십시오. 다음 Java 명령을 실행하십시오.
![[Windows]](../images/windows.gif)
<java_install_root>\bin\java
-classpath com.ibm.ws.ejb.thinclient_8.5.0.jar;<list_of_your_application_jars_and_classes>
-Djava.naming.provider.url=iiop://<your_application_server_machine_name>
<fully_qualified_class_name_to_run>
![[z/OS]](../images/ngzos.gif)
export LIBPATH=<app_server_root>/lib:$LIBPATH
<java_install_root>/bin/java
-classpath com.ibm.ws.ejb.thinclient.zos_8.5.0.jar:<list_of_your_application_jars_and_classes>
-Djava.naming.provider.url=iiop://<your_application_server_machine_name>
-Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
-Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
<fully_qualified_class_name_to_run>
- IIOP 인증 구성 및 클라이언트 SSL 구성을
제공하십시오. 다음 시스템 특성을 Java 명령에 추가하십시오.
-Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
-Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
ssl.client.props
파일과
sas.client.props 파일을
WebSphere Application Server 설치에서 얻고
파일을 환경에 적합하게 수정할 수 있습니다. 대상 환경의
위치가 일치하도록 적어도
ssl.client.props 파일에서
키 파일의 위치를 업데이트해야 합니다. 예를 들어, 다음과 같습니다.
-Dcom.ibm.ssl.keyStore=/home/user1/etc/key.p12
-Dcom.ibm.ssl.trustStore=/home/user1/etc/trust.p12
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
비IBM 제품 JRE의
애플리케이션을 실행할 때의 권장하는 SSL 구성 설정: com.ibm.ssl.protocol=SSL
com.ibm.ssl.trustManager=SunX509
com.ibm.ssl.keyManager=SunX509
com.ibm.ssl.contextProvider=SunJSSE
com.ibm.ssl.keyStoreType=JKS
com.ibm.ssl.keyStoreProvider=SUN
com.ibm.ssl.keyStore=/home/user1/etc/key.jks
com.ibm.ssl.trustStoreType=JKScom.ibm.ssl.trustStoreProvider=SUN
com.ibm.ssl.trustStore=/home/user1/etc/trust.jks
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
애플리케이션을 실행하기 전에
Java keytool
유틸리티를 사용하여 키 저장소 파일과 신뢰 저장소 파일을 작성해야
합니다. 비IBM 제품 JRE의 경우
자동 키 파일 생성이 지원되지 않습니다.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
비IBM 제품 JRE의 기본 ORB 구현을
com.ibm.ws.orb_8.5.0.jar 파일로 대체하거나
클래스 경로에 추가해야 합니다.
- 클라이언트 애플리케이션을 실행하십시오.
- endorsed_apis_8.5.0.jar 파일을 JAVA_JRE\lib\endorsed
기본 디렉토리로 복사한 경우 다음 명령을 입력하십시오.
예를 들어, 다음과 같습니다.
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
%JAVA_HOME%\bin\java -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
$JAVA_HOME/bin/java -Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>
- endorsed_apis_8.5.0.jar 파일을
기본 JAVA_JRE\lib\endorsed 디렉토리 이외의 디렉토리로
복사한 경우에는 다음 명령을 입력하십시오. 예를 들어,
다음과 같습니다.
![[Windows]](../images/windows.gif)
![[z/OS]](../images/ngzos.gif)
%JAVA_HOME%\bin\java
-Djava.endorsed.dirs=<directory_that_includes_endorsed_apis_8.5.0.jar>
-Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
![[AIX]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[Solaris]](../images/solaris.gif)
![[Linux]](../images/linux.gif)
![[IBM i]](../images/iseries.gif)
$JAVA_HOME/bin/java
-Djava.endorsed.dirs=<directory_that_includes_endorsed_apis_8.5.0.jar>
-Dcom.ibm.SSL.ConfigURL=file:///home/sample/ssl.client.props <your_client_application>
다음에 수행할 작업
Java 명령에 다음을 추가해서 IBM Thin
Client for EJB에 대한 추적을 사용하십시오.
-Dcom.ibm.ejs.ras.lite.traceSpecification=*=all