オンプレミス・アプリケーション用のスタンドアロン Node.js データ・コレクターの構成

Node.js アプリケーションをオンプレミス環境にインストールした場合は、Node.js アプリケーションに関する情報を収集するように Node.js データ・コレクターを構成する必要があります。

1. データ・コレクター・パッケージからファイルを抽出します。nodejs_datacollector_8.1.4.0.6.tgz パッケージは、解凍されたディレクトリーに含まれています。
2. アプリケーションのホーム・ディレクトリーを判別します。
   • 標準的な Node.js アプリケーションでは、node app.js コマンドを使用して Node.js アプリケーションを開始し、app.js メインファイルが /root/nodejs_app ディレクトリーにある場合、/root/nodejs_app がアプリケーションのホーム・ディレクトリーです。
   • IBM API Connect 環境内の集合メンバーの場合、wlpn-server list コマンドを実行して、同じマシン上のすべての集合メンバーのリストを表示します。集合メンバーのホーム・ディレクトリーは、以下の形式です。

     user_directory/collective-member_name/package

     例えば、コマンド出力として /root/wlpn/rock-8345a96-148538-1/package が得られた場合、/root/wlpn はユーザー・ディレクトリーであり、rock-8345a96-148538-1 は集合メンバー名です。
   • IBM API Connect 環境内の Developer Portal アプリケーションの場合、ps -ef | grep node コマンドを実行して、ホーム・ディレクトリーを確認できます。例えば、以下のコマンド出力が得られた場合、ホーム・ディレクトリーは /home/admin/bgsync であり、アプリケーションのメインファイルは rest_server.js です。

     admin 19085 1 0 Jun25 ?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js

3. アプリケーションのホーム・ディレクトリーから、以下のコマンドを実行して、データ・コレクター・パッケージからファイルを解凍します。

   tar -zxf nodejs_datacollector_8.1.4.0.6.tgz

4. 以下のコマンドを実行して、nodejs_dc フォルダー内の ibmapm.tgz ファイルを解凍します。

   tar -zxf nodejs_dc/ibmapm.tgz

   ibmapm フォルダーが作成されます。
5. 以下のコマンドを実行して、アプリケーションのデータ・コレクターをインストールします。

   npm install ./ibmapm

6. 以下の行を、Node.js アプリケーションのメインファイルの先頭に追加します。

   require('ibmapm');

   • node app.js コマンドを実行してアプリケーションを開始する場合は、app.js がアプリケーションのメインファイルです。
   • IBM API Connect 環境内の集合メンバーの場合、メインファイルは、ホーム・ディレクトリーまたはそのサブフォルダー内の package.json ファイルで定義されます。デフォルトでは、メインファイルは、home_directory/server/server.js です。ここで、home_directory は、集合メンバーのホーム・ディレクトリーです。
   • IBM API Connect 環境内の Developer Portal アプリケーションの場合、ps -ef | grep node コマンドを実行して、メインファイルを確認できます。例えば、以下のコマンド出力が得られた場合、アプリケーションのメインファイルは rest_server.js です。

     admin 19085 1 0 Jun25 ?  00:06:53 /usr/local/bin/node /home/admin/bgsync/rest_server.js

7. アプリケーションを再始動します。
   ヒント:

   • 集合メンバーを再始動するには、wlpn-server stop collective_member_name コマンドを実行します。このコマンドを実行すると、集合メンバーは自動的に再始動します。始動しない場合は、wlpn-server start collective_member_name コマンドを実行して手動で再始動します。
   • Developer Portal アプリケーションを再始動するには、まず /etc/init.d/restservice stop コマンドを実行してアプリケーションを停止してから、/etc/init.d/restservice start コマンドを実行してアプリケーションを開始します。