wsadmin 管理 WebSphere

    WebSphere Application Server 提供了一个名为 wsadmin 的命令行管理工具，可以使用它以交互方式或通过使用 Jacl 脚本文件来运行管理命令。wsadmin 工具使用支持各种脚本语言的“Bean 脚本编制框架”（BSF）来配置和控制 WebSphere Application Server。在 WebSphere Application Server V5.0 中，wsadmin 只支持 Jacl 脚本语言。

 

 

    wsadmin 启动程序通过特定于语言的接口使 Java 对象可用。脚本将这些对象用于应用程序管理、配置、操作控制和与运行在 WebSphere 服务器进程中的 MBean 进行通信。

    WebSphere Application Server V5.0 System Management 将管理功能分成以下类别：
    ·配置：这些功能与 WebSphere Application Server V5.0 安装的配置有关。
    ·操作：这些功能与 WebSphere Application Server V5.0 安装中当前运行的对象有关。
    ·应用程序管理：这些功能与安装、卸载和管理企业应用程序有关。
以下主题提供关于 wsadmin 和如何使用它来管理 WebSphere Application Server 的实例的信息：

运行 wsadmin 工具.

    此主题描述如何启动交互式 wsadmin 会话和调用 wsadmin 命令的其它方法。可以使用交互式 wsadmin 会话输入 wsadmin 命令来管理 WebSphere Application Server 的实例。

语法和参数

    要在 wsadmin 中运行命令和脚本，必须在 Qshell 中运行 wsadmin 命令。参见此主题以获取有关 wsadmin 命令的语法和参数的信息。

脚本编制对象

    命令行管理客户机提供了四个可以在脚本中使用的对象：AdminApp、AdminControl、AdminConfig 和 Help。此主题提供关于其中每个对象的信息。

wsadmin 的 Java 属性

    wsadmin 使用的 Java 属性存储在 wsadmin.properties 文件中。此主题描述这些属性。

运行 wsadmin 工具

    此主题描述如何启动与停止交互式 wsadmin 会话和调用 wsadmin 命令的其它方法。
    交互式会话是个外壳程序环境，在此环境中可以运行 wsadmin 命令和脚本。
    启动 wsadmin
    停止 wsadmin
    也可以运行单一命令或脚本文件而不启动交互式会话，或在交互式会话启动之前运行概要文件中的命令。可以调用 wsadmin 命令的其它方法如下：
    单独运行 wsadmin 命令
    运行脚本中的 wsadmin 命令
    运行概要文件中的 wsadmin 命令

启动 wsadmin
    要启动交互式 wsadmin 会话，执行以下步骤：
    1.在 OS/400 命令行上输入“启动 Qshell”（STRQSH）命令。
    2.使用 cd 命令进入产品安装根目录的 bin 目录：
    cd /QIBM/ProdData/WebAS5/Base/bin
或
    cd /QIBM/ProdData/WebAS5/ND/bin
    3.在 Qshell 提示符下输入以下命令：
    wsadmin -instance instance
其中 instance 是要管理的实例的名称。
在退出交互式会话之前，运行以下命令来保存配置更改：
wsadmin> $AdminConfig save
如果不运行此命令，当退出交互式会话时，wsadmin 将废弃更改。

停止 wsadmin
    要退出 wsadmin，在 wsadmin 提示符下输入以下命令：
wsadmin> exit
单独运行 wsadmin 命令
    要单独运行命令，当运行 wsadmin 命令时指定 -c 选项。
wsadmin -instance instance -c '$AdminApp list'

WASX7209I: Connected to process "server" on node node using SOAP connector; The type of process is: UnManagedProcess
adminconsole
DefaultApplication
ivtApp
    在此示例中，instance 是 WebSphere Application Server 实例的名称，server 是应用程序服务器的名称，node 是 iSeries 主机服务器的名称：
当运行带有 -c 参数的命令时，将自动保存配置更改。不需要运行 $AdminConfig save 命令。

运行脚本中的 wsadmin 命令
    在运行脚本之后，wsadmin 返回至 Qshell 提示符。
要运行脚本中的命令，当运行 wsadmin 命令时指定 -f 选项：
wsadmin -instance instance -f 'script.jacl'

WASX7209I: Connected to process "server" on node node using SOAP connector; The type of process is: UnManagedProcess
adminconsole
DefaultApplication
ivtApp
    在此示例中，instance 是 WebSphere Application Server 实例的名称，server 是应用程序服务器的名称，node 是实例运行所在节点的名称，script.jacl 是包含这些命令的 Jacl 脚本的全限定路径：
