Executando o IBM Thin Client para EJB (Enterprise JavaBeans)

Um cliente EJB é um aplicativo RMI-IIOP (Remote Method Invocation over Internet Inter-ORB Protocol) Java™ Platform, Standard Edition (Java SE) que acessa EJBs (Enterprise Java Beans) remotos de um servidor através da procura JNDI (Java Naming and Directory Interface). O IBM® Thin Client para EJB oferece uma área de cobertura menor e é fácil de implementar em um ambiente Java SE e em um ambiente Eclipse RCP (Rich Client Platform). É possível empacotar a biblioteca IBM Thin Client for EJB utilizando a instalação do WebSphere Application Server ou o Aplicativo Cliente para a instalação do WebSphere Application Server com o aplicativo. O IBM Thin Client para EJB também estende a opção de tempo de execução do Java SE. Ele pode ser executado no Java Runtime Environment (JRE) que é empacotado com o produto WebSphere Application Server, o JRE que é transferido por download a partir do website da Oracle ou o JRE que é transferido por download a partir do site da HP.

Antes de Iniciar

[AIX Solaris HP-UX Linux Windows][IBM i]A biblioteca de implementação do IBM ORB é requerida quando o IBM Thin Client para EJB está em execução com um produto JRE não-IBM em uma plataforma de produto não-IBM. Por exemplo, executar o IBM Thin Client for EJB com o JRE da Sun Microsystems no Windows, Linux ou Solaris, e com o JRE da HP no HP-UX. O JRE híbrido da HP e o Solaris híbrido fornecido pela IBM não são considerados ambientes JRE de produtos não-IBM.

O IBM Thin Client for EJB pode acessar as versões 2.x e 3.x do EJB no WebSphere Application Server utilizando a consulta JNDI, mas ele não pode acessar a versão 3.x do EJB por meio da injeção de recurso. A injeção de recurso será suportada se o aplicativo cliente for um Aplicativo Cliente Java Platform, Enterprise Edition (Java EE) em execução dentro do Contêiner do Aplicativo Cliente Java Platform, Enterprise Edition (Java EE).

Antes de configurar um ambiente do EJB Thin Client, obtenha o arquivo Java archive (JAR) para o EJB Thin Client for WebSphere Application Server. Para obter o EJB Thin Client for WebSphere Application Server, instale o WebSphere Application Server ou o Aplicativo Cliente. O EJB Thin Client para o arquivo do 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.jar, está localizado no diretório app_server_root\runtimes. [z/OS]Utilize o com.ibm.ws.ejb.thinclient.zos_8.5.0.jar para qualquer cliente que esteja em execução no z/OS. [AIX Solaris HP-UX Linux Windows][IBM i]Utilize o com.ibm.ws.ejb.thinclient.jar para qualquer cliente que é executado em plataformas distribuídas. Determinar o cliente a ser usado dependerá da plataforma do cliente, e não da plataforma do servidor à qual você está se conectando.

Copie o arquivo Java archive (JAR) para o IBM Thin Client for EJB com o produto 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.jar e os arquivos endorsed_apis_8.5.0.jar, para outras máquinas para criar um ambiente leve do cliente que permite comunicações com os produtos. As cópias do IBM Thin Client for EJB estão sujeitas aos mesmos termos e condições do contrato de licença para o produto WebSphere no qual o Thin Client for EJB foi obtido. Consulte os contratos de licença para o uso correto e outras limitações.

Copie o arquivo app_server_root\runtimes\endorsed\endorsed_apis_8.5.0.jar para o diretório padrão JAVA_JRE\lib\endorsed. Alternativamente, é possível usar a propriedade java.endorsed.dirs property para especificar um diretório da sua escolha. Se você escolher usar um diretório alternativo, é uma boa prática apenas incluir o arquivo JAR endorsed_apis.

[AIX Solaris HP-UX Linux Windows][IBM i]O IBM Thin Client for EJB com o WebSphere Application Server é executado nos sistemas operacionais distribuídos com o suporte do JDK. Ao usar o IBM Thin Client for EJB como um aplicativo independente Java SE com um JRE do produto não IBM, você deverá substituir a implementação de ORB padrão para o JRE por meio de um dos métodos a seguir:
  • Inclua o arquivo com.ibm.ws.orb_8.5.0.jar no caminho de classe do sistema Java.
  • Substitua a implementação ORB padrão no JRE, usando Java Endorsed Standards Override Mechanism.
  • Configure o caminho java.endorsed.dirs para um diretório que contém o arquivo com.ibm.ws.orb_8.5.0.jar.
Ao executar o IBM Thin Client para EJB como um aplicativo Eclipse RCP, recomenda-se usar o método dois, para substituir a implementação do JRE ORB padrão.
Atenção: Quando executar o Cliente IBM Thin para EJB e a opção da linha de comandos -Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager for usada, será emitido um erro ClassDefNotFoundError. O uso de WsLogManager não é suportado no Cliente IBM Thin para EJB, mas você pode usar outro gerenciador de log Java.

Sobre Esta Tarefa

Execute o IBM Thin Client para EJB concluindo as seguintes etapas.

Procedimento

  1. Chame o aplicativo cliente. Execute o seguinte comando 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>
    Inclua as seguintes propriedades do sistema no comando Java se você quiser autenticação e SSL ativados:[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. Forneça configuração de autenticação IIOP e Configuração SSL de Cliente. Inclua as seguintes propriedades do sistema no comando Java:
    -Dcom.ibm.SSL.ConfigURL=file:///home/user1/ssl.client.props
    -Dcom.ibm.CORBA.ConfigURL=file:///home/user1/sas.client.props
    É possível obter o arquivo ssl.client.props e o arquivo sas.client.props a partir da instalação do WebSphere Application Server e modificar o arquivo para se ajustar ao seu ambiente. Você deve, pelo menos, atualizar o local dos arquivos de chaves no arquivo ssl.client.props para corresponder ao local do seu ambiente de destino. Por exemplo:
    -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]Definições SSL de configuração recomendada ao executar o aplicativo com um JRE de produto não-IBM:
    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=JKS
    com.ibm.ssl.trustStoreProvider=SUN
    com.ibm.ssl.trustStore=/home/user1/etc/trust.jks

    [AIX Solaris HP-UX Linux Windows][IBM i]O arquivo de armazenamento de chaves e armazenamento de confiança deve ser criado usando o utilitário Java keytool antes da execução do aplicativo. A geração de arquivo de chaves automática não é suportada com um JRE de produto não-IBM.

    [AIX Solaris HP-UX Linux Windows][IBM i]Deve-se substituir a implementação do ORB padrão do JRE do produto não IBM pelo arquivo com.ibm.ws.orb_8.5.0.jar ou incluí-la no caminho de classe.

  3. Execute o aplicativo cliente:
    • Insira o comando a seguir se tiver copiado o arquivo endorsed_apis_8.5.0.jar para o diretório JAVA_JRE\lib\endorsed padrão; por exemplo:
      [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 <seu_aplicativo_cliente>
    • Insira o seguinte comando se tiver copiado o arquivo endorsed_apis_8.5.0.jar em um diretório diferente do diretório JAVA_JRE\lib\endorsed padrão; por exemplo:
      [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>

O que Fazer Depois

Ative o rastreio para o IBM Thin Client para EJB incluindo o seguinte comando Java.
  -Dcom.ibm.ejs.ras.lite.traceSpecification=*=all

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tcli_ejbthinclient
Nome do arquivo: tcli_ejbthinclient.html