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

ユーザーにロールを割り当て、キャッシュ操作や Data Grid のリソースとのやり取りを行う権限を付与します。

user roles ls katie
["deployer"]

グループを使用すると、複数のユーザーのパーミッションを変更できます。グループにロールを割り当ててから、そのグループにユーザーを追加します。ユーザーは、グループロールからパーミッションを継承します。

cat server/conf/groups.properties

Data Grid には、キャッシュや Data Grid のリソースにアクセスするための権限をユーザーに提供するロールがいくつかあります。

Data Grid CLI は、以下の目的でさまざまなリソースを公開します。

[//containers/default]> ls
caches
counters
configurations
schemas
tasks

[hostname@cluster/]> ls
containers
cluster
server

ノードを適切にシャットダウンして再起動することで、データの損失を回避してクラスターの一貫性を確保します。

クラスターのシャットダウン

Data Grid では、クラスターの状態を保存し、キャッシュ内のすべてのデータを永続化する時には、shutdown cluster コマンドを使用してクラスター内のすべてのノードを停止することを推奨します。shutdown cluster コマンドは、ノードが 1 つ含まれるクラスターに対しても使用できます。

Data Grid クラスターをオンラインに戻すと、すべてのノードが再度参加するまで、クラスター内のすべてのノードおよびキャッシュが利用できなくなります。Data Grid は、不整合やデータ損失を防ぐために、クラスターに保存されているデータへのアクセスと、クラスター状態の変更を制限します。さらに、Data Grid はクラスターのリバランスを無効にし、起動時にローカルキャッシュストアがパージされないようにします。

クラスターの回復プロセス中に、コーディネーターノードは、新しいノードが参加するたびにメッセージをログに記録し、どのノードが使用可能でどのノードがまだ欠落しているかを示します。Data Grid クラスター内の他のノードには、参加時のビューが表示されます。Data Grid Console または REST API を使用して、キャッシュの可用性を監視できます。

ただし、すべてのノードを待機することが不要または望ましくない場合は、現在のトポロジーで使用可能なキャッシュを設定できます。この方法は、CLI (下記参照) または REST API を通じて可能です。

サーバーのシャットダウン

shutdown server コマンドを使用してノードを停止した後、オンラインに戻った最初のノードは、他のメンバーを待たずにすぐに使用できるようになります。残りのノードはすぐにクラスターに参加し、状態繊維がトリガーされますが、最初にローカル永続性が読み込まれるため、エントリーが失効する可能性があります。起動時にパージするように設定されたローカルキャッシュストアは、サーバーの起動時に空になります。purge=false としてマークされたローカルキャッシュストアは、サーバーの再起動後に使用可能になりますが、古いエントリーが含まれている可能性があります。

shutdown server コマンドを使用してクラスター化されたノードをシャットダウンする場合は、データ損失やキャッシュ内の古いエントリーに関連する問題が発生しないようにするために、各サーバーを逆の順序で再起動する必要があります。
たとえば、server1 をシャットダウンしてから、server2 をシャットダウンする場合は、最初に server2 を起動してから server1 を起動する必要があります。ただし、クラスター化されたノードを逆の順序で再起動しても、データ損失や古いエントリーを完全に防ぐことはできません。

XML、JSON、および YAML 形式で宣言型キャッシュ設定を作成できます。

すべての宣言型キャッシュは Data Grid スキーマに準拠する必要があります。JSON 形式の設定は XML 設定の構造に従う必要があります。要素がオブジェクトに対応し、属性はフィールドに対応します。

分散キャッシュ

<distributed-cache owners="2"
                   segments="256"
                   capacity-factor="1.0"
                   l1-lifespan="5000"
                   mode="SYNC"
                   statistics="true">
  <encoding media-type="application/x-protostream"/>
  <locking isolation="REPEATABLE_READ"/>
  <transaction mode="FULL_XA"
               locking="OPTIMISTIC"/>
  <expiration lifespan="5000"
              max-idle="1000" />
  <memory max-count="1000000"
          when-full="REMOVE"/>
  <indexing enabled="true"
            storage="local-heap">
    <index-reader refresh-interval="1000"/>
    <indexed-entities>
      <indexed-entity>org.infinispan.Person</indexed-entity>
    </indexed-entities>
  </indexing>
  <partition-handling when-split="ALLOW_READ_WRITES"
                      merge-policy="PREFERRED_NON_NULL"/>
  <persistence passivation="false">
    <!-- Persistent storage configuration. -->
  </persistence>
</distributed-cache>

{
  "distributed-cache": {
    "mode": "SYNC",
    "owners": "2",
    "segments": "256",
    "capacity-factor": "1.0",
    "l1-lifespan": "5000",
    "statistics": "true",
    "encoding": {
      "media-type": "application/x-protostream"
    },
    "locking": {
      "isolation": "REPEATABLE_READ"
    },
    "transaction": {
      "mode": "FULL_XA",
      "locking": "OPTIMISTIC"
    },
    "expiration" : {
      "lifespan" : "5000",
      "max-idle" : "1000"
    },
    "memory": {
      "max-count": "1000000",
      "when-full": "REMOVE"
    },
    "indexing" : {
          "enabled" : true,
          "storage" : "local-heap",
          "index-reader" : {
            "refresh-interval" : "1000"
          },
          "indexed-entities": [
            "org.infinispan.Person"
          ]
    },
    "partition-handling" : {
      "when-split" : "ALLOW_READ_WRITES",
      "merge-policy" : "PREFERRED_NON_NULL"
    },
    "persistence" : {
      "passivation" : false
    }
  }
}

distributedCache:
  mode: "SYNC"
  owners: "2"
  segments: "256"
  capacityFactor: "1.0"
  l1Lifespan: "5000"
  statistics: "true"
  encoding:
    mediaType: "application/x-protostream"
  locking:
    isolation: "REPEATABLE_READ"
  transaction:
    mode: "FULL_XA"
    locking: "OPTIMISTIC"
  expiration:
    lifespan: "5000"
    maxIdle: "1000"
  memory:
    maxCount: "1000000"
    whenFull: "REMOVE"
  indexing:
    enabled: "true"
    storage: "local-heap"
    indexReader:
      refreshInterval: "1000"
    indexedEntities:
      - "org.infinispan.Person"
  partitionHandling:
    whenSplit: "ALLOW_READ_WRITES"
    mergePolicy: "PREFERRED_NON_NULL"
  persistence:
    passivation: "false"
    # Persistent storage configuration.

レプリケートされたキャッシュ

<replicated-cache segments="256"
                  mode="SYNC"
                  statistics="true">
  <encoding media-type="application/x-protostream"/>
  <locking isolation="REPEATABLE_READ"/>
  <transaction mode="FULL_XA"
               locking="OPTIMISTIC"/>
  <expiration lifespan="5000"
              max-idle="1000" />
  <memory max-count="1000000"
          when-full="REMOVE"/>
  <indexing enabled="true"
            storage="local-heap">
    <index-reader refresh-interval="1000"/>
    <indexed-entities>
      <indexed-entity>org.infinispan.Person</indexed-entity>
    </indexed-entities>
  </indexing>
  <partition-handling when-split="ALLOW_READ_WRITES"
                      merge-policy="PREFERRED_NON_NULL"/>
  <persistence passivation="false">
    <!-- Persistent storage configuration. -->
  </persistence>
</replicated-cache>

{
  "replicated-cache": {
    "mode": "SYNC",
    "segments": "256",
    "statistics": "true",
    "encoding": {
      "media-type": "application/x-protostream"
    },
    "locking": {
      "isolation": "REPEATABLE_READ"
    },
    "transaction": {
      "mode": "FULL_XA",
      "locking": "OPTIMISTIC"
    },
    "expiration" : {
      "lifespan" : "5000",
      "max-idle" : "1000"
    },
    "memory": {
      "max-count": "1000000",
      "when-full": "REMOVE"
    },
    "indexing" : {
      "enabled" : true,
      "storage" : "local-heap",
      "index-reader" : {
        "refresh-interval" : "1000"
        },
      "indexed-entities": [
        "org.infinispan.Person"
      ]
    },
    "partition-handling" : {
      "when-split" : "ALLOW_READ_WRITES",
      "merge-policy" : "PREFERRED_NON_NULL"
    },
    "persistence" : {
      "passivation" : false
    }
  }
}

replicatedCache:
  mode: "SYNC"
  segments: "256"
  statistics: "true"
  encoding:
    mediaType: "application/x-protostream"
  locking:
    isolation: "REPEATABLE_READ"
  transaction:
    mode: "FULL_XA"
    locking: "OPTIMISTIC"
  expiration:
    lifespan: "5000"
    maxIdle: "1000"
  memory:
    maxCount: "1000000"
    whenFull: "REMOVE"
  indexing:
    enabled: "true"
    storage: "local-heap"
    indexReader:
      refreshInterval: "1000"
    indexedEntities:
      - "org.infinispan.Person"
  partitionHandling:
    whenSplit: "ALLOW_READ_WRITES"
    mergePolicy: "PREFERRED_NON_NULL"
  persistence:
    passivation: "false"
    # Persistent storage configuration.

複数のキャッシュ

<infinispan
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
      xsi:schemaLocation="urn:infinispan:config:15.0 https://infinispan.org/schemas/infinispan-config-15.0.xsd
                          urn:infinispan:server:15.0 https://infinispan.org/schemas/infinispan-server-15.0.xsd"
      xmlns="urn:infinispan:config:15.0"
      xmlns:server="urn:infinispan:server:15.0">
  <cache-container name="default"
                   statistics="true">
    <distributed-cache name="mycacheone"
                       mode="ASYNC"
                       statistics="true">
      <encoding media-type="application/x-protostream"/>
      <expiration lifespan="300000"/>
      <memory max-size="400MB"
              when-full="REMOVE"/>
    </distributed-cache>
    <distributed-cache name="mycachetwo"
                       mode="SYNC"
                       statistics="true">
      <encoding media-type="application/x-protostream"/>
      <expiration lifespan="300000"/>
      <memory max-size="400MB"
              when-full="REMOVE"/>
    </distributed-cache>
  </cache-container>
</infinispan>

{
  "infinispan" : {
    "cache-container" : {
      "name" : "default",
      "statistics" : "true",
      "caches" : {
        "mycacheone" : {
          "distributed-cache" : {
            "mode": "ASYNC",
            "statistics": "true",
            "encoding": {
              "media-type": "application/x-protostream"
            },
            "expiration" : {
              "lifespan" : "300000"
            },
            "memory": {
              "max-size": "400MB",
              "when-full": "REMOVE"
            }
          }
        },
        "mycachetwo" : {
          "distributed-cache" : {
            "mode": "SYNC",
            "statistics": "true",
            "encoding": {
              "media-type": "application/x-protostream"
            },
            "expiration" : {
              "lifespan" : "300000"
            },
            "memory": {
              "max-size": "400MB",
              "when-full": "REMOVE"
            }
          }
        }
      }
    }
  }
}

infinispan:
  cacheContainer:
    name: "default"
    statistics: "true"
    caches:
      mycacheone:
       distributedCache:
          mode: "ASYNC"
          statistics: "true"
          encoding:
            mediaType: "application/x-protostream"
          expiration:
            lifespan: "300000"
          memory:
            maxSize: "400MB"
            whenFull: "REMOVE"
      mycachetwo:
        distributedCache:
          mode: "SYNC"
          statistics: "true"
          encoding:
            mediaType: "application/x-protostream"
          expiration:
            lifespan: "300000"
          memory:
            maxSize: "400MB"
            whenFull: "REMOVE"

add - 任意の値でカウンターに増分または減分を適用します。

add ['OPTIONS'] ['COUNTER_NAME']

add --delta=10 cnt_a
cnt_a の値を 10 増やします。

add --delta=-5 cnt_a
cnt_a の値を 5 減らします。

cas(1)、reset(1)

alias - エイリアスを作成または表示します。

alias ['ALIAS-NAME'='COMMAND']

alias q=quit
quit コマンドのエイリアスとして q を作成します。

alias
定義されているすべてのエイリアスをリスト表示します。

config(1)、unalias(1)

alter - Data Grid Server のキャッシュの設定を変更します。

alter cache ['OPTIONS'] CACHE_NAME

変更が既存の設定と互換性がある場合にのみ、alter コマンドを使用してキャッシュを変更できます。

たとえば、レプリケートされたキャッシュ設定を使用して分散キャッシュを変更することはできません。同様に、特定の属性を使用してキャッシュ設定を作成する場合、代わりに別の属性を使用するように設定を変更することはできません。たとえば、max-count 属性の値を指定してキャッシュ設定を変更しようとすると、max-size がすでに設定されている場合、無効な設定になります。

alter cache mycache --file=/path/to/mycache.json
mycache.json ファイルを使用して、mycache という名前のキャッシュの設置を変更します。

alter cache mycache --attribute=clustering.remote-timeout --value=5000
clustering.remote-timeout 属性の値が '5000' となるように、mycache という名前のキャッシュの設置を変更します。

create(1)、drop(1)

availability - ネットワークパーティション内のクラスター化されたキャッシュの可用性を管理します。

availability ['OPTIONS'] ['CACHE_NAME']

AVAILABLE は、ネットワークパーティション内のすべてのノードでキャッシュを利用できるようにします。DEGRADED_MODE は、ネットワークパーティションが発生したときにキャッシュの読み取りおよび書き込み操作を防止します。

availability cache1
キャッシュ 'cache1' の現在の可用性を取得します。

availability --mode=AVAILABLE cache1
キャッシュ 'cache1' の可用性を AVAILABLE に設定します。

backup - コンテナーのバックアップ作成と復元を管理します。

backup create ['OPTIONS']

backup delete ['OPTIONS'] BACKUP_NAME

backup get ['OPTIONS'] BACKUP_NAME

backup ls

backup restore ['OPTIONS'] BACKUP_PATH

backup create -n example-backup
example-backup という名前ですべてのコンテナーコンテンツのバックアップを開始します。

backup create -d /some/server/dir
すべてのコンテナーコンテンツのバックアップを開始し、サーバーのパス /some/server/dir に保存します。

backup create --caches=* --templates=*
キャッシュとキャッシュ設定リソースのみを含むバックアップを開始します。

backup create --proto-schemas=schema1,schema2
指定されたスキーマリソースのみを含むバックアップを開始します。

backup ls
サーバーで使用可能なすべてのバックアップをリスト表示します。

backup get example-backup
example-backup アーカイブをサーバーからダウンロードします。バックアップ操作が進行中の場合、コマンドはバックアップ操作が完了するのを待ちます。

backup restore /some/path/on/the/server
サーバー上のバックアップアーカイブからすべてのコンテンツを復元します。

backup restore -u /some/local/path
サーバーにアップロードされたローカルバックアップアーカイブからすべてのコンテンツを復元します。

backup restore /some/path/on/the/server --caches=*
サーバー上のバックアップアーカイブからキャッシュコンテンツのみを復元します。

backup restore /some/path/on/the/server --proto-schemas=schema1,schema2
サーバー上のバックアップアーカイブから、指定されたスキーマリソースのみを復元します。

backup delete example-backup
example-backup アーカイブをサーバーから削除します。

drop(1)

benchmark - キャッシュに対してパフォーマンスベンチマークを実行します。

HTTP および Hot Rod プロトコル http、https、hotrod、および hotrods のパフォーマンスベンチマークを実行できます。URI を使用してベンチマークのプロトコルを指定します。プロトコルを指定しない場合、ベンチマークは現在の CLI 接続の URI を使用します。

Hot Rod URI のベンチマークは、クラスター全体に接続します。HTTP URI の場合、ベンチマークは単一のノードにのみ接続します。

ベンチマークは、既存のキャッシュに対してパフォーマンスをテストします。ベンチマークを実行する前に、測定する機能を備えたキャッシュを作成する必要があります。たとえば、クロスサイトレプリケーションのパフォーマンスを評価する場合は、バックアップの場所を持つキャッシュを作成する必要があります。永続性のパフォーマンスをテストする場合は、適切なキャッシュストアを使用するキャッシュを作成します。

benchmark ['OPTIONS'] [uri]

benchmark hotrod://localhost:11222
Hot Rod プロトコルを使用してベンチマークテストを実行します。

benchmark --value-size=10000 --cache=largecache hotrod://localhost:11222
サイズが 10000 バイトのテスト値を使用して、largecache キャッシュに対して Hot Rod プロトコルでベンチマークテストを実行します。

benchmark --mode=All --threads=20 https://user:password@server:11222
20 スレッドを使用して HTTPS プロトコルでベンチマークテストを実行し、レポートにすべてのモードを含めます。

cache - 後続のコマンドのデフォルトキャッシュを選択します。

cache ['CACHE_NAME']

cache mycache
mycache を選択します。cd caches/mycache を使用してリソースツリーをナビゲートするのと同じです。

cd(1)、clear(1)、container(1)、get(1)、put(1)、remove(1)

cas - 強力なカウンターで 'compare-and-swap' 操作を実行します。

cas ['OPTIONS'] ['COUNTER_NAME']

cas --expect=10 --value=20 cnt_a
現在の値が 10 の場合にのみ、cnt_a の値を 20 に設定します。

add(1)、cas(1)、reset(1)

cd - サーバーリソースツリーをナビゲートします。

PATH は、絶対パスまたは現在のリソースに対する相対パスです。../ は親リソースを指定します。

cd ['PATH']

cd caches
リソースツリーの caches パスに変更します。

cache(1)、ls(1)、container(1)

clearcache - キャッシュからすべてのエントリーを削除します。

clearcache ['CACHE_NAME']

clearcache mycache
mycache からすべてのエントリーを削除します。

cache(1)、drop(1)、remove(1)

config - CLI 設定プロパティーを管理します。

config

config set 'name' 'value'

config get 'name'

config convert --outputFormat=[xml|json|yaml] [-o outputFile] [inputFile]

CLI 設定プロパティーを管理 (一覧表示、設定、取得) し、さまざまな形式 (XML、JSON、YAML) 間の設定変換を提供します。

これらのオプションは、すべてのコマンドに適用されます。

次のオプションが convert コマンドに適用されます。

config set autoconnect-url http://192.0.2.0:11222
CLI の起動時に、カスタム IP アドレスでサーバーに接続します。

config get autoconnect-url
autoconnect-url 設定プロパティーの値を返します。

config set autoexec /path/to/mybatchfile
CLI の起動時に、"mybatchfile" という名前のバッチファイルを実行します。

config set trustall true
すべてのサーバー証明書を信頼します。

config set truststore /home/user/my-trust-store.jks
"my-trust-store.jks"という名前のキーストアのパスを指定します。

config set truststore-password secret
必要に応じて、キーストアのパスワードを設定します。

config convert -f yaml -o infinispan.yaml infinispan.xml
infinispan.xml ファイルを YAML に変換し、出力を infinispan.yaml ファイルに書き込みます。

config convert -f json
設定を標準入力から JSON に変換し、出力を標準出力に書き込みます。

alias(1)、unalias(1)

connect - 実行中の Data Grid サーバーに接続します。

デフォルトは http://localhost:11222 で、認証が必要な場合は認証情報の入力を求められます。

connect ['OPTIONS'] ['SERVER_LOCATION']

connect 127.0.0.1:11322 -u test -p changeme
100 のポートオフセットとサンプルの認証情報を使用して、ローカルで実行されているサーバーに接続します。

disconnect(1)

container - 後続のコマンドを実行するためのコンテナーを選択します。

container ['CONTAINER_NAME']

container default
デフォルトのコンテナーを選択します。これは、cd containers/default を使用してリソースツリーをナビゲートするのと同じです。

cd(1)、clear(1)、container(1)、get(1)、put(1)、remove(1)

counter - 後続のコマンドのデフォルトカウンターを選択します。

counter ['COUNTER_NAME']

counter cnt_a
cnt_a を選択します。cd counters/cnt_a を使用してリソースツリーをナビゲートするのと同じです。

add(1)、cas(1)

create - Data Grid サーバーにキャッシュとカウンターを作成します。

create cache ['OPTIONS'] CACHE_NAME

create counter ['OPTIONS'] COUNTER_NAME

create cache --template=org.infinispan.DIST_SYNC mycache
DIST_SYNC テンプレートから mycache という名前のキャッシュを作成します。

create counter --initial-value=3 --storage=PERSISTENT --type=strong cnt_a
cnt_a という名前の強力なカウンターを作成します。

drop(1)

credentials - Data Grid Server のクレデンシャルを含むキーストアを管理します

credentials ls

credentials add 'alias'

credentials remove 'alias'

credentials mask -i iterations -s salt secret

キーストア内の認証情報を一覧表示、作成、および削除し、キーストアのパスワードをマスクします。デフォルトでは、コマンドはサーバー設定ディレクトリーの credentials.pfx キーストアを管理します。

クレデンシャルの追加

クレデンシャルの削除

credentials add dbpassword -c changeme -p "secret1234!"
認証情報キーストアがまだ存在しない場合は、新しいデフォルトの認証情報キーストアを作成し、"changeme"のパスワードに"dbpassword"のエイリアスを追加します。このコマンドはクレデンシャルキーストアのパスワードとして"secret1234!"も設定します。このパスワードは、サーバー設定のパスワード <clear-text-credential clear-text="secret1234!"/> と一致する必要があります。

credentials ls -p "secret1234!"
デフォルトのクレデンシャルキーストア内のすべてのエイリアスをリスト表示します。

credentials add ldappassword -t JCEKS -p "secret1234!"
JCEKS 形式で認証情報キーストアを作成し、エイリアス"ldappassword"を追加します。このコマンドは、エイリアスに対応するパスワードを指定するように要求します。

credentials mask "secret1234!" -i 100 -s pepper99 認証情報 "secret1234!" のマスクされた表現を作成します。文字列 pepper99 をソルトとして使用して 100 回の反復を使用します。

describe - リソースに関する情報を表示します。

describe ['PATH']

describe //containers/default
デフォルトのコンテナーに関する情報を表示します。

describe //containers/default/caches/mycache
mycache キャッシュに関する情報を表示します。

describe //containers/default/caches/mycache/k1
k1 キーに関する情報を表示します。

describe //containers/default/counters/cnt1
cnt1 カウンターに関する情報を表示します。

cd(1)、ls(1)

disconnect - Data Grid サーバーとの CLI セッションを終了します。

disconnect

disconnect
現在の CLI セッションを終了します。

connect(1)

drop - キャッシュとカウンターを削除します。

drop cache CACHE_NAME

drop counter COUNTER_NAME

drop cache mycache
mycache キャッシュを削除します。

drop counter cnt_a
cnt_a カウンターを削除します。

create(1)、clearcache(1)

encoding - キャッシュエントリーのエンコーディングを表示および設定します。

キャッシュに対するputおよびget操作のデフォルトのエンコーディングを設定します。引数が指定されていない場合、encodingコマンドは現在のエンコーディングを表示します。

有効なエンコーディングでは、次のような標準の MIME タイプ (IANA メディアタイプ) の命名規則が使用されます。

encoding ['ENCODING']

encoding application/json
エントリーを application/json としてエンコードするように、現在選択されているキャッシュを設定します。

get(1)、put(1)

get - キャッシュからエントリーを取得します。

get ['OPTIONS'] KEY

get hello -c mycache
mycache から hello という名前のキーの値を取得します。

query(1)、put(1)

help - コマンドのマニュアルページを出力します。

help ['COMMAND']

help get
getコマンドのマニュアルページを出力します。

version(1)

index - キャッシュインデックスを管理します。

index reindex 'cache-name'

index clear 'cache-name'

index update-schema 'cache-name'

index stats 'cache-name'

index clear-stats 'cache-name'

index reindex mycache
キャッシュを再インデックス化します。

index clear mycache
キャッシュインデックスをクリアします。

index update-schema mycache
キャッシュのインデックススキーマを更新します。

index stats mycache
キャッシュのインデックス作成と検索の統計を表示します。

index clear-stats mycache
キャッシュのインデックス作成と検索の統計をクリアします。

query(1)

install - Data Grid サーバーのアーティファクトをダウンロードしてインストールします。

アーティファクトを server/lib ディレクトリーにダウンロードしてインストールします。アーティファクトのダウンロード場所は、Maven アーティファクト座標、URL、またはローカルファイルパスとして指定できます。

Maven アーティファクトをダウンロードする場合は、オプションの Maven settings.xml ファイルによって、リモートおよびローカルリポジトリーの場所と、認証情報およびプロキシー設定が決定されます。

アーティファクトを zip、tar.gz、または tgz アーカイブとしてダウンロードすると、コンテンツが抽出されます。

install 'artifact-1[[|algorithm]|checksum]' ['artifact-2[[|algorithm]|checksum]'…​]

アーティファクト名は、次のいずれかになります。

ダウンロード後にアーティファクトのチェックサムを検証できます。アルゴリズムのデフォルトは SHA-256 ですが、MD-5、SHA-1、SHA-256、SHA-384、または `SHA-512' にすることもできます。

install -o org.postgresql:postgresql:42.3.1
PostgreSQL JDBC ドライバー JAR をインストールし、すでに存在する場合は上書きします。

install https://example.org/artifact.zip
artifact.zip をダウンロードし、内容を抽出します。

install https://example.org/artifact.zip|52d73f9b3611610ebbb4dca7c2ac1171218eb09891c1faba10f5f54c1d2acc13
artifact.zip をダウンロードし、その SHA-256 チェックサムを検証して、コンテンツを抽出します。

install https://example.org/artifact.zip|MD5|2b48d1871ee26f969d8481db94e103c2
artifact.zip をダウンロードし、その MD-5 チェックサムを検証して、コンテンツを抽出します。

logging - Data Grid サーバーのランタイムロギング設定を検査および操作します。

logging list-loggers

logging list-appenders

logging set ['OPTIONS'] [LOGGER_NAME]

logging remove LOGGER_NAME

logging list-loggers
利用可能なすべてのロガーをリスト表示します。

logging set --level=DEBUG --appenders=FILE org.infinispan
org.infinispan ロガーのログレベルを DEBUG に設定し、FILE アペンダーを使用するように設定します。

ls - 現在のパスまたは特定のパスのリソースをリスト表示します。

ls ['PATH']

ls caches
使用可能なキャッシュをリスト表示します。

ls ../
親リソースをリスト表示します。

ls -l --pretty-print=CSV /containers/default/caches/mycache > mycache.csv
キー、値、メタデータを含むキャッシュのコンテンツを一覧表示し、コンテンツをファイルにリダイレクトします。

cd(1)

migrate - Data Grid のあるバージョンから別のバージョンにデータを移行します。

migrate cluster connect

migrate cluster synchronize

migrate cluster disconnect

migrate cluster source-connection

ストアの移行

あるバージョンの Data Grid から別のバージョンにデータを移行するには、migrate コマンドを使用します。

クラスターの移行

ストアの移行

これらのオプションは、すべてのコマンドに適用されます。

クラスター接続のオプション

*-c, --cache*='name'::
The name of the cache to connect to the source.

*-f, --file*='FILE'::
Specifies a configuration file in JSON format, containing a single 'remote-store' element.

CLUSTER SYNCHRONIZE OPTIONS
---------------------------

*-c, --cache*='name'::
The name of the cache to synchronize.

*-b, --read-batch*='num'::
The amount of entries to process in a batch. Defaults to 10000.

*-t, --threads*='num'::
The number of threads to use. Defaults to the number of cores on the server.


CLUSTER DISCONNECT OPTIONS

*-P

patch - サーバーパッチを管理します。

サーバーパッチをリスト表示、説明、インストール、ロールバック、および作成します。

パッチは、サーバーをアップグレードして問題を解決したり、新しい機能を追加したりするためのアーティファクトを含む zip アーカイブファイルです。パッチは、異なるバージョンの複数のサーバーインストールにターゲットバージョンを適用できます。

patch ls

patch install 'patch-file'

patch describe 'patch-file'

patch rollback

patch create 'patch-file' 'target-server' 'source-server-1' ['source-server-2'…​]

patch ls
サーバーに現在インストールされているパッチをインストール順にリスト表示します。

patch install mypatch.zip
サーバーの現在のディレクトリーに"mypatch.zip"をインストールします。

patch install mypatch.zip --server=/path/to/server/home
サーバーの別のディレクトリーに"mypatch.zip"をインストールします。

patch describe mypatch.zip
"mypatch.zip"のターゲットバージョンとソースバージョンのリストを表示します。

patch create mypatch.zip 'target-server' 'source-server-1' ['source-server-2'…​]
ターゲットサーバーのバージョンを使用し、ソースサーバーのバージョンに適用する"mypatch.zip"という名前のパッチファイルを作成します。

patch rollback
サーバーに適用された最後のパッチをロールバックし、以前のバージョンを復元します。

put - キャッシュエントリーを追加または更新します。

新しいキーのエントリーを作成します。既存のキーの値を置き換えます。

put ['OPTIONS'] KEY [VALUE]

put -c mycache hello world
値が world の hello キーを mycache キャッシュに追加します。

put -c mycache -f myfile -i 500 hola
値が myfile の内容の hola キーを追加します。また、最大アイドル時間を 500 秒に設定します。

get(1)、remove(1)

query - Ickle クエリーを実行して、リモートキャッシュのエントリーを照合します。

query ['OPTIONS'] QUERY_STRING

query "from org.infinispan.example.Person p where p.gender = 'MALE'"
リモートキャッシュの値にクエリーを行い、性別データ型が MALE であるいる Protobuf Person エンティティーからのエントリーを検索します。

index(1) schema(1)

quit - コマンドラインインターフェイスを終了します。

quit

exitとbyeはコマンドエイリアスです。

quit
CLI セッションを終了します。

exit
CLI セッションを終了します。

bye
CLI セッションを終了します。

disconnect(1)、shutdown(1)

rebalance - キャッシュの自動リバランスを管理します。

rebalance enable ['PATH']

rebalance disable ['PATH']

rebalance enable
現在のコンテキストで自動リバランスを有効にします。このコマンドをルートコンテキストで実行すると、すべてのキャッシュのリバランスが有効になります。

rebalance enable caches/mycache
mycache という名前のキャッシュの自動リバランスを有効にします。

rebalance disable
現在のコンテキストで自動リバランスを無効にします。このコマンドをルートコンテキストで実行すると、すべてのキャッシュのリバランスが無効になります。

rebalance disable caches/mycache
mycache という名前のキャッシュの自動リバランスを無効にします。

remove - キャッシュからエントリーを削除します。

remove KEY ['OPTIONS']

remove --cache=mycache hola
mycache キャッシュから hola エントリーを削除します。

cache(1)、drop(1)、clearcache(1)

reset - カウンターの初期値を復元します。

reset ['COUNTER_NAME']

reset cnt_a
cnt_a カウンターをリセットします。

add(1)、cas(1)、drop(1)

schema - Protobuf スキーマを操作します。

schema ls

schema upload --file=/path/to/schema.proto schema.proto

schema remove schema.proto

schema get schema.proto

ls、upload、get、remove サブコマンドを使用してスキーマを管理します。

schema upload --file=person.proto person.proto
Protobuf スキーマ person.proto を登録します。

query(1)

server - サーバー設定と状態管理。

serverコマンドは、サーバーエンドポイントコネクターとデータソースを記述および管理し、サーバーとホストの両方に関する集約された診断レポートを取得します。

レポートは、設定ファイルとログファイルに加えて、CPU、メモリー、開いているファイル、ネットワークソケットとルーティング、スレッドに関する詳細を提供します。

server report

server heap-dump [--live]

server connections ls [--global]

server connector ls

server connector describe 'connector-name'

server connector start 'connector-name'

server connector stop 'connector-name'

server connector ipfilter ls 'connector-name'

server connector ipfilter set 'connector-name' --rules='[ACCEPT|REJECT]/cidr',…​

server connector ipfilter clear 'connector-name'

server datasource ls

server datasource test 'datasource-name'

server principals ls

server aclcache flush

server report
: ネットワーク、スレッド、メモリーなどに関する情報を含むサーバーレポートを取得します。

server heap-dump
: サーバーデータディレクトリーに JVM ヒープダンプを生成し、生成されたファイルの名前を返します。

server connections ls
: サーバーへのアクティブなクライアント接続をすべてリスト表示します。--global 引数は、すべてのクラスターメンバーからの接続を返します。

server connector ls
サーバーで使用可能なすべてのコネクターをリスト表示します。

server connector describe endpoint-default
ホスト、ポート、ローカルおよびグローバル接続、IP フィルタリングルールなど、指定されたコネクターに関する情報を表示します。

server connector stop my-hotrod-connector
クラスター全体で確立されたすべての接続をドロップするコネクターを停止します。要求を処理しているコネクターを停止しようとすると、このコマンドは拒否されます。

server connector start my-hotrod-connector
クラスター全体の接続を受け入れることができるように、コネクターを開始します。

server connector ipfilter ls my-hotrod-connector
クラスター全体のコネクターでアクティブなすべての IP フィルタリングルールを一覧表示します。

server connector ipfilter set my-hotrod-connector --rules=ACCEPT/192.168.0.0/16,REJECT/10.0.0.0/8 クラスター全体のコネクターに IP フィルタリングルールを設定します。既存のすべてのルールを置き換えます。拒否ルールの 1 つが、呼び出された接続のアドレスと一致する場合、このコマンドは拒否されます。

server connector ipfilter clear my-hotrod-connector
クラスター全体のコネクターのすべての IP フィルタリングルールを削除します。

server datasource ls
サーバー上で使用可能なすべてのデータソースをリスト表示します。

server datasource test my-datasource
データソースでテスト接続を実行します。

server principals ls
サーバーが認識しているプリンシパルをリスト表示します。

server aclcache flush
クラスター全体のセキュリティーキャッシュをフラッシュします。

shutdown - サーバーインスタンスとクラスターを停止します。

shutdown server ['SERVERS']

shutdown cluster

shutdown container

shutdown server
CLI が接続されているサーバーを停止します。

shutdown server my_server01
ホスト名が my_server01 のサーバーを停止します。

shutdown cluster
クラスターの状態を保存し、キャッシュストアがある場合はエントリーを永続化した後、クラスター内のすべてのノードを停止します。

shutdown container
サーバープロセスを終了せずにデータコンテナーを停止します。クラスターの状態を保存し、キャッシュストアがある場合はエントリーを保持します。サーバーインスタンスは、アクティブなエンドポイントとクラスタリングで引き続き実行されます。コンテナーリソースへの REST 呼び出しは、503 Service Unavailable 応答になります。shutdown container コマンドは、リソースのライフサイクル管理を自動化する Kubernetes などの環境を対象としています。自己管理環境では、shutdown server または shutdown cluster コマンドを使用してサーバーを停止する必要があります。

connect(1)、disconnect(1)、quit(1)

site - バックアップの場所を管理し、サイト間のレプリケーション操作を実行します。

site status ['OPTIONS']

site bring-online ['OPTIONS']

site take-offline ['OPTIONS']

site push-site-state ['OPTIONS']

site cancel-push-state ['OPTIONS']

site cancel-receive-state ['OPTIONS']

site push-site-status ['OPTIONS']

site state-transfer-mode get|set ['OPTIONS']

site name

site view

site is-relay-node

site relay-nodes

site status --cache=mycache
mycache のすべてのバックアップ場所のステータスを返します。

site status --all-caches
バックアップのあるすべてのキャッシュの各バックアップロケーションのステータスを返します。

site status --cache=mycache --site=NYC
mycache の NYC のステータスを返します。

site bring-online --cache=mycache --site=NYC
mycache のサイト NYC をオンラインにします。

site take-offline --cache=mycache --site=NYC
mycache のサイト NYC をオフラインにします。

site push-site-state --cache=mycache --site=NYC
キャッシュをリモートバックアップの場所にバックアップします。

site push-site-status --cache=mycache
mycache をバックアップする操作のステータスを表示します。

site cancel-push-state --cache=mycache --site=NYC
mycache を NYC にバックアップする操作をキャンセルします。

site cancel-receive-state --cache=mycache --site=NYC
NYC から状態を受信する操作をキャンセルします。

site clear-push-state-status --cache=myCache
mycache の状態をプッシュする操作のステータスをクリアします。

site state-transfer-mode get --cache=myCache --site=NYC
mycache の状態転送モードを NYC に取得します。

site state-transfer-mode set --cache=myCache --site=NYC --mode=AUTO
mycache の NYC への自動状態転送を設定します。

site name
ローカルサイトの名前を返します。クロスサイトレプリケーションが設定されていない場合、ローカルサイトの名前は常に"local"です。

site view
すべてのサイトの名前のリストを返します。クロスサイトレプリケーションが設定されていない場合は、空のリスト ("[]") を返します。

site is-relay-node
ノードがクラスター間の RELAY メッセージを処理する場合は true を返します。

site relay-nodes
リレーノードのリストを論理名で返します。

stats - リソースに関する統計を表示します。

stats ['PATH']

stats //containers/default
デフォルトのコンテナーに関する統計を表示します。

stats //containers/default/caches/mycache
mycache キャッシュに関する統計を表示します。

cd(1)、ls(1)、describe(1)

task - サーバー側のタスクとスクリプトを実行してアップロードします

task upload --file='script' 'TASK_NAME'

task exec ['TASK_NAME']

task upload --file=hello.js hello
hello.js ファイルからスクリプトをアップロードし、hello という名前を付けます。

task exec @@cache@names
使用可能なキャッシュ名を返すタスクを実行します。

task exec hello -Pgreetee=world
hello という名前のスクリプトを実行し、world の値で greetee パラメーターを指定します。

ls(1)

unalias - エイリアスを削除します。

unalias 'ALIAS-NAME'

unalias q
q エイリアスを削除します。

config(1)、alias(1)

user - プロパティーセキュリティーレルムで Data Grid ユーザーを管理します。

user ls

user create 'username'

user describe 'username'

user remove 'username'

user password 'username'

user groups 'username'

user encrypt-all

user roles ls 'principal'

user roles grant --roles='role1'[,'role2'…​] 'principal'

user roles deny --roles='role1'[,'role2'…​] 'principal'

user roles create --description='custom description' --permissions='perm1'[,'perm2'…​] 'role'

user roles update --permissions='perm1'[,'perm2'…​] --description='updated description' 'role'

user roles remove 'role'

user roles describe 'role'

ls、create、describe、remove、password、groups、および encrypt-all サブコマンドを使用して、プロパティーレルムのユーザーを管理します。承認にクラスターロールマッパーを使用する場合は、roles サブコマンドを使用してプリンシパルからロールへのマッピングをリスト表示および変更します。

これらのオプションは、すべてのコマンドに適用されます。

version - サーバーのバージョンと CLI のバージョンを表示します。

version

version
サーバーと CLI のバージョンを返します。

help(1)