8.4. 管理服务器
8.4.1. 配置服务器组
以下是服务器组定义的示例:
<server-group name="main-server-group" profile="full"> <jvm name="default"> <heap size="64m" max-size="512m"/> </jvm> <socket-binding-group ref="full-sockets"/> <deployments> <deployment name="test-application.war" runtime-name="test-application.war"/> <deployment name="jboss-helloworld.war" runtime-name="jboss-helloworld.war" enabled="false"/> </deployments> </server-group>
可以使用管理 CLI 或管理控制台 运行时 选项卡配置服务器组。
添加服务器组
以下管理 CLI 命令可用于添加服务器组。
/server-group=SERVER_GROUP_NAME:add(profile=PROFILE_NAME,socket-binding-group=SOCKET_BINDING_GROUP_NAME)
更新服务器组
以下管理 CLI 命令可用于更新服务器组属性:
/server-group=SERVER_GROUP_NAME:write-attribute(name=ATTRIBUTE_NAME,value=VALUE)
删除服务器组
以下管理 CLI 命令可用于删除服务器组:
/server-group=SERVER_GROUP_NAME:remove
服务器组属性
服务器组需要以下属性:
-
名称
:服务器组名称。 -
配置集
:服务器组配置集名称。 -
socket-binding-group
:用于组中服务器的默认套接字绑定组。这可以基于每台服务器覆盖。
服务器组包括以下可选属性:
-
management-subsystem-endpoint
: 设置为true
,使属于服务器组的服务器使用来自其remoting
子系统的端点连接到主机控制器(必须显示remoting
子系统才能正常工作)。 -
socket-binding-default-interface
:此服务器的套接字绑定组默认接口。 -
socket-binding-port-offset
:添加到套接字绑定组给定的端口值的默认偏移。 -
Deployments :要部署到组中的服务器上的部署内容。
-
JVM
:组中所有服务器的默认 JVM 设置。主机控制器将这些设置与host.xml
中提供的任何其他配置合并,以派生用于启动服务器的 JVM 设置。 -
Deployment-overlays
:此服务器组中定义部署覆盖和部署之间的链接。 -
system-properties
:要在组中的服务器上设置的系统属性。
8.4.2. 配置服务器
默认 host.xml
配置文件定义三台服务器:
<servers> <server name="server-one" group="main-server-group"> </server> <server name="server-two" group="main-server-group" auto-start="true"> <socket-bindings port-offset="150"/> </server> <server name="server-three" group="other-server-group" auto-start="false"> <socket-bindings port-offset="250"/> </server> </servers>
名为 server-one
的服务器实例与 main-server-group
关联,并继承该服务器组指定的子系统配置和套接字绑定。名为 server-two
的服务器实例也与 main-server-group
关联,但也定义了套接字绑定 port-offset
值,因此不会与 server-one
使用的端口值冲突。名为 server-three
的服务器实例与 other-server-group
关联,并使用该组的配置。它还定义 port-offset
值,并将 auto-start
设置为 false
,以便此服务器在主机控制器启动时不会启动。
可使用管理 CLI 或管理控制台 Runtime 选项卡配置服务器。
添加服务器
以下管理 CLI 命令可用于添加服务器。
/host=HOST_NAME/server-config=SERVER_NAME:add(group=SERVER_GROUP_NAME)
更新服务器
以下管理 CLI 命令可用于更新服务器属性:
/host=HOST_NAME/server-config=SERVER_NAME:write-attribute(name=ATTRIBUTE_NAME,value=VALUE)
删除服务器
以下管理 CLI 命令可用于移除服务器。
/host=HOST_NAME/server-config=SERVER_NAME:remove
服务器属性
服务器需要以下属性:
-
名称
:服务器的名称。 -
组
:域模型中的服务器组的名称。
服务器包括以下可选属性:
-
Auto-start
: 主机控制器启动时是否应启动此服务器。 -
socket-binding-group
:此服务器所属的套接字绑定组。 -
socket-binding-port-offset
:添加到此服务器的套接字绑定组给出的端口值中的偏移值。 -
update-auto-start-with-server-status
: 使用服务器状态更新auto-start
属性。 -
接口
:可用于服务器使用的、完全指定的命名网络接口的列表。 -
JVM
:此服务器的 JVM 设置。如果没有声明,则从父服务器组或主机继承设置。 -
路径
:指定文件系统路径的列表。 -
system-property
: 此服务器上要设置的系统属性列表。
8.4.3. 启动和停止服务器
您可以通过导航到 Runtime 选项卡并选择适当的主机或服务器组,从管理控制台中对服务器执行操作,如启动、停止和重新加载。
请参阅以下 命令,以使用管理 CLI 执行这些操作。
启动服务器
您可以在特定主机上启动单个服务器。
/host=HOST_NAME/server-config=SERVER_NAME:start
您可以启动指定服务器组中的所有服务器。
/server-group=SERVER_GROUP_NAME:start-servers
停止服务器
您可以在特定主机上停止单个服务器。
/host=HOST_NAME/server-config=SERVER_NAME:stop
您可以停止指定服务器组中的所有服务器。
/server-group=SERVER_GROUP_NAME:stop-servers
重新加载服务器
您可以在特定主机上重新加载单个服务器。
/host=HOST_NAME/server-config=SERVER_NAME:reload
您可以重新加载指定服务器组中的所有服务器。
/server-group=SERVER_GROUP_NAME:reload-servers