本Blog所有内容不得随意转载，版权属于作者所有。如需转载请与作者联系（ fastzch@163.com ）。
未经许可的转载，本人保留一切法律权益。
一直以来，发现有某些人完全不尊重我的劳动成果，随意转载，提醒一下那些人小心哪天惹上官司。

there are two types of tasks: the operational task and the configurational task.

wsadmin 支持两种脚本语言： jacl(Java Command Language ， deprecated) & Jython 。 WAS6.1 提供了工具转换 Jacl 脚本为 Jython ，工具名为： Jacl2Jython 。这个工具能转换 95-98% 的内容，但是开发人员必须手动的检查所有的转换。

 

wsadmin.bat(or wsadmin.sh) 在每个应用服务器的 profile ， DM ，被管理的节点实例的 bin 目录下，所以当你启动 wsadmin 的时候，必须注意选择正确的位置。

要想得到 wsadmin 语法相关的帮助，可以输入 wsadmin.bat -? ，以下是帮助的详细内容：

----------------------------------------------------------------------

WASX7001I: wsadmin 是用于 WebSphere 脚本编制的可执行文件。

语法：

  wsadmin

        [ -h(elp)  ]

        [ -?]

        [ -c <command> ]

        [ -p <properties_file_name>]

        [ -profile <profile_script_name>]

        [ -f <script_file_name>]

        [ -javaoption java_option]

        [ -lang  language]

        [ -wsadmin_classpath  classpath]

        [ -profileName profile]

        [ -conntype

                SOAP

                        [-host host_name]

                        [-port port_number]

                        [-user userid]

                        [-password password] |

                RMI

                        [-host host_name]

                        [-port port_number]

                        [-user userid]

                        [-password password] |

                NONE

        ]

        [ -jobid <jobid_string>]

        [ -tracefile <trace_file>]

        [ -appendtrace <true/false>]

        [ script parameters ]

 

其中     “ command ”是要传递给脚本处理程序的命令；

        “ properties_file_name ”是要使用的 java 属性文件；

        “ profile_script_name ”是在主命令或文件前要执行的脚本文件；

        “ script_file_name ”是要传递给脚本处理程序的命令；

        “ java_option ”是要传递给 Java 程序的 java 标准或非标准选项；

        “ language ”是要用于解释脚本的语言；受支持的值为“ jacl ”和“ jython ”。

        “ classpath ”是附加到内置路径中的类路径；

        “ -conntype ”指定要使用的连接类型；

                缺省参数是“ SOAP ”

                conntype 为“ NONE ”意味着没有建立服务器连接

                且某些操作会以本地方式执行；

        “ host_name ”是用于 SOAP 或 RMI 连接的端口；

                缺省值是本地主机；

         “ port_number ”是用于 SOAP 或 RMI 连接的端口；

        “ userid ”是服务器以安全方式运行时

                所需的用户标识；

        “ password ”是服务器以安全方式运行时

                所需的密码；

        “ script parameters ”是命令行上的任何其他内容。它们

                在 argv 变量中传递给脚本；参数的数目

                可在 argc 变量中获得。

        “ jobid_string ”是要用来审计 wsadmin 的每个调用的

                作业标识字符串；

        “ trace_file ”是 wsadmin 跟踪输出定向至的

                日志文件名和位置；

 

如果未指定命令或脚本，将创建一个解释器 shell

以供交互使用。要离开交互式脚本编制会话，

使用“ quit ”或“ exit ”命令。

 

可以在单个命令行上指定几个命令、属性文件和

概要文件。它们是按照其指定的顺序处理和执行的。

----------------------------------------------------------------------

 

 

配置 wsadmin 有三种方式：

1 ，使用 Profile 或系统默认的属性文件：

       <profile_home>/properties/wsadmin.properties

       or

       <was_home>/properties/wsadmin.properties

2 ，使用自定义的环境变量去替换原来的配置文件的位置，环境变量为： WSADMIN_PROPERTIES, 可以 Copy 默认的属性文件到你指定的位置，然后修改它。

3 ，在执行 wsadmin 命令时使用 -p 参数来设置属性文件的位置

 

Wsadmin 属性列表

Property	Value
com. ibm.ws.scr ipting.con nectionTyp e	SOAP, RMI or NONE
com. ibm.script ing.port	TCPport of targetsystem
com. ibm.script ing.host	Host name oftarget system
com. ibm.ws.scr ipting.def aultLang	Jython or Jacl
com. ibm.ws.scr ipting.ech oparams	Determineswhether parametersor argumentsare outputto STDOUTorto the wsadmintrace file
com. ibm.ws.scr ipting.tra ceFile	File for trace information
com. ibm.ws.scr ipting.val i dationOutput	Location ofvalidation reports
com. ibm.ws.scr ipting.tra ceString	= com.ibm.*=all=enabled
com. ibm.ws.scr ipting.app endTrace	Appends tothe end ofthe existing log file
com. ibm.ws.scr ipting.pro files	List ofprofiles to be run before running user commands, scripts,oran interactive shell
com. ibm.ws.scr ipting.emi tWarningFo rC usto mSecurityP olicy	ControlswhethermessageWASX7207W is emitted when custom permissions are found
com. ibm.ws.scr ipting.tem pdir	Store temporary fileswhen installing applications
com. ibm.ws.scr ipting.val idationLev el	Levelof validation to use when configurationchangesaremadefromthe scripting interface
com. ibm.ws.scr ipting.cro ssDocument Va lida tionEnable d	Determineswhether thevalidation mechanismexamines other documents whenchangesaremadetoonedocument
com. ibm.ws.scr ipting.cla sspath	List ofpathsto search for classes and resources

 

Wsadmin 的调用有三种不同的方式：

使用单行命令方式 (-c)

       wsadmin –c AdminControl.getNode()

使用交互方式

       wsadmin

运行脚本文件，使用 -f 参数

       wsadmin –f myScript.py

 

使用 -profile 参数，表示要执行的一些预先执行的脚本。

使用 -p 可以定义属性文件的位置。

 

Wsadmin 管理的对象包括：

AdminControl ：用于操作控制。通过 MBean 来进行通讯，包含查询在在的运行中的对象和其属性，并在这些对象上调用操作。另外，支持关于连接服务的查询，客户端跟踪的方便命令，重新连接至服务器，启动和停止服务器。

AdminConfig ：管理存储在仓库中的配置信息。通过 WAS 的配置服务组件来查询和更改配置。可以使用它来查询存在的配置对象，创建配置对象，修改存在的对象和移除配置对象。在分布式的环境中，此命令仅仅能用于连接到 DM ，不能连接到 Node Agent 或管理某一 Application Server ，因为这些服务器的进程配置仅仅是保存在 DM 上的一个 Copy( 副本 ) 。

AdminApp ：能更新应用的元数据，映射虚拟主机到 Web 模块，映射已安装的模块至服务器。对一个应用程序进行更改，比如为应用程序指定一个共享库，设置会话管理的配置属性。

AdminTask ：用于访问面向任务的管理命令。这些命令用于访问配置命令和运行时对象管理命令。当脚本客户端运行时，可以自动发现管理命令。可用的管理命令以用于安装 WAS 的版本。

Help ：

       print Help.AdminControl()

运行环境： AdminConfig ， AdminTask ， AdminApp 对象都是处理配置功能。可以在连接或不连接至服务器的环境下运行，但 AdminControl 需要连接到服务器才能运行，因为他是通过调用正在运行的 JMX MBean 来执行的。

 

 

AdminControl.queryNames(*)

查询当前运行在 MBean Server 上的所有 MBean 的对象名。

如果客户端隶属于一个单独的 Server ，这个列表中仅包含运行在这个 Server 上的 MBean 。

如果客户端隶属于一个 Node Agent ，这个列表包含运行在此节点上所有 Server 的 MBean 。

如果客户端隶属于一个 DM ，这个列表中则包含运行在这个 DM 上的所有 Node Agent ，所有 Server 的 MBean 。

 

一个列出所有 MBean 对象的脚本：

会得到如下形式的内容：

你可以通过关键字来缩小查找范围，如：

wsadmin>AdminControl.queryNames('WebSphere:type=Server,node=starNode01,*')

另外，也可以通过 completeObjectName 命令来获得其完整的对象名。如：

wsadmin>AdminControl. completeObjectName ('WebSphere:type=Server,node=starNode01,*')

但这个命令如果遇到多个匹配项的时候会提示并只会返回第一项。

 

