使用 Data Grid 命令行界面

流程

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

2. 使用 user create 命令创建 admin 用户。

   bin/cli.sh user create admin -p changeme

   Copy to Clipboard Toggle word wrap
   提示

   从 CLI 会话运行 help user 以获取完整的命令详情。

流程

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 命令停止集群中的所有节点，例如：

     shutdown cluster

     Copy to Clipboard Toggle word wrap

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

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

     shutdown server <my_server01>

     Copy to Clipboard Toggle word wrap

流程

1. 启动 CLI。

   bin/cli.sh

   Copy to Clipboard Toggle word wrap
2. 运行 connect 命令，并在提示时输入您的用户名和密码。

3. 使用 create cache 命令创建远程缓存。

   例如，从名为 mycache.xml 的文件创建一个名为 "mycache" 的缓存，如下所示：

   create cache --file=mycache.xml mycache

   Copy to Clipboard Toggle word wrap

验证

1. 使用 ls 命令列出所有远程缓存。

   ls caches
   mycache

   Copy to Clipboard Toggle word wrap

2. 使用 describe 命令查看缓存配置。

   describe caches/mycache

   Copy to Clipboard Toggle word wrap

流程

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

2. 使用以下方法之一修改缓存配置：

   • 使用 --file 选项指定带有一个或多个属性修改的配置文件。

   • 使用 --attribute 和 --value 选项来修改特定的配置属性。

     提示

     如需更多信息和示例，请运行 help alter 命令。

3. 使用 describe 命令验证您的更改，例如：

   describe caches/mycache

   Copy to Clipboard Toggle word wrap

流程

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

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

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

     put --cache=mycache hello world

     Copy to Clipboard Toggle word wrap

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

     [//containers/default/caches/mycache]> put 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 命令删除所有条目。

     clearcache mycache

     Copy to Clipboard Toggle word wrap

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

     remove --cache=mycache hello

     Copy to Clipboard Toggle word wrap

流程

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

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

   drop cache mycache

   Copy to Clipboard Toggle word wrap

流程

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

2. 使用 rebalance disable 命令为所有缓存禁用自动重新平衡。

   rebalance disable

   Copy to Clipboard Toggle word wrap

3. 使用 rebalance enable 命令为特定缓存启用自动重新平衡。

   以下示例仅为名为 "mycache" 的缓存启用重新平衡。

   rebalance enable caches/mycache

   Copy to Clipboard Toggle word wrap

4. 为所有缓存重新启用自动重新平衡。

   rebalance enable

   Copy to Clipboard Toggle word wrap

流程

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

2. 执行以下操作之一：

   • 将给定缓存的当前拓扑设置为 stable。

     topology set-stable cacheName

     Copy to Clipboard Toggle word wrap

   • 如果当前拓扑中缺少的节点数大于或等于所有者数，则需要 force 标志来确认操作。

     topology set-stable cacheName -f

     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 命令的别名：

   alias q=quit

   Copy to Clipboard Toggle word wrap

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

   alias
   alias q='quit'

   Copy to Clipboard Toggle word wrap

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

   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. 可选： 定义信任存储密码。以下示例将 secret 设置为信任存储密码：

   bin/cli.sh config set truststore-password secret

   Copy to Clipboard Toggle word wrap

3. 可选： 如果您需要服务器进行客户端证书身份验证，请指定客户端密钥存储的位置。考虑以下示例，将 &lt ;path& gt; 替换为密钥存储文件的绝对路径，并将 < key_store_file > 替换为密钥存储文件的名称：

   bin/cli.sh config set keystore /<emphasis><path></emphasis>/<emphasis><key_store_file></emphasis>

   Copy to Clipboard Toggle word wrap

4. 可选： 定义一个密钥存储密码。以下示例将 secret 设置为密钥存储密码：

   bin/cli.sh config set keystore-password secret

   Copy to Clipboard Toggle word wrap

5. 验证您的 CLI 配置。

   bin/cli.sh config get truststore

   Copy to Clipboard Toggle word wrap

   bin/cli.sh config get truststore-password

   Copy to Clipboard Toggle word wrap

流程

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

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

   1. 创建 my-weak-counter。

      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。

      create counter --initial-value=3 --storage=PERSISTENT --type=strong my-strong-counter

      Copy to Clipboard Toggle word wrap

3. 列出可用的计数器。

   ls counters

   Copy to Clipboard Toggle word wrap

4. 验证计数器配置。

   1. 描述 my-weak-counter。

      describe counters/my-weak-counter

      Copy to Clipboard Toggle word wrap

      {
          "weak-counter":{
              "initial-value":5,
              "storage":"PERSISTENT",
              "concurrency-level":1
          }
      }

      Copy to Clipboard Toggle word wrap

   2. 描述 my-strong-counter。

      describe counters/my-strong-counter

      Copy to Clipboard Toggle word wrap

      {
          "strong-counter":{
              "initial-value":3,
              "storage":"PERSISTENT",
              "upper-bound":5
          }
      }

      Copy to Clipboard Toggle word wrap

流程

1. 选择一个计数器。

   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. 使用 site status 命令检查备份位置是否在线或离线：

   site status --cache=cacheName --site=NYC

   Copy to Clipboard Toggle word wrap
   注意

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

   提示

   使用 --all-caches 选项获取所有缓存的备份位置状态。

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

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

     site bring-online --cache=customers --site=NYC

     Copy to Clipboard Toggle word wrap

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

     site take-offline --cache=customers --site=NYC

     Copy to Clipboard Toggle word wrap

流程

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

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

     site state-transfer-mode get --cache=cacheName --site=NYC

     Copy to Clipboard Toggle word wrap

   • 为缓存和备份位置配置自动状态传输操作。

     site state-transfer-mode set --cache=cacheName --site=NYC --mode=AUTO

     Copy to Clipboard Toggle word wrap

流程

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

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

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

     backup create

     Copy to Clipboard Toggle word wrap

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

     backup create -n example-backup

     Copy to Clipboard Toggle word wrap

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

     backup create -d /some/server/dir

     Copy to Clipboard Toggle word wrap

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

     backup create --caches=* --templates=*

     Copy to Clipboard Toggle word wrap

   • 仅备份命名 Protobuf 模式。

     backup create --proto-schemas=schema1,schema2

     Copy to Clipboard Toggle word wrap

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

   backup ls

   Copy to Clipboard Toggle word wrap

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

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

   backup get example-backup

   Copy to Clipboard Toggle word wrap

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

   backup delete example-backup

   Copy to Clipboard Toggle word wrap

流程

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

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

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

     backup restore /some/path/on/the/server

     Copy to Clipboard Toggle word wrap

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

     backup restore -u /some/local/path

     Copy to Clipboard Toggle word wrap

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

     backup restore /some/path/on/the/server --caches=*

     Copy to Clipboard Toggle word wrap