mqsichangeresourcestats コマンド- Windows、 Linux、および AIX システム
Windows、 Linux®、および AIX® システムで mqsichangeresourcestats コマンドを使用して、統合ノード内のリソースの統計収集を制御します。
構文
パラメーター
- このパラメーターは、特定の統合ノードの名前を識別します。 リモート統合ノードに名前で接続するには、 --admin-host と(オプションで) --admin-port パラメータも指定する必要があります。
- このパラメーターは、統合ノードまたは独立統合サーバーに関する接続の詳細を含む .broker ファイルの名前を識別します。 このパラメーターの指定時には、場所 (パス) とファイル名を含めてください。 このコマンドの実行時には、この場所がアクセス可能であることを確認しなければなりません。
このファイルを使用して独立統合サーバーに接続できます。 接続詳細にノード名 (integrationNodeName) が含まれていないこと、ホストとポートが独立統合サーバーのものであることが必要です。
このオプションは、複数のユーザーが同じ統合ノードまたは統合サーバーに接続する場合や、SSL などの拡張接続パラメーターを使用する場合に使用します。 .broker ファイルの作成と使用方法の詳細については、.broker ファイルを作成して統合ノードに接続するを参照してください。
保護されたチャネルでリモート統合ノードや統合サーバーを管理するために SSL を使用するコマンドを実行することができます。 IBM_JAVA_OPTIONS 環境変数を使用している接続には、鍵ストアおよびトラストストアのパスワードを指定する必要があります。 詳細については、 コマンド実行時の問題解決を参照のこと。
- これらのパラメーターは、拡張接続パラメーターを必要としない接続に対して、統合ノードまたは独立統合サーバーのホストとポートを識別します。
特定のリモート統合ノードに名前で接続するには、接頭辞に integrationNodeName. 同じコマンドで --integration-node-file (-n) integrationNodeFileName パラメータを使用することはできません。
統合ノードの場合、いずれのパラメーターも、省略した場合、デフォルト値が使用されます。
- --admin-host ホスト (または -i ipAddress ). 統合ノードまたは統合サーバーが稼働しているコンピューターのホスト名または IP アドレス。 このパラメーターを指定しない場合、ローカル・コンピューターを表す値が使用されます。
独立統合サーバーに接続する場合、この値には、統合サーバーの server.conf.yaml 構成ファイルの adminRestApiHost プロパティーで設定したホストを指定します。
保護された統合ノードまたは統合サーバーに特定ユーザーで接続する場合は、
tcp://user:password@hostnameの形式の URI として セキュリティー資格情報を指定します。 パスワードに URI 予約文字が含まれている場合は、 それらの文字をパーセントでエンコードされた形式に変換する必要があります。 詳細については、「 コマンド実行時の問題を解決する 」の「 リモート・ホスト名に接続しようとすると、正しい URL、パスワードがエラー BIP1939 を返します 」を参照してください。 - --admin-port ポート (または -p ポート )。 Web ユーザー・インターフェース HTTP 接続リスナーが listen しているポート。 このパラメーターを指定しない場合、値 4414 が使用されます。
独立統合サーバーに接続する場合、この値には、server.conf.yaml 構成ファイル内の adminRestApiPort プロパティーに設定したポートを指定します。 デフォルトでは、adminRestApiPort は 7600 に設定されます。
- --admin-host ホスト (または -i ipAddress ). 統合ノードまたは統合サーバーが稼働しているコンピューターのホスト名または IP アドレス。 このパラメーターを指定しない場合、ローカル・コンピューターを表す値が使用されます。
その他のパラメーター:
- --https
- (オプション)統合ノードまたはサーバーへの接続に HTTPS を使用することを指定します。 --https も --no-https も指定されていない場合は、まず HTTPS で接続を試み、最初の試みが失敗した場合は HTTPS を使わずに接続を試みる。
- --no-https
- (オプション)統合ノードまたはサーバーへの接続に HTTPS を使用しないことを指定します。 --https も --no-https も指定されていない場合は、まず HTTPS で接続を試み、最初の試みが失敗した場合は HTTPS を使わずに接続を試みる。
- --cacert cacertFile
- (オプション)統合ノードまたはサーバーの検証に使用する証明書ファイル( PEM、 P12、またはJKS形式)のパスを指定します。 cacertファイルが指定されず、デフォルトのadmin-sslが有効になっている場合、cacertファイルのデフォルトはadmin-sslのデフォルトのpemファイルとなる。
- --cacert パラメーターは、 HTTPS が接続に使用されている場合にのみ有効であるため、 --no-https パラメーターと一緒に設定することはできない。 パラメータ --https が設定されている場合、あるいは --no-https パラメータ --https もパラメータも設定されていない場合(この場合はデフォルト --cacert で SSL が使用されます)に設定できます。
- --cacert パラメータは、 --admin-host パラメータが URI なしで指定されている場合、または
ssl://で始まる URI が指定されている場合にのみ設定できる。
- --cacert-password cacertPassword
- (オプション)パスワードで保護されたcacertファイルのパスワード。
- --cacert-password パラメーターは、 HTTPS が接続に使用され、 --cacert パラメーターが設定されている場合にのみ有効である。 --no-https パラメーターと一緒に設定することはできない。
- --cacert-password パラメータは、 --admin-host パラメータが URI なしで指定されている場合、または
ssl://で始まる URI が指定されている場合にのみ設定できる。
- --insecure
- (オプション) 統合ノードまたはサーバーから返される証明書が検証されないことを指定します。
- --insecure パラメーターは、 HTTPS が接続に使用されている場合にのみ有効であるため、 --no-https パラメーターと一緒に設定することはできない。 パラメータ --https が設定されている場合、あるいは --no-https パラメータ --https もパラメータも設定されていない場合(この場合はデフォルト --insecure で SSL が使用されます)に設定できます。
- --insecure パラメータは、 --admin-host パラメータが URI なしで指定されている場合、または
ssl://で始まる URI が指定されている場合にのみ設定できる。
- --control | -c コントロール
- (必須) リソース統計収集に適用するアクションを定義する値。
- リソース統計収集を開始する場合は、
activeを指定します。 - リソース統計収集を停止する場合は、
inactiveを指定します。
- リソース統計収集を開始する場合は、
- --integration-server | -e integrationServerName
- (オプション) リソース統計収集を開始/停止する統合サーバーの名前。
--integration-server または -e を指定しない場合、リソース統計の収集は、統合ノード上のすべての統合サーバーに対して開始または停止されます。
- --non-persist
- (オプション) このパラメーターは、統合サーバーの再始動時またはメッセージ・フローの再デプロイ時、コマンドによって指定されたその他の設定を保持しないことを指定します。その時点からは、server.conf.yaml ファイル内に指定されている設定が有効になります。 デフォルトでは、このパラメーターは設定されてません。つまり、このコマンドで指定する設定は、 統合サーバーまたはノードの再起動時、およびメッセージ・フローの再デプロイ時も維持されます。
例
IntNodeA のすべての統合サーバーでリソース統計の収集を開始します。
mqsichangeresourcestats IntNodeA --control active 統合ノード IntNodeA の統合サーバー default でリソース統計の収集を停止します。
mqsichangeresourcestats IntNodeA --control inactive --integration-server default 