Data Grid 命令行界面

流程

1. 在 $RHDG_HOME 中打开一个终端。

2. 启动 CLI。

   • linux:

     $ bin/cli.sh

     Copy to Clipboard Toggle word wrap

   • Microsoft Windows：

     $ bin\cli.bat

     Copy to Clipboard Toggle word wrap

3. 运行 connect 命令，并在提示时输入您的用户名和密码。

   • 在默认端口 11222 上的数据网格服务器：

     [disconnected]> connect

     Copy to Clipboard Toggle word wrap

   • 带有端口偏移 100 的数据网格服务器：

     [disconnected]> connect 127.0.0.1:11322

     Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用以下方法之一关闭 Data Grid 服务器：

   • 使用 shutdown cluster 命令停止集群中的所有节点，例如：

     [//containers/default]> shutdown cluster

     Copy to Clipboard Toggle word wrap

     此命令将集群状态保存到集群中每个节点的 data 文件夹。如果使用缓存存储，shutdown cluster 命令也会保留缓存中的所有数据。

   • 使用 shutdown server 命令和服务器主机名停止单个服务器实例，例如：

     [//containers/default]> shutdown server <my_server01>

     Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用 create cache 命令添加缓存定义。

   • 使用 --file 选项，从 XML 或 JSON 文件添加缓存定义。

     [//containers/default]> create cache --file=configuration.xml mycache

     Copy to Clipboard Toggle word wrap

   • 使用 --template 选项从模板创建缓存定义。

     [//containers/default]> create cache --template=org.infinispan.DIST_SYNC mycache

     Copy to Clipboard Toggle word wrap
     提示

     在 --template= 参数后按 tab 键以列出可用的缓存模板。

3. 使用 ls 命令验证缓存是否存在。

   [//containers/default]> ls caches
   mycache

   Copy to Clipboard Toggle word wrap

4. 使用 describe 命令检索缓存配置。

   [//containers/default]> describe caches/mycache

   Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 在缓存中添加条目，如下所示：

   • 从缓存的上下文使用 put 命令：

     [//containers/default/caches/mycache]> put hello world

     Copy to Clipboard Toggle word wrap

   • 在 put 命令中使用 --cache= ：

     [//containers/default]> put --cache=mycache hello world

     Copy to Clipboard Toggle word wrap

3. 使用 get 命令验证条目。

   [//containers/default/caches/mycache]> get hello
   world

   Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 执行以下操作之一：

   • 使用 clearcache 命令删除所有条目。

     [//containers/default]> clearcache mycache

     Copy to Clipboard Toggle word wrap

   • 使用 remove 命令删除特定条目。

     [//containers/default]> remove --cache=mycache hello

     Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用 drop 命令删除缓存。

   [//containers/default]> drop cache mycache

   Copy to Clipboard Toggle word wrap

流程

1. 创建包含一组操作的文件。

   例如，创建一个名为 batch 的文件，该文件创建名为 mybatch 的缓存，向缓存添加两个条目，并断开与 CLI 的连接。

   connect --username=<username> --password=<password> <hostname>:11222
   create cache --template=org.infinispan.DIST_SYNC mybatch
   put --cache=mybatch hello world
   put --cache=mybatch hola mundo
   ls caches/mybatch
   disconnect

   Copy to Clipboard Toggle word wrap
   提示

   使用 autoconnect-url 属性配置 CLI，而不是直接在批处理文件中使用 connect 命令。

2. 运行 CLI，并将文件指定为输入。

   $ bin/cli.sh -f batch

   Copy to Clipboard Toggle word wrap

流程

1. 以交互模式启动 Data Grid CLI。

   $ bin/cli.sh -c localhost:11222 -f -

   Copy to Clipboard Toggle word wrap
   提示

   您可以使用 autoconnect-url 属性配置 CLI 连接，而不使用 -c 参数。

2. 运行批处理操作，例如：

   create cache --template=org.infinispan.DIST_SYNC mybatch
   put --cache=mybatch hello world
   put --cache=mybatch hola mundo
   disconnect
   quit

   Copy to Clipboard Toggle word wrap

流程

1. （可选）使用以下方法之一设置到 Data Grid CLI 存储目录的自定义路径：

   • 使用 cli.dir 系统属性：

     $ bin/cli.sh -Dcli.dir=/path/to/cli/storage ...

     Copy to Clipboard Toggle word wrap

   • 使用 ISPN_CLI_DIR 环境变量：

     export ISPN_CLI_DIR=/path/to/cli/storage
     $ bin/cli.sh ...

     Copy to Clipboard Toggle word wrap

2. 使用 config set 命令为配置属性设置值。

   例如，设置 autoconnect-url 属性，以便 CLI 会自动连接到该 URL。

   注意

   对于远程连接，指定 URL 并提供凭证：

   • http[s]://<username>:<password>@<hostname>:<port > 用于基本身份验证。
   • http[s]://<token>@<hostname>:<port& gt; 用于 OAuth 身份验证。

   $ bin/cli.sh config set autoconnect-url http://<username>:<password>@<hostname>:11222

   Copy to Clipboard Toggle word wrap

3. 使用 config get 命令验证配置属性。

   提示

   运行 help config 以查看可用的配置属性，并获取示例用法。

流程

1. 使用别名 < alias>=<command> 命令创建 别名。

   例如，将 q 设置为 quit 命令的别名：

   [//containers/default]> alias q=quit

   Copy to Clipboard Toggle word wrap

2. 运行 alias 命令检查定义的别名。

   [//containers/default]> alias
   alias q='quit'

   Copy to Clipboard Toggle word wrap

3. 使用 unalias 命令删除别名，例如：

   [//containers/default]> unalias q

   Copy to Clipboard Toggle word wrap

流程

1. 指定服务器密钥存储的位置，如下例所示：

   $ bin/cli.sh config set truststore /home/user/my-trust-store.jks

   Copy to Clipboard Toggle word wrap

2. 如果需要，定义密钥存储密码，如下所示：

   $ bin/cli.sh config set truststore-password secret

   Copy to Clipboard Toggle word wrap

3. 验证您的 CLI 配置。

   $ bin/cli.sh config get truststore
   truststore=/home/user/my-trust-store.jks
   
   $ bin/cli.sh config get truststore-password
   truststore-password=secret

   Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用适当的参数运行 create counter 命令。

   1. 创建 my-weak-counter。

      [//containers/default]> create counter --concurrency-level=1 --initial-value=5 --storage=PERSISTENT --type=weak my-weak-counter

      Copy to Clipboard Toggle word wrap

   2. 创建 my-strong-counter。

      [//containers/default]> create counter --initial-value=3 --storage=PERSISTENT --type=strong my-strong-counter

      Copy to Clipboard Toggle word wrap

3. 列出可用的计数器。

   [//containers/default]> ls counters
   my-strong-counter
   my-weak-counter

   Copy to Clipboard Toggle word wrap

4. 验证计数器配置。

   1. 描述 my-weak-counter。

      [//containers/default]> describe counters/my-weak-counter
      
      {
          "weak-counter":{
              "initial-value":5,
              "storage":"PERSISTENT",
              "concurrency-level":1
          }
      }

      Copy to Clipboard Toggle word wrap

   2. 描述 my-strong-counter。

      [//containers/default]> describe counters/my-strong-counter
      
      {
          "strong-counter":{
              "initial-value":3,
              "storage":"PERSISTENT",
              "upper-bound":5
          }
      }

      Copy to Clipboard Toggle word wrap

流程

1. 选择一个计数器。

   [//containers/default]> counter my-weak-counter

   Copy to Clipboard Toggle word wrap

2. 列出当前计数。

   [//containers/default/counters/my-weak-counter]> ls
   5

   Copy to Clipboard Toggle word wrap

3. 将计数器值递增为 2。

   [//containers/default/counters/my-weak-counter]> add --delta=2

   Copy to Clipboard Toggle word wrap

4. 将计数器值减少为 -4。

   [//containers/default/counters/my-weak-counter]> add --delta=-4

   Copy to Clipboard Toggle word wrap

流程

1. 创建一个 Data Grid 配置文件来添加名为 qcache 的分布式缓存并配置介质类型，例如：

   <distributed-cache name="pcache">
      <encoding>
         <key media-type="application/x-protostream"/>
         <value media-type="application/x-protostream"/>
      </encoding>
   </distributed-cache>

   Copy to Clipboard Toggle word wrap

2. 使用 --file= 选项从 pcache.xml 创建 pcache。

   [//containers/default]> create cache --file=pcache.xml pcache

   Copy to Clipboard Toggle word wrap

3. 验证 pcache。

   [//containers/default]> ls caches
   pcache
   ___protobuf_metadata
   [//containers/default]> describe caches/pcache
   {
     "distributed-cache" : {
       "mode" : "SYNC",
       "encoding" : {
         "key" : {
           "media-type" : "application/x-protostream"
         },
         "value" : {
           "media-type" : "application/x-protostream"
         }
       },
       "transaction" : {
         "mode" : "NONE"
       }
     }
   }

   Copy to Clipboard Toggle word wrap

4. 向 pcache 添加一个条目并检查编码。

   [//containers/default]> put --cache=pcache good morning
   [//containers/default]> cd caches/pcache
   [//containers/default/caches/pcache]> get good
   {
     "_type" : "string",
     "_value" : "morning"
   }

   Copy to Clipboard Toggle word wrap

流程

1. 使用以下信息，创建一个名为 person.proto 的 schema 文件：

   package org.infinispan.rest.search.entity;
   
   message Address {
       required string street = 1;
       required string postCode = 2;
   }
   
   message PhoneNumber {
       required string number = 1;
   }
   
   message Person {
       optional int32 id = 1;
       required string name = 2;
       required string surname = 3;
       optional Address address = 4;
       repeated PhoneNumber phoneNumbers = 5;
       optional uint32 age = 6;
       enum Gender {
           MALE = 0;
           FEMALE = 1;
       }
   
       optional Gender gender = 7;
   }

   Copy to Clipboard Toggle word wrap

2. 注册 person.proto。

   [//containers/default]> schema --upload=person.proto person.proto

   Copy to Clipboard Toggle word wrap

3. 验证 person.proto。

   [//containers/default]> cd caches/___protobuf_metadata
   [//containers/default/caches/___protobuf_metadata]> ls
   person.proto
   [//containers/default/caches/___protobuf_metadata]> get person.proto

   Copy to Clipboard Toggle word wrap

流程

1. 进入 pcache 缓存。

   [//containers/default/caches]> cd pcache

   Copy to Clipboard Toggle word wrap

2. 将每个 JSON 文档作为条目添加到缓存中，例如：

   [//containers/default/caches/pcache]> put --encoding=application/json --file=jessicajones.json jessicajones
   [//containers/default/caches/pcache]> put --encoding=application/json --file=matthewmurdock.json matthewmurdock
   [//containers/default/caches/pcache]> put --encoding=application/json --file=lukecage.json lukecage

   Copy to Clipboard Toggle word wrap

3. 验证条目是否存在。

   [//containers/default/caches/pcache]> ls
   lukecage
   matthewmurdock
   jessicajones

   Copy to Clipboard Toggle word wrap

4. 查询缓存，从 Protobuf Person 实体（其中 gender datatype 为 MALE ）返回条目。

   [//containers/default/caches/pcache]> query "from org.infinispan.rest.search.entity.Person p where p.gender = 'MALE'"
   {
     "total_results" : 2,
     "hits" : [ {
       "hit" : {
         "_type" : "org.infinispan.rest.search.entity.Person",
         "id" : 2,
         "name" : "Luke",
         "surname" : "Cage",
         "gender" : "MALE",
         "address" : {
           "street" : "38th St",
           "postCode" : "NY 11221"
         },
         "phoneNumbers" : [ {
           "number" : "4444"
         }, {
           "number" : "5555"
         } ]
       }
     }, {
       "hit" : {
         "_type" : "org.infinispan.rest.search.entity.Person",
         "id" : 3,
         "name" : "Matthew",
         "surname" : "Murdock",
         "gender" : "MALE",
         "address" : {
           "street" : "57th St",
           "postCode" : "NY 10019"
         }
       }
     } ]
   }

   Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用 site status 命令检查备份位置是否在线或离线：

   [//containers/default]> site status --cache=cacheName --site=NYC

   Copy to Clipboard Toggle word wrap
   注意

   --site 是一个可选参数。如果没有设置，CLI 会返回所有备份位置。

3. 管理备份位置，如下所示：

   • 使用 bring-online 命令在线显示备份位置：

     [//containers/default]> site bring-online --cache=customers --site=NYC

     Copy to Clipboard Toggle word wrap

   • 使用 take-offline 命令使备份位置离线：

     [//containers/default]> site take-offline --cache=customers --site=NYC

     Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用 site 命令配置状态传输模式，如下例所示：

   • 检索当前状态传输模式。

     [//containers/default]> site state-transfer-mode get --cache=cacheName --site=NYC
     "MANUAL"

     Copy to Clipboard Toggle word wrap
   • 为缓存和备份位置配置自动状态传输操作。

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用 site 命令推送状态传输，如下例所示：

   [//containers/default]> site push-site-state --cache=cacheName --site=NYC

   Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用适当的选项运行 backup create 命令，例如：

   • 使用自动生成的名称备份所有资源。

     [//containers/default]> backup create

     Copy to Clipboard Toggle word wrap

   • 备份名为 example-backup 的备份存档中的所有资源。

     [//containers/default]> backup create -n example-backup

     Copy to Clipboard Toggle word wrap

   • 将所有资源备份到服务器上的 /some/server/dir 路径。

     [//containers/default]> backup create -d /some/server/dir

     Copy to Clipboard Toggle word wrap

   • 仅备份缓存和缓存模板。

     [//containers/default]> backup create --caches=* --templates=*

     Copy to Clipboard Toggle word wrap

   • 仅备份命名 Protobuf 模式。

     [//containers/default]> backup create --proto-schemas=schema1,schema2

     Copy to Clipboard Toggle word wrap

3. 列出服务器上的可用备份存档。

   [//containers/default]> backup ls

   Copy to Clipboard Toggle word wrap

4. 从服务器下载 example-backup 存档。

   如果备份操作仍在进行中，该命令将等待它完成。

   [//containers/default]> backup get example-backup

   Copy to Clipboard Toggle word wrap

5. （可选）从服务器中删除 example-backup 归档。

   [//containers/default]> backup delete example-backup

   Copy to Clipboard Toggle word wrap

流程

1. 创建与 Data Grid 的 CLI 连接。

2. 使用适当的选项运行 backup restore 命令。

   • 从服务器上可访问的备份存档中恢复所有内容。

     [//containers/default]> backup restore /some/path/on/the/server

     Copy to Clipboard Toggle word wrap

   • 从本地备份存档中恢复所有内容。

     [//containers/default]> backup restore -u /some/local/path

     Copy to Clipboard Toggle word wrap

   • 仅从服务器上的备份存档中恢复缓存内容。

     [//containers/default]> backup restore /some/path/on/the/server --caches=*

     Copy to Clipboard Toggle word wrap