อัปเดต Apigee Edge 4.51.00 หรือ 4.52.00 หรือ 4.52.01 เป็น 4.52.02

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

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

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

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

องค์ประกอบใดบ้างที่ต้องอัปเดต

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

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

ตรวจสอบว่าคุณมีคุณสมบัติตามข้อกำหนดเบื้องต้นต่อไปนี้ก่อนอัปเกรด Apigee Edge

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

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

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

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

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

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

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

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

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

อัปเกรดเป็น Zookeeper 3.8.3

Edge for Private Cloud 4.52.02 ไม่รวมการอัปเกรด Zookeeper อย่างไรก็ตาม หากคุณอัปเกรดจากเวอร์ชันที่เก่ากว่า 4.52.01 คุณจะต้องทำตามขั้นตอนการอัปเกรด Zookeeper ที่ระบุไว้ด้านล่าง

  • หากคุณอัปเกรดจาก Edge for Private Cloud เวอร์ชัน 4.51.00 หรือ 4.52.00 โปรดดูขั้นตอนในการอัปเกรดที่จำเป็นเป็น Zookeeper 3.8.3 เพื่ออัปเกรด Zookeeper
  • หากคุณอัปเกรดจาก Edge for Private Cloud เวอร์ชัน 4.52.01 คุณควรใช้ Zookeeper เวอร์ชัน 3.8.3 อยู่แล้ว และไม่จำเป็นต้องทำตามขั้นตอนพิเศษใดๆ ในการอัปเกรด Zookeeper

อัปเกรดเป็น Postgres 14

  • หากอัปเกรดจาก Edge for Private Cloud 4.51.00 เป็น 4.52.02 คุณต้องทำตามขั้นตอนเพื่ออัปเกรด Postgres แม้ว่า Edge for Private Cloud 4.52.02 จะไม่มีการอัปเกรด Postgres ก็ตาม การอัปเกรดจาก Edge สำหรับ Private Cloud 4.51.00 เป็น 4.52.02 ต้องใช้ขั้นตอนการอัปเกรด Postgres เพิ่มเติม โปรดดูส่วนการอัปเกรดที่จำเป็นเป็น Postgres 14
  • หากคุณอัปเกรดจาก Edge for Private Cloud 4.52.00 หรือ 4.52.01 เป็น 4.52.02 คุณไม่จำเป็นต้องดำเนินการอัปเกรด Postgres เพิ่มเติม

อัปเกรดเป็น Cassandra 3.11.16

Apigee Edge สำหรับ Private Cloud 4.52.02 มีการอัปเกรด Cassandra เป็นเวอร์ชัน 3.11.16 Cassandra เป็นคอมโพเนนต์ที่สำคัญของ Apigee และการอัปเกรดนี้ยังรวมถึงการอัปเดตซอฟต์แวร์ไดรเวอร์ในคอมโพเนนต์รันไทม์และการจัดการต่างๆ ที่ใช้ในการค้นหาและเขียนไปยัง Cassandra ด้วย

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

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

พอร์ทัลนักพัฒนาซอฟต์แวร์ - การจัดทำเอกสาร API

พอร์ทัลนักพัฒนาซอฟต์แวร์ Apigee Drupal มีฟีเจอร์ต่างๆ สำหรับการจัดทำเอกสาร API แม้ว่าเราจะแนะนำให้เปลี่ยนจากการใช้พอร์ทัลนักพัฒนาซอฟต์แวร์ที่ใช้ Drupal 7 แต่หากคุณยังคงใช้พอร์ทัลดังกล่าวและใช้ฟีเจอร์ SmartDocs เอกสารการใช้ SmartDocs API จะมีผลกับคุณ หากคุณใช้พอร์ทัลนักพัฒนาซอฟต์แวร์เวอร์ชันใหม่ การอัปเกรดนี้จะไม่ส่งผลกระทบต่อเอกสารประกอบ API ของคุณ

