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

1. $ISPN_HOME でターミナルを開きます。

2. CLI を実行します。

   $ bin/cli.sh
   [disconnected]>

   Copy to Clipboard Toggle word wrap

手順

1. テンプレートからの分散同期キャッシュを作成し、mycache という名前を付けます。

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

   Copy to Clipboard Toggle word wrap
   ヒント

   --template= 引数の後に Tab キーを押して、利用可能なキャッシュテンプレートを一覧表示します。

2. キャッシュ設定を取得します。

   [//containers/default]> describe caches/mycache
   {
     "distributed-cache" : {
       "mode" : "SYNC",
       "remote-timeout" : 17500,
       "state-transfer" : {
         "timeout" : 60000
       },
       "transaction" : {
         "mode" : "NONE"
       },
       "locking" : {
         "concurrency-level" : 1000,
         "acquire-timeout" : 15000,
         "striping" : false
       },
       "statistics" : true
     }
   }

   Copy to Clipboard Toggle word wrap

手順

1. エントリーを "mycache" に追加します。

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

   Copy to Clipboard Toggle word wrap
   ヒント

   キャッシュのコンテキストにない場合は、--cache= パラメーターを使用します。以下に例を示します。

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

   Copy to Clipboard Toggle word wrap

2. エントリーを取得して確認します。

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

   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. 適切な引数を指定して 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

2. 使用可能なカウンターを一覧表示します。

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

   Copy to Clipboard Toggle word wrap

3. カウンター設定を確認します。

   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. Red Hat カスタマーポータルにアクセスします。
2. ソフトウェアダウンロードセクション から適切な Data Grid サーバーパッチをダウンロードします。
3. ターミナルウィンドウを開き、$RHDG_HOME に移動します。

4. CLI を起動します。

   $ bin/cli.sh
   [disconnected]>

   Copy to Clipboard Toggle word wrap

5. ダウンロードしたパッチファイルを記述します。

   [disconnected]> patch describe /path/to/redhat-datagrid-$version-server-patch.zip
   Red Hat Data Grid patch target=$target_version source=$source_version created=$timestamp

   Copy to Clipboard Toggle word wrap
   • $target_version は、サーバーにパッチをインストール時に適用する Data Grid バージョンです。
   • $source_version は、パッチをインストールできる 1 つ以上の Data Grid サーバーのバージョンです。

1. 以下のように、ダウンロードしたパッチを引数として、md5sum コマンドまたは sha256sum コマンドを実行します。

   $ sha256sum redhat-datagrid-$version-server-patch.zip

   Copy to Clipboard Toggle word wrap
2. Data Grid Software Details ページで MD5 または SHA-256 チェックサムの値と比較します。

手順

1. 作成するパッチのターゲットバージョンを持つ Data Grid サーバーインストールの $RHDG_HOME に移動します。

2. CLI を起動します。

   $ bin/cli.sh
   [disconnected]>

   Copy to Clipboard Toggle word wrap

3. patch create コマンドを使用してパッチアーカイブを生成し、パッチを説明する意味のある修飾子と共に -q オプションを追加します。

   [disconnected]> patch create -q "this is my test patch" path/to/mypatch.zip \
   path/to/target/server/home path/to/source/server/home

   Copy to Clipboard Toggle word wrap

   前述のコマンドは、指定されたディレクトリーに .zip アーカイブを生成します。パスは、ターゲットサーバーの $RHDG_HOME に相対します。

   ヒント

   複数の Data Grid バージョン用にパッチを 1 つ作成します。以下に例を示します。

   [disconnected]> patch create -q "this is my test patch" path/to/mypatch.zip \
   path/to/target/server/home \
   path/to/source/server1/home path/to/source/server2/home

   Copy to Clipboard Toggle word wrap

   server1 および server2 はそれぞれ異なる Data Grid バージョンであり、mypatch.zip をインストールできます。

4. 生成されたパッチアーカイブを記述します。

   [disconnected]> patch describe path/to/mypatch.zip
   
   Red Hat Data Grid patch target=$target_version(my test patch)  source=$source_version created=$timestamp

   Copy to Clipboard Toggle word wrap
   • $target_version は、パッチが作成された Data Grid サーバーのバージョンです。

   • $source_version は、パッチを適用できる 1 つ以上の Data Grid サーバーのバージョンです。

     $source_version のみに一致する Data Grid サーバーにパッチを適用できます。他のバージョンにパッチを適用しようとすると、以下の例外が発生します。

     java.lang.IllegalStateException: The supplied patch cannot be applied to `$source_version`

     Copy to Clipboard Toggle word wrap

手順

1. パッチを適用する Data Grid サーバーの $RHDG_HOME に移動します。

2. サーバーが実行している場合は停止します。

   注記

   サーバーの実行中にサーバーにパッチを適用すると、再起動後にバージョンの変更が有効になります。サーバーを停止しない場合は、ターゲットバージョンで新しいクラスターを作成し、パッチを適用せずにそのバージョンへのローリングアップグレードを実行します。

3. CLI を起動します。

   $ bin/cli.sh
   [disconnected]>

   Copy to Clipboard Toggle word wrap

4. パッチをインストールします。

   [disconnected]> patch install path/to/patch.zip
   
   Red Hat Data Grid patch target=$target_version source=$source_version \
   created=$timestamp installed=$timestamp

   Copy to Clipboard Toggle word wrap
   • $target_version は、パッチがインストールされている Data Grid バージョンを表示します。
   • $source_version は、パッチをインストールする前に Data Grid バージョンを表示します。

5. サーバーを起動し、パッチがインストールされていることを確認します。

   $ bin/server.sh
   ...
   ISPN080001: Red Hat Data Grid Server $version

   Copy to Clipboard Toggle word wrap

   パッチが正常にインストールされると、$version は $target_version と一致します。

手順

1. ロールバックする Data Grid サーバーインストールの $RHDG_HOME に移動します。
2. サーバーが実行している場合は停止します。

3. CLI を起動します。

   $ bin/cli.sh
   [disconnected]>

   Copy to Clipboard Toggle word wrap

4. インストールされたパッチを一覧表示します。

   [disconnected]> patch ls
   
   Red Hat Data Grid patch target=$target_version source=$source_version
   created=$timestamp installed=$timestamp

   Copy to Clipboard Toggle word wrap
   • $target_version は、パッチの適用後、Data Grid サーバーのバージョンです。
   • $source_version は、パッチの適用前の Data Grid サーバーのバージョンです。パッチをロールバックすると、このバージョンにサーバーを復元します。

5. 最後にインストールしたパッチをロールバックします。

   [disconnected]> patch rollback

   Copy to Clipboard Toggle word wrap

6. CLI を終了します。

   [disconnected]> quit

   Copy to Clipboard Toggle word wrap

7. サーバーを起動し、パッチが以前のバージョンにロールバックされていることを確認します。

   $ bin/server.sh
   ...
   ISPN080001: Data Grid Server $version

   Copy to Clipboard Toggle word wrap

   パッチがロールバックされると、$version が正常に $source_version と一致します。