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 のデフォルトポート上の 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 コマンドを使用して、クラスターのすべてのノードを停止します。以下に例を示します。

     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. 次のいずれかの方法で、alter コマンドを使用してキャッシュ設定を変更します。

   • --file オプションを使用して、1 つ以上の属性が変更された設定ファイルを指定します。

   • --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

   • 現在のトポロジーに所有者の数よりも多くのノードが不足している場合は、操作を確定するために強制フラグが必要です。

     topology set-stable cacheName -f

     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 を設定します。

   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. オプション: サーバーのクライアント証明書認証が必要な場合は、クライアント鍵ストアの場所を指定します。次の例を考慮して、<path> をキーストアファイルへの絶対ディレクトリーパスに置き換え、<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