Edge Router のトラブルシューティング

Edge for Private Cloud v4.17.09

Edge Router は Nginx ルーターを使用して実装されます。Edge のアップグレード プロセスや Router の構成の変更中に、Nginx の構成エラーが発生することがあります。これらのエラーが発生すると、問題の原因となった Nginx 構成ファイルが /opt/nginx/conf.d に書き込まれます。その後、Nginx の configtest ツールを使用してエラーの原因を特定できます。

たとえば、/opt/nginx/conf.d を調べると、次のファイルが表示されます。

-rw-r--r-- 1 apigee apigee 522 Jul 20 08:41 0-default.conf.bad 
-rw-r--r-- 1 apigee apigee 577 Jul 20 08:42 0-fallback.conf
-rw-r--r-- 1 apigee apigee 1062 Jul 20 08:18 0-map.conf
-rw-r--r-- 1 apigee apigee 1887 Jul 20 08:42 custorg_test_default.conf.bad

複数のファイルの接尾辞が .bad である点に注意してください。

通常、これらのエラーは /opt/apigee/customer/application/router.properties ファイルを誤って変更したか、仮想ホストに変更を加えたことが原因で発生します。たとえば、以下を追加しました。

conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=32k

この値は使用できません。

このエラーを解決するには:

  1. /opt/nginx/conf.d フォルダ内のファイル名から .bad サフィックスを削除し、末尾が .conf になるようにします。
  2. Nginx の configtest ツールを実行して、失敗の理由を表示します。
    /opt/nginx/scripts/apigee-nginx configtest

    出力は次の形式で表示されます。

    nginx: [emerg]
      "proxy_busy_buffers_size" must be equal to or greater than the maximum of the value of
      "proxy_buffer_size" and one of the "proxy_buffers" in /opt/nginx/conf/nginx.conf:47
  3. /opt/apigee/customer/application/router.properties を編集して、conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size を 128k に設定します。
  4. /opt/nginx/conf.d ディレクトリを削除しました。
    rm -rf /opt/nginx/conf.d
  5. Router を再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
  6. /opt/nginx/conf.d フォルダに不正な構成ファイルが表示されなくなりました。