ไฟล์การกำหนดค่าไม่ถูกต้อง

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่เอกสารประกอบของ Apigee X ข้อมูล

ลักษณะปัญหา

ใช้งานเราเตอร์ Edge โดยใช้ 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 ได้เนื่องจากไฟล์การกำหนดค่าไม่ถูกต้อง

สาเหตุที่เป็นไปได้

โดยปกติแล้ว ไฟล์การกำหนดค่า NGINX จะได้รับการทำเครื่องหมายว่าไม่ถูกต้องเนื่องจากมีการกำหนดค่าที่ไม่ถูกต้องเป็นพร็อพเพอร์ตี้ NGINX ในไฟล์ /opt/apigee/customer/application/router.properties หรือมีการเปลี่ยนแปลงโฮสต์เสมือนที่ไม่ถูกต้อง

การวินิจฉัย

1. นำคำต่อท้าย .bad ออกจากชื่อไฟล์ในไดเรกทอรี /opt/nginx/conf.d เพื่อให้ลงท้ายด้วย .conf

2. เรียกใช้เครื่องมือกำหนดค่า NGINX เพื่อหาสาเหตุของความล้มเหลวดังนี้

   /opt/nginx/scripts/apigee-nginx configtest
   

ความละเอียด

1. หากการทดสอบการกำหนดค่าระบุสาเหตุของไฟล์การกำหนดค่าที่ไม่ถูกต้อง ให้แก้ไขปัญหาโดยทำการเปลี่ยนแปลงที่เหมาะสมกับพร็อพเพอร์ตี้ที่ต้องการในไฟล์ /opt/apigee/customer/application/router.properties หรือโฮสต์เสมือน

2. นำไดเรกทอรี /opt/nginx/conf.d ออก:

   rm -rf /opt/nginx/conf.d
   

3. รีสตาร์ทเราเตอร์โดยทำดังนี้

   /opt/apigee/apigee-service/bin/apigee-service edge-router restart
   

4. คุณจะไม่เห็นไฟล์การกำหนดค่าที่ไม่ถูกต้องในไดเรกทอรี /opt/nginx/conf.d อีกต่อไป

หากปัญหายังคงอยู่ โปรดติดต่อทีมสนับสนุนของ Apigee Edge

นี่คือตัวอย่างที่แสดงวิธีแก้ไขปัญหาโดยอิงตามข้อมูลที่ได้จากการทดสอบการกำหนดค่า NGINX

ตัวอย่างที่ 1: ชุดค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ NGINX

1. สมมติว่าคุณอัปเดตพร็อพเพอร์ตี้ "proxy_busy_buffers_size" เป็น 128K ในไฟล์ /opt/apigee/customer/application/router.properties ดังที่แสดงด้านล่าง

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

ซึ่งทำให้ระบบทำเครื่องหมายไฟล์การกำหนดค่าว่าไม่ถูกต้องในไดเรกทอรี /opt/apigee/nginx/conf.d

2. เรียกใช้คำสั่ง configtest ของ NGINX เพื่อหาสาเหตุของความล้มเหลว:

   /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_busy_buffers_size แต่ดูเหมือนว่าตั้งค่าไว้ไม่ถูกต้อง

3. ตรวจสอบค่าที่ตั้งไว้สำหรับพร็อพเพอร์ตี้ proxy_buffer_size และ proxy_notification_buffers_size ในไฟล์ 0-default.conf:

   proxy_buffer_size 512k;
   proxy_busy_buffers_size 128k;
   

4. อัปเดตค่าของพร็อกซี_ไม่ว่าง_buffers_size เป็น 512K ในไฟล์ /opt/apigee/customer/application/router.properties:

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

5. นำโฟลเดอร์ /opt/nginx/conf.d ออก:

   rm -rf /opt/nginx/conf.d
   

6. รีสตาร์ทเราเตอร์โดยทำดังนี้

   /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 หากแก้ปัญหาไม่ได้ ให้ทำตามขั้นตอนต่อไปนี้

1. หยุดคอมโพเนนต์ Edge- Router
2. สำรองข้อมูลคอมโพเนนต์ EDGE-Router
3. เรียกใช้คำสั่งนี้เพื่ออัปเกรดเป็น apigee-nginx 1.2.x:

sudo yum update apigee-nginx

4. ลบทั้ง *.bad ไฟล์ภายใต้ /opt/apigee/nginx/conf.d.
5. รีสตาร์ทคอมโพเนนต์ Edge-Router