JBoss CLI

转自http://www.cnblogs.com/inteliot/archive/2012/08/05/2623719.html

 

为 了便于维护和管理， JBoss AS 7 提供了命令行接口（CLI）， 用户经过丰富的命令能够达到和 Web Console 同样的管理效果。本文尝试对 JBoss AS 7 的 CLI 进行简单介绍。 

   JBoss CLI 的做用

   显而易见，CLI 的做用在于管理。 JBoss AS 7 团队力图使 CLI 和 Web console 起到一样的管理效果。CLI 使得 JBoss AS 7 的管理很容易被嵌入管理员的脚本中，针对大规模的服务器管理和与其余服务器的集成管理有很大优点。 

  JBoss CLI 是怎样工做的

  JBoss AS 7 启动的时候，会开启 management 的两个端口， native-interface(default port: 9999) 和 http-interface(default port: 9990)， native-interface 默认是给 CLI 用的， http-interface 是给 Web console 用的。

standalone 下该配置在 standalone/configuraiton/standalone.xml 中：

<socket-binding name="management-native"  interface="management"  port="${jboss.management.native.port:9999}"/>
<socket-binding name="management-http" interface="management" port="${jboss.management.http.port:9990}"/>

 domain 下该配置在 domain/configuration/host.xml 中：

<management-interfaces>
    <native-interface security-realm="ManagementRealm">
        <socket interface="management" port="${jboss.management.native.port:9999}"/>
    </native-interface>
    <http-interface security-realm="ManagementRealm">
        <socket interface="management" port="${jboss.management.http.port:9990}"/>
    </http-interface>
</management-interfaces>

NOTE

配置文件中的 ${jboss.management.native.port:9999} 意味着若是有 jboss.management.native.port 系统变量存在，那么就使用该变量的值，不然使用9999。变量经过 -D 传入。

JBoss CLI 的入口

  JBoss CLI 的入口是 bin/jboss-admin.sh 脚本， 不加任何参数运行该脚本会进入 interactive mode， 用户在console里输入命令和 native-interface 端口进行通信。 

JBoss CLI 的实现

  JBossl CLI 使用 JLine 处理控制台的输入，实现了诸如 Tab 自动完成， 命令历史记录等特性，让那些习惯于 bash 等控制台操做的管理员们感受很舒服。JBoss CLI 使用 JBoss remoting 和服务器端的 controller 通信。若是是 standalone mode， controller 是单个的 host controoler，若是是 domain mode， controoler 就是 domain controller。交互的数据格式是基于 JBoss remoting 的自定义协议，与其不一样的是 Web Console 下与 management-http 端口通信的是基于 JSON 格式的 base64编码。 

JBoss CLI 的特性 

  JBoss CLI 有三个特性须要说下，一是 interactive mode 下支持 tab 自动完成， 二是有些命令只有在服务器链接之后才有用，有些则在 standalone 和 domain 下不一样。三是能够自定义新的命令。若是想看某个命令的详细说明， 运行： command --help 。 

JBoss CLI 的参数 

脚本 bin/jboss-admin.sh 有一些参数： 

./jboss-admin.sh --version
# 打印版本信息。 除 JBoss AS release 的信息之外，都是 CLI 所在的机器的信息。

./jboss-admin.sh --controller=host:port
  # 指定 CLI 链接的目标 controller。 该设定并无启动链接， 只有调用 connect 命令或者 --connect 参数才会启动链接

./jboss-admin.sh --file=FILE
  # 读取 FILE 里的命令列表，逐个执行。 每一个命令一行。 运行完后，退出

./jboss-admin.sh --command COMMAND
  # 执行 --command 后面的 COMMAND， 而且退出。 “--command”  能够省略。

./jboss-admin.sh --commands COMMAND1,COMMAND2...
  # 执行 --commands 后面的命令列表， 以逗号分开。运行完成后退出。“--commands” 能够省略。

./jboss-admin.sh --user=username --password=password
  # 指定须要 authentication 的用户名和密码。

./jboss-admin.sh --connect --gui
  # 启动 GUI 进行可视化 command builder
  # --gui 在 7.1.0.Final 会出现

JBoss CLI 经常使用命令  

 下面列出的一些 command 都是基于 jboss-as-7.1.0.CR1b 版本， 之后有可能会有增长或者修改。

1 connect

 connect 命令用于链接目标 controller。

 用法以下：

