อัปเดต 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 ในตอนแรก หรือผู้ที่เรียกใช้ในฐานะรูท

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

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

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

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

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

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

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

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

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

หากต้องการอัปเกรดเป็น Edge สำหรับ 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 สำหรับ 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 สำหรับ 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 เพื่อให้มั่นใจว่าเวอร์ชันใหม่ๆ จะมีประสิทธิภาพสูงสุด แม้ว่าการเปลี่ยนแปลงเหล่านี้จะน้อยมาก แต่กระบวนการอัปเกรดจะขัดขวาง API การจัดการบางอย่างเมื่อเริ่มการอัปเกรด โดย API การจัดการที่มักจะถูกขัดขวางจะแสดงอยู่ในส่วนที่เกี่ยวข้องด้านล่าง

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

พอร์ทัลนักพัฒนาแอป - การจัดทำเอกสาร API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • ทำตามแนวทางการย้อนกลับแบบ DC ต่อ DC

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • เราได้อัปเกรดคอมโพเนนต์ Zookeeper, Postgres และ LDAP เป็นเวอร์ชัน 4.52.02 แล้ว Edge สำหรับคลัสเตอร์ Private Cloud มีความเสถียรและใช้งานได้ หากต้องย้อนกลับ ระบบจะย้อนกลับคลัสเตอร์ไปยังสถานะนี้
  • Cassandra ใน Apigee ที่ทำงานด้วยเวอร์ชัน 2.1.22
  • คอมโพเนนต์ Edge
    • เซิร์ฟเวอร์การจัดการสื่อสารกับ Cassandra ผ่านโปรโตคอล Thrift เวอร์ชันเก่า
    • เซิร์ฟเวอร์รันไทม์ (Message Processor และ Router) สื่อสารกับ 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. ตรวจสอบว่าคอมโพเนนต์ Edge ทั้งหมดเข้าถึงพอร์ต 9160 และ 9042 ในโหนด Cassandra ได้ หากยังไม่มี ดูข้อมูลเพิ่มเติมได้ที่ ข้อกำหนดเกี่ยวกับพอร์ต

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

  1. บล็อกการรับส่งข้อมูลรันไทม์และการจัดการขาเข้าจากศูนย์ข้อมูลแรก
  2. เปลี่ยนเส้นทางการรับส่งข้อมูลรันไทม์และ 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 - [ไม่บังคับ] นำเข้า Smart Docs ที่ส่งออกไว้ก่อนหน้านี้

เมื่ออัปเกรดเซิร์ฟเวอร์การจัดการทั้งหมดแล้ว คุณจะนำเข้าโมเดลเอกสารอัจฉริยะที่ส่งออกในขั้นตอนที่ 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 สำหรับ 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 เวอร์ชันล่าสุดอยู่แล้ว และไม่จำเป็นต้องทำตามขั้นตอน Qpidupgrade เพิ่มเติม

UI ของ Edge ใหม่

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

ติดตั้ง Edge UI

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

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

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

อัปเดต UI ของ Edge

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

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

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

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

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

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

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

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

  1. หากมี ให้ปิดใช้งานงาน cron ที่กำหนดค่าให้ดำเนินการซ่อมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์
  2. เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง RPM ของ Edge
  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. ดาวน์โหลดไฟล์ 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.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 ทั้งหมด ยกเว้น 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.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. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในโหนดทั้งหมดที่เรียกใช้คอมโพเนนต์ดังกล่าว หากยังไม่ได้ดำเนินการ 
      /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. ในโหนดใหม่ ให้แตกไฟล์ไปยังไดเรกทอรี /tmp 
      tar -xzf apigee-4.52.02.tar.gz

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

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

      โปรดทราบว่าคุณต้องระบุเส้นทางไปยังไดเรกทอรี 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. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-setup ของ Edge และการอ้างอิง 
      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 ทั้งหมด ยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ, Message Processor, Router, เซิร์ฟเวอร์ Qpid, เซิร์ฟเวอร์ Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (หากคุณติดตั้ง SSO)
      • ue UI ของ Edge ใหม่
      • ui: UI ของ Edge แบบคลาสสิก
      • zk: Zookeeper
    • 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 ด้วย
  • อัปเดต UI ของ Edge และ UI ของ Edge ใหม่ รวมถึงโหนด 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. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในเครื่องที่ 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. อัปเดต 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. อัปเดต 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
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ 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
    • UI ของ Edge ใหม่: หากคุณติดตั้ง UI ของ Edge ใหม่ ให้รีสตาร์ทคอมโพเนนต์ 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 ในทั้ง 2 DC

    /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 ในทั้ง 2 DC 
    /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. อัปเดตเซิร์ฟเวอร์การจัดการในเครื่อง 1 ใน DC-1 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. อัปเดตเราเตอร์และตัวประมวลผลข้อความในเครื่อง 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. อัปเดตเราเตอร์และตัวประมวลผลข้อความในเครื่อง 8, 9 ใน DC-2 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. เลิกบล็อกการรับส่งข้อมูลใน DC-2 และตอนนี้ทั้ง 2 DC จะจัดการการรับส่งข้อมูล
  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 ในทั้ง 2 DC ดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. อัปเดต Qpid ในเครื่อง 4,5,10,11 ในทั้ง 2 DC 
    /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 ในทั้ง 2 DC ดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (หากติดตั้ง Apigee SSO) ให้อัปเดตโหนด Apigee SSO ในทั้ง 2 DC ดังนี้ 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ใหม่ (edge-management-ui) หรือ UI ของ Edge แบบคลาสสิก (edge-ui) ใน DC ทั้ง 2 รายการ 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart