在 Java 2 Platform, Standard Edition 环境中以远程方式运行 wsadmin 工具
瘦管理客户机增加了支持管理客户机功能的 Java™ 归档 (JAR) 文件,可以将这些文件与 IBM® Developer Kit For the Java Platform 配合使用。
关于此任务
注意: 请注意以下限制:
- 不能使用 -conntype NONE 选项来运行瘦管理客户机。
- IBM SDK 支持 Administration Thin Client。具有相同主版本的相应 Java Development Kit (JDK) 也支持 Administration Thin Client,前提是客户机管理应用程序只使用 SOAP 接口。
- 客户机管理应用程序必须使用 com.ibm.websphere.management.AdminClientFactory API 来获取 JMX 客户机。
- 瘦管理客户机不支持安装 SAR 文件或编辑使用外部 JACC 提供程序(如 Tivoli® Access Manager)的应用程序。
z/OS® 上的瘦管理客户机没有使用 localcomm。
- 瘦管理客户机不支持安装 SAR 文件或编辑使用外部 JACC 提供程序(如 Tivoli Access Manager)的应用程序。
有关瘦管理客户机的跟踪和日志记录信息,请参阅。
过程
- 从 WebSphere® Application Server Network Deployment 安装中获取瘦管理客户机 JAR 文件及启用安全性时的其他必需文件。 请参阅“使用 Administration Thin Client”主题以获取关于执行本任务所需的文件的详细信息。
- 从服务器生成 wsadmin.sh 或 wsadmin.bat 文件。
- 将 Java 目录从服务器安装复制到瘦客户机环境。
- 在非 OSGi 环境中启动 wsadmin 工具。 wsadmin.bat 文件和 wsadmin.sh 文件的示例如下:
示例: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%
示例: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" \
"-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 $?
对于 z/OS 环境,wsadmin.sh 脚本应该具有在步骤 4 中列示的 wsadmin.bat 示例中指定的所有属性。
示例
%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
文件名:txml_j2se.html