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.
  • [z/OS]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

  1. 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.
  2. Genere el archivo wsadmin.sh o wsadmin.bat desde la máquina servidor.
  3. Copie el directorio Java de la instalación del servidor al entorno del cliente ligero.
  4. 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" \
        [z/OS]"-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 $?
  5. [z/OS]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

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_j2se
File name: txml_j2se.html