Tool "wsadmin" über Fernzugriff in einer J2EE-Umgebung ausführen

Der Thin-Verwaltungsclient fügt JAR-Dateien (Java-Archiv) hinzu, die Verwaltungsclientfunktionen unterstützen und die Sie mit IBM Developer Kits für die Java-Plattform verwenden können.

Informationen zu diesem Vorgang

Achtung: Beachten Sie die folgenden Einschränkungen:
  • Ein Thin-Verwaltungsclient kann nicht mit der Option "-conntype NONE" ausgeführt werden.
  • Der Thin-Verwaltungsclient wird für IBM SDKs unterstützt. Der Thin-Verwaltungsclient wid für das entsprechende Java Development Kit (JDK) mit derselben Hauptversion unterstützt, sofern die Clientverwaltungsanwendung nur den SOAP-Connector verwendet.
  • Die Clientverwaltungsanwendung muss die API com.ibm.websphere.management.AdminClientFactory verwenden, um den JMX-Client abzurufen.
  • Thin-Verwaltungsclients bieten keine Unterstützung für die Installation von SAR-Dateien und die Bearbeitung von Anwendungen, die externe JACC-Provider wie Tivoli Access Manager verwenden.
  • [z/OS]Thin-Verwaltungsclients unter z/OS verwenden localcomm nicht.
  • Thin-Verwaltungsclients bieten keine Unterstützung für die Installation von SAR-Dateien und die Bearbeitung von Anwendungen, die externe JACC-Provider wie Tivoli Access Manager verwenden.

Informationen zur Traceerstellung und Protokollierung für den Thin-Verwaltungsclient finden Sie unter "Trace in Client- und eigenständigen Anwendungen aktivieren".

