查看 Apigee Edge 說明文件。
前往
Apigee X說明文件。 資訊
問題
Edge Router 是使用 NGINX 實作。在 Edge 升級程序中或
變更路由器的設定時，您可能會看到 NGINX 設定錯誤。如果這些情況
錯誤時，Edge 會標記所有造成問題的 NGINX 設定檔
/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
錯誤訊息
您不會看到任何錯誤訊息。但您可能無法順利執行 API Proxy 伺服器。
可能原因
NGINX 設定檔通常會標示為錯誤，因為
/opt/apigee/customer/application/router.properties 檔案中的 NGINX 屬性
虛擬主機的變動或不正確之處
診斷
- 移除 .bad 後置字串的
/opt/nginx/conf.d目錄，因此結尾是 .conf。
- 執行 NGINX configtest 工具，來判斷失敗的原因：
/opt/nginx/scripts/apigee-nginx configtest
解析度
- 如果設定測試找出了錯誤設定檔的原因，請採取以下步驟修正問題：
對標記中的特定屬性進行適當變更
/opt/apigee/customer/application/router.properties檔案或虛擬主機。
- 移除
/opt/nginx/conf.d目錄：rm -rf /opt/nginx/conf.d
- 重新啟動路由器：
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- 這樣一來，您應該不會再在
/opt/nginx/conf.d目錄。
如果問題仍未解決，請與 Apigee Edge 支援團隊聯絡。
以下範例說明如何根據 然後檢查 NGINX 設定測試
示例 1：NGINX 屬性設定的值不正確
- 假設您已更新屬性「proxy_busy_buffers_size」
/opt/apigee/customer/application/router.properties檔案的大小變成 128K，如上所示 如下：conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=128k
導致 /opt/apigee/nginx/conf.d 中的設定檔標示為錯誤
目錄。
- 請執行 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 nginx: configuration file /opt/nginx/conf/nginx.conf test failed
configtest 結果表示該屬性的值 proxy_busy_buffers_size 必須大於或等於 proxy_buffer_size，但設定的值似乎不正確。
- 請檢查針對屬性的值設定的值
proxy_buffer_size 和 proxy_healthy_buffers_size
在
0-default.conf檔案中：proxy_buffer_size 512k; proxy_busy_buffers_size 128k;
- 將
/opt/apigee/customer/application/router.properties檔案：conf_load_balancing_load.balancing.driver.proxy.busy.buffer.size=512k
- 移除
/opt/nginx/conf.d資料夾：rm -rf /opt/nginx/conf.d
- 重新啟動路由器：
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
這項問題已修正，並移除了錯誤的設定檔。
示例 2：升級 NGINX (僅限 Private Cloud 18.01) 的程序失敗
假設您執行 configtest 並取得以下回應：
/apigee-nginx configtest nginx: the configuration file /opt/nginx/conf/nginx.conf syntax is ok nginx: [emerg] zero size shared memory zone "perclient" nginx: configuration file /opt/nginx/conf/nginx.conf test failed
發生這個錯誤，表示程序無法將 NGINX 從 1.10.x 升級至 1.12.x。 將 Edge Private Cloud 升級至 18.01 版時發生已知錯誤。
如要正確診斷這個問題 (僅適用於 Private Cloud 18.01)，請按照下列步驟操作：
rpm -aq | grep apigee-nginx
這個指令應會傳回已安裝的 rpm 版本 1.12.x。如果沒有，請按照下列步驟操作：
- 停止邊緣路由器元件。
- 備份邊緣路由器元件。
- 執行下列指令，升級至 apigee-nginx 1.2.x：
- 刪除「
/opt/apigee/nginx/conf.d.」下的全部*.bad個檔案 - 重新啟動邊緣路由器元件。
sudo yum update apigee-nginx