Ejecución remota de la herramienta wsadmin en un entorno Java 2 Platform, Standard Edition
El cliente administrativo ligero añade archivos JAR (Java™ Archive) que soportan funciones de cliente administrativas que se pueden utilizar con IBM® Developer Kits para la plataforma Java.
Acerca de esta tarea
Atención: Tenga en cuenta las limitaciones siguientes:
- No se puede ejecutar un cliente administrativo ligero con la opción -conntype NONE.
- El cliente ligero de administración está soportado para los SDK de IBM. El cliente ligero de administración está soportado para el JDK (Kit de desarrollo de Java) correspondiente con la misma versión principal, siempre que la aplicación de administración del cliente utilice solo el conector SOAP.
- La aplicación de administración de cliente debe utilizar la API com.ibm.websphere.management.AdminClientFactory para obtener el cliente JMX.
- Los clientes administrativos ligeros no soportan la instalación de archivos SAR o la edición de aplicaciones que utilizan un proveedor de JACC externo, tales como Tivoli Access Manager.
Los clientes administrativos ligeros en z/OS no utilizan localcomm.
- Los clientes administrativos ligeros no soportan la instalación de archivos SAR ni la edición de aplicaciones que utilizan un proveedor de JACC externo como, por ejemplo, Tivoli Access Manager.
Para rastrear y registrar información para el cliente administrativo ligero, consulte el artículo sobre habilitación de rastreo en aplicaciones autónomas de cliente.
Procedimiento
- Obtenga el archivo JAR del cliente administrativo ligero u otros archivos que son necesarios cuando la seguridad está activada desde la instalación de WebSphere Application Server, Network Deployment. Consulte el tema Utilización del cliente ligero de administración para obtener detalles sobre los archivos que necesita para realizar esta tarea.
- Genere el archivo wsadmin.sh o wsadmin.bat desde la máquina servidor.
- Copie el directorio Java de la instalación del servidor al entorno del cliente ligero.
- Inicie la herramienta wsadmin en un entorno que no sea OSGi. A continuación, se muestran los siguientes ejemplos de archivos
wsadmin.bat y wsadmin.sh:
Ejemplo: wsadmin.bat
@REM wsadmin launcher @echo off @REM Usage: argumentos wsadmin setlocal @REM was home debe indicar el directorio que decida para el entorno del cliente ligero set WAS_HOME=c:\MyThinClient set USER_INSTALL_ROOT=%WAS_HOME% @REM Java home debe indicar el lugar donde ha instalado java para el cliente ligero set JAVA_HOME="%WAS_HOME%\java" set WAS_LOGGING=-Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager -Djava.util.logging.configureByServer=true set THIN_CLIENT=-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" ) @REM CONSOLE_ENCODING controla el cifrado de la salida utilizado para stdout/stderr @REM console - el cifrado es correcto para una ventana de la consola @REM file - el cifrado es el cifrado del archivo predeterminado del sistema @REM other - se utiliza el cifrado especificado. Por ejemplo: Cp1252, Cp850, SJIS @REM SET CONSOLE_ENCODING=-Dws.output.encoding=console @REM Para la depuración del propio programa de utilidad @REM set WAS_DEBUG=-Djava.compiler=NONE -Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=7777 set CLIENTSOAP=-Dcom.ibm.SOAP.ConfigURL=file:"%USER_INSTALL_ROOT%"\properties\soap.client.props set CLIENTSAS=-Dcom.ibm.CORBA.ConfigURL=file:"%USER_INSTALL_ROOT%"\properties\sas.client.props set CLIENTSSL=-Dcom.ibm.SSL.ConfigURL=file:"%USER_INSTALL_ROOT%"\properties\ssl.client.props set CLIENTIPC=-Dcom.ibm.IPC.ConfigURL=file:"%USER_INSTALL_ROOT%"\properties\ipc.client.props set JAASSOAP=-Djava.security.auth.login.config=%USER_INSTALL_ROOT%\properties\wsjaas_client.conf @REM lo que viene a continuación son propiedades de wsadmin @REM debe cambiar el valor para habilitar la activación del rastreo set wsadminTraceString=-Dcom.ibm.ws.scripting.traceString=com.ibm.*=todo inhabilitado set wsadminTraceFile=-Dcom.ibm.ws.scripting.traceFile="%USER_INSTALL_ROOT%"\logs\wsadmin.traceout set wsadminValOut=-Dcom.ibm.ws.scripting.validationOutput="%USER_INSTALL_ROOT%"\logs\wsadmin.valout @REM éste será el host del servidor al que se conectará set wsadminHost=-Dcom.ibm.ws.scripting.host=myhost.austin.ibm.com @REM debe asegurarse de que el número de puerto es el número de puerto del servidor SOAP al que desea conectarse, en este ejemplo, el puerto del servidor SOAP es 8887 set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=SOAP set wsadminPort=-Dcom.ibm.ws.scripting.port=8887 @REM asegúrese de que el número de puerto es el número de puerto del servidor RMI al que desea conectarse, en este ejemplo, el puerto del servidor RMI es 2815 @REM set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=RMI @REM set wsadminPort=-Dcom.ibm.ws.scripting.port=2815 @REM asegúrese de que el número de puerto es el número de puerto del servidor JSR160RMI al que desea conectarse, en este ejemplo, el puerto del servidor JSR160RMI es 2815 @REM set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=JSR160RMI @REM set wsadminPort=-Dcom.ibm.ws.scripting.port=2815 @REM asegúrese de que el número de puerto es el número de puerto del servidor IPC al que desea conectarse, en este ejemplo, el puerto del servidor IPC es 9632 y el host de IPC debe ser localhost @REM set wsadminHost=-Dcom.ibm.ws.scripting.ipchost=localhost @REM set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=IPC @REM set wsadminPort=-Dcom.ibm.ws.scripting.port=9632 @REM especifique el idioma que desea utilizar con wsadmin set wsadminLang=-Dcom.ibm.ws.scripting.defaultLang=jacl @REM set wsadminLang=-Dcom.ibm.ws.scripting.defaultLang=jython set SHELL=com.ibm.ws.scripting.WasxShell :prop set WSADMIN_PROPERTIES_PROP= if not defined WSADMIN_PROPERTIES goto workspace set WSADMIN_PROPERTIES_PROP="-Dcom.ibm.ws.scripting.wsadminprops=%WSADMIN_PROPERTIES%" :workspace set WORKSPACE_PROPERTIES= if not defined CONFIG_CONSISTENCY_CHECK goto loop set WORKSPACE_PROPERTIES="-Dconfig_consistency_check=%CONFIG_CONSISTENCY_CHECK%" :loop if '%1'=='-javaoption' goto javaoption if '%1'=='' goto runcmd goto nonjavaoption :javaoption shift set javaoption=%javaoption% %1 goto again :nonjavaoption set nonjavaoption=%nonjavaoption% %1 :again shift goto loop :runcmd set C_PATH="%WAS_HOME%\properties;%WAS_HOME%\com.ibm.ws.admin.client_9.0.jar;%WAS_HOME%\com.ibm.ws.security.crypto.jar" set PERFJAVAOPTION=-Xms256m -Xmx256m -Xj9 -Xquickstart if "%JAASSOAP%"=="" set JAASSOAP=-Djaassoap=off "%JAVA_EXE%" %PERFJAVAOPTION% %WAS_LOGGING% %javaoption% %CONSOLE_ENCODING% %WAS_DEBUG% "%THIN_CLIENT%" "%JAASSOAP%" "%CLIENTSOAP%" "%CLIENTSAS%" "%CLIENTIPC%" "%CLIENTSSL%" %WSADMIN_PROPERTIES_PROP% %WORKSPACE_PROPERTIES% "-Duser.install.root=%USER_INSTALL_ROOT%" "-Dwas.install.root=%WAS_HOME%" %wsadminTraceFile% %wsadminTraceString% %wsadminValOut% %wsadminHost% %wsadminConnType% %wsadminPort% %wsadminLang% -classpath %C_PATH% com.ibm.ws.scripting.WasxShell %* set RC=%ERRORLEVEL% goto END :END @endlocal set MYERRORLEVEL=%ERRORLEVEL% if defined PROFILE_CONFIG_ACTION exit %MYERRORLEVEL% else exit /b %MYERRORLEVEL%
Ejemplo: wsadmin.sh
#!/bin/bash # ejemplo de iniciador wsadmin # WAS_HOME debe indicar el directorio para el cliente ligero WAS_HOME="/MyThinClient" USER_INSTALL_ROOT="/MyThinClient" # JAVA_HOME debe indicar el lugar donde está instalado java para el cliente ligero JAVA_HOME="$WAS_HOME/java" WAS_LOGGING="-Djava.util.logging.manager=com.ibm.ws.bootstrap.WsLogManager -Djava.util.logging.configureByServer=true" if [[ -f ${JAVA_HOME}/bin/java ]]; then JAVA_EXE="${JAVA_HOME}/bin/java" else JAVA_EXE="${JAVA_HOME}/jre/bin/java" fi # Para la depuración del propio programa de utilidad # WAS_DEBUG=-Djava.compiler="NONE -Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=7777" CLIENTSOAP="-Dcom.ibm.SOAP.ConfigURL=file:${USER_INSTALL_ROOT}/properties/soap.client.props" CLIENTSAS="-Dcom.ibm.CORBA.ConfigURL=file:${USER_INSTALL_ROOT}/properties/sas.client.props" CLIENTSSL="-Dcom.ibm.SSL.ConfigURL=file:${USER_INSTALL_ROOT}/properties/ssl.client.props" CLIENTIPC="-Dcom.ibm.IPC.ConfigURL=file:${USER_INSTALL_ROOT}/properties/ipc.client.props" # lo que viene a continuación son propiedades de wsadmin # debe cambiar el valor para habilitar la activación del rastreo wsadminTraceString=-Dcom.ibm.ws.scripting.traceString=com.ibm.*=all=enabled wsadminTraceFile=-Dcom.ibm.ws.scripting.traceFile=${USER_INSTALL_ROOT}/logs/wsadmin.traceout wsadminValOut=-Dcom.ibm.ws.scripting.validationOutput=${USER_INSTALL_ROOT}/logs/wsadmin.valout # éste será el host del servidor al que se conectará wsadminHost=-Dcom.ibm.ws.scripting.host=myhost.austin.ibm.com # asegúrese de que el número de puerto es el número de puerto del servidor SOAP al que desea conectarse; en este ejemplo, el puerto del servidor SOAP es 8875 wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=SOAP wsadminPort=-Dcom.ibm.ws.scripting.port=8875 # asegúrese de que el número de puerto es el número de puerto del servidor RMI al que desea conectarse; en este ejemplo, el puerto del servidor RMI es 2811 #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=RMI #wsadminPort=-Dcom.ibm.ws.scripting.port=2811 # asegúrese de que el número de puerto es el número de puerto del servidor JSR160RMI al que desea conectarse; en este ejemplo, el puerto del servidor JSR160RMI es 2811 #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=JSR160RMI #wsadminPort=-Dcom.ibm.ws.scripting.port=2811 # asegúrese de que el número de puerto es el número de puerto del servidor IPC al que desea conectarse; en este ejemplo, el puerto del servidor IPC es 9630 #wsadminHost=-Dcom.ibm.ws.scripting.ipchost=localhost #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=IPC #wsadminPort=-Dcom.ibm.ws.scripting.port=9630 # especifique el idioma que desea utilizar con wsadmin wsadminLang=-Dcom.ibm.ws.scripting.defaultLang=jacl #wsadminLang=-Dcom.ibm.ws.scripting.defaultLang=jython SHELL=com.ibm.ws.scripting.WasxShell # Si las propiedades wsadmin están establecidas, utilícelas if [[ -n "${WSADMIN_PROPERTIES+V}" ]]; then WSADMIN_PROPERTIES_PROP="-Dcom.ibm.ws.scripting.wsadminprops=${WSADMIN_PROPERTIES}" else # De lo contrario, no las utilice WSADMIN_PROPERTIES_PROP= fi # Si la comprobación de coherencia de configuración está establecida, utilícela if [[ -n "${CONFIG_CONSISTENCY_CHECK+V}" ]]; then WORKSPACE_PROPERTIES="-Dconfig_consistency_check=${CONFIG_CONSISTENCY_CHECK}" else WORKSPACE_PROPERTIES= fi # Analice los argumentos de entrada isJavaOption=false nonJavaOptionCount=1 for option in "$@" ; do if [ "$option" = "-javaoption" ] ; then isJavaOption=true else if [ "$isJavaOption" = "true" ] ; then javaOption="$javaOption $option" isJavaOption=false else nonJavaOption[$nonJavaOptionCount]="$option" nonJavaOptionCount=$((nonJavaOptionCount+1)) fi fi done DELIM=" " C_PATH="${WAS_HOME}/properties:${WAS_HOME}/com.ibm.ws.admin.client_9.0.jar:${WAS_HOME}/com.ibm.ws.security.crypto.jar" #Args específicos de la plataforma... PLATFORM=`/bin/uname` case $PLATFORM in AIX | Linux | SunOS | HP-UX) CONSOLE_ENCODING=-Dws.output.encoding=console ;; OS/390) CONSOLE_ENCODING=-Dfile.encoding=ISO8859-1 EXTRA_X_ARGS="-Xnoargsconversion" ;; esac # Establezca opciones java para el rendimiento PLATFORM=`/bin/uname` case $PLATFORM in AIX) PERF_JVM_OPTIONS="-Xms256m -Xmx256m -Xquickstart" ;; Linux) PERF_JVM_OPTIONS="-Xms256m -Xmx256m -Xj9 -Xquickstart" ;; SunOS) PERF_JVM_OPTIONS="-Xms256m -Xmx256m -XX:PermSize=40m" ;; HP-UX) PERF_JVM_OPTIONS="-Xms256m -Xmx256m -XX:PermSize=40m" ;; OS/390) PERF_JVM_OPTIONS="-Xms256m -Xmx256m" ;; esac if [[ -z "${JAASSOAP}" ]]; then JAASSOAP="-Djaassoap=off" fi "${JAVA_EXE}" \ ${PERFJAVAOPTION} \ ${EXTRA_X_ARGS} \ -Dws.ext.dirs="$WAS_EXT_DIRS" \ ${EXTRA_D_ARGS} \ ${WAS_LOGGING} \ ${javaoption} \ ${CONSOLE_ENCODING} \ ${WAS_DEBUG} \ "${CLIENTSOAP}" \ "${JAASSOAP}" \ "${CLIENTSAS}" \ "${CLIENTSSL}" \ "${CLIENTIPC}" \ ${WSADMIN_PROPERTIES_PROP} \ ${WORKSPACE_PROPERTIES} \ "-Duser.install.root=${USER_INSTALL_ROOT}" \ "-Dwas.install.root=${WAS_HOME}" \ "-Dcom.ibm.websphere.thinclient=true" \
"-Djava.security.properties=${WAS_HOME}/properties/java.security" \ ${wsadminTraceFile} \ ${wsadminTraceString} \ ${wsadminValOut} \ ${wsadminHost} \ ${wsadminConnType} \ ${wsadminPort} \ ${wsadminLang} \ -classpath \ "${C_PATH}" \ com.ibm.ws.scripting.WasxShell \ "${nonJavaOption[@]}" exit $?
Para el entorno z/OS, el script wsadmin.sh debe tener todas las propiedades que se especifican en el ejemplo de wsadmin.bat que se indica en el Paso 4.
Ejemplo
%JAVA_EXE% -classpath "%C_PATH%" -Dcom.ibm.websphere.thinclient=true -Duser.install.root=%USER_INSTALL_ROOT% - Dcom.ibm.SSL.ConfigURL=file:%WAS_HOME%/properties/ssl.client.props %SOAPURL% your_class_file ${JAVA_EXE} -classpath "${C_PATH}" -Dcom.ibm.websphere.thinclient=true -Duser.install.root=${USER_INSTALL_ROOT} -Dcom.ibm.SSL.ConfigURL=file:${WAS_HOME}/properties/ssl.client.props ${SOAPURL} your_class_file


http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_j2se
File name: txml_j2se.html