A.35. modcluster 子系统属性


modcluster 子系统具有以下结构:

load-provider=dynamic 资源允许您配置因素,如 CPU、会话、堆、内存和权重来确定负载均衡行为。

load-provider=simple 资源仅允许将静态常量设置为 factor 属性。当用户不需要动态或复杂的规则来负载平衡传入的 HTTP 请求时,这可帮助。

注意

这些表中的属性名称会在管理模型中出现时列出,例如使用管理 CLI 时。请参阅位于 EAP_HOME/docs/schema/jboss-as-mod-cluster_3_0.xsd 的 schema 定义文件,以查看 XML 中出现的元素,因为管理模型可能会有所不同。

Expand
表 A.123. 代理配置选项
属性default描述

advertise

true

是否启用基于多播的广告机制。

advertise-security-key

 

它是 httpd 实例和侦听 httpd 实例的 JBoss EAP 服务器之间的共享机密。

advertise-socket

 

要注册的反向代理上的负载均衡器名称。

auto-enable-contexts

true

如果设置为 false,则上下文将在反向代理中注册为 disabled。您可以使用 enable-context 操作或使用 mod_cluster_manager 控制台启用上下文。

balancer

 

要注册的反向代理上的负载均衡器名称。如果没有设置,则使用 ManagerBalancerName 指令在 Apache HTTP 服务器上配置该值,默认为 mycluster

connector

 

mod_cluster 反向代理将连接到的 Undertow 侦听器的名称。

excluded-contexts

 

要排除使用反向代理注册的上下文列表。如果没有显示主机,则假定主机为 localhostROOT 表示 Web 应用的根上下文。

flush-packets

false

是否启用向 Web 服务器清空的数据包。

flush-wait

-1

在 httpd 中清空数据包前等待的时间。max 值为 2,147,483,647

listener

 

将注册到反向代理的 Undertow 侦听器的名称。

load-balancing-group

 

如果设置,则请求将发送到负载均衡器上的指定的负载均衡组。

max-attempts

1

反向代理在放弃前尝试向 worker 发送给定请求的次数。

node-timeout

-1

到 worker 的代理连接的超时(以秒为单位)。这是 mod_cluster 将在返回错误前等待后端响应的时间。如果 node-timeout 属性未定义,则使用 httpd ProxyTimeout 指令。如果 ProxyTimeout 未定义,则使用 httpd Timeout 指令,则默认为 300 秒。

ping

10

等待 ping 的 pong 回答的时间(以秒为单位)。

proxies

 

mod_cluster 的代理列表,用于注册 socket-binding-group 中的 outbound-socket-binding 定义。

proxy-list

 

代理列表。格式为 HOST_NAME:PORT,用逗号分开。已弃用,以代替 代理

proxy-url

/

MCMP 请求的基本 URL。

session-draining-strategy

DEFAULT

会话排空 web 应用程序未部署中使用的策略。有效值为 DEFAULTALWAYSNEVER

DEFAULT
只有 Web 应用无法区分时,仅在 web 应用取消部署前排空会话。
ALWAYS
始终在 web 应用取消前排空会话,即使是可分布式 Web 应用也是如此。
NEVER
在 web 应用取消部署前不要排空会话。

load-provider=simple

 

如果没有动态加载提供程序,要使用的负载提供程序。它为每个群集成员分配 1 的负载因子,并在不应用负载平衡算法的情况下平均分发工作。

smax

-1

httpd 中软最大闲置连接数。

socket-timeout

20

在超时前,等待 httpd 代理到 MCMP 命令的响应的秒数,并将代理标记为错误。

ssl-context

 

对 mod_cluster 使用的 SSLContext 的引用。

status-interval

10

从应用服务器发送到反向代理的 STATUS 消息的秒数。允许的值介于 12,147,483,647 之间。

sticky-session

true

如果可能,后续的给定会话的请求是否应路由到同一节点。

sticky-session-force

false

当负载均衡器无法将请求路由到它被阻塞的节点时,反向代理是否应该返回错误。如果禁用粘性会话,则忽略此设置。

sticky-session-remove

false

删除有关故障切换的会话信息。

stop-context-timeout

10

对于不可分布式上下文,等待上下文处理待处理请求、可分布式上下文或销毁活动会话的最长时间(以秒为单位)。

ttl

-1

超过 smax 的闲置连接的时间(以秒为单位)。允许的值介于 -12,147,483,647 之间。

worker-timeout

-1

在 httpd 中等待可用工作程序处理请求的超时。允许的值介于 -12,147,483,647 之间。

Expand
表 A.124. load-provider=dynamic Configuration Options
属性default描述

decay

2

标语。

history

9

历史记录。

initial-load

0

节点报告的初始负载。有效范围为 0-1000 表示最大负载。

此属性有助于逐渐增加新加入节点的负载值,以避免在加入集群时过载。

您可以通过将值设置为 -1 来禁用此行为。禁用后,节点会报告负载值 100,表示它在加入集群时没有负载。

Expand
表 A.125. custom-load-metric Attribute Options
属性default描述

capacity

1.0

指标的容量。

class

 

自定义指标的类名称。

属性

 

指标的属性。

weight

1

指标的权重。

Expand
表 A.126. Load-metric Attribute Options
属性default描述

capacity

1.0

指标的容量。

属性

 

指标的属性。

type

 

指标的类型。有效值为 cpu,mem,heap,sessions,receive-traffic,send-traffic, requests ,requests, 或 busyness.

weight

1

指标的权重。

Expand
表 A.127. SSL 属性选项
属性default描述

ca-certificate-file

 

证书颁发机构。

ca-revocation-url

 

证书颁发机构撤销列表。

certificate-key-file

${user.home}/.keystore

证书的密钥文件。

cipher-suite

 

允许的密码套件。

key-alias

 

密钥别名。

password

changeit

密码.

protocol

TLS

启用的 SSL 协议。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat