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.
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
- 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".
- Generieren Sie die Datei wsadmin.sh oder wsadmin.bat auf der Servermaschine.
- Kopieren Sie das Java-Verzeichnis aus der Serverinstallation in Ihre Thin-Client-Umgebung.
- 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" \
"-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 $?
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


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