可以通过如下方法得到一个对象的属性：

wsadmin>serv=AdminControl. completeObjectName ('WebSphere:type=Server,*')

wsadmin>print Help.attributes(serv)

得到如下结果：

每一个属性都有可读写性，RO代表只读，RW代表可读可写。

我们可以通过 AdminControl 的 getAttribute 和 setAttribute 方法来对这些属性进行操作，如：

AdminControl.getAttribute(serv,'pid')

 

同时， operations 命令也可以为我们列出某一 MBean 支持的操作，如下：

print Help.operations(serv)

 

MBean 支持的操作可以用 invoke 命令来进行调用，如：

print AdminControl.invoke(serv,'getVersionsForAllProducts')

 

另外，有一个图形化的工具 MBI （ MBeanInspector ）可以查看和调用 MBean 的这些属性。目前 IBM 的网站上提供的版本是为 WAS5.x 的版本开发的，但是在 WAS6.x 中也可以使用。 MBI 并不是与 profile 相关的，可以使用 WAS 安装目录 profile 下的 sas.proerties 文件替换到 WAS 根目录下面的 sas.properties 文件，以此来允许安全的连接。其网址为：

http://www.alphaworks.ibm.com/tech/mbeaninspector

 

 

AdminConfig and AdminTask Objects are used to managed configuration information.

AdminConfig 通过 WAS 的配置服务查询和更新配置。所有通过 AdminConfig 的命令的 modifications 都被存储到临时的工作空间，直到调用 save 命令。

注意：使用 AdminConfig 配置 WAS ，需要对 WAS 的 XML 配置文档和配置目录内容有很好的理解。

Types 命令

WAS 的配置在一组 XML 文档中由 types 和 attribute names 组成。在 wsadmin 中，每一个元素类型被作为一个具有唯一配置 ID 的配置对象管理。所有可用的配置对象都可以用 types 命令列出。命令为： AdminConfig.types()

同时，也可以用 AdminConfig 的 attributes 命令来列出某一对象的属性，如：

wsadmin>print AdminConfig.attributes('WorkManagerInfo')

 

一个对象可以包含另一个对象，因此，父子关系在配置中也存在。可以通过 parents 命令来获得其父对象，如： wsadmin>AdminConfig.parents('ApplicationServer')

 

getid 命令返回一个配置对象的配置名。配置对象被命名为对象及其配置 ID 的组合。

 

list 命令返回给定类型的一个对象列表。例如，可以将 DataSource 对象列出。如:

wsadmin>AdminConfig.list('DataSource')

 

defaults 命令显示一个对象的属性的默认值列表。如：

wsadmin>print AdminConfig.defaults('DynamicCache')

 

配置对象的 input 和 output 属性

AdminConfig 的 attributes 命令是 wsadmin 在线帮助的一部分。

 

 

使用 AdminConfig 和 AdminControl 需要一些 JMX 框架和 WebSphere XML 配置结构的一些知识。为了执行一系列的脚本管理任务，而又没有底层架构的知识， AdminTask 对象将给你一些引导。

AdminTask 对象的命令更像是一个向导，提供一步一步的向导去执行管理操作。同时，也可以交互式的调用，会提示给用户一些需要的参数，或者是像批次调用一样，所有的输入作为调用的一部分。

AdminTask 对象提供很多命令来执行简单或复杂的管理任务，为了某一特定的任务找到一个命令，这些命令被按照逻辑进行了分组。

用如下命令可以列出所有的分组：

wsadmin>print AdminTask.help('-commandGroups')

会得出所有的分组。然后，可以对其中的某一组命令进行查询，如：

wsadmin>print AdminTask.help('AdminReports')

可得出如下结果：

此时，可进一步查询某一命令的用法，如下：

wsadmin>print AdminTask.help('reportConfiguredPorts')

调用其中某一命令的方法为：

wsadmin>print AdminTask.reportConfiguredPorts()

此命令可得到如下结果：

根据前面所说，我们可以使用交互式的方式来调用，如下：

wsadmin>print AdminTask.reportConfiguredPorts('-interactive')

会出现如下提示：

此时，我们输入节点名，如：starNode01

再输入F或直接回车，表示参数输入完成，即可得到starNode01所有的端口报表，由于我的实验环境中只有一个节点，所以结果跟上面的命令相同。