Vorgehensweise

  1. Rufen Sie die JAR-Datei des Thin-Verwaltungsclients und alle anderen Dateien, die bei aktivierter Sicherheit erforderlich sind, aus der Installation von WebSphere Application Server Network Deployment ab. Einzelheiten zu den DAteien, die Sie für die Ausführung dieser Task benötigen, finden Sie im Artikel "Thin-Verwaltungsclient verwenden".
  2. Generieren Sie die Datei wsadmin.sh oder wsadmin.bat auf der Servermaschine.
  3. Kopieren Sie das Java-Verzeichnis aus der Serverinstallation in Ihre Thin-Client-Umgebung.
  4. Starten Sie das Tool "wsadmin" in einer Nicht-OSGi-Umgebung. Im Folgenden sind Beispiele für die Dateien wsadmin.bat und wsadmin.sh aufgeführt:

    Beispiel: wsadmin.bat

    @REM wsadmin launcher 
    @echo off
    @REM Syntax: wsadmin Argumente setlocal
    @REM WAS_HOME muss auf das Verzeichnis zeigen, das Sie für Ihre Thin-Client-Umgebung verwenden möchten
    
    set WAS_HOME=c:\MyThinClient
    set USER_INSTALL_ROOT=%WAS_HOME%
    
    @REM JAVA_HOME muss auf das Verzeichnis zeigen, in dem Sie Java für Ihren Thin Client installiert haben
    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 steuert die Ausgabecodierung für stdout/stderr
    @REM console - Codierung ist für ein Konsolfenster korrekt
    @REM file - Codierung ist die Standarddateicodierung für das System
    @REM andere - Es wird die angegebene Codierung verwendet, z. B. Cp1252, Cp850, SJIS
    @REM SET CONSOLE_ENCODING=-Dws.output.encoding=console
    @REM Zum Debuggen des Dienstprogramms selbst
    @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 Es folgen wsadmin-Eigenschaften
    @REM Sie müssen den Wert in enabled ändern, um die Traceerstellung zu aktivieren
    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 Dies ist der Server-Host, zu dem Sie eine Verbindung herstellen
    set wsadminHost=-Dcom.ibm.ws.scripting.host=myhost.austin.ibm.com
    
    @REM Sie müssen sicherstellen, dass die Portnummer der Nummer des Server-SOAP-Ports entspricht, zu dem Sie eine
    @REM Verbindung herstellen möchten. In diesem Beispiel ist die Nummer des Server-SOAP-Ports 8887.
    set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=SOAP
    set wsadminPort=-Dcom.ibm.ws.scripting.port=8887
    
    @REM Sie müssen sicherstellen, dass die Portnummer der Nummer des Server-RMI-Ports entspricht, zu dem Sie eine
    @REM Verbindung herstellen möchten. In diesem Beispiel ist die Nummer des Server-RMI-Ports 2815.
    @REM set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=RMI
    @REM set wsadminPort=-Dcom.ibm.ws.scripting.port=2815
    
    @REM Sie müssen sicherstellen, dass die Portnummer der Nummer des Server-JSR160RMI-Ports entspricht, zu dem Sie eine
    @REM Verbindung herstellen möchten. In diesem Beispiel ist die Nummer des Server-JSR160RMI-Ports 2815.
    @REM set wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=JSR160RMI
    @REM set wsadminPort=-Dcom.ibm.ws.scripting.port=2815
    
    @REM Sie müssen sicherstellen, dass die Portnummer der Nummer des Server-IPC-Ports entspricht, zu dem Sie die Verbindung herstellen möchten. In diesem Beispiel ist 9632 der Server-IPC-Port, und der Host für IPC muss localhost sein.
    @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 Geben Sie die für wsadmin zu verwendende Sprache an
    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%  

    Beispiel: wsadmin.sh

    #!/bin/bash
    # Bespiel für wsadmin-Startprogramm
    # WAS_HOME muss auf das Verzeichnis für den Thin Client zeigen
    
    WAS_HOME="/MyThinClient"
    USER_INSTALL_ROOT="/MyThinClient"
    
    # JAVA_HOME muss auf die Position zeigen, an der Java für den Thin Client installiert ist
    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
    
    # Für das Debugging des Dienstprogramms selbst
    # 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"
    
    # Es folgen wsadmin-Eigenschaften
    # Sie müssen den Wert in enabled ändern, um die Traceerstellung zu aktivieren
    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
    
    # Dies ist der Server-Host, zu dem Sie eine Verbindung herstellen
    wsadminHost=-Dcom.ibm.ws.scripting.host=myhost.austin.ibm.com
    
    # Sie müssen sicherstellen, dass die Portnummer der Nummer des Server-SOAP-Ports entspricht, zu dem Sie eine
    # Verbindung herstellen möchten. In diesem Beispiel ist die Nummer des Server-SOAP-Ports 8875.
    wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=SOAP
    wsadminPort=-Dcom.ibm.ws.scripting.port=8875
    
    # Sie müssen sicherstellen, dass die Portnummer der Nummer des Server-RMI-Ports entspricht, zu dem Sie eine
    # Verbindung herstellen möchten. In diesem Beispiel ist die Nummer des Server-RMI-Ports 2811.
    #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=RMI
    #wsadminPort=-Dcom.ibm.ws.scripting.port=2811
    
    # Sie müssen sicherstellen, dass die Portnummer der Nummer des Server-JSR160RMI-Ports entspricht, zu dem Sie eine
    # Verbindung herstellen möchten. In diesem Beispiel ist die Nummer des Server-JSR160RMI-Ports 2811.
    #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=JSR160RMI
    #wsadminPort=-Dcom.ibm.ws.scripting.port=2811
    
    # Sie müssen sicherstellen, dass die Portnummer der Nummer des Server-IPC-Ports entspricht, zu dem Sie eine
    # Verbindung herstellen möchten. In diesem Beispiel ist die Nummer des Server-IPC-Ports 9630.
    #wsadminHost=-Dcom.ibm.ws.scripting.ipchost=localhost
    #wsadminConnType=-Dcom.ibm.ws.scripting.connectionType=IPC
    #wsadminPort=-Dcom.ibm.ws.scripting.port=9630
    
    # Geben Sie die für wsadmin zu verwendende Sprache an
    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
    
    
    # Eingabeargumente parsen
    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"
    
    #Plattformspezifische Argumente...
    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
    
    # Java-Optionen für die Leistung festlegen
    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]Für die Umgebung z/OS müssen alle Eigenschaften, die in der Beispieldatei wsadmin.bat in Schritt 4 aufgelistet sind, im Script wsadmin.sh angegeben sein.

    Beispiel

    %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

Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=txml_j2se
Dateiname:txml_j2se.html