เมื่อคุณอัปเกรด Apigee เป็นเวอร์ชัน 4.52.02 ระบบจะไม่ย้ายข้อมูลโมเดล API ที่สร้างขึ้นโดยใช้ฟีเจอร์ SmartDocs ของพอร์ทัลนักพัฒนาซอฟต์แวร์ Drupal 7 ไปยังเวอร์ชันที่ใหม่กว่าโดยอัตโนมัติ คุณจะต้องส่งออกแต่ละโมเดลด้วยตนเองโดยใช้พอร์ทัลนักพัฒนาซอฟต์แวร์ แล้วนำเข้าอีกครั้งหลังจากอัปเกรดเสร็จสมบูรณ์

คำศัพท์ที่ใช้ด้านล่าง

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

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

ในระหว่างการอัปเกรดนี้ การรับส่งข้อมูลรันไทม์และการจัดการจะได้รับผลกระทบในภูมิภาคหรือศูนย์ข้อมูล (DC) ที่มีการอัปเดต ไม่ว่าศูนย์ข้อมูลใดจะได้รับการอัปเดต ก็จะส่งผลกระทบต่อ Management API บางรายการในศูนย์ข้อมูลทั้งหมด ผลกระทบนี้จะระบุไว้หลังแต่ละขั้นตอน

ในแต่ละขั้นตอนด้านล่าง สถานะของรันไทม์และการจัดการจะอธิบายไว้เมื่อคุณดำเนินการผ่านขั้นตอนต่างๆ ของกระบวนการอัปเกรด

กลยุทธ์การอัปเกรด

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

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

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

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

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

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

  • API รันไทม์ที่รีเฟรชโทเค็น OAuth
  • API รันไทม์ที่ใช้นโยบายเอนทิตีการเข้าถึง
  • Management API ที่แสดงแอปของนักพัฒนาแอป
  • Management API ที่แสดงผลิตภัณฑ์

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

การย้อนกลับ - ระดับสูง

  • ผลกระทบระหว่างการย้อนกลับ

    การย้อนกลับจาก Cassandra 3.11.x เป็น 2.1.x จะส่งผลต่อทั้งรันไทม์และการเข้าชมการจัดการภายในศูนย์ข้อมูล (DC) ที่มีการย้อนกลับ นอกจากนี้ Management API บางรายการอาจหยุดชะงักในศูนย์ข้อมูลทั้งหมด ไม่ว่า DC ใดจะกำลังย้อนกลับอยู่ก็ตาม

  • Follow DC by DC Rollback Approach

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

  • การย้อนกลับคลัสเตอร์ที่อัปเกรดบางส่วน

    หากศูนย์ข้อมูลอย่างน้อย 1 แห่งยังคงทำงานได้อย่างสมบูรณ์ใน Cassandra เวอร์ชันเก่า (2.1.22) คุณสามารถย้อนกลับ DC อื่นๆ ที่อัปเกรดแล้วได้โดยการสร้างใหม่จาก DC ของ Cassandra 2.1.X ที่ทำงานได้อย่างสมบูรณ์

  • การย้อนกลับทั้งคลัสเตอร์

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

  • ข้อควรพิจารณาก่อนอัปเกรด

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

คลัสเตอร์การย้อนกลับที่มีศูนย์ข้อมูลเดียว

การอัปเกรด Cassandra จากเวอร์ชัน 2.1.x เป็น 3.11.x อาจส่งผลต่อการเข้าชมรันไทม์และ Management API บางรายการอย่างมาก ผลกระทบเหล่านี้ยังเกิดขึ้นในระหว่างการย้อนกลับด้วย และอาจส่งผลให้เกิดช่วงเวลาที่ระบบหยุดทำงานหรือข้อมูลรั่วไหล

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

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

ย้อนกลับคลัสเตอร์ที่มีศูนย์ข้อมูลหลายแห่ง

