Início
Produtos
Red Hat Data Grid
8.4
Data Grid Server Guide
Chapter 13. Creating remote caches

Este conteúdo não está disponível no idioma selecionado.

Chapter 13. Creating remote caches

When you create remote caches at runtime, Data Grid Server synchronizes your configuration across the cluster so that all nodes have a copy. For this reason you should always create remote caches dynamically with the following mechanisms:

Data Grid Console
Data Grid Command Line Interface (CLI)
Hot Rod or HTTP clients

13.1. Default Cache Manager
Copiar o link

Data Grid Server provides a default Cache Manager that controls the lifecycle of remote caches. Starting Data Grid Server automatically instantiates the Cache Manager so you can create and delete remote caches and other resources like Protobuf schema.

After you start Data Grid Server and add user credentials, you can view details about the Cache Manager and get cluster information from Data Grid Console.

Open 127.0.0.1:11222 in any browser.

You can also get information about the Cache Manager through the Command Line Interface (CLI) or REST API:

CLI

Run the describe command in the default container.

[//containers/default]> describe

[//containers/default]> describe

Copy to Clipboard

Toggle word wrap

REST

Open 127.0.0.1:11222/rest/v2/cache-managers/default/ in any browser.

Default Cache Manager configuration

XML

<infinispan>
  <!-- Creates a Cache Manager named "default" and enables metrics. -->
  <cache-container name="default"
                   statistics="true">
     <!-- Adds cluster transport that uses the default JGroups TCP stack. -->
     <transport cluster="${infinispan.cluster.name:cluster}"
                stack="${infinispan.cluster.stack:tcp}"
                node-name="${infinispan.node.name:}"/>
     <!-- Requires user permission to access caches and perform operations. -->
     <security>
        <authorization/>
     </security>
  </cache-container>
</infinispan>

<infinispan>
  <!-- Creates a Cache Manager named "default" and enables metrics. -->
  <cache-container name="default"
                   statistics="true">
     <!-- Adds cluster transport that uses the default JGroups TCP stack. -->
     <transport cluster="${infinispan.cluster.name:cluster}"
                stack="${infinispan.cluster.stack:tcp}"
                node-name="${infinispan.node.name:}"/>
     <!-- Requires user permission to access caches and perform operations. -->
     <security>
        <authorization/>
     </security>
  </cache-container>
</infinispan>

Copy to Clipboard

Toggle word wrap

JSON

{
  "infinispan" : {
    "jgroups" : {
      "transport" : "org.infinispan.remoting.transport.jgroups.JGroupsTransport"
    },
    "cache-container" : {
      "name" : "default",
      "statistics" : "true",
      "transport" : {
        "cluster" : "cluster",
        "node-name" : "",
        "stack" : "tcp"
      },
      "security" : {
        "authorization" : {}
      }
    }
  }
}

{
  "infinispan" : {
    "jgroups" : {
      "transport" : "org.infinispan.remoting.transport.jgroups.JGroupsTransport"
    },
    "cache-container" : {
      "name" : "default",
      "statistics" : "true",
      "transport" : {
        "cluster" : "cluster",
        "node-name" : "",
        "stack" : "tcp"
      },
      "security" : {
        "authorization" : {}
      }
    }
  }
}

Copy to Clipboard

Toggle word wrap

YAML

infinispan:
  jgroups:
    transport: "org.infinispan.remoting.transport.jgroups.JGroupsTransport"
  cacheContainer:
    name: "default"
    statistics: "true"
    transport:
      cluster: "cluster"
      nodeName: ""
      stack: "tcp"
    security:
      authorization: ~

infinispan:
  jgroups:
    transport: "org.infinispan.remoting.transport.jgroups.JGroupsTransport"
  cacheContainer:
    name: "default"
    statistics: "true"
    transport:
      cluster: "cluster"
      nodeName: ""
      stack: "tcp"
    security:
      authorization: ~

Copy to Clipboard

Toggle word wrap

13.2. Creating caches with Data Grid Console
Copiar o link

Use Data Grid Console to create remote caches in an intuitive visual interface from any web browser.

Prerequisites

Create a Data Grid user with admin permissions.
Start at least one Data Grid Server instance.
Have a Data Grid cache configuration.

Procedure

Open 127.0.0.1:11222/console/ in any browser.
Select Create Cache and follow the steps as Data Grid Console guides you through the process.

13.3. Creating remote caches with the Data Grid CLI
Copiar o link

Use the Data Grid Command Line Interface (CLI) to add remote caches on Data Grid Server.

Prerequisites

Create a Data Grid user with admin permissions.
Start at least one Data Grid Server instance.
Have a Data Grid cache configuration.

Procedure

Start the CLI.
```
bin/cli.sh
```
```
bin/cli.sh
```
Copy to Clipboard Toggle word wrap
Run the connect command and enter your username and password when prompted.
Use the create cache command to create remote caches.
For example, create a cache named "mycache" from a file named mycache.xml as follows:
```
create cache --file=mycache.xml mycache
```
```
create cache --file=mycache.xml mycache
```
Copy to Clipboard Toggle word wrap

Verification

List all remote caches with the ls command.
```
ls caches
mycache
```
```
ls caches
mycache
```
Copy to Clipboard Toggle word wrap
View cache configuration with the describe command.
```
describe caches/mycache
```
```
describe caches/mycache
```
Copy to Clipboard Toggle word wrap

13.4. Creating remote caches from Hot Rod clients
Copiar o link

Use the Data Grid Hot Rod API to create remote caches on Data Grid Server from Java, C++, .NET/C#, JS clients and more.

This procedure shows you how to use Hot Rod Java clients that create remote caches on first access. You can find code examples for other Hot Rod clients in the Data Grid Tutorials.

Prerequisites

Create a Data Grid user with admin permissions.
Start at least one Data Grid Server instance.
Have a Data Grid cache configuration.

Procedure

Invoke the remoteCache() method as part of your the ConfigurationBuilder.
Set the configuration or configuration_uri properties in the hotrod-client.properties file on your classpath.

ConfigurationBuilder

File file = new File("path/to/infinispan.xml")
ConfigurationBuilder builder = new ConfigurationBuilder();
builder.remoteCache("another-cache")
       .configuration("<distributed-cache name=\"another-cache\"/>");
builder.remoteCache("my.other.cache")
       .configurationURI(file.toURI());

File file = new File("path/to/infinispan.xml")
ConfigurationBuilder builder = new ConfigurationBuilder();
builder.remoteCache("another-cache")
       .configuration("<distributed-cache name=\"another-cache\"/>");
builder.remoteCache("my.other.cache")
       .configurationURI(file.toURI());

Copy to Clipboard

Toggle word wrap

hotrod-client.properties

infinispan.client.hotrod.cache.another-cache.configuration=<distributed-cache name=\"another-cache\"/>
infinispan.client.hotrod.cache.[my.other.cache].configuration_uri=file:///path/to/infinispan.xml

infinispan.client.hotrod.cache.another-cache.configuration=<distributed-cache name=\"another-cache\"/>
infinispan.client.hotrod.cache.[my.other.cache].configuration_uri=file:///path/to/infinispan.xml

Copy to Clipboard

Toggle word wrap

Important

If the name of your remote cache contains the . character, you must enclose it in square brackets when using hotrod-client.properties files.

13.5. Creating remote caches with the REST API
Copiar o link

Use the Data Grid REST API to create remote caches on Data Grid Server from any suitable HTTP client.

Prerequisites

Create a Data Grid user with admin permissions.
Start at least one Data Grid Server instance.
Have a Data Grid cache configuration.

Procedure

Invoke POST requests to /rest/v2/caches/<cache_name> with cache configuration in the payload.

Voltar ao topo

Este conteúdo não está disponível no idioma selecionado.

Chapter 13. Creating remote caches

13.1. Default Cache Manager
Copiar o link

Default Cache Manager configuration

13.2. Creating caches with Data Grid Console
Copiar o link

13.3. Creating remote caches with the Data Grid CLI
Copiar o link

13.4. Creating remote caches from Hot Rod clients
Copiar o link

13.5. Creating remote caches with the REST API
Copiar o link

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Tornando o open source mais inclusivo

Sobre a Red Hat

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

Este conteúdo não está disponível no idioma selecionado.

Chapter 13. Creating remote caches

13.1. Default Cache ManagerCopiar o linkLink copiado para a área de transferência!

Default Cache Manager configuration

13.2. Creating caches with Data Grid ConsoleCopiar o linkLink copiado para a área de transferência!

13.3. Creating remote caches with the Data Grid CLICopiar o linkLink copiado para a área de transferência!

13.4. Creating remote caches from Hot Rod clientsCopiar o linkLink copiado para a área de transferência!

13.5. Creating remote caches with the REST APICopiar o linkLink copiado para a área de transferência!

Aprender

Experimente, compre e venda

Comunidades

Sobre a documentação da Red Hat

Tornando o open source mais inclusivo

Sobre a Red Hat

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

13.1. Default Cache Manager
Copiar o link

13.2. Creating caches with Data Grid Console
Copiar o link

13.3. Creating remote caches with the Data Grid CLI
Copiar o link

13.4. Creating remote caches from Hot Rod clients
Copiar o link

13.5. Creating remote caches with the REST API
Copiar o link