connect [host]:[port]
# 链接 host:port 端口， 默认为链接 localhost:9999。 这个是在 interactive mode 下输入的命令。
./jboss-admin.sh --connect
# 启动控制台的时候自动链接 localhost:9999
./jboss-admin.sh --connect --controller=host:port
# 启动控制台的时候自动链接 host:port
./jboss-admin.sh --connect --controller=host:port --user=<username> --password=<password>
# 启动控制台的时候自动链接 host:port, 而且使用 username 和 password 进行 。

  2 clear

    clear 用于清屏。cls 是它的一个 alias。 与 linux 下的 clear 同样。 

3 help

    很是有用的命令。运行 command --help 来查看详细解释 

  4 history

    列出已经运行过的命令历史记录。 存放在 USER_HOME/.jboss-cli-history 文件。 

5 version

    打印出版本信息 

6 pwd

   打印当前所在 node 的路径信息。 

7 batch

  进入 batch mode。 batch mode 是将一些命令在一个事务下运行。 batch 的定义也能够放在一个文件里，由 ./jboss-admin.sh --file=FILE 执行。有关 batch mode 的具体用法， 请参照：http://community.jboss.org/wiki/CLIBatchMode 

8 quit

   退出 

9. cd node_path【connect 后有效】

   改变当前 node 的路径。 "cd .." 会更改到上一层。 

10 ls 【connect 后有效】

   列出当前 node 下的子路经 

11 deploy file_path 【connect 后有效】

   部署一个文件到目标 host。 

[standalone@192.168.1.102:9999 /] deploy /home/lgao/sources/my_own/maven_webapp/myapp/target/myapp.war
  # 部署一个 war， 同时启动
[standalone@192.168.1.102:9999 /] deploy -l
myapp.war
  # 列出已部署的应用
[standalone@192.168.1.102:9999 /] undeploy myapp.war
  # 卸载 myapp.war
[standalone@192.168.1.102:9999 /] deploy /home/lgao/sources/my_own/maven_webapp/myapp/target/myapp.war  --disabled
  # 部署一个 war， 可是不启动它
[standalone@192.168.1.102:9999 /] deploy -l
myapp.war
[standalone@192.168.1.102:9999 /] deploy --name myapp.war
  # 仅仅启动 myapp.war

   CLI 会把 myapp.war 上传到目标 host中进行部署。

   deploy -l 会列出当前的部署列表。（若是同时能列出每一个部署的状态就更好了。） 

12 undeploy deployname 【connect 后有效】

    卸载一个部署。 deployname 是  deploy -l 列出的 name 

13 command add --node-type=xx --property-id=xx --command-name=CmdName 【connect 后有效】 

    定义一个命令，使得该命令对指定 node-type 的某个 node 对应的实例进行操做。JBoss CLI 内置了2 个 自定义命令： data-source, xa-data-source. 其中 data-source 的定义是：

command add --node-type=/subsystem=datasources/data-source --property-id=jndi-name --command-name=data-source

   咱们来自定义一个 connector 的命令： 

[standalone@localhost:9999 /] command add --node-type=/subsystem=web/connector --propertiy-id=name --command-name=connector

   而后咱们就能够使用 connector 命令了： 

[standalone@localhost:9999 /] connector --name=http read-resource
enable-lookups=false
enabled=true
max-post-size=2097152
max-save-post-size=4096
protocol=HTTP/1.1
redirect-port=8443
scheme=http
secure=false
socket-binding=http
ssl=n/a
virtual-server=n/a

    每一个新添加的自定义命令都会有 --help  参数， JBoss CLI 会读取服务器端支持的 operation 和 attribute， 组合成帮助文档显示出来。 

 除了以上的命令之外， 还能够经过 /node-type=node-name:operation 的方式进行调用。好比： 

[standalone@localhost:9999 /] /subsystem=naming:read-resource-description
{
"outcome" => "success",
"result" => {
"description" => "The configuration of the naming subsystem.",
"attributes" => {},
"operations" => undefined,
"children" => {"binding" => {
"description" => "JNDI bindings for primitive types",
"model-description" => undefined
}}
}
}

    在根 node 下有个 operation 用来关闭 JBoss： 

[standalone@localhost:9999 /] :shutdown
{"outcome" => "success"}
[standalone@localhost:9999 /]

    在根 node 下有个 operation 用来重启 JBoss： 

[standalone@localhost:9999 /] :reload
{"outcome" => "success"}
[standalone@localhost:9999 /]

    重启后， CLI 保持着 connected 状态。