set apps [$AdminApp list]
puts $apps
    如果运行对应用程序服务器的配置进行更改的脚本文件，必须在脚本的末尾包括 $AdminConfig save 命令。如果不包括此命令，wsadmin 不会保存更改。
运行概要文件中的 wsadmin 命令
    wsadmin 工具在运行概要文件中的命令后启动一个交互式会话。
要运行概要文件中的命令，当运行 wsadmin 命令时指定 -profile 选项：
wsadmin -instance instance -profile 'profile.jacl'

WASX7209I: Connected to process "server" on node node using SOAP connector;  The type of process is: UnManagedProcess
Applications currently installed:
adminconsole
DefaultApplication
ivtApp
WASX7029I: For help, enter: "$Help help"
wsadmin>
    在此示例中，instance 是 WebSphere Application Server 实例的名称，server 是应用程序服务器的名称，node 是实例运行所在节点的名称，profile.jacl 是包含这些命令的概要文件的全限定路径：
set apps [$AdminApp list]
puts "Applications currently installed:\n$apps"


语法和参数

    此页面描述 wsadmin 命令的语法和参数。
语法
wsadmin -instance instance [ -c 'command' | -f scriptfile ]
[ -lang lang ] [ -p propertiesfile ] [ -profile scriptfile ]
[ -conntype SOAP | RMI | JMS | NONE [ -host host ] [ -port port] ]
[ -wsadmin_classpath classpath ] [ -help ] [ -? ] [ script_parameters ]
参数
    ·-instance
    如果要使用非缺省实例，则需要此参数。如果未对此参数指定值，wsadmin 使用缺省实例。
    ·-c
    此可选参数指定要运行的单一命令。如果指定此参数，wsadmin 运行输入的命令，然后将控制权返回到 Qshell 提示符。要运行多个命令，可以对要运行的每个命令指定 -c 参数。将按列示命令的次序运行命令。
    ·-f
    此可选参数指定脚本源和要运行的脚本。如果指定此参数，wsadmin 运行指定的脚本，然后返回到 Qshell 提示符。
    ·-lang
因为 Jacl 是唯一支持的脚本语言，所以不需要指定此参数。
    ·-p
    此可选参数指定要装入的属性文件。在装入用 -p 指定的任何文件之前，将装入两个属性文件。
    1.第一个文件是以下目录中的 wsadmin. 属性文件：
    §WebSphere Application Serve ：
/QIBM/UserData/WebAS5/Base/instance/properties/wsadmin.properties
    §WebSphere Application Server Network Deployment：
/QIBM/UserData/WebAS5/ND/instance/properties/wsadmin.properties
其中 instance 为 WebSphere Application Server 实例的名称。
    2.第二个文件是 /home/QEJBSVR/wsadmin.properties。此文件未随 WebSphere Application Server 一起交付。
