IBM Thin Client for EJB(Enterprise JavaBeans) 실행

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][IBM i]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][IBM i]com.ibm.ws.ejb.thinclient_8.5.0.jar[z/OS]com.ibm.ws.ejb.thinclient.zos_8.5.0.jarapp_server_root\runtimes 디렉토리에 있습니다. [z/OS]z/OS에서 실행 중인 클라이언트에 com.ibm.ws.ejb.thinclient.zos_8.5.0.jar을 사용하십시오. [AIX Solaris HP-UX Linux Windows][IBM i]분산 플랫폼에서 실행하는 클라이언트에 com.ibm.ws.ejb.thinclient.jar을 사용하십시오. 사용할 클라이언트 판별은 연결 중인 서버의 플랫폼이 아닌 클라이언트 플랫폼에 따라 다릅니다.

WebSphere Application Server 제품을 포함한 IBM Thin Client for EJB의 Java 아카이브(JAR) 파일, [AIX Solaris HP-UX Linux Windows][IBM i]com.ibm.ws.ejb.thinclient_8.5.0.jar[z/OS]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][IBM i]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를 실행하십시오.

프로시저

  1. 클라이언트 애플리케이션을 호출하십시오. 다음 Java 명령을 실행하십시오.
    [Windows]
    <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>
    인증 및 SSL을 사용하려면 다음 시스템 특성을 Java 명령에 추가하십시오. [AIX][HP-UX][Solaris][Linux]
    <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> 
    -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>
    [z/OS]
    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>
  2. 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][IBM i]비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][IBM i]애플리케이션을 실행하기 전에 Java keytool 유틸리티를 사용하여 키 저장소 파일과 신뢰 저장소 파일을 작성해야 합니다. 비IBM 제품 JRE의 경우 자동 키 파일 생성이 지원되지 않습니다.

    [AIX Solaris HP-UX Linux Windows][IBM i]비IBM 제품 JRE의 기본 ORB 구현을 com.ibm.ws.orb_8.5.0.jar 파일로 대체하거나 클래스 경로에 추가해야 합니다.

  3. 클라이언트 애플리케이션을 실행하십시오.
    • endorsed_apis_8.5.0.jar 파일을 JAVA_JRE\lib\endorsed 기본 디렉토리로 복사한 경우 다음 명령을 입력하십시오. 예를 들어, 다음과 같습니다.
      [Windows][z/OS]
      %JAVA_HOME%\bin\java -Dcom.ibm.SSL.ConfigURL=file:\\\home\sample\ssl.client.props <your_client_application>
      [AIX][HP-UX][Solaris][Linux][IBM i]
      $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][z/OS]
      %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][HP-UX][Solaris][Linux][IBM i]
      $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

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



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