JBoss7配置指南(一)

最新推荐文章于 2017-01-22 15:31:26 发布
最新推荐文章于 2017-01-22 15:31:26 发布
阅读量2.7k 收藏 3
点赞数
分类专栏： EJB 文章标签： jboss logging 服务器 jms shell domain

1. 目标听众

     这篇文档是为需要安装配置JBoss Application Server(AS7)的人员编写

1.1 开始之前

       你需要知道如何下载，安装和运行JBoss Application Server7. 如果你还不了解这些信息， 请参考“入门指导"

 

1.2 手册中的示例

      手册种大部分的例子会使用部分XML配置文件或者是de-typed的管理模型进行表示


2. 客户端

 

       JBoss AS7提供三种不同的方式对服务器进行配置和管理: web，命令行和xml 配置文件形式。无论你选择什么样的配置方式，配置信息都会被同步到各个方式的管理界面上，并且被存储到xml配置文件中。

 

2.1 web接口

      web管理客户端是一个GWT的应用，它通过HTPP管理接口来管理域(domain)或者是单独运行(standalone)的服务器

 

2.1.1 HTTP管理接入点

       基于HTTP协议的管理接入点负责接入 使用http协议与管理层进行交互 客户端。它负责接收使用JSON编解码的协议和de-typed RPC形式的的api来对可管理的域服务器或者单独运行服务器进行管理操作。web控制台就是通过它来实现的，但基于HTTP协议的管理接入点也可以与其他的管理终端进行集成，交互。

基于HTTP协议的管理点会运行在域控制器(domain controller)或者是单独运行服务器上，默认运行在9990端口上。

Xml代码 复制代码  收藏代码
  1. <management-interfaces>  
  2.  [...]   
  3.  <http-interface interface="management" port="9990"/>  
  4. <management-interfaces>  

 (参见 standalone/configuration/standalone.xml 或者 domain/configuration/host.xml)


基于HTTP协议的管理接入点运行在两个不同的context下。一个用于运行管理的操作 另外一个提供对web管理接口的访问。

  •      域API: http://<host>:9990/management
  •     Web控制台: http://<host>:9990/console

2.1.2访问管理控制台 :

      管理控制台和基于HTTP协议管理的API在统端口上运行，可以通过以下URL进行访问：

  •         http://<host>:9990/console
默认访问web管理页面的URL:http://localhost:9990/console.
 

2.1.3  对管理控制台进行加密


      web管理控制台通过HTTP管理接口来对服务器进行通信。对于如何机密HTTP管理接口以及如何启用默认的安全域，请参考一下本文中关于“加密管理接口"章节。

 

2.2 命令行接口

 

      命令行方式的管理工具（CLI）提供了对域和单独运行服务器的管理。用户可以使用命令行来连接域服务器或者单独运行服务器,通过传输de-typede的管理模型来执行管理操作。

 

2.2.1  Native管理接入点

      Native的管理接入点负责接入使用AS内部协议与管理层进行交互的客户端.它使用基于java对象来描述的管理操作、二进制协议和RPC形式的API来对域和单独运行服务器进行管理操作。命令行方式的管理工具使用它来实现对服务器的管理，单Native管理接入点也提供了极强的集成能力，可以和其他的客户端进行集成。

 

      Nativeg管理接入点运行在host控制器上或者是一个单独运行服务器上。如果使用命令行管理工具，Native管理接入点必须被启用.默认Native管理接入点运行在9999端口上:

<management-interfaces>
<native-interface interface="management" port="9999"/>
[...]
<management-interfaces>

参见 standalone/configuration/standalone.xml 或者 domain/configuration/host.xml)

 

 

2.2.2 运行命令行管理工具

   

        根据操作系统，使用JBossAS7 bin目录下的jboss-admin.sh或者jboss-admin.bat来启动命令行管理工具.关于AS7目录的详细信息，请参考"入门指南".

       命令行工具启动以后的第一件事情就是连接被管理的Jboss AS7实例。我们通过命令connect进行:

