registerNode コマンド

registerNode コマンドを使用して、スタンドアロン・ノードを管理エージェントに登録します。これにより、管理エージェントは そのノードを管理できるようになります。

管理エージェント・サーバーの bin ディレクトリーから registerNode コマンドを実行して、ノードを管理エージェントに登録します。コマンドを実行すると、スタンドアロン・ノードは、管理エージェントが管理するノードに変換されます。

管理エージェントおよび登録するノードは、同じコンピューター上にある必要があります。

管理エージェントは、複数の統合されていない (スタンドアロン) アプリケーション・サーバー・ノードを管理するための単一のインターフェースとして機能し、 例えば、開発環境、単体テスト環境、サーバー・ファーム環境などで使用されます。単一のインターフェースを使用して、アプリケーション・サーバーを管理することによって、すべてのアプリケーション・サーバーにおいて、管理サービス実行のオーバーヘッドが削減されます。

管理エージェントの管理コンソールを使用して、 管理エージェントの構成、管理エージェントに登録されたノードのプロパティーの表示および変更、 ジョブ・マネージャーに対するアプリケーション・サーバー・ノードの登録および登録抹消、登録されたノードのジョブ・マネージャー構成の表示および変更が可能です。 ジョブ・マネージャーでは、ノードがジョブ・サーバーにも登録されている場合に、 管理エージェントに登録されたノードのジョブを非同期にサブミットして管理することができます。 管理エージェント・サブシステムについて詳しくは、Overview of administrative enhancements developer works 記事で管理エージェントに関するセクションを参照してください。

トラブルの回避 (Avoid trouble) トラブルの回避 (Avoid trouble): 登録するノードには、 管理エージェントと同じ製品がなければなりません。また、これらの製品のバージョン・レベルも 管理エージェントと同じでなければなりません。管理エージェントでは、登録されたノードのすべての管理機能 を実施できるようにノードと環境が一致していなければならないため、この要件が必要となります。 ノードに同じ製品およびバージョンのセットがない場合は、 そのノードを管理エージェントに登録できません。gotcha

コマンドは、統合されていないノード上でのみ実行できます。コマンドが統合ノード上で実行されると、コマンドはエラーで終了します。

registerNode コマンドを実行すると、ノード上で稼働中のすべてのアプリケーション・サーバーが停止します。オプションで、registerNode コマンドを実行する前に、登録する、ノード上のアプリケーション・サーバーを停止することができます。

遷移: 前に 7.0.0.11 以前のバージョンを使用しており、 一致していない製品またはバージョンがある管理対象ノードが管理エージェントに登録されている場合に、 バージョン 8.0 にマイグレーションすると、その管理エージェントは、 一致していない製品またはバージョンがある管理対象ノードのサブシステムを開始できません。 管理エージェントと同じ製品およびバージョンが含まれるように、これらのノードを更新して、 ノード上のサーバーを再始動してから管理エージェントを再始動すると、 管理エージェントでこれらの登録されたノードを再び管理できるようになります。

登録するアプリケーション・サーバーの管理コンソール・アプリケーションまたは管理 Enterprise JavaBeans (EJB) アプリケーションを使用可能にすると、ノード登録プロセスはそれらのアプリケーションを使用不可にします。

構文

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

registerNode [options]

パラメーター

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

-conntype<JSR160RMI|IPC|RMI|SOAP>
管理エージェントに接続してノードの登録を開始するために使用される、オプションのコネクター・タイプ。 デフォルトは SOAP です。
非推奨の機能 (Deprecated feature) 非推奨の機能 (Deprecated feature): 最終的には、RMI コネクターから JSR160RMI コネクターに切り替える必要があります。これは、RMI コネクターのサポートが推奨されないためです。depfeat
-host host_name
管理エージェントのホスト名を指定するオプション・パラメーター。
-name managed_node_name
管理エージェントに管理対象ノードが登録された後で、そのノードの名前を指定するオプション・パラメーター。
-nodepassword node_password
登録するノードのパスワードを指定するオプション・パラメーター。 このパラメーターは、セキュリティーがノードでオンになっており、そのパスワードが管理エージェントのパスワードと異なる場合に指定します。 このパラメーターは -nodeusername パラメーターとともに使用してください。 -nodeusername パラメーターと -nodepassword パラメーターは、ノード上のすべてのサーバーを停止するために使用されます。
-nodeusername node_user_name
登録するノードのユーザー名を指定するオプション・パラメーター。このパラメーターは、セキュリティーがノードでオンになっており、そのユーザー名が管理エージェントのユーザー名とは異なる場合に指定します。 このパラメーターは -nodepassword パラメーターとともに使用してください。 -nodeusername パラメーターと -nodepassword パラメーターは、ノード上のすべてのサーバーを停止するために使用されます。
-openConnectors connectors
管理エージェントが開くコネクターのリスト (各コネクターはコンマで区切られます) を指定するオプション・パラメーター。 デフォルトでは、すべてのコネクターが開かれます。
-port port_number
管理エージェントのコネクター・ポートのポート番号を指定するオプション・パラメーター。

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

注: このトピックでは、 1 つ以上のアプリケーション・サーバー・ログ・ファイルを参照します。推奨される代替案として、分散システムや IBM® i システムの SystemOut.logSystemErr.logtrace.logactivity.log ファイルではなく、High Performance Extensible Logging (HPEL) ログおよびトレース・インフラストラクチャーを使用するようにサーバーを構成できます。また HPEL は、ネイティブ z/OS® ロギング機能と連携させて使用することができます。HPEL を使用する場合、LogViewer コマンド・ライン・ツールを サーバー・プロファイルの bin ディレクトリーから使用して、すべてのログ・ファイルにアクセスし、 情報をトレースできます。HPEL の使用について詳しくは、HPEL を使用してのアプリケーションの トラブルシューティングに関する情報を参照してください。
-profilePath profile_path
登録するアプリケーション・サーバー・ノードのプロファイルへのパスを指定する必須パラメーター。
-trace
registerNode コマンドのトレース出力を指定するオプション・パラメーター。
-portsFile ports_file
新規に登録されたノードのポート設定値を定義するファイルへのパスを指定するオプション・パラメーター。

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

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

-profileName profile_name
管理エージェントのプロファイル名を指定するオプション・パラメーター。
-username username
管理エージェントにログオンするためのユーザー ID を指定するオプション・パラメーター。
-password password
管理エージェントにログオンするためのパスワードを指定するオプション・パラメーター。
-help
使用法ステートメントを表示するオプション・パラメーター。
-?
使用法ステートメントを表示するオプション・パラメーター。

使用法シナリオ

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

[z/OS]
registerNode.sh -conntype SOAP -port 8878
 -profilePath app_server_root/profiles/default
[AIX][HP-UX][Linux][Solaris]
registerNode.sh -conntype SOAP -port 8878 
 -profilePath app_server_root/profiles/AppSrv01
[Windows]
registerNode.bat -conntype SOAP -port 8878
 -profilePath app_server_root\profiles\AppSrv01
[IBM i]
registerNode -conntype SOAP -port 8878
 -profilePath user_data_root/profiles/AppSrv01

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=ragt_registerNode
ファイル名:ragt_registerNode.html