JBoss CLI

此文为转载，目前我所使用的 jboss-eap-6.4 CLI入口为 bin/jboss-cli.sh

文中 deploy 章节中提到的“仅启动项目”在我的环境中方法为:

deploy --name=some.war

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。 

[[email protected]:9999 /] deploy /home/lgao/sources/my_own/maven_webapp/myapp/target/myapp.war  
  # 部署一个 war， 同时启动  
[[email protected]:9999 /] deploy -l  
myapp.war  
  # 列出已部署的应用  
[[email protected]:9999 /] undeploy myapp.war  
  # 卸载 myapp.war  
[[email protected]:9999 /] deploy /home/lgao/sources/my_own/maven_webapp/myapp/target/myapp.war  --disabled  
  # 部署一个 war， 但是不启动它  
[[email protected]:9999 /] deploy -l  
myapp.war  
[[email protected]: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 状态。