主页
产品
Red Hat Data Grid
8.0
Configuring Data Grid
Chapter 8. Configuring Cluster Discovery

此内容没有您所选择的语言版本。

Chapter 8. Configuring Cluster Discovery

Running Data Grid on hosted services requires using discovery mechanisms that are adapted to network constraints that individual cloud providers impose. For instance, Amazon EC2 does not allow UDP multicast.

Data Grid can use the following cloud discovery mechanisms:

Generic discovery protocols (TCPPING and TCPGOSSIP)
JGroups PING protocols (KUBE_PING and DNS_PING)
Cloud-specific PING protocols

Note

Embedded Data Grid requires cloud provider dependencies.

8.1. TCPPING
复制链接

TCPPING is a generic JGroups discovery mechanism that uses a static list of IP addresses for cluster members.

To use TCPPING, you must add the list of static IP addresses to the JGroups configuration file for each Data Grid node. However, the drawback to TCPPING is that it does not allow nodes to dynamically join Data Grid clusters.

TCPPING configuration example

<config>
      <TCP bind_port="7800" />
      <TCPPING timeout="3000"
           initial_hosts="${jgroups.tcpping.initial_hosts:localhost[7800],localhost[7801]}"
           port_range="1"
           num_initial_members="3"/>
...
...
</config>

<config>
      <TCP bind_port="7800" />
      <TCPPING timeout="3000"
           initial_hosts="${jgroups.tcpping.initial_hosts:localhost[7800],localhost[7801]}"
           port_range="1"
           num_initial_members="3"/>
...
...
</config>

Copy to Clipboard

Toggle word wrap

Reference

JGroups TCPPING

8.2. Gossip Router
复制链接

Gossip routers provide a centralized location on the network from which your Data Grid cluster can retrieve addresses of other nodes.

You inject the address (IP:PORT) of the Gossip router into Data Grid nodes as follows:

Pass the address as a system property to the JVM; for example, -DGossipRouterAddress="10.10.2.4[12001]".
Reference that system property in the JGroups configuration file.

Gossip router configuration example

<config>
    <TCP bind_port="7800" />
    <TCPGOSSIP timeout="3000" initial_hosts="${GossipRouterAddress}" num_initial_members="3" />
...
...
</config>

<config>
    <TCP bind_port="7800" />
    <TCPGOSSIP timeout="3000" initial_hosts="${GossipRouterAddress}" num_initial_members="3" />
...
...
</config>

Copy to Clipboard

Toggle word wrap

Reference

JGroups Gossip Router

8.3. DNS_PING
复制链接

JGroups DNS_PING queries DNS servers to discover Data Grid cluster members in Kubernetes environments such as OKD and Red Hat OpenShift.

DNS_PING configuration example

<stack name="dns-ping">
...
    <dns.DNS_PING
      dns_query="myservice.myproject.svc.cluster.local" />
...
</stack>

<stack name="dns-ping">
...
    <dns.DNS_PING
      dns_query="myservice.myproject.svc.cluster.local" />
...
</stack>

Copy to Clipboard

Toggle word wrap

Reference

JGroups DNS_PING
DNS for Services and Pods (Kubernetes documentation for adding DNS entries)

8.4. KUBE_PING
复制链接

JGroups Kube_PING uses a Kubernetes API to discover Data Grid cluster members in environments such as OKD and Red Hat OpenShift.

KUBE_PING configuration example

<config>
    <TCP bind_addr="${match-interface:eth.*}" />
    <kubernetes.KUBE_PING />
...
...
</config>

<config>
    <TCP bind_addr="${match-interface:eth.*}" />
    <kubernetes.KUBE_PING />
...
...
</config>

Copy to Clipboard

Toggle word wrap

KUBE_PING configuration requirements

Your KUBE_PING configuration must bind the JGroups stack to the eth0 network interface. Docker containers use eth0 for communication.
KUBE_PING uses environment variables inside containers for configuration. The KUBERNETES_NAMESPACE environment variable must specify a valid namespace. You can either hardcode it or populate it via the Kubernetes Downward API.
KUBE_PING requires additional privileges on Red Hat OpenShift. Assuming that oc project -q returns the current namespace and default is the service account name, you can run:
```
oc policy add-role-to-user view system:serviceaccount:$(oc project -q):default -n $(oc project -q)
```
```
$ oc policy add-role-to-user view system:serviceaccount:$(oc project -q):default -n $(oc project -q)
```
Copy to Clipboard Toggle word wrap

Reference

8.5. NATIVE_S3_PING
复制链接

On Amazon Web Service (AWS), use the S3_PING protocol for discovery.

You can configure JGroups to use shared storage to exchange the details of Data Grid nodes. NATIVE_S3_PING allows Amazon S3 as the shared storage but requires both Amazon S3 and EC2 subscriptions.

NATIVE_S3_PING configuration example

