registerNode コマンド

構文

registerNode コマンド構文は次のようになります。

registerNode [options]

パラメーター

registerNode コマンドで使用可能なオプションは、以下のとおりです。

-conntype<JSR160RMI|IPC|RMI|SOAP>

管理エージェントに接続してノードの登録を開始するために使用される、オプションのコネクター・タイプ。 デフォルトは SOAP です。

非推奨フィーチャー: RMI コネクターのサポートは推奨されないため、最終的には RMI コネクターから JSR160RMI コネクターに切り替える必要があります。

-host ホスト名

管理エージェントのホスト名を指定するオプション・パラメーター。

-name 管理対象ノード名

管理エージェントに管理対象ノードが登録された後で、そのノードの名前を指定するオプション・パラメーター。

-nodepassword ノード・パスワード

登録するノードのパスワードを指定するオプション・パラメーター。 このパラメーターは、セキュリティーがノードでオンになっており、そのパスワードが管理エージェントのパスワードと異なる場合に指定します。 このパラメーターは -nodeusername パラメーターとともに使用してください。 -nodeusername パラメーターと -nodepassword パラメーターは、ノード上のすべてのサーバーを停止するために使用されます。

-nodeusername ノード・ユーザー名

登録するノードのユーザー名を指定するオプション・パラメーター。 このパラメーターは、セキュリティーがノードでオンになっており、そのユーザー名が管理エージェントのユーザー名とは異なる場合に指定します。 このパラメーターは -nodepassword パラメーターとともに使用してください。 -nodeusername パラメーターと -nodepassword パラメーターは、ノード上のすべてのサーバーを停止するために使用されます。

-openConnectors コネクター

管理エージェントが開くコネクターのリスト (各コネクターはコンマで区切られます) を指定するオプション・パラメーター。 デフォルトでは、すべてのコネクターが開かれます。

-port ポート番号

管理エージェントのコネクター・ポートのポート番号を指定するオプション・パラメーター。

管理エージェントのデフォルト SOAP ポートのポート番号は、デフォルトで 8878 です。 SOAP は、コマンドのデフォルトの Java™ Management Extensions (JMX) コネクター・タイプです。 複数の製品がインストールされている場合、あるいは複数のプロファイルがある場合は、SOAP ポートが 8878 以外になることがあります。 現在使用中のポートを確認するには、管理エージェントの SystemOut.log ファイルを調べてください。

注: このトピックでは、1 つ以上のアプリケーション・サーバー・ログ・ファイルを参照します。 推奨される代替方法として、分散システムおよび IBM® i システムで SystemOut.log 、 SystemErr.log、 trace.log、および activity.log ファイルを使用する代わりに、High Performance Extensible Logging (HPEL) ログおよびトレース・インフラストラクチャーを使用するようにサーバーを構成することができます。 HPEL は、ネイティブ z/OS® ロギング機能と組み合わせて使用することもできます。 HPEL を使用する場合、すべてのログとトレース情報にアクセスするには、サーバー・プロファイルの bin ディレクトリーから、LogViewer コマンド行ツールを使用します。 HPEL の使用について詳しくは、 HPEL の使用に関する情報 を参照してアプリケーションのトラブルシューティングを行ってください。

-profilePath プロファイル・パス

登録するアプリケーション・サーバー・ノードのプロファイルへのパスを指定する必須パラメーター。

-trace

registerNode コマンドのトレース出力を指定するオプション・パラメーター。

-portsFile ポート・ファイル

新規に登録されたノードのポート設定値を定義するファイルへのパスを指定するオプション・パラメーター。

-portsFile パラメーターを指定しなかった場合、ノードの登録中に、registerNode コマンドは、自動的に生成されたセットの推奨ポートを使用します。 推奨されるポート値は、デフォルト・ポートの可用性に基づくデフォルト・ポート値とは異なっている場合があります。

指定する ports_file ファイルのフォーマットは、portdef.props ファイルと同じです。ただし、ポートは、SOAP_CONNECTOR_ADDRESS、RMI_CONNECTOR_ADDRESS、JSR160RMI_CONNECTOR_ADDRESS、および IPC_CONNECTOR_ADDRESS のみが使用されます。

-profileName 「profile_name」

管理エージェントのプロファイル名を指定するオプション・パラメーター。

-username ユーザー名

管理エージェントにログオンするためのユーザー ID を指定するオプション・パラメーター。

-password パスワード

管理エージェントにログオンするためのパスワードを指定するオプション・パラメーター。

-help

使用法ステートメントを表示するオプション・パラメーター。

-?

使用法ステートメントを表示するオプション・パラメーター。

使用シナリオ

以下は、正しい構文の例です。 コマンドは、印刷目的のために複数行に分割されています。

registerNode.sh -conntype SOAP -port 8878 
 -profilePath app_server_root/profiles/AppSrv01

registerNode.bat -conntype SOAP -port 8878 
 -profilePath app_server_root\profiles\AppSrv01

registerNode -conntype SOAP -port 8878 
 -profilePath user_data_root/profiles/AppSrv01