You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: mod_cluster-discovery/README.md
+18-18Lines changed: 18 additions & 18 deletions
Original file line number
Diff line number
Diff line change
@@ -4,11 +4,11 @@ The `mod_cluster-discovery` quickstart will focus on the ways in which mod_clust
4
4
set of workers to be used for load balancing.
5
5
6
6
Mod_cluster can be configured for use with a variety of load balancers. The load balancer configuration we use for this
7
-
example will be based on the Wildfly server profile `standalone-load-balancer.xml` which integrates Undertow and
7
+
example will be based on the WildFly server profile `standalone-load-balancer.xml` which integrates Undertow and
8
8
mod_cluster to provide a feature-rich load balancer solution.
9
9
10
10
For the latest documentation on mod_cluster, see the
11
-
[Wildfly High Availablity Guide](https://docs.wildfly.org/30/High_Availability_Guide.html#load-balancing)
11
+
[WildFly High Availability Guide](https://docs.wildfly.org/33/High_Availability_Guide.html#load-balancing)
12
12
13
13
## Introduction
14
14
@@ -30,8 +30,8 @@ In this quickstart, we shall explore the configuration requirements for both dyn
30
30
### Configuration of load balancer and workers
31
31
32
32
As mentioned earlier, we will be using a load balancing setup where:
33
-
* our load balancer will be a Wildfly server instance started with the `standalone-load-balancer.xml` server profile
34
-
* our worker nodes will be Wildfly server instances started with the `standalone-ha.xml` profile
33
+
* our load balancer will be a WildFly server instance started with the `standalone-load-balancer.xml` server profile
34
+
* our worker nodes will be WildFly server instances started with the `standalone-ha.xml` profile
35
35
36
36
The `standalone-load-balancer.xml` server profile uses dynamic, multicast-discovery by default, which provides a
37
37
discovery configuration which works out-of-the-box. The `standalone-ha.xml` server profile ensures that any deployments
@@ -69,7 +69,7 @@ With respect to previous discussion, we note the following:
69
69
* the http-listener element `management` is where the load balancer listens for incoming MCMP traffic from workers; this listener uses the http protocol by default
70
70
71
71
Not all attributes of the element `<mod-cluster/>` defined in the schema are shown here in this default configuration.
72
-
For a full list of configurable elements and attributes, see the [modcluster filter model reference](https://docs.wildfly.org/30/wildscribe/subsystem/undertow/configuration/filter/mod-cluster/index.html)
72
+
For a full list of configurable elements and attributes, see the [modcluster filter model reference](https://docs.wildfly.org/33/wildscribe/subsystem/undertow/configuration/filter/mod-cluster/index.html)
73
73
74
74
#### Configuration of mod_cluster on the workers
75
75
@@ -89,7 +89,7 @@ For the purposes of our discussion, we note the following:
89
89
traffic from the load balancer. In this case, the binary `ajp` protocol is used for communication between the load balancer and the workers
90
90
91
91
Not all attributes of the modcluster subsystem defined in the schema are shown here. For a full list of configurable
92
-
elements and attributes, see the [modcluster subsystem model reference](https://docs.wildfly.org/30/wildscribe/subsystem/modcluster/index.html)
92
+
elements and attributes, see the [modcluster subsystem model reference](https://docs.wildfly.org/33/wildscribe/subsystem/modcluster/index.html)
93
93
94
94
Now that we have a basic understanding of how mod_cluster works and how it is configured, we explore how dynamic
95
95
discovery works with mod_cluster as the default discovery mode.
@@ -100,21 +100,21 @@ In order to test the load balancer and its workers once configured, we need a sa
100
100
worker nodes.
101
101
102
102
In what follows, we shall use the application [clusterbench](https://github.com/clusterbench/clusterbench), a J2EE
103
-
application tailored for testing J2EE application servers such as Wildfly and the clustering features they provide.
103
+
application tailored for testing J2EE application servers such as WildFly and the clustering features they provide.
104
104
105
105
Our aim here is not to test the features of the load balancer itself, but rather to demonstrate that, with discovery
106
106
so configured, a client can make invocations on a deployment via the load balancer and that we see the requests
107
107
balanced between worker nodes.
108
108
109
-
### Setting up the Wildfly instances
109
+
### Setting up the WildFly instances
110
110
111
-
In what follows, we will install and configure three instances of Wildfly to represent the load balancer and two workers.
111
+
In what follows, we will install and configure three instances of WildFly to represent the load balancer and two workers.
112
112
These instances will be run on `localhost` using the loopback network `lo` for communication between instances.
113
113
114
114
We refer to the instances as follows:
115
-
*`BALANCER_HOME` is the directory containing the Wildfly installation to be used for the load balancer
116
-
*`WORKER1_HOME` is the directory containing the Wildfly installation to be used for the first worker
117
-
*`WORKER2_HOME` is the directory containing the Wildfly installation to be used for the second worker
115
+
*`BALANCER_HOME` is the directory containing the WildFly installation to be used for the load balancer
116
+
*`WORKER1_HOME` is the directory containing the WildFly installation to be used for the first worker
117
+
*`WORKER2_HOME` is the directory containing the WildFly installation to be used for the second worker
118
118
119
119
Additionally, we assume that a user called `quickstartUser` and a password called`quickstartPwd1!` is defined on each
120
120
of the worker instances. This user and password combination will be used for authentication of the client application
@@ -126,7 +126,7 @@ Similarly, add the same user and password for WORKER2_HOME.
126
126
127
127
## Scenario I: mod_cluster with dynamic discovery
128
128
129
-
As mentioned earlier, dynamic discovery is enabled by default when using the Wildfly standalone-load-balancer.xml server
129
+
As mentioned earlier, dynamic discovery is enabled by default when using the WildFly standalone-load-balancer.xml server
130
130
profile. This is to allow discovery to work out-of-the-box; in other words, with no additional configuration of the
131
131
load balancer or its workers.
132
132
@@ -147,7 +147,7 @@ In a new terminal, start the load-balancer instance using the standalone-load-ba
0 commit comments