JBoss AS7手册Word格式.docx
- 文档编号:21542327
- 上传时间:2023-01-31
- 格式:DOCX
- 页数:15
- 大小:26.30KB
JBoss AS7手册Word格式.docx
《JBoss AS7手册Word格式.docx》由会员分享,可在线阅读,更多相关《JBoss AS7手册Word格式.docx(15页珍藏版)》请在冰豆网上搜索。
这会在你的系统中启动5个进程:
3个JBossASServer的实例;
1个DomainController(Domain控制器)进程,这个进程用来集中控制所有属于这个"
的server;
和一个轻量的ProcessController,负责管理其他的4个进程并监听它们的生命周期。
如果你想工作在"
,打开字符终端并且cd到解压的bin目录,然后运行"
standalone"
$cdbin
$./standalone.sh
standalone.bat
这会在你的系统中启动一个进程,一个单个的JBossASserver的实例。
停止正在运行的StandaloneServer实例
一个正在运行的standaloneserver实例可以通过以下方法来停止:
如果你能访问启动该Server的命令行控制台,只要按下Ctrl+C就能够干净的停止这个Server。
∙如果不行的话,可以从一个新的命令行控制台,输入以下的命令来给运行的standaloneserver实例发出一个shutdown指令:
$./jboss-admin.sh--connectcommand=:
shutdown
"
--connect"
默认会连接localhost的9999端口。
如果你的server使用的不是默认端口或者没有绑定到localhost地址,你就需要为--connect指定host和port,像下面这样:
$./jboss-admin.sh--connectcontroller=<
IP>
:
<
port>
command=:
是指这个Server绑定的IP地址,<
是管理端口.(配置在standalone.xml中)
如果你是取出了AS7的源码,会有好几个demos,在源码的demos模块下,下面会详细讲到。
DomainMode和StandaloneMode
AS7一个重要的特性是,能够从单个的控制点管理多个AS的实例。
这样的一组Server作为一个"
的成员,由DomainController进程统一管理。
Domain可以跨越多个物理或虚拟主机,一台机器上的所有AS实例由HostController进程负责控制。
HostController和DomainController进行交互来控制该机器上的AS进程,并且协助DomainController对它们进行管理。
当你将JBossAS启动为"
(通过domain.sh或者domain.bat),你实际上启动了一个DomainController,一个HostController以及通常至少一个AS实例。
许多用户案例中,并不需要domainmode下的集中化的管理能力,对于这些情况,AS能够运行在"
,这种模式下,每一个AS实例运行在独立的进程,和AS3,4,5和6一样。
Standalone的Server实例可以通过standalone.sh或者standalone.bat脚本来运行。
如果运行了不止一个standalone实例并且需要管理多台服务器,那么就需要用户自行来协调管理这多台服务器。
一个server实例不能在domainmode和standalonemode之间进行转换,例如,你不能运行domain.sh,停止domain,然后运行standalone.sh,并且希望和运行domainmode时有任何关联。
两种mode的配置文件是分开的。
在未来的发布中,我们也许会包含某个工具来简化将一个服务的配置文件从domainmode转换成standalonemode的工作。
决定使用DomainModel还是StandaloneMode
什么用户案例适合使用DomainModel,而哪些又更适合StandaloneMode呢?
Domainmode用于统一协调管理多个服务器,通过JBossAS提供的中心控制点,能够管理多台服务器,并具有丰富的功能以维持所有服务器配置文件的一致性以及将对配置文件的修改(包括部署的应用)统一应用到所有的服务器中。
理解DomainMode和StandaloneMode只是与如何管理你的服务器有关这一点很重要,并不会影响响应最终用户请求的能力。
这个差别会在高可用集群到来时特别重要。
当前的AS7beta1版本并不支持HA功能,然而有必要理解一点HA功能在今后的版本被添加之后,DomainMode和StandaloneMode就会有些功能的交叉。
也就是说,可以从HA集群配置成一群以StandaloneMode运行的服务器。
总之,Domain和StandaloneMode决定服务器如何被管理,而不是它们能提供的功能。
那么,我们给出结论:
∙如果单个Server不需要从DomainMode中获得任何东西,那么standalonemode是更好的选择。
∙对于多Server的产品环境,选择DomainMode还是StandaloneMode归结为用户是否想要使用DomainMode提供的中心管理能力。
一些企业已经开发他们自己的经过考验的多Server管理能力并且能够舒服的统一对多个JBossAS实例做修改,对于这些企业,一个有单个standalonemodeAS实例组成的多server架构仍然是一个好的选择。
∙在开发阶段,StandaloneMode会更合适。
通常,对于embeddingJBossAS没有DomainMode;
比如:
运行在Arquillian-based的测试套件过程中。
在DomainMode中能够完成的任何单个Server的配置同样也能在StandaloneMode中配完成,所以,即使正在开发的应用最终要运行在DomainMode下,大多数的开发工作仍能在StandaloneMode下完成。
∙Domainmode在一些高级开发场景下会有用;
对于那些需要在多个AS实例之间进行交互的操作。
开发人员可能会发现将多个server设置成domain的成员是一个有效的方法来启动多server集群。
AS7发布文件中的内容
AS7发布文件中包含以下的目录:
bin--启动脚本的所在地
docs--license文件,文档,schemas,范例,等等.这个目录下的内容会随着开发而不断增加。
modules--AS7基于模块classloading架构,Server使用的各种模块被放置在这里。
一般而言,最终用户不应该对这里的内容做任何修改。
domain--放置与DomainMode相关的内容。
配置文件,部署的内容,用户在运行DomainMode时进程写一些文件的地方,更多的细节参考后面的章节。
standalone--放置与StandaloneMode相关的内容。
配置文件,部署的内容,用户在运行StandaloneMode时进程写一些文件的地方,更多的细节参考后面的章节。
domain目录下的内容
以下是仅与domainmode相关的目录内容.
configuration--Domain、HostController以及跑在这个安装上的所有Servers的配置文件。
如果我们已经做得足够好,这些配置文件是最终用户唯一需要修改的配置文件(除了用户自己部署的应用的描述文件)。
更多关于其中的文件的内容,下面会讲到。
content--一个给HostController的内部工作空间,用于存储部署的内容。
这个目录不应该被最终用户操作。
log--用于ProcessController和HostController写日志文件的目录。
servers--每一个AS实例用于写的空间。
每一个AS实例都有自己的子目录,在第一次启动的时候会创建该目录。
在一个Server的子目录下,会包含以下子目录:
data--Server用于写需要在重启是回复的数据。
log--Server的日志文件
temp--Server用于写临时文件的目录
目录下的内容
仅与使用standalonemode相关。
configuration--运行StandaloneServer是的配置文件。
data--Server存储的信息,为了重启在重启时恢复数据。
deployments--如果希望Server在运行时能自动检查和部署,可以把要部署的文件放在该目录下。
ServermanagementAPI暴露了其它的方法来将部署文件,使用API是更好的部署方法。
然后我们意识到,在AS7开发的早期阶段,围绕deploymentAPI的工具还不完善,很多用户愿意使用deploymentdirectory来部署文件。
注意:
不支持基于文件系统扫描来部署文件。
log--Server的日志文件
tmp--Server存储临时文件的地方
DomainMode"
配置文件
位于domain/configuration目录.
domain.xml--domain的主要配置文件,包括各种给ASinstance的"
profile"
配置文件。
一个profile配置包括各种子系统(subsystem)的配置(比如:
embeddedJBossWebinstance是一个子系统,JBossTStransactionmanager是一个subsystem,等等)。
包括子系统要打开的socketgroup的定义,以及"
servergroups"
的定义,对于一个profile,会映射一组socket定义以及0到多个deployment。
每一个单独的Server会被映射(在host.xml中,下面会讲到)到一个servergroup;
Severgroup的配置最大可能的定义了单个server的配置。
一个domain.xml文件必须位于安装目录的domain/configuration下,如果不运行domaincontroller,不需要有这个文件;
仅仅配置了了HostController用于连接remoteDomainController时,此时domain.xml会被忽略。
用户可以看一下AS7configurationschema,从<
domain>
元素开始,来学习更多关于DomainContoller的内容。
host.xml--HostController的配置文件。
每一个安装必须有host.xml文件,包含了HostController的配置信息,主要有:
∙运行的ASServerinstance的名称列表,以及他们所属的servergroup。
∙配置HostController怎么联系DomainController以便注册自己并访问domain配置。
既可能配置为如果查找和联系一个remoteDomainController,也可能配置为告诉HostController自己作为DomainController.
∙本地安装的一些特别的配置项。
比如,domain.xml中定义namedinterface能够在host.xm中l映射到一个实际的特定机器的IP地址
host>
元素开始,来学习更多关于HostContoller的内容。
logging.properties--包含HostController和ProcessController的日志配置。
也定义每个ASinstance初始启动的日志配置配置。
一旦Server启动到这个配置生效,启动日志配置会被domain.xml中日志配置所覆盖。
StandaloneMode"
位于standalone/configuration目录.
standalone.xml--ASinstance的主要配置文件。
除此之外,包含了ASinstance运行的"
的配置。
也包括subsystem可能打开的socket的定义。
server>
元素开始,来学习更多关于standaloneASinstance的内容。
logging.properties--包含了启动时初始化的日志配置信息。
在Server启动过程进行到standalone.xml中的日志配置信息可用时,启动日志配置会被standalone.xml文件中的日志配置覆盖。
通用配置概念
有一些通用的配置概念对于DomainMode和StandaloneMode均适用:
扩展(Extensions)
一个extension是一个扩展了Server核心功能的模块。
AScore是非常简单和轻量的,大多数与用户相关的功能通过扩展来提供。
一个扩展打包成一个模块放置在modules目录下。
用户如果要激活一个特定的扩展,就在domain.xml或者standalone.xml文件中包含<
extension/>
标签并指定扩展名。
extensions>
...
<
extensionmodule="
org.jboss.as.transactions"
/>
org.jboss.as.web"
/>
org.jboss.as.webservices"
org.jboss.as.weld"
/extensions>
路径Paths
是指文件系统路径的一个逻辑名称。
domain.xml,host.xml和standalone.xml配置文件都有一个段落来申明路径。
配置中的其它段落则可以通过逻辑名称来引用,而不必指定详细的全路径(在不同的机器上可能不一样)。
比如:
logging子系统配置中包含了对"
jboss.server.log.dir"
路径的引用,用来指向服务器的"
log"
目录。
filerelative-to="
path="
server.log"
AS自动提供了一些标准的路径,用户不需要在配置文件中配置它们:
jboss.home-AS的跟目录
∙user.home-用户的home目录
∙user.dir-用户当前的工作目录
∙java.home-java安装目录
∙jboss.server.base.dir-单独serverinstance的根目录
∙jboss.server.data.dir-server存储数据文件的目录
∙jboss.server.log.dir-server日志文件的存放目录
∙jboss.server.tmp.dir-server存储临时文件的目录
∙jboss.domain.servers.dir-hostcontroller用户为单个serverinstance存放工作文件的目录(domainmodeonly)
用户可以在配置文件中增加<
path/>
标签和定义自己的路径,并可以覆盖除上面前天个路径之外的所有路径。
pathname="
example"
relative-to="
jboss.server.data.dir"
详细内容可以参考XSD.
在domain.xml中,<
除了name属性之外不需要其它的属性,也就是不需要任何关于实际文件系统路径的信息:
x"
这个配置项的意思是,"
有一个名称为'
x'
的路径,在domain.xml可以被引用,而'
的指向的实际的文件系统的路径由每一个主机的host.xml配置文件给出。
如果使用这种方法,在每台主机的host.xml中就必须有一个path标签来制定其真实的文件系统路径:
/var/x"
接口(Interfaces)
是为networkinterface/IPaddress/hostname定义逻辑名,用于绑定sockets。
domain.xml,host.xml和
standalone.xml的配置都包含了一个段落来申明接口。
其它的段落则可以使用逻辑名称来引用,而不用指定完整的全名称(不同的机器可能不一样)。
一个接口配置包含接口的逻辑名称以及用户解析物理地址的标准信息。
标准是两种类型中的热和一个:
一个element用于指定该接口需要被绑定到一个通配符地址,或者接口或地址需要匹配的一个包含了一个或多个特征的列表。
interfacename="
global"
!
--Usethewildcardaddress-->
any-address/>
/interface>
external"
nicname="
eth0"
default"
--Matchanyinterface/addressontherightsubnetifit'
s
up,supportsmulticastandisn'
tpoint-to-point-->
subnet-matchvalue="
192.168.0.0/16"
up/>
multicast/>
not>
point-to-point/>
/not>
loopback"
inet-addressvalue="
127.0.0.1"
关于各种标准选项的详细信息,请查看XSD。
domain.xml中的<
interface/>
标签不需要包含除name属性外的任何属性;
也就是它不需要指定这个名称关联的具体IP地址信息:
internal"
这个配置是说,"
internal'
的接口,公domain.xml其它部分引用。
'
实际对应的IP地址由每一台主机的host.xml配置文件来指定。
如果使用该方法,在每台主机的host.xml中,必须要有一个interface元素来指定获取IP地址的标准:
eth1"
Socket绑定以及组绑定(SocketBindingsandSocketBindingGroups)
socketbinding用户给socket命名。
domain.xml和standalone.xml都包含了一个段落用于申明socketbinding。
其它的段落则可以通过逻辑名称来引用,而不是使用详细的全名(不同的主机可能不一样)。
一个socketbinding包含了以下信息:
∙name--socket配置的逻辑名称,定义好之后,能够用在配置文件中的其它地方
∙port--socket绑定的端口(注意:
servers通过应用一个增加/减少的数值来改变配置好的端口,下面会讲到)
∙interface(optional)--socket要绑定的接口的名称(上面讲到了接口)
∙multicast-address(optional)--广播地址,如果socket要使用广播
∙multicast-port(optional)--广播端口,如果socket要使用广播
∙fixed-port(optional,defaultstofalse)--如果为true,则申明port的值不能被覆盖
Socket绑定配配置被放置在<
socket-binding-group/>
元素里。
这个元素包括一个default-interface属性;
如果没有指定interface,这个interface将会作为默认的interface使用。
SystemProperties
domain.xml,host.xmlandstandalone.xml,中有很多地方可以设置系统属性。
standalone.xml中的值在server启动过程中解析。
domain.xml和host.xml中的值在在servers加载的时候解析。
ProfilesandSubsystems
domain.xml和standalone.xml中最有意义的配置部分是一个(standalone
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- JBoss AS7手册 AS7 手册