首页 > 代码库 > WLST 命令和变量

WLST 命令和变量

下列部分将详细描述 WLST 命令和变量。主题包括:

  •  WSLT 命令类别概述
  •  浏览命令
  •  控制命令
  •  部署命令
  •  诊断命令
  •  编辑命令
  •  信息命令
  •  生命周期命令
  •  节点管理器命令
  •  树命令
  •  WLST 变量参考

 


WSLT 命令类别概述

注意:有关命令语法要求,建议您查看 WLST 命令的语法。

WLST 命令分为下列几种类别。

表 A-1 WLST 命令类别
命令类别
描述
浏览命令
导航配置 Bean 或运行时 Bean 的层次,并控制提示显示。
控制命令
  •  连接到服务器,或断开与服务器的连接。
  •  创建并配置 WebLogic 域或域模板。
  •  退出 WLST。
部署命令
  •  将应用程序和独立模块部署和重新部署到 WebLogic Server 实例,以及从该实例取消部署。
  •  更新现有的部署计划。
  •  询问 WebLogic Deployment Manager 对象。
  •  启动和停止已部署的应用程序。
诊断命令
导出诊断数据。
编辑命令
询问和编辑配置 Bean。
信息命令
询问域、服务器和变量,并提供配置 Bean、运行时 Bean 以及与 WLST 相关的信息。
生命周期命令
管理服务器实例的生命周期。
节点管理器命令
通过使用节点管理器启动、关闭、重新启动和监视 WebLogic Server 实例。
树命令
在 MBean 层次之间进行导航。

 

 


浏览命令

使用表 A-2 中列出的 WLST 浏览命令,可以导航配置 Bean 或运行时 Bean 的层次,并控制提示显示。

表 A-2 WLST 配置的浏览命令
使用此命令...
操作...
用于 WLST...
cd
导航配置 Bean 或运行时 Bean 的层次。
联机版或脱机版
currentTree
返回层次中的当前位置。
联机版
prompt
在提示下切换路径信息的显示。
联机版或脱机版
pwd
显示层次中的当前位置。
联机版或脱机版

 

cd

命令类别:浏览命令 用于 WLST:联机版或脱机版

描述

导航配置 Bean 或运行时 Bean 的层次。此命令使用一种类似于在 Windows 或 UNIX 命令外壳中导航文件系统的模型。例如,要导航回父配置 Bean 或运行时 Bean,请输入 cd(‘..‘)。字符串..(点-点)是指当前目录的上一级目录。要在导航到深层 Bean 后返回根 Bean,请输入 cd(‘/‘)

可以导航到位于当前层次的 Bean,以及任何子级或实例。

cd 命令可返回配置或运行时 Bean 实例的存根控件(如果存根控件存在的话)。如果导航到一种类型,则此命令将从导航的对象返回配置 Bean 或运行时 Bean 实例的存根控件。在出现错误的情况下,此命令将返回WLSTException

注意:第一次将 WLST 连接到服务器实例时,cmo 变量将被初始化为所有域配置 Bean 的根。在导航到实例之前,此变量可反映父配置 Bean 类型。有关 cmo 变量的详细信息,请参阅更改当前管理对象。

语法

cd(mbeanName)

参数
定义
mbeanName
指向名称空间中 Bean 路径。

 

示例

以下示例可导航配置 Bean 的层次。第一个命令可导航到 Servers 配置 Bean 类型,第二个命令可导航到 myserver 配置 Bean 实例,最后一个命令回退两个层次导航到初始目录位置。

wls:/mydomain/serverConfig> cd(‘Servers‘) wls:/mydomain/serverConfig/Servers> cd(‘myserver‘) wls:/mydomain/serverConfig/Servers/myserver> cd(‘../..‘) wls:/mydomain/serverConfig>

currentTree

命令类别:浏览命令 用于 WLST:联机版

描述

返回层次中的当前位置。通过此命令,可以存储层次中的当前位置,以在浏览后轻松返回到此位置。在出现错误的情况下,此命令将返回 WLSTException

语法

currentTree()

示例

以下示例可将层次中的当前位置存储到 myTree 中,然后使用 myTree 从管理服务器实例上的运行时 MBean 层次导航返回到 Edit MBean 层次。

wls:/mydomain/edit> myTree=currentTree() wls:/mydomain/edit> serverRuntime() Location changed to serverRuntime tree.This is a read-only tree with ServerRuntimeMBean as the root. For more help, use help(‘serverRuntime‘)
wls:/mydomain/serverRuntime> myTree() wls:/mydomain/edit>

prompt

命令类别:浏览命令 用于 WLST:联机版或脱机版

描述

如果输入此命令时不带参数,则可以根据提示切换路径信息。若由于路径长度而使得提示过长,此命令非常有用。

也可以将 on 或 off 明确指定为命令的参数。如果指定 off,WLST 将隐藏 WLST 提示并默认为 Jython 提示。默认情况下,WLST 提示可显示配置或运行时导航路径信息。

禁用提示详细信息时,要确定层次中的当前位置,可以使用 pwd 命令,如 pwd 中所述。

在出现错误的情况下,此命令将返回 WLSTException

语法

prompt(myPrompt)

参数
定义
myPrompt
可选。隐藏或显示 WLST 提示。有效值包括 off 或 on
    •  off 参数可隐藏 WLST 提示。

如果运行 prompt(‘off‘),则使用 WLST 联机版时,提示将默认为 Jython 提示。可以使用 Jython 语法新建提示。有关使用 Jython 进行编程的详细信息,请参阅 http://www.jython.org。在这种情况下,如果随后输入 prompt 命令且不带参数,WLST 将显示不包含路径信息的 WLST 命令提示。要重新显示路径信息,请再次输入 prompt(),或输入 prompt(‘on‘)

  •  on 参数可显示包含路径信息的默认 WLST 提示。

 

示例

以下示例可根据提示隐藏路径信息,然后重新显示此信息。

wls:/mydomain/serverConfig/Servers/myserver> prompt() wls:/> prompt() wls:/mydomain/serverConfig/Servers/myserver> 

以下示例可隐藏提示并默认为 Jython 提示(由于此命令是使用 WLST 联机版运行的)、更改 Jython 提示,然后重新显示 WLST 提示。此示例还说明了 pwd 命令的使用。

注意:有关使用 Jython 进行编程的详细信息,请参阅 http://www.jython.org

