Skip to content

Commit 13c26a8

Browse files
committed
more review updates
1 parent 43f606b commit 13c26a8

File tree

1 file changed

+19
-26
lines changed

1 file changed

+19
-26
lines changed

docs-source/content/faq/coherence-requirements.md

Lines changed: 19 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -14,40 +14,33 @@ and so these requirements apply to them.
1414
#### Unicast and Well Known Address
1515
When the first Coherence process starts, it will form a cluster. The next
1616
Coherence process to start (i.e. in a different pod) will use UDP to try
17-
to contact the master. Most Kubernetes overlay network providers do not
18-
support multicast, so you should configure Coherence to use unicast and
19-
provide a "well known address (WKA)" so that members can find the master.
20-
This is typically done by using the cluster address, i.e. the address of
21-
the Kubernetes service that is pointing to all cluster members.
22-
23-
{{% notice note %}}
24-
If you create your domain using the samples provided in this project, the
25-
cluster will be able to form; you do not need to manually specify WKA.
26-
However, the information is included below for completeness.
27-
{{% /notice %}}
28-
29-
For example, suppose you have a domain called `domain1` and in that domain
30-
you have a cluster called `cluster1` and Coherence is running in that
31-
cluster. You would therefore use the cluster service that is created by
32-
the operator as the well known address. This service, in this example,
33-
would be called `domain1-cluster-cluster1` and follows the pattern:
17+
to contact the senior member.
3418

35-
```
36-
domainUID "-cluster-" cluster name
37-
```
19+
If you create a WebLogic domain which contains a Coherence cluster
20+
using the samples provided in this project, then that cluster will
21+
be configured correctly so that it is able to form;
22+
you do not need to do any additional manual configuration.
3823

39-
Where `-cluster-` is a string literal. Note also that the operator
40-
normalizes the domainUID and the cluster name if necessary so that they
41-
are DNS compatible, for example all lower case, underscores converted
42-
to hyphens.
24+
If you are running Coherence standalone (outside a
25+
WebLogic domain) you should configure Coherence to use unicast and
26+
provide a "well known address (WKA)" so that all members can find the senior
27+
member. Most Kubernetes overlay network providers do not
28+
support multicast.
4329

44-
The Coherence well known addresses are provided in a variable named
30+
This is done by specifying the Coherence well known addresses in a variable named
4531
`coherence.wka` as shown in the example below:
4632

4733
```
48-
-Dcoherence.wka=domain1-cluster-cluster1
34+
-Dcoherence.wka=my-cluster-service
4935
```
5036

37+
In this example `my-cluster-service` should be the name of the Kubernetes
38+
service that is pointing to all of the members of that Coherence cluster.
39+
40+
Please refer to the [Coherence operator documentation](https://oracle.github.io/coherence-operator/)
41+
for more information about running Coherence in Kubernetes outside of
42+
a WebLogic domain.
43+
5144
#### Operating system library requirements
5245

5346
In order for Coherence clusters to form correctly, the `conntrack` library

0 commit comments

Comments
 (0)