可以多次指定 -p 参数。如果这样做，将按指定的次序调用属性文件。
    ·-profile
    此可选参数指定概要文件脚本。概要文件脚本在其它命令或脚本之前运行。如果指定 -c，概要文件在单一命令之前运行。如果指定 -f，概要文件在脚本之前运行。如果不指定 -c 或 -f，wsadmin 运行概要文件中的命令，然后启动交互式 wsadmin 会话。可以指定多个 -profile 参数。如果这样做，将按指定的次序调用概要文件脚本。
    ·-conntype
    此可选参数指定用于连接至要管理的应用程序服务器的连接类型。conntype 参数的有效值为 SOAP、RMI、JMS 和 NONE。缺省值为 SOAP。（JMS 在 WebSphere Application Server 的当前版本中是不受支持的连接类型。）-conntype 参数确定哪个端口（如果有的话）用于连接至服务器。如果将 conntype 参数指定为 NONE ，则只有 $AdminApp 命令可用。
    ·-host
    此可选参数指定运行您想管理的应用程序服务器的系统的主机名。如果不指定此参数，则主机名缺省为 localhost。
    ·-port
    如果指定 -conntype 参数，则可以指定用于连接至远程应用程序服务器的端口号。例如，如果使用 SOAP 连接，则为要管理的应用程序服务器指定 SOAP 端口。如果不指定此参数，则脚本使用在实例的 wsadmin. 属性文件中对 com.ibm.ws.scripting.port 属性指定的值（如果该属性存在）。如果属性在为 wsadmin 脚本显式或隐式指定的任何属性文件中不存在，将发生错误。当创建实例时，将用实例的 SOAP 和 RMI 连接器端口更新 wsadmin. 属性文件。对于缺省 WebSphere Application Server 实例，这些端口为 8880（对于 SOAP）和 2809（对于 RMI）。对于缺省 WebSphere Application Server Network Deployment 实例，这些端口为 8879（对于 SOAP）和 9809（对于 RMI）。
    ·-wsadmin_classpath
    此可选参数使附加类可用于脚本编制进程。值 classpath 指定包含要 wsadmin 访问的类的类路径。指定的类路径将添加至脚本编制进程的类装入器中。也可以在 wsadmin.properties 文件中用 com.ibm.ws.scripting.classpath 属性指定此选项。-wsadmin_classpath 参数覆盖在 wsadmin.properties 中指定的任何值。
    ·-help 或 -?
    提供语法帮助的可选自变量。
    ·script_parameters
    如果指定 -f 参数以运行脚本，则可以在 wsadmin 命令中包括该脚本的参数。
    示例
    下列示例演示了正确的语法。在这些示例中，mymachine 为包含 SOAP 或 RMI 连接器的服务器运行所在的主机的名称。在 wsadmin. 属性文件中通过 com.ibm.ws.scripting.port 指定端口。
    ·与本地主机上的缺省 WebSphere Application Server 实例的 SOAP 连接
    wsadmin
    ·与本地主机上的 WebSphere Application Server 实例 test 的 SOAP 连接
    wsadmin -instance test
    ·使用端口 8880 与 as400 主机的 SOAP 连接
    wsadmin -conntype SOAP -host as400 -port 8880
    ·使用端口 2809 与 as400 主机的 RMI 连接
    wsadmin -conntype RMI -host as400 -port 2809

脚本编制对象
    有四个对象可以在脚本中使用：
·    AdminControl
·    AdminConfig
·    AdminApp
·    Help

AdminControl 对象
    可以使用 AdminControl 对象来对在 WebSphere Application Server 中运行的对象调用操作命令。
    可用于 AdminControl 的方法示例包括：getAttribute、setAttribute 和 invoke。很多 AdminControl 方法有多个特征符，以便可以使用通过“Java 管理扩展”（JMX）指定的参数或使用字符串表示参数来以原始方式调用它们。
    注意：大多数用户应该使用字符串特征符。
    除了操作命令外，AdminControl 对象还支持某些用于跟踪、再连接服务器和转换类型的实用程序方法。有关更多信息，参见用于脚本管理的 AdminControl 对象。

AdminConfig 对象
    使用 AdminConfig 对象来调用配置命令并创建或更改 WebSphere Application Server 配置的元素。
    AdminConfig 对象的方法示例包括：create、remove、list、show 和 modify。有关更多信息，参见用于脚本管理的 AdminConfig 对象。

AdminApp 对象
    使用 AdminApp 对象来安装、修改和管理应用程序。
    AdminApp 对象与 WebSphere Application Server 管理和配置服务进行交互以便执行应用程序查询和更改。它包括安装和卸载应用程序、移动模块、列示模块和导出等等。AdminApp 对象与 AdminConfig 和 AdminControl 对象不同，因为要使用 AdminConfig 和 AdminContro，必须将脚本编制进程连接至服务器。可以用本地方式调用大多数 AdminApp 功能，这意味着客户机不与服务器通信就能完成功能。有关更多的信息，参见用于脚本管理的 AdminApp 对象。

Help 对象
    Help 对象提供一般帮助和有关正在运行的 MBean 的动态联机信息。
    可以使用 Help 对象来帮助编写和运行具有 AdminControl 对象的脚本。某些方法包括：attributes、operations、AdminConfig 和 AdminControl。有关更多的信息，参见用于脚本管理的 Help 对象。


wsadmin 的 Java 属性

    wsadmin 编制脚本客户机使用以下所示的 Java 属性。这些属性在 wsadmin.properties 文件中指定，此文件位于以下目录：
·WebSphere Application Server：/QIBM/UserData/WebAS5/Base/instance/properties
    ·WebSphere Application Server Network Deployment：/QIBM/ProdData/WebAS5/ND/instance/properties
其中 instance 是实例的名称。
    注意：这些属性中的某些属性有两个缺省值。
    ·iSeries 缺省值
    当创建实例时，将在 wsadmin.properties 文件中设置此值。此文件中指定的值覆盖 wsadmin 工具缺省值。
    ·wsadmin 工具缺省值
这些值已在工具中硬编码。如果未指定其它值，则工具使用这些缺省值。

    以下是包含在 wsadmin.properties 文件中的 Java 属性：
·com.ibm.ws.scripting.connectionType
    此值确定要使用的连接类型。可能值为 SOAP（简单对象访问协议）、RMI（远程方法调用）或 NONE。iSeries 缺省值为 SOAP。
·com.ibm.ws.scripting.port
    此属性指定连接器使用的端口。缺省值为实例的 SOAP 端口。
·com.ibm.ws.scipting.host
    脚本编制进程尝试连接的主机。缺省值为 localhost。
·com.ibm.ws.scripting.defaultLang
    此属性指定当执行脚本时要使用的语言。Jacl 是唯一受支持的语言。如果指定 -f 参数，则 wsadmin 检查文件扩展名是否映射至已知值。例如，如果文件名是 test.jacl，则它将语言设置为 JACL。如果未指定 -f 参数或文件类型是未知的，则 wsadmin 会生成错误。
    iSeries 缺省值：jacl。
    工具缺省值：无
·com.ibm.ws.scripting.traceFile
    此属性指定一个文件，脚本编制进程将把跟踪和记录信息写入该文件。
    iSeries 缺省值：以下目录中的 wsadmin.traceout 文件：
§    WebSphere Application Server：
/QIBM/UserData/WebAS5/Base/instance/logs/wsadmin.traceout
§    WebSphere Application Server Network Deployment：
/QIBM/UserData/WebAS5/ND/instance/logs/wsadmin.traceout
其中 instance 是实例的名称。
    工具缺省值：将跟踪输出打印至屏幕。
·com.ibm.ws.scripting.validationOutput
    此属性指定将验证报告定向至何处。如果多个用户同时使用 wsadmin 管理某个实例，建议在用户属性文件中指定不同的 validationOutput 属性。
    iSeries 缺省值：以下目录中的 wsadmin.valout 文件：
§    WebSphere Application Server：
/QIBM/UserData/WebAS5/Base/instance/logs/wsadmin.valout
§    WebSphere Application Server Network Deployment：
/QIBM/UserData/WebAS5/ND/instance/logs/wsadmin.valout
其中 instance 是实例的名称。
    工具缺省值：当前目录中的 wsadmin.valout
·com.ibm.ws.scripting.traceString
    此属性用于打开对脚本编制进程的跟踪。例如，使用 com.ibm.ws.scripting.*=all=enabled 来打开对脚本编制代码的所有跟踪。缺省值为不使用跟踪。
·com.ibm.ws.scripting.profiles
    概要文件属性是 wsadmin 在运行用户命令、脚本或交互式外壳程序之前运行的概要文件的列表。
    iSeries 缺省值包括 /QIBM/ProdData/WebAS5/Base/bin/securityProcs.jacl 和 /QIBM/ProdData/WebAS5/Base/bin/LTPA_LDAPSecurityProcs.jacl。这些概要文件脚本使得配置安 全性很容易。
    工具缺省值：无
·com.ibm.ws.scripting.emitWarningForCustomSecurityPolicy
    此属性指定当找到定制许可时是否发出消息 WASX7207W。可能值为 TRUE 和 FALSE。
    iSeries 缺省值：无
    工具缺省值：TRUE
·com.ibm.ws.scripting.tempdir
    此属性指定当安装应用程序时要用于临时文件的目录。
    iSeries 缺省值：无
    工具缺省值：Java 系统属性 java.io.tempdir 的值
·com.ibm.ws.scripting.validationLevel
    此属性指定当从脚本编制界面进行配置更改时要使用的验证级别。可能值为 NONE、LOW、MEDIUM、HIGH 和 HIGHEST。
    iSeries 缺省值：无
    工具缺省值：HIGHEST
·com.ibm.ws.scripting.crossDocumentValidationEnabled
    此属性指定当更改一个文档时验证机制是否检查其它文档。可能值为 TRUE 和 FALSE。
    iSeries 缺省值：无
    工具缺省值：TRUE
·com.ibm.ws.scripting.classpath
    此类路径属性将附加到用于搜索类和资源的路径列表中。对于 iSeries 或 wsadmin 工具无缺省值。