Utilizando o Administration Thin Client

Com o Administration Thin Client, é possível executar a ferramenta wsadmin ou um programa Java™ administrativo independente com apenas alguns arquivos Java archive (JAR). Isso reduz o tempo gasto para que a ferramenta wsadmin seja iniciada e o desempenho melhorado. Estas informações para configurar problemas clientes JMX.

Antes de Iniciar

Verifique se o IBM® Software Development Kit (SDK) está instalado no Administration Thin Client. Recomenda-se usar o mesmo IBM SDK que o servidor com o qual ele se conecta no ambiente doThin-Client administrativo.
Importante: O Administration Thin Client é suportado para os IBM SDKs. Ele também é suportado pelo Oracle Java Development Kit (JDK) correspondente com a mesma versão principal, contanto que:
  • O aplicativo de administração cliente utilize apenas o conector SOAP.
  • O aplicativo de administração do cliente use a API com.ibm.websphere.management.AdminClientFactory para obter o cliente JMX.
Atenção: Não é possível executar um thin client administrativo com a opção -conntype NONE.

Sobre Esta Tarefa

Não é possível utilizar o Administration Thin Client para gerenciar feature packs e nem implementar artefatos de aplicativo que são específicos para os feature packs.

O Administration Thin Client não suporta a instalação de arquivos SIP Application Archive (SAR) ou a edição de aplicativos que usam um provedor Java Authorization Contract for Containers (JACC) externo, como o Tivoli Access Manager.

O Administrative Thin Client não suporta a passagem de um token Kerberos para um servidor. Ele suporta apenas autenticação básica, que transmite o ID do usuário e a senha.

O Administration Thin Client não suporta coexistência com outros clientes thin.

O Administration Thin Client na plataforma z/OS não usa localcomm.

Para obter informações de rastreio e de criação de log para o Administration Thin Client, consulte Ativando o Rastreio em Aplicativos Clientes e Independentes.

