อัปเดต Apigee Edge 4.52.02 เป็น 4.53.00

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

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

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

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

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

คอมโพเนนต์ที่ต้องอัปเดต

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

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

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

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

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

• ตรวจสอบว่า Edge ทำงานอยู่
  ตรวจสอบว่า Edge ทำงานอยู่ในระหว่างกระบวนการอัปเดตโดยใช้คำสั่งต่อไปนี้

  /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

การนำไปใช้งานการตั้งค่าที่พักโดยอัตโนมัติ

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

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

Apigee Edge สําหรับ Private Cloud 4.53.00 มีการอัปเกรด Cassandra เป็นเวอร์ชัน 4.0.13

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

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

การทำ Rollback เป็นกระบวนการที่มี 2 จุดตรวจสอบ

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

ตัวอย่าง

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

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
• กลยุทธ์การบีบอัดตั้งค่าเป็น LeveledCompactionStrategy (ข้อกําหนดเบื้องต้นในการอัปเกรดเป็นเวอร์ชัน 4.52.02)
• ขั้นตอนหลังการอัปเกรดทั้งหมดจากการอัปเกรดครั้งแรกเป็น Cassandra 3.11.16 ซึ่งเป็นส่วนหนึ่งของการอัปเกรด 4.52.02 เสร็จสมบูรณ์แล้ว หากไม่ ให้ทำตามขั้นตอนเหล่านี้อีกครั้ง ซึ่งจะมีผลเฉพาะในกรณีที่คุณอัปเกรดเป็น Private Cloud เวอร์ชัน 4.52.02 จากเวอร์ชันเก่า

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

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

1. สำรองข้อมูล Cassandra โดยใช้ Apigee
2. ถ่ายภาพหน้าจอ VM ของโหนด Cassandra (หากเป็นไปได้)
3. ตรวจสอบว่าพอร์ต 9042 เข้าถึงได้จากคอมโพเนนต์ Edge for Private Cloud ทั้งหมด ซึ่งรวมถึงเซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ Qpid และ Postgres ไปยังโหนด 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.13 | CQL spec 3.4.5 | Native protocol v5] 
   Metadata is verified

ขั้นตอนที่ 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.00 ที่เหลือทั้งหมด

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

ขั้นตอนที่ 6: ขั้นตอนหลังการอัปเกรด

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

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

ใน Edge for Private Cloud 4.53.00 ตอนนี้ระบบจะกำหนดค่าคีย์และใบรับรอง IDP ที่ใช้ในคอมโพเนนต์ apigee-sso ผ่านคีย์สโตร์ คุณจะต้องส่งออกคีย์และใบรับรองที่ใช้ก่อนหน้านี้ไปยังคีย์สโตร์ กำหนดค่า แล้วดำเนินการอัปเดต 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.ก.
      • 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

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

3. เปลี่ยนเจ้าของไฟล์คีย์สโตร์เอาต์พุตเป็นผู้ใช้ "apigee" โดยทำดังนี้

   sudo chown apigee:apigee <keystore_file>

4. เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ใน ไฟล์การกําหนดค่า SSO ของ Apigee และอัปเดตด้วยเส้นทางไฟล์คีย์สโตร์ รหัสผ่าน ประเภทคีย์สโตร์ และอีเมลแทน

   # 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. อัปเดตซอฟต์แวร์ SSO ของ Apigee ในโหนด SSO ตามปกติโดยใช้คําสั่งต่อไปนี้

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

UI ของ Edge เวอร์ชันใหม่

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

ติดตั้ง UI ของ Edge

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

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

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

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

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

• ถอนการติดตั้ง mTLS ของ Apigee
• ติดตั้ง mTLS ของ Apigee อีกครั้ง

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

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

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

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

• ในโหนดเราเตอร์และโปรแกรมประมวลผลข้อความแบบรวม
  • ก่อนอัปเดต ให้ทำดังนี้
    1. ทำให้เข้าถึงเราเตอร์ไม่ได้
    2. ทำให้เข้าถึง Message Processor ไม่ได้
  • หลังจากอัปเดตแล้ว ให้ทำดังนี้
    1. ทำให้ Message Processor เข้าถึงได้
    2. ทำให้เข้าถึงเราเตอร์ได้
• ในโหนดเราเตอร์เดียว ให้ทำดังนี้
  • ก่อนอัปเดต ให้ทำให้เราเตอร์เข้าถึงไม่ได้
  • หลังจากอัปเดตแล้ว ให้ทำให้เราเตอร์เข้าถึงได้
• ในโหนด Message Processor รายการเดียว ให้ทำดังนี้
  • ก่อนอัปเดต ให้ทำให้ไม่สามารถเข้าถึงโปรแกรมประมวลผลข้อความได้
  • หลังจากอัปเดตแล้ว ให้ทำให้โปรแกรมประมวลผลข้อความเข้าถึงได้

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

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

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

ใช้ขั้นตอนต่อไปนี้เพื่ออัปเดตคอมโพเนนต์ 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 อยู่ ให้ทำดังนี้

   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. ติดตั้งยูทิลิตีและรายการที่เกี่ยวข้องของ apigee-service Edge 4.53.00 โดยดำเนินการตามคำสั่งต่อไปนี้

      sudo bash /tmp/bootstrap_4.53.00.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: เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (หากคุณติดตั้ง SSO)
        • ue: UI ของ Edge เวอร์ชันใหม่
        • ui: UI ของ Edge แบบคลาสสิก
        • zk: Zookeeper
      • configFile คือไฟล์การกําหนดค่าเดียวกับที่คุณใช้กําหนดคอมโพเนนต์ Edge ในระหว่างการติดตั้ง 4.52.02

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

      /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.00

อัปเดตเป็น 4.53.00 จากที่เก็บข้อมูลในเครื่อง

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

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

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

วิธีอัปเดตจากที่เก็บข้อมูล 4.53.00 ในพื้นที่

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

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี /tmp ในโหนดใหม่
   3. ในโหนดใหม่ ให้แตกไฟล์ไปยังไดเรกทอรี /tmp โดยทำดังนี้

      tar -xzf apigee-4.53.00.tar.gz

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

   4. ติดตั้งยูทิลิตี apigee-service ของ Edge และไลบรารีต่อไปนี้จาก /tmp/repos

      sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

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

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

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

   3. ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี apigee-setup ของ Edge และข้อกําหนดต่อไปนี้

      sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

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: เซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ เซิร์ฟเวอร์ 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" แต่ต้องมีโปรไฟล์การติดตั้งแบบ "All-in-One" (AIO) ของ Edge เท่านั้น เช่น

   /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.00

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

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

• คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนอัปเดตโหนดอื่นๆ
• สำหรับเครื่องที่มีคอมโพเนนต์ Edge หลายรายการ (เซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ เซิร์ฟเวอร์ QPID แต่ไม่ใช่เซิร์ฟเวอร์ Postgres) ให้ใช้ตัวเลือก -c edge เพื่ออัปเดตทั้งหมดพร้อมกัน
• หากขั้นตอนหนึ่งระบุว่าควรดำเนินการในหลายเครื่อง ให้ดำเนินการตามลำดับเครื่องที่ระบุ
• คุณไม่จำเป็นต้องอัปเดตการสร้างรายได้แยกต่างหาก ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก -c edge

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

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

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. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1

   /opt/apigee/apigee-setup/bin/update.sh -c cs,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. อัปเดตคอมโพเนนต์ Edge ในเครื่องที่ 2 และ 1

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

5. อัปเดต Qpid ในเครื่องที่ 2

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

6. อัปเดต UI ในเครื่องที่ 1 โดยทำดังนี้

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

7. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 1 โดยทำดังนี้

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

9. รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในเครื่องที่ 1 โดยทำดังนี้

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

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

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

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

1. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3

   /opt/apigee/apigee-setup/bin/update.sh -c cs,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. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5, 1, 2, 3

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

6. อัปเดต Qpid ในเครื่องที่ 4

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

7. อัปเดต Qpid ในเครื่อง 5

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

8. อัปเดต 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

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

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

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

ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง

1. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3

   /opt/apigee/apigee-setup/bin/update.sh -c cs,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. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 8, 9, 1, 4 และ 5 ตามลำดับดังนี้

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

6. อัปเดต Qpid ในเครื่อง 6 และ 7

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

7. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ในเครื่องที่ 1 โดยทำดังนี้

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -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 โดยทำดังนี้
    • 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. อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3

   /opt/apigee/apigee-setup/bin/update.sh -c cs,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. อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 8, 9, 6, 7, 10 และ 11 ตามลำดับ

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

6. อัปเดต Qpid ในเครื่อง 12 และ 13

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

7. อัปเดต UI ใหม่ (ue) หรือ UI แบบคลาสสิก (ui) ในเครื่องที่ 6 และ 7 โดยทำดังนี้

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. (หากคุณติดตั้ง apigee-adminapi) อัปเดตยูทิลิตี apigee-adminapi ในเครื่องที่ 6 และ 7

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 6 และ 7 โดยทำดังนี้

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

10. รีสตาร์ทคอมโพเนนต์ 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. อัปเดต 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

2. อัปเดต 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

3. อัปเดต 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

4. อัปเดตคอมโพเนนต์ Edge โดยทำดังนี้
   1. เครื่อง 4, 5, 6, 1, 2, 3 ในศูนย์ข้อมูล 1

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

   2. เครื่อง 10, 11, 12, 7, 8, 9 ในศูนย์ข้อมูล 2

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

5. อัปเดต 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

6. อัปเดต 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

7. (หากคุณติดตั้ง 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

8. (หากคุณติดตั้ง 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

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

9. รีสตาร์ทคอมโพเนนต์ 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. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. Edge ซึ่งหมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลําดับคือโหนดที่มีเซิร์ฟเวอร์ Qpid, เซิร์ฟเวอร์ Edge Postgres, เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ และเราเตอร์
6. qpidd
7. UI ของ Edge (แบบคลาสสิกหรือแบบใหม่)
8. apigee-adminapi
9. SSO ของ Apigee

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