WLST 命令和变量

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

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

WSLT 命令类别概述

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

浏览命令

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

cd

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

描述

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

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

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

语法

cd(mbeanName)

示例

以下示例可导航配置 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)

示例

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

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

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

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 配置的控制命令。

addTemplate

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

描述

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

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

语法

addTemplate(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 参数的值。

示例

以下示例可将 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：脱机版

描述

使用指定的模板创建域。

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

语法

createDomain(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)

示例

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

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 参数指定值。

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

语法

exit([defaultAnswer], [exitcode])

示例

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

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)

示例

以下示例可打开 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 使用命令（如 cd、ls 和 pwd）遍历配置 Bean 的层次结构，其方式类似于在 UNIX 或 Windows 命令外壳中导航文件系统。导航到配置 Bean 实例之后，您可使用 WLST 命令与 Bean 交互。有关详细信息，请参阅导航和询问 MBean。

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

语法

readTemplate(templateFileName)

示例

以下示例可打开 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 命令打开此域。

在写入域之前，必须定义默认用户的密码（如果尚未定义的话）。例如：

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

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

语法

writeDomain(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(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。

deploy

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

描述

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

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

语法

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

示例

以下示例可对位于 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=‘[email protected]‘)

以下示例显示了如何将应用程序版本 (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])

示例

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

以下示例通过使用在 c:/deployment/BigApp/plan.xml 中定义的部署计划将 c:/myapps/BigApp 应用程序分发到 myserver、oamserver1 和 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])

示例

以下示例通过使用位于 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])

示例

以下示例通过使用位于 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])

示例

以下示例使用指定的部署选项启动 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])

示例

以下示例可停止 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])

示例

以下示例可将 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])

示例

以下示例通过使用位于 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 诊断框架。

exportDiagnosticData

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

描述

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

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

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

语法

exportDiagnosticData([options])

示例

以下示例可针对名为 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])

示例

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

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

编辑命令

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

activate

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

描述

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

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

语法

activate([timeout], [block])

示例

以下示例可激活在当前编辑会话期间所进行的、已保存到磁盘但尚未激活的更改。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 和 destinationType：

•  分配应用程序部署时，请按如下所示设置值：

•  sourceType：AppDeployment
•  destinationType：Target

•  分配库时，请按如下所示设置值：

•  sourceType：Library
•  destinationType：Target

•  分配服务时，请按如下所示设置值：

•  sourceType：指定服务器的名称，例如 JDBCSystemResource
•  destinationType：Target

•  将服务器分配到群集时，请按如下所示设置值：

•  sourceType：Server
•  destinationType：Cluster

•  分配子部署时，请按如下所示设置值：

•  sourceType: service.SubDeployment，其中 service 用于指定 SubDeployment 的父级（例如 JMSSystemResource.SubDeployment）；还可以指定嵌套的子部署（例如AppDeployment.SubDeployment.SubDeployment）
•  destinationType：Target

•  分配安全类型时，请按如下所示设置值：

•  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：脱机版

描述

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

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

语法

assignAll(sourceType, destinationType, destinationName)

示例

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

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

可将下列服务（如果存在）分配到指定的目标：MigratableRMIService、Shutdownclass、Startupclass、FileT3,RMCFactory、MailSession、MessagingBridge、JMSConnectionFactory、JDBCConnectionPool、JDBCMultipool、JDBCTxDatasource、JDBCDataSource、JDBCPoolComp、JoltConnectionPool、WLECConnectionPool和 WTCServer。

cancelEdit

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

描述

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

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

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

语法

cancelEdit([defaultAnswer])

示例

以下示例可取消当前编辑会话。在取消前，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。

将 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])

示例

以下示例可为当前配置 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。

语法

delete(name, childMBeanType)

示例

以下示例可删除名为 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])

示例

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

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

get

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

描述

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

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

cmo.getListenPort()

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

语法

get(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)

示例

以下示例可对当前配置 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])

示例

以下示例可指定在当前 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)

示例

以下示例通过使用 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)

示例

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

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)

例如

以下示例可将 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)

示例

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

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

showChanges

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

描述

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

语法

showChanges([onlyInMemory])

示例

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

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 : falseMBean 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。

语法

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

示例

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

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])

示例

以下示例可停止当前编辑会话。在取消前，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 和 destinationType：

•  取消分配应用程序部署时，请按如下所示设置值：

•  sourceType：AppDeployment
•  destinationType：Target

•  取消分配库时，请按如下所示设置值：

•  sourceType：Library
•  destinationType：Target

•  取消分配安全类型时，请按如下所示设置值：

•  sourceType：安全类型的名称，例如 User
•  destinationType：目标安全类型的名称，例如 Group

•  从群集中取消分配服务器时，请按如下所示设置值：

•  sourceType：Server
•  destinationType：Cluster

•  取消分配服务时，请按如下所示设置值：

•  sourceType：指定服务器的名称，例如 JDBCSystemResource
•  destinationType：Target

•  取消分配子部署时，请按如下所示设置值：

•  sourceType: service.SubDeployment，其中 service 用于指定 SubDeployment 的父级（例如 JMSSystemResource.SubDeployment）；还可以指定嵌套的子部署（例如AppDeployment.SubDeployment.SubDeployment）
•  destinationType：Target

示例

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

•  从群集 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：脱机版

描述

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

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

语法

unassignAll(sourceType, destinationType, destinationName)

示例

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

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

此时从指定的目标中取消分配下列服务（如果存在）：MigratableRMIService、Shutdownclass、Startupclass、FileT3、RMCFactory、MailSession、MessagingBridge、JMSConnectionFactory、JDBCConnectionPool、JDBCMultipool、JDBCTxDatasource、JDBCDataSource、JDBCPoolComp、JoltConnectionPool、WLECConnectionPool和 WTCServer。

undo

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

描述

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

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

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

语法

undo([unactivateChanges], [defaultAnswer])

示例

下面的示例将恢复自上次 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 相关信息。

addListener

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

描述

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

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

语法

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

示例

下面的示例在 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])

示例

下面的示例将配置转换为 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])

示例

下面的示例在当前配置层次中搜索名为 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。

语法

getMBean(mbeanPath)

示例

下面的示例返回指定路径的 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，并将其存储在变量 svrMbi 中。

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

getPath

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

描述

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

语法

getPath(mbean)

示例

下面的示例返回指定路径的 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])

示例

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

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

lookup

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

描述

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

语法

lookup(name, [childMBeanType])

示例

下面的示例查找指定的服务器 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)

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

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

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

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

语法

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

ls( [ moPath ] returnMap [ returnType ] )

示例

下面的示例在 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])

示例

下面的示例为 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])

示例

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

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

removeListener

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

描述

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

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

语法

removeListener([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])

示例

下面的示例开始在 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])

示例

下面的示例中返回受管服务器 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: myclusterStates 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])

示例

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

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])

示例

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

wls:/mydomain/serverConfig> threadDump()

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

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

viewMBean

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

描述

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

语法

viewMBean(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)

示例

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

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

生命周期命令

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

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

migrate

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

描述

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

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

语法

migrate(sname, destinationName, [sourceDown], [destinationDown], [migrationType])

示例

下面的示例将 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])

示例

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

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])

示例

下面的示例命令 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: myclusterStates of the servers are MServer1---SHUTDOWN MServer2---SHUTDOWN MServer3---SHUTDOWN wls:/mydomain/serverConfig>

start

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

描述

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

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

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

语法

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

示例

下面的示例命令节点管理器启动受管服务器实例；监听地址为 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])

示例

下面的示例在 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])

示例

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

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])

示例

下面的示例使用默认的主机、端口号及 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])

示例

下面的示例注册连接到节点管理器的当前计算机，并将节点管理器机密文件 (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)

示例

下面的示例在指定服务器 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])

示例

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

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

nmLog

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

描述

返回节点管理器日志。

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

语法

nmLog([writer])

示例

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

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

nmServerLog

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

描述

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

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

语法

nmServerLog([serverName], [writer])

示例

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

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

nmServerStatus

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

描述

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

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

语法

nmServerStatus([serverName])

示例

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

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

nmStart

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

描述

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

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

语法

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

示例

下面的示例使用节点管理器在当前域中启动服务器 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 的相同计算机上启动节点管理器。

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

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

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

语法

startNodeManager([verbose], [nmProperties])

示例

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

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 层次中导航。