Exécution de l'outil wsadmin à distance dans un environnement J2SE (Java 2 Platform, Standard Edition)

Le client d'administration léger ajoute des fichiers archive Java™ (JAR) qui prennent en charge les fonctions de client d'administration utilisables avec les kits de développement IBM® Developer pour la plateforme Java.

Pourquoi et quand exécuter cette tâche

Avertissement : Prenez connaissance des limitations suivantes :
  • Il est impossible d'exécuter un client léger d'administration avec l'option -conntype NONE.
  • Le client léger d'administration est pris en charge pour les kits IBM SDK. Le client léger d'administration est pris en charge pour le kit Java Development Kit (JDK) avec la même version, à condition que l'application d'administration client n'utilise que le connecteur SOAP.
  • L'application d'administration client doit utiliser l'API com.ibm.websphere.management.AdminClientFactory pour obtenir le client JMX.
  • Les clients d'administration partiels ne prennent pas en charge l'installation de fichiers SAR ou l'édition d'applications qui utilisent un fournisseur JACC externe tel que Tivoli Access Manager.
  • [z/OS]Les clients d'administration légers sur z/OS n'utilisent pas localcomm.
  • Les clients d'administration partiels ne prennent pas en charge l'installation de fichiers SAR ou l'édition d'applications qui utilisent un fournisseur JACC externe tel que Tivoli Access Manager.

Pour des informations sur le traçage et la journalisation du client d'administration partiel, reportez-vous à l'article Activation de la fonction de trace sur des applications client autonomes .

Procédure

  1. Récupérez le fichier JAR du client d'administration léger et les autres fichiers nécessaires à l'activation de la sécurité sur l'installation WebSphere Application Server, Network Deployment. Pour plus d'informations sur les fichiers nécessaires à l'exécution de cette tâche, reportez-vous à la rubrique Utilisation du client léger d'administration.
  2. Générez le fichier wsadmin.sh ou wsadmin.bat sur la machine du serveur.
  3. Copiez le répertoire Java depuis l'installation de serveur vers votre environnement de client léger.
  4. Lancement de l'outil wsadmin dans un environnement non OSGi. Voici des exemples pour les fichiers wsadmin.bat et wsadmin.sh :

    Exemple : wsadmin.bat

    @REM wsadmin launcher 
    @echo off 
    @REM Usage: wsadmin arguments setlocal 
    @REM was home should point to whatever directory you decide for your thin client environment 
    
    set WAS_HOME=c:\MyThinClient 
    set USER_INSTALL_ROOT=%WAS_HOME% 
    
    @REM Java home should point to where you installed java for your thinclient 
    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 controls the output encoding used for stdout/stderr 
    @REM console - encoding is correct for a console window 
    @REM file - encoding is the default file encoding for the system 
    @REM other - the specified encoding is used.  e.g. Cp1252, Cp850, SJIS 
    @REM SET CONSOLE_ENCODING=-Dws.output.encoding=console  
    @REM For debugging the utility itself 
    @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 the following are wsadmin property 
    @REM you need to change the value to enabled to turn on trace 
    set wsadminTraceString=-Dcom.ibm.ws.scripting.traceString=com.ibm.*=all=disabled 
    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 this will be the server host that you will connecting to 
    set wsadminHost=-Dcom.ibm.ws.scripting.host=myhost.austin.ibm.com  
    
    @REM you need to make sure the port number is the server SOAP port number you want to connect to, in this 
    example the server SOAP port is 8887 
    set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=SOAP 
    set wsadminPort=-Dcom.ibm.ws.scripting.port=8887  
    
    @REM you need to make sure the port number is the server RMI port number you want to connect to, in this example 
    the server RMI Port is 2815 
    @REM set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=RMI 
    @REM set wsadminPort=-Dcom.ibm.ws.scripting.port=2815  
    
    @REM you need to make sure the port number is the server JSR160RMI port number you want to connect to, 
    in this example the server JSR160RMI Port is 2815 
    @REM set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=JSR160RMI 
    @REM set wsadminPort=-Dcom.ibm.ws.scripting.port=2815  
    
    @REM you need to make sure the port number is the server IPC port number you want to connect to, 
    in this example the server IPC Port is 9632 and the host for IPC should be 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 specify what language you want to use with 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%

    Exemple : wsadmin.sh

    #!/bin/bash
    # example wsadmin launcher
    # WAS_HOME should point to the directory for the thin client
    
    WAS_HOME="/MyThinClient"
    USER_INSTALL_ROOT="/MyThinClient"
    
    # JAVA_HOME should point to where java is installed for the thin client
    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
    
    # For debugging the utility itself
    # 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"
    
    # the following are wsadmin property 
    # you need to change the value to enabled to turn on trace
    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
    
    # this will be the server host that you will be connecting to
    wsadminHost=-Dcom.ibm.ws.scripting.host=myhost.austin.ibm.com
    
    # you need to make sure the port number is the server SOAP port number you want to connect to, 
    in this example the server SOAP port is 8875
    wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=SOAP
    wsadminPort=-Dcom.ibm.ws.scripting.port=8875
    
    # you need to make sure the port number is the server RMI port number you want to connect to, 
    in this example the server RMI port is 2811
    #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=RMI
    #wsadminPort=-Dcom.ibm.ws.scripting.port=2811
    
    # you need to make sure the port number is the server JSR160RMI port number you want to connect to,
     in this example the server JSR160RMI port is 2811
    #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=JSR160RMI
    #wsadminPort=-Dcom.ibm.ws.scripting.port=2811
    
    # you need to make sure the port number is the server IPC port number you want to connect to,
     in this example the server IPC port is 9630
    #wsadminHost=-Dcom.ibm.ws.scripting.ipchost=localhost
    #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=IPC
    #wsadminPort=-Dcom.ibm.ws.scripting.port=9630
    
    # specify what language you want to use with wsadmin
    wsadminLang=-Dcom.ibm.ws.scripting.defaultLang=jacl
    #wsadminLang=-Dcom.ibm.ws.scripting.defaultLang=jython
    
    SHELL=com.ibm.ws.scripting.WasxShell
    
    # If wsadmin properties is set, use it
    if [[ -n "${WSADMIN_PROPERTIES+V}" ]]; then
         WSADMIN_PROPERTIES_PROP="-Dcom.ibm.ws.scripting.wsadminprops=${WSADMIN_PROPERTIES}"
    else
         # Not set, do not use it
         WSADMIN_PROPERTIES_PROP=
    fi
    
    # If config consistency check is set, use it
    if [[ -n "${CONFIG_CONSISTENCY_CHECK+V}" ]]; then
         WORKSPACE_PROPERTIES="-Dconfig_consistency_check=${CONFIG_CONSISTENCY_CHECK}"
    else
         WORKSPACE_PROPERTIES=
    fi
    
    
    # Parse the input arguments
    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"
    
    #Platform specific args...
    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
    
    # Set java options for performance
    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]Pour l'environnement z/OS, le script wsadmin.sh doit contenir toutes les propriétés qui sont indiquées dans l'exemple wsadmin.bat fourni à l'étape 4.

    Exemple

    %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

Icône indiquant le type de rubrique Rubrique de tâche



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_j2se
Nom du fichier : txml_j2se.html