wls:/mydomain/serverConfig/Servers/myserver> prompt(‘off‘) >>>sys.ps1="myprompt>" myprompt> prompt() wls:> pwd() `serverConfig:Servers/myserver‘ wls:> prompt() wls:/mydomain/serverConfig/Servers/myserver> 

pwd

命令类别:浏览命令 用于 WLST:联机版或脱机版

描述

显示配置 Bean 或运行时 Bean 层次中的当前位置。

在已使用 prompt 命令禁止在提示中显示路径信息时,此命令非常有用,如 prompt 中所述。

在出现错误的情况下,此命令将返回 WLSTException

语法

pwd()

示例

以下示例显示配置 Bean 层次中的当前位置。

wls:/mydomain/serverConfig/Servers/myserver/Log/myserver> pwd() ‘serverConfig:/Servers/myserver/Log/myserver‘

 


控制命令

使用表 A-3 中列出的 WLST 控制命令,可执行下列任务:

  •  连接到服务器,或断开与服务器的连接
  •  创建并配置 WebLogic 域或域模板(类似于 Configuration Wizard)
  •  退出 WLST

表 A-3 列出了 WLST 配置的控制命令。

表 A-3 WLST 配置的控制命令
若要...
使用此命令...
操作...
用于 WLST...
连接到 WebLogic Server 实例,以及断开与 WebLogic Server 实例的连接
connect
将 WLST 连接到 WebLogic Server 实例。
联机版或脱机版
disconnect
断开 WLST 与 WebLogic Server 实例的连接。
联机版
使用域模板新建域
createDomain
使用指定的模板新建域。
脱机版
readTemplate
打开现有域模板以创建域。
脱机版
writeDomain
将域配置信息写入指定的目录。
脱机版
closeTemplate
关闭当前域模板。
脱机版
更新现有域(脱机)
readDomain
打开现有域进行更新。
脱机版
addTemplate
使用应用程序或服务扩展模板扩展当前域。
脱机版
updateDomain
更新并保存当前域。
脱机版
closeDomain
关闭当前域。
脱机版
向域模板写入信息
writeTemplate
将配置信息写入指定的域模板文件。
脱机版
退出 WLST
exit
从交互式会话退出 WLST,并关闭脚本外壳。
联机版或脱机版

 

addTemplate

命令类别:控制命令 用于 WLST:脱机版

描述

使用应用程序或服务扩展模板扩展当前域。使用 Template Builder 创建应用程序或服务扩展模板。请参阅使用 Domain Template Builder 创建模板。

在出现错误的情况下,此命令将返回 WLSTException

语法

addTemplate(templateFileName)

参数
定义
templateFileName
应用程序扩展模板或服务扩展模板的名称。

 

示例

以下示例可打开某个域,然后使用指定的扩展模板 DefaultWebApp.jar 扩展此域。

wls:/offline> readDomain(‘c:/bea/user_projects/domains/wlw‘) wls:/offline/wlw> addTemplate(‘c:/bea/wlserver_10.0/common/templates/ applications/DefaultWebApp.jar‘) wls:/offline/wlw> 

closeDomain

命令类别:控制命令 用于 WLST:脱机版

描述

关闭当前域。域一旦关闭,就不能再对其进行编辑。在出现错误的情况下,此命令将返回 WLSTException

语法

closeDomain()

示例

以下示例可关闭当前域:

wls:/offline> readDomain(‘c:/bea/user_projects/domains/medrec‘) ... wls:/offline/medrec> updateDomain() wls:/offline/medrec> closeDomain() wls:/offline>

closeTemplate

命令类别:控制命令 用于 WLST:脱机版

描述

关闭当前域模板。域模板一旦关闭,就不再可用。在出现错误的情况下,此命令将返回 WLSTException

语法

closeTemplate()

示例

以下示例可打开现有的域模板,执行某些操作,然后关闭当前域模板。

wls:/offline> readTemplate(‘c:/bea/wlserver_10.0/common/templates/domains/ wls.jar‘) ... wls:/offline/wls> closeTemplate() wls:/offline>

connect

命令类别:控制命令 用于 WLST:联机版或脱机版

描述

将 WLST 连接到 WebLogic Server 实例。

需要您提供已在活动 WebLogic 安全领域中定义的用户的凭据(用户名和密码)。一旦连接到 WebLogic Server 实例,安全策略的集合将确定允许您查看或修改的配置特性。(请参阅“WebLogic Server MBean Reference”中的 Default Security Policies for MBeans。)

可以通过下列任何操作提供用户凭据:

  •  在命令行上输入凭据。只有以交互模式使用 WLST 时,才建议使用此选项。
  •  在命令行上输入凭据,然后使用 storeUserConfig 命令创建包含加密格式凭据的用户配置文件以及 WebLogic Server 用来对凭据解除加密的密钥文件。在后续 WLST 会话中(或 WLST 脚本中),提供用户配置文件和密钥文件的名称,而不是在命令行上输入凭据。如果以脚本模式使用 WLST,因为使用此选项可以防止将解除加密的用户凭据存储在脚本中,所以建议您使用此选项。
  •  使用在管理服务器的 boot.properties 文件中存储的凭据。默认情况下,当您创建管理服务器时,WebLogic Server 加密用户用来创建服务器的凭据并将它们存储在 boot.properties 文件中。

如果在未指定用户名和密码或者配置文件和密钥文件的情况下运行 connect 命令,WLST 将尝试使用以下列出的(按优先顺序排列)方法之一处理命令:

  1.  如果主目录中存在用户配置和默认密钥文件,则使用那些文件。主目录的位置取决于运行 WLST 的操作系统的类型。有关默认位置的信息,请参阅 storeUserConfig。
  2.  如果未指定 adminServerName 参数,则在 ./boot.properties 或 ./servers/myserver/security/boot.properties 中查找 boot.properties 文件。
  3.  如果指定了 adminServerName 参数,则在 ./servers/adminServerName/security/boot.properties 中查找 boot.properties 文件,其中 adminServerName 是 adminServerName 参数的值。

 
 

username
可选。正在将 WLST 连接到服务器的操作员的用户名。如果未指定,WLST 将按照上述方式处理命令。
password
可选。正在将 WLST 连接到服务器的操作员的密码。如果未指定,WLST 将按照上述方式处理命令。
url
可选。服务器实例的监听地址和监听端口,通过以下格式指定:[protocol://]listen-address:listen-port。如果未指定,则此参数默认为 t3://localhost:7001
timeout
可选。WLST 等待联机命令完成(返回)的毫秒数。
当调用 WLST 联机命令时,WLST 将连接到 MBean 服务器,调用 MBean 服务器方法,然后返回调用结果。如果 MBean 服务器方法未在超时时段之内返回,WLST 则放弃其调用尝试。为此参数使用如下的语法: timeout=‘milliseconds
值为 0 表示操作不会超时。此参数默认为 300,000 毫秒(或 5 分钟)。
userConfigFile
可选。包含加密用户名和密码的用户配置文件的名称和位置。为此参数使用如下的语法: userConfigFile=‘file-system-path
如果未指定,WLST 将按照上述方式处理命令。
当创建用户配置文件时,storeUserConfig 命令将使用密钥文件对用户名和密码进行加密。只有对用户配置文件进行加密的密钥文件才可以解密用户名和密码。(请参阅 storeUserConfig。)
userKeyFile
可选。密钥文件的名称和位置,此密钥文件与指定的用户配置文件相关联并用于对其进行解密。为此参数使用如下的语法: userKeyFile=‘file-system-path
如果未指定,WLST 将按照上述方式处理命令。
请参阅 storeUserConfig。
adminServerName
可选。域管理服务器的名称。导致 connect 命令使用在管理服务器的 boot.properties 文件中存储的凭据。为此参数使用如下的语法: adminServerName=‘server-name
只有从域目录中启动 WLST 后,此参数才有效。如果管理服务器的 boot.properties 文件位于域目录中,则不需要指定此参数。
如果未指定,WLST 将按照上述方式处理命令。

 

示例

以下示例可将 WLST 连接到 WebLogic Server 实例。在此示例中,管理服务器名称默认为 AdminServer。请注意,如果未使用 SSL 端口或管理端口连接到服务器,将显示警告。

wls:/offline> connect(‘weblogic‘,‘weblogic‘,‘t3://localhost:8001‘) Connecting to weblogic server instance running at t3://localhost:8001 as username weblogic...
Successfully connected to Admin Server ‘AdminServer‘ that belongs to domain ‘mydomain‘.
Warning: An insecure protocol was used to connect to the server.To ensure on-the-wire security, the SSL port or Admin port should be used instead.
wls:/mydomain/serverConfig>

以下示例可将 WLST 连接到位于指定 URL 的 WebLogic Server 实例。在此示例中,用户名和密码将作为变量传递。此示例使用安全协议。

wls:/offline> username = ‘weblogic‘ wls:/offline> password = ‘weblogic‘ wls:/offline> connect(username,password,‘t3s://myhost:8001‘) Connecting to weblogic server instance running at t3://myhost:8001 as username weblogic...
Successfully connected to Admin Server ‘AdminServer‘ that belongs to domain ‘mydomain‘. wls:/mydomain/serverConfig>

以下示例将使用用户配置文件和密钥文件将 WLST 连接到 WebLogic Server 实例,以提供用户凭据。

wls:/offline> connect(userConfigFile=‘c:/myfiles/myuserconfigfile.secure‘, userKeyFile=‘c:/myfiles/myuserkeyfile.secure‘)  Connecting to weblogic server instance running at t3://localhost:7001 as username ...
Successfully connected to Admin Server ‘AdminServer‘ that belongs to domain ‘mydomain‘. wls:/mydomain/serverConfig>

createDomain

命令类别:控制命令 用于 WLST:脱机版

描述

使用指定的模板创建域。

注意:如果希望在创建域时修改域配置设置,请参阅编辑域(脱机)中的选项 2。

注意:createDomain 命令在功能上与 unpack 命令类似,如使用 pack 和 unpack 命令创建模板和域中所述。

在出现错误的情况下,此命令将返回 WLSTException

语法

createDomain(domainTemplate, domainDir, user, password)

参数
定义
domainTemplate
要从中创建域的域模板的名称和位置。
domainDir
要向其中写入域配置信息的目录名称。
user
默认用户名。
password
默认用户密码。

 

示例

以下示例将通过使用 Avitek MedRec 模板新建域,并将默认用户名和密码设置为 weblogic。该域将被保存到以下目录:c:/bea/user_projects/domains/medrec

wls:/offline> createDomain(‘c:/bea/wlserver_10.0/common/templates/domains /wls_medrec.jar‘,‘c:/bea/user_projects/domains/medrec‘, ‘weblogic‘, ‘weblogic‘)

disconnect

命令类别:控制命令 用于 WLST:联机版

描述

断开 WLST 与 WebLogic Server 实例的连接。disconnect 命令不会导致 WLST 退出交互式脚本外壳;它会在保持交互式外壳活动的同时关闭当前 WebLogic Server 实例连接,并重置所有变量。

在出现错误的情况下,此命令将返回 WLSTException

可以使用 connect 命令连接到另一个 WebLogic Server 实例,如 connect 中所述。

语法

disconnect(force)

参数
定义
force
可选。一个布尔值,可指定 WLST 是否应不等待活动会话完成就断开连接。此参数默认为 false,表示在断开连接之前,必须完成所有活动会话。

 

示例

以下示例可断开与正在运行的服务器的连接:

wls:/mydomain/serverConfig> disconnect() Disconnected from weblogic server: myserver wls:/offline> 

exit

命令类别:控制命令 用于 WLST:联机版或脱机版

描述

从用户会话退出 WLST,并关闭脚本外壳。

如果有正在进行中的编辑会话,WLST 将提示您进行确认。要跳过提示,请将 defaultAnswer 参数设置为 y

默认情况下,退出 WLST 时,WLST 将为当前 WLST JVM 调用 System.exit(0)。如果要 JVM 使用其他退出代码退出,可通过使用 exitCode 参数指定值。

注意:如果在 Ant 脚本内发出 WLST 退出命令,可能还会退出 Ant 脚本的执行。建议在 Ant 脚本内调用 WLST 时,通过指定 fork="true" 分出新的 JVM。

在出现错误的情况下,此命令将返回 WLSTException

语法

exit([defaultAnswer], [exitcode])

参数
定义
defaultAnswer
可选。这是不希望从命令行中获得提示时的默认响应。有效值为 y 和 n。此参数默认为 null,WLST 将会提示您作出响应。
exitcode
可选。退出 WLST 时要设置的退出代码。

 

示例

以下示例将断开与用户会话的连接,并关闭脚本外壳。

wls:/mydomain/serverConfig> exit() Exiting WebLogic Scripting Tool ... c:\>

以下示例可断开与用户会话的连接、关闭脚本外壳,并将错误代码设置为 101。

wls:/mydomain/serverConfig> exit(exitcode=101) Exiting WebLogic Scripting Tool ... c:\>

readDomain

命令类别:控制命令 用于 WLST:脱机版

描述

打开现有域进行更新。

使用 WLST 脱机版,可对在域 config 目录或域模板 JAR(由 Template Builder 创建)中持久存储的配置数据进行读取和写入访问。此数据是 XML 文档的集合,表示管理对象的层次。

打开模板或域时,系统将 WLST 放置到该域配置层次的根位置,并更新提示以反映配置层次中的当前位置。例如:

wls:/offline/base_domain>

有关详细信息,请参阅导航和询问 MBean。

在出现错误的情况下,此命令将返回 WLSTException

语法

readDomain(domainDirName)

参数
定义
domainDirName
要打开的域目录的名称。

 

示例

以下示例可打开 medrec 域进行编辑。

wls:/offline> readDomain(‘c:/bea/user_projects/domains/medrec‘) wls:/offline/medrec>

readTemplate

命令类别:控制命令 用于 WLST:脱机版

描述

打开现有域模板以创建域。

如果打开某个域模板,会将 WLST 放入此域模板的配置 Bean 层次中,并且更新提示以反映配置层次中的当前位置。例如:

wls:/offline/base_domain>

WebLogic Server 配置 Bean 存在于层次结构之中。在 WLST 文件系统中,层次相当于驱动程序;类型和示例相当于目录;特性和操作相当于文件。WLST 使用命令(如 cdls 和 pwd)遍历配置 Bean 的层次结构,其方式类似于在 UNIX 或 Windows 命令外壳中导航文件系统。导航到配置 Bean 实例之后,您可使用 WLST 命令与 Bean 交互。有关详细信息,请参阅导航和询问 MBean。

注意:通过使用 WLST 和域模板,在新建域时仅能够创建和访问安全信息。更新域时,不能通过 WLST 访问安全信息。

在出现错误的情况下,此命令将返回 WLSTException

语法

readTemplate(templateFileName)

参数
定义
templateFileName
与域模板相对应的 JAR 文件的名称。

 

示例

以下示例可打开 medrec.jar 域模板以创建域。

wls:/offline> readTemplate(‘c:/bea/wlserver_10.0/common/templates/domains /wls_medrec.jar‘) wls:/offline/wls_medrec>

updateDomain

命令类别:控制命令 用于 WLST:脱机版

描述

更新并保存当前域。更新并保存某个域后,可继续对此域进行编辑。

在出现错误的情况下,此命令将返回 WLSTException

语法

updateDomain()

示例

以下示例可打开 medrec 域、执行某些操作,并更新和保存当前域:

wls:/offline> readDomain(‘c:/bea/user_projects/domains/medrec‘) ... wls:/offline/medrec> updateDomain()

writeDomain

命令类别:控制命令 用于 WLST:脱机版

描述

将域配置信息写入指定的目录中。

将域写入文件系统后,可以继续更新内存中的域模板对象,并重新发出 writeDomain 命令,以将域配置存储到新的或现有文件中。

默认情况下,写入域时会将相关联的应用程序写入 BEAHOME/user_projects/applications/domainname,其中 BEAHOME 用于指定 BEA 主目录,domainname 用于指定域的名称。此目录必须为空,否则 WLST 将显示错误。

完成对内存中的域模板对象的使用后,请使用 closeTemplate 命令将其关闭。如果要对已保存到磁盘中的某个域进行编辑,可通过使用 readDomain 命令打开此域。

注意:域的名称是从域目录的名称中派生出来的。例如,对于保存到 c:/bea/user_projects/domains/myMedrec 的域,域名为 myMedrec

在写入域之前,必须定义默认用户的密码(如果尚未定义的话)。例如:

cd(‘/Security/base_domain/User/weblogic‘) cmo.setPassword(‘weblogic‘)

在出现错误的情况下,此命令将返回 WLSTException

语法

writeDomain(domainDir)

参数
定义
domainDir
要向其中写入域配置信息的目录名称。

 

示例

以下示例可读取 medrec.jar 域模板,执行某些操作,并将域配置信息写入 c:/bea/user_projects/domains/medrec 目录。

wls:/offline> readTemplate(‘c:/bea/wlserver_10.0/common/templates/domains /wls.jar‘) ... wls:/offline/base_domain> writeDomain(‘c:/bea/user_projects/domains/base_domain‘)

writeTemplate

命令类别:控制命令 用于 WLST:脱机版

描述

将域配置信息写入指定的域模板。可以使用域配置模板重新创建域。

将配置信息写入域配置模板后,可以继续更新内存中的域或域模板对象,并重新发出 writeDomain 或 writeTemplate 命令,以将域配置存储到新的或现有的域或域模板文件中。有关详细信息,请分别参阅 writeDomain 或writeTemplate。

在出现错误的情况下,此命令将返回 WLSTException

注意:writeTemplate 命令在功能上与 pack 命令类似,如使用 pack 和 unpack 命令创建模板和域中所述。但是,writeTemplate 不支持创建受管服务器模板。

语法

writeTemplate(templateName)

参数
定义
templateName
存储域配置信息的域模板的名称。

 

示例

以下示例可将当前域配置写入名为 c:/bea/user_projects/templates/myTemplate.jar 的域模板。

wls:/offline> readDomain(‘c:/bea/user_projects/domains/mydomain‘) ... wls:/offline/base_domain> writeTemplate(‘c:/bea/user_projects/templates/myTemplate.jar‘)

 


部署命令

使用表 A-4 中列出的 WLST 部署命令,可以执行下列操作:

  •  将应用程序和独立模块部署和重新部署到 WebLogic Server 实例,以及从该实例取消部署。
  •  更新现有的部署计划。
  •  询问 WebLogic Deployment Manager 对象。
  •  启动和停止已部署的应用程序。

有关部署应用程序的详细信息,请参阅将应用程序部署到 WebLogic Server。

表 A-4 WLST 配置的部署命令
命令...
可以...
用于 WLST...
deploy
将应用程序部署到 WebLogic Server 实例。
联机版
distributeApplication
将部署捆绑复制到指定目标。
联机版
getWLDM
返回 WebLogic DeploymentManager 对象。
联机版
loadApplication
将应用程序和部署计划加载到内存中。
联机版
redeploy
重新部署先前已部署的应用程序
联机版
startApplication
启动应用程序,以供用户使用。
联机版
stopApplication
停止应用程序,使其对用户不可用。
联机版
undeploy
从指定服务器取消应用程序部署。
联机版
updateApplication
通过使用新的部署计划更新应用程序配置。
联机版

 

deploy

命令类别:部署命令 用于 WLST:联机版

描述

将应用程序部署到 WebLogic Server 实例。

deploy 命令可返回 WLSTProgress 对象,可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。在出现错误的情况下,此命令将返回 WLSTException

注意:如果有正在进行中的编辑会话,deploy 命令将不会阻塞用户交互。

语法

deploy(appName, path, [targets], [stageMode], [planPath], [options])

参数
定义
appName
要部署的应用程序或独立 Java EE 模块的名称。
path
要部署的应用程序目录、归档文件或展开的归档目录根的名称。
targets
可选。以逗号分隔的目标列表。通过可以由 Java EE 模块名限定的每个目标(例如 module1@server1),可以将应用程序归档的不同模块部署到不同的服务器上。此参数默认为 WLST 当前所连接的服务器。
stageMode
可选。正在部署的应用程序的临时模式。有效值为 stagenostage 和 external_stage。有关临时模式的信息,请参阅“将应用程序部署到 WebLogic Server”中的使用临时模式控制部署文件复制。此参数默认为 null。
planPath
可选。部署计划文件的名称。文件名可以是绝对文件名或相对于应用程序目录的文件名。此参数默认为应用程序目录下的 plan/plan.xml 文件(如果此文件存在的话)。
options
可选。以逗号分隔的部署选项的列表,这些选项被指定为名称-值对。有效选项包括:
  •  altDD - 管理服务器上备用应用程序部署描述符的位置。
  •  altWlsDD - 管理服务器上备用 WebLogic 应用程序部署描述符的位置。
  •  archiveVersion - 归档版本号。
  •  block - 一个布尔值,可指定在命令完成之前,WLST 是否应阻塞用户交互。此选项默认为 true。如果设置为 false,WLST 将在发出命令后将控制权返回给用户;可以对 WLSTProgress 对象进行查询,以确定命令的状态。如果要将 WLST 导入为 Jython 模块(如将 WLST 导入为 Jython 模块中所述),block 将始终设置为 true
  •  clusterDeploymentTimeout - 准许的针对此应用程序的群集部署任务的时间(毫秒)。
  •  createPlan - 一个布尔值,可表示用户是否要创建默认计划。此选项默认为 false
options(继续)
  •  defaultSubmoduleTargets - 布尔值,表示应该由系统派生限定 JMS 子模块的目标,请参阅“将应用程序部署到 WebLogic Server”中的将子模块定位用于 JMS 应用程序模块。默认值为 true。
  •  forceUndeployTimeout - 强制取消部署超时值。
  •  gracefulIgnoreSessions - 一个布尔值,可指定正常生成管理模式操作是否应忽略待定 HTTP 会话。此选项默认为 false,仅当 gracefulProductionToAdmin 设置为 true 时,此选项才适用。
  •  gracefulProductionToAdmin - 一个布尔值,可指定生成管理模式操作是否应是正常的。此选项默认为 false
  •  libImplVersion - 库的实现版本(如果清单中没有的话)。
  •  libraryModule - 一个布尔值,可指定某个模块是否为库模块。此选项默认为 false
  •  libSpecVersion - 库的规范版本(如果清单中没有的话)。
  •  planVersion - 计划版本号。
  •  remote - 指定操作是否将在包含源的文件系统的远程进行的布尔值。如果您所在的计算机不是管理服务器,但部署描述符文件已装在管理服务器所在的指定位置,则使用此选项。此选项默认为 false
  •  retireGracefully - 仅在某个应用程序完成所有正在进行的工作后才使此应用程序正常过期的过期策略。此策略仅对于停止操作和重新部署操作有意义,并且与过期超时策略相互排斥。
  •  retireTimeout - 在使已替换为较新版本的应用程序过期之前,WLST 等待的时间(秒)。此选项默认为 -1,可指定正常超时。
  •  securityModel - 安全模型。有效值包括:DDOnlyCustomRolesCustomRolesAndPolicies 和 Advanced
  •  securityValidationEnabled - 一个布尔值,可指定是否已启用安全验证。
  •  subModuleTargets - JMS 模块的子模块级别目标。例如 submod@mod-jms.xml@target | submoduleName@target
options(继续)
  •  testMode - 一个布尔值,可指定是否启动访问受限制的 Web 应用程序。此选项默认为 false
  •  timeout - 取消部署过程操作之前,WLST 等待此操作完成的时间(毫秒)。值为 0 表示操作不会超时。此参数默认为 300,000 毫秒(或 5 分钟)。
  •  upload - 一个布尔值,可指定是否要在部署某些应用程序文件前,先将这些文件上传到 WebLogic Server 管理服务器的上传目录。当管理服务器无法通过文件系统访问应用程序文件时使用此选项。此选项默认为 false。
  •  versionIdentifier - 版本标识符。

 

示例

以下示例可对位于 c:/myapps/business 的 businessApp 应用程序进行部署,将创建默认的部署计划。

deploy 命令可返回 WLSTProgress 对象,可以访问此对象以检查命令的状态。WLSTProgress 对象在用户定义的变量(在本案例中为 progress)中被捕获。

wls:/mydomain/serverConfig/Servers> progress= deploy(appName=‘businessApp‘,path=‘c:/myapps/business‘,createplan=‘true‘)

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量(在本案例中为 progress)中。然后可以使用 progress 变量打印 deploy 命令的状态。例如:

wls:/mydomain/serverConfig/Servers> progress.printStatus() Current Status of your Deployment: Deployment command type: deploy Deployment State       : completed Deployment Message     : null wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。

以下示例通过将应用程序模块定位到 myserver,并使用位于 c:/myapps/demos/app/plan/plan.xml 的部署计划文件,对归档文件(位于 c:/myapps/demos/app/demoApp.ear)中的 demoApp 应用程序进行部署。WLST 用 120,000 毫秒的时间等待该进程完成。

wls:/mydomain/serverConfig/Servers> deploy(‘demoApp‘, ‘c:/myapps/demos/app/demoApp.ear‘, targets=‘myserver‘, planPath=‘c:/myapps/demos/app/plan/plan.xml‘, timeout=120000)

以下示例通过将应用程序模块定位到指定的目标,对位于 c:/myapps/demos/jmsApp/demo-jms.xml 的 jmsApp 应用程序进行部署。

wls:/mydomain/serverConfig/Servers>deploy(‘jmsApp‘,path=‘c:/myapps/demos/jmsApps/demo-jms.xml‘, subModuleTargets=‘jmsApp@managed1‘)

以下示例显示了如何将应用程序版本 (appVersion) 设置为唯一的标识符,以支持生产环境重新部署(并行)。此示例可对归档文件(位于 c:/myapps/demos/app/demoApp.ear)中的 demoApp 应用程序进行部署,并将应用程序和归档版本号设置为指定的值。

wls:/mydomain/serverConfig> deploy(‘demoApp‘, ‘c:/myapps/demos/app/demoApp.ear‘, archiveVersion=‘901-101‘, appVersion=‘901-102‘)

有关生产环境重新部署策略的详细信息,请参阅“将应用程序部署到 WebLogic Server”中的在生产环境中更新应用程序。

distributeApplication

命令类别:部署命令 用于 WLST:联机版

描述

将部署捆绑复制到指定目标。部署捆绑包括模块、配置数据和任何其他生成的代码。distributeApplication 命令不会启动部署。

distributeApplication 命令可返回 WLSTProgress 对象,可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。在出现错误的情况下,此命令将返回WLSTException

语法

distributeApplication(appPath, [planPath], [targets], [options])

参数
定义
appPath
要部署的归档文件或展开的归档目录根的名称。
planPath
可选。部署计划文件的名称。文件名可以是绝对文件名或相对于应用程序目录的文件名。此参数默认为应用程序目录下的 plan/plan.xml 文件(如果此文件存在的话)。
targets
可选。以逗号分隔的目标列表。通过可以由 Java EE 模块名限定的每个目标(例如 module1@server1),可以将应用程序归档的不同模块部署到不同的服务器上。此参数默认为 WLST 当前所连接的服务器。
options
可选。以逗号分隔的部署选项的列表,这些选项被指定为名称-值对。有关有效部署选项的列表,请参阅 deploy 中的 options 参数描述。

 

示例

以下示例可加载位于 c:/myapps 目录下的 BigApp 应用程序,并将 WLSTProgress 对象存储到用户定义的变量(在本案例中为 progress)中。

以下示例通过使用在 c:/deployment/BigApp/plan.xml 中定义的部署计划将 c:/myapps/BigApp 应用程序分发到 myserveroamserver1 和 oamcluster 服务器中。

wls:/offline> progress=distributeApplication(‘c:/myapps/BigApp‘, ‘c:/deployment/BigApp/plan.xml‘, ‘myserver,oamserver1,oamcluster‘) Distributing Application and Plan ... Successfully distributed the application.

上一个示例可将 WLSTProgress 对象存储在用户定义的变量(在本案例中为 progress)中。然后可以使用 progress 变量来确定 distributeApplication 命令是否已完成。例如:

wls:/mydomain/serverConfig/Servers> progress.isCompleted() 1 wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。

getWLDM

命令类别:部署命令 用于 WLST:联机版

描述

返回 WebLogic DeploymentManager 对象。可以使用对象方法配置和部署应用程序。WLST 必须连接到管理服务器才能运行此命令。在出现错误的情况下,此命令将返回 WLSTException

语法

getWLDM()

示例

以下示例可获取 WebLogicDeploymentManager 对象,并将此对象存储到 wldm 变量中。

wls:/mydomain/serverConfig> wldm=getWLDM() wls:/mydomain/serverConfig> wldm.isConnected() 1 wls:/mydomain/serverConfig>

loadApplication

命令类别:部署命令 用于 WLST:联机版

描述

将应用程序和部署计划加载到内存中。

loadApplication 命令可返回 WLSTPlan 对象,可以访问此对象以对部署计划进行更改。有关 WLSTPlan 对象的详细信息,请参阅 WLSTPlan 对象。在出现错误的情况下,此命令将返回 WLSTException

语法

loadApplication(appPath, [planPath], [createPlan])

参数
定义
appPath
包含要加载的应用程序的顶级父应用程序目录、归档文件或展开的归档目录根的名称。
planPath
可选。部署计划文件的名称。文件名可以是绝对文件名或相对于应用程序目录的文件名。此参数默认为应用程序目录下的 plan/plan.xml 文件(如果此文件存在的话)。
createPlan
可选。一个布尔值,可指定如果指定的计划不存在,WLST 是否应在应用程序目录中创建计划。此参数默认为 true

 

示例

以下示例通过使用位于 c:/myplans/myejb/plan.xml 的计划文件加载 c:/myapps/myejb.jar 应用程序。

wls:/myserver/serverConfig> myPlan=loadApplication(‘c:/myapps/myejb.jar‘, ‘c:/myplans/myejb/plan.xml‘) Loading application from c:/myapps/myejb.jar and deployment plan from c:/myplans/myejb/plan.xml ... Successfully loaded the application. wls:/myserver/serverConfig>

上一个示例可将返回的 WLSTPlan 对象存储在 myPlan 变量中。然后可以使用 myPlan 变量显示计划相关的信息(例如变量)。例如:

wls:/myserver/serverConfig> myPlan.showVariables() MyEJB jndi.ejb MyWAR app.foo wls:/myserver/serverConfig>

有关 WLSTPlan 对象的详细信息,请参阅 WLSTPlan 对象。

redeploy

命令类别:部署命令 用于 WLST:联机版

描述

重新加载类并重新部署先前已部署的应用程序。

redeploy 命令可返回 WLSTProgress 对象,可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。

在出现错误的情况下,此命令将返回 WLSTException

有关重新部署应用程序的详细信息,请参阅“将应用程序部署到 WebLogic Server”中的常见部署场景概述。

语法

redeploy(appName, [planPath], [options])

参数
定义
appName
要重新部署的应用程序的名称。
planPath
可选。部署计划文件的名称。文件名可以是绝对文件名或相对于应用程序目录的文件名。此参数默认为应用程序目录下的 plan/plan.xml 文件(如果此文件存在的话)。
options
可选。以逗号分隔的部署选项的列表,这些选项被指定为名称-值对。有关有效部署选项的列表,请参阅 deploy 中的 options 参数描述。
此外,可为 redeploy 命令指定以下部署选项:
  •  appPath - 要重新部署的归档文件或展开的归档目录根的名称。

 

示例

以下示例通过使用位于 c:/myapps 目录下的 plan.xml 文件对 myApp 应用程序进行重新部署。

wls:/mydomain/serverConfig> progress=redeploy(‘myApp‘ ‘c:/myapps/plan.xml‘) Redeploying application ‘myApp‘ ... Redeployment of ‘myApp‘ is successful wls:/mydomain/serverConfig>

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量(在本案例中为 progress)中。然后可以使用 progress 变量访问 redeploy 命令的状态。例如:

wls:/mydomain/serverConfig/Servers> progress.getState() `completed‘ wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。

startApplication

命令类别:部署命令 用于 WLST:联机版

描述

启动应用程序,以供用户使用。应用程序必须完整配置且在域中可用。

startApplication 命令可返回 WLSTProgress 对象,可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。在出现错误的情况下,此命令将返回 WLSTException

语法

startApplication(appName, [options])

参数
定义
appName
 plan.xml 文件中指定的要启动的应用程序名称。
options
可选。以逗号分隔的部署选项的列表,这些选项被指定为名称-值对。有关有效部署选项的列表,请参阅 deploy 中的 options 参数描述。

 

示例

以下示例使用指定的部署选项启动 BigApp 应用程序。

wls:/offline> progress=startApplication(‘BigApp‘, stageMode=‘NOSTAGE‘, testMode=‘false‘) Starting the application... Successfully started the application.

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量(在本案例中为 progress)中。然后可以使用 progress 变量访问 startApplication 命令的状态。例如:

wls:/mydomain/serverConfig/Servers> progress.getState() `completed‘ wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。

stopApplication

命令类别:部署命令 用于 WLST:联机版

描述

停止应用程序,使其对用户不可用。应用程序必须完整配置且在域中可用。

stopApplication 命令可返回 WLSTProgress 对象,可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。

在出现错误的情况下,此命令将返回 WLSTException

语法

stopApplication(appName, [options])

参数
定义
appName
 plan.xml 文件中指定的要停止的应用程序名称。
options
可选。以逗号分隔的部署选项的列表,这些选项被指定为名称-值对。有关有效部署选项的列表,请参阅 deploy 中的 options 参数描述。

 

示例

以下示例可停止 BigApp 应用程序。

wls:/offline> progress=stopApplication(‘BigApp‘) Stopping the application... Successfully stopped the application.

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量(在本案例中为 progress)中。然后可以使用 progress 变量检查 stopApplication 命令是否正在运行。例如:

wls:/mydomain/serverConfig/Servers> progress.isRunning() 0 wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。

undeploy

命令类别:部署命令 用于 WLST:联机版

描述

从指定的服务器中取消某个应用程序的部署。

undeploy 命令可返回 WLSTProgress 对象,可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。在出现错误的情况下,此命令将返回 WLSTException

有关部署和取消部署应用程序的详细信息,请参阅“将应用程序部署到 WebLogic Server”中的常见部署场景概述。

语法

undeploy(appName,[targets],[options])

参数
定义
appName
已部署的应用程序的部署名。
targets
可选。将从中删除应用程序的目标服务器的列表。如果未指定,则默认为所有当前目标。
options
可选。以逗号分隔的部署选项的列表,这些选项被指定为名称-值对。有关有效部署选项的列表,请参阅 deploy 中的 options 参数描述。

 

示例

以下示例可将 businessApp 应用程序从所有目标服务器中删除。在此过程完成之前,WLST 将等待 60,000 毫秒。

wls:/mydomain/serverConfig> undeploy(‘businessApp‘, timeout=60000) Undeploying application businessApp ... <Jul 20, 2005 9:34:15 AM EDT> <Info> <J2EE Deployment SPI> <BEA-260121> <Initiating undeploy operation for application, businessApp [archive: null],  to AdminServer .>

Completed the undeployment of Application with status Current Status of your Deployment: Deployment command type: undeploy Deployment State       : completed Deployment Message     : no message wls:/mydomain/serverConfig>

updateApplication

命令类别:部署命令 用于 WLST:联机版

描述

通过使用新的部署计划更新应用程序配置。应用程序必须完整配置且在域中可用。

updateApplication 命令可返回 WLSTProgress 对象,可以访问此对象以检查命令的状态。有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。在出现错误的情况下,此命令将返回 WLSTException

语法

updateApplication(appName, [planPath], [options])

参数
定义
appName
在当前 plan.xml 文件中指定的应用程序的名称。
planPath
可选。新部署计划文件的名称。文件名可以是绝对文件名或相对于应用程序目录的文件名。
options
可选。以逗号分隔的部署选项的列表,这些选项被指定为名称-值对。有关有效部署选项的列表,请参阅 deploy 中的 options 参数描述。

 

示例

以下示例通过使用位于 c:/myapps/BigApp/newPlan 的 plan.xml 文件更新 BigApp 的应用程序配置。

wls:/offline> progress=updateApplication(‘BigApp‘, ‘c:/myapps/BigApp/newPlan/plan.xml‘, stageMode=‘STAGE‘, testMode=‘false‘) Updating the application... Successfully updated the application.

上一个示例可将返回的 WLSTProgress 对象存储在用户定义的变量(在本案例中为 progress)中。然后可以使用 progress 变量访问 updateApplication 命令的状态。例如:

wls:/mydomain/serverConfig/Servers> progress.getState() `completed‘ wls:/mydomain/serverConfig/Servers>

有关 WLSTProgress 对象的详细信息,请参阅 WLSTProgress 对象。

 


诊断命令

使用表 A-5 列出的 WLST 诊断命令,通过针对 WebLogic 诊断框架(WebLogic Diagnostics Framework,简称 WLDF)数据存储执行查询,来检索诊断数据。有关 WLDF 的详细信息,请参阅配置和使用 WebLogic 诊断框架。

表 A-5 WLST 配置的诊断命令
命令...
可以...
用于 WLST...
exportDiagnosticData
根据指定的日志文件执行查询。
脱机版
exportDiagnosticDataFromServer
在服务器端执行查询,并检索导出的 WebLogic 诊断框架 (WLDF) 数据。
联机版

 

exportDiagnosticData

命令类别:诊断命令 用于 WLST:脱机版

描述

根据指定的日志文件执行查询。结果将保存在 XML 文件中。

有关 WebLogic Server 诊断服务的详细信息,请参阅配置和使用 WebLogic 诊断框架。

在出现错误的情况下,此命令将返回 WLSTException

语法

exportDiagnosticData([options])

参数
定义
options
可选。以逗号分隔的诊断数据导出选项的列表,这些选项被指定为名称-值对。有效选项包括:
  •  beginTimestamp - 要添加到结果集中的最早记录的时间戳(含最早记录)。此选项默认为 0。
  •  endTimestamp - 要添加到结果集中的最新记录的时间戳(不含最新记录)。此选项默认为 Long.MAX_VALUE
  •  exportFileName - 要将数据导出到的文件的名称。此选项默认为 export.xml
  •  logicalName - 正在读取的日志文件的逻辑名称。有效值包括:HarvestedDataArchiveEventsDataArchiveServerLogDomainLogHTTPAccessLogWebAppLogConnectorLog 和JMSMessageLog。此选项默认为 ServerLog
  •  logName - 包含要导出的日志数据的基本日志文件名。此选项默认为 myserver.log
  •  logRotationDir - 包含滚动日志文件的目录。此选项默认值为“.”(与存储日志文件的目录相同)。
  •  query - 一个表达式,可指定要包含在结果集中的数据记录的筛选条件。此选项默认为 ""(空字符串),可返回所有数据。有关详细信息,请参阅“配置和使用 Weblogic 诊断框架”中的 WLDF 查询语言。
  •  storeDir - 服务器的诊断信息存储的位置。此选项默认为 ../data/store/diagnostics

 

示例

以下示例可针对名为 myserver.log 的 ServerLog 执行查询,并将结果存储在名为 myExport.xml 的文件中。

wls:/offline/mydomain>exportDiagnosticData(logicalName=‘ServerLog‘, logName=‘myserver.log‘, exportFileName=‘myExport.xml‘) {‘elfFields‘: ‘‘, ‘logName‘: ‘myserver.log‘, ‘logRotationDir‘: ‘.‘, ‘endTimestamp‘: 9223372036854775807L, ‘exportFileName‘: ‘export.xml‘, ‘storeDir‘: ‘../data/store/diagnostics‘, ‘logicalName‘: ‘ServerLog‘, ‘query‘: ‘‘, ‘beginTimestamp‘: 0}
Exporting diagnostic data to export.xml

<Aug 2, 2005 6:58:21 PM EDT> <Info> <Store> <BEA-280050> <Persistent store  "WLS_DIAGNOSTICS" opened: directory="c:\bea\wlserver_10.0\server\data\store\diagnostics"  writePolicy="Disabled" blockSize=512 directIO=false driver="wlfileio2">
wls:/mydomain/serverRuntime>

exportDiagnosticDataFromServer

命令类别:诊断命令 用于 WLST:联机版

描述

在服务器端执行查询,并检索导出的 WebLogic 诊断框架 (WLDF) 数据。结果将保存在 XML 文件中。

有关 WebLogic Server 诊断服务的详细信息,请参阅配置和使用 WebLogic 诊断框架。

在出现错误的情况下,此命令将返回 WLSTException

语法

exportDiagnosticDataFromServer([options])

参数
定义
options
可选。以逗号分隔的诊断数据导出选项的列表,这些选项被指定为名称-值对。有效选项包括:
  •  beginTimestamp - 要添加到结果集中的最早记录的时间戳(含最早记录)。此选项默认为 0。
  •  endTimestamp - 要添加到结果集中的最新记录的时间戳(不含最新记录)。此选项默认为 Long.MAX_VALUE
  •  exportFileName - 要将数据导出到的文件的名称。此选项默认为 export.xml
  •  logicalName - 正在读取的日志文件的逻辑名称。有效值包括:HarvestedDataArchiveEventsDataArchiveServerLogDomainLogHTTPAccessLogWebAppLogConnectorLog 和JMSMessageLog。此选项默认为 ServerLog
  •  query - 一个表达式,可指定要包含在结果集中的数据记录的筛选条件。此选项默认为 ""(空字符串),可返回所有数据。

 

示例

以下示例可针对 HTTPAccessLog 执行查询,并将结果存储在名为 myExport.xml 的文件中。

wls:/mydomain/serverRuntime> exportDiagnosticDataFromServer(logicalName="HTTPAccessLog", exportFileName="myExport.xml")

 


编辑命令

使用表 A-6 中列出的 WLST 编辑命令,可以询问和编辑配置 Bean。

注意:要编辑配置 Bean,必须连接到管理服务器,并且必须导航到编辑树并启动编辑会话,分别如 edit 和 startEdit 中所述。

注意:如果连接到受管服务器,则 WLST 的功能只限于浏览配置 Bean 层次。无法使用 WLST 更改受管服务器上的 MBean 的值时,可以使用管理 API 进行更改。BEA Systems 建议仅更改管理服务器上的配置 MBean 的值。更改受管服务器上 MBean 的值会导致域的配置不一致。

注意:有关编辑配置 Bean 的详细信息,请参阅使用 WLST 联机版更新现有域。

表 A-6 WLST 配置的编辑命令
命令...
可以...
用于 WLST...
activate
激活在当前编辑会话期间保存但尚未部署的更改。
联机版或脱机版
assign
将资源分配到一个或多个目标。
脱机版
assignAll
将所有应用程序或服务分配到一个或多个目标。
脱机版
cancelEdit
取消编辑会话,解除编辑锁定,并放弃所有未保存的更改。任何具有管理员权限的用户都可以调用此操作,即使该用户没有启动该编辑会话。
联机版
create
为当前 Bean 创建指定类型的配置 Bean。
联机版或脱机版
delete
删除当前配置 Bean 的配置实例。
联机版或脱机版
encrypt
对指定的字符串进行加密。
联机版
get
返回指定特性的值。
联机版或脱机版
getActivationTask
返回用户可以从中获取状态的最新 ActivationTask MBean。
联机版
invoke
对当前配置 Bean 调用管理操作。
联机版
isRestartRequired
确定是否需要重新启动服务器。
联机版
loadDB
将 SQL 文件加载到数据库中。
脱机版
loadProperties
从文件中加载属性值。
联机版或脱机版
save
保存已完成但尚未保存的编辑。
联机版
set
为当前配置 Bean 设置指定的特性值。
联机版或脱机版
setOption
设置与创建域或更新域相关的选项。
脱机版
showChanges
显示在当前编辑会话期间由当前用户对配置所进行的更改。
联机版
startEdit
代表当前已连接的用户启动配置编辑会话。
联机版
stopEdit
停止当前编辑会话,解除编辑锁定,并放弃未保存的更改。
联机版
unassign
从一个或多个目标中取消应用程序或资源的分配。
脱机版
unassignAll
从一个或多个目标中取消应用程序或资源的分配。
脱机版
undo
恢复所有未保存或未激活的编辑。
联机版
validate
对已完成但尚未保存的更改进行验证。
联机版

 

activate

命令类别:编辑命令 用于 WLST:联机版

描述

激活在当前编辑会话期间已保存但尚未部署的更改。如果需要重新启动服务器才能激活更改,此命令将打印一条消息。

activate 命令将返回最新的 ActivationTask MBean,此 MBean 可反映用户当前所进行的或最近已进行的更改的状态。然后可以调用方法以获取有关正在进行的或刚完成的最新配置管理器激活任务的信息。在出现错误的情况下,此命令将返回 WLSTException

语法

activate([timeout], [block])

参数
定义
timeout
可选。在取消激活配置更改操作之前,WLST 等待此操作完成的时间(毫秒)。值为 -1 表示操作不会超时。此参数默认为 300,000 毫秒(或 5 分钟)。
block
可选。一个布尔值,可指定在命令完成之前,WLST 是否应阻塞用户交互。此参数默认为 false,表示不会阻止用户交互。这种情况下,WLST 将在发出命令后将控制权返回给用户,并将与当前任务相关联的任务 MBean 赋给某个变量,可使用此变量检查此 MBean 的状态。如果要将 WLST 导入为 Jython 模块(如将 WLST 导入为 Jython 模块中所述),block 将始终设置为 true

 

示例

以下示例可激活在当前编辑会话期间所进行的、已保存到磁盘但尚未激活的更改。WLST 在激活完成之前,将等待 100,000 毫秒,在停止激活之前,将等待 200,000 毫秒。

wls:/mydomain/edit !> activate(200000, block=‘true‘) Activating all your changes, this may take a while ...  The edit lock associated with this edit session is released once the activation is completed. Action completed. wls:/mydomain/edit>

assign

命令类别:编辑命令 用于 WLST:脱机版

描述

将资源分配到一个或多个目标。

在出现错误的情况下,此命令将返回 WLSTException

语法

assign(sourceType, sourceName, destinationType, destinationName)

参数
定义
sourceType
要分配的配置 Bean 的类型。可将此值设置为下列值之一:
  •  AppDeployment
  •  Library
  •  securityType(例如 User
  •  Server
  •  service(例如 JDBCSystemResource
  •  service.SubDeployment,其中 service 用于指定 SubDeployment(例如 JMSSystemResource.SubDeployment)的服务类型;还可以指定嵌套的子部署(例如AppDeployment.SubDeployment.SubDeployment
下文提供了设置此值的准则。
sourceName
要分配的资源名称。可以指定多个名称,用逗号隔开,或者可以使用通配符 (*) 指定给定类型的所有资源。
可使用以下格式指定子部署:service.subDeployment,其中 service 用于指定父服务,subDeployment 用于指定子部署的名称。例如 myJMSResource.myQueueSubDeployment。还可以指定嵌套的子部署,例如 MedRecEAR.MedRecAppScopedJMS.MedRecJMSServer
destinationType
目标类型。下文提供了设置此值的准则。
destinationName
目标名称。可以指定多个名称,用逗号隔开。

 

可使用下列准则设置 sourceType 和 destinationType

    •  分配应用程序部署时,请按如下所示设置值:
  •  sourceTypeAppDeployment
  •  destinationTypeTarget
    •  分配库时,请按如下所示设置值:
  •  sourceTypeLibrary
  •  destinationTypeTarget
    •  分配服务时,请按如下所示设置值:
  •  sourceType:指定服务器的名称,例如 JDBCSystemResource
  •  destinationTypeTarget
    •  将服务器分配到群集时,请按如下所示设置值:
  •  sourceTypeServer
  •  destinationTypeCluster
    •  分配子部署时,请按如下所示设置值:
  •  sourceType: service.SubDeployment,其中 service 用于指定 SubDeployment 的父级(例如 JMSSystemResource.SubDeployment);还可以指定嵌套的子部署(例如AppDeployment.SubDeployment.SubDeployment
  •  destinationTypeTarget
    •  分配安全类型时,请按如下所示设置值:
  •  sourceType:安全类型的名称,例如 User
  •  destinationType:目标安全类型的名称,例如 Group

示例

下列示例可执行下列操作:

    •  将服务器 myServer 和 myServer2 分配到群集 myCluster
wls:/offline/mydomain> assign("Server", "myServer,myServer2", "Cluster", "myCluster")
    •  将所有服务器分配到群集 myCluster
wls:/offline/mydomain> assign("Server", "*", "Cluster", "myCluster")
    •  将应用程序部署 myAppDeployment 分配到目标服务器 newServer
wls:/offline/mydomain> assign("AppDeployment", "myAppDeployment", "Target", "newServer")
    •  将用户 newUser 分配到组 Monitors
wls:/offline/mydomain> assign("User", "newUser", "Group", "Monitors")
    •  将子部署 myQueueSubDeployment(为 JMS 资源 myJMSResource 的子级)分配到目标服务器 newServer
wls:/offline/mydomain> assign(‘JMSSystemResource.SubDeployment‘, ‘myJMSResource.myQueueSubDeployment‘, ‘Target‘, ‘newServer‘)
    •  将嵌套的子部署 MedRecAppScopedJMS.MedRecJMSServer(为 AppDeployment AppDeployment 的子级)分配到目标服务器 AdminServer
wls:/offline/mydomain>assign(‘AppDeployment.SubDeployment.SubDeployment ‘,‘MedRecEAR.MedRecAppScopedJMS.MedRecJMSServer‘,‘Target‘,‘AdminServer‘)

assignAll

命令类别:编辑命令 用于 WLST:脱机版

描述

注意:自 WebLogic Server 9.0 开始,不赞成使用此命令。应更新您的脚本,以使用 assign 命令,如 assign 中所述。此命令仍可以在指定 sourceType 的任何资源上执行。

将所有应用程序或服务分配到一个或多个目标。

注意:请注意,必须使用 assign 命令分配 JMS 服务器和 JMS 分布式目标,如 assign 中所述。

在出现错误的情况下,此命令将返回 WLSTException

语法

assignAll(sourceType, destinationType, destinationName)

参数
定义
sourceType
要分配的应用程序或服务的类型。可将此值设置为 Applications 或 Services
destinationType
目标类型。必须将此值设置为 Target
destinationName
目标名称。可以指定多个名称,用逗号隔开。

 

示例

以下示例可将所有服务分配到服务器 adminServer 和 cluster1

wls:/offline/mydomain> assignAll("Services", "Target", "adminServer,cluster1")

可将下列服务(如果存在)分配到指定的目标:MigratableRMIServiceShutdownclassStartupclassFileT3,RMCFactoryMailSessionMessagingBridgeJMSConnectionFactoryJDBCConnectionPoolJDBCMultipoolJDBCTxDatasourceJDBCDataSourceJDBCPoolCompJoltConnectionPoolWLECConnectionPool WTCServer

cancelEdit

命令类别:编辑命令 用于 WLST:联机版

描述

取消编辑会话,解除编辑锁定,并放弃所有未保存的更改。

发出此命令的用户不一定必须是当前编辑者;这样可允许管理员取消编辑会话(如有必要),以使其他用户可以启动编辑会话。

在出现错误的情况下,此命令将返回 WLSTException

语法

cancelEdit([defaultAnswer])

参数
定义
defaultAnswer
可选。这是不希望从命令行中获得提示时的默认响应。有效值为 y 和 n。此参数默认为 null,WLST 将会提示您作出响应。

 

示例

以下示例可取消当前编辑会话。在取消前,WLST 将提示进行验证。

wls:/mydomain/edit !> cancelEdit() Sure you would like to cancel the edit session?(y/n)y Edit session is cancelled successfully wls:/mydomain/edit>

create

命令类别:编辑命令 用于 WLST:联机版或脱机版

描述

为当前 Bean 创建指定类型的配置 Bean。

create 命令可返回新建配置 Bean 的存根控件。在出现错误的情况下,此命令将返回 WLSTException

注意:子类型必须在其父类型的实例之下创建。仅可以创建当前配置管理对象 (cmo) 类型子类型的配置 Bean。有关 cmo 变量的详细信息,请参阅更改当前管理对象。

 create 命令与 WLST 联机版配合使用时,请注意以下事项:

  •  必须连接到管理服务器。不能将 create 命令用于运行时 MBean,或 WLST 连接到受管服务器实例时不能使用此命令。
  •  在发出此命令之前,必须使用 edit 命令导航到编辑配置 MBean 层次。请参阅 edit。
  •  可以使用 create 命令创建当前 MBean 类型子类型的 WebLogic Server 配置 MBean。

 create 命令与 WLST 脱机版配合使用时,请注意以下事项:

  •  使用 WLST 脱机版时,下列字符在对象名称中无效:句号 (.)、正斜杠 (/) 或反斜杠 (\)。

有关详细信息:

  •  创建 MBean,请参阅“使用 JMX 开发自定义管理实用工具”中的了解 WebLogic Server MBean。
  •  有关创建特定类型的 Mbean 资源(如 JMS 或 JDBC 系统资源)的示例,请参阅随产品安装的 WLST 示例脚本,在 WLST 示例脚本中有具体说明。
  •  有关 Mbean 及其子类型、特性和操作的详细信息,请参阅 WebLogic Server MBean Reference。

语法

create(name, childMBeanType, [baseProviderType])

参数
定义
name
要创建的配置 Bean 的名称。
childMBeanType
要创建的配置 Bean 的类型。可以创建在 config.xml 文件中定义的任何类型(除自定义安全类型之外)的实例。有关有效配置 Bean 的详细信息,请参阅 WebLogic Server MBean Reference。
baseProviderType
创建安全提供程序时,可指定基本安全提供程序类型,例如 AuthenticationProvider。此参数默认为 None。

 

示例

以下示例可为当前配置 Bean 创建名为 newServer、类型为 Server 的子配置 Bean,并将存根控件存储为 server1

wls:/mydomain/edit !> server1=create(‘newServer‘,‘Server‘) Server with name `newServer‘ has been created successfully. wls:/mydomain/edit !> server1.getName() `newServer‘ wls:/mydomain/edit !>

以下示例可创建称为 myProvider 的身份验证提供程序安全提供程序:

wls:/mydomain/edit !> cd(‘SecurityConfiguration/mydomain/Realms/myrealm‘) wls:/mydomain/edit !> create(‘myProvider‘,‘weblogic.security.providers.authentication.SQLAuthenticator‘,‘AuthenticationProvider‘)

以下示例可创建名为 highsec_nm 的计算机,并设置关联节点管理器的特性。

wls:/mydomain/edit !> create(‘highsec_nm‘, ‘Machine‘) wls:/mydomain/edit !> cd(‘Machine/highsec_nm/NodeManager/highsec_nm‘)  wls:/mydomain/edit !> set(‘DebugEnabled‘, ‘true‘) wls:/mydomain/edit !> set(‘ListenAddress‘, ‘innes‘) wls:/mydomain/edit !> set(‘NMType‘, ‘SSL‘) wls:/mydomain/edit !> set(‘ShellCommand‘, ‘‘)

delete

命令类别:编辑命令 用于 WLST:联机版或脱机版

描述

删除当前配置 Bean 的指定类型的配置 Bean 的实例。

在出现错误的情况下,此命令将返回 WLSTException

注意:仅可以删除当前配置管理对象 (cmo) 类型的子类型的配置 Bean。有关 cmo 变量的详细信息,请参阅更改当前管理对象。

语法

delete(name, childMBeanType)

参数
定义
name
要删除的子配置 Bean 的名称。
childMBeanType
要删除的配置 Bean 的类型。可以删除 config.xml 文件中所定义的任何类型的实例。有关有效配置 Bean 的详细信息,请参阅 WebLogic Server MBean Reference。

 

示例

以下示例可删除名为 newServer、类型为 Server 的配置 Bean:

wls:/mydomain/edit !> delete(‘newServer‘,‘Server‘) Server with name ‘newServer‘ has been deleted successfully. wls:/mydomain/edit !>

encrypt

命令类别:编辑命令 用于 WLST:联机版

描述

对指定的字符串进行加密。然后可以在配置文件中使用加密的字符串,或将其用作命令的参数。

必须为要在其中使用加密字符串的每个域调用一次此命令。只能在最初加密字符串的域中使用相应的字符串。

在出现错误的情况下,此命令将返回 WLSTException

语法

encrypt(obj, [domainDir])

参数
定义
obj
要对其进行加密的字符串。
domainDir
可选。域目录的绝对路径名。加密字符串只能供指定目录中包含的域使用。
如果未指定此参数,此命令就对字符串进行加密,以用于 WLST 当前连接到的域中。

 

示例

以下示例通过使用指定域目录中的 security/SerializedSystemIni.dat 文件对指定的字符串进行加密。

wls:/mydomain/serverConfig> es=encrypt(‘myPassword‘,‘c:/bea/domains/mydomain‘)

get

命令类别:编辑命令 用于 WLST:联机版或脱机版

描述

返回指定特性的值。有关可以查看的 MBean 特性的详细信息,请参阅 WebLogic Server MBean Reference。在出现错误的情况下,此命令将返回 WLSTException

注意:可通过输入 ls(‘a‘) 列出所有特性及其当前值。有关详细信息,请参阅 ls。

也可以使用 cmo 变量在当前配置 Bean 上执行任一 get 方法。例如:

cmo.getListenPort()

有关 cmo 变量的详细信息,请参阅更改当前管理对象。

语法

get(attrName)

参数
定义
attrName
要显示的特性的名称。可以指定特性的完整路径名。如果未指定任何路径名,将显示当前配置对象的特性。

 

示例

以下示例可为当前配置 Bean 返回 AdministrationPort 的值。

wls:/mydomain/serverConfig> get(‘AdministrationPort‘) 9002

也可以使用 cmo 变量:

cmo.getAdministrationPort()

getActivationTask

命令类别:编辑命令 用于 WLST:联机版

描述

返回用户可以从中获取状态的最新 ActivationTask MBean。ActivationTask MBean 可反映用户当前所进行或最近已进行的更改的状态。然后可以调用方法以获取有关正在进行的或刚完成的最新配置管理器激活任务的信息。在出现错误的情况下,此命令将返回 WLSTException

语法

getActivationTask()

示例

以下示例可返回用户可在其上获取状态的最新 ActivationTask MBean,并将其存储到 task 变量中。

wls:/mydomain/serverConfig> task=getActivationTask() wls:/mydomain/serverConfig> task.getState() STATE_COMMITTED

invoke

命令类别:编辑命令 用于 WLST:联机版

描述

对当前配置 Bean 调用管理操作。通常,使用此命令可以调用除大多数 WebLogic Server 配置 Bean 提供的 get 和 set 操作之外的操作。类对象是通过用于加载对其调用操作的配置 Bean 的同一类加载器加载的。

WLST 连接到受管服务器实例时不能使用 invoke 命令。

如果成功,invoke 命令将返回由调用的操作返回的对象。在出现错误的情况下,此命令将返回 WLSTException

语法

invoke(methodName, parameters, signatures)

参数
定义
methodName
要调用的方法的名称。
parameters
要传递给方法调用的参数数组。
signatures
包含操作的签名的数组。

 

示例

以下示例可对当前配置 Bean 调用 lookupServer 方法。

wls:/mydomain/config> objs = jarray.array([java.lang.String("oamserver")],java.lang.Object) wls:/mydomain/edit> strs = jarray.array(["java.lang.String"],java.lang.String) wls:/mydomain/edit> invoke(‘lookupServer‘,objs,strs) true wls:/mydomain/edit>

isRestartRequired

命令类别:编辑命令 用于 WLST:联机版

描述

确定是否需要重新启动服务器。

如果在编辑会话正在进行中时调用此命令,则响应将基于当前正在进行中的编辑。如果指定某个特性的名称,WLST 将指示是否仅对于此特性需要重新启动服务器。

在出现错误的情况下,此命令将返回 WLSTException

语法

isRestartRequired([attributeName])

参数
定义
attributeName
可选。指定特性的名称,此特性为要检查是否需要重新启动服务器的特性。

 

示例

以下示例可指定在当前 WLST 会话期间进行的所有更改是否需要重新启动服务器。

wls:/mydomain/edit !> isRestartRequired()  Server re-start is REQUIRED for the set of changes in progress.
The following attribute(s) have been changed on MBeans that require server re-start. MBean Changed : mydomain:Name=mydomain,Type=Domain Attributes changed : AutoConfigurationSaveEnabled

以下示例可指定如果编辑 ConsoleEnabled 特性,是否需要重新启动服务器。

wls:/mydomain/edit !> isRestartRequired("ConsoleEnabled")  Server re-start is REQUIRED if you change the attribute ConsoleEnabled wls:/mydomain/edit !> 

loadDB

命令类别:编辑命令 用于 WLST:脱机版

描述

将 SQL 文件加载到数据库中。

loadDB 命令可从模板文件中加载 SQL 文件。将域模板或者扩展模板加载到内存中后,方可发出此命令(请参阅 readDomain 和 readTemplate)。

在执行此命令之前,请确保满足下列条件:

    •  相应的数据库正在运行。
    •  指定的数据库和版本存在 SQL 文件。

要验证相应的 SQL 文件是否存在,请打开域模板并查找相关的 SQL 文件列表 jdbc.index(位于 _jdbc_ 目录下)。例如,对于 PointBase 版本 4.4,SQL 文件列表位于 _jdbc_\Pointbase\44\jdbc.index

如果不能满足上述条件,此命令将失败。

在出现错误的情况下,此命令将返回 WLSTException

语法

loadDB(dbVersion, datasourceName, dbCategory)

参数
定义
dbVersion
要使用 SQL 文件的数据库的版本。
datasourceName
用于加载 SQL 文件的 JDBC 数据源的名称。
dbCategory
可选。与指定的数据源相关联的数据库类别。
有关 jdbc.index 文件和数据库类别的详细信息,请参阅“Domain Template 参考”(可从以下站点获得:http://edocs.bea.com/common/docs100/tempref/tempref.html)中的“模板中通常包含的文件”

 

示例

以下示例通过使用 p13nDataSource JDBC 数据源加载与专用于数据库版本 5.1 的 Drop/Create P13N Database Objects 相关的 SQL 文件。

wls:/offline/mydomain> loadDB(‘5.1‘, ‘p13nDataSource‘, ‘Drop/Create P13N Database Objects‘)

loadProperties

命令类别:编辑命令 用于 WLST:联机版 和 Offline

描述

从文件中加载属性值,并使这些值在 WLST 会话中可用。

将 WLST 导入为 Jython 模块时,不能使用此命令,如将 WLST 导入为 Jython 模块中所述。

在出现错误的情况下,此命令将返回 WLSTException

语法

loadProperties(fileName)

参数
定义
fileName
属性文件路径名。

 

示例

此示例可获取和设置属性文件的值。

wls:/mydomain/serverConfig> loadProperties(‘c:/temp/myLoad.properties‘)

save

命令类别:编辑命令 用于 WLST:联机版

描述

保存已完成但尚未保存的编辑。此命令仅当正在编辑会话时有效。有关启动编辑会话的信息,请参阅 startEdit。

在出现错误的情况下,此命令将返回 WLSTException

语法

save()

示例

以下示例可保存尚未保存到磁盘的编辑。

wls:/mydomain/edit !> save() Saving all your changes ... Saved all your changes successfully. wls:/mydomain/edit !> 

set

命令类别:编辑命令 用于 WLST:联机版或脱机版

描述

在当前管理对象中设置指定特性的值。在使用 WLST 脱机版时,此命令将特性值写入域的配置文件中。在使用 WLST 联机版时,此命令可设置 MBean 特性的值。当您激活编辑时,会将联机版更改写入到域的配置文件中。

在出现错误的情况下,此命令将返回 WLSTException

有关设置已加密的特性(所有已加密特性的名称都以 Encrypted 结尾)的信息,请参阅写入和读取加密的配置值。

使用 WLST 联机版时请注意下列事项:

    •  要使用此命令,必须在编辑会话中。请参阅 startEdit。
    •  当 WLST 连接到受管服务器实例时不能使用此命令。
    •  作为此命令的替代,可使用以下语法的 cmo 变量: cmo.setattrName(value)

例如,可以使用  cmo.setListenPort(7011),而不使用 set(`ListenPort‘, 7011)

有关 cmo 变量的详细信息,请参阅更改当前管理对象。

语法

set(attrName, value)

参数
定义
attrName
要设置的特性的名称。
value
要设置的特性的值。

注意:不应使用单引号或双引号将此值括起来。

 

 

例如

以下示例可将 DomainMBean 的 ArchiveConfigurationCount 特性设置为 10

wls:/mydomain/serverConfig> set(‘ArchiveConfigurationCount‘,10)

以下示例将自定义 Mbean 的 T1TimerInterval 特性的 Long 值设置为 123

wls:/mydomain/serverConfig> set(`T1TimerInterval‘, Long(123))

以下示例将自定义 Mbean 的 MyBooleanAttribute 特性的 boolean 值设置为 true

wls:/mydomain/serverConfig> set(`MyBooleanAttribute‘, Boolean(true))

setOption

命令类别:编辑命令 用于 WLST:脱机版

描述

设置与创建域或更新域相关的选项。在出现错误的情况下,此命令将返回 WLSTException

语法

setOption(optionName, optionValue)

参数
定义
optionName
要设置的选项的名称。
可用于域创建的选项包括:
  •  CreateStartMenu - 一个布尔值,可指定是否在 Windows 平台上创建开始菜单快捷方式。此选项默认为 true

注意:如果具有管理员权限的用户已安装本软件并选择在 All Users 文件夹中创建开始菜单项,则在使用 Configuration Wizard 或 WLST 创建域时,仅具有管理员权限的用户可以在同一文件夹中创建开始菜单项。即如果不具有管理员权限的用户在此安装中使用 Configuration Wizard 或 WLST 创建域,将不会创建这些域的开始菜单快捷方式。在这种情况下,用户可以根据需要在他们的本地开始菜单文件夹中手工创建快捷方式。

 

  •  DomainName - 域的名称。默认情况下,域的名称是从域目录的名称中派生出来的。例如,对于保存到 c:/bea/user_projects/domains/myMedrec 的域,域名为 myMedrec。通过设置DomainName,创建的域的名称可以独立于域目录名。
  •  JavaHome - 启动服务器时使用的 JVM 的主目录。此选项的默认值取决于 WebLogic Server 的安装平台。
  •  OverwriteDomain - 布尔值,可指定是否允许覆盖现有的域。此选项默认为 false
  •  ServerStartMode - 为新创建的域启动服务器时使用的模式。此值可以为 dev(开发)或 prod(生产)。此选项默认为 dev
可用于域更新的选项包括:
  •  AllowCasualUpdate - 布尔值,可指定是否允许在不添加扩展模板的情况下更新域。此选项默认为 true
  •  ReplaceDuplicates - 布尔值,可指定在发生冲突时,是保持域中原始的配置元素还是将这些元素替换为扩展模板中的相应元素。此选项默认为 true
optionName(继续)
可用于域创建和域更新的选项包括:
  •  AppDir - 应用程序需要单独的目录时使用的应用程序目录,由模板指定。此选项默认为 BEAHOME/user_projects/applications/domainname,其中 BEAHOME 用于指定 BEA 主目录,domainname 用于指定域的名称。
  •  AutoAdjustSubDeploymentTarget - 布尔值,可指定 WLST 是否自动调整 AppDeployments 的子部署的目标。此选项默认为 true。要停用此功能,请将此选项设置为 false,并在写入或更新域或域模板之前明确设置 AppDeployment 子部署的定位。
AutoDeploy - 布尔值,可指定创建一个群集或多个受管服务器时,是否激活自动部署。此选项默认为 true。要停用此项功能,请在脚本的第一行中将选项设置为 false
optionValue
选项的值。

注意:可将布尔值指定为字符串(truefalse)或整数(01)。

 

 

示例

以下示例可将 CreateStartMenu 选项设置为 false

wls:/offline> setOption(‘CreateStartMenu‘, ‘false‘)

showChanges

命令类别:编辑命令 用于 WLST:联机版

描述

显示在当前编辑会话期间由当前用户对配置所进行的更改。在出现错误的情况下,此命令将返回 WLSTException

语法

showChanges([onlyInMemory])

参数
定义
onlyInMemory
可选。一个布尔值,可指定是否仅显示尚未保存的更改。此参数默认为 false,表示将显示从启动会话开始所进行的所有更改。

 

示例

以下示例可显示自启动当前编辑会话之后,当前用户对配置进行的所有更改。

wls:/mydomain/edit !> showChanges() Changes that are in memory and saved to disc but not yet activated are:
MBean Changed : com.bea:Name=basicWLSDomain,Type=Domain Operation Invoked : add Attribute Modified : Machines Attributes Old Value : null Attributes New Value : Mach1 Server Restart Required : false
MBean Changed : com.bea:Name=basicWLSDomain,Type=Domain Operation Invoked : add Attribute Modified : Servers Attributes Old Value : null Attributes New Value : myserver Server Restart Required : false

startEdit

命令类别:编辑命令 用于 WLST:联机版

描述

代表当前已连接的用户启动配置编辑会话。在发出此命令之前,必须使用 edit 命令导航到编辑配置 MBean 层次。有关详细信息,请参阅 edit。

必须在调用任何命令前调用此命令,以对域配置进行修改。

在出现错误的情况下,此命令将返回 WLSTException

注意:如果 WLST 检测到存在由同一用户可能通过管理控制台或另一个 WLST 会话启动的编辑会话已在进行中,WLST 将自动启动编辑会话。

语法

startEdit([waitTimeInMillis], [timeoutInMillis], [exclusive])

参数
定义
waitTimeInMillis
可选。在另一个用户取得锁定的情况下,WLST 在其取得锁定之前所等待的时间(毫秒)。此参数默认为 0 毫秒。
timeOutInMillis
可选。WLST 等待释放编辑锁定的时间(毫秒)。此参数默认为 -1 毫秒,表示此编辑会话永不过期。
exclusive
可选。指定编辑会话是否应为独占会话。如果设置为 true,若同一所有者输入 startEdit 命令,则 WLST 将在启动新编辑会话之前一直等待,直到释放当前编辑会话锁定。独占锁定超时取决于timeoutInMillis 中指定的时间。此参数默认为 false

 

示例

以下示例可保存尚未保存到磁盘的编辑。

wls:/mydomain/edit> startEdit(60000, 120000) Starting an edit session ... Started edit session, please be sure to save and activate your changes once you are done. wls:/mydomain/edit !>

stopEdit

命令类别:编辑命令 用于 WLST:联机版

描述

停止当前编辑会话,解除编辑锁定,并放弃所有未保存的更改。

在出现错误的情况下,此命令将返回 WLSTException

语法

stopEdit([defaultAnswer])

参数
定义
defaultAnswer
可选。这是不希望从命令行中获得提示时的默认响应。有效值为 y 和 n。此参数默认为 null,WLST 将会提示您作出响应。

 

示例

以下示例可停止当前编辑会话。在取消前,WLST 将提示进行验证。

wls:/mydomain/edit !> stopEdit() Sure you would like to stop your edit session?(y/n) y Edit session has been stopped successfully. wls:/mydomain/edit>

unassign

命令类别:编辑命令 用于 WLST:脱机版

描述

从一个或多个目标中取消应用程序或资源的分配。

在出现错误的情况下,此命令将返回 WLSTException

语法

unassign(sourceType, sourceName, destinationType, destinationName)

参数
定义
sourceType
要取消分配的配置 Bean 的类型。可将此值设置为下列值之一:
  •  AppDeployment
  •  Library
  •  securityType(例如 User
  •  Server
  •  service(例如 JDBCSystemResource
  •  service.SubDeployment,其中 service 用于指定 SubDeployment(例如 JMSSystemResource.SubDeployment)的服务类型;还可以指定嵌套的子部署(例如AppDeployment.SubDeployment.SubDeployment
sourceName
要取消分配的应用程序或资源的名称。可以指定多个名称,用逗号隔开,或者可以使用通配符 (*) 指定给定类型的所有资源。
可使用以下格式指定子部署:service.subDeployment,其中 service 用于指定父服务,subDeployment 用于指定子部署的名称。例如 myJMSResource.myQueueSubDeployment。 还可以指定嵌套的子部署,例如 MedRecEAR.MedRecAppScopedJMS.MedRecJMSServer
destinationType
目标类型。下文提供了设置此值的准则。
destinationName
目标名称。可以指定多个名称,用逗号隔开。

 

可使用下列准则设置 sourceType 和 destinationType

    •  取消分配应用程序部署时,请按如下所示设置值:
  •  sourceTypeAppDeployment
  •  destinationTypeTarget
    •  取消分配库时,请按如下所示设置值:
  •  sourceTypeLibrary
  •  destinationTypeTarget
    •  取消分配安全类型时,请按如下所示设置值:
  •  sourceType:安全类型的名称,例如 User
  •  destinationType:目标安全类型的名称,例如 Group
    •  从群集中取消分配服务器时,请按如下所示设置值:
  •  sourceTypeServer
  •  destinationTypeCluster
    •  取消分配服务时,请按如下所示设置值:
  •  sourceType:指定服务器的名称,例如 JDBCSystemResource
  •  destinationTypeTarget
    •  取消分配子部署时,请按如下所示设置值:
  •  sourceType: service.SubDeployment,其中 service 用于指定 SubDeployment 的父级(例如 JMSSystemResource.SubDeployment);还可以指定嵌套的子部署(例如AppDeployment.SubDeployment.SubDeployment
  •  destinationTypeTarget

示例

下列示例可执行下列操作:

    •  从群集 myCluster 中取消分配服务器 myServer 和 myServer2
wls:/offline/medrec> unassign("Server", "myServer,myServer2", "Cluster", "myCluster")
    •  从群集 myCluster 中取消分配所有服务器。
wls:/offline/mydomain> unassign("Server", "*", "Cluster", "myCluster")
    •  从组 Monitors 中取消分配用户 newUser
wls:/offline/medrec> unassign("User", "newUser", "Group", "Monitors")
    •  从目标服务器 newServer 中取消分配应用程序部署 myAppDeployment
wls:/offline/mydomain> unassign("AppDeployment", "myAppDeployment", "Target", "newServer")
    •  从目标服务器 AdminServer 中取消分配嵌套的子部署 MedRecAppScopedJMS.MedRecJMSServer(为 AppDeployment AppDeployment 的子级)。
wls:/offline/mydomain> assign(‘AppDeployment.SubDeployment.SubDeployment‘, ‘MedRecEAR.MedRecAppScopedJMS.MedRecJMSServer‘, ‘Target‘,‘AdminServer‘)

unassignAll

命令类别:编辑命令 用于 WLST:脱机版

描述

注意:自 WebLogic Server 9.0 开始,不赞成使用此命令。应更新您的脚本,以使用 unassign 命令,如 unassign 中所述。此命令仍可以在指定 sourceType 的任何资源上执行。

从一个或多个目标中取消分配所有应用程序或服务。

在出现错误的情况下,此命令将返回 WLSTException

语法

unassignAll(sourceType, destinationType, destinationName)

参数
定义
sourceType
要取消分配的应用程序或服务的类型。可将此值设置为 Applications 或 Services
destinationType
目标类型。必须将此值设置为 Target
destinationName
目标名称。可以指定多个名称,用逗号隔开。

 

示例

下面的示例将从服务器 adminServer 和 cluster1 中取消分配所有的服务。

wls:/offline/medrec> unassignAll("Services", "Target", "adminServer,cluster1")

此时从指定的目标中取消分配下列服务(如果存在):MigratableRMIServiceShutdownclassStartupclassFileT3RMCFactoryMailSessionMessagingBridgeJMSConnectionFactoryJDBCConnectionPoolJDBCMultipoolJDBCTxDatasourceJDBCDataSourceJDBCPoolCompJoltConnectionPoolWLECConnectionPool WTCServer

undo

命令类别:编辑命令 用于 WLST:联机版

描述

恢复所有未保存的或未激活的编辑。

指定是否恢复所有未激活的编辑(包括已保存到磁盘的编辑)或自上次 save 操作以来的所有编辑。此命令不会释放编辑会话。

在出现错误的情况下,此命令将返回 WLSTException

语法

undo([unactivateChanges], [defaultAnswer])

参数
定义
unactivateChanges
可选。这是一个布尔值,指定是否撤消所有未激活的更改(包括已保存到磁盘的编辑)。此参数默认为 false,表示恢复自上次 save 操作以来的所有编辑。
defaultAnswer
可选。这是不希望从命令行中获得提示时的默认响应。有效值为 y 和 n。此参数默认为 null,WLST 将会提示您作出响应。

 

示例

下面的示例将恢复自上次 save 操作以来进行的所有更改。WLST 提示您在恢复之前进行验证。

wls:/mydomain/edit !> undo() Sure you would like to undo your changes?(y/n) y Discarded your in-memory changes successfully. wls:/mydomain/edit>

下面的示例恢复所有未激活的更改。WLST 提示您在恢复之前进行验证。

wls:/mydomain/edit !> undo(‘true‘) Sure you would like to undo your changes?(y/n) y Discarded all your changes successfully. wls:/mydomain/edit>

validate

命令类别:编辑命令 用于 WLST:联机版

描述

验证已完成但尚未保存的更改。通过此命令,可以在保存所有更改之前验证它们的有效性。

在出现错误的情况下,此命令将返回 WLSTException

语法

validate()

示例

下面的示例将验证所有已完成但尚未保存的更改。

wls:/mydomain/edit !> validate() Validating changes ... Validated the changes successfully

 


信息命令

使用表 A-7 中列出的 WLST 信息命令以询问域、服务器和变量,并提供配置 Bean、运行时 Bean 和 WLST 相关信息。

表 A-7 用于 WLST 配置的信息命令
命令...
可以...
用于 WLST...
addListener
将 JMX 监听器添加到指定的 MBean。
联机版
configToScript
将现有的服务器配置(config 目录)转换为可执行的 WLST 脚本
联机版或脱机版
dumpStack
显示执行 WLST 操作时最后一次出现异常的堆栈跟踪,并重置此堆栈跟踪。
联机版或脱机版
dumpVariables
显示 WLST 使用的所有变量,包括它们的名称和值。
联机版或脱机版
find
在当前层次中查找 MBean 和特性。
联机版
getConfigManager
返回管理更改过程的最新 ConfigurationManagerBean MBean。
联机版
getMBean
通过浏览至指定路径返回 MBean。
联机版
getMBI
返回指定 MBeanType 或 cmo 变量的 MBeanInfo
联机版
getPath
返回指定 MBean 实例的 MBean 路径。
联机版
listChildTypes
列出所有可创建或删除的 cmo 类型的子 MBean。
联机版
lookup
查找指定的 MBean。
联机版
ls
列出当前配置 Bean 或运行时 Bean 的所有子 Bean 和/或特性。
联机版或脱机版
man
为当前 MBean 或其指定特性显示来自 MBeanInfo 的帮助。
联机版
redirect
将 WLST 输出重定向到指定的文件名。
联机版或脱机版
removeListener
删除以前定义的监听器。
联机版
showListeners
显示当前定义的所有监听器。
联机版
startRecording
记录与 WLST 的所有用户交互,这对捕获命令进行重播非常有用。
联机版或脱机版
state
使用节点管理器返回服务器或群集及其状态的表。
联机版
stopRecording
停止记录 WLST 命令。
联机版或脱机版
stopRedirect
停止将 WLST 输出重定向到文件。
联机版或脱机版
storeUserConfig
创建用户配置文件和相关联的密钥文件。
联机版
threadDump
显示指定服务器的线程转储。
联机版或脱机版
viewMBean
显示有关 MBean 的信息,例如特性名称、特性值和操作。
联机版
writeIniFile
将 WLST 定义和方法声明转换为 Python (.py) 文件。
联机版或脱机版

 

addListener

命令类别:信息命令 用于 WLST:联机版

描述

将 JMX 监听器添加到指定的 MBean。对 MBean 进行的所有更改都将报告到标准输出中和/或保存到指定的配置文件中。

在出现错误的情况下,此命令将返回 WLSTException

语法

addListener(mbean, [attributeNames], [logFile], [listenerName])

参数
定义
mbean
要监听的 MBean 或 MBean 对象的名称。
attributeNames
可选。要在其上添加 JMX 监听器的所有特性名称的列表(以逗号分隔)。此参数默认为空,将为所有特性添加 JMX 监听器。
logFile
可选。要在其中写入监听器信息的日志文件的名称和位置。此参数默认为标准输出。
listenerName
可选。JMX 监听器的名称。此参数默认为由 WLST 生成的名称。

 

示例

下面的示例在 cmo MBean 上为 Notes 和 ArchiveConfigurationCount 特性定义 JMX 监听器。此监听器名为 domain-listener 且存储在 ./listeners/domain.log 中。

wls:/mydomain/serverConfig> addListener(cmo, "Notes,ArchiveConfigurationCount","./listeners/domain.log","domain-listener") 

configToScript

命令类别:信息命令 用于 WLST:联机版或脱机版

将现有的服务器配置(config 目录)转换为可执行的 WLST 脚本。可使用生成的脚本在其他服务器上重新创建资源。

configToScript 命令创建下列文件:

  •  WLST 脚本,它包含重新创建配置需要的命令。
  •  属性文件,它包含域的特定值。可以更新此文件中的值以新建与原始配置类似的域。
  •  用来存储加密特性的用户配置文件和关联的密钥文件。用户配置文件包含加密信息。密钥文件包含用于加密和解密已加密信息的密钥。

运行生成的脚本时:

  •  如果服务器当前正在运行,WLST 将尝试使用属性文件中的值进行连接,然后运行脚本命令创建服务器资源。
  •  如果当前没有运行任何服务器,WLST 将使用属性文件中的值启动服务器,运行脚本命令创建服务器资源,然后关闭服务器。这可能会导致 WLST 退出命令外壳。

在出现错误的情况下,此命令将返回 WLSTException

语法

configToScript([configPath], [pyPath], [overwrite], [propertiesFile], [createDeploymentScript])

参数
定义
configPath
可选。包含要转换配置的 domain 目录的路径。此参数默认为从中启动 WLST (./) 的目录。
pyPath
可选。要写入已转换的 WLST 脚本的路径和文件名。此参数默认为 ./config/config.py
overwrite
可选。这是一个布尔值,它指定如果脚本文件已存在,是否应对其进行改写。此参数默认为 true,表示改写脚本文件。
propertiesFile
可选。希望 WLST 在其中写入属性文件的目录的路径。此参数默认为为 scriptPath 参数指定的路径名。
createDeploymentScript
可选。这是一个布尔值,它指定 WLST 是否创建仅执行部署的脚本。此参数默认为 false,表示不创建部署脚本。

 

示例

下面的示例将配置转换为 WLST 脚本 config.py。默认情况下,从 ./config 加载配置文件,脚本文件保存到 .config/config.py,属性文件保存到 .config/config.py.properties

wls:/offline> configToScript() configToScript is loading configuration from c:\bea\user_projects\domains\wls\config\config.xml ... Completed configuration load, now converting resources to wlst script... configToScript completed successfully The WLST script is written to c:\bea\user_projects\domains\wls\config\config.py and the properties file associated with this script is written to c:\bea\user_projects\domains\wls\config\config.py.properties wls:/offline>

下面的示例将文件 c:\bea\user_projects\domains\mydomain\config 目录中配置的服务器资源转换为 WLST 脚本 c:\bea\myscripts\config.py

wls:/offline> configToScript(‘c:/bea/user_projects/domains/mydomain‘, ‘c:/bea/myscripts‘) configToScript is loading configuration from c:\bea\user_projects\domains\mydomain\config\config.xml ... Completed configuration load, now converting resources to wlst script... configToScript completed successfully The WLST script is written to c:\bea\myscripts\config.py and the properties file associated with this script is written to c:\bea\mydomain\config.py.properties wls:/offline>

dumpStack

命令类别:信息命令 用于 WLST:联机版或脱机版

描述

显示执行 WLST 操作时最后一次出现异常的堆栈跟踪,并重置此堆栈跟踪。

如果重置成功,则 dumpstack 命令将返回 Throwable 对象。在出现错误的情况下,此命令将返回 WLSTException

语法

dumpStack()

示例

此示例显示堆栈跟踪。

wls:/myserver/serverConfig> dumpStack() com.bea.plateng.domain.script.jython.WLSTException: java.lang.reflect.Invocation TargetException ...

dumpVariables

命令类别:信息命令 用于 WLST:联机版或脱机版

描述

显示 WLST 使用的所有变量,包括它们的名称和值。在出现错误的情况下,此命令将返回 WLSTException

语法

dumpVariables()

示例

此示例将显示所有当前变量及其值。

wls:/mydomain/serverConfig> dumpVariables() adminHome   weblogic.rmi.internal.BasicRemoteRef - hostID:     ‘-1 108080150904263937S:localhost:[7001,8001,-1,-1,-1,-1,-1]:    mydomain:AdminServer‘, oid: ‘259‘, channel: ‘null‘ cmgr   [MBeanServerInvocationHandler]com.bea:Name=ConfigurationManager,    Type=weblogic.management.mbeanservers.edit.ConfigurationManagerMBean

cmo   [MBeanServerInvocationHandler]com.bea:Name=mydomain,Type=Domain connected true domainName mydomain ... wls:/mydomain/serverConfig>

find

命令类别:信息命令 用于 WLST:联机版

描述

在当前层次中查找 MBean 和特性。

WLST 将返回用来存储特性和/或特性类型及特性值的 MBean 的路径名。如果将 searchInstancesOnly 设置为 false,则此命令也会搜索未在服务器中实例化但可以创建的 MBeanType 路径。在出现错误的情况下,此命令将返回 WLSTException

语法

find([name], [type], [searchInstancesOnly])

参数
定义
name
可选。要查找的特性名称。
type
可选。要查找的特性类型。
searchInstancesOnly
可选。这是一个布尔值,它指定是否仅搜索已注册的实例,或者同时搜索未在服务器中实例化、但可以创建的 MBeanTypes 的路径。此参数默认为 true,表示仅搜索已注册的实例。

 

示例

下面的示例在当前配置层次中搜索名为 javaCompiler 的特性。

wls:/mydomain/serverConfig> find(name = ‘JavaCompiler‘) Finding ‘JavaCompiler‘ in all registered MBean instances ... /Servers/AdminServer                         JavaCompilerPreClassPath      null /Servers/AdminServer                       JavaCompiler                  java /Servers/AdminServer                      JavaCompilerPostClassPath   null wls:/mydomain/serverConfig>

下面的示例在当前配置层次中搜索类型为 JMSRuntime 的特性。

wls:/mydomain/serverRuntime> find(type=‘JMSRuntime‘) Finding MBean of type ‘JMSRuntime‘ in all the instances ... /JMSRuntime/AdminServer.jms wls:/mydomain/serverRuntime>

下面的示例在当前配置层次中搜索名为 execute 的特性。searchInstancesOnly 参数设置为 false,表示同时搜索未在服务器中实例化的 MBeanType。

wls:/mydomain/serverConfig> find(name=‘execute‘, searchInstancesOnly=‘false‘) Finding ‘execute‘ in all registered MBean instances ... /Servers/AdminServer 				ExecuteQueues [Ljavax.management.ObjectName;@1aa7dbc /Servers/AdminSever 				Use81StyleExecuteQueues                            false

Now finding ‘execute‘ in all MBean Types that can be instantiated ... /Servers                                      ExecuteQueues /Servers                                      Use81StyleExecuteQueues wls:/mydomain/serverConfig>

getConfigManager

命令类别:编辑命令 用于 WLST:联机版

描述

返回可管理更改过程的最新 ConfigurationManager MBean。然后您可以调用方法以便管理域中的配置更改。在出现错误的情况下,此命令将返回 WLSTException

语法

getConfigManager()

示例

下面的示例返回最新的 ConfigurationManagerBean MBean 并将其存储到任务变量中。

wls:/mydomain/serverConfig> cm=getConfigManager() wls:/mydomain/serverConfig> cm=getType() ‘weblogic.management.mbeanservers.edit.ConfigurationManagerMBean‘

getMBean

命令类别:信息命令 用于 WLST:联机版

描述

通过浏览至指定路径返回 MBean。在出现错误的情况下,此命令将返回 WLSTException

注意:如果未找到 MBean,则不会出现异常。

语法

getMBean(mbeanPath)

参数
定义
mbeanPath
当前层次中的 MBean 的路径名。

 

示例

下面的示例返回指定路径的 MBean。

wls:/mydomain/edit !> com=getMBean(‘Servers/myserver/COM/myserver‘) wls:/mydomain/edit !> com.getType() `Server‘

getMBI

命令类别:信息命令 用于 WLST:联机版

描述

返回指定的 MBeanType 或 cmo 变量的 MBeanInfo。在出现错误的情况下,此命令将返回 WLSTException

语法

getMBI([mbeanType])

参数
定义
mbeanType
可选。为其显示 MBeanInfo 的 MBeanType

 

示例

下面的示例获取指定 MBeanType 的 MBeanInfo,并将其存储在变量 svrMbi 中。

wls:/mydomain/serverConfig> svrMbi=getMBI(‘weblogic.management.configuration.ServerMBean‘)

getPath

命令类别:信息命令 用于 WLST:联机版

描述

返回当前树中 MBean 的指定 MBean 实例或 ObjectName 的 MBean 路径。在出现错误的情况下,此命令将返回 WLSTException

语法

getPath(mbean)

参数
定义
mbean
当前树中要返回其 MBean 路径的 MBean 的 MBean 实例或 ObjectName。

 

示例

下面的示例返回指定路径的 MBean。

wls:/mydomain/edit !> path=getPath(‘com.bea:Name=myserver,Type=Server‘) wls:/mydomain/edit !> print path ‘Servers/myserver‘

listChildTypes

命令类别:信息命令 用于 WLST:联机版

描述

列出所有可创建或删除的 cmo 的子 MBean。cmo 变量可指定您使用 WLST 上一次导航到的配置 Bean 实例。有关 cmo 变量的详细信息,请参阅更改当前管理对象。

在出现错误的情况下,此命令将返回 WLSTException

语法

listChildTypes([parent])

参数
定义
parent
可选。要为其列出子类型的父类型。

 

示例

下面的示例将列出可以创建或删除的 cmo 类型的子 MBean。

wls:/mydomain/serverConfig> listChildTypes() AppDeployments BridgeDestinations CachingRealms Clusters ... wls:/mydomain/serverConfig>

lookup

命令类别:信息命令 用于 WLST:联机版

描述

查找指定的 MBean。此 MBean 必须是当前 MBean 的子 MBean。在出现错误的情况下,此命令将返回 WLSTException

语法

lookup(name, [childMBeanType])

参数
定义
name
要查找的 MBean 的名称。
childMBeanType
可选。要查找的 MBean 的类型。

 

示例

下面的示例查找指定的服务器 myserver,并将返回的存根控件存储在 sbean 变量中。

wls:/mydomain/serverConfig> sbean=lookup(‘myserver‘,‘Server‘) wls:/mydomain/serverConfig> sbean.getType() `Server‘ wls:/mydomain/serverConfig> 

ls

命令类别:信息命令 用于 WLST:联机版或脱机版

描述

列出指定管理对象的特性、操作和子管理对象。

在出现错误的情况下,此命令将返回 WLSTException

默认情况下,输出以字符串形式返回,并且分为三列:

    •  第一列显示一组代码,描述所列出的项目。请参阅表 A-8。
    •  第二列显示项目名称。
    •  如果项目为特性,第三列就显示特性值。如果特性被加密,第三列就显示星号,而不显示值。(请参阅写入和读取加密的配置值。)
    •  如果项目为操作,第三列就使用以下模式显示操作的返回类型和输入参数:returnType: parameterType(parameterName)

表 A-8 ls 命令输出信息
代码
描述
d
表示项目为子管理对象。
类似 UNIX 或 Windows 文件系统中的目录,可以使用 cd 命令使子对象成为当前管理对象。
r
表示项目是可读的子管理对象或特性,假定已经根据安全领域的策略向当前用户授予读取权限。(请参阅“WebLogic Server MBean Reference”中的 Default Security Policies for MBeans。)
w
表示项目是可写特性,假定已经根据安全领域的策略向当前用户授予写入权限。(请参阅“WebLogic Server MBean Reference”中的 Default Security Policies for MBeans。)
x}。
表示项目是可执行的操作,假定已经根据安全领域的策略向当前用户授予执行权限。(请参阅“WebLogic Server MBean Reference”中的 Default Security Policies for MBeans。)

默认情况下,输出会列出当前管理对象的所有特性、操作和子管理对象。要筛选输出,或者查看不同管理对象的列表,可以指定命令参数。

当使用 WLST 脱机版时请注意下列事项:

    •  为了性能优化,WebLogic Server 不会在域配置文件中存储大多数默认值。某些情况下,此优化会阻止 WLST 脱机版显示全部管理对象(因为 WebLogic Server 从未将相应的 XML 元素写入域配置文件中)。比如,如果从未在域活动时修改域的默认日志记录严重程度级别,则 WLST 脱机版将不显示域的 Log 管理对象。

如果要更改其管理对象不被 WLST 脱机版显示的特性的默认值,必须首先使用 create 命令创建管理对象。然后,可使用 cd 命令转到管理对象并更改特性值。请参阅 create。

语法

ls( [ a | c | o ] [ moPath ])

ls( [ moPath ] returnMap [ returnType ] )

参数
定义
a
可选。只显示指定管理对象的特性(禁止显示其他项目)。
c
可选。只显示指定管理对象的子管理对象(禁止显示其他项目)。
o
可选。只显示能在指定管理对象上调用的操作(禁止显示其他项目)。
此参数只适用于 WLST 联机版。
moPath
可选。要为其列出特性、操作和子管理对象的管理对象的路径名。
可以指定相对于层次中当前位置的路径名,或绝对路径名。
在 WLST 脱机版中,使用正斜杠字符 (/) 指定配置文档的根。
在 WLST 联机版中,可以列出任何管理层次中的 MBean 内容(请参阅树命令)。使用以下语法可指定某个层次的根: root-name:/
例如,列出服务器运行时层次的根: ls(‘serverRuntime:/‘)
如果不指定此参数,此命令就列出当前管理对象的项目。
returnMap
可选。布尔值,用于确定此命令是否返回映射值。此参数的默认值为 false,可使此命令返回字符串。
returnType
可选。控制以列表形式返回的输出。指定 ac 或 o,如此表顶部所述,它可筛选输出。
只有将 returnMap 设置为 true 时,此参数才有效。此参数默认为 c

 

示例

下面的示例在 WLST 脱机版模式下显示 examples 域(已加载到内存)的所有子配置 Bean 和特性名称及特性值:

wls:/offline/mydomain > ls() dr--   AppDeployments dr--   BridgeDestinations dr--   Clusters dr--   CustomResources dr--   DeploymentConfiguration dr--   Deployments dr--   EmbeddedLDAP dr--   ErrorHandlings dr--   FileStores dr--   InternalAppDeployments dr--   InternalLibraries dr--   JDBCDataSourceFactories dr--   JDBCStores dr--   JDBCSystemResources dr--   JMSBridgeDestinations dr--   JMSInteropModules dr--   JMSServers dr--   JMSSystemResources dr--   JMX ... wls:/offline/examples>

下面的示例显示 DomainMBean 中的所有特性名称和特性值:

wls:/mydomain/serverConfig> ls(‘a‘) -r--   AdminServerName                              AdminServer -r--   AdministrationMBeanAuditingEnabled           false -r--   AdministrationPort                           9002 -r--   AdministrationPortEnabled                    false -r--   AdministrationProtocol                       t3s -r--   ArchiveConfigurationCount                    0 -r--   ClusterConstraintsEnabled                    false -r--   ConfigBackupEnabled                          false -r--   ConfigurationAuditType                       none -r--   ConfigurationVersion                         9.0.0.0 -r--   ConsoleContextPath                           console -r--   ConsoleEnabled                               true -r--   ConsoleExtensionDirectory                    console-ext -r--   DomainVersion                                9.0.0.0 -r--   LastModificationTime                         0 -r--   Name                                         basicWLSDomain -r--   Notes                                        null -r--   Parent                                       null -r--   ProductionModeEnabled                        false -r--   RootDirectory                                . -r--   Type                                         Domain wls:/mydomain/serverConfig>

下面的示例显示 Servers MBean 中的所有子 Bean、特性名称和特性值:

wls:/mydomain/serverConfig> ls(‘Servers‘) dr--   AdminServer

下面的示例显示指定 MBean 路径的特性名称和特性值,并以表的形式返回信息:

wls:/mydomain/serverConfig> svrAttrList = ls(‘edit:/Servers/myserver‘, ‘true‘, ‘a‘) -rw-   AcceptBacklog                                50 -rw-   AdminReconnectIntervalSeconds                10 -rw-   AdministrationPort                           9002 -rw-   AdministrationProtocol                       t3s -rw-   AutoKillIfFailed                             false -rw-   AutoMigrationEnabled                         false -rw-   AutoRestart                                  true -rw-   COMEnabled                                   false -rw-   ClasspathServletDisabled                     false -rw-   ClientCertProxyEnabled                       false -rw-   Cluster                                      null -rw-   ClusterRuntime                               null -rw-   ClusterWeight                                100 wls:/mydomain/serverConfig>

man

命令类别:信息命令 用于 WLST:联机版

描述

为当前 MBean 或其指定特性显示来自 MBeanInfo 的帮助。在出现错误的情况下,此命令将返回 WLSTException

语法

man([attrName])

参数
定义
attrName
可选。要为其显示帮助的 MBean 特性名称。如果未指定,则 WLST 将显示当前 MBean 的帮助。

 

示例

下面的示例为 ServerMBean Bean 显示来自 MBeanInfo 的帮助。

wls:/mydomain/serverConfig> man(‘Servers‘) dynamic : true creator : createServer destroyer : destroyServer description : <p>Returns the ServerMBeans representing the servers that have been configured to be part of this domain.</p> descriptorType : Attribute Name : Servers interfaceClassName : [Lweblogic.management.configuration.ServerMBean; displayName : Servers relationship : containment

redirect

命令类别:信息命令 用于 WLST:联机版或脱机版

描述

将 WLST 信息、错误和调试消息重定向到指定的文件名。也可以将 dumpStack() 和 dumpVariables() 命令的输出重定向到指定的文件名。

在出现错误的情况下,此命令将返回 WLSTException

语法

redirect(outputFile, [toStdOut])

参数
定义
outputFile
要在其中记录 WLST 命令的文件名。文件名可以使用绝对路径,也可以使用相对于您从中启动 WLST 的目录的相对路径。
toStdOut
可选。这是一个布尔值,它指定是否将输出发送到 stdout。此参数默认为 true,表示输出将被发送到 stdout

 

示例

下面的示例开始将 WLST 输出重定向到 logs/wlst.log 文件:

wls:/mydomain/serverConfig> redirect(‘./logs/wlst.log‘)

removeListener

命令类别:信息命令 用于 WLST:联机版

描述

删除以前定义的监听器。如果不指定参数,则 WLST 将删除为所有 MBean 定义的所有监听器。有关设置监听器的详细信息,请参阅 addListener。

在出现错误的情况下,此命令将返回 WLSTException

语法

removeListener([mbean], [listenerName])

参数
定义
mbean
可选。要为其删除先前已定义的监听器的 MBean 或 MBean 对象的名称。
listenerName
可选。要删除的监听器的名称。

 

示例

下面的示例删除名为 mylistener 的监听器。

wls:/mydomain/serverConfig> removeListener(listenerName="mylistener")

showListeners

命令类别:信息命令 用于 WLST:联机版

描述

显示当前定义的所有监听器。有关设置监听器的详细信息,请参阅 addListener。

在出现错误的情况下,此命令将返回 WLSTException

语法

showListeners()

示例

下面的示例显示当前定义的所有监听器。

wls:/mydomain/serverConfig> showListeners()

startRecording

命令类别:信息命令 用于 WLST:联机版或脱机版

描述

记录所有用户与 WLST 的交互。此命令对于捕获用于重播的命令非常有用。

在出现错误的情况下,此命令将返回 WLSTException

将 WLST 导入为 Jython 模块时,不能使用此命令,如将 WLST 导入为 Jython 模块中所述。

语法

startRecording(recordFile, [recordAll])

参数
定义
recordFile
要在其中记录 WLST 命令的文件名。文件名可以使用绝对路径,也可以使用相对于您从中调用 WLST 的目录的相对路径。
recordAll
可选。这是一个布尔值,它指定是否在文件中捕获所有的用户交互。此参数默认为 false,表示仅捕获 WLST 命令而不捕获 WLST 命令输出。

 

示例

下面的示例开始在 record.py 文件中记录 WLST 命令:

wls:/mydomain/serverConfig> startRecording(‘c:/myScripts/record.py‘) Starting recording to c:/myScripts/record.py wls:/mydomain/serverConfig>

state

命令类别:信息命令 用于 WLST:联机版

描述

使用节点管理器,返回服务器或群集及其状态的列表。节点管理器必须正在运行。

有关服务器状态的详细信息,请参阅“管理服务器启动和关闭”中的了解服务器生命周期。

在出现错误的情况下,此命令将返回 WLSTException

语法

state(name, [type])

参数
定义
name
要检索其当前状态的服务器或群集的名称。
type
可选。类型,Server 或 Cluster。此参数默认为 Server。当返回群集的状态时,必须将此参数显式设置为 Cluster,否则命令将失败。

 

示例

下面的示例中返回受管服务器 managed1 的状态。

wls:/mydomain/serverConfig> state(‘managed1‘,‘Server‘) Current state of "managed1": SUSPENDED wls:/mydomain/serverConfig>

下面的示例将返回群集 mycluster 的状态。

wls:/mydomain/serverConfig> state(‘mycluster‘,‘Cluster‘) There are 3 server(s) in cluster: mycluster
States of the servers are MServer1---SHUTDOWN MServer2---SHUTDOWN MServer3---SHUTDOWN wls:/mydomain/serverConfig>

stopRecording

命令类别:信息命令 用于 WLST:联机版或脱机版

描述

停止记录 WLST 命令。有关启动记录的信息,请参阅 startRecording。

在出现错误的情况下,此命令将返回 WLSTException

语法

stopRecording()

示例

下面的示例停止记录 WLST 命令。

wls:/mydomain/serverConfig> stopRecording() Stopping recording to c:\myScripts\record.py wls:/mydomain/serverConfig>

stopRedirect

命令类别:信息命令 用于 WLST:联机版或脱机版

描述

如果重定向正在进行中,则停止将 WLST 输出重定向到文件。

在出现错误的情况下,此命令将返回 WLSTException

语法

stopRedirect()

示例

下面的示例停止将 WLST 输出重定向到文件:

wls:/mydomain/serverConfig> stopRedirect() WLST output will not be redirected to myfile.txt any more

storeUserConfig

命令类别:信息命令 用于 WLST:联机版

描述

创建用户配置文件和相关联的密钥文件。用户配置文件包含加密后的用户名和密码。密钥文件包含用于加密和解密用户名和密码的密钥。

只有用于最初加密用户名和密码的密钥文件才可用于解密这些值。如果丢失了密钥文件,则必须新建用户配置文件和密钥文件对。

在出现错误的情况下,此命令将返回 WLSTException

语法

storeUserConfig([userConfigFile], [userKeyFile], [nm])

参数
定义
userConfigFile
可选。用于存储用户配置的文件名。路径名可以是绝对路径,也可以是相对于您启动 WLST 的文件系统目录的相对路径。
如果不指定此参数,此命令就将文件存储在由 JVM 确定的主目录中。主目录的位置取决于 SDK 和运行 WLST 的操作系统的类型。默认文件名基于以下模式: username-WebLogicConfig.properties  ,其中的 username 是您用来登录操作系统的用户名。
此命令也将文件创建位置输出到标准输出中。
userKeyFile
可选。用于存储与指定的用户配置文件相关联的密钥信息的文件名。路径名可以是绝对路径,也可以是相对于您启动 WLST 的文件系统目录的相对路径。
如果不指定此参数,此命令就将文件存储在由 JVM 确定的主目录中。主目录的位置取决于 SDK 和运行 WLST 的操作系统的类型。默认文件名基于以下模式: username-WebLogicKey.properties  ,其中 username 是您用来登录操作系统的用户名。
此命令也将文件创建位置输出到标准输出中。
nm
可选。布尔值,指定是否存储节点管理器或 WebLogic Server 的用户名和密码。如果设置为 true,则存储节点管理器的用户名和密码。此参数默认为 false

 

示例

下面的示例在默认位置创建和存储用户配置文件和密钥文件。

wls:/mydomain/serverConfig>  storeUserConfig() Creating the key file can reduce the security of your system if it is not kept in a secured location after it is created.Do you want to create the key file? y or n y The username and password that were used for this current WLS connection are stored in stored in C:\Documents and Settings\pat\pat-WebLogicConfig.properties and C:\Documents and Settings\pat\pat-WebLogicKey.properties.

下面的示例在指定位置创建和存储用户配置文件和密钥文件。

wls:/mydomain/serverConfig>  storeUserConfig(‘c:/myFiles/myuserconfigfile.secure‘, ‘c:/myFiles/myuserkeyfile.secure‘) Creating the key file can reduce the security of your system if it is not kept in a secured location after it is created.Do you want to create the key file? y or n y The username and password that were used for this current WLS connection are stored in c:/myFiles/mysuserconfigfile.secure and c:/myFiles/myuserkeyfile.secure wls:/mydomain/serverConfig>

threadDump

命令类别:信息命令 用于 WLST:联机版或脱机版

描述

显示指定服务器的线程转储。在出现错误的情况下,此命令将返回 WLSTException

语法

threadDump([writeToFile], [fileName], [serverName])

参数
定义
writeToFile
可选。这是一个布尔值,它指定是否将输出保存到文件。此参数默认为 true,表示将输出保存到文件。
fileName
可选。将输出写入到的文件的名称。文件名可以使用绝对路径,也可以使用相对于正在运行 WLST 的目录的相对路径。此参数默认为 Thread_Dump_serverName 文件,其中 serverName 表示服务器的名称。仅在将 writeToFile 设置为 true 时,此参数才有效。
serverName
可选。要为其请求线程转储的服务器的名称。此参数默认为 WLST 要连接到的服务器。
如果连接到管理服务器,则可显示管理服务器和任何正在域中运行的受管服务器的线程转储。如果连接到受管服务器,则仅能显示此受管服务器的线程转储。

 

示例

下面的示例显示当前服务器的线程转储并将输出保存到 Thread_Dump_serverName 文件。

wls:/mydomain/serverConfig> threadDump()

下面的示例显示服务器 managedServer 的线程转储。此信息不保存到文件。

wls:/mydomain/serverConfig> threadDump(writeToFile=‘false‘, serverName=‘managedServer‘)

viewMBean

命令类别:信息命令 用于 WLST:联机版

描述

显示有关 MBean 的信息,例如特性名称、特性值和操作。在出现错误的情况下,此命令将返回 WLSTException

语法

viewMBean(mbean)

参数
定义
mbean
要显示其信息的 MBean。

 

示例

下面的示例显示有关当前 MBean cmo 的信息。

wls:/mydomain/serverConfig> cmo.getType() `Domain‘ wls:/mydomain/serverConfig> viewMBean(cmo) Attribute Names and Values -------------------------- XMLEntityCaches   null Targets   javax.management.ObjectName[com.bea :Name=MedRecJMSServer,Type=JMSServer,    com.bea:Name=WSStoreForwardInternalJMSServerMedRecServer,Type=JMSServer,     com.bea:Name=MedRecWseeJMSServer,Type=JMSServer,    com.bea:Name=PhysWSEEJMSServer,Type=JMSServer,     com.bea:Name=MedRecSAFAgent,Type=SAFAgent,     com.bea:Name=AdminServer,Type=Server] RootDirectory                                . EmbeddedLDAP                                 com.bea:Name=OOTB_medrec,Type=EmbeddedLDAP RemoteSAFContexts  null Libraries   javax.management.ObjectName[com.bea ... wls:/mydomain/serverConfig>

writeIniFile

命令类别:编辑命令 用于 WLST:联机版

描述

将 WLST 定义和方法声明转换为 Python (.py) 文件,使高级用户能够将其作为 Jython 模块导入。导入之后,这些定义和方法声明可用于其他 Jython 模块,且可直接使用 Jython 语法来访问。有关详细信息,请参阅将 WLST 导入为 Jython 模块

在出现错误的情况下,此命令将返回 WLSTException

语法

writeIniFile(filePath)

参数
定义
filePath
要保存已转换信息的文件的完整路径名。

 

示例

下面的示例将 WLST 转换为名为 wl.py 的 Python 文件。

wls:/offline> writeIniFile("wl.py") The Ini file is successfully written to wl.py wls:/offline> 

 


生命周期命令

使用在表 A-9 中列出的 WLST 生命周期命令管理服务器实例的生命周期。

有关服务器实例的生命周期的详细信息,请参阅“管理服务器启动和关闭”中的了解服务器生命周期。

表 A-9 用于 WLST 配置的生命周期命令
命令...
可以...
用于 WLST...
migrate
将服务迁移到群集中的目标服务器。
联机版
resume
恢复处于挂起或 ADMIN 状态的服务器实例。
联机版
shutdown
正常关闭正在运行的服务器实例或群集。
联机版
start
使用节点管理器启动受管服务器实例或群集。
联机版
startServer
启动管理服务器。
联机版或脱机版
suspend
挂起正在运行的服务器。
联机版

 

migrate

命令类别:生命周期命令 用于 WLST:联机版

描述

将指定的服务(JTA、JMS 或服务器)迁移到群集内的目标服务器。在出现错误的情况下,此命令将返回 WLSTException

有关迁移服务的信息,请参阅“使用 WebLogic Server 群集”中的服务级迁移。

语法

migrate(sname, destinationName, [sourceDown], [destinationDown], [migrationType])
                                               
参数
定义
sname
从中迁移服务的服务器的名称。
destinationName
服务迁移到的计算机或服务器的名称。
sourceDown
可选。布尔值,用于指定源服务器是否处于关闭状态。此参数默认为 true,表示源服务器未在运行。
在迁移 JTA 服务时,即使指定了 sourceDown 参数,也会忽略它,并且默认为 true。源服务器必须处于关闭状态,才能将 JTA 服务迁移成功。
destinationDown
可选。 布尔值,用于指定目标服务器是否处于关闭状态。此参数默认为 false,表示目标服务器未在运行。
如果目标未在运行,并且您未将此参数设置为 true,则 WLST 将返回 MigrationException
在将 JMS 相关的服务迁移到未正在运行的服务器实例时,此服务器实例就会在下一次启动时激活 JMS 服务。在将 JTA 事务恢复服务迁移到未在运行的服务器实例时,此目标服务器实例在其启动时将进行恢复服务。
migrationType
可选。要迁移的服务的类型。有效值包括:
  • jms - 只迁移 JMS 相关的服务(JMS 服务器、SAF 代理、路径服务和 WebLogic 持久性存储)。
  • jta - 仅迁移 JTA 服务。
  • server - 仅迁移服务器服务。
  • all - 迁移所有 JTA 和 JMS 服务。
此参数默认为 all

示例

下面的示例将 server1 上的所有 JMS 和 JTA 服务迁移到服务器 server2。布尔参数指定源服务器已关闭而目标服务器正在运行。

wls:/mydomain/edit !> migrate(‘server1‘,‘server2‘, ‘true‘, ‘false‘, ‘all‘) Migrating all JMS and JTA services from ‘server1‘ to destination `server2‘ ... wls:/mydomain/edit !>

下面的示例将 server1 上的所有服务器服务迁移到服务器 server2。布尔参数指定源服务器已关闭而目标服务器正在运行。

wls:/mydomain/edit !> migrate(‘server1‘,‘server2‘, ‘true‘, ‘false‘, ‘Server‘) Migrating singleton server services from ‘server1‘ to machine ‘server2‘... wls:/mydomain/edit !>

resume

命令类别:生命周期命令 用于 WLST:联机版

描述

恢复处于挂起或 ADMIN 状态的服务器实例。此命令将服务器更改为 RUNNING 状态。有关服务器状态的详细信息,请参阅“管理服务器启动和关闭”中的了解服务器生命周期。

在出现错误的情况下,此命令将返回 WLSTException

语法

resume([sname], [block])

参数
定义
sname
要恢复的服务器的名称。此参数默认为 WLST 当前所连接的服务器。
block
可选。布尔值,指定 WLST 是否应在恢复服务器之前一直阻止用户交互。此参数默认为 false,表示不会阻止用户交互。在这种情况下,WLST 将在执行命令后把控制权返回给用户,并将与当前任务相关联的任务 MBean 分配到一个能够用于检查此参数状态的变量。如果要将 WLST 导入为 Jython 模块(如将 WLST 导入为 Jython 模块中所述),block 将始终设置为 true

 

示例

下面的示例恢复受管服务器实例。

wls:/mydomain/serverConfig> resume(‘managed1‘, block=‘true‘) Server ‘managed1‘ resumed successfully. wls:/mydomain/serverConfig>

shutdown

命令类别:生命周期命令 用于 WLST:联机版

描述

正常关闭正在运行的服务器实例或群集。shutdown 命令在关闭服务器或群集之前,会等待到所有进行中的工作都完成。

通过输入不带任何参数的 shutdown 命令,可以关闭 WLST 所连接的服务器。

当连接到受管服务器实例时,只能使用 shutdown 命令关闭 WLST 所连接的受管服务器实例,而不能在连接到受管服务器实例的情况下关闭其他服务器。

WLST 使用节点管理器关闭受管服务器。在关闭受管服务器时,节点管理器必须正在运行。

在出现错误的情况下,此命令将返回 WLSTException

语法

shutdown([name], [entityType], [ignoreSessions], [timeOut], [force], [block])

参数
定义
name
可选。要关闭的服务器或群集的名称。此参数默认为 WLST 当前所连接的服务器。
entityType
可选。类型,Server 或 Cluster。此参数默认为 Server。当关闭群集时,必须将此参数明确设置为 Cluster,否则命令将失败。
ignoreSessions
可选。Boolean 值指定 WLST 是否应立即结束所有 HTTP 会话,或是等待 HTTP 会话的结束或超时。该参数默认设置为 false,表示所有 HTTP 会话的结束或超时。
timeOut
可选。WLST 等待子系统完成正在进行的工作而在关闭服务器之前将自身挂起的时间(秒)。此参数默认为 0 秒,表示不存在超时。
force
可选。布尔值,指定 WLST 是否不等待活动的会话结束,就终止服务器实例或群集。此参数默认为 false,表示在关闭前必须结束所有的活动会话。
block
可选。这是一个布尔值,它指定 WLST 是否应在关闭服务器之前,持续阻止用户交互。此参数默认为 false,表示不会阻止用户交互。在这种情况下,WLST 将在执行命令后把控制权返回给用户,并将与当前任务相关联的任务 MBean 分配到一个能够用于检查此参数状态的变量。如果要将 WLST 导入为 Jython 模块(如将 WLST 导入为 Jython 模块中所述),block 将始终设置为 true

 

示例

下面的示例命令 WLST 关闭所连接的服务器:

wls:/mydomain/serverConfig> shutdown() Shutting down the admin server that you are currently connected to ....... Disconnected from weblogic server: AdminServer

下面的示例命令 WLST 在关闭 myserver 前为 HTTP 会话的结束或超时 (1000 ms) 等待 1000 秒:

wls:/mydomain/serverConfig> shutdown(‘myserver‘,‘Server‘,‘false‘,1000, block=‘false‘)

下面的示例命令 WLST 在连接到受管服务器实例时立即结束所有 HTTP 会话:

wls:/mydomain/serverConfig> shutdown(‘MServer1‘,‘Server‘,‘true‘,1200) Shutting down a managed server that you are connected to ... Disconnected from weblogic server: MServer1

下面的示例命令 WLST 关闭群集 mycluster

wls:/mydomain/serverConfig> shutdown(‘mycluster‘,‘Cluster‘) Shutting down the cluster with name mycluster Shutdown of cluster mycluster has been issued, please  refer to the logs to check if the cluster shutdown is successful. Use the state(<server-name>) or state(<cluster-name>,"Cluster") to check the status of the server or cluster wls:/mydomain/serverConfig> state(‘mycluster‘,‘Cluster‘) There are 3 server(s) in cluster: mycluster
States of the servers are MServer1---SHUTDOWN MServer2---SHUTDOWN MServer3---SHUTDOWN wls:/mydomain/serverConfig>

start

命令类别:生命周期命令 用于 WLST:联机版

描述

使用节点管理器启动受管服务器实例或群集。WLST 必须连接到管理服务器且节点管理器必须正在运行。

有关用于连接的 WLST 命令和使用节点管理器的详细信息,请参阅节点管理器命令。

在出现错误的情况下,此命令将返回 WLSTException

语法

start(name, [type], [url], [block])

参数
定义
name
要启动的受管服务器或群集的名称。
type
可选。类型,Server 或 Cluster。此参数默认为 Server。当启动群集时,必须将此参数明确设置为 Cluster,否则命令将失败。
url
可选。服务器实例的监听地址和监听端口,通过以下格式指定:[protocol://]listen-address:listen-port。如果未指定,则此参数默认为 t3://localhost:7001
block
可选。这是一个布尔值,它指定 WLST 是否应在启动服务器或群集之前,持续阻止用户交互。此参数默认为 false,表示不会阻止用户交互。在这种情况下,WLST 将在执行命令后把控制权返回给用户,并将与当前任务相关联的任务 MBean 分配到一个能够用于检查此参数状态的变量。如果要将 WLST 导入为 Jython 模块(如将 WLST 导入为 Jython 模块中所述),block 将始终设置为 true

 

示例

下面的示例命令节点管理器启动受管服务器实例;监听地址为 localhost,监听端口为 8801。因为将 block 设置为 false,所以 WLST 发出此命令后将返回对用户的控制。

wls:/mydomain/serverConfig> start(‘myserver‘, ‘Server‘, block=‘false‘) Starting server myserver ... Server with name myserver started successfully. wls:/mydomain/serverConfig>

下面的示例命令节点管理器启动群集。因为 block 默认为 true,所以在启动群集之前,WLST 会持续阻止用户交互。

wls:/mydomain/serverConfig> start(‘mycluster‘, ‘Cluster‘) Starting the following servers in Cluster, mycluster: MS1, MS2, MS3... ...................................................................... All servers in the cluster mycluster are started successfully. wls:/mydomain/serverConfig>

startServer

命令类别:生命周期命令 用于 WLST:联机版或脱机版

描述

启动管理服务器。在出现错误的情况下,此命令将返回 WLSTException

语法

startServer([adminServerName], [domainName], [url], [username], [password], [domainDir], [block], [timeout], [serverLog], [systemProperties], [jvmArgs])

参数
定义
adminServerName
可选。要启动的管理服务器的名称。此参数默认为 myserver
domainName
可选。管理服务器所属的域的名称。此参数默认为 mydomain
url
可选。管理服务器的 URL。此参数默认为 t3://localhost:7001
username
可选。用于将 WLST 连接到服务器的用户名。此参数默认为 weblogic
password
可选。用于将 WLST 连接到服务器的密码。此参数默认为 weblogic
domainDir
可选。正在其中启动管理服务器的域目录。此参数默认为从中启动 WLST 的目录。
block
可选。这是一个布尔值,它指定 WLST 是否在启动服务器之前,持续阻止用户交互。当 block 设置为 false 时,WLST 在发出命令后将返回对用户的控制,并将与当前任务相关联的任务 MBean 分配到一个变量,使用此变量可以检查服务器的状态。此参数默认为 true,表示阻止用户交互。如果要将 WLST 导入为 Jython 模块(如将 WLST 导入为 Jython 模块中所述),block 将始终设置为 true
timeout
可选。WLST 在取消此操作前所等待的启动服务器的时间(毫秒)。默认值为 60000 毫秒。仅在将 block 设置为 true 时,此参数才适用。
serverLog
可选。服务器日志文件的位置。此参数默认为 stdout
systemProperties
可选。传递给服务器进程的系统属性。应将系统属性指定为以逗号分隔的“名称 - 值”对的形式,其中“名称”和“值”之间应以等号 (=) 分隔。
jvmArgs
可选。传递给服务器进程的 JVM 参数。可以用逗号分隔指定多个参数。

 

示例

下面的示例在 demoDomain 中启动名为 demoServer 的管理服务器。

wls:/offline> startServer(‘demoServer‘,‘demoDomain‘,‘t3://localhost:8001‘, ‘myweblogic‘,‘wlstdomain‘,‘c:/mydomains/wlst‘,‘false‘, 60000, jvmArgs=‘-XX:MaxPermSize=75m, -Xmx512m, -XX:+UseParallelGC‘) wls:/offline>

suspend

命令类别:生命周期命令 用于 WLST:联机版

描述

挂起正在运行的服务器。此命令将服务器从 RUNNING 状态更改为 ADMIN 状态。有关服务器状态的详细信息,请参阅“管理服务器启动和关闭”中的了解服务器生命周期。

在出现错误的情况下,此命令将返回 WLSTException

语法

suspend([sname], [ignoreSessions], [timeOut], [force], [block])

参数
定义
sname
可选。要挂起的服务器的名称。此参数默认为 WLST 当前所连接的服务器。
ignoreSessions
可选。这是一个布尔值,它指定在执行挂起命令时,WLST 是否应立即结束所有 HTTP 会话,或是等待 HTTP 会话的结束或超时。此参数默认为 false,表示必须等待 HTTP 会话的结束或超时。
timeOut
可选。挂起服务器之前,WLST 等待服务器结束正在进行的工作的时间(秒)。此参数默认为 0 秒,表示不存在超时。
force
可选。这是一个布尔值,它指定 WLST 是否应在不等待活动会话结束的情况下挂起服务器。此参数默认为 false,表示在挂起服务器之前必须结束所有的活动会话。
block
可选。这是一个布尔值,它指定 WLST 是否在启动服务器之前,持续阻止用户交互。此参数默认为 false,表示不会阻止用户交互。在这种情况下,WLST 将在执行命令后把控制权返回给用户,并将与当前任务相关联的任务 MBean 分配到一个能够用于检查此参数状态的变量。如果要将 WLST 导入为 Jython 模块(如将 WLST 导入为 Jython 模块中所述),block 将始终设置为 true

 

示例

下面的示例挂起受管服务器实例:

wls:/mydomain/serverConfig> suspend(‘managed1‘) Server ‘managed1‘ suspended successfully. wls:/mydomain/serverConfig>

 


节点管理器命令

使用表 A-10 中列出的 WLST 节点管理器命令启动、关闭、重新启动和监视 WebLogic Server 实例。

在执行此类别的命令之前,节点管理器必须正在运行。

有关节点管理器的详细信息,请参阅“管理服务器启动和关闭”中的使用节点管理器控制服务器。

nm

命令类别:节点管理器命令 用于 WLST:联机版或脱机版

描述

确定 WLST 是否已连接到节点管理器。返回 true 或 false,并打印描述性消息。在执行此命令之前,节点管理器必须正在运行。

在出现错误的情况下,此命令将返回 WLSTException

语法

nm()

示例

下面的示例 WLST 当前已连接到正在监视 mydomain 的节点管理器。

wls:/mydomain/serverConfig> nm() Currently connected to Node Manager that is monitoring the domain "mydomain" wls:/mydomain/serverConfig>

下面的示例 WLST 当前未连接到节点管理器。

wls:/mydomain/serverConfig> nm() Not connected to any Node Manager wls:/mydomain/serverConfig>

nmConnect

命令类别:节点管理器命令 用于 WLST:联机版或脱机版

描述

将 WLST 连接到节点管理器以便建立会话。连接到节点管理器之后,可以通过 WLST 调用任何节点管理器命令。在执行此命令之前,节点管理器必须正在运行。

一旦连接后,WLST 将提示显示如下内容,其中 domainName 表示正受到管理的域的名称:wls:/nm/domainName>。如果转为将 WLST 连接到 WebLogic Server 实例,则提示会更改为反映 WebLogic Server 实例。可使用 nm 命令确定 WLST 是否已连接到节点管理器,有关描述可参阅 nm。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmConnect([username, password], [host], [port], [domainName], [domainDir] [nmType], [verbose])

nmConnect([userConfigFile, userKeyFile], [host], [port], [domainName], [domainDir] [nmType], [verbose])

参数
定义
username
将 WLST 连接到节点管理器的操作员的用户名。此参数默认为 weblogic

注意:当服务器在生产模式下运行时,必须在命令行上明确指定用户名和密码,确保在连接到节点管理器时使用正确的用户名和密码。

 

password
将 WLST 连接到节点管理器的操作员的密码。此密码默认为 weblogic

注意:当服务器在生产模式下运行时,必须在命令行上明确指定用户名和密码,确保在连接到节点管理器时使用正确的用户名和密码。

 

host
可选。节点管理器的主机名。此参数默认为 localhost
port
可选。节点管理器的端口号。此参数的默认值基于节点管理器的服务器类型,如下所示:
  •  对于 plain 类型,端口号默认为 5556
  •  对于 rsh 类型,端口号默认为 514
  •  对于 ssh 类型,端口号默认为 22
  •  对于 ssl 类型,端口号默认为 5556
domainName
可选。要管理的域的名称。此参数默认为 mydomain
domainDir
可选。要在其中保存节点管理器的机密文件 (nm_password.properties) 和 SerializedSystemIni.dat 文件的域目录的路径。此参数默认为 WLST 的启动目录。
nmType
节点管理器的服务器类型。有效值包括:
  •  对于基于 Java 的常规套接口实现,类型为 plain
  •  对于 RSH 实现,类型为 rsh
  •  对于基于脚本的 SSH 实现,类型为 ssh
  •  对于基于 Java 的 SSL 实现,类型为 ssl
此参数默认为 ssl
verbose
可选。这是一个布尔值,它指定 WLST 是否以详细模式连接到节点管理器。此参数默认为 false,表示禁用详细模式。
userConfigFile
可选。包含加密用户名和密码的用户配置文件的名称和位置。
当创建用户配置文件时,storeUserConfig 命令将使用密钥文件对用户名和密码进行加密。只有对用户配置文件进行加密的密钥文件才可以解密用户名和密码。(请参阅 storeUserConfig。)
userKeyFile
可选。密钥文件的名称和位置,此密钥文件与指定的用户配置文件相关联并用于对其进行解密。(请参阅 storeUserConfig。)

 

示例

下面的示例使用默认的主机、端口号及 plain 节点管理器类型,将 WLST 连接到节点管理器以便监视 oamdomain 域。

wls:/myserver/serverConfig> nmConnect(‘weblogic‘, ‘weblogic‘, ‘localhost‘, ‘5555‘, ‘oamdomain‘, ‘c:/bea/user_projects/domains/oamdomain‘,‘plain‘) Connecting to Node Manager Server ... Successfully connected to Node Manager. wls:/nm/oamdomain>

下面的示例通过使用用户配置文件和密钥文件提供用户凭据,将 WLST 连接到节点管理器服务器实例。

wls:/myserver/serverConfig>nmConnect(userConfigFile=‘c:/myfiles/myuserconfigfile.secure‘, userKeyFile=‘c:/myfiles/myuserkeyfile.secure‘,  host=‘172.18.137.82‘, port=26106, domainName=‘mydomain‘,  domainDir=‘c:/myfiles/mydomain‘, mType=‘plain‘)

Connecting to Node Manager Server ... Successfully connected to Node Manager. wls:/nm/mydomain>

nmDisconnect

命令类别:节点管理器命令 用于 WLST:联机版或脱机版 要运行此命令必须将 WLST 连接到节点管理器。

描述

断开 WLST 和节点管理器会话之间的连接。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmDisconnect()

示例

下面的示例断开 WLST 和节点管理器会话之间的连接。

wls:/nm/oamdomain> nmDisconnect() Successfully disconnected from Node Manager wls:/myserver/serverConfig>

nmEnroll

命令类别:节点管理器命令 用于 WLST:联机版

描述

注册当前正在运行 WLST 的计算机。要运行此命令,WLST 必须连接到管理服务器;WLST 无需连接到节点管理器。

此命令将从管理服务器中下载以下文件:

  •  节点管理器机密文件 (nm_password.properties),此文件包含用于服务器身份验证的加密用户名和密码
  •  SerializedSystemIni.dat 文件

此命令还将更新 WL_HOME/common/nodemanager 目录下 nodemanager.domains 文件中的域信息,其中 WL_HOME 指 WebLogic Server 的上一级安装目录。

您必须在每台计算机的每个域中运行该命令一次,但共享管理服务器根目录的域除外。

如果运行此命令时,此计算机已注册,则刷新节点管理器机密文件 (nm_password.properties) 以便获得管理服务器的最新信息。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmEnroll([domainDir], [nmHome])

参数
定义
domainDir
可选。要在其中保存节点管理器的机密文件 (nm_password.properties) 和 SerializedSystemIni.dat 文件的域目录的路径。此参数默认为 WLST 的启动目录。
nmHome
可选。节点管理器主目录的路径。包含域信息的 nodemanager.domains 文件将写入此目录中。此参数默认为 WL_HOME/common/nodemanager,其中 WL_HOME 指 WebLogic Server 的上一级安装目录。

 

示例

下面的示例注册连接到节点管理器的当前计算机,并将节点管理器机密文件 (nm_password properties) 和 SerializedSystemIni.dat 文件保存到c:/bea/mydomain/common/nodemanager/nm_password.properties。默认情况下,nodemanager.domains 文件将写入 WL_HOME/common/nodemanager

wls:/mydomain/serverConfig> nmEnroll(‘c:/bea/mydomain/common/nodemanager‘) Enrolling this machine with the domain directory at c:\bea\mydomain\common\nodemanager.... Successfully enrolled this machine with the domain directory at C:\bea\mydomain\common\nodemanager wls:/mydomain/serverConfig>

nmGenBootStartupProps

命令类别:节点管理器命令 用于 WLST:联机版

描述

为指定的服务器生成节点管理器属性文件 boot.properties 和 startup.properties。节点管理器的属性文件相对于指定服务器的根目录存储。目标根目录所在的计算机必须与运行此命令的计算机是同一台计算机。

必须指定服务器名称,否则,此命令将失败。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmGenBootStartupProps(serverName)

参数
定义
serverName
为其生成节点管理器属性文件的服务器的名称。

 

示例

下面的示例在指定服务器 ms1 的根目录中生成 boot.properties 和 startup.properties

wls:/mydomain/serverConfig> nmGenBootStartupProps(‘ms1‘) Successfully generated boot.properties at c:\bea\mydomain\servers\ms1\data\nodemanager\boot.properties Successfully generated startup.properties at c:\bea\mydomain\servers\ms1\data\nodemanager\startup.properties wls:/mydomain/serverConfig>

nmKill

命令类别:节点管理器命令 用于 WLST:联机版或脱机版 要运行此命令必须将 WLST 连接到节点管理器。

描述

取消使用节点管理器启动的指定的服务器实例。

如果未使用 serverName 参数指定服务器名称,则此参数默认为 myServer,它必须与您的服务器名称相匹配,否则命令将失败。

如果试图取消不是使用节点管理器启动的服务器实例,则命令将显示出错。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmKill([serverName])

参数
定义
serverName
可选。要取消的服务器的名称。此参数默认为 myserver

 

示例

下面的示例取消名为 oamserver 的服务器。

wls:/nm/oamdomain> nmKill(‘oamserver‘) Killing server `oamserver‘ ... Server oamServer killed successfully. wls:/nm/oamdomain>

nmLog

命令类别:节点管理器命令 用于 WLST:联机版或脱机版 要运行此命令必须将 WLST 连接到节点管理器。

描述

返回节点管理器日志。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmLog([writer])

参数
定义
writer
可选。java.io.Writer object to which you want to stream the log output. 此参数默认为 WLST 编写器流。

 

示例

下面的示例显示节点管理器日志。

wls:/nm/oamdomain> nmLog() Successfully retrieved the Node Manager log and written. wls:/nm/oamdomain>

nmServerLog

命令类别:节点管理器命令 用于 WLST:联机版或脱机版 要运行此命令必须将 WLST 连接到节点管理器。

描述

返回使用节点管理器启动的服务器的输出日志。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmServerLog([serverName], [writer])

参数
定义
serverName
可选。要显示其输出日志的服务器的名称。此参数默认为 myserver
writer
可选。java.io.Writer object to which you want to stream the log output. 如果未指定,则此参数默认为 WLSTInterpreter 标准输出。

 

示例

下面的示例显示服务器 oamserver 的输出日志并将日志输出写入到 myWriter

wls:/nm/oamdomain> nmServerLog(‘oamserver‘,myWriter) Successfully retrieved the server log and written. wls:/nm/oamdomain> 

nmServerStatus

命令类别:节点管理器命令 用于 WLST:联机版或脱机版 要运行此命令必须将 WLST 连接到节点管理器。

描述

返回使用节点管理器启动的服务器的状态。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmServerStatus([serverName])

参数
定义
serverName
可选。要显示其状态的服务器的名称。此参数默认为 myserver

 

示例

下面的示例显示使用节点管理器启动的名为 oamserver 的服务器的状态。

wls:/nm/oamdomain> nmServerStatus(‘oamserver‘) RUNNING wls:/nm/oamdomain>

nmStart

命令类别:节点管理器命令 用于 WLST:联机版或脱机版 要运行此命令必须将 WLST 连接到节点管理器。

描述

使用节点管理器在当前域中启动服务器。

在出现错误的情况下,此命令将返回 WLSTException

注意:为了使用 nmStart 启动服务器,boot.properties 必须存在。如果这是您第一次启动服务器,则必须进行手工创建以使用 nmStart。

语法

nmStart([serverName], [domainDir], [props], [writer])

参数
定义
serverName
可选。要启动的服务器的名称。
domainDir
可选。要启动的服务器的域目录。此参数默认为从中启动 WLST 的目录。
props
可选。适用于新服务器的系统属性。
writer
可选。java.io.Writer object to which the server output is written. 此参数默认为 WLST 编写器。

 

示例

下面的示例使用节点管理器在当前域中启动服务器 managed1

wls:/nm/mydomain> nmStart("managed1") Starting server managed1 ... Server managed1 started successfully wls:/nm/mydomain>

下面的示例使用节点管理器在指定的域中启动管理服务器。在此示例中,prps 变量存储系统属性设置,通过 props 参数可将此变量传递到命令中。

wls:/nm/mydomain> prps = makePropertiesObject("weblogic.ListenPort=8001") wls:/nm/mydomain> nmStart("AdminServer",props=prps)  Starting server AdminServer... Server AdminServer started successfully wls:/nm/mydomain>

nmVersion

命令类别:节点管理器命令 用于 WLST:联机版或脱机版 要运行此命令必须将 WLST 连接到节点管理器。

描述

返回节点管理器版本。

在出现错误的情况下,此命令将返回 WLSTException

语法

nmVersion()

示例

下面示例显示了节点管理器版本。

wls:/nm/oamdomain> nmVersion() The Node Manager version that you are currently connected to is 9.0.0.0 wls:/nm/oamdomain> 

startNodeManager

命令类别:节点管理器命令 用于 WLST:联机版或脱机版

描述

在运行 WLST 的相同计算机上启动节点管理器。

注意:WebLogic Server 自定义安装过程可以有选择的安装节点管理器,并将其作为 Windows 系统中的 Windows 服务来启动。有关详细信息,请参阅“BEA 产品安装指南”中的关于将节点管理器安装为 Windows 服务。在这种情况下,不需要手工启动节点管理器。

如果调用 startNodeManager 命令时,节点管理器已在运行,则会显示下列消息:

A Node Manager has already been started. Cannot start another Node Manager process via WLST

在出现错误的情况下,此命令将返回 WLSTException

语法

startNodeManager([verbose], [nmProperties])

参数
定义
verbose
可选。这是一个布尔值,它指定 WLST 是否以详细模式启动节点管理器。此参数默认为 false,表示禁用详细模式。
nmProperties
可选。以“名称 – 值”对形式指定的节点管理器属性的列表(以逗号分隔)。节点管理器属性包括但不限于以下内容:NodeManagerHomeListenAddressListenPort 和 PropertiesFile

 

示例

以下示例显示节点管理器服务器版本。

wls:/mydomain/serverConfig> startNodeManager(verbose=‘true‘, NodeManagerHome=‘c:/bea/wlserver_10.0/common/nodemanager‘, ListenPort=‘6666‘, ListenAddress=‘myhost‘)) Launching Node Manager ... Successfully launched the Node Manager. The Node Manager process is running independent of the WLST process Exiting WLST will not stop the Node Manager process. Please refer to the Node Manager logs for more information. The Node Manager logs will be under c:\bea\wlserver_10.0\common\nodemanager. wls:/mydomain/serverConfig> 

 


树命令

使用表 A-11 中列出的 WLST 树命令以便在 MBean 层次中导航。

表 A-11 用于 WLST 配置的树命令
使用此命令...
操作...
用于 WLST...
config
导航到配置 MBean 层次中您上一次导航到的 MBean,或导航到层次的根 DomainMBean

注意:自 WebLogic Server 9.0 开始,不赞成使用此命令。应更新您的脚本,以使用 serverConfig 命令,如 serverConfig 中所述。

 

联机版
custom
导航到在服务器中注册的自定义 MBean 的根。
联机版
domainConfig
导航到域配置层次中您上一次导航到的 MBean,或导航到层次的根 DomainMBean
联机版
domainRuntime
导航到域运行时层次中您上一次导航到的 MBean,或导航到层次的根 DomainRuntimeMBean
联机版
edit
导航到编辑配置 MBean 层次中您上一次导航到的 MBean,或导航到层次的根 DomainMBean
联机版
JNDI
导航到 WLST 当前所连接的服务器的 JNDI 树。
联机版
runtime
导航到运行时 MBean 层次中您上一次导航到的 MBean,或导航至此层次的根 DomainRuntimeMBean

注意:自 WebLogic Server 9.0 开始,不赞成使用此命令。应更新您的脚本,以使用 serverRuntime 命令,如 serverRuntime 中所述。

 

联机版
serverConfig
导航到配置 MBean 层次中您上一次导航到的 MBean,或导航到层次的根 DomainMBean
联机版
serverRuntime
导航到运行时 MBean 层次中您上一次导航到的 MBean,或导航至此层次的根 ServerRuntimeMBean
联机版

 

config

命令类别:树命令 用于 WLST:联机版

描述

注意:自 WebLogic Server 9.0 开始,不赞成使用此命令。应更新您的脚本,以使用 serverConfig 命令,如 serverConfig 中所述。

导航到配置 MBean 层次中您上一次导航到的 MBean,或导航到层次的根 DomainMBean。有关详细信息,请参阅在 MBean 层次中导航。

在出现错误的情况下,此命令将返回 WLSTException

语法

config()

示例

下面的示例说明如何在管理服务器实例上从运行时 MBean 层次导航到配置 MBean 层次:

wls:/mydomain/runtime> config() Location changed to config tree (deprecated).This is a writeable tree with DomainMBean as the root. For more help, use help(‘config‘) wls:/mydomain/config> ls() dr--   Applications dr--   BridgeDestinations dr--   Clusters dr--   DeploymentConfiguration dr--   Deployments dr--   DomainLogFilters dr--   EmbeddedLDAP dr--   JDBCConnectionPools dr--   JDBCDataSourceFactories dr--   JDBCDataSources dr--   JDBCMultiPools dr--   JDBCTxDataSources dr--   JMSBridgeDestinations dr--   JMSConnectionFactories dr--   JMSDestinationKeys dr--   JMSDestinations dr--   JMSDistributedQueueMembers dr--   JMSDistributedQueues dr--   JMSDistributedTopicMembers dr--   JMSDistributedTopics dr--   JMSFileStores dr--   JMSJDBCStores ... wls:/mydomain/config>

custom

命令类别:树命令 用于 WLST:联机版

描述

导航到在服务器中注册的自定义 MBean 的根。WLST 可以对自定义 MBean 进行导航、询问和编辑,正像它对域 MBean 操作的那样;但是,因为存根控件不可用,所以自定义 MBean 不能使用 cmo 变量。

注意:当导航到 custom 树时,WLST 会查询兼容 MBean 服务器中的所有 MBean,如运行时 MBean 服务器,可能还有 JVM 平台 MBean 服务器,以便定位自定义 MBean。此过程会花费几分钟的时间,并且 WLST 可能不会立即返回提示,这些都取决于当前域中 WLST 的数目。

当 WLST 连接到管理服务器实例或受管服务器实例时,custom 命令可用。当连接到 WebLogic Integration 或 WebLogic Portal 服务器时,WLST 可以与所有的 WebLogic Integration 或 WebLogic Portal 服务器 MBean 进行交互。

有关自定义 MBean 的详细信息,请参阅使用 JMX 开发自定义管理实用工具。

在出现错误的情况下,此命令将返回 WLSTException

语法

custom()

示例

下面的示例针对管理服务器实例,从配置 MBean 层次导航到自定义 MBean 层次。

wls:/mydomain/serverConfig> custom() Location changed to custom tree.This is a writeable tree with No root.For more help, use help(‘custom‘) wls:/mydomain/custom> 

domainConfig

命令类别:树命令 用于 WLST:联机版

描述

导航到域配置层次中您上一次导航到的 MBean,或导航到层次的根 DomainMBean。此只读层次可存储代表当前域的配置 MBean。

在出现错误的情况下,此命令将返回 WLSTException

语法

domainConfig()

示例

下面的示例在管理服务器实例上,从配置 MBean 层次导航到域配置层次。

wls:/mydomain/serverConfig> domainConfig() Location changed to domainConfig tree.This is a read-only tree with DomainMBean as the root. For more help, use help(‘domainConfig‘) wls:/mydomain/domainConfig> ls() dr--   AppDeployments dr--   BridgeDestinations dr--   Clusters dr--   CustomResources dr--   DeploymentConfiguration dr--   Deployments dr--   EmbeddedLDAP dr--   ErrorHandlings dr--   FileStores dr--   InternalAppDeployments dr--   InternalLibraries dr--   JDBCDataSourceFactories dr--   JDBCStores dr--   JDBCSystemResources dr--   JMSBridgeDestinations dr--   JMSInteropModules dr--   JMSServers dr--   JMSSystemResources ... wls:/mydomain/domainConfig>

domainRuntime

命令类别:树命令 用于 WLST:联机版

描述

导航到域运行时层次中您上一次导航到的 MBean,或导航到层次的根 DomainRuntimeMBean。此只读层次可存储表示当前域的运行时 MBean。

在出现错误的情况下,此命令将返回 WLSTException

语法

domainRuntime()

示例

下面的示例在管理服务器实例上,从配置 MBean 层次导航到域运行时层次。

wls:/mydomain/serverConfig> domainRuntime() wls:/mydomain/domainRuntime> ls() dr--   AppRuntimeStateRuntime dr--   DeployerRuntime dr--   DomainServices dr--   LogRuntime dr--   MessageDrivenControlEJBRuntime dr--   MigratableServiceCoordinatorRuntime dr--   MigrationDataRuntimes dr--   SNMPAgentRuntime dr--   ServerLifeCycleRuntimes dr--   ServerRuntimes dr--   ServerServices
-r-- ActivationTime Mon Aug 01 11:41:25 EDT 2005 -r-- Clusters null -r-- MigrationDataRuntimes null -r-- Name sampleMedRecDomain -rw- Parent null -r-- SNMPAgentRuntime null -r-- Type DomainRuntime -r-x restartSystemResource Void : WebLogicMBean(weblogic.management.configuration.SystemResourceMBean) wls:/mydomain/domainRuntime>

edit

命令类别:树命令 用于 WLST:联机版

描述

导航到编辑配置 MBean 层次中您上一次导航到的 MBean,或导航到层次的根 DomainMBean。此可写层次可存储表示当前域的所有配置 MBean。

注意:要编辑配置 Bean,必须连接到管理服务器。如果连接到受管服务器,则 WLST 的功能只限于浏览配置 Bean 层次。无法使用 WLST 更改受管服务器上的 MBean 的值时,可以使用管理 API 进行更改。BEA Systems 建议仅更改管理服务器上的配置 MBean 的值。更改受管服务器上 MBean 的值会导致域的配置不一致。

注意:有关编辑配置 Bean 的详细信息,请参阅使用 WLST 联机版更新现有域。

在出现错误的情况下,此命令将返回 WLSTException

语法

edit()

示例

下面的示例说明如何在管理服务器实例上从服务器配置 MBean 层次导航到域配置 MBean 层次的可编辑的副本。

wls:/myserver/serverConfig> edit() Location changed to edit tree.This is a writeable tree with DomainMBean as the root. For more help, use help(‘edit‘) wls:/myserver/edit !> ls() dr--   AppDeployments dr--   BridgeDestinations dr--   Clusters dr--   DeploymentConfiguration dr--   Deployments dr--   EmbeddedLDAP ... wls:/myserver/edit !> 

jndi

命令类别:树命令 用于 WLST:联机版

描述

导航到 WLST 当前所连接的服务器的 JNDI 树。此只读树保留所有当前绑定在 JNDI 中的元素。

在出现错误的情况下,此命令将返回 WLSTException。

语法

jndi()

示例

下面的示例在管理服务器实例上,从运行时 MBean 层次导航到域 JNDI 树。

wls:/myserver/runtime> jndi() Location changed to jndi tree.This is a read-only tree with No root.For more help, use help(‘jndi‘) wls:/myserver/jndi> ls() dr--   ejb dr--   javax dr--   jms dr--   weblogic ...

runtime

命令类别:树命令 用于 WLST:联机版

描述

注意:自 WebLogic Server 9.0 开始,不赞成使用此命令。应更新您的脚本,以使用 serverRuntime 命令,如 serverRuntime 中所述。

导航到运行时层次中您上一次导航到的 MBean,或导航到所有运行时对象的根 DomainRuntimeMBean。当连接到受管服务器实例时,运行时 MBean 的根是 ServerRuntimeMBean

在出现错误的情况下,此命令将返回 WLSTException

有关详细信息,请参阅浏览运行时 MBean。

语法

runtime()

示例

下面的示例在受管服务器实例上,从配置 MBean 层次导航到运行时 MBean 层次。

wls:/mydomain/serverConfig> runtime() Location changed to runtime tree (deprecated).This is a read-only tree with DomainRuntimeMBean as the root. For more help, use help(‘runtime‘) wls:/mydomain/runtime>

serverConfig

命令类别:树命令 用于 WLST:联机版

描述

导航到配置 MBean 层次中您上一次导航到的 MBean,或导航到层次的根 DomainMBean

此只读层次可存储表示 WLST 当前所连接的服务器的配置 MBean。MBean 特性值包括启动服务器时用户指定的所有命令行替换。

在出现错误的情况下,此命令将返回 WLSTException

有关详细信息,请参阅在 MBean 层次中导航。

语法

serverConfig()

示例

下面的示例在管理服务器实例上,从域运行时 MBean 层次导航到配置 MBean 层次。

wls:/mydomain/domainRuntime> serverConfig() wls:/mydomain/serverConfig>

serverRuntime

命令类别:树命令 用于 WLST:联机版

描述

导航到运行时 MBean 层次中您上一次导航到的 MBean,或导航到层次的根 ServerRuntimeMBean。此只读层次可存储表示 WLST 当前所连接的服务器的运行时 MBean。

在出现错误的情况下,此命令将返回 WLSTException

语法

serverRuntime()

示例

下面的示例在管理服务器实例上,从配置 MBean 层次导航到运行时 MBean 层次。

wls:/mydomain/serverConfig> serverRuntime() Location changed to serverRuntime tree.This is a read-only tree with ServerRuntimeMBean as the root. For more help, use help(‘serverRuntime‘) wls:/mydomain/serverRuntime> 

 


WLST 变量参考

表 A-12 描述了 WLST 变量及其常见的用法。所有变量在启动用户会话时已初始化为默认值,并且会根据用户与 WLST 的交互情况发生更改。

表 A-12 WLST 变量
变量
描述
示例
adminHome
Administration MBean。仅在 WLST 已连接到管理服务器时,此变量才可用。

注意:从 WebLogic Server 9.0 开始不赞成使用此变量。

 

wls:/mydomain/edit> bean = adminHome.getMBean(ObjectName(‘mydomain:Name=mydomain,Type=Domain‘))
cmo
当前管理对象。将 cmo 变量设置为使用 WLST 导航到的 Bean 实例。您可以使用该变量对当前 Bean 实例执行任何 getset 或 invoke 方法。
WLST 将变量设置为当前 WLST 路径。例如,当更改到 serverConfig 层次时,cmo 的值将被设置为 DomainMBean。当更改到 serverRuntime 层次时,cmo 的值将被设置为 ServerRuntimeMBean。
该变量在除了 custom 和 jndi 的所有 WLST 层上都可使用。
wls:/mydomain/edit> cmo.setAdministrationPort(9092)
connected
这是一个布尔值,它指定 WLST 是否已连接到正在运行的服务器。当连接到正在运行的服务器时,WLST 将此变量设置为 true;否则,WLST 将其设置为false
wls:/mydomain/serverConfig> print connected false
domainName
WLST 所连接到的域的名称。
wls:/mydomain/serverConfig> print domainName mydomain
domainRuntimeService
DomainRuntimeServiceMBean MBean。仅在 WLST 已连接到管理服务器时,此变量才可用。
wls:/mydomain/serverConfig> domainService.getServerName() `myserver‘
editService
EditServiceMBean MBean。仅在 WLST 已连接到管理服务器时,此变量才可用。
wls:/mydomain/edit> dc = editService.getDomainConfiguration()
exitonerror
这是一个布尔值,它指定当 WLST 出现异常时,是否会终止脚本执行。此变量默认为true,表示当 WLST 出错时,将终止脚本执行。当 WLST 以交互模式运行时,此变量不适用。
wls:/mydomain/serverConfig> print exitonerror true
home
Local MBean。

注意:从 WebLogic Server 9.0 开始不赞成使用此变量。

 

wls:/mydomain/serverConfig> bean = home.getMBean(ObjectName(‘mydomain:Name=mydomain,Type=Domain‘))
isAdminServer
这是一个布尔值,它指定 WLST 是否已连接到 WebLogic 管理服务器实例。如果 WLST 连接到 WebLogic 管理服务器,则 WLST 将此变量设置为 true;否则,WLST 将其设置为 false
wls:/mydomain/serverConfig> print isAdminServer true
mbs
对应于层次的当前位置的 MBeanServerConnection 对象。
wls:/mydomain/serverConfig>mbs.isRegistered(ObjectName(‘mydomain:Name=mydomain,Type=Domain‘))
recording
这是一个布尔值,它指定 WLST 是否正在记录命令。当输入 startRecording 命令时,WLST 将此变量设置为 true;否则,WLST 将此变量设置为 false
wls:/mydomain/serverConfig> print recording true
runtimeService
RuntimeServiceMBean MBean。
wls:/mydomain/serverConfig> sr=runtimeService.getServerRuntime()
serverName
WLST 所连接到的服务器的名称。
wls:/mydomain/serverConfig> print serverName myserver
typeService
TypeServiceMBean MBean。
wls:/mydomain/serverConfig>mi=typeService.getMBeanInfo(‘weblogic.management.configuration.ServerMBean‘)
username
当前连接到 WLST 的用户的名称。
wls:/mydomain/serverConfig> print username weblogic
version
WLST 所连接的正在运行的服务器的当前版本。
wls:/mydomain/serverConfig> print version WebLogic Server 9.0 Thu Aug 31 12:15:50 PST 2005 778899

 

WLST 命令和变量