Utilización del cliente ligero de administración

Con el cliente ligero de administración, puede ejecutar la herramienta wsadmin o un programa Java™ administrativo autónomo con sólo un par de archivos JAR (Java). Esto reduce el tiempo que tarda la herramienta wsadmin en iniciarse y una mejora del rendimiento. Esta información es para configurar los programa clientes JMX.

Antes de empezar

Asegúrese de que SDK (Software Development Kit) de IBM® esté instalado en el cliente ligero de administración. . Se recomienda que utilice el mismo IBM SDK que el servidor al que se conecta en el entorno administrativo de Thin-Client.
Importante: El cliente ligero de administración está soportado para los SDK de IBM. También está soportado para el correspondiente JDK (Java Development Kit) de Oracle con la misma versión principal, siempre que:
  • La aplicación de administración de cliente sólo utiliza el conector SOAP.
  • La aplicación de administración de cliente utilice la API com.ibm.websphere.management.AdminClientFactory para obtener el cliente JMX.
Atención: No se puede ejecutar un cliente administrativo ligero con la opción -conntype NONE.

Acerca de esta tarea

No puede utilizar el cliente ligero de administración para gestionar paquetes de características ni desplegar artefactos de aplicación específicos de paquetes de características.

El cliente ligero de administración no soporta la instalación de archivos SAR (SIP Application Archive) o la edición de aplicaciones que utilizan un proveedor JACC (Java Authorization Contract for Containers) externo, por ejemplo Tivoli Access Manager.

El cliente ligero de administración no soporta la transferencia de la señal Kerberos a un servidor. Sólo soporta la autenticación básica, que pasa el ID de usuario y la contraseña.

El cliente ligero de administración no soporta la coexistencia con otros clientes ligeros.

El cliente ligero de administración en la plataforma z/OS no utiliza localcomm.

Para rastrear y registrar información para el cliente ligero de administración, consulte Habilitación del rastreo en aplicaciones autónomas y de clientes.

