อัปเดต Apigee Edge 4.52.02 หรือ 4.53.00 เป็น 4.53.01

Apigee รองรับการอัปเกรด Edge สำหรับ Private Cloud โดยตรงจากเวอร์ชัน 4.52.02 หรือ 4.53.00 เป็นเวอร์ชัน 4.53.01 หน้านี้จะอธิบายวิธีอัปเกรด

ดูภาพรวมของเส้นทางการอัปเกรดที่เข้ากันได้ได้ที่เมทริกซ์ความเข้ากันได้ของการอัปเกรดสำหรับรุ่น Edge for Private Cloud

ผู้ที่อัปเดตได้

ผู้ที่ทำการอัปเดตควรเป็นคนเดียวกับผู้ที่ติดตั้ง Edge ในตอนแรก หรือผู้ที่เรียกใช้ในฐานะรูท

หลังจากติดตั้ง RPM ของ Edge แล้ว ทุกคนจะกำหนดค่าได้

คุณต้องอัปเดตคอมโพเนนต์ใด

คุณต้องอัปเดตคอมโพเนนต์ทั้งหมดของ Edge Edge ไม่รองรับการตั้งค่าที่มีคอมโพเนนต์จากหลายเวอร์ชัน

อัปเดตข้อกำหนดเบื้องต้น

ตรวจสอบการเปลี่ยนแปลงใน Edge สำหรับ Private Cloud 4.53.01

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

โปรดตรวจสอบข้อกำหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge

  • สำรองข้อมูลโหนดทั้งหมด
    ก่อนที่จะอัปเดต เราขอแนะนำให้คุณสำรองข้อมูลโหนดทั้งหมดอย่างสมบูรณ์เพื่อความปลอดภัย ใช้ขั้นตอนสำหรับ Edge เวอร์ชันปัจจุบันเพื่อทำการสำรองข้อมูล

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

  • ตรวจสอบว่า Edge ทำงานอยู่
    ตรวจสอบว่า Edge ทำงานอยู่ระหว่างกระบวนการอัปเดตโดยใช้คำสั่งต่อไปนี้ 
    /opt/apigee/apigee-service/bin/apigee-all status
  • ยืนยันข้อกำหนดเบื้องต้นของ Cassandra

    หากก่อนหน้านี้คุณอัปเกรดจาก Edge for Private Cloud เวอร์ชันเก่าเป็นเวอร์ชัน 4.52.02 และตอนนี้วางแผนที่จะอัปเกรดเป็นเวอร์ชัน 4.53.01 โปรดตรวจสอบว่าคุณได้ทำขั้นตอนหลังการอัปเกรดที่จำเป็นสำหรับ Cassandra เสร็จสมบูรณ์แล้ว ขั้นตอนเหล่านี้ระบุไว้ในเอกสารประกอบการอัปเกรดเวอร์ชัน 4.52.02 และยังกล่าวถึงในส่วนข้อกำหนดเบื้องต้นสำหรับการอัปเกรด Cassandra ด้วย หากไม่แน่ใจว่าได้ทำตามขั้นตอนเหล่านี้ในระหว่างการอัปเกรดครั้งก่อนหรือไม่ ให้ทำตามขั้นตอนอีกครั้งก่อนดำเนินการอัปเกรดเป็นเวอร์ชัน 4.53.01

  • การกำหนดค่าคีย์และใบรับรอง IDP ใน Edge for Private Cloud 4.53.01

    ใน Edge for Private Cloud 4.53.01 ตอนนี้ระบบจะกำหนดค่าคีย์และใบรับรอง IdP ที่ใช้ในคอมโพเนนต์ apigee-sso ผ่านที่เก็บคีย์แล้ว คุณจะต้องส่งออกคีย์และใบรับรองที่เคยใช้ก่อนหน้านี้ไปยัง Keystore ทำตามขั้นตอนในส่วนขั้นตอนการอัปเดต Apigee SSO จากเวอร์ชันเก่าเพื่อดูขั้นตอนโดยละเอียดก่อนอัปเดตคอมโพเนนต์ SSO

  • ข้อกำหนดของ Python
    ตรวจสอบว่าโหนดทั้งหมด รวมถึงโหนด Cassandra ได้ติดตั้ง Python 3 แล้วก่อนที่จะพยายามอัปเกรด

ขั้นตอนพิเศษที่ควรพิจารณาสำหรับการอัปเกรด

หากต้องการอัปเกรดเป็น Edge สำหรับ Private Cloud 4.53.01 ให้พิจารณาดำเนินการตามขั้นตอนที่เฉพาะเจาะจงสำหรับการอัปเกรดซอฟต์แวร์บางอย่าง ขั้นตอนที่จำเป็นจะขึ้นอยู่กับเวอร์ชันปัจจุบันของคุณ ดูตารางด้านล่างเพื่อดูซอฟต์แวร์ต่างๆ ที่ต้องมีขั้นตอนเพิ่มเติม และทำตามวิธีการโดยละเอียดสำหรับซอฟต์แวร์แต่ละรายการ หลังจากทํางานที่จําเป็นเสร็จแล้ว ให้กลับไปที่ขั้นตอนการอัปเกรดหลักเพื่อดําเนินการอัปเกรดต่อ

เวอร์ชันปัจจุบัน ซอฟต์แวร์ที่ต้องมีขั้นตอนพิเศษในการอัปเกรดเป็น 4.53.01
4.52.02 LDAP, Cassandra, Zookeeper, Postgres
4.53.00 LDAP, Zookeeper, Postgres

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

การส่งต่อการตั้งค่าพร็อพเพอร์ตี้โดยอัตโนมัติ

หากคุณตั้งค่าพร็อพเพอร์ตี้ใดๆ โดยการแก้ไขไฟล์ .properties ใน /opt/apigee/customer/application การอัปเดตจะเก็บค่าเหล่านี้ไว้

ต้องอัปเกรดเป็น OpenLDAP 2.6

ขั้นตอนโดยละเอียดสำหรับการอัปเกรดบริการ LDAP พื้นฐานของ Apigee Edge สำหรับ Private Cloud จาก OpenLDAP 2.4 รุ่นเดิมเป็น OpenLDAP 2.6 มีดังนี้ การอัปเกรดนี้เป็นข้อกำหนดที่จำเป็นสำหรับการอัปเดตเป็น Apigee Edge สำหรับ Private Cloud เวอร์ชัน 4.53.01 ขึ้นไป การอัปเกรดนี้ใช้ได้กับโทโพโลยีการติดตั้งใช้งาน Apigee LDAP ทั้งหมด ได้แก่ เซิร์ฟเวอร์เดียว ใช้งานอยู่-ไม่ได้ใช้งาน และใช้งานอยู่-ใช้งานอยู่ (หลายมาสเตอร์)

สิ่งที่ต้องดำเนินการก่อนและข้อควรพิจารณา

  • โปรดทราบว่าในระหว่างกระบวนการอัปเกรด LDAP นั้น Management API และ Apigee UI จะใช้งานไม่ได้โดยสมบูรณ์ในทุกภูมิภาค งานด้านการดูแลระบบทั้งหมด เช่น การจัดการผู้ใช้ บทบาท แอป และองค์กร จะไม่สำเร็จและควรหยุดชั่วคราว การดำเนินการนี้จะไม่ส่งผลต่อการประมวลผลการเข้าชมพร็อกซี API โปรดตรวจสอบว่าได้ปิดเซิร์ฟเวอร์การจัดการ Edge และ Edge UI ทั้งหมดก่อนที่จะดำเนินการอัปเกรด LDAP ต่อไป

  • การสำรองข้อมูลเป็นสิ่งสำคัญ: คุณต้องสำรองข้อมูล LDAP ที่มีอยู่ทั้งหมดและตรวจสอบแล้ว การดำเนินการต่อโดยไม่มีข้อมูลสำรองที่ถูกต้องจะทำให้ข้อมูลสูญหายแบบเอากลับคืนมาไม่ได้ ต้องเริ่มการสำรองข้อมูลขณะที่บริการ LDAP ยังทำงานอยู่เพื่อบันทึกภาพรวมข้อมูล LDAP ที่สอดคล้องกัน ณ จุดเวลาหนึ่งๆ คุณต้องสำรองข้อมูลเพื่อทำการอัปเกรดจริง หากไม่มีข้อมูลสำรอง คุณจะอัปเกรดหรือย้อนกลับไม่ได้ เนื่องจากขั้นตอนการอัปเกรดเกี่ยวข้องกับการล้างข้อมูล LDAP

การเตรียมและการติดตั้ง (เซิร์ฟเวอร์ LDAP ทั้งหมด)

ขั้นตอนในส่วนนี้ (ขั้นตอนที่ 2 ถึง 5) จะเหมือนกันสําหรับโทโพโลยีการติดตั้งใช้งาน LDAP ทั้งหมด การดำเนินการเหล่านี้ต้องทำในทุกเซิร์ฟเวอร์ที่ติดตั้งคอมโพเนนต์ apigee-openldap โดยไม่คำนึงถึงบทบาทของเซิร์ฟเวอร์

  1. โปรดตรวจสอบว่าได้ปิดedge-management-server และ edge-ui ทั้งหมดก่อนที่จะดำเนินการอัปเกรด LDAP ต่อ 
    apigee-service edge-management-server stop
