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

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

ส่วนนี้อธิบาย Edge เวอร์ชัน 4.19.06 สำหรับการเผยแพร่ฟีเจอร์ Private Cloud

ข้อมูลสรุปของรุ่น

ตารางต่อไปนี้สรุปการเปลี่ยนแปลงในรุ่นนี้

ฟีเจอร์ใหม่

รุ่นนี้มีฟีเจอร์ใหม่ต่อไปนี้

○ การสนับสนุน LDAP สำหรับ SSO
○ การสนับสนุนการทำให้ HTTP ใช้งานได้
○ Pluggable analytics
○ Cassandra rack
○ IPv6 รองรับ
○ Unified New Edge
○ ยกเว้นธุรกรรม INVALID_TSC รายการ (การสร้างรายได้)

ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์ใหม่เหล่านี้แต่ละรายการได้ที่ฟีเจอร์ใหม่

ความเข้ากันได้แบบย้อนหลัง

ปัญหาต่อไปนี้ที่ส่งผลกระทบต่อความเข้ากันได้แบบย้อนหลังได้เกิดขึ้นใน Apigee Edge สำหรับ Private Cloud เวอร์ชันนี้

     
  • เนื่องจากการแก้ปัญหา 132443137 (ตามที่อธิบายไว้ในบันทึกประจำรุ่นของ Public Cloud 19.03.01) ผู้ประมวลผลข้อความจะไม่สนใจส่วนหัวที่ขึ้นต้นด้วย X-Apigee-* คุณจึงต้องเปลี่ยนโครงสร้างภายในโค้ดที่ใช้ส่วนหัว X-Apigee-* และแทนที่ส่วนหัวเหล่านั้นด้วยส่วนหัวที่รองรับ

  • เปลี่ยนชื่อไฟล์บันทึก Cassandra การสนทนาตอนนี้คือ

    /opt/apigee/var/log/apigee-cassandra/system.log
การเผยแพร่ที่รวมอยู่ด้วย

เนื่องจาก Edge for Private Cloud Feature Release รุ่นก่อนหน้า รุ่นต่อไปนี้จึงได้เกิดขึ้นและรวมอยู่ในรุ่นนี้

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
19.01.1418.12.0418.08.3118.07.31
○ พอร์ทัล
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.01.16
การเกษียณอายุ ไม่มี
การเลิกใช้งาน

โดยในรุ่น 4.19.06 เราจะเลิกใช้งานรายการต่อไปนี้

  • 4.18.01: เราเลิกใช้งาน Apigee Edge สำหรับ Private Cloud เวอร์ชัน 4.18.01 แล้ว

ดูข้อมูลเพิ่มเติมได้ที่การเลิกใช้งาน การเลิกใช้ การเลิกใช้ และการเปลี่ยนแปลง CPS ของ Apigee

แก้ไขข้อบกพร่อง

รุ่นนี้มีการแก้ไขข้อบกพร่องดังต่อไปนี้

○ UseStringDeduplication not set (140270474)
1 ข้อผิดพลาด MP1 ใน Google Analytics (140270474) (140270474) (140270474)









HEAD

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการแก้ไขแต่ละวิธีได้ที่การแก้ไขข้อบกพร่อง

ปัญหาที่ทราบ

รุ่นนี้มีปัญหาที่ทราบดังต่อไปนี้

1 7 ไม่ให้คะแนนธุรกรรมในเบื้องต้น (141628497)
○ 1 การรั่วไหลของหน่วยความจำเซิร์ฟเวอร์การให้คะแนน Mint (137865184)
○ รูปแบบไฟล์ข้อมูลเมตาสำหรับการติดตั้ง Apigee-sso (135616498) (135616498)
apigee-monit ไม่รองรับการสำรองข้อมูลเพิ่มเติมของ Amazon Linux 1 (1223700)



ดูข้อมูลเพิ่มเติมเกี่ยวกับปัญหาที่ทราบแต่ละรายการเหล่านี้ รวมถึงวิธีแก้ปัญหาเฉพาะหน้าได้ที่ปัญหาที่ทราบ

เส้นทางการอัปเกรด

ตารางต่อไปนี้แสดงเส้นทางการอัปเกรดสำหรับรุ่นนี้

From 4.19.01 อัปเกรดจากเวอร์ชัน 4.19.01 → 4.19.06 โดยตรง
ตั้งแต่ 4.18.05 อัปเกรดจากเวอร์ชัน 4.18.05 → 4.19.06 โดยตรง
ตั้งแต่ 4 มีนาคม 2018 อัปเกรดจากเวอร์ชัน 4.18.01 → 4.19.06 โดยตรง

ฟีเจอร์ใหม่

ส่วนนี้จะแสดงฟีเจอร์ใหม่ในรุ่นนี้ นอกจากนี้ รุ่นนี้จะมีฟีเจอร์ทั้งหมดใน Edge UI, การจัดการ Edge และรุ่นพอร์ทัลแสดงอยู่ในรุ่นที่รวม

นอกเหนือจากการเพิ่มประสิทธิภาพต่อไปนี้แล้ว รุ่นนี้ยังมีการเพิ่มประสิทธิภาพด้านความสามารถในการใช้งาน ประสิทธิภาพ ความปลอดภัย และความเสถียรอีกมากมาย

