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 のデフォルトポート上の Data Grid Server:

     [disconnected]> connect

     Copy to Clipboard Toggle word wrap

   • ポートオフセットが 100 の Data Grid Server:

     [disconnected]> connect 127.0.0.1:11322

     Copy to Clipboard Toggle word wrap

手順

1. Data Grid への CLI 接続を作成します。

2. 次のいずれかの方法で Data Grid Server をシャットダウンします。

   • 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. 一連の操作を含むファイルを作成している。

   たとえば、mybatch という名前のキャッシュを作成する batch という名前のファイルを作成し、キャッシュに 2 つのエントリーを追加して、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
   ヒント

   バッチファイルで直接 connect コマンドを使用する代わりに、autoconnect-url プロパティーを使用して CLI を設定します。

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
   ヒント

   -c 引数を使用する代わりに、autoconnect-url プロパティーを使用して CLI 接続を設定できます。

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 コマンドを使用して、設定プロパティーの値を設定します。

   たとえば、CLI が自動的にその URL に接続するように、autoconnect-url プロパティーを設定します。

   注記

   リモート接続の場合は、URL を指定し、資格情報を入力します。

   • http[s]://<username>:<password>@<hostname>:<port>(Basic 認証用)
   • http[s]://<token>@<hostname>:<port>(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 <alias>=<command> コマンドを使用してエイリアスを作成します。

   たとえば、quit コマンドのエイリアスとして q を設定します。

   [//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. qcache という名前の分散キャッシュを追加し、メディアタイプを設定する Data Grid 設定ファイルを作成します。次に例を示します。

   <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 という名前のスキーマファイルを作成します。

   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. キャッシュをクエリーして、性別データ型が MALE である Protobuf Person エンティティーからエントリーを返します。

   [//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