Skip to content

Commit e13a5ff

Browse files
authored
Merge pull request #4 from rhusar/style
Fix bunch of spelling and styling issues; update docs links.
2 parents efd61b2 + 3c7e469 commit e13a5ff

File tree

4 files changed

+46
-47
lines changed

4 files changed

+46
-47
lines changed

mod_cluster-discovery/README.md

Lines changed: 18 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ The `mod_cluster-discovery` quickstart will focus on the ways in which mod_clust
44
set of workers to be used for load balancing.
55

66
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
88
mod_cluster to provide a feature-rich load balancer solution.
99

1010
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)
1212

1313
## Introduction
1414

@@ -30,8 +30,8 @@ In this quickstart, we shall explore the configuration requirements for both dyn
3030
### Configuration of load balancer and workers
3131

3232
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
3535

3636
The `standalone-load-balancer.xml` server profile uses dynamic, multicast-discovery by default, which provides a
3737
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:
6969
* 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
7070

7171
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)
7373

7474
#### Configuration of mod_cluster on the workers
7575

@@ -89,7 +89,7 @@ For the purposes of our discussion, we note the following:
8989
traffic from the load balancer. In this case, the binary `ajp` protocol is used for communication between the load balancer and the workers
9090

9191
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)
9393

9494
Now that we have a basic understanding of how mod_cluster works and how it is configured, we explore how dynamic
9595
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
100100
worker nodes.
101101

102102
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.
104104

105105
Our aim here is not to test the features of the load balancer itself, but rather to demonstrate that, with discovery
106106
so configured, a client can make invocations on a deployment via the load balancer and that we see the requests
107107
balanced between worker nodes.
108108

109-
### Setting up the Wildfly instances
109+
### Setting up the WildFly instances
110110

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.
112112
These instances will be run on `localhost` using the loopback network `lo` for communication between instances.
113113

114114
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
118118

119119
Additionally, we assume that a user called `quickstartUser` and a password called`quickstartPwd1!` is defined on each
120120
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.
126126

127127
## Scenario I: mod_cluster with dynamic discovery
128128

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
130130
profile. This is to allow discovery to work out-of-the-box; in other words, with no additional configuration of the
131131
load balancer or its workers.
132132

@@ -147,7 +147,7 @@ In a new terminal, start the load-balancer instance using the standalone-load-ba
147147
```shell
148148
$BALANCER_HOME/bin/standalone.sh -c standalone-load-balancer.xml -Djboss.node.name=balancer -Djboss.bind.address=localhost
149149
```
150-
Here, we have provided an appropriate name for this Wildfly instance (`balancer`) as well as specified the domain name
150+
Here, we have provided an appropriate name for this WildFly instance (`balancer`) as well as specified the domain name
151151
of `localhost` for the bind address.
152152

153153
### Starting the workers
@@ -156,7 +156,7 @@ First, in a new terminal, start the worker1 instance using the standalone-ha.xml
156156
```shell
157157
$WORKER1_HOME/bin/standalone.sh -c standalone-ha.xml -Djboss.node.name=worker1 -Djboss.bind.address=localhost -Djboss.socket.binding.port-offset=100
158158
```
159-
As with the load balancer instance, we have provided an appropriate name for this Wildfly instance as well as specified
159+
As with the load balancer instance, we have provided an appropriate name for this WildFly instance as well as specified
160160
the domain name of `localhost` for the bind address. Additionally, because all three of the server instances are running
161161
on the same host, to avoid port conflicts, we need to additionally specify a socket binding port offset, 100 in this case.
162162

@@ -243,7 +243,7 @@ this command should show the request being directed to the different worker node
243243
### Conclusion
244244
245245
We have seen that dynamic (multicast-based) discovery is enabled by default when using the standalone-load-balancer.xml
246-
server profile of Wildfly. Once multicast is configured for the network over which the load balancer and workers
246+
server profile of WildFly. Once multicast is configured for the network over which the load balancer and workers
247247
communicate, discovery happens dynamically upon the load balancer and the workers being started.
248248
249249
In the next section, we shall show the configuration changes required to adjust the discovery method from dynamic
@@ -257,7 +257,7 @@ with the load balancer, using the load balancer host:port provided.
257257
258258
### Re-configuring the load balancer for static discovery
259259
260-
To configure the load-balancer, we provide a Wildfly CLI script `configure-loadbalancer.cli` which contains the CLI
260+
To configure the load-balancer, we provide a WildFly CLI script `configure-loadbalancer.cli` which contains the CLI
261261
commands for setting up static discovery on the load balancer. Review the comments in the CLI script to understand
262262
the changes made.
263263
@@ -279,7 +279,7 @@ At this stage, the load balancer is now configured for static discovery and you
279279
280280
### Re-configuring the workers for static discovery
281281
282-
To configure the workers, we provide a Wildfly CLI script `configure-worker.cli` which contains the CLI
282+
To configure the workers, we provide a WildFly CLI script `configure-worker.cli` which contains the CLI
283283
commands for setting up static discovery on the worker nodes. Review the comments in the CLI script to understand
284284
the changes made.
285285

mod_cluster-discovery/client/src/main/java/org/wildfly/clustering/examples/RemoteEJBClient.java

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,6 @@
3636
* Additionally, The wildfly-config.xml file includes an EJB client configuration section specifying a URL pointing to
3737
* the load balancer and including its HTTP invoker context path prefix. This allows the EJB/HTTP discovery mechanism
3838
* to find out which deployments are accessible via the load balancer.
39-
*
4039
*/
4140
public class RemoteEJBClient {
4241
private static final Logger log = Logger.getLogger(RemoteEJBClient.class);
@@ -69,7 +68,7 @@ public static void main(String[] args) throws Exception {
6968
/*
7069
7170
// an alternative means to create the proxy
72-
log.info("Creating SLSB using Wildfly Naming client API .");
71+
log.info("Creating SLSB using WildFly Naming client API.");
7372
final Hashtable<String, String> jndiProperties = new Hashtable<>();
7473
jndiProperties.put(Context.INITIAL_CONTEXT_FACTORY, "org.wildfly.naming.client.WildFlyInitialContextFactory");
7574
jndiProperties.put(Context.PROVIDER_URL, "http://localhost:8080/wildfly-services");

0 commit comments

Comments
 (0)