การย้อนกลับศูนย์ข้อมูลหลายแห่งจะเป็นไปตามแนวทางแบบศูนย์ข้อมูลต่อศูนย์ข้อมูล (DC-by-DC) ในแนวทางนี้ การเข้าชมจากศูนย์ข้อมูลที่กำลังย้อนกลับจะเปลี่ยนเส้นทางไปยังศูนย์ข้อมูลที่ใช้งานได้อื่นๆ เพื่อให้มั่นใจว่ากระบวนการย้อนกลับที่มีการควบคุมและแยกต่างหากสำหรับโหนด Cassandra, Management Server และ Runtime เพื่อหลีกเลี่ยงการหยุดชะงักของการเข้าชม

ดูรายละเอียดได้ที่ส่วนย้อนกลับการอัปเดต Cassandra 3.11.16

ขั้นตอนที่ 0: สถานะเริ่มต้น

  • คอมโพเนนต์ Zookeeper, Postgres และ LDAP ได้รับการอัปเกรดเป็นเวอร์ชัน 4.52.02 แล้ว คลัสเตอร์ Edge for Private Cloud มีความเสถียรและทำงานได้ หากจำเป็นต้องย้อนกลับ ระบบจะย้อนกลับคลัสเตอร์ไปยังสถานะนี้
  • Cassandra ใน Apigee ทำงานด้วยเวอร์ชัน 2.1.22
  • องค์ประกอบ Edge
    • เซิร์ฟเวอร์การจัดการสื่อสารกับ Cassandra ผ่านโปรโตคอล Thrift ที่เก่ากว่า
    • เซิร์ฟเวอร์รันไทม์ (Message Processor และเราเตอร์) สื่อสารกับ Cassandra ผ่านโปรโตคอล Thrift เวอร์ชันเก่า
สถานะรันไทม์ในขั้นตอนนี้ สถานะการจัดการในขั้นตอนนี้
รันไทม์ทำงานได้อย่างสมบูรณ์ การจัดการทำงานได้อย่างสมบูรณ์

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

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

  1. เปลี่ยน Cassandra ให้ใช้ LeveledCompactionStrategy
  2. สำรองข้อมูล Cassandra โดยใช้ Apigee
  3. ถ่ายภาพสแนปชอต VM ของโหนด Cassandra (หากเป็นไปได้)
  4. สร้างไฟล์การกำหนดค่าการอัปเกรด Cassandra ในแต่ละโหนด Cassandra ที่ /opt/apigee/apigee-cassandra/cass_upgrade.conf โดยมีเนื้อหาต่อไปนี้
    # IP Address of node
    HOSTIP=10.0.0.1
    
    # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
    CASS_USERNAME=<cassuser>
    
    # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
    CASS_PASSWORD=<casspass>
    
    # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
    CASS_PORT=9160
    
    # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
    CASS_CQL_PORT=9042
    
    # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
    # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
    CASS_TMP_DIR=/tmp/cass_upgrade_scripts
        
    หากสร้างไฟล์ที่ /opt/apigee/apigee-cassandra/cass_upgrade.conf ไม่ได้ ให้สร้างไฟล์ /opt/silent.conf ที่มีเนื้อหาเดียวกันในโหนด Cassandra แต่ละโหนด
  5. หากคุณใช้ฟีเจอร์ SmartDocs ของพอร์ทัลนักพัฒนาซอฟต์แวร์ Apigee Drupal 7 ให้ส่งออกแต่ละโมเดลโดยดาวน์โหลดในรูปแบบ JSON จาก UI ของพอร์ทัลนักพัฒนาซอฟต์แวร์ คุณจะต้องนำเข้าโมเดลเหล่านี้กลับไปยัง Apigee หลังจากอัปเดตเซิร์ฟเวอร์การจัดการแล้ว
  6. ตรวจสอบว่าพอร์ต 9160 และ 9042 เข้าถึงได้จากคอมโพเนนต์ Edge ทั้งหมดไปยังโหนด Cassandra หากยังไม่มี ดูข้อมูลเพิ่มเติมได้ที่ข้อกำหนดของพอร์ต

