为
了便于维护和管理, 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 状态。
分享到:
相关推荐
### JBoss AS 7 简介与特点 JBoss AS 7(Application Server 7)是JBoss系列中的一个重要版本,它标志着JBoss AS在技术架构上的一次重大革新。本文将详细介绍JBoss AS 7的历史背景、设计初衷、核心技术和内部结构,...
JBoss AS7(Application Server 7)是JBoss社区推出的一款开源应用服务器,其文档提供了全面且详细的指南、教程及资源介绍,旨在帮助开发者和管理员更好地理解和掌握JBoss AS7的各项功能与配置。 #### 一、文档结构...
JBoss AS 7 是一款开源的应用服务器,由 Red Hat 公司开发,它提供了一个高效且灵活的平台来运行Java应用程序。在这个版本中,JBoss 引入了命令行接口 (CLI) 作为管理和部署应用的主要工具,以提高管理效率和自动化...
### JBoss AS7 管理指南核心知识点详解 #### 一、目标受众与预备知识 **1.1 目标受众** 本指南主要面向希望深入掌握JBoss AS7.0管理技能的技术人员,包括系统管理员、开发人员及技术支持工程师等。 **1.2 预备...
Windows 环境下 JBoss AS 7 配置 HTTPS 在 Windows 环境下,配置 JBoss AS 7 的 HTTPS 需要按照特定的步骤进行。下面将详细介绍配置 HTTPS 的过程。 生成服务器端证书文件 首先,需要使用 JDK 自带的工具制作 ...
本篇将详细介绍如何在MyEclipse中远程调试JBoss AS7或JBoss EAP6,无论是在Windows还是Linux环境下。 首先,我们需要了解远程调试的基本原理。远程调试通常依赖于Java的调试接口(Java Debug Wire Protocol, JDWP)...
1. **下载和解压**:从官方源或镜像站点下载`jboss-as-7.1.0.CR1b.zip`,然后使用`unzip`命令解压到指定目录。 2. **设置环境变量**:在`.bashrc`或`.bash_profile`文件中添加JBoss AS的路径到`JAVA_HOME`和`JBOSS_...
* jboss-as:存放jboss的核心组件 * licenses:存放jboss的许可证文件 * modules:存放jboss的模块文件 * standalone:存放jboss的 独立配置文件 * welcome-content:存放jboss的欢迎页面文件 在安装完成后,需要...
3. **CLI和Management API**:JBoss AS 7提供了命令行接口(CLI)和管理API,使得管理和操作服务器变得更加方便。CLI允许用户执行各种管理任务,如部署应用、配置服务和查看服务器状态,而Management API则为开发者...
### JBoss AS5 安装与上手指南详解 #### 一、引言 JBoss Application Server (简称 JBoss AS) 是一款免费且开源的应用服务器,广泛用于开发和部署 Java 应用程序。JBoss AS5 版本是 JBoss AS 的一个重要版本,引入...
在开始安装前,确保你的Linux系统是64位的,并且已经安装了Java Development Kit (JDK) 1.6或更高版本,因为JBoss AS 7需要JDK来运行。你可以通过`java -version`命令检查JDK是否已安装。 **2. 下载JBoss AS 7.1.1*...
JBoss AS 7 是一个开源的应用服务器,由 Red Hat 公司开发,它基于 Java Enterprise Edition (Java EE) 平台,提供了一种运行和管理企业级应用的环境。本篇将介绍 JBoss AS 7 的入门使用,重点讲解两种管理模式——...
本文将重点介绍JBoss7.1.1的核心特性和管理员需要了解的关键概念,包括JBoss的主要版本特性、JBoss AS7的新特性、域(Domain)和群集(Cluster)的概念、JBoss7的配置方法、安全性配置、管理接口、JVM设置、命令行...
### jboss-as-web-7.0.1.Final配置SSL详解 #### 一、引言 随着互联网技术的发展,安全成为越来越重要的议题。对于企业级应用服务器而言,配置SSL(Secure Sockets Layer,安全套接层)是非常必要的,它能够为用户...
"工具"标签可能指的是用于管理Jboss的各种工具,如上述的`jboss-as-nativeservice.exe`,还有像Jboss Management Console这样的图形界面工具,用于远程管理和监控Jboss实例。 总之,"在另一个位置运行Jboss服务"是...
- **下载地址**: 访问官方下载页面http://jbossas.jboss.org/downloads/,下载JBoss 7.1.1 Final版本,文件名为`jboss-as-7.1.1.Final.zip`。 - **安装路径**: 解压缩文件至`F:\jboss-as-7.1.1.Final`。 - **环境...
### JBoss简介 JBoss AS(Application Server),现称为WildFly,是一款开源的Java应用服务器,支持最新的Java EE标准。它由JBoss集团开发,并于2014年被Red Hat收购后更名为WildFly。JBoss AS提供了一整套企业级的...
JBoss安装脚本jbosstools是脚本和示例的集合,以及如何配置JBoss AS和JBoss EAP的示例。先决条件JBoss版本必须为7或更高版本。 Unix风格的操作系统。 在Linux(Fedora,RHEL,Ubuntu),Solaris上测试快速开始将...
- 访问JBoss AS社区下载页面:[http://www.jboss.org/jbossas/downloads/](http://www.jboss.org/jbossas/downloads/) - 下载适用于您的JDK版本的平台独立ZIP分发包: - Java SE 5 – jboss-5.1.0.GA.zip - Java...