4.19.01 Edge สำหรับบันทึกประจำรุ่นของ Private Cloud

รูปแบบไฟล์ข้อมูลเมตาสำหรับการติดตั้ง apigee-sso

เมื่อติดตั้ง apigee-sso และใช้ไฟล์Metadata.xml แทน URL หากไฟล์ metadata.xml ไม่ได้มีบรรทัดใหม่ (CRLF) ที่ท้ายไฟล์ จะไม่ได้อ่านไฟล์ metadata.xml ทั้งหมด

วิธีแก้ปัญหาเฉพาะหน้า

หากต้องการหลีกเลี่ยงปัญหานี้ คุณสามารถดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้

• เพิ่ม CRLF ต่อท้ายไฟล์ metadata.xml

  หรือ

• ใช้ตำแหน่งตาม URL สำหรับข้อมูลเมตา

ไม่รองรับ apigee-monit ใน Amazon Linux 1

วิธีแก้ปัญหาเฉพาะหน้า

การสำรองข้อมูลตัวประมวลผลข้อความไม่สำรองชุดไฟล์ที่ถูกต้อง

วิธีแก้ปัญหาเฉพาะหน้า

ดำเนินการสำรองข้อมูลเป็นครั้งที่ 2 จากนั้นระบบจะสำรองชุดไฟล์ที่ถูกต้อง

โทเค็นของเซสชันไม่ถูกทำให้ใช้งานไม่ได้

โทเค็นเซสชันจะไม่ใช้งานไม่ได้ในเซิร์ฟเวอร์เมื่อผู้ใช้คลิกปุ่มออกจากระบบ Apigee Edge

วิธีแก้ปัญหาเฉพาะหน้า

การดําเนินการ Cassandra จะไม่ทํางานเมื่อเปิดใช้การตรวจสอบสิทธิ์ JMX

วิธีแก้ปัญหาเฉพาะหน้า

คำขอ HEAD รายการที่ส่งไปยังเป้าหมาย Node.js ค้าง

คำขอ HEAD ที่ส่งไปยังเป้าหมาย Node.js อาจค้างอยู่ ซึ่งทำให้การเชื่อมต่อรอดำเนินการอยู่

วิธีแก้ปัญหาเฉพาะหน้า

หากต้องการแก้ปัญหานี้ ให้กำหนดเครื่องจัดการสำหรับคำขอ HEAD เพื่อส่งคืนการตอบกลับที่ว่างเปล่าอย่างชัดเจน

ชื่อโฮสต์ไม่ได้รับการแก้ไข

หลังจากติดตั้งหรืออัปเกรด Edge สำหรับ Private Cloud แล้ว ชื่อโฮสต์อาจแก้ไขเป็นที่อยู่ไม่ได้

วิธีแก้ปัญหาเฉพาะหน้า

หากต้องการแก้ไขปัญหานี้ ให้รีสตาร์ทคอมโพเนนต์ Edge UI โดยทำดังนี้

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

DataAccessException ในการกำหนดค่าศูนย์ข้อมูลหลายรายการ

ในการกำหนดค่าศูนย์ข้อมูลหลายรายการ หากพื้นที่เก็บข้อมูลเดียวไม่พร้อมใช้งาน คุณอาจเห็นข้อผิดพลาดต่อไปนี้

DataAccessException: Error while accessing datastore;
Please retry later

ผลที่ได้คือเซิร์ฟเวอร์การจัดการอาจไม่เริ่มทำงานเนื่องจากพยายามเชื่อมต่อกับโหนด Cassandra ทั้งใน dc-1 และ dc-2 DataAccessExceptions จะเกิดขึ้นหากโหนด Cassandra หยุดทำงาน การดำเนินการนี้อาจส่งผลให้การรับส่งข้อมูล API หยุดชะงัก เนื่องจาก Message Processor รายงานว่า DataAccessExceptions ขณะพยายามเรียกข้อมูล KVM

โปรดทราบว่าสถานะที่คาดไว้คือเซิร์ฟเวอร์การจัดการไม่เชื่อมต่อกับคอมโพเนนต์พื้นที่เก็บข้อมูลในภูมิภาคต่างๆ

วิธีแก้ปัญหา

วิธีแก้ปัญหาคือการยกเลิกการลงทะเบียนประเภทโหนด Cassandra ต่อไปนี้ในศูนย์ข้อมูลที่ไม่พร้อมใช้งาน แล้วลงทะเบียนอีกครั้งหลังจากที่โหนด Cassandra พร้อมใช้งานอีกครั้ง

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

วิธียกเลิกการลงทะเบียนและลงทะเบียนประเภทโหนด Cassandra เหล่านี้อีกครั้ง

1. รับ UUID ของโหนด Cassandra โดยใช้คำสั่ง curl ต่อไปนี้

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   โดยที่

   • ADMIN_EMAIL และ ADMIN_PW คือข้อมูลเข้าสู่ระบบของบัญชี Apigee
   • MS_IP และ MS_PORT คือที่อยู่ IP และหมายเลขพอร์ตของเซิร์ฟเวอร์การจัดการ
   • REGION คือชื่อของศูนย์ข้อมูลที่มีเซิร์ฟเวอร์การจัดการ
   • GATEWAY_POD คือชื่อพ็อด ซึ่งโดยค่าเริ่มต้นคือ "เกตเวย์" แต่อาจเปลี่ยนชื่อใหม่เป็นชื่ออื่น ดังนั้นโปรดตรวจสอบการติดตั้งใช้งาน
   • CASSANDRA_NODE_TYPE เป็นหนึ่งใน kms-datastore, dc-datastore และ keyvaluemap-datastore

   ตัวอย่างเช่น

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   การตอบกลับใช้รูปแบบต่อไปนี้

   {
     "internalIP" : "POD_IP_ADDRESS",
     "isUp" : [true|false],
     "pod" : "GATEWAY_POD",
     "reachable" : [true|false],
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
       "uUID" : "POD_UUID"
   }

   ตัวอย่างเช่น

   {
     "internalIP" : "192.168.1.11",
     "isUp" : false,
     "pod" : "gateway",
     "reachable" : false,
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : "dc-datastore",
     "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
   }

   จดค่าของช่อง uUID ในคำตอบ ซึ่งคุณจะต้องใช้เหล่านี้เพื่อยกเลิกการลงทะเบียนโหนด

2. ทำซ้ำขั้นตอนที่ 1 สำหรับประเภทโหนด Cassandra แต่ละประเภท: kms-datastore, dc-datastore และ keyvaluemap-datastore อย่าลืมจด UUID ที่ส่งกลับมา
3. ยกเลิกการลงทะเบียนโหนดโดยใช้คำสั่งต่อไปนี้

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   โดย UUID คือ UUID ที่แสดงผลในการตอบสนองของคำสั่งก่อนหน้า

4. ทำขั้นตอนที่ 3 ซ้ำสำหรับ UUID แต่ละรายการที่คุณรวบรวมในขั้นตอนที่ 1 และ 2
5. ลงทะเบียนโหนดอีกครั้งโดยใช้คำสั่งต่อไปนี้

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
     "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
     Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
     region=REGION&pod=GATEWAY_POD" -H \
     'content-type: application/x-www-form-urlencoded' -X POST

โปรดทราบว่าการดำเนินการเหล่านี้จะลงทะเบียนและยกเลิกการลงทะเบียนโหนดจาก Zookeeper และจะไม่ส่งผลกระทบต่อคลัสเตอร์ Cassandra ดูข้อมูลเพิ่มเติมเกี่ยวกับคำสั่งเหล่านี้ได้ที่อัปเดตการลงทะเบียนพื้นที่เก็บข้อมูล

นโยบาย MessageLในเร็วๆ นี้รวมถึงข้อมูลเพิ่มเติมในข้อความบันทึก

องค์ประกอบ FormatMessage ของนโยบาย MessageLoking จะควบคุมรูปแบบของข้อความที่บันทึก เมื่อ FormatMessage=false ข้อความที่บันทึกไม่ควรมีข้อมูลที่ Apigee สร้างขึ้น อย่างไรก็ตาม แม้ว่าคุณจะตั้งค่า FormatMessage=false แล้ว ข้อความในบันทึกจะยังคงมีข้อมูลต่อไปนี้

• คะแนนลำดับความสำคัญ
• การประทับเวลา

วิธีแก้ปัญหาเฉพาะหน้า

รีเซ็ตรหัสผ่านของผู้ดูแลระบบไม่สำเร็จ

การรีเซ็ตรหัสผ่านของผู้ดูแลระบบสำหรับเซิร์ฟเวอร์การจัดการที่มีสัญลักษณ์พิเศษจะล้มเหลว

วิธีแก้ปัญหาเฉพาะหน้า

กำหนดรหัสผ่านในไฟล์ข้อมูลที่จะส่งต่อไปไปยังปลายทาง /users ใน Management API โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการรีเซ็ตรหัสผ่านของผู้ดูแลระบบ