Data Grid コマンドラインインターフェイス

手順

1. $RHDG_HOME でターミナルを開きます。
2. user コマンドを使用して 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 から切断します。

   $ cat > batch<<EOF
   create cache --template=org.infinispan.DIST_SYNC mybatch
   put --cache=mybatch hello world
   put --cache=mybatch hola mundo
   disconnect
   EOF

   Copy to Clipboard Toggle word wrap

2. CLI を実行し、ファイルを入力として指定します。

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

   Copy to Clipboard Toggle word wrap

3. 新しい Data Grid CLI 接続を作成し、mybatch を確認します。

   [//containers/default]> ls caches
   ___protobuf_metadata
   mybatch
   [//containers/default]> ls caches/mybatch
   hola
   hello
   [//containers/default]> disconnect
   [disconnected]>

   Copy to Clipboard Toggle word wrap

手順

1. インタラクティブモードで Data Grid CLI を起動します。

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

   Copy to Clipboard Toggle word wrap
   注記

   -c フラグを使用しない場合は、connect コマンドを実行する必要があります。

   $ bin/cli.sh -f -
   connect

   Copy to Clipboard Toggle word wrap

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

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 設定ファイルを作成します。次に例を示します。

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

   Copy to Clipboard Toggle word wrap

2. --file= オプションを使用して、pcache.xml から qcache を作成します。

   [//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 push-site-state --cache=cacheName --site=NYC

   Copy to Clipboard Toggle word wrap