ขั้นตอนที่ 2: เปลี่ยนเส้นทางการเข้าชมออกจากศูนย์ข้อมูลแรก

  1. บล็อกการเข้าชมรันไทม์และการจัดการที่เข้ามาจากศูนย์ข้อมูลแรก
  2. เปลี่ยนเส้นทางการรับส่งข้อมูลรันไทม์และ Management API ทั้งหมดไปยังศูนย์ข้อมูลอื่นๆ ที่ใช้งานได้
  3. ตรวจสอบว่า DC อื่นๆ จัดการรันไทม์และการเข้าชมการจัดการได้สำเร็จ

ขั้นตอนที่ 3: อัปเกรดโหนด Cassandra ทั้งหมดในศูนย์ข้อมูลแรก

  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
    โค้ดข้างต้นจะแสดงผลลัพธ์ในลักษณะต่อไปนี้
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. เรียกใช้คำสั่ง post_upgrade ต่อไปนี้ในโหนด Cassandra แต่ละโหนดทีละโหนดหลังจากการอัปเกรดเสร็จสมบูรณ์
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
สถานะรันไทม์ในขั้นตอนนี้ สถานะการจัดการในขั้นตอนนี้
  • การเข้าชมรันไทม์ถูกบล็อกในศูนย์ข้อมูลที่กำลังอัปเกรด
  • รันไทม์ทำงานได้อย่างสมบูรณ์ในศูนย์ข้อมูลอื่นๆ

ขั้นตอนที่ 4: อัปเกรดโหนดการจัดการทั้งหมดในศูนย์ข้อมูลแรก

อัปเกรดโหนดการจัดการทั้งหมดในศูนย์ข้อมูลโดยทำดังนี้

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
สถานะรันไทม์ในขั้นตอนนี้ สถานะการจัดการในขั้นตอนนี้
  • การเข้าชมรันไทม์ถูกบล็อกในศูนย์ข้อมูลที่กำลังอัปเกรด
  • รันไทม์ทำงานได้อย่างสมบูรณ์

ขั้นตอนที่ 5: อัปเกรดโหนดรันไทม์ทั้งหมดในศูนย์ข้อมูลแรก

อัปเกรดโหนดเราเตอร์และ Message Processor ทั้งหมดในศูนย์ข้อมูลทีละรายการ โดยทำดังนี้

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
สถานะรันไทม์ในขั้นตอนนี้ สถานะการจัดการในขั้นตอนนี้
  • การเข้าชมรันไทม์ถูกบล็อกในศูนย์ข้อมูลที่กำลังอัปเกรด
  • รันไทม์ทำงานได้อย่างสมบูรณ์ในศูนย์ข้อมูลอื่นๆ

ขั้นตอนที่ 6: เปลี่ยนเส้นทางการรับส่งข้อมูลกลับไปยังศูนย์ข้อมูลแรก

  • เมื่ออัปเกรดศูนย์ข้อมูลแรกด้วย Cassandra, คอมโพเนนต์รันไทม์ และเซิร์ฟเวอร์การจัดการแล้ว ให้เปิดใช้การรับส่งข้อมูลรันไทม์และการจัดการไปยังศูนย์ข้อมูลแรกอีกครั้ง
  • ตรวจสอบว่าการเข้าชมรันไทม์และการจัดการประสบความสำเร็จใน DC

ขั้นตอนที่ 7: อัปเกรดศูนย์ข้อมูลอื่นๆ

ทำซ้ำขั้นตอนที่ 1 ถึงขั้นตอนที่ 6 ในศูนย์ข้อมูลที่เหลือทีละรายการโดยเปลี่ยนเส้นทางการรับส่งข้อมูลออกจากศูนย์ข้อมูลดังกล่าว อัปเดตซอฟต์แวร์ Apigee และเปิดใช้การรับส่งข้อมูลในศูนย์ข้อมูลดังกล่าวอีกครั้ง

ขั้นตอนที่ 8: เรียกใช้ขั้นตอนการอัปเกรดอีกครั้งในโหนดการจัดการทั้งหมด

เรียกใช้คำสั่งอัปเกรดต่อไปนี้อีกครั้งในโหนดการจัดการทั้งหมดในศูนย์ข้อมูล

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

