

apiconnect-collective-member wlpn-server コマンドおよび wlpn-collective コマンド
wlpn-server コマンドは、解凍済み Node.js アプリケーションを開始または停止する場合、およびアプリケーションを圧縮または解凍する場合に実行します。wlpn-collective コマンドは、Node.js アプリケーションを Liberty 集合のメンバーとして結合する場合、または Node.js 集合メンバーを集合から削除する場合に実行します。apiconnect-collective-member コマンドは、${wlpn.usr.dir} ディレクトリーから実行してください。デフォルトでは、このディレクトリーは /home/user_name/wlpn にあります。
wlpn-server コマンドを実行して解凍済み Node.js アプリケーションの開始および停止を行い、wlpn-collective コマンドを実行してそのアプリケーションを Node.js 集合メンバーにしますが、Node.js アプリケーションはサーバーではありません。これはアプリケーションです。 ただし、Node.js アプリケーションを集合コントローラーによって認識される wlpn ユーザー・ディレクトリーに解凍すると、コントローラーはそのアプリケーションを集合メンバー・サーバーとして管理することができます。この資料では、Node.js 集合メンバーを Node.js サーバー と呼ぶことがあります。
wlpn-server コマンドの構文
wlpn-server コマンドのコマンド構文は以下のとおりです。
wlpn-server action variable | variable
- help
- wlpn-server コマンドに関する情報を表示します。
wlpn-server help
- start
- 解凍済み Node.js アプリケーションを開始します。server_name には、コマンドで開始する解凍済み Node.js アプリケーションの名前を指定します。
wlpn-server start server_name
コマンドは、サーバー・プロセスを開始し、PID ファイルをサーバー・ディレクトリーに書き込みます。このディレクトリーは、デフォルトでは /home/user_name/wlpn/server_name です。
- stop
- 解凍済み Node.js アプリケーションを停止します。server_name には、コマンドで停止する解凍済み Node.js アプリケーションの名前を指定します。
wlpn-server stop server_name
コマンドは、サーバー・プロセスを停止し、サーバー・ディレクトリーから PID ファイルを削除します。
- pack
- ファイル・システムにアプリケーションをデプロイメントするために、.tgz 拡張子を付けて圧縮した TAR アーカイブを作成します。圧縮するディレクトリーをコマンドに指定してください。
wlpn-server pack directory_to_pack
コマンドは、指定されたディレクトリーを圧縮し、現行ディレクトリー内に .tgz ファイルを作成します。
以下の手順は、ディレクトリーを準備して圧縮する方法を説明しています。
- Node.jsアプリケーションを作成します。
- 必要に応じて、server.json ファイルを作成し、それを package.json ファイルと同じディレクトリーに置きます。server.json ファイルの内容は、以下の例のようになります。
{ "clusterName": "cluster name", "contextRoot": "context root", "appPort":"integer", "adminPort":"integer" }
- cluster name は、デフォルトでは server name です。
- context root はオプションで、デフォルトでは server name です。
- appPort では、integer はアプリケーション・トラフィックのポートで、デフォルトでは 9080 です。
- adminPort では、integer は管理トラフィックのポートで、デフォルトでは 9443 です。
- 依存関係を組み込むには、アプリケーション・ディレクトリー内で npm install コマンドを実行します。
- ディレクトリーを圧縮するには、wlpn-server pack コマンドを実行します。
- unpack
- アプリケーションをディスクに解凍して、サーバー・ディレクトリーを作成します。作成するサーバーの名前、および解凍する TARファイルの名前をコマンドに指定してください。
wlpn-server unpack server_name tgz_file_name
コマンドは、.tgz ファイルを ${wlpn.usr.dir}/server_name に解凍します。デフォルトでは、これは /home/user_name/wlpn ディレクトリーです。wlpn ディレクトリーが存在しない場合、このコマンドで wlpn ディレクトリーが作成されます。
使用法
以下は、正しい構文の例です。
wlpn-server help
wlpn-server start myServer
wlpn-server stop myServer
wlpn-server pack example-app
wlpn-server unpack myServer example-app.tgz
wlpn-collective コマンドの構文
wlpn-collective コマンドのコマンド構文は以下のとおりです。
wlpn-collective action server_name [options]
- help
- wlpn-collective コマンドに関する情報を表示します。
wlpn-collective help
- join
- Node.js アプリケーションをメンバーとして結合し、Liberty 集合に解凍します。解凍済み Node.js アプリケーションの名前、集合コントローラー・ホスト、ポート、ユーザー、パスワード、および鍵ストア・パスワードをコマンドに指定してください。
wlpn-collective join server_name --host=collectiveControllerHost --port=collectiveControllerHTTPSPort --user=collectiveControllerAdminUserID --password=collectiveControllerAdminUserPassword --keystorePassword=generatedKeystorePassword
また、必要に応じて以下のオプション・パラメーターを 1 つ以上指定します。- --autoAcceptCertificates
- すべての SSL 証明書を自動的に信頼します。
- --sshPrivateKey
- wlpn-collective
join コマンドは、指定したホスト・コンピューターの SSH サーバーに対する認証用に、固有の SSH 鍵ペアを生成します。SSH 鍵ペアが既に生成されているリモート・ホストを登録する場合は、SSH 秘密鍵ファイルのパスを指定できます。
以下のコマンドでは、SSH 秘密鍵がローカル・コントローラー・コンピューター上の /home/user1/.ssh/id_rsa に保管されることを想定しています。SSH 鍵ペアのもう一方のファイルは、リモート・ターゲット・ホスト上の /home/user1/.ssh/authorized_keys の公開鍵ファイルです。
wlpn-collective join myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --sshPrivateKey=/home/user1/.ssh/id_rsa
- --genDeployVariables
- 解凍された Node.js アプリケーションをメンバーとして Liberty 集合に結合する際のデプロイメント変数 (ポート) を割り振ります。genDeployVariables オプションは、デプロイメント変数を集合リポジトリーに登録し、デプロイメント変数をメンバーに生成します。コントローラーの server.xml ファイルでデプロイメント変数を定義する deployVariable ステートメントの例については、デプロイメント REST API を使用した Node.js サーバーのデプロイのステップ 3 を参照してください。
このコマンドは、Node.js アプリケーションを集合に結合し、コマンドの実行元のファイル・システムに SSL 構成ファイルを作成します。コマンドは、このファイル・システムの ${wlpn.usr.dir}/server_name ディレクトリー内に join.json ファイルも作成します。この join.json ファイルは server.json とは別個のもので、集合用に使用されます。join.json ファイルには、コントローラーのホスト名、ポート番号、およびハートビート間隔が含まれています。
- remove
- Node.js 集合メンバー・サーバーを Liberty 集合から削除します。Node.js サーバーの名前、集合コントローラー・ホスト、ポート、ユーザー、パスワード、および --autoAcceptCertificates パラメーターをコマンドに指定してください。
wlpn-collective remove server_name --host=collectiveControllerHost --port=collectiveControllerHTTPSPort --user=collectiveControllerAdminUserID --password=collectiveControllerAdminUserPassword --autoAcceptCertificates
このコマンドは、Node.js サーバーを集合から削除し、SSL 構成ファイルおよび join.json ファイルを削除します。
- registerHost
- Node.js サーバーのインストール先となるホストを集合コントローラーに登録します。ターゲット・ホストの名前、集合コントローラー・ホスト、ポート、ユーザー、パスワード、および --autoAcceptCertificates パラメーターをコマンドに指定してください。
wlpn-collective registerHost targetHost --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --rpcUser=osUser --rpcPassword=osUserPassword --autoAcceptCertificates
このコマンドにより、集合コントローラーはホスト上のファイル、コマンド、その他のリソースにアクセスできるようになります。
- updateHost
- Node.js サーバーが常駐するホストのホスト登録パラメーター値を変更します。ターゲット・ホストの名前、集合コントローラー・ホスト、ポート、ユーザー、パスワード、および --autoAcceptCertificates パラメーターをコマンドに指定してください。
wlpn-collective updateHost targetHost --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --rpcUser=osUser --rpcPassword=osUserPassword --autoAcceptCertificates
このコマンドによりホスト登録が更新されます。
使用法
以下は、正しい構文の例です。
wlpn-collective help
wlpn-collective join myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --autoAcceptCertificates
wlpn-collective remove myServer --host=controllerHost --port=controllerHTTPSPort --user=controllerAdmin --password=controllerAdminPassword --autoAcceptCertificates