apigee-service edge-ui stop

  2. สำรองข้อมูล LDAP ที่มีอยู่

    ก่อนทำการเปลี่ยนแปลงใดๆ ให้สำรองข้อมูล LDAP ปัจจุบันทั้งหมดจากเซิร์ฟเวอร์ LDAP ทั้งหมด ซึ่งจะสร้างจุดคืนค่าที่ปลอดภัย

    • เรียกใช้คำสั่งสำรองข้อมูล การดำเนินการนี้จะสร้างที่เก็บถาวรสำรองที่มีการประทับเวลาภายในไดเรกทอรี /opt/apigee/backup/openldap 
      apigee-service apigee-openldap backup
    • รับจำนวนระเบียนทั้งหมด: บันทึกจำนวนระเบียนในไดเรกทอรีสำหรับการตรวจสอบหลังการอัปเกรด (จำนวนระเบียนควรตรงกันในเซิร์ฟเวอร์ LDAP ทั้งหมด) นี่คือการตรวจสอบความถูกต้อง 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

  3. หยุด LDAP และล้างไดเรกทอรีข้อมูล

    ขั้นตอนนี้ต้องดำเนินการในเซิร์ฟเวอร์ LDAP ทั้งหมด การดำเนินการนี้เป็นข้อบังคับเนื่องจากการเปลี่ยนแปลงเวอร์ชันหลักและความแตกต่างของโครงสร้างพื้นฐาน การล้างไดเรกทอรีจะช่วยให้ไม่มีข้อขัดแย้ง เมื่อเซิร์ฟเวอร์ LDAP ทั้งหมดหยุดทำงาน การหยุดชะงักของ Management API และ UI จะเริ่มขึ้น

    • หยุดบริการ LDAP 
      apigee-service apigee-openldap stop
    • นำข้อมูลและไดเรกทอรีการกำหนดค่า LDAP เก่าออกอย่างถาวร 
      rm -rf /opt/apigee/data/apigee-openldap/*

  4. ติดตั้งและกำหนดค่า LDAP เวอร์ชันใหม่

    ในเซิร์ฟเวอร์ LDAP ทั้งหมด ให้ใช้สคริปต์ Apigee มาตรฐานเพื่อดาวน์โหลดและติดตั้งคอมโพเนนต์เวอร์ชันใหม่

    • ติดตั้งคอมโพเนนต์ LDAP ใหม่: สคริปต์การอัปเดตจะอ่านไฟล์การกำหนดค่าและติดตั้งแพ็กเกจ apigee-openldap ใหม่ 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf
    • ตรวจสอบเวอร์ชัน LDAP ใหม่: หลังจากติดตั้งเสร็จแล้ว ให้โหลดโปรไฟล์ซ้ำและตรวจสอบว่าได้ติดตั้ง LDAP เวอร์ชันใหม่ถูกต้องแล้ว 
      source ~/.bash_profile
ldapsearch -VV
Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

  5. หยุด LDAP ในเซิร์ฟเวอร์ทั้งหมดก่อนที่จะกู้คืนข้อมูล

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

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*

  6. กู้คืนข้อมูล LDAP

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

    1. ระบุเซิร์ฟเวอร์ที่ใช้งานเครื่องแรกสำหรับการกู้คืน

      • สำหรับการตั้งค่าเซิร์ฟเวอร์เดียว: นี่คือเซิร์ฟเวอร์ LDAP เพียงเครื่องเดียว คุณดำเนินการในขั้นตอนถัดไปได้เลย
      • สำหรับการตั้งค่าแบบแอ็กทีฟ-พาสซีฟและแอ็กทีฟ-แอ็กทีฟ: เรียกใช้คำสั่งการวินิจฉัยต่อไปนี้ในเซิร์ฟเวอร์ LDAP แต่ละเครื่อง 
        grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
Note:
-If this command returns output, the server is a passive server.
-If it returns no output, the server is the active server.

    2. กู้คืนข้อมูลสำรอง

      ก่อนดำเนินการต่อ โปรดตรวจสอบอีกครั้งว่าขั้นตอนที่ 5 เสร็จสมบูรณ์ในเซิร์ฟเวอร์ LDAP ทั้งหมด

      • ในเซิร์ฟเวอร์ที่ใช้งานเครื่องแรกที่คุณระบุไว้ข้างต้น ให้ไปที่ไดเรกทอรีสำรอง 
        cd /opt/apigee/backup/openldap
      • เรียกใช้คำสั่ง restore เราขอแนะนำเป็นอย่างยิ่งให้ระบุการประทับเวลาสำรองที่แน่นอนจากขั้นตอนที่ 2 เพื่อป้องกันการกู้คืนเวอร์ชันที่ไม่ต้องการหรือเวอร์ชันเก่ากว่า 
        # To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
      • หลังจากกระบวนการกู้คืนเสร็จสมบูรณ์แล้ว ให้เริ่มบริการ LDAP ในเซิร์ฟเวอร์ที่ใช้งานเครื่องแรก 
        apigee-service apigee-openldap start

  7. เริ่มเซิร์ฟเวอร์ LDAP ที่เหลือ

    หากคุณมีการตั้งค่าแบบหลายเซิร์ฟเวอร์ ให้เริ่มบริการในเซิร์ฟเวอร์ LDAP แต่ละเครื่องโดยทำดังนี้ 

    apigee-service apigee-openldap start

  8. การตรวจสอบขั้นสุดท้าย

    ขั้นตอนสุดท้ายคือการยืนยันว่าการอัปเกรดสำเร็จและข้อมูลสอดคล้องกันในคลัสเตอร์ LDAP ทั้งหมด

    • เรียกใช้คำสั่งการตรวจสอบในเซิร์ฟเวอร์ LDAP ทั้งหมด จำนวนระเบียนควรเหมือนกันในเซิร์ฟเวอร์ทั้งหมด และต้องตรงกับจำนวนที่คุณบันทึกไว้ในขั้นตอนที่ 2
      • # Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • เมื่อยืนยันแล้วว่าข้อมูลถูกต้องและสอดคล้องกัน การอัปเกรด LDAP ก็จะเสร็จสมบูรณ์ ตอนนี้คุณสามารถเริ่ม edge-management-server และ edge-ui รวมถึงคอมโพเนนต์อื่นๆ ที่ขึ้นอยู่กับคอมโพเนนต์เหล่านี้ได้ตามขั้นตอนการอัปเกรดมาตรฐานขององค์กร

ต้องอัปเกรดเป็น Cassandra 4.0.18

Apigee Edge สำหรับ Private Cloud 4.53.01 มีการอัปเกรด Cassandra เป็นเวอร์ชัน 4.0.18

การอัปเกรดและการย้อนกลับ

  • การอัปเกรดจาก Cassandra 3.11.X เป็น Cassandra 4.0.X เป็นกระบวนการที่ราบรื่น Cassandra 4.0.X ซึ่งเปิดตัวพร้อมกับ Edge for Private Cloud 4.53.00 สามารถใช้งานร่วมกับคอมโพเนนต์รันไทม์และการจัดการของ Private Cloud 4.52.02 ได้
  • คุณย้อนกลับจาก Cassandra 4.0.X เป็น 3.11.X โดยตรงไม่ได้ การย้อนกลับโดยใช้รีพลิกาหรือข้อมูลสำรองเป็นกระบวนการที่ซับซ้อนและอาจทำให้เกิดช่วงหยุดทำงานและ/หรือข้อมูลสูญหาย การแก้ปัญหาและการอัปเกรดเป็น Cassandra 4.0.X เป็นวิธีที่แนะนำมากกว่าการย้อนกลับ
  • คุณควรทำความคุ้นเคยกับขั้นตอนการย้อนกลับก่อนที่จะพยายามอัปเกรด การพิจารณาความแตกต่างของการย้อนกลับระหว่างการอัปเกรดเป็นสิ่งสำคัญเพื่อให้แน่ใจว่ามีเส้นทางการย้อนกลับที่เหมาะสม

ศูนย์ข้อมูลเดียว

การอัปเกรด Cassandra จาก 3.11.X เป็น 4.0.X ภายในศูนย์ข้อมูลเดียวเป็นไปอย่างราบรื่น แต่การย้อนกลับนั้นซับซ้อนและอาจส่งผลให้เกิดช่วงพักการใช้งานและข้อมูลสูญหาย สำหรับภาระงานการผลิต เราขอแนะนำอย่างยิ่งให้เพิ่มศูนย์ข้อมูลใหม่ที่มีโหนด Cassandra อย่างน้อย 1 รายการในศูนย์ข้อมูลใหม่ก่อนเริ่มการอัปเกรด ซึ่งจะช่วยให้คุณย้อนกลับ Cassandra ได้โดยไม่มีการสูญเสียข้อมูลหรือการหยุดชะงักของการเข้าชม API คุณสามารถเลิกใช้งานศูนย์ข้อมูลเพิ่มเติมนี้ได้เมื่อการอัปเกรดเสร็จสิ้นหรือเมื่อถึงจุดตรวจสอบที่ 2

หากเพิ่มศูนย์ข้อมูลใหม่ไม่ได้ แต่ยังต้องการความสามารถในการย้อนกลับ คุณจะต้องสำรองข้อมูลเพื่อกู้คืน Cassandra 3.11.X อย่างไรก็ตาม วิธีนี้อาจทำให้เกิดการหยุดทำงานและข้อมูลสูญหาย

ศูนย์ข้อมูลหลายแห่ง

การใช้งานศูนย์ข้อมูลหลายแห่งด้วย Edge สำหรับ Private Cloud 4.52.02 จะช่วยให้คุณย้อนกลับได้อย่างยืดหยุ่นมากขึ้นในระหว่างการอัปเกรดเป็น Edge สำหรับ Private Cloud 4.53.00

  • การย้อนกลับขึ้นอยู่กับการมีศูนย์ข้อมูลอย่างน้อย 1 แห่งที่ใช้ Cassandra เวอร์ชันเก่ากว่า (3.11.X)
  • หากอัปเกรดคลัสเตอร์ Cassandra ทั้งหมดเป็น 4.0.X คุณต้องไม่ย้อนกลับไปใช้ Cassandra 3.11.X คุณต้องใช้ Cassandra เวอร์ชันใหม่กว่ากับคอมโพเนนต์อื่นๆ ของ Private Cloud 4.53.00 หรือ 4.52.02 ต่อไป
  1. อัปเกรดศูนย์ข้อมูล Cassandra ทีละแห่ง: เริ่มต้นด้วยการอัปเกรดโหนด Cassandra ทีละรายการภายในศูนย์ข้อมูลเดียว อัปเกรดโหนด Cassandra ทั้งหมดในศูนย์ข้อมูลหนึ่งให้เสร็จสมบูรณ์ก่อนที่จะไปยังศูนย์ข้อมูลถัดไป
  2. หยุดชั่วคราวและตรวจสอบ: หลังจากอัปเกรดศูนย์ข้อมูล 1 แห่งแล้ว ให้หยุดชั่วคราวเพื่อให้มั่นใจว่าคลัสเตอร์ Private Cloud โดยเฉพาะศูนย์ข้อมูลที่อัปเกรดแล้วทํางานได้อย่างถูกต้อง
  3. โปรดทราบ: คุณจะย้อนกลับไปใช้ Cassandra เวอร์ชันก่อนหน้าได้ก็ต่อเมื่อมีศูนย์ข้อมูลอย่างน้อย 1 แห่งที่ยังคงใช้เวอร์ชันเก่าอยู่
  4. ต้องดำเนินการโดยเร็ว: แม้ว่าคุณจะหยุดชั่วคราวเป็นระยะเวลาสั้นๆ (แนะนําให้หยุด 2-3 ชั่วโมง) เพื่อตรวจสอบฟังก์ชันการทํางานได้ แต่คุณจะอยู่ในสถานะเวอร์ชันผสมอย่างไม่มีกําหนดไม่ได้ เนื่องจากคลัสเตอร์ Cassandra ที่ไม่สม่ำเสมอ (มีโหนดในเวอร์ชันต่างๆ) มีข้อจำกัดในการทำงาน
  5. การทดสอบอย่างละเอียด: Apigee ขอแนะนำอย่างยิ่งให้ทดสอบประสิทธิภาพและฟังก์ชันการทำงานอย่างครอบคลุมก่อนอัปเกรดศูนย์ข้อมูลถัดไป เมื่ออัปเกรดศูนย์ข้อมูลทั้งหมดแล้ว จะไม่สามารถย้อนกลับไปใช้เวอร์ชันก่อนหน้าได้
การย้อนกลับเป็นกระบวนการแบบ 2 จุดตรวจ
  1. จุดตรวจที่ 1: สถานะเริ่มต้น โดยคอมโพเนนต์ทั้งหมดเป็นเวอร์ชัน 4.52.02 คุณสามารถย้อนกลับทั้งหมดได้ตราบใดที่ศูนย์ข้อมูล Cassandra อย่างน้อย 1 แห่งยังคงใช้เวอร์ชันเก่าอยู่
  2. จุดตรวจสอบที่ 2: หลังจากอัปเดตโหนด Cassandra ทั้งหมดในศูนย์ข้อมูลทั้งหมดแล้ว คุณสามารถย้อนกลับไปที่สถานะนี้ได้ แต่จะย้อนกลับไปที่จุดตรวจสอบ 1 ไม่ได้
ตัวอย่าง

พิจารณาคลัสเตอร์ 2 ศูนย์ข้อมูล (DC) ดังนี้

  1. สถานะเริ่มต้น: โหนด Cassandra ในทั้ง 2 DC อยู่ในเวอร์ชัน 3.11.X โหนดอื่นๆ ทั้งหมดอยู่ใน Edge สำหรับ Private Cloud เวอร์ชัน 4.52.02 สมมติว่ามีโหนด Cassandra 3 โหนดต่อ DC
  2. อัปเกรด DC-1: อัปเกรดโหนด Cassandra ทั้ง 3 โหนดใน DC-1 ทีละโหนด
  3. หยุดชั่วคราวและตรวจสอบ: หยุดชั่วคราวเพื่อให้แน่ใจว่าคลัสเตอร์ โดยเฉพาะ DC-1 ทํางานได้อย่างถูกต้อง (ตรวจสอบประสิทธิภาพ ฟังก์ชันการทํางาน) คุณสามารถย้อนกลับไปที่สถานะเริ่มต้นได้โดยใช้โหนด Cassandra ใน DC-2 โปรดทราบว่าการหยุดชั่วคราวนี้ต้องเป็นแบบชั่วคราวเนื่องจากข้อจำกัดของคลัสเตอร์ Cassandra แบบเวอร์ชันผสม
  4. อัปเกรด DC-2: อัปเกรดโหนด Cassandra ที่เหลืออีก 3 โหนดใน DC-2 ซึ่งจะเป็นจุดตรวจสอบการย้อนกลับใหม่
  5. อัปเกรดคอมโพเนนต์อื่นๆ: อัปเกรดโหนดการจัดการ รันไทม์ และการวิเคราะห์ตามปกติในศูนย์ข้อมูลทั้งหมด โดยอัปเกรดทีละโหนดและทีละศูนย์ข้อมูล หากเกิดปัญหา คุณสามารถย้อนกลับไปที่สถานะของขั้นตอนที่ 4 ได้

ข้อกำหนดเบื้องต้นสำหรับการอัปเกรด Cassandra

คุณควรใช้ Cassandra 3.11.16 กับ Edge สำหรับ Private Cloud 4.52.02 และตรวจสอบว่ามีสิ่งต่อไปนี้
  1. คลัสเตอร์ทั้งหมดทำงานได้และใช้งานได้อย่างสมบูรณ์ด้วย Cassandra 3.11.16
  2. กลยุทธ์การบีบอัดได้รับการตั้งค่าเป็น LeveledCompactionStrategy (ข้อกำหนดเบื้องต้นสำหรับการอัปเกรดเป็นเวอร์ชัน 4.52.02)

  3. ยืนยันว่าได้ทำตามแต่ละขั้นตอนด้านล่างเป็นส่วนหนึ่งของการอัปเกรด Cassandra 3.11 ใน Edge for Private Cloud 4.52.02 ครั้งแรก

    • ระบบได้เรียกใช้คำสั่ง post_upgrade ในแต่ละโหนด Cassandra ระหว่างการอัปเกรดครั้งก่อน
    • ระบบได้เรียกใช้คำสั่ง drop_old_tables ในคลัสเตอร์ Cassandra ทั้งหมดระหว่างการอัปเกรดครั้งก่อน

หากไม่แน่ใจว่าคำสั่ง post_upgrade และ drop_old_tables ได้รับการดำเนินการใน Cassandra 3.11 ขณะใช้ Edge for Private Cloud 4.52.02 หรือไม่ คุณสามารถเรียกใช้คำสั่งเหล่านั้นอีกครั้งได้อย่างปลอดภัยก่อนที่จะพยายามอัปเกรดเป็น 4.53.01

ขั้นตอนที่ 1: เตรียมพร้อมสำหรับการอัปเกรด

ขั้นตอนด้านล่างนี้เป็นส่วนเพิ่มเติมจากไฟล์มาตรฐานที่คุณมักจะสร้าง เช่น ไฟล์การกำหนดค่ามาตรฐานของ Apigee สำหรับการเปิดใช้การอัปเกรดคอมโพเนนต์

  1. สำรองข้อมูล Cassandra โดยใช้ Apigee
  2. ถ่ายภาพรวม VM ของโหนด Cassandra (หากเป็นไปได้)
  3. ตรวจสอบว่าคอมโพเนนต์ Edge for Private Cloud ทั้งหมด รวมถึงเซิร์ฟเวอร์การจัดการ, Message Processor, Router, Qpid และ Postgres สามารถเข้าถึงพอร์ต 9042 ไปยังโหนด Cassandra ได้ หากยังไม่ได้กำหนดค่า ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดเกี่ยวกับพอร์ต

ขั้นตอนที่ 2: อัปเกรดโหนด Cassandra ทั้งหมด

คุณควรจะอัปเดตโหนด Cassandra ทั้งหมดทีละโหนดในแต่ละศูนย์ข้อมูล โดยอัปเดตทีละศูนย์ข้อมูล ระหว่างการอัปเกรดโหนดภายในศูนย์ข้อมูล ให้รอสัก 2-3 นาทีเพื่อให้แน่ใจว่าโหนดที่อัปเดตเริ่มทำงานและเข้าร่วมคลัสเตอร์อย่างสมบูรณ์แล้ว ก่อนที่จะอัปเกรดโหนดอื่นในศูนย์ข้อมูลเดียวกัน

หลังจากอัปเกรดโหนด Cassandra ทั้งหมดภายในศูนย์ข้อมูลแล้ว ให้รอสักครู่ (30 นาทีถึง 2-3 ชั่วโมง) ก่อนดำเนินการกับโหนดในศูนย์ข้อมูลถัดไป ในช่วงนี้ ให้ตรวจสอบศูนย์ข้อมูลที่อัปเดตอย่างละเอียด และตรวจสอบว่าเมตริกด้านการทำงานและประสิทธิภาพของคลัสเตอร์ Apigee ยังคงอยู่ ขั้นตอนนี้มีความสำคัญอย่างยิ่งในการรับประกันความเสถียรของศูนย์ข้อมูลที่อัปเกรด Cassandra เป็นเวอร์ชัน 4.0.X ในขณะที่คอมโพเนนต์ Apigee ที่เหลือยังคงเป็นเวอร์ชัน 4.52.02

  1. หากต้องการอัปเกรดโหนด Cassandra ให้เรียกใช้คำสั่งต่อไปนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. เมื่ออัปเดตโหนดแล้ว ให้เรียกใช้คำสั่งต่อไปนี้ในโหนดเพื่อเรียกใช้การตรวจสอบบางอย่างก่อนดำเนินการต่อ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. คำสั่งข้างต้นจะแสดงผลลัพธ์ในลักษณะต่อไปนี้ 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. เรียกใช้คำสั่ง post_upgrade ต่อไปนี้ในโหนด Cassandra 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. เรียกใช้คำสั่ง nodetool ต่อไปนี้เพื่อสร้างดัชนีใหม่ในโหนด Cassandra 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     หากใช้การสร้างรายได้ ให้เรียกใช้คำสั่งสร้างดัชนีใหม่ต่อไปนี้ที่เกี่ยวข้องกับคีย์สเปซการสร้างรายได้ด้วย 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

ขั้นตอนที่ 3: อัปเกรดโหนดการจัดการทั้งหมด

อัปเกรดโหนดการจัดการทั้งหมดในทุกภูมิภาคทีละรายการ

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

ขั้นตอนที่ 4: อัปเกรดโหนดรันไทม์ทั้งหมด

อัปเกรดเราเตอร์และโหนดตัวประมวลผลข้อความทั้งหมดในทุกภูมิภาคทีละรายการ

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

ขั้นตอนที่ 5: อัปเกรดคอมโพเนนต์ Edge for Private Cloud 4.53.01 ที่เหลือทั้งหมด

อัปเกรดโหนด edge-qpid-server และ edge-postgres-server ที่เหลือทั้งหมดในทุกภูมิภาคทีละรายการ

ต้องอัปเกรดเป็น Zookeeper 3.8.4

Edge สำหรับ Private Cloud รุ่นนี้มีการอัปเกรดเป็น Zookeeper 3.8.4 ในส่วนของการอัปเกรดดังกล่าว ระบบจะย้ายข้อมูล Zookeeper ทั้งหมดไปยัง Zookeeper 3.8.4

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

ในระหว่างกระบวนการอัปเดต อาจเกิดความล่าช้าชั่วคราวหรือเขียนข้อมูลลงใน Zookeeper ไม่สำเร็จ เมื่อปิดโหนดผู้นำ ซึ่งอาจส่งผลต่อการดำเนินการจัดการที่เขียนลงใน Zookeeper เช่น การดำเนินการติดตั้งใช้งานพร็อกซี และการเปลี่ยนแปลงโครงสร้างพื้นฐานของ Apigee เช่น การเพิ่มหรือนำ Message Processor ออก เป็นต้น API รันไทม์ของ Apigee ไม่ควรได้รับผลกระทบ (เว้นแต่ API รันไทม์เหล่านี้เรียกใช้ Management API) ในระหว่างการอัปเกรด Zookeeper ขณะทำตามขั้นตอนด้านล่าง

กระบวนการอัปเกรดในระดับสูงเกี่ยวข้องกับการสำรองข้อมูลของแต่ละโหนด จากนั้น ให้อัปเกรดผู้สังเกตการณ์และผู้ติดตามทั้งหมด แล้วจึงอัปเกรดโหนดผู้นำ

สำรองข้อมูล

สำรองข้อมูลโหนดทั้งหมดของ Zookeeper เพื่อใช้ในกรณีที่ต้องย้อนกลับ โปรดทราบว่า การย้อนกลับจะกู้คืน Zookeeper ไปยังสถานะเมื่อมีการสำรองข้อมูล หมายเหตุ: การติดตั้งใช้งานหรือ การเปลี่ยนแปลงโครงสร้างพื้นฐานใน Apigee ตั้งแต่ที่มีการสำรองข้อมูล (ซึ่งจัดเก็บข้อมูลไว้ใน Zookeeper) จะหายไปในระหว่างการกู้คืน 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

หากคุณใช้เครื่องเสมือนและมีความสามารถดังกล่าว คุณอาจใช้สแนปชอตหรือข้อมูลสำรองของ VM เพื่อกู้คืนหรือย้อนกลับ (หากจำเป็น) ได้ด้วย

ระบุผู้นำ ผู้ติดตาม และผู้สังเกตการณ์

หมายเหตุ: คำสั่งตัวอย่างด้านล่างใช้ ยูทิลิตี nc เพื่อส่งข้อมูลไปยัง Zookeeper คุณยังใช้ ยูทิลิตีสำรองเพื่อส่งข้อมูลไปยัง Zookeeper ได้ด้วย

  1. หากไม่ได้ติดตั้งในโหนด ZooKeeper ให้ติดตั้ง nc โดยทำดังนี้ 
      sudo yum install nc
  2. เรียกใช้คำสั่ง nc ต่อไปนี้ในโหนด โดยที่ 2181 คือพอร์ต ZooKeeper 
      echo stat | nc localhost 2181

    คุณควรเห็นเอาต์พุตดังต่อไปนี้

      Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

    ในบรรทัด Mode ของเอาต์พุตสำหรับโหนด คุณควรเห็น observer, leader หรือ follower (หมายถึงผู้ลงคะแนนที่ไม่ใช่ผู้นำ) ทั้งนี้ขึ้นอยู่กับการกำหนดค่าโหนด หมายเหตุ: ในการติดตั้ง Edge แบบสแตนด์อโลนที่มีโหนด ZooKeeper เดียว ระบบจะตั้งค่า Mode เป็นแบบสแตนด์อโลน

  3. ทำขั้นตอนที่ 1 และ 2 ซ้ำในแต่ละโหนด ZooKeeper

อัปเกรด Zookeeper ในโหนด Observer และ Follower

อัปเกรด Zookeeper ในโหนด Observer และ Follower แต่ละโหนดดังนี้

  1. ดาวน์โหลดและเรียกใช้ Bootstrap ของ Edge for Private Cloud 4.53.01 ตามที่อธิบายไว้ใน อัปเดตเป็น 4.53.01 ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก กระบวนการนี้อาจ แตกต่างกันไปโดยขึ้นอยู่กับว่าโหนดมีการเชื่อมต่ออินเทอร์เน็ตภายนอกหรือไม่ หรือ คุณกำลังทำการติดตั้งแบบออฟไลน์
  2. อัปเกรดคอมโพเนนต์ Zookeeper 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
     หมายเหตุ: หากโหนดเหล่านี้มีการติดตั้งคอมโพเนนต์อื่นๆ (เช่น Cassandra) คุณก็อัปเกรด โหนดเหล่านั้นได้เลย (เช่นเดียวกับโปรไฟล์ cs,zk) หรือจะอัปเกรดคอมโพเนนต์อื่นๆ ในภายหลังก็ได้ Apigee ขอแนะนำให้อัปเกรด Zookeeper ก่อนและตรวจสอบว่าคลัสเตอร์ทำงานได้อย่างถูกต้อง ก่อนที่จะอัปเกรดคอมโพเนนต์อื่นๆ
  3. ทำซ้ำขั้นตอนข้างต้นในโหนด Zookeeper Observer และ Follower แต่ละรายการ

ปิดผู้นำ

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

โปรดทราบว่าในระหว่างเหตุการณ์นี้ ก่อนที่จะมีการเลือกผู้นำคนใหม่ อาจเกิดความล่าช้าชั่วคราวหรือ การเขียนล้มเหลวใน Zookeeper ซึ่งอาจส่งผลต่อการดำเนินการที่เขียนลงใน Zookeeper เช่น การดำเนินการในการติดตั้งใช้งานพร็อกซีหรือการเปลี่ยนแปลงโครงสร้างพื้นฐานของ Apigee เช่น การเพิ่มหรือ การนำ Message Processor ออก เป็นต้น

ยืนยันว่ามีการเลือกผู้นำคนใหม่

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

อัปเกรดผู้นำ

ทำตามขั้นตอนเดียวกับใน การอัปเกรด Zookeeper ในโหนด Observer และ Follower ด้านบน

เมื่ออัปเกรดโหนดลีดเดอร์เก่าแล้ว ให้ตรวจสอบสถานะคลัสเตอร์และ ตรวจสอบว่ามีโหนดลีดเดอร์

การอัปเกรด Nginx เป็นเวอร์ชัน 1.26 ใน Edge-Router

การอัปเกรดเป็น Edge for Private Cloud 4.53.01 จากเวอร์ชันก่อนหน้าจะไม่เป็นการอัปเกรดซอฟต์แวร์ Nginx เป็นเวอร์ชันล่าสุด (1.26.x) โดยอัตโนมัติ ทั้งนี้เพื่อป้องกันผลข้างเคียงที่อาจเกิดขึ้นโดยไม่ตั้งใจในรันไทม์อันเป็นผลมาจากการเปลี่ยนแปลงที่ระบุไว้ในการเปลี่ยนแปลง Nginx 1.26 ใน Apigee Edge 4.53.01 คุณอัปเกรด Nginx จาก 1.20.x เป็น 1.26.x ด้วยตนเองได้หลังจากการยืนยันในสภาพแวดล้อมที่ต่ำกว่า วิธีอัปเกรดด้วยตนเอง

  1. ตรวจสอบว่าโหนด Edge Router ใช้ซอฟต์แวร์เวอร์ชันล่าสุด 4.53.01

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

  2. ตรวจสอบและยืนยันเวอร์ชัน Nginx ที่คุณใช้อยู่

    /opt/nginx/sbin/nginx -V

    หากใช้ Nginx เวอร์ชันเก่า คุณสามารถทำตามขั้นตอนด้านล่างเพื่ออัปเกรด Nginx เป็นเวอร์ชัน 1.26.X ในโหนดเราเตอร์

  3. หยุดกระบวนการ Edge Router ในโหนดเราเตอร์

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

  4. อัปเกรดซอฟต์แวร์ nginx ในโหนดเราเตอร์

    dnf update apigee-nginx

  5. ตรวจสอบว่าได้อัปเดตเวอร์ชัน Nginx แล้ว

    /opt/nginx/sbin/nginx -V

  6. เริ่มกระบวนการเราเตอร์ในโหนด

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

  7. ทำกระบวนการนี้ซ้ำในโหนดเราเตอร์แต่ละโหนดทีละโหนด

ต้องอัปเกรดเป็น Postgres 17

Edge รุ่นนี้มีการอัปเกรดเป็น Postgres 17 การอัปเกรดดังกล่าวจะย้ายข้อมูล Postgres ทั้งหมดไปยัง Postgres 17

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

วิธีอัปเดต Postgres จะขึ้นอยู่กับวิธีที่คุณกำหนดค่าที่เก็บข้อมูลสำหรับโหนด Postgres ดังนี้

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

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

    ในการกำหนดค่า Edge แบบ 1 โหนดและ 2 โหนด ซึ่งเป็นโทโพโลยีที่ใช้สำหรับการสร้างต้นแบบและการทดสอบ คุณจะมีโหนด Postgres เพียงโหนดเดียว คุณอัปเดตโหนด Postgres เหล่านี้ได้โดยตรงโดยไม่ต้องสร้างโหนด Postgres ใหม่

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

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

การติดตั้งโหนดสแตนด์บาย Postgres ใหม่

ขั้นตอนนี้จะสร้างเซิร์ฟเวอร์สแตนด์บาย Postgres ในโหนดใหม่ ตรวจสอบว่าคุณได้ติดตั้งเซิร์ฟเวอร์สแตนด์บาย Postgres ใหม่สำหรับ Edge เวอร์ชันที่มีอยู่ (4.52.02 หรือ 4.53.00) ไม่ใช่สำหรับเวอร์ชัน 4.53.01

หากต้องการติดตั้ง ให้ใช้ไฟล์การกำหนดค่าเดียวกับที่ใช้ติดตั้ง Edge เวอร์ชันปัจจุบัน

วิธีสร้างโหนดสแตนด์บาย Postgres ใหม่

  1. ในมาสเตอร์ Postgres ปัจจุบัน ให้แก้ไขไฟล์ /opt/apigee/customer/application/postgresql.properties เพื่อตั้งค่าโทเค็นต่อไปนี้ หากไม่มีไฟล์ดังกล่าว ให้สร้างไฟล์โดยทำดังนี้ 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    โดย existing_standby_ip คือที่อยู่ IP ของเซิร์ฟเวอร์สแตนด์บาย Postgres ปัจจุบัน และ new_standby_ip คือที่อยู่ IP ของโหนดสแตนด์บายใหม่

  2. รีสตาร์ท apigee-postgresql ในมาสเตอร์ Postgres โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. ยืนยันว่าได้เพิ่มโหนดสแตนด์บายใหม่แล้วโดยดูไฟล์ /opt/apigee/apigee-postgresql/conf/pg_hba.conf ในมาสเตอร์ คุณควรเห็นบรรทัดต่อไปนี้ในไฟล์นั้น 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. ติดตั้งเซิร์ฟเวอร์สแตนด์บาย Postgres ใหม่
    1. แก้ไขไฟล์การกำหนดค่าที่ใช้ติดตั้ง Edge เวอร์ชันปัจจุบันเพื่อระบุ ข้อมูลต่อไปนี้ 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. ปิดใช้ SELinux ตามที่อธิบายไว้ใน ติดตั้งยูทิลิตี apigee-setup ของ Edge

    3. หากคุณใช้ Edge 4.52.02 อยู่ในขณะนี้ ให้ทำดังนี้

      1. ดาวน์โหลดไฟล์ bootstrap_4.52.02.sh ของ Edge ไปยัง /tmp/bootstrap_4.52.02.sh : 
        curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.51.00.sh
      2. ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge apigee-service 
        sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      หากคุณใช้ Edge 4.53.00 อยู่ในขณะนี้ ให้ทำดังนี้

      1. ดาวน์โหลดไฟล์ bootstrap_4.53.00.sh ของ Edge ไปยัง /tmp/bootstrap_4.53.00.sh 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge apigee-service 
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    4. ใช้ apigee-service เพื่อติดตั้งยูทิลิตี apigee-setup โดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. ติดตั้ง Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. เรียกใช้คำสั่งต่อไปนี้ในโหนดสแตนด์บายใหม่ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      ตรวจสอบว่าอุปกรณ์อยู่ในโหมดสแตนด์บาย

การอัปเกรด Postgres ในตำแหน่ง

หมายเหตุ: คุณต้องทำขั้นตอนเบื้องต้นต่อไปนี้ก่อน อัปเกรด Postgres แบบแทนที่

ขั้นตอนเบื้องต้น

ก่อนที่จะอัปเกรด Postgres ในที่ ให้ทําตามขั้นตอนต่อไปนี้ทั้งในโฮสต์หลัก และโฮสต์สำรอง เพื่ออัปเดตพร็อพเพอร์ตี้ max_locks_per_transaction ใน apigee-postgresql

  1. หากไม่มี ให้สร้างไฟล์ /opt/apigee/customer/application/postgresql.properties
  2. เปลี่ยนการเป็นเจ้าของไฟล์นี้เป็น apigee 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ลงในไฟล์ 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. กำหนดค่า apigee-postgresql 
    apigee-service apigee-postgresql configure
  5. รีสตาร์ท apigee-postgresql 
    apigee-service apigee-postgresql restart

ทำการอัปเกรดแบบแทนที่

หากต้องการอัปเกรดเป็น Postgres 17 ในที่ ให้ทำตามขั้นตอนต่อไปนี้

  1. อัปเกรด Postgres ในโฮสต์หลัก 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. เรียกใช้คำสั่งตั้งค่าในโฮสต์หลัก 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. เรียกใช้คำสั่งกำหนดค่าในโฮสต์หลัก 
    apigee-service apigee-postgresql configure
  4. รีสตาร์ทโฮสต์หลัก 
    apigee-service apigee-postgresql restart
  5. กำหนดค่าเป็นมาสเตอร์ 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. ตรวจสอบว่าโฮสต์หลักได้เริ่มทำงานแล้ว 
    apigee-service apigee-postgresql wait_for_ready
  7. วิธีหยุดโหมดสแตนด์บาย 
    apigee-service apigee-postgresql stop
  8. อัปเกรดสแตนด์บาย

    หมายเหตุ: หากขั้นตอนนี้เกิดข้อผิดพลาด/ล้มเหลว คุณสามารถข้ามไปได้ update.sh จะพยายาม เริ่มเซิร์ฟเวอร์สแตนด์บายด้วยการกำหนดค่าที่ไม่ถูกต้อง หากอัปเกรดการติดตั้ง Postgres เป็น 17 แล้ว คุณก็ไม่ต้องสนใจข้อผิดพลาดนี้

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. ตรวจสอบว่าหยุดสแตนด์บายแล้ว 
    apigee-service apigee-postgresql stop
  10. นำการกำหนดค่าสแตนด์บายเก่าออก 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. ตั้งค่าการจำลองแบบในเซิร์ฟเวอร์สแตนด์บาย 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
  12. นำบรรทัด conf/postgresql.conf+max_locks_per_transaction=30000 ออกจาก ไฟล์ /opt/apigee/customer/application/postgresql.properties ในทั้ง โฮสต์หลักและโฮสต์สำรอง บรรทัดนี้ เพิ่มในขั้นตอนเบื้องต้น

หลังจากทำตามขั้นตอนนี้แล้ว สแตนด์บายจะเริ่มทำงานได้สำเร็จ

การเลิกใช้งานโหนด Postgres

หลังจากอัปเดตเสร็จสมบูรณ์ ให้เลิกใช้งานโหนดสแตนด์บายใหม่โดยทำดังนี้

  1. ตรวจสอบว่า Postgres ทำงานอยู่โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-all status

    หาก Postgres ไม่ได้ทำงาน ให้เริ่มทำงานโดยทำดังนี้ 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. รับ UUID ของโหนดสแตนด์บายใหม่โดยการเรียกใช้curlคำสั่งต่อไปนี้ในโหนดสแตนด์บายใหม่ 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    คุณควรเห็น UUID ของโหนดที่ท้ายเอาต์พุตในรูปแบบต่อไปนี้ 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. หยุดโหนดสแตนด์บายใหม่โดยเรียกใช้คำสั่งต่อไปนี้ในโหนดสแตนด์บายใหม่ 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. ในโหนดหลักของ Postgres ให้แก้ไข /opt/apigee/customer/application/postgresql.properties เพื่อนำโหนดสแตนด์บายใหม่ออกจาก conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. รีสตาร์ท apigee-postgresql ในมาสเตอร์ Postgres โดยใช้คำสั่งต่อไปนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. ยืนยันว่าได้นำโหนดสแตนด์บายใหม่ออกแล้วโดยดูไฟล์ /opt/apigee/apigee-postgresql/conf/pg_hba.conf ในมาสเตอร์ คุณควรเห็นบรรทัดต่อไปนี้ในไฟล์นั้น เท่านั้น 
    host replication apigee existing_standby_ip/32 trust
  7. ลบ UUID ของโหนดสแตนด์บายออกจาก ZooKeeper โดยการเรียกใช้ API การจัดการ Edge ต่อไปนี้ในโหนดเซิร์ฟเวอร์การจัดการ 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

ขั้นตอนหลังการอัปเกรดสำหรับ Postgres

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

Postgres สามารถสร้างสถิติใหม่ได้ทีละน้อยเมื่อเวลาผ่านไปเมื่อมีการเรียกใช้การค้นหาและเมื่อ Daemon Autovacuum ทำงาน อย่างไรก็ตาม จนกว่าจะสร้างสถิติใหม่เสร็จ การค้นหาอาจช้า

หากต้องการแก้ไขปัญหานี้ ให้เรียกใช้ ANALYZE ในตารางทั้งหมดในฐานข้อมูลบนโหนด Postgres หลัก หรือจะเรียกใช้ ANALYZE สำหรับตาราง 2-3 ตารางพร้อมกันก็ได้

ขั้นตอนการอัปเดต Apigee SSO จากเวอร์ชันเก่า

ใน Edge for Private Cloud 4.53.01 ตอนนี้คีย์และใบรับรอง IdP ที่ใช้ในคอมโพเนนต์ apigee-sso ได้รับการกำหนดค่าผ่านที่เก็บคีย์แล้ว คุณจะต้องส่งออกคีย์และใบรับรองที่ใช้ก่อนหน้านี้ไปยัง Keystore กำหนดค่า แล้วดำเนินการอัปเดต SSO ตามปกติ

  1. ระบุคีย์และใบรับรองที่มีอยู่ซึ่งใช้ในการกำหนดค่า IdP

    1. ดึงข้อมูลใบรับรองโดยค้นหาค่าของ SSO_SAML_SERVICE_PROVIDER_CERTIFICATE ในไฟล์การกำหนดค่าการติดตั้ง SSO หรือโดยการค้นหาคอมโพเนนต์ apigee-sso สำหรับ conf_login_service_provider_certificate

      ใช้คำสั่งต่อไปนี้ในโหนด SSO เพื่อค้นหา apigee-sso สำหรับเส้นทางใบรับรอง IdP ในเอาต์พุต ให้มองหามูลค่าในบรรทัดสุดท้าย 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. เรียกข้อมูลคีย์โดยค้นหาค่าของ SSO_SAML_SERVICE_PROVIDER_KEY ในไฟล์กำหนดค่าการติดตั้ง SSO หรือโดยการค้นหาคอมโพเนนต์ apigee-sso สำหรับ conf_login_service_provider_key

      ใช้คำสั่งต่อไปนี้ในโหนด SSO เพื่อค้นหา apigee-sso สำหรับเส้นทางคีย์ IdP ในเอาต์พุต ให้มองหามูลค่าในบรรทัดสุดท้าย

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. ส่งออกคีย์และใบรับรองไปยังคีย์สโตร์
    1. ส่งออกคีย์และใบรับรองไปยังคีย์สโตร์ PKCS12 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      พารามิเตอร์ ได้แก่

      • certificate_path: เส้นทางไปยังไฟล์ใบรับรองที่ดึงข้อมูลมาในขั้นตอนที่ 1.a
      • key_path: เส้นทางไปยังไฟล์คีย์ส่วนตัวที่ดึงข้อมูลในขั้นตอนที่ 1.b
      • keystore_path: เส้นทางไปยังคีย์สโตร์ที่สร้างขึ้นใหม่ซึ่งมีใบรับรองและคีย์ส่วนตัว
      • alias: ชื่อแทนที่ใช้สำหรับคู่คีย์และใบรับรองภายในคีย์สโตร์

      ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบ OpenSSL

    2. (ไม่บังคับ) ส่งออกคีย์และใบรับรองจาก PKCS12 ไปยังคีย์สโตร์ JKS 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      พารามิเตอร์ ได้แก่

      • PKCS12_keystore_path: เส้นทางไปยังคีย์สโตร์ PKCS12 ที่สร้างในขั้นตอนที่ 2.a ซึ่งมีใบรับรองและคีย์
      • destination_keystore_path: เส้นทางไปยังที่เก็บคีย์ JKS ใหม่ที่จะส่งออกใบรับรองและคีย์
      • alias: ชื่อแทนที่ใช้สำหรับคู่คีย์และใบรับรองภายในคีย์สโตร์ JKS

      3. ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบของ Keytool

  3. เปลี่ยนเจ้าของไฟล์คีย์สโตร์เอาต์พุตเป็นผู้ใช้ "apigee" โดยทำดังนี้ 
    sudo chown apigee:apigee <keystore_file>
  4. เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ใน ไฟล์การกำหนดค่า Apigee SSO และอัปเดตด้วยเส้นทางไฟล์ที่เก็บคีย์รหัสผ่าน ประเภทที่เก็บคีย์ และนามแฝง 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. อัปเดตซอฟต์แวร์ Apigee SSO ในโหนด SSO ตามปกติโดยใช้คำสั่งต่อไปนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

UI ของ Edge ใหม่

ส่วนนี้แสดงข้อควรพิจารณาเกี่ยวกับ UI ของ Edge ดูข้อมูลเพิ่มเติมได้ที่ UI ใหม่ของ Edge สำหรับ Private Cloud

ติดตั้ง Edge UI

หลังจากติดตั้งครั้งแรกเสร็จแล้ว Apigee ขอแนะนำให้คุณติดตั้ง Edge UI ซึ่งเป็นอินเทอร์เฟซผู้ใช้ที่ได้รับการปรับปรุงสำหรับนักพัฒนาซอฟต์แวร์และผู้ดูแลระบบของ Apigee Edge สำหรับ Private Cloud

โปรดทราบว่า UI ของ Edge กำหนดให้คุณต้องปิดใช้การตรวจสอบสิทธิ์พื้นฐานและใช้ IDP เช่น SAML หรือ LDAP

ดูข้อมูลเพิ่มเติมได้ที่ติดตั้ง UI ของ Edge ใหม่

อัปเดตด้วย Apigee mTLS

หากต้องการอัปเดต Apigee mTLS ให้ทำตามขั้นตอนต่อไปนี้

การย้อนกลับการอัปเดต

ในกรณีที่อัปเดตไม่สำเร็จ คุณสามารถลองแก้ไขปัญหา แล้วเรียกใช้ update.sh อีกครั้ง คุณเรียกใช้การอัปเดตได้หลายครั้ง และการอัปเดตจะดำเนินการต่อจากจุดที่ค้างไว้

หากการอัปเดตล้มเหลวและคุณต้องย้อนกลับไปใช้เวอร์ชันก่อนหน้า โปรดดูวิธีการโดยละเอียดที่หัวข้อย้อนกลับไปใช้เวอร์ชัน 4.53.01

ข้อมูลการอัปเดตการบันทึก

โดยค่าเริ่มต้น ยูทิลิตี update.sh จะเขียนข้อมูลบันทึกลงในตำแหน่งต่อไปนี้

/opt/apigee/var/log/apigee-setup/update.log

หากผู้ที่เรียกใช้ยูทิลิตี update.sh ไม่มีสิทธิ์เข้าถึงไดเรกทอรีดังกล่าว ระบบจะเขียนบันทึกลงในไดเรกทอรี /tmp เป็นไฟล์ชื่อ update_username.log

หากบุคคลนั้นไม่มีสิทธิ์เข้าถึง /tmp ยูทิลิตี update.sh จะทำงานไม่สำเร็จ

การอัปเดตโดยไม่มีช่วงหยุดทำงาน

การอัปเดตแบบไม่มีช่วงพักหรือการอัปเดตแบบต่อเนื่องช่วยให้คุณอัปเดตการติดตั้ง Edge ได้โดยไม่ต้อง ปิด Edge

การอัปเดตโดยไม่มีการหยุดทำงานจะทำได้เฉพาะกับการกำหนดค่าแบบ 5 โหนดขึ้นไป

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

  1. อัปเดตเครื่องตามลำดับที่ถูกต้องสำหรับการติดตั้งตามที่อธิบายไว้ใน ลำดับการอัปเดตเครื่อง
  2. เมื่อถึงเวลาอัปเดตเราเตอร์ ให้เลือกเราเตอร์ใดก็ได้และทำให้เราเตอร์นั้นเข้าถึงไม่ได้ ตามที่อธิบายไว้ในการเปิด/ปิดการเข้าถึงเซิร์ฟเวอร์ (Message Processor/Router)
  3. อัปเดตเราเตอร์ที่เลือกและคอมโพเนนต์ Edge อื่นๆ ทั้งหมดในเครื่องเดียวกับเราเตอร์ การกำหนดค่า Edge ทั้งหมดจะแสดงเราเตอร์และตัวประมวลผลข้อความในโหนดเดียวกัน
  4. ทำให้เราเตอร์เข้าถึงได้อีกครั้ง
  5. ทำตามขั้นตอนที่ 2 ถึง 4 ซ้ำสำหรับเราเตอร์ที่เหลือ
  6. อัปเดตเครื่องที่เหลือในการติดตั้งต่อไป

โปรดดำเนินการต่อไปนี้ก่อนและหลังการอัปเดต

ใช้ไฟล์การกำหนดค่าแบบเงียบ

คุณต้องส่งไฟล์การกำหนดค่าแบบเงียบไปยังคำสั่งอัปเดต ไฟล์การกำหนดค่าแบบเงียบ ควรเป็นไฟล์เดียวกับที่คุณใช้ติดตั้ง Edge สำหรับ Private Cloud 4.52.02 หรือ 4.53.00

อัปเดตเป็น 4.53.01 ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก

ทําตามขั้นตอนต่อไปนี้เพื่ออัปเดตคอมโพเนนต์ Edge ในโหนด

  1. หากมี ให้ปิดใช้งานงาน cron ที่กำหนดค่าให้ดำเนินการซ่อมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง RPM ของ Edge
  3. ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้ง ยูทิลิตี apigee-setup ของ Edge
  4. หากคุณติดตั้งใน AWS ให้เรียกใช้ yum-configure-manager คำสั่งต่อไปนี้ 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  5. หากคุณใช้ Edge 4.52.02 หรือ 4.53.00 อยู่ในขณะนี้ ให้ทำดังนี้

    1. ดาวน์โหลดไฟล์ bootstrap_4.53.01.sh ของ Edge ไปยัง /tmp/bootstrap_4.53.01.sh 
      curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
    2. ติดตั้งยูทิลิตี apigee-service และทรัพยากร Dependency ของ Edge 4.53.01 โดย เรียกใช้คำสั่งต่อไปนี้ 
      sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณได้รับจาก Apigee หากคุณ ละเว้น pWord ระบบจะแจ้งให้คุณป้อน

      โดยค่าเริ่มต้น โปรแกรมติดตั้งจะตรวจสอบว่าคุณได้ติดตั้ง Java 1.8 แล้ว หากไม่มี โปรแกรมติดตั้งจะติดตั้งให้คุณ

      ใช้ตัวเลือก JAVA_FIX เพื่อระบุวิธีจัดการ การติดตั้ง Java JAVA_FIX มีค่าดังนี้

      • I: ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)
      • C: ดำเนินการต่อโดยไม่ต้องติดตั้ง Java
      • Q: ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
    3. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ดังที่ตัวอย่างต่อไปนี้แสดง 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. อัปเดตยูทิลิตี apigee-provision ในเซิร์ฟเวอร์การจัดการ ดังที่ตัวอย่างต่อไปนี้แสดง 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. เรียกใช้ยูทิลิตี update ในโหนดโดยการเรียกใช้คำสั่งต่อไปนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      ทำตามลำดับที่อธิบายไว้ในลำดับการอัปเดตเครื่อง

      สถานที่:

      • component คือคอมโพเนนต์ Edge ที่จะอัปเดต ค่าที่เป็นไปได้ ได้แก่
        • cs: Cassandra
        • edge: คอมโพเนนต์ Edge ทั้งหมด ยกเว้น UI ของ Edge ได้แก่ Management Server, Message Processor, Router, QPID Server, Postgres Server
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (หากคุณติดตั้ง SSO)
        • ue: UI ของ Edge ใหม่
        • ui: UI ของ Edge แบบคลาสสิก
        • zk: Zookeeper
      • configFile คือไฟล์การกำหนดค่าเดียวกันกับที่คุณใช้เพื่อ กำหนดคอมโพเนนต์ Edgeระหว่างการติดตั้ง 4.52.02 หรือ 4.53.00

      คุณสามารถเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "all" แต่จะทำได้ก็ต่อเมื่อคุณมีโปรไฟล์การติดตั้ง Edge แบบ All-in-One (AIO) เช่น

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในโหนดทั้งหมดที่เรียกใช้คอมโพเนนต์ดังกล่าว หากยังไม่ได้ดำเนินการ ให้ทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง

หากภายหลังตัดสินใจที่จะย้อนกลับการอัปเดต ให้ทำตามขั้นตอนที่อธิบายไว้ใน ย้อนกลับ 4.53.01

อัปเดตเป็น 4.53.01 จากที่เก็บในเครื่อง

หากโหนด Edge อยู่หลังไฟร์วอลล์ หรือถูกห้ามไม่ให้เข้าถึงที่เก็บ Apigee ผ่านอินเทอร์เน็ตด้วยวิธีอื่นๆ คุณสามารถอัปเดตจากที่เก็บในเครื่องหรือมิเรอร์ของที่เก็บ Apigee ได้

หลังจากสร้างที่เก็บ Edge ในเครื่องแล้ว คุณจะมี 2 ตัวเลือกในการอัปเดต Edge จากที่เก็บในเครื่อง

  • สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด แล้วอัปเดต Edge จากไฟล์ .tar
  • ติดตั้งเว็บเซิร์ฟเวอร์ในโหนดที่มีที่เก็บในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้คุณใช้ หรือจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้

วิธีอัปเดตจากที่เก็บ 4.53.01 ในเครื่อง

  1. สร้างที่เก็บ 4.53.01 ในเครื่องตามที่อธิบายไว้ใน "สร้างที่เก็บ Apigee ในเครื่อง" ที่ ติดตั้งยูทิลิตี apigee-setup ของ Edge
  2. หากต้องการติดตั้ง apigee-service จากไฟล์ .tar ให้ทำดังนี้
    1. ในโหนดที่มีที่เก็บในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บในเครื่อง เป็นไฟล์ .tar ไฟล์เดียวชื่อ /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
    3. ในโหนดใหม่ ให้คลายการบีบอัดไฟล์ไปยังไดเรกทอรี /tmp 
      tar -xzf apigee-4.53.01.tar.gz

      คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ repos ในไดเรกทอรีที่มีไฟล์ .tar เช่น /tmp/repos

    4. ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge apigee-service จาก /tmp/repos 
      sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      โปรดทราบว่าคุณต้องระบุเส้นทางไปยังไดเรกทอรี repos ในคำสั่งนี้

  3. วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
    1. กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากที่เก็บโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่ติดตั้งยูทิลิตี apigee-setup ของ Edge
    2. ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์ Edge bootstrap_4.53.01.sh ไปยัง /tmp/bootstrap_4.53.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

      โดย uName:pWord คือชื่อผู้ใช้และรหัสผ่านที่คุณตั้งไว้ก่อนหน้านี้สำหรับ ที่เก็บ และ remoteRepo คือที่อยู่ IP หรือชื่อ DNS ของโหนดที่เก็บ

    3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-setup ของ Edge และการอ้างอิง 
      sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านของที่เก็บ

  4. ใช้ apigee-service เพื่ออัปเดตยูทิลิตี apigee-setup ดังตัวอย่างต่อไปนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. อัปเดตยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการ ดังที่ตัวอย่างต่อไปนี้แสดง 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. อัปเดตยูทิลิตี apigee-provision ในเซิร์ฟเวอร์การจัดการ ดังที่ตัวอย่างต่อไปนี้แสดง 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. เรียกใช้ยูทิลิตี update ในโหนดตามลำดับที่อธิบายไว้ใน ลำดับการอัปเดตเครื่อง 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    สถานที่:

    • component คือคอมโพเนนต์ Edge ที่จะอัปเดต โดยปกติแล้ว คุณจะอัปเดต คอมโพเนนต์ต่อไปนี้
      • cs: Cassandra
      • edge: คอมโพเนนต์ Edge ทั้งหมด ยกเว้น UI ของ Edge: Management Server, Message Processor, Router, QPID Server, Postgres Server
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (หากคุณติดตั้ง SSO)
      • ue UI ของ Edge ใหม่
      • ui: UI ของ Edge แบบคลาสสิก
      • zk: Zookeeper
    • configFile คือไฟล์การกำหนดค่าเดียวกันกับที่คุณใช้เพื่อ กำหนดคอมโพเนนต์ Edge ระหว่างการติดตั้ง 4.52.02 หรือ 4.53.00

    คุณเรียกใช้ update.sh กับคอมโพเนนต์ทั้งหมดได้โดยตั้งค่า component เป็น "all" แต่จะทำได้ก็ต่อเมื่อคุณมีโปรไฟล์การติดตั้ง Edge แบบ All-in-One (AIO) เช่น

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. รีสตาร์ทคอมโพเนนต์ UI ในโหนดทั้งหมดที่เรียกใช้ หากยังไม่ได้ดำเนินการ 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี apigee-validate ในเซิร์ฟเวอร์การจัดการตามที่อธิบายไว้ในทดสอบการติดตั้ง

หากภายหลังตัดสินใจที่จะย้อนกลับการอัปเดต ให้ทำตามขั้นตอนที่อธิบายไว้ใน ย้อนกลับ 4.53.01

ลำดับการอัปเดตเครื่อง

ลำดับที่คุณอัปเดตเครื่องในการติดตั้ง Edge มีความสำคัญดังนี้

  • คุณต้องอัปเดตโหนด LDAP ทั้งหมดก่อนที่จะอัปเดตคอมโพเนนต์อื่นๆ คุณจะต้องทำตามขั้นตอนพิเศษเพื่ออัปเกรด LDAP
  • คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมด หากคุณอัปเกรดจาก 4.52.02 ให้ทำตามขั้นตอนพิเศษเพื่ออัปเกรด Cassandra คุณจะต้องทำตามขั้นตอนพิเศษเพื่ออัปเกรด Zookeeper สำหรับ 4.52.02 หรือ 4.53.00
  • คุณต้องอัปเกรดเซิร์ฟเวอร์การจัดการและเราเตอร์และตัวประมวลผลข้อความทั้งหมดโดยใช้ตัวเลือก -c edge เพื่ออัปเดต
  • คุณต้องอัปเกรดโหนด Postgres ทั้งหมดตามขั้นตอนพิเศษสำหรับอัปเกรด Postgres
  • คุณต้องอัปเดตคอมโพเนนต์ edge-qpid-server และ edge-postgres-server ในศูนย์ข้อมูลทั้งหมด
  • คุณต้องอัปเกรดโหนด Qpid ทั้งหมด
  • คุณต้องอัปเกรดโหนด Edge UI รวมถึงอัปเกรดโหนด New Edge UI และ SSO(หากมี)
  • ไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก -c edge

การอัปเกรดแบบสแตนด์อโลน 1 โหนด

วิธีอัปเกรดการกำหนดค่าแบบสแตนด์อโลน 1 โหนดเป็น 4.53.01

  1. อัปเดตคอมโพเนนต์ทั้งหมด 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

การอัปเกรดแบบสแตนด์อโลน 2 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สำหรับการติดตั้งแบบสแตนด์อโลน 2 โหนด

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต LDAP ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. อัปเดต Postgres ในเครื่อง 2 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. อัปเดต Qpid ในเครื่อง 2 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. อัปเดต UI ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  10. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในเครื่องที่ 1 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

อัปเดตคอมโพเนนต์ต่อไปนี้สำหรับการติดตั้ง 5 โหนด

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต LDAP ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1, 2, 3 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. อัปเดต Postgres ในเครื่อง 4 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. อัปเดต Postgres ในเครื่อง 5 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. อัปเดต Qpid ในเครื่อง 4 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. อัปเดต Qpid ในเครื่อง 5 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. อัปเดต UI ของ Edge โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้อัปเดตคอมโพเนนต์ ui ในเครื่อง 1 ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้อัปเดต ue ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่อง 1) 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  12. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 1 ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่อง 1) 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

การอัปเกรดแบบคลัสเตอร์ 9 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สำหรับการติดตั้งแบบคลัสเตอร์ 9 โหนด

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต LDAP ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1, 4 และ 5 (เซิร์ฟเวอร์การจัดการ, Message Processor, เราเตอร์) ตามลำดับ 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. อัปเดต Postgres ในเครื่อง 8 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. อัปเดต Postgres ในเครื่อง 9 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 8 และ 9 ตามลำดับ 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. อัปเดต Qpid ในเครื่อง 6 และ 7 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ในเครื่อง 1 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่อง 1 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  11. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 1 ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่อง 1) 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

การอัปเกรดแบบคลัสเตอร์ 13 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สำหรับการติดตั้งแบบคลัสเตอร์ 13 โหนด

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต LDAP ในเครื่อง 4 และ 5 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. อัปเดต Cassandra และ ZooKeeper ในเครื่อง 1, 2 และ 3 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 10 และ 11 ตามลำดับ 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. อัปเดต Postgres ในเครื่อง 8 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. อัปเดต Postgres ในเครื่อง 9 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 8 และ 9 ตามลำดับ 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. อัปเดต Qpid ในเครื่อง 12 และ 13 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ในเครื่อง 6 และ 7 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 6 และ 7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (หากคุณติดตั้ง Apigee SSO) ให้อัปเดต Apigee SSO ในเครื่องที่ 6 และ 7 โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  11. รีสตาร์ทคอมโพเนนต์ UI โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์ edge-ui ในเครื่อง 6 และ 7 ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่ 6 และ 7 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

การอัปเกรดคลัสเตอร์ 12 โหนด

อัปเดตคอมโพเนนต์ต่อไปนี้สำหรับการติดตั้งแบบคลัสเตอร์ 12 โหนด

ดูรายการโทโพโลยี Edge และหมายเลขโหนดได้ที่โทโพโลยีการติดตั้ง

  1. อัปเดต LDAP
    1. เครื่อง 1 ในศูนย์ข้อมูล 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. เครื่อง 7 ในศูนย์ข้อมูล 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. อัปเดต Cassandra และ ZooKeeper
    1. เครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2 ให้ทำดังนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. อัปเดตคอมโพเนนต์ Edge โดยทำดังนี้
    1. ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1 ให้ทำดังนี้ 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. อัปเดต Postgres
    1. เครื่อง 6 ในศูนย์ข้อมูล 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. เครื่อง 12 ในศูนย์ข้อมูล 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. อัปเดตคอมโพเนนต์ Edge โดยทำดังนี้
    1. เครื่อง 4, 5, 6 ในศูนย์ข้อมูล 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. เครื่อง 10, 11, 12 ในศูนย์ข้อมูล 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. อัปเดต qpidd:
    1. เครื่อง 4, 5 ในศูนย์ข้อมูล 1
      1. อัปเดต qpidd ในเครื่อง 4 ดังนี้ 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. อัปเดต qpidd ในเครื่อง 5 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. เครื่อง 10, 11 ในศูนย์ข้อมูล 2
      1. อัปเดต qpidd ในเครื่อง 10 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. อัปเดต qpidd ในเครื่อง 11 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) โดยทำดังนี้
    1. เครื่อง 1 ในศูนย์ข้อมูล 1 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. เครื่อง 7 ในศูนย์ข้อมูล 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi โดยทำดังนี้
    1. เครื่อง 1 ในศูนย์ข้อมูล 1 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. เครื่อง 7 ในศูนย์ข้อมูล 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO โดยทำดังนี้
    1. เครื่อง 1 ในศูนย์ข้อมูล 1 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. เครื่อง 7 ในศูนย์ข้อมูล 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. โดย sso_config_file คือไฟล์การกำหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO

  10. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ใหม่ (edge-management-ui) หรือ UI ของ Edge แบบคลาสสิก (edge-ui) ในเครื่อง 1 และ 7 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

สำหรับการกำหนดค่าที่ไม่เป็นไปตามมาตรฐาน

หากมีการกำหนดค่าที่ไม่เป็นไปตามมาตรฐาน ให้อัปเดตคอมโพเนนต์ของ Edge ตามลำดับต่อไปนี้

  1. LDAP
  2. Cassandra
  3. ผู้ดูแลสวนสัตว์
  4. เซิร์ฟเวอร์การจัดการ
  5. Message Processor
  6. เราเตอร์
  7. Postgres
  8. Edge หมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลำดับต่อไปนี้ โหนดที่มีเซิร์ฟเวอร์ Qpid เซิร์ฟเวอร์ Edge Postgres
  9. qpidd
  10. UI ของ Edge (แบบคลาสสิกหรือแบบใหม่)
  11. apigee-adminapi
  12. Apigee SSO

หลังจากอัปเดตเสร็จแล้ว ให้รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่องทั้งหมดที่เรียกใช้