ขั้นตอนที่ 9 - [ไม่บังคับ] นำเข้าเอกสารอัจฉริยะที่ส่งออกก่อนหน้านี้

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

คุณต้องดำเนินการนี้เฉพาะในกรณีที่ใช้พอร์ทัลนักพัฒนาซอฟต์แวร์ที่ใช้ Drupal 7 และใช้ฟีเจอร์ SmartDocs

สถานะรันไทม์ในขั้นตอนนี้ สถานะการจัดการในขั้นตอนนี้
รันไทม์ทำงานได้อย่างสมบูรณ์ การจัดการทำงานได้อย่างสมบูรณ์

ขั้นตอนที่ 10 - ทิ้งตารางที่ไม่ได้ใช้

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

ขั้นตอนที่ 11 - อัปเกรด Edge และคอมโพเนนต์อื่นๆ ที่เหลือทั้งหมดสำหรับ Private Cloud 4.52.02

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

ในขั้นตอนนี้ หากคุณอัปเกรดจากเวอร์ชันที่เก่ากว่า Edge for Private Cloud 4.52.01 ตามด้านล่าง ให้ทำตามขั้นตอนเพิ่มเติมเพื่ออัปเกรด Qpid และ Postgres ตามลำดับ และอัปเกรดคอมโพเนนต์ที่เหลือตามขั้นตอนเหล่านี้

อัปเกรดเป็น Qpid J-Broker

แม้ว่า Edge for Private Cloud 4.52.02 จะไม่มีการอัปเกรดเป็น Qpid แต่หากคุณอัปเกรดจากเวอร์ชันที่เก่ากว่า 4.52.01 คุณจะต้องทำตามขั้นตอนเพื่ออัปเกรด QPID

  • หากคุณอัปเกรดจาก Edge for Private Cloud 4.51.00 หรือ 4.52.00 เป็น 4.52.02 คุณจะต้องทำตามขั้นตอนการอัปเกรด Qpid เพิ่มเติม โปรดดูส่วนอัปเกรด Qpid หากคุณอัปเกรดจากเวอร์ชัน 4.51.00 หรือ 4.52.00 เป็น 4.52.02
  • หากคุณอัปเกรดจาก Edge for Private Cloud 4.52.01 เป็น 4.52.02 คุณควรใช้ Qpid Broker เวอร์ชันล่าสุดอยู่แล้ว และไม่จำเป็นต้องทำตามขั้นตอนการอัปเกรด Qpid เพิ่มเติม

UI ใหม่ของ Edge

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

ติดตั้ง Edge UI

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

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

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

อัปเดต Edge UI

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

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

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

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

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

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

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

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

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

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

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

การอัปเดตโดยไม่มีช่วงพัก

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

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

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

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

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

ใช้ไฟล์การกำหนดค่าการติดตั้งแบบอัตโนมัติโดยเบ็ดเสร็จ

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

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

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

  1. หากมี ให้ปิดใช้ cron งานที่กำหนดค่าให้ดำเนินการซ่อมแซมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง Edge RPM
  3. ติดตั้ง yum-utils และ yum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. ปิดใช้ SELinux ตามที่อธิบายไว้ในหัวข้อติดตั้งยูทิลิตี apigee-setup ของ Edge
  5. หากติดตั้งใน Oracle 7.x ให้เรียกใช้คำสั่งต่อไปนี้
    sudo yum-config-manager --enable ol7_optional_latest
  6. หากติดตั้งใน 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
  7. หากคุณใช้ Edge 4.51.00 อยู่ในปัจจุบัน ให้ทำดังนี้

    1. ดาวน์โหลดไฟล์ Edge bootstrap_4.52.02.sh ไปยัง /tmp/bootstrap_4.52.02.sh โดยทำดังนี้
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. ติดตั้งยูทิลิตีและทรัพยากร Dependency ของ Edge 4.52.02 apigee-service โดยเรียกใช้คำสั่งต่อไปนี้
      sudo bash /tmp/bootstrap_4.52.02.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 ทั้งหมดยกเว้น Edge UI: 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: ผู้ดูแลสัตว์
      • configFile เป็นไฟล์การกำหนดค่าเดียวกับที่คุณใช้กำหนดคอมโพเนนต์ Edge ระหว่างการติดตั้ง 4.50.00 หรือ 4.51.00

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    3. ติดตั้งยูทิลิตี Edge apigee-setup และทรัพยากร Dependency ในโหนดระยะไกล โดยทำดังนี้
      sudo bash /tmp/bootstrap_4.52.02.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 ทั้งหมด ยกเว้น Edge UI: 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: ผู้ดูแลสัตว์
    • configFile เป็นไฟล์การกำหนดค่าเดียวกับที่คุณใช้กำหนดคอมโพเนนต์ Edge ระหว่างการติดตั้ง 4.50.00 หรือ 4.51.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.52.02