Procedimiento

  1. Haga que los archivos JAR del cliente ligero de administración estén disponibles copiando com.ibm.ws.admin.clientXXX.jar de un entorno de WebSphere Application Server a un entorno externo a WebSphere Application Server, por ejemplo, c:\MyThinClient. Los archivos JAR del cliente ligero de administración com.ibm.ws.admin.client_9.0.jar y com.ibm.ws.admin.client.forJython21_9.0.jar se encuentran en una de las ubicaciones siguientes:
    • El directorio AppServer/runtimes.
    • El directorio AppClient/runtimes, si ha seleccionado opcionalmente el cliente ligero de administración al instalar el cliente de aplicaciones.

    Se debe utilizar com.ibm.ws.admin.client_9.0.jar para jython27 y com.ibm.ws.admin.client.forJython21_9.0.jar para jython21.

    Nota: En la Versión 9, wsadmin utilizará jython27 de forma predeterminada. Jython21 aún está soportado y, para utilizar jython21, debe utilizar el argumento de wsadmin -usejython21 true o actualizar com.ibm.ws.scripting.usejython21=true en el archivo wsadmin.properties.
    Avoid trouble Avoid trouble: Si ve un error y jython no se carga, habrá algún valor de configuración incorrecto, por ejemplo, utiliza jython21 pero establece la vía de acceso de clases en com.ibm.ws.admin.client_9.0.jar o bien utiliza jython27 pero establece la vía de acceso de claves java en com.ibm.ws.admin.client.forJython21_9.0.jar. Asegúrese de que establece la vía de acceso de clases java en el jar correcto. Jython27 no da soporte a Java7 o inferior. Debe utilizar el mismo nivel Java que el servidor WebSphere al que está intentando conectarse.gotcha
  2. Utilice los archivos JAR del cliente ligero de administración para compilar y probar los programas cliente de administración. Para aplicaciones Java, puede compilar y ejecutar los archivos JAR en un entorno estándar Java 2 Platform, Standard Edition. Para obtener más información, consulte el tema Compilación de una aplicación de administración utilizando el cliente ligero de administración.
  3. Copie el directorio de mensajes desde el directorio raíz_servidor_aplic/properties al directorio C:\MyThinClient\properties.
  4. Si la seguridad está activada, también necesita los archivos siguientes:
    • Copie el archivo com.ibm.ws.security.crypto.jar del directorio AppServer/plugins o el directorio AppClient/plugins y colóquelo en el directorio C:\MiClienteLigero.
    • Si utiliza el conector IPC, copie opcionalmente el archivo ipc.client.props del directorio AppServer\profiles\nombrePerfil/properties o AppClient\properties en el directorio C:\MyThinClient\properties. De forma alternativa, puede establecer las propiedades del archivo ipc.client.props mediante programa en el código Java.
    • Si va a utilizar el conector SOAP, copie opcionalmente el archivo soap.client.props del directorio AppServer\profiles\nombre_perfil\properties y colóquelo en el directorio C:\MyThinClient\properties. A continuación, habilite la seguridad del cliente configurando la propiedad com.ibm.CORBA.securityEnabled en true. De forma alternativa, puede establecer las propiedades del archivo soap.client.props mediante programa en el código Java.
    • Si va a utilizar conectores RMI o JSR160RMI, copie el archivo sas.client.props del directorio AppServer/profiles/nombre_perfil/properties y colóquelo en el directorio C:\MyThinClient\properties.

      Si hay un cortafuegos en la instalación y el cliente de aplicaciones utiliza RMI para recibir notificaciones, puede recibir un error RemoteException después de intentar desplegar una aplicación. Un escucha de notificaciones con RMI no funciona a través de un cortafuegos porque requiere un puerto de escucha en el cliente que está a la escucha de las notificaciones. Este puerto de escucha no es accesible directamente cuando el servidor intenta enviar notificaciones de vuelta al puerto del cliente. En lugar de RMI, utilice un conector SOAP, que sondea las notificaciones.

    • Copie los archivos wsjaas_client.conf del directorio AppServer\profiles\nombre_perfil/properties o el directorio AppClient/properties y colóquelos en el directorio C:\MyThinClient\properties.
    • Copie o genere el archivo ssl.client.props del directorio AppServer\profiles\nombrePerfil/properties o el directorio AppClient/properties y póngalo en el directorio C:\MiClienteLigero\properties.
      Atención: Este archivo contiene la propiedad user.root. Debe modificar el valor del directorio del cliente ligero, por ejemplo, C:\MyThinClient.
    • Si utiliza el SDK de IBM, copie los archivos key.p12 y trust.p12 del directorio AppServer\profiles\nombrePerfil\etc y colóquelos en el directorio C:\MiClienteLigero\etc. Para completar esta tarea, copie el archivo en el directorio del cliente ligero o ejecute un script para generar el archivo. Para obtener más información, consulte los temas siguientes:
      • Archivo de configuración del cliente ssl.client.props
      • Cómo actuar conjuntamente con las versiones anteriores del producto
      • Mandato retrieveSigners
      • Instalación segura para recuperador de firmantes de cliente SSL
    • Si está utiliza el JDK de Sun, cambie las siguientes propiedades en el archivo ssl.client.props de modo que utilice claves y almacenes de confianza JKS y las implementaciones de Sun Microsystems en los gestores de claves y de confianza:
      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
      
      # Información del almacén de claves
      com.ibm.ssl.keyStoreName=ClientDefaultKeyStore
      com.ibm.ssl.keyStore=${user.root}/etc/almacén_claves.jks
      com.ibm.ssl.keyStorePassword=contraseña_almacén_claves
      com.ibm.ssl.keyStoreType=JKS
      com.ibm.ssl.keyStoreProvider=SUN
      com.ibm.ssl.keyStoreFileBased=true
      
      # Información del almacén de confianza
      com.ibm.ssl.trustStoreName=ClientDefaultTrustStore
      com.ibm.ssl.trustStore=${user.root}/etc/almacén_confianza.jks
      com.ibm.ssl.trustStorePassword=contraseña_almacén_confianza
      com.ibm.ssl.trustStoreType=JKS
      com.ibm.ssl.trustStoreProvider=SUN
      com.ibm.ssl.trustStoreFileBased=true
  5. Inicie el cliente ligero de administración o ejecute la herramienta wsadmin de forma remota en un entorno de Java 2 Platform, Standard Edition. Para iniciar la aplicación de administración, utilice los siguientes scripts de ejecución de ejemplo:
    Nota: Si utiliza el JDK de Oracle, establezca la propiedad JVM com.ibm.websphere.thinclient en true.
    [Windows]
    set WAS_HOME=c:\MyThinClient 
    set USER_INSTALL_ROOT=%WAS_HOME% 
    set JAVA_HOME=ubicación_del_archivo_JRE
    
    REM C_PATH es la vía de acceso de clases. Añádala según sea necesario.
    REM Vía de acceso de clases que se utilizará para jython27 (si utiliza jython21, comente la línea)
    set C_PATH=%WAS_HOME%\com.ibm.ws.admin.client_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar 
    
    REM Vía de acceso de clases que se utilizará para jython21 (para jython21, descomente la línea)
    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% archivo_clases#
    [AIX][HP-UX][IBM i][Linux][Solaris][z/OS]
    !/bin/bash 
    WAS_HOME=/MyThinClient 
    USER_INSTALL_ROOT=${WAS_HOME}
    JAVA_HOME=ubicación_archivo_JRE
    
    # C_PATH es la vía de acceso de clases. Añádala según sea necesario.
    # Vía de acceso de clases que se utilizará para jython27 (si utiliza jython21, comente la línea)
    C_PATH=${WAS_HOME}/com.ibm.ws.admin.client_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar 
    
    # Vía de acceso de clases que se utilizará para jython27 (si utiliza jython27, comente la línea)
    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} archivo_clases

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_adminclient
File name: txml_adminclient.html