A.37. ModCluster Subsystem Attributes


modcluster 子系统具有以下结构:

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

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

注意

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

表 A.136. 代理配置选项
属性默认描述

advertise

true

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

advertise-security-key

 

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

advertise-socket

 

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

auto-enable-contexts

true

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

balancer

 

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

连接器

 

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

excluded-contexts

 

要排除与反向代理注册之外的上下文列表。如果未指明主机,则假定主机为 localhostROOT 表示 Web 应用的根上下文。

flush-packets

false

是否启用数据包刷新到 Web 服务器.

flush-wait

-1

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

监听程序

 

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

load-balancing-group

 

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

max-attempts

1

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

node-timeout

-1

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

ping

10

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

代理

 

要注册到 socket-binding-group 中的 outbound -socket-binding 定义的 mod_cluster 代理列表。

proxy-list

 

代理列表.格式为 HOST_NAME:PORT,用逗号分隔。弃用了 代理

proxy-url

/

MCMP 请求的基本 URL。

session-draining-strategy

DEFAULT

取消部署 Web 应用程序期间使用的会话排空策略。有效值为 DEFAULTALWAYSNEVER

DEFAULT
只有 Web 应用不可分发时,才可排空会话,然后再取消部署。
ALWAYS
在 Web 应用取消部署之前始终排空会话,即使是对于可分布式 Web 应用也是如此。
NEVER
在 Web 应用取消部署前,请勿排空会话。

load-provider=simple

 

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

SMAX

-1

httpd 中的软最大空闲连接数.

socket-timeout

20

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

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 之间。

表 A.137. load-provider=dynamic 配置选项
属性默认描述

衰减

2

衰减.

history

9

历史.

初始负载

0

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

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

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

表 A.138. custom-load-metric Attribute 选项
属性默认描述

capacity

1.0

指标的容量。

class

 

自定义指标的类名称。

属性

 

指标的属性。

weight

1

指标的权重。

表 A.139. 负载指标属性选项
属性默认描述

capacity

1.0

指标的容量。

属性

 

指标的属性。

type

 

指标的类型。有效值包括 cpumem、堆 sessions、ce-traffic、send-trafficrequestbusyness

weight

1

指标的权重。

表 A.140. SSL 属性选项
属性默认描述

ca-certificate-file

 

证书颁发机构.

ca-revocation-url

 

证书颁发机构撤销列表.

certificate-key-file

${user.home}/.keystore

证书的密钥文件。

cipher-suite

 

允许的密码套件.

key-alias

 

密钥别名.

password

changeit

密码.

协议

TLS

已启用的 SSL 协议.

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.