ลำดับการอัปเดตเครื่อง - อัปเกรดจาก 4.51.00 (หรือ) 4.52.00 (หรือ) 4.52.01

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

  • คุณต้องอัปเดตโหนด ZooKeeper ทั้งหมดในศูนย์ข้อมูลก่อนที่จะอัปเกรดคอมโพเนนต์อื่นๆ ทั้งหมด หากอัปเกรดจาก Edge Private Cloud 4.51.00 (หรือ) 4.52.00 คุณจะต้องทำตามขั้นตอนเพิ่มเติมเพื่ออัปเกรด Zookeeper ด้วย
  • คุณต้องอัปเดต Postgresql ในศูนย์ข้อมูลทั้งหมด หากอัปเกรดจาก Edge Private Cloud 4.51.00 คุณจะต้องทำตามขั้นตอนเพิ่มเติมเพื่ออัปเกรด postgres ด้วย
  • คุณต้องอัปเดตโหนด LDAP ในศูนย์ข้อมูลทั้งหมด
  • คุณต้องอัปเดตโหนด Cassandra, Management Server, Message Processor และ Router ทั้งหมดทีละศูนย์ข้อมูลจนกว่าจะอัปเกรดศูนย์ข้อมูลทั้งหมด
  • คุณต้องอัปเดตคอมโพเนนต์ edge-qpid-server และ edge-postgres-server ในศูนย์ข้อมูลทั้งหมด
  • คุณต้องอัปเกรดโหนด Qpid ในศูนย์ข้อมูลทั้งหมด หากอัปเกรดจาก Edge Private Cloud 4.51.00 (หรือ) 4.52.00 คุณจะต้องทำตามขั้นตอนเพิ่มเติมเพื่ออัปเกรด Qpid ด้วย
  • อัปเดต Edge UI และ Edge UI ใหม่, โหนด SSO ในศูนย์ข้อมูลทั้งหมด
  • ไม่มีขั้นตอนแยกต่างหากในการอัปเดตการสร้างรายได้ โดยจะอัปเดตเมื่อคุณระบุตัวเลือก -c edge

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