Procedimento

  1. Disponibilize os arquivos JAR do Administration Thin-Client ao copiar com.ibm.ws.admin.clientXXX.jar a partir de um ambiente do WebSphere Application Server para um ambiente fora do WebSphere Application Server, por exemplo, c:\MyThinClient. Os arquivos JAR do Administration Thin Client com.ibm.ws.admin.client_9.0.jar e com.ibm.ws.admin.client.forJython21_9.0.jar estão localizados em um dos locais a seguir:
    • O diretório AppServer/runtimes.
    • O diretório AppClient/runtimes, se por opção você tiver selecionado o Cliente Thin de Administração quando instalou o aplicativo cliente.

    O com.ibm.ws.admin.client_9.0.jar precisa ser usado para o jython27 e o com.ibm.ws.admin.client.forJython21_9.0.jar precisa ser usado para o jython21.

    Nota: Na Versão 9, o wsadmin usará o jython27 por padrão. O Jython21 ainda é suportado e para usar o jython21, é necessário usar o argumento wsadin -usejython21 true ou atualizar o com.ibm.ws.scripting.usejython21=true no arquivo wsadmin.properties.
    Evitar Problemas Evitar Problemas: Se você estiver vendo um erro e o jython não carregar, tem algo configurado incorretamente, tal como você está usando o jython21, mas configurou o caminho da classe para com.ibm.ws.admin.client_9.0.jar ou está usando do jython27, mas configurou o caminho da classe java para com.ibm.ws.admin.client.forJython21_9.0.jar. Certifique-se de estar configurando o caminho da classe java para o jar correto. O Jython27 não suporta Java7 ou inferior. Deve-se usar o mesmo nível Java que o do servidor WebSphere com o qual está se conectando.gotcha
  2. Use os arquivos JAR do Administration Thin-Client para compilar e testar programas clientes de administração. Para aplicativos Java, é possível compilar e executar os arquivos JAR em um ambiente padrão do Java 2 Platform, Standard Edition. Para obter informações adicionais, consulte o tópico Compiling an administration application using the Thin Administration Client.
  3. Copie o diretório de mensagens do diretório app_server_root/properties para o diretório C:\MyThinClient\properties.
  4. Se a segurança estiver ativada, os seguintes arquivos também serão necessários:
    • Copie o arquivo com.ibm.ws.security.crypto.jar do diretório AppServer/plugins ou do diretório AppClient/plugins e coloque-o no diretório C:\MyThinClient.
    • Se você estiver usando o conector IPC, copie, opcionalmente, o arquivo ipc.client.props do diretório AppServer\profiles\profileName/properties ou AppClient\properties e coloque-o no diretório C:\MyThinClient\properties. Alternativamente, é possível configurar as propriedades do arquivo ipc.client.props programaticamente no código Java.
    • Se você estiver usando o conector SOAP, copie, opcionalmente, o arquivo soap.client.props do diretório AppServer\profiles\profileName\properties e coloque-o no diretório C:\MyThinClient\properties. Em seguida, ative a segurança do cliente definindo a propriedade com.ibm.CORBA.securityEnabled como true. Alternativamente, é possível configurar as propriedades do arquivo soap.client.props programaticamente no código Java.
    • Se você estiver usando os conectores RMI ou JSR160RMI, copie o arquivo sas.client.props do diretório AppServer/profiles/profileName/properties e coloque-o no diretório C:\MyThinClient\properties.

      Se houver um firewall em sua instalação e seu aplicativo cliente usar RMI para receber notificações, poderá receber um erro RemoteException após tentar implementar um aplicativo. O listener de notificações com RMI não funciona por um firewall porque necessita de uma porta do listener no cliente atendendo notificações. Esta porta do listener não está diretamente acessível quando o servidor tenta enviar notificações de volta à porta do cliente. Em vez do RMI, use um conector SOAP, que pesquisa por notificações.

    • Copie os arquivos wsjaas_client.conf do diretório AppServer\profiles\profileName/properties ou do diretório AppClient/properties e coloque-os no diretório C:\MyThinClient\properties.
    • Copie ou gere o arquivo ssl.client.props do diretório AppServer\profiles\profileName/properties ou do diretório AppClient/properties e coloque-o no diretório C:\MyThinClient\properties.
      Atenção: Esse arquivo contém a propriedade user.root. Deve-se modificar o valor para o seu diretório thin-client, por exemplo, C:\MyThinClient.
    • Se você estiver usando o IBM SDK, copie os arquivos key.p12 e trust.p12 do diretório AppServer\profiles\profileName\etc e coloque-os no diretório C:\MyThinClient\etc. Para concluir essa tarefa, copie o arquivo para o diretório thin client ou execute um script para gerar o arquivo. Para obter informações adicionais, consulte os seguintes tópicos:
      • Arquivo de Configuração do Cliente ssl.client.props
      • Interoperando com Versões Anteriores do Produto
      • Comando retrieveSigners
      • Instalação segura para recuperação de assinante do cliente em SSL
    • Se você estiver usando o Sun JDK, altere as seguintes propriedades no arquivo ssl.client.props para que ele use a chave JKS e os truststores e as implementações do Sun Microsystems nos gerenciadores de chave e confiança:
      com.ibm.ssl.alias=DefaultSSLSettings
      com.ibm.ssl.protocol=SSL
      com.ibm.ssl.securityLevel=HIGH
      com.ibm.ssl.trustManager=SunX509
      com.ibm.ssl.keyManager=SunX509
      com.ibm.ssl.contextProvider=SunJSSE
      com.ibm.ssl.enableSignerExchangePrompt=gui
      
      # Informações de keystore
      com.ibm.ssl.keyStoreName=ClientDefaultKeyStore
      com.ibm.ssl.keyStore=${user.root}/etc/keystore.jks
      com.ibm.ssl.keyStorePassword=keystore_password
      com.ibm.ssl.keyStoreType=JKS
      com.ibm.ssl.keyStoreProvider=SUN
      com.ibm.ssl.keyStoreFileBased=true
      
      # Informações de truststore
      com.ibm.ssl.trustStoreName=ClientDefaultTrustStore
      com.ibm.ssl.trustStore=${user.root}/etc/truststore.jks
      com.ibm.ssl.trustStorePassword=truststore_password
      com.ibm.ssl.trustStoreType=JKS
      com.ibm.ssl.trustStoreProvider=SUN
      com.ibm.ssl.trustStoreFileBased=true
  5. Ative o Administration Thin Client ou execute a ferramenta wsadmin remotamente em um ambiente do Java 2 Platform, Standard Edition. Para ativar o aplicativo de administração, use os seguintes scripts de ativação de amostra:
    Nota: Se você estiver usando o Oracle JDK, configure a propriedadecom.ibm.websphere.thinclient da JVM como true.
    [Windows]
    set WAS_HOME=c:\MyThinClient 
    set USER_INSTALL_ROOT=%WAS_HOME% 
    set JAVA_HOME=location_of_the_JRE_file 
    
    REM C_PATH is the class path. Add to it as needed. 
    REM Classpath to use for jython27 (comment this out if using jython21)
    set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    REM Classpath to use for jython21 (uncomment this to use jython21)
    REM set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client.forJython21_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    set SOAPURL=-Dcom.ibm.SOAP.ConfigURL=%WAS_HOME%\properties\soap.client.props 
    set TC=-Dcom.ibm.websphere.thinclient=true 
    
    if exist %JAVA_HOME%\bin\java.exe ( 
           set JAVA_EXE=%JAVA_HOME%\bin\java 
    ) else ( 
           set JAVA_EXE=%JAVA_HOME%\jre\bin\java 
    ) 
    
    %JAVA_EXE% -classpath "%C_PATH%" %TC% -Duser.install.root=%USER_INSTALL_ROOT% -Dcom.ibm.SSL.ConfigURL=file %WAS_HOME%/properties/ssl.client.props %SOAPURL% your_class_file#
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    !/bin/bash 
    WAS_HOME=/MyThinClient 
    USER_INSTALL_ROOT=${WAS_HOME} 
    JAVA_HOME=location_of_the_JRE_file 
    
    # C_PATH is the class path. Add to it as needed. 
    # Classpath to use for jython27 (comment this out if using jython21)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    # Classpath to use for jython27 (comment this out if using jython27)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client.forJython21_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    SOAPURL=-Dcom.ibm.SOAP.ConfigURL=${WAS_HOME}/properties/soap.client.props 
    TC=-Dcom.ibm.websphere.thinclient=true 
    
    if [[ -f ${JAVA_HOME}/bin/java ]]; then 
           JAVA_EXE="${JAVA_HOME}/bin/java" 
    else 
           JAVA_EXE="${JAVA_HOME}/jre/bin/java" 
    fi 
    
    ${JAVA_EXE} -classpath "${C_PATH}" $TC -Duser.install.root=${USER_INSTALL_ROOT} -Dcom.ibm.SSL.ConfigURL=file:${WAS_HOME}/properties/ssl.client.props ${SOAPURL} your_class_file

Í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=txml_adminclient
Nome do arquivo: txml_adminclient.html