การสนับสนุนการทำให้ HTTP ใช้งานได้

Edge จะใช้ RPC เพื่อทำให้พร็อกซี API ใช้งานได้โดยค่าเริ่มต้น แม้ว่าโหมดนี้จะใช้งานได้ดีสำหรับการติดตั้งส่วนใหญ่ แต่โทโพโลยีขนาดใหญ่ที่มี MP จำนวนมากอาจพบปัญหาระยะหมดเวลาเมื่อมีการเรียกใช้พร้อมกันจำนวนมากผ่าน RPC

ด้วยเหตุนี้ Apigee จึงขอแนะนำให้ติดตั้งใช้งาน HTTP แทน RPC ในการทำให้ใช้งานได้ ระบบรองรับการเปิดใช้การทำให้ HTTP ใช้งานได้แล้วในตอนนี้

ดูข้อมูลเพิ่มเติมได้ที่เปิดใช้การทำให้ HTTP ใช้งานได้

การรองรับชั้นวางของ Cassandra

ตอนนี้ Apigee ได้ให้คำแนะนำทั่วไปสำหรับการปรับขนาดการดำเนินการของ Cassandra โดยทำให้ Cassandra บน Apigee Edge สำหรับแร็คของ Private Cloud เท่านั้น

ดูข้อมูลเพิ่มเติมได้ที่การรองรับชั้นวางของ Cassandra

ข้อมูลวิเคราะห์ที่เสียบปลั๊กได้

โดยค่าเริ่มต้น ระบบจะอัปโหลดข้อมูลการวิเคราะห์ที่ผู้ประมวลผลข้อความรวบรวมไว้ไปยัง Qpid และ Postgres เพื่อประมวลผล จากนั้นคุณจะดูข้อมูลการวิเคราะห์ได้ใน Edge UI

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

ดูข้อมูลเพิ่มเติมได้ที่การเขียนข้อมูลวิเคราะห์ลงในไฟล์

การติดตั้งประสบการณ์ New Edge อย่างง่าย

การติดตั้งประสบการณ์ New Edge ลดความซับซ้อนด้วยสคริปต์ใหม่

โปรดดูข้อมูลเพิ่มเติมที่ติดตั้งประสบการณ์ Edge ใหม่

การสนับสนุน LDAP IDP

การตรวจสอบสิทธิ์ผู้ใช้ด้วยการเรียก Edge UI และ Edge Management API จะรองรับ LDAP เพิ่มเติมจาก SAML แล้ว การรองรับ LDAP มีทั้งวิธีการเชื่อมโยงโดยตรงและการเชื่อมโยงโดยอ้อม

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของการตรวจสอบสิทธิ์ IdP ภายนอก

รองรับ IPv6

โดยค่าเริ่มต้น การเรียก API รันไทม์ทั้งหมดไปยัง Apigee Edge สำหรับ Private Cloud จะใช้ IPv4 คุณเพิ่มการรองรับ IPv6 ให้กับเราเตอร์ได้ด้วยพร็อพเพอร์ตี้ใหม่

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ใช้ IPv6 บนเราเตอร์

ไม่รวมธุรกรรม INVALID_TSC รายการ (การสร้างรายได้)

ตอนนี้คุณยกเว้นไม่ให้เพิ่มธุรกรรม INVALID_TSC รายการลงในฐานข้อมูล Postgres ได้แล้วเมื่อใช้การสร้างรายได้

ดูข้อมูลเพิ่มเติมได้ที่พร็อพเพอร์ตี้เซิร์ฟเวอร์การสร้างรายได้

ซอฟต์แวร์ที่รองรับ

รุ่นนี้มีการเปลี่ยนแปลงซอฟต์แวร์ที่รองรับดังต่อไปนี้

เพิ่มการรองรับแล้ว ไม่รองรับอีกต่อไป

รุ่นนี้เพิ่มการรองรับแพลตฟอร์มต่อไปนี้

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle ใน Linux 6.9

ระบบไม่รองรับแพลตฟอร์มต่อไปนี้ในรุ่นนี้อีกต่อไป

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

ดูรายการแพลตฟอร์มทั้งหมดที่รองรับได้ในซอฟต์แวร์ที่รองรับและเวอร์ชันที่รองรับ

แก้ไขข้อบกพร่อง

ส่วนนี้จะแสดงข้อบกพร่องของ Private Cloud ที่ได้รับการแก้ไขในรุ่นนี้ นอกจากนี้ รุ่นนี้มีการแก้ไขข้อบกพร่องทั้งหมดใน Edge UI, การจัดการ Edge และรุ่นพอร์ทัลที่แสดงในรุ่นที่รวม

รหัสปัญหา คำอธิบาย
140270474

ไม่ได้ตั้งค่า UseStringDeduplication

ไม่ได้ตั้งค่า UseStringDeduplication สำหรับคอมโพเนนต์ edge-message-processor ในสภาพแวดล้อมการใช้งานจริง
111445518

ข้อผิดพลาด MP

ตัวประมวลผลข้อความจะบันทึกข้อความแสดงข้อผิดพลาดต่อไปนี้อย่างต่อเนื่องทุก 5 นาที
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

Cassandra ล้มเหลวกับ JMX

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

การอัปเกรด 13 โหนด

การอัปเกรดการติดตั้ง 13 โหนดจาก 17.09, 18.01 และ 18.05 ล้มเหลว
119802562

พร็อกซีที่มีชื่อเดียวกัน

หากผู้ใช้ 2 รายในองค์กรเดียวกันสร้างพร็อกซีที่มีชื่อเดียวกัน ผู้ใช้รายที่ 2 ที่สร้างขึ้นจะเขียนทับรายการแรก ซึ่งเหตุการณ์นี้จะเกิดขึ้นเมื่อผู้ใช้แต่ละคนมองไม่เห็นพร็อกซีอีกรายการ
118851790

คีย์สโตร์ไม่โหลด

เมื่อมีคีย์สโตร์มากกว่า 100 รายการสำหรับองค์กร/สภาพแวดล้อม ส่วนคีย์สโตร์และข้อมูลอ้างอิงใน Edge UI ไม่โหลด UI แสดงข้อผิดพลาด Internal Error (Error Fetching Keystores) แทน
110988191

Analytics ล้มเหลว

Analytics ล้มเหลวสำหรับสภาพแวดล้อมเมื่อได้รับข้อมูลจาก Microgateway ที่ตั้งค่าเป็นวันที่ในอนาคต
110785400

การสำรองข้อมูลล้มเหลว

ZooKeeper, Cassandra และ OpenLDAP สำรองข้อมูลอย่างถูกต้องไม่สำเร็จเป็นพักๆ เนื่องจากข้อผิดพลาดต่อไปนี้ File changed as we read it.
79993247

คำขอ HEAD รายการไปยัง Node.js

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

ข้อมูลสำรอง/กู้คืน apigee-postgres

การดำเนินการสำรองข้อมูล/กู้คืน Apigee-postgres จะช่วยสำรองข้อมูลสำหรับคอมโพเนนต์ทั้งหมด
65737520

การรีเซ็ตรหัสผ่านผู้ดูแลระบบ

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

ปัญหาที่ทราบ

ตารางต่อไปนี้แสดงปัญหาที่ทราบในรุ่นนี้

รหัสปัญหา คำอธิบาย
141628497

อย่าให้คะแนนธุรกรรมตั้งแต่แรก

Edge สำหรับ Private Cloud จะไม่จัดประเภทธุรกรรมในตอนแรกเมื่อคุณเปิดใช้การสร้างรายได้สำหรับองค์กรเป็นครั้งแรก ซึ่งจะมีผลกับองค์กรใหม่และองค์กรเดิม

API การเปิดใช้งานการสร้างรายได้จะตอบกลับด้วยรหัสงาน และเมื่องานเสร็จสมบูรณ์แล้ว สถานะของงานจะบ่งชี้ความสำเร็จ อย่างไรก็ตาม การเรียก API ที่สร้างรายได้ที่เกิดขึ้นในตอนแรกจะไม่ได้รับการประมวลผลโดยการสร้างรายได้และจะไม่ได้รับการจัดประเภท ธุรกรรมเหล่านี้จะปรากฏในข้อมูลวิเคราะห์ปกติเท่านั้น

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

รีสตาร์ทโปรแกรมประมวลผลข้อความ (MP) โดยดำเนินการดังนี้
apigee-service edge-message-processor restart

หลังจากเปิดใช้การสร้างรายได้แล้ว การรีสตาร์ท MP จะทำให้ Edge โหลดการกำหนดค่าจาก ZooKeeper เมื่อเริ่มต้นใช้งาน ปัญหานี้จะเกิดขึ้นทุกครั้งที่รีสตาร์ท ซึ่งหมายความว่าปัญหาจะเกิดขึ้นเฉพาะครั้งแรกเท่านั้น

137865184

หน่วยความจำรั่วไหลของเซิร์ฟเวอร์การจัดประเภทมินต์

เมื่ออินสแตนซ์ Qpid ใหม่ลงทะเบียนใน mxgroup คิวจะสร้างโดยไม่มีผู้ใช้ ซึ่งทำให้ความลึกของคิวเพิ่มขึ้นจนกว่าจะใช้ทรัพยากรที่มีอยู่ทั้งหมด

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

ไม่มี
135616498

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

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

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

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

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

    หรือ

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

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

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

ไม่มี
121095148

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

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

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

76087166

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 ดูข้อมูลเพิ่มเติมเกี่ยวกับคำสั่งเหล่านี้ได้ที่อัปเดตการลงทะเบียนพื้นที่เก็บข้อมูล

68722102

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

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

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

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

ไม่มี

ขั้นตอนถัดไป

หากต้องการเริ่มต้นใช้งาน Edge สำหรับ Private Cloud 4.19.06 โปรดใช้ลิงก์ต่อไปนี้

การติดตั้งใหม่:
ภาพรวมของการติดตั้งใหม่
การติดตั้งที่มีอยู่:
เส้นทางการอัปเกรด