<config>
    <TCP bind_port="7800" />
    <org.jgroups.aws.s3.NATIVE_S3_PING
            region_name="replace this with your region (e.g. eu-west-1)"
            bucket_name="replace this with your bucket name"
            bucket_prefix="replace this with a prefix to use for entries in the bucket (optional)" />
</config>

<config>
    <TCP bind_port="7800" />
    <org.jgroups.aws.s3.NATIVE_S3_PING
            region_name="replace this with your region (e.g. eu-west-1)"
            bucket_name="replace this with your bucket name"
            bucket_prefix="replace this with a prefix to use for entries in the bucket (optional)" />
</config>

Copy to Clipboard

Toggle word wrap

NATIVE_S3_PING dependencies for embedded Data Grid

<dependency>
  <groupId>org.jgroups.aws.s3</groupId>
  <artifactId>native-s3-ping</artifactId>
  <version>${version.jgroups.native_s3_ping}</version>
</dependency>

<dependency>
  <groupId>org.jgroups.aws.s3</groupId>
  <artifactId>native-s3-ping</artifactId>
  <version>${version.jgroups.native_s3_ping}</version>
</dependency>

Copy to Clipboard

Toggle word wrap

8.6. JDBC_PING
复制链接

JDBC_PING uses JDBC connections to shared databases, such as Amazon RDS on EC2, to store information about Data Grid nodes.

Reference

JDBC_PING Wiki

8.7. AZURE_PING
复制链接

On Microsoft Azure, use a generic discovery protocol or AZURE_PING, which uses shared Azure Blob Storage to store discovery information.

AZURE_PING configuration example

<azure.AZURE_PING
	storage_account_name="replace this with your account name"
	storage_access_key="replace this with your access key"
	container="replace this with your container name"
/>

<azure.AZURE_PING
	storage_account_name="replace this with your account name"
	storage_access_key="replace this with your access key"
	container="replace this with your container name"
/>

Copy to Clipboard

Toggle word wrap

AZURE_PING dependencies for embedded Data Grid

<dependency>
  <groupId>org.jgroups.azure</groupId>
  <artifactId>jgroups-azure</artifactId>
  <version>${version.jgroups.azure}</version>
</dependency>

<dependency>
  <groupId>org.jgroups.azure</groupId>
  <artifactId>jgroups-azure</artifactId>
  <version>${version.jgroups.azure}</version>
</dependency>

Copy to Clipboard

Toggle word wrap

8.8. GOOGLE2_PING
复制链接

On Google Compute Engine (GCE), use a generic discovery protocol or GOOGLE2_PING, which uses Google Cloud Storage (GCS) to store information about the cluster members.

GOOGLE2_PING configuration example

<org.jgroups.protocols.google.GOOGLE_PING2 location="${jgroups.google.bucket_name}" />

<org.jgroups.protocols.google.GOOGLE_PING2 location="${jgroups.google.bucket_name}" />

Copy to Clipboard

Toggle word wrap

GOOGLE2_PING dependencies for embedded Data Grid

<dependency>
  <groupId>org.jgroups.google</groupId>
  <artifactId>jgroups-google</artifactId>
  <version>${version.jgroups.google}</version>
</dependency>

<dependency>
  <groupId>org.jgroups.google</groupId>
  <artifactId>jgroups-google</artifactId>
  <version>${version.jgroups.google}</version>
</dependency>

Copy to Clipboard

Toggle word wrap

返回顶部

此内容没有您所选择的语言版本。

Chapter 8. Configuring Cluster Discovery

8.1. TCPPING
复制链接

8.2. Gossip Router
复制链接

8.3. DNS_PING
复制链接

8.4. KUBE_PING
复制链接

8.5. NATIVE_S3_PING
复制链接

8.6. JDBC_PING
复制链接

8.7. AZURE_PING
复制链接

8.8. GOOGLE2_PING
复制链接

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

此内容没有您所选择的语言版本。

Chapter 8. Configuring Cluster Discovery

8.1. TCPPING复制链接链接已复制到粘贴板!

8.2. Gossip Router复制链接链接已复制到粘贴板!

8.3. DNS_PING复制链接链接已复制到粘贴板!

8.4. KUBE_PING复制链接链接已复制到粘贴板!

8.5. NATIVE_S3_PING复制链接链接已复制到粘贴板!

8.6. JDBC_PING复制链接链接已复制到粘贴板!

8.7. AZURE_PING复制链接链接已复制到粘贴板!

8.8. GOOGLE2_PING复制链接链接已复制到粘贴板!

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

8.1. TCPPING
复制链接

8.2. Gossip Router
复制链接

8.3. DNS_PING
复制链接

8.4. KUBE_PING
复制链接

8.5. NATIVE_S3_PING
复制链接

8.6. JDBC_PING
复制链接

8.7. AZURE_PING
复制链接

8.8. GOOGLE2_PING
复制链接