Java代码 复制代码  收藏代码
  1. ./bin/jboss-admin.sh   
  2. You are disconnected at the moment. Type 'connect' to connect to the server   
  3. or 'help' for the list of supported commands.   
  4. [disconnected /]   
  5.   
  6. [disconnected /] connect   
  7. Connected to domain controller at localhost:9999  
  8.   
  9. [domain@localhost:9999 /] quit   
  10. Closed connection to localhost:9999  
./bin/jboss-admin.sh
You are disconnected at the moment. Type 'connect' to connect to the server
or 'help' for the list of supported commands.
[disconnected /]

[disconnected /] connect
Connected to domain controller at localhost:9999

[domain@localhost:9999 /] quit
Closed connection to localhost:9999

 

localhost:9999 是JBossAS7域控制器客户端连接的默认主机和端口名.主机名和端口都是可选的参数，可以被单独或者一起指定。想要退出对话，可以键入quit命令来结束。

 

Xml代码 复制代码  收藏代码
  1. jboss-admin脚本可以接收--cnnect参数: ./jboss-admin.sh --connenct  

 

help命令用来显示参考帮助文档:

 
Shell代码 复制代码  收藏代码
  1. [domain@localhost:9999 /] help   
  2. Supported commands:   
  3.   
  4. cn (or cd)             - change the current node path to the argument;   
  5. connect                - connect to the specified host and port;   
  6. deploy                 - deploy an application;   
  7. help (or h)            - print this message;   
  8. history                - print or disable/enable/clear the history expansion.   
  9. ls                     - list the contents of the node path;   
  10. pwn (or pwd)           - prints the current working node;   
  11. quit (or q)            - quit the command line interface;   
  12. undeploy               - undeploy an application;   
  13. version                - prints the version and environment information.   
  14.   
  15. add-jms-queue          - creates a new JMS queue   
  16. remove-jms-queue       - removes an existing JMS queue   
  17. add-jms-topic          - creates a new JMS topic   
  18. remove-jms-topic       - removes an existing JMS topic   
  19. add-jms-cf             - creates a new JMS connection factory   
  20. remove-jms-cf          - removes an existing JMS connection factory   
  21.   
  22. data-source            - allows to add new, modify and remove existing data sources   
  23. xa-data-source         - allows to add new, modify and remove existing XA data sources  
 

查看特定命令的详细帮助文档，需要在命令后加"--help"参数来获得。

 

2.2.3 管理请求

 

        管理请求允许与管理模型进行低级别的交互。它不同于高级别的命令(比如创建一个jms的queue命令:create-jms-queue),使用管理请求可以对服务器的配置像对直接对xml配置文件进行编辑而进行读和修改操作。整个配置用一个有地址的资源树进行表示，这个树上的每个节点提供一系列的操作供执行。

一个管理请求包含三个部分:地址，操作名和可选的操作参数

这是一个管理请求的规约:

 

 
规约代码 复制代码  收藏代码
  1. [/node-type=node-name (/node-type=node-name)*] : operation-name [( [parameter-name=parameter-value (,parameter-name=parameter-value)*] )]  
 

举个例子:

Shell代码 复制代码  收藏代码
  1. /profile=production/subsystem=threads/bounded-queue-thread-pool=pool1:write-core-threads (count=0, per-cpu=20)  
 
Tab补全代码 复制代码  收藏代码
  1. Tab补全:   
  2. 所有的命令和参数都支持tab补全。比如结点的类型，名字，操作名和参数名。我们正考虑增加别名在tab补全时可以显示更少的选项，然后在后台翻译成相应的管理请求。  

 

     管理请求字符串之间的空格是不敏感的 。

 

2.2.3.1 管理资源的地址

 

       管理请求可以不含有地址信息和参数,比如::read-resource, 可以列出当前Node下的所有节点类型。

 

        在管理命令中，为了消除歧义需要以下几个前缀:

  •     "  : "   --- 在当前节点上执行操作，比如:

              [subsystem=web] :read-resource(recursive="true")

  •   " ./"  ---- 在当前节点的子节点上执行操作,如：

           [subsystem=web] ./connector=http:read-resource

               这个操作的全路径地址是: subsystem=web,connector=http.

  •    " /" --- 在根节点上执行操作,如：

                 [subsystem=web] /:read-resource   或子节点: [subsystem=web] /subsystem=logging:read-resource

 

2.2.3.2 操作类型和操作描述列表

 

       操作的类型可以分为在任何节点上的通用操作和在特殊节点上的特殊操作(如:subsystem).通用的操作包括:

 

操作列表代码 复制代码  收藏代码
  1. add   
  2. remove   
  3. read-attribute   
  4. write-attribute   
  5. read-children-names   
  6. read-children-resources   
  7. read-children-types   
  8. read-operation-description   
  9. read-operation-names   
  10. read-resource   
  11. read-resource-description  

       对于特殊操作列表（比如在logging子系统上可以进行的特殊操作),可以通过管理的节点进行查询。比如，查询一个单独运行服务器上logging子系统上所支持的操作:

Shell代码 复制代码  收藏代码
  1. [[standalone@localhost:9999 /] /subsystem=logging:read-operation-names   
  2. {   
  3.    "outcome" => "success",   
  4.    "result" => [   
  5.        "add",   
  6.        "change-root-log-level",   
  7.        "read-attribute",   
  8.        "read-children-names",   
  9.        "read-children-resources",   
  10.        "read-children-types",   
  11.        "read-operation-description",   
  12.        "read-operation-names",   
  13.        "read-resource",   
  14.        "read-resource-description",   
  15.        "remove-root-logger",   
  16.        "set-root-logger",   
  17.        "write-attribute"  
  18.    ]   
  19. }  

        可以看出，logging支持三个额外特殊的操作:change-root-log-level , set-root-logger and remove-root-logger.

 

进一步关于被管理节点描述或者被管理节点上操作的描述，可以通过一下命令查询：

 

Shell代码 复制代码  收藏代码
  1. [standalone@localhost:9999 /] /subsystem=logging:read-operation-description(name=change-root-log-level)   
  2. {   
  3.    "outcome" => "success",   
  4.    "result" => {   
  5.        "operation-name" => "change-root-log-level",   
  6.        "description" => "Change the root logger level.",   
  7.        "request-properties" => {"level" => {   
  8.            "type" => STRING,   
  9.            "description" => "The log level specifying which message levels will be logged by this logger.   
  10.                             Message levels lower than this value will be discarded.",   
  11.            "required" => true   
  12.        }}   
  13.    }   
  14. }  

 

Java代码 复制代码  收藏代码
  1. <STRONG>递归模式查看全部信息输入::read-resource(recursive=true).</STRONG>  
递归模式查看全部信息输入::read-resource(recursive=true).

 

2.2.4 命令行历史信息

 

       命令行(和操作请求)历史信息默认是开启的。历史信息在内存中和硬盘文件中都有保存,并且命令行历史信息在命令行对话之间保存。
       命令行历史信息文件信息保存在名为.jboss-cli-history的文件中，这个文件会在用户的home目录下自动创建。当启动命令行模式时，这个文件会被读入内存中来对初始化命令行历史信息。

    在命令行对话中，你可以使用上下键来向前和向后查阅命令行历史信息。


      命令行历史可以通过history命令进行操作。如果history命令执行时不带参数，它会将内存中所有的历史命令和操作打印出来(取决于历史信息的最大个数，默认500). history 命令支持3个可选的参数:

Shell代码 复制代码  收藏代码
  1. disable-关闭历史记录功能(但不会清除已经记录的历史信息)   
  2. enable-开启历史记录功能(从上次关闭历史记录前的最后一条记录开始)   
  3. clear-清除内存种的历史记录(但不会清除文件中的信息)   

2.2.5 批处理

        批处理模式允许用户以将一组命令和操作按照原子的方式执行。如果一个命令或者操作失败，那么在批处理中成功执行的子命令将会被回滚。
        不是所有的命令都可以批处理种执行。比如: cd, ls, help等不能被转换成操作请求的就不可以在批处理种执行。 只有可以转换成为操作请求的命令才可以在批处理种执行。批处理的命令实际上是
以组合操作请求的方式执行的。
执行batch命令进入批处理模式:

Shell代码 复制代码  收藏代码
  1. [standalone@localhost:9999 /] batch   
  2. [standalone@localhost:9999 / #] /subsystem=datasources/data-source="java\:\/H2DS":enable   
  3. [standalone@localhost:9999 / #] /subsystem=messaging/jms-queue="newQueue":add  

run-batch执行一个批处理:

 

Shell代码 复制代码  收藏代码
  1. [standalone@localhost:9999 / #] run-batch   
  2. The batch executed successfully.  

 
退出批处理编辑模式并且不丢失更改:

Shell代码 复制代码  收藏代码
  1. [standalone@localhost:9999 / #] holdback-batch   
  2. [standalone@localhost:9999 /]  

 

稍后重新激活批处理:

Shell代码 复制代码  收藏代码
  1. [standalone@localhost:9999 /] batch   
  2. Re-activated batch   
  3. #1 /subsystem=datasources/data-source=java:/H2DS:\/H2DS:enable  


还有一些比较重要的批处理命令(使用tab补全来查看以下列表):

Shell代码 复制代码  收藏代码
  1. clear-batch   
  2. edit-batch-line (e.g. edit-batch line 3 create-jms-topic name=mytopic)   
  3. remove-batch-line (e.g. remove-batch-line 3)   
  4. move-batch-line (e.g. move-batch-line 3 1)   
  5. discard-batch   

2.3 配置文件


域管理和单服务器的xml配置可以在configuration子目录下找到:

Shell代码 复制代码  收藏代码
  1. domain/configuration/domain.xml   
  2. domain/configuration/host.xml   
  3. standalone/configuration/standalone.xml  

 
       一个被管理的域有两种类型的配置:一种是对整个域的配置(domain.xml)另外一种是对每个加入到域里主机(host)的配置(host.xml).关于如何配置域拓详细信息请参考"域配置"章节。xml配置是核心可靠的配置源。任何通过web接口或者命令行方式对配置的更改都持久化到XML配置文件中.如果一个域或者单独服务器离线,xml配置文件也可以进行手动更改，任何更改都在下一次启动时生效。
        但是，我们鼓励用户使用web接口或者命令行方式更改配置文件，而不是采用离线编辑的方式对配置文件进行更改。对正在处理的配置文件进行的外部更改将不会被探测到，从而有可能会被覆盖。

 

 

evilying
关注
专栏目录
JBoss7配置指南(三)
jboss_cn的专栏
09-19 283
(翻译整理by Jim Ma) 4.管理任务 4.1 网络接口和端口 4.1.1 网络接口声明 JBoss AS 7 在整个配置文件中都引用命名的接口。一个网络接口通过指定一个逻辑名和选择一个物理接口来声明。 [standalone@localhost:9999 /] :read-children-names(child-type=...
JBoss7 安装配置
xuedongabc的专栏
07-12 157
一、下载安装 1、下载地址： http://www.jboss.org/jbossas/downloads ，下载Certified Java EE 6 Full Profile版本。 2、解压 jboss-as-7.1.1.Final.zip 到 D:\programs。 3、设置环境变量如下： 系统变量-&gt;新建-&gt;变量名：JAVA_HOME = C:\Java 以下是非...
JBoss7配置指南
weixin_33894992的博客
05-23 587
JBoss7配置指南   1.    jboss各主要版本特性... 3 1.1.     jboss4特性... 3 1.2.     jboss5特性... 5 1.3.     jboss6特性... 6 1.4.     jboss7特性... 7 2.    为什么JBoss AS7 这么快... 8 3.    JBoss AS7中的新概念－域... 10 3.1. ...
JBoss7配置指南及管理员手册.doc
04-10
### JBoss7配置指南及管理员手册 #### JBoss7配置说明及核心管理概念 JBoss7作为一款先进的Java应用服务器，其配置与管理对于确保应用的高效稳定运行至关重要。本文档将详细介绍JBoss7的核心配置及管理概念，帮助...
jboss7配置指南
08-17
《深入解析：JBoss7配置指南之核心管理概念》 一、引言 JBoss AS 7，作为一款成熟的企业级应用服务器，提供了强大的功能和灵活性，满足了各种复杂的应用需求。本文将深入探讨JBoss7的核心管理概念，特别是运行模式...
JBoss7.1.1配置指南及管理员手册PDF版
06-23
JBoss7.1.1配置指南及管理员手册是一份全面的指南，旨在帮助用户理解和配置JBoss应用服务器的各个方面的设置和管理。本文将重点介绍JBoss7.1.1的核心特性和管理员需要了解的关键概念，包括JBoss的主要版本特性、...
jboss 7 配置 jms
04-06
NULL 博文链接：https://dujianmeng.iteye.com/blog/1552685
JBoss7.1.1配置指南及管理员手册
04-18
jboss7.1超详细说明，有群的说明 也有jboss7.1独有的”域“说明和详细配置
JBoss AS7教程
06-10
我总结的JBoss AS7教程资料，几全面的，对目前公司的项目都很有帮助的，希望对j2ee的人员进行jboss升级的掌握有帮助。
Jboss7快速入门手册
06-27
Jboss7快速入门手册，作者比尔板三，主要介绍Jboss7新特性，部署配置，管理Jboss和常见问题。
Jboss7 配置 入门级配置
dp studio
11-06 1877
试手Jboss7~ 记录一下今天解决的一些问题。 一、eclipse只支持jboss5。    解决办法：下载jboss tools.    eclipse 3.7 的eclipse下载地址：http://download.jboss.org/jbosstools/updates/development/indigo/ 二、在服务器配置好jboss之后，只有127.0.0
JBoss7安装配置
IT打工匠
10-10 2947
一、JBoss优点： a、Jboss支持热部署，将归档后的JAR、WAR文件到部署目录下自动加载部署，自动更新。 b、在高并发访问时，性能比Tomcat更加优秀、高效。 c、Jboss在设计方面与Tomcat相比，进行了线程池和连接池的优化。 d、Jboss已经成为Java中间件的一个企业级的Web应用，Tomcat是轻量级应用，作为Java开发调试环境使用广泛。 e、配置简单，占用系统资
JBoss7配置指南(二)
张星的博客
10-09 2125
3 核心管理概念   3.1 运行模式   JBoss Application Server 7可以被启动到两个不同的模式.域模式可以用来运行和管理多个jboss服务器的拓扑， 或者是单服务器模式，仅运行一个服务器的实例   3.1.1 单服务器模式 对于大多数
jboss7开发配置指南
akjw008的专栏
01-17 632
目录(?)[-] Jboss7下载与安装 1     官方下载2     目录介绍与启动 21  目录介绍22  启动jboss 3    Eclipse中配置jboss7 项目部署 11  部署第三方jar包12  部署项目ifc包13  部署warejb包和配置依赖关系 JNDI获取 1    绑定jndi方式2    代码定义jndi 数据源配置
jboss7 数据源密码加密
hwm的专栏
01-22 5216
参考：http://stackoverflow.com/questions/10520997/jboss-as-7-1-datasource-how-to-encrypt-password/10542809#10542809 以及：http://minstrel.iteye.com/blog/1547168 应用场景：没加密前jboss数据源是明文密文，不安全。 jboss版
JBoss7配置与调试指南
"JBoss7的学习配置需要注意一些关键步骤，包括标准启动、调试模式启动、创建用户、WEB访问以及配置远程访问。" 在JBoss7的配置过程中，首先我们需要了解如何进行标准启动。标准启动可以通过执行/bin/standalone.bat...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值