วิธีอัปเกรดการกำหนดค่าแบบสแตนด์อโลน 1 โหนดเป็น 4.52.02
  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. อัปเดต Zookeeper ในเครื่องที่ 1 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. อัปเดต Postgres ในเครื่องที่ 2 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต LDAP ในเครื่องที่ 1 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. อัปเดต Cassandra ในเครื่องที่ 1 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1 และ 2 โดยทำดังนี้
    /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. รีสตาร์ทคอมโพเนนต์ Edge UI ในเครื่อง 1 โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

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

  1. อัปเดต ZooKeeper ในเครื่อง 1, 2 และ 3 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. อัปเดต Postgres ในเครื่อง 4 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต Postgres ในเครื่อง 5 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. อัปเดต LDAP ในเครื่องที่ 1 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดต Cassandra ในเครื่อง 1, 2 และ 3 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1, 2, 3, 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. อัปเดต Edge UI โดยทำดังนี้
    • UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้อัปเดตคอมโพเนนต์ ui ในเครื่อง 1 ดังตัวอย่างต่อไปนี้
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Edge UI ใหม่: หากคุณติดตั้ง Edge UI ใหม่ ให้อัปเดตคอมโพเนนต์ 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
    • Edge UI ใหม่: หากคุณติดตั้ง Edge UI ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่อง 1) ดังนี้
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. อัปเดต ZooKeeper ในเครื่อง 1, 2 และ 3 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. อัปเดต Postgres ในเครื่อง 8 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต Postgres ในเครื่อง 9 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. อัปเดต LDAP ในเครื่องที่ 1 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดต Cassandra ในเครื่อง 1, 2 และ 3 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 1, 4, 5, 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
    • Edge UI ใหม่: หากคุณติดตั้ง Edge UI ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่องที่เหมาะสม (อาจไม่ใช่เครื่อง 1) ดังนี้
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. อัปเดต ZooKeeper ในเครื่อง 1, 2 และ 3 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. อัปเดต Postgres ในเครื่อง 8 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต Postgres ในเครื่อง 9 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. อัปเดต LDAP ในเครื่อง 4 และ 5 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. อัปเดต Cassandra ในเครื่อง 1, 2 และ 3 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 10, 11, 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
    • Edge UI ใหม่: หากคุณติดตั้ง Edge UI ใหม่ ให้รีสตาร์ทคอมโพเนนต์ edge-management-ui ในเครื่อง 6 และ 7 โดยทำดังนี้
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. อัปเดต ZooKeeper ในเครื่อง 1,2,3,7,8,9 ใน DC ทั้ง 2 แห่ง โดยทำดังนี้

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. อัปเดต Postgres ในเครื่อง 6,12 ใน DC ทั้ง 2 แห่ง
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. อัปเดต LDAP ในเครื่อง 1,7 ใน DC ทั้ง 2 แห่ง
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. บล็อกการเข้าชมใน DC-1 และตรวจสอบว่าการเข้าชมทั้งหมดเปลี่ยนเส้นทางไปยัง DC-2 อื่นๆ

  5. อัปเดต Cassandra ในเครื่อง 1,2,3 ใน DC-1 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. อัปเดต Management Server ในเครื่อง 1 ใน DC-1:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. อัปเดตเราเตอร์, Message Processor ในเครื่อง 2,3 ใน DC-1:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. เลิกบล็อกการเข้าชมใน DC-1 และตรวจสอบ DC-1 จากนั้นดำเนินการกับ DC-2 โดยบล็อกการเข้าชมใน DC-2 และเปลี่ยนเส้นทางการเข้าชมไปยัง DC-1
  9. อัปเดต Cassandra ในเครื่อง 7,8,9 ใน DC-2:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. อัปเดตเซิร์ฟเวอร์การจัดการในเครื่อง 7 ใน DC-2 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. อัปเดตเราเตอร์, Message Processor ในเครื่อง 8,9 ใน DC-2:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. เลิกบล็อกการเข้าชมใน DC-2 และตอนนี้ DC ทั้ง 2 แห่งจะจัดการการเข้าชม
  13. เรียกใช้คำสั่งอัปเดตอีกครั้งในเซิร์ฟเวอร์การจัดการทั้งหมดใน DC บนเครื่อง 1 และ 7 โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. อัปเดต edge-qpid-server และ edge-postgres-server ในเครื่อง 4,5,6,10,11,12 ใน DC ทั้ง 2 แห่ง โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. อัปเดต Qpid ในเครื่อง 4,5,10,11 ใน DC ทั้ง 2 แห่ง โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ใน DC ทั้ง 2 แห่ง ดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (หากคุณติดตั้ง apigee-adminapi) อัปเดต apigee-adminapi ใน DC ทั้ง 2 แห่งโดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (หากคุณติดตั้ง Apigee SSO) อัปเดตโหนด Apigee SSO ใน DC ทั้ง 2 แห่ง โดยทำดังนี้
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. รีสตาร์ทคอมโพเนนต์ Edge UI ใหม่ (edge-management-ui) หรือ Edge UI แบบคลาสสิก (edge-ui) ใน DC ทั้ง 2 รายการ โดยทำดังนี้
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart