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.
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.
- 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: 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
- 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.
- Copie el directorio de mensajes desde el directorio raíz_servidor_aplic/properties al directorio C:\MyThinClient\properties.
- 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
- 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]](../images/windows.gif)
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]](../images/aixlogo.gif)
![[HP-UX]](../images/hpux.gif)
![[IBM i]](../images/iseries.gif)
![[Linux]](../images/linux.gif)
![[Solaris]](../images/solaris.gif)
![[z/OS]](../images/ngzos.gif)
!/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