本附录将介绍以下内容：
命令行接口简介
使用WebLogic 服务器命令 WebLogic 服务器管理命令参考 配置及管理连接池的命令 Mbean 管理命令参考
命令行接口简介 命令行接口简介 命令行接口简介 命令行接口简介
作为管理控制台的另一种选择， WebLogic 服务器提供了命令行接口作为管理工具，同时也 可以设定多数的configuration 以及 run-time Mbean 的属性。
以下情况可以使用命令行界面：
如果要用脚本进行有效的管理 如果不能使用浏览器访问管理控制台 相比于GUI，你更愿意使用命令行界面
开始前的准备工作 开始前的准备工作 开始前的准备工作 开始前的准备工作
本文档中的例子是基于以下假设：
WebLogic 服务器安装在 c:\weblogic 目录 JDK 位于 c:\java 目录
WebLogic 服务器是从它的安装目录启动的
运行WebLogic Server 命令之前，必须先完成以下工作：
1．安装并配置 WebLogic 服务器软件。参见以下页面的“WebLogic 服务器安装指南”中的部分：
位于http://e-docs.bea.com/wls/docs61/install/index.html
2．正确地配置 CLASSPATH 环境变量。参见 2-7 页的“设置类路径选项”
3．执行以下步骤中的一个来启用命令行界面 从服务器的安装目录启动服务器
如果不是从服务器的安装目录启动服务器，那么应该使用以下命令，把命令中的 c:\weblogic 用你的webLogic 服务器所在的目录名替代。
-Dweblogic.system.home=c:/weblogic
使用使用
使用使用
WebLogic 服务器命令
服务器命令服务器命令服务器命令本章介绍了WebLogic Server 的命令与所需参数。WebLogic Server 的命令不区分大小写。
语法语法 语法语法
java weblogic.Admin [-url URL] [-username username] [-password password] COMMAMD arguments
参数参数 参数参数
许多WebLogic 服务器命令都需要以下参数：。
参数 定义
URL WebLogic 服务器主机的 URL，其中包括 WebLogic 服务器监听客户端请求的 TCP 端口。格式为 hostname:port。缺省为 localhost:7001.
注意：服务器命令中的URL 参数引用的是 WebLogic 服务器，而 run-time Mbea 与configuration Mbean 命令总是指向一个特定的管理服务器。
username 可选参数。要验证的用户名用以确定是否可以执行命令。缺省为guest 管理员必须具有相应的访问权限，以执行管理run-time Mbeans 的命令。
见以下章节：
B-4 页的“WebLogic 服务器管理命令参考”
B-18 页的“WebLogic 服务器连接池管理命令参考”
B-28 页的“Mbean 管理命令参考”
见B-6 页 的“CANCEL-SHUTDOWN”
连接到WebLogic 服务 器
CONNECT 对WebLogic 服务器进行指定次数的连接，并返回每 个回合连接的总时间（用两位数表示）以及每次连接 的平均持续时间
见B-7 页的“CONNECT”
获得命令的帮助信息 HELP 给出了所有 WebLogic 服务器的语法与使用信息。如 果HELP 命令中指定了命令值，那么只给出这一命令 的帮助信息。
参见B-8 页的“HELP”部分 启动或停止 WebLogic
服务器
java 用Java 命令启动或停止 WebLogic 服务器，这与启动 或停止其它Java 应用的方式是一样的。
见管理指南的“启与停止 WebLogic 服务器”中的部 分，位于：
http://e-docs.bea.com/wls/docs61/adminguide/startstop.html . 查看WebLogic 服务器
的许可证
LICENSES 列出一服务器上所有WebLogic 服务器实例的许可证。
见B-9 页的“LICENSES”
列出JNDI 名字树节点
SERVERLOG 显示指定服务器所产生的服务器日志文件。
见B-13 页的“SERVERLOG”
关闭一个WebLogic 服 务器
SHUTDOWN 关闭URL 所指定的 WebLogic 服务器。
见B-14 页的“SHUTDOWN”。
查看线程 THREAD_DUMP 提供了当前正在运行的 WebLogic 服务器线程的一个 实时快照。
见B-15 页的“THREAD_DUMP”
解锁WebLogic 服务器 UNLOCK 解开用LOCK 命令对指定 WebLogic 服务器添加的锁。
见B-16 页的“UNLOCK”。
查看WebLogic 服务器 版本
VERSION 显示URL 所指定机器上的 WebLogic 服务器软件的版 本。
见B-17 页的“VERSION”。
注：
注：
注：
注：若管理员不能连接到服务器上，则所有命令的退出代码为1
CONNECT
CANCEL_SHUTDOWN 命令取消对指定的 URL 上的 WebLogic 服务器执行的关闭命令。见 B-14 页上的“SHUTDOWN”。
当使用 SHUTDOWN 命令时，你可以以秒指定一个延时，管理员可以在这段延时的时间内取 消关闭命令。但是 SHUTDOWN 命令禁止用户登录，即使在取消关闭命令执行后，依旧保持 禁止状态。可以通过UNLOCK 命令重新允许用户登录，参见 B-16 页的“UNLOCK”。
语法：语法：
语法：语法：
示例：示例：
示例：示例：
CONNECT
对WebLogic 服务器进行指定次数的连接，并返回每个回合连接的总时间（用两位数表示）以 及每次连接的平均持续时间（以微秒为单位）。
语法：语法：
语法：语法：
java weblogic.Admin [-url URL] [-username username] [-password password] CONNECT count
参数 定义
在下面的例子中，一个名字为adminuser 口令为 gumby1234 的用户运行 CONNECT 命令对名字
为localhost 的服务器建立了 25 次连接并返回这些连接的信息：
java weblogic.Admin -url localhost:7001 -username adminuser -password gumby1234 CONNECT 25
HELP
给出所有 WebLogic 服务器命令的语法与使用信息（缺省的），如果 HELP 命令行给出了一个 命令值，那么HELP 命令将显示该命令的帮助信息。
语法：语法：
语法：语法：
java weblogic.Admin HELP [COMMAND]
示例：示例：
示例：示例：
下面的例子使用HELP 命令获得 PING 命令的帮助信息。
java weblogic.Admin HELP PING
HELP 命令将以下信息输出到标准输出上：
Usage: weblogic.Admin [-url url] [-username username]
[-password password]<COMMAND><ARGUMENTS>
PING <count><bytes>
LICENSES
列出安装在某一服务器上的所有WebLogic 服务器实例的许可证
语法：语法：
语法：语法：
java weblogic.Admin [-url URL] [-username username] [-password password] LICENSES
示例：
示例：
示例：
示例：
在下面的例子中，管理远使用缺省的用户名（guest）与口令（guest）获得 localhost 机器中在 7001 端口运行的 WebLogic 服务器的许可证信息。
java weblogic.Admin -url localhost:7001 -username guest -password guest LICENSES
LIST
列出JNDI 名字树上某一节点的绑定信息。
语法：语法：
语法：语法：
java weblogic.Admin [-username username] [-password password] LIST context
参数 定义
context 必需的参数。进行JNDI 查找的上下文。例如，weblogic, weblogic.ejb.javax
示例：示例：
示例：示例：
在本例中，用户adminuser（口令为 gumby1234）的用户请求列出 weblogic.ejb 中节点的绑定信 息。
java weblogic.Admin -username adminuser -password gumby1234 LIST weblogic.ejb
LOCK
java weblogic.Admin [-url URL] [-username username] [-password password] LOCK “string_message ”
参数 定义
“string_message” 可选参数。当 WebLogic 服务器被锁住后，没有权限的用户进行登录将引
发一个安全异常，该异常包含了双引号中的消息字符串。
示例：
示例：
示例：
示例：
下例中，WebLogic 服务器已被锁住。
java weblogic.Admin -url localhost:7001 -username adminuser -password gumby1234 LOCK "Sorry, WebLogic Server is temporarily out of service."
当应用使用一个非特权用户的登录名与口令登录被锁住的服务器时，将收到以下消息：sorry, webLogic Server is temporarily out of service
PING
发送消息以验证WebLogic 服务器是否在端口上进行监听以及是否可以接收 WebLogic 客户端 请求。
语法：
语法：
语法：
语法：
java weblogic.Admin [-url URL] [-username username] [-password password]PING [round_trips][message_length]
参数 定义
round_trips 可选参数。Ping 的次数
message_length 可选参数。每个ping 发送的包的大小。当 ping 的包大于 10MB 将引发
java weblogic.Admin -url localhost:7001 -username adminuser -password gumby1234 PING 10
SERVERLOG
显示指定服务器所生成的日志文件。
如果没有指定URL，那么将显示管理服务器上的服务器日志。
如果指定服务器的URL，那么可以取得非管理服务器中的日志。
如果省略了startime 与 endtime 参数，会启动运行显示整个服务器日志。
语法：
语法：
语法：
语法：
java.weblogic.Admin [-url URL] [-username username] [-password password] SERVERLOG [[starttime]|[endtime]]
参数 定义
starttime 可选参数。显示的日志从该时间的消息开始。如果没有指定这一参数，缺省情
况下将显示执行SERVERLOG 命令后的消息。日期的格式为 yyyy/mm/dd。时间 的格式使用24 小时制。起始日期与时间应该用双引号括起来，即使用以下格 式：”yyyy/mm/dd hh:mm”
endtime 可选参数。显示消息的截止时间。如果没有指定这一参数，缺省为SERVERLOG
命令执行时的时间。日期的格式为yyyy/mm/dd。时间的格式使用 24 小时制。结 束日期与时间应该用双引号括起来，即使用以下格式：”yyyy/mm/dd hh:mm”
示例：
示例：
示例：
示例：
下面的例子使用SERVERLOG 命令显示运行在 localhost 机器上 7001 端口的 WebLogic 服务器的 日志。
java weblogic.Admin -url localhost:7001 SERVERLOG “2001/12/01 14:00”“2001/12/01 16:00”
该命令显示2001/12/1 2:00p.m. 与 2001/12/1 4:00p.m.之间的日志。
SHUTDOWN
关闭指定URL 上的 WebLogic 服务器
语法：
语法：
语法：
语法：
java weblogic.Admin [-url URL] [-username username] [-password password] SHUTDOWN [seconds][“lockMessage”]
参数 定义
seconds 可选参数。指定命令执行后多长时间关闭服务器。
“lockMessage” 可选参数。当用户登录一个被锁住的webLogic 服务器时，系统将发送双引号中 的消息。
示例：
示例：
示例：
示例：
下面的例子中，adminuser 用户（口令为 gumby1234）关闭 localhost 机器中在 7001 端口监听的 WebLogic 服务器：
java weblogic.Admin -url localhost:7001 -username adminuser -password gumby1234 SHUTDOWN 300
“Server localhost is shutting down.”
当命令执行后，过30 秒，所指定的服务器被关闭并将以下消息发送到标准输出：
Server localhost is shutting down.
THREAD_DUMP
提供当前正在运行的WebLogic 服务器线程的实时快照。
语法：
语法：
语法：
语法：
java weblogic.Admin [-url URL] [-username username] [-password password] THREAD_DUMP
unlock
将一个被锁住的WebLogic 服务器解锁。
语法：语法：
语法：语法：
java weblogic.Admin [-url URL] [-username username] [-password password] UNLOCK
参数 定义
username 必需的参数。一个有效的管理员用户的用户名
password 必需的参数。管理员用户的口令
示例：示例：
示例：示例：
本例中，管理员用户adminuser（口令为 gumby1234）请求对运行在 loalhost 机器 7001 端口的 WebLogic 服务器解锁。
java weblogic.Admin -url localhost:7001 -username adminuser -password gumby1234 UNLOCK
VERSION
显示运行在URL 所指定的机器上的 WebLogic 服务器软件的版本。
语法：
语法：
语法：
语法：
java weblogic.Admin [-url URL] [-username username] [-password password] VERSION
示例：示例：
示例：示例：
下面的例子中，一个用户要求显示运行在localhost 机器 7001 端口的 WebLogic 服务器的版本 java weblogic.Admin -url localhost:7001 -username guest -password guest VERSION
注意：本例使用了缺省的usename 与 password 参数, 即使用的是 guest 用户，其口令也是 guest
CREATE＿POOL 在WebLogic 运行时，允许创建连接池。注：动态连 接池不能用于数据源和Tx 数据源。
见B-20 页的“CREATE＿POOL”
删除一个连接 池
DESTROY_POOL 关闭和从连接池中删除连接，当连接池中没有任何连
接时，连接池就不存在了。只有”System”用户和拥有
“Admin”权限并定义了关于连接池的 ACL 的的用户 才可以删除连接池
参见B-23 页的“DESTROY＿POOL”部分
禁用连接池 DISABLE＿POOL 你可以暂时禁用一个连接池，阻止其他用户从该池中 获取连接，只有”System”用户和拥有“Admin”权限并 定义了关于连接池的ACL 的的用户才可以禁用和启 用连接池。
参见B-23 页的“DISABLE＿POOL”部分 允许使用连接
池
ENABLE＿POOL 在一个连接池被禁用后启用它，每个在使用的连接的 JDBC 连接状态与连接池被禁用时的一样，客户端可 以继续当其被停滞时的操作。
参见B-25 页的“ENABLE＿POOL”部分 判断连接池是
否存在
EXISTS＿POOL 测试WebLogic 服务器中指定名字的连接池是否存在，
你可以使用该命令判断连接池是否已经建立或者在
你可以使用该命令判断连接池是否已经建立或者在