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 ต่อไป
วิธีการอัปเกรดที่แนะนำ
- อัปเกรดศูนย์ข้อมูล Cassandra ทีละแห่ง: เริ่มต้นด้วยการอัปเกรดโหนด Cassandra ทีละโหนดภายในศูนย์ข้อมูลเดียว อัปเกรดโหนด Cassandra ทั้งหมดในศูนย์ข้อมูลหนึ่งให้เสร็จสิ้นก่อนดำเนินการกับศูนย์ข้อมูลถัดไป
- หยุดชั่วคราวและตรวจสอบ: หลังจากอัปเกรดศูนย์ข้อมูล 1 แห่งแล้ว ให้หยุดชั่วคราวเพื่อตรวจสอบว่าคลัสเตอร์ระบบคลาวด์ส่วนตัวของคุณ โดยเฉพาะศูนย์ข้อมูลที่อัปเกรดแล้ว ทำงานได้อย่างถูกต้อง
- โปรดทราบว่า คุณจะย้อนกลับไปยัง Cassandra เวอร์ชันก่อนหน้าได้ก็ต่อเมื่อมีศูนย์ข้อมูลอย่างน้อย 1 แห่งที่ยังคงใช้เวอร์ชันเก่าอยู่
- มีเวลาจำกัด: แม้ว่าคุณจะหยุดชั่วคราวได้ในระยะสั้น (แนะนำให้หยุด 2-3 ชั่วโมง) เพื่อตรวจสอบฟังก์ชันการทำงาน แต่คุณไม่สามารถอยู่ในสถานะเวอร์ชันผสมได้ตลอด เนื่องจากคลัสเตอร์ Cassandra ที่ไม่เหมือนกัน (มีโหนดในเวอร์ชันต่างๆ) มีข้อจํากัดด้านการดำเนินการ
- การทดสอบอย่างละเอียด: Apigee ขอแนะนําอย่างยิ่งให้ทดสอบประสิทธิภาพและฟังก์ชันการทํางานอย่างครอบคลุมก่อนอัปเกรดศูนย์ข้อมูลถัดไป เมื่ออัปเกรดศูนย์ข้อมูลทั้งหมดแล้ว คุณจะย้อนกลับไปใช้เวอร์ชันก่อนหน้าไม่ได้
การทำ Rollback เป็นกระบวนการที่มี 2 จุดตรวจสอบ
- จุดตรวจ 1: สถานะเริ่มต้นที่มีคอมโพเนนต์ทั้งหมดเป็นเวอร์ชัน 4.52.02 คุณย้อนกลับได้ทั้งหมดตราบใดที่มีศูนย์ข้อมูล Cassandra อย่างน้อย 1 แห่งที่ใช้เวอร์ชันเก่าอยู่
- จุดตรวจสอบ 2: หลังจากอัปเดตโหนด Cassandra ทั้งหมดในศูนย์ข้อมูลทั้งหมดแล้ว คุณสามารถย้อนกลับไปยังสถานะนี้ได้ แต่จะเปลี่ยนกลับไปที่จุดตรวจสอบ 1 ไม่ได้
ตัวอย่าง
ลองพิจารณาคลัสเตอร์ศูนย์ข้อมูล (DC) 2 แห่ง ดังนี้
- สถานะเริ่มต้น: โหนด Cassandra ในทั้ง 2 DC เป็นเวอร์ชัน 3.11.X โหนดอื่นๆ ทั้งหมดใช้ Edge สำหรับ Private Cloud เวอร์ชัน 4.52.02 สมมติว่าโหนด Cassandra 3 โหนดต่อ DC
- อัปเกรด DC-1: อัปเกรดโหนด Cassandra 3 โหนดใน DC-1 ทีละโหนด
- หยุดชั่วคราวและตรวจสอบ: หยุดชั่วคราวเพื่อให้แน่ใจว่าคลัสเตอร์ โดยเฉพาะ DC-1 ทํางานอย่างถูกต้อง (ตรวจสอบประสิทธิภาพ ฟังก์ชันการทํางาน) คุณย้อนกลับเป็นสถานะเริ่มต้นได้โดยใช้โหนด Cassandra ใน DC-2 โปรดทราบว่าการหยุดชั่วคราวนี้จะต้องเป็นแบบชั่วคราวเนื่องจากข้อจํากัดของคลัสเตอร์ Cassandra แบบหลายเวอร์ชัน
- อัปเกรด DC-2: อัปเกรดโหนด Cassandra ที่เหลือ 3 โหนดใน DC-2 ซึ่งจะเป็นจุดตรวจสอบการย้อนกลับใหม่
- อัปเกรดคอมโพเนนต์อื่นๆ: อัปเกรดโหนดการจัดการ รันไทม์ และข้อมูลวิเคราะห์ตามปกติในศูนย์ข้อมูลทั้งหมด โดยอัปเกรดทีละโหนดและทีละศูนย์ข้อมูล หากเกิดปัญหาขึ้น คุณสามารถย้อนกลับไปยังสถานะของขั้นตอนที่ 4 ได้
ข้อกําหนดเบื้องต้นสําหรับการอัปเกรด Cassandra
คุณควรใช้ Cassandra 3.11.16 กับ Edge for Private Cloud 4.52.02 และตรวจสอบสิ่งต่อไปนี้- คลัสเตอร์ทั้งหมดทํางานได้และใช้งานได้อย่างเต็มรูปแบบกับ Cassandra 3.11.16
- กลยุทธ์การบีบอัดตั้งค่าเป็น
LeveledCompactionStrategy
(ข้อกําหนดเบื้องต้นในการอัปเกรดเป็นเวอร์ชัน 4.52.02) - ขั้นตอนหลังการอัปเกรดทั้งหมดจากการอัปเกรดครั้งแรกเป็น Cassandra 3.11.16 ซึ่งเป็นส่วนหนึ่งของการอัปเกรด 4.52.02 เสร็จสมบูรณ์แล้ว หากไม่ ให้ทำตามขั้นตอนเหล่านี้อีกครั้ง ซึ่งจะมีผลเฉพาะในกรณีที่คุณอัปเกรดเป็น Private Cloud เวอร์ชัน 4.52.02 จากเวอร์ชันเก่า
ขั้นตอนที่ 1: เตรียมพร้อมสำหรับการอัปเกรด
ขั้นตอนด้านล่างนี้นอกเหนือจากไฟล์มาตรฐานที่คุณสร้างโดยทั่วไป เช่น ไฟล์การกําหนดค่ามาตรฐานของ Apigee เพื่อเปิดใช้การอัปเกรดคอมโพเนนต์
- สำรองข้อมูล Cassandra โดยใช้ Apigee
- ถ่ายภาพหน้าจอ VM ของโหนด Cassandra (หากเป็นไปได้)
- ตรวจสอบว่าพอร์ต 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
-
หากต้องการอัปเกรดโหนด Cassandra ให้เรียกใช้คำสั่งต่อไปนี้
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
-
เมื่ออัปเดตโหนดแล้ว ให้เรียกใช้คําสั่งต่อไปนี้ในโหนดเพื่อเรียกใช้การตรวจสอบบางอย่างก่อนดําเนินการต่อ
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
-
คำสั่งข้างต้นจะแสดงผลลัพธ์ประมาณนี้
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 ต่อตามปกติ
-
ระบุคีย์และใบรับรองที่มีอยู่ซึ่งใช้สำหรับกำหนดค่า IDP โดยทำดังนี้
-
เรียกข้อมูลใบรับรองโดยค้นหาค่า 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
-
เรียกข้อมูลคีย์โดยค้นหาค่าของ 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
-
-
ส่งออกคีย์และใบรับรองไปยังคีย์สโตร์ ดังนี้
-
ส่งออกคีย์และใบรับรองไปยังคีย์สโตร์ PKCS12 โดยทำดังนี้
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
พารามิเตอร์ ได้แก่
certificate_path
: เส้นทางไปยังไฟล์ใบรับรองที่ดึงข้อมูลในขั้นตอนที่ 1.ก.key_path
: เส้นทางไปยังไฟล์คีย์ส่วนตัวที่ดึงข้อมูลในขั้นตอนที่ 1.bkeystore_path
: เส้นทางไปยังคีย์สโตร์ที่สร้างขึ้นใหม่ซึ่งมีใบรับรองและคีย์ส่วนตัวalias
: ชื่อแทนที่ใช้สำหรับคู่คีย์และใบรับรองภายในคีย์สโตร์
ดูรายละเอียดเพิ่มเติมในเอกสารประกอบ OpenSSL
-
(ไม่บังคับ) ส่งออกคีย์และใบรับรองจาก 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
-
ส่งออกคีย์และใบรับรองไปยังคีย์สโตร์ PKCS12 โดยทำดังนี้
- เปลี่ยนเจ้าของไฟล์คีย์สโตร์เอาต์พุตเป็นผู้ใช้ "apigee" โดยทำดังนี้
sudo chown apigee:apigee <keystore_file>
-
เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ใน ไฟล์การกําหนดค่า 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
-
อัปเดตซอฟต์แวร์ 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 ให้ทําตามขั้นตอนต่อไปนี้
การย้อนกลับการอัปเดต
ในกรณีที่อัปเดตไม่สำเร็จ คุณสามารถลองแก้ไขปัญหา แล้วเรียกใช้ 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 โหนดขึ้นไป
เคล็ดลับในการอัปเกรดแบบไม่มีเวลาหยุดทำงานคือการนำเราเตอร์แต่ละตัวออกจากโหลดบาลานเซอร์ทีละตัว จากนั้นอัปเดตเราเตอร์และคอมโพเนนต์อื่นๆ ในเครื่องเดียวกับเราเตอร์ แล้วเพิ่มเราเตอร์กลับไปยังตัวจัดสรรภาระงาน
- อัปเดตเครื่องตามลำดับที่ถูกต้องสำหรับการติดตั้งตามที่อธิบายไว้ลำดับการอัปเดตเครื่อง
- เมื่อถึงเวลาอัปเดตเราเตอร์ ให้เลือกเราเตอร์เครื่องใดเครื่องหนึ่งและทำให้เข้าถึงไม่ได้ ตามที่อธิบายไว้ในการเปิด/ปิดการเข้าถึงเซิร์ฟเวอร์ (Message Processor/Router)
- อัปเดตเราเตอร์ที่เลือกและคอมโพเนนต์ Edge อื่นๆ ทั้งหมดในเครื่องเดียวกับเราเตอร์ การกําหนดค่า Edge ทั้งหมดจะแสดงเราเตอร์และโปรแกรมประมวลผลข้อความในโหนดเดียวกัน
- ทำให้เราเตอร์เข้าถึงได้อีกครั้ง
- ทำตามขั้นตอนที่ 2 ถึง 4 ซ้ำสำหรับเราเตอร์ที่เหลือ
- อัปเดตเครื่องที่เหลือในการติดตั้งต่อ
โปรดดำเนินการต่อไปนี้ก่อนและหลังการอัปเดต
- ในโหนดเราเตอร์และโปรแกรมประมวลผลข้อความแบบรวม
- ก่อนอัปเดต ให้ทำดังนี้
- ทำให้เข้าถึงเราเตอร์ไม่ได้
- ทำให้เข้าถึง Message Processor ไม่ได้
- หลังจากอัปเดตแล้ว ให้ทำดังนี้
- ทำให้ Message Processor เข้าถึงได้
- ทำให้เข้าถึงเราเตอร์ได้
- ก่อนอัปเดต ให้ทำดังนี้
- ในโหนดเราเตอร์เดียว ให้ทำดังนี้
- ก่อนอัปเดต ให้ทำให้เราเตอร์เข้าถึงไม่ได้
- หลังจากอัปเดตแล้ว ให้ทำให้เราเตอร์เข้าถึงได้
- ในโหนด Message Processor รายการเดียว ให้ทำดังนี้
- ก่อนอัปเดต ให้ทำให้ไม่สามารถเข้าถึงโปรแกรมประมวลผลข้อความได้
- หลังจากอัปเดตแล้ว ให้ทำให้โปรแกรมประมวลผลข้อความเข้าถึงได้
ใช้ไฟล์การกําหนดค่าแบบเงียบ
คุณต้องส่งไฟล์การกําหนดค่าแบบเงียบไปยังคําสั่งอัปเดต ไฟล์การกําหนดค่าแบบเงียบควรเป็นไฟล์เดียวกับที่คุณใช้ติดตั้ง Edge for Private Cloud 4.52.02
อัปเดตเป็น 4.53.00 ในโหนดที่มีการเชื่อมต่ออินเทอร์เน็ตภายนอก
ใช้ขั้นตอนต่อไปนี้เพื่ออัปเดตคอมโพเนนต์ Edge ในโหนด
- หากมี ให้ปิดใช้งานงาน
cron
ที่กําหนดค่าให้ดําเนินการซ่อมใน Cassandra จนกว่าการอัปเดตจะเสร็จสมบูรณ์ - เข้าสู่ระบบโหนดในฐานะรูทเพื่อติดตั้ง RPM ของ Edge
- ปิดใช้ SELinux ตามที่อธิบายไว้ในติดตั้งยูทิลิตี apigee-setup ของ Edge
- หากติดตั้งใน 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
-
หากคุณใช้ Edge 4.52.02 อยู่ ให้ทำดังนี้
- ดาวน์โหลดไฟล์
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
- ติดตั้งยูทิลิตีและรายการที่เกี่ยวข้องของ
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
เพื่อระบุวิธีจัดการการติดตั้ง JavaJAVA_FIX
จะใช้ค่าต่อไปนี้I
: ติดตั้ง OpenJDK 1.8 (ค่าเริ่มต้น)C
: ดำเนินการต่อโดยไม่ติดตั้ง JavaQ
: ออก สำหรับตัวเลือกนี้ คุณต้องติดตั้ง Java ด้วยตนเอง
- ใช้
apigee-service
เพื่ออัปเดตยูทิลิตีapigee-setup
ดังที่แสดงในตัวอย่างต่อไปนี้/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- อัปเดตยูทิลิตี
apigee-validate
ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- อัปเดตยูทิลิตี
apigee-provision
ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- เรียกใช้ยูทิลิตี
update
ในโหนดโดยดำเนินการตามคำสั่งต่อไปนี้/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
โดยทําตามลําดับที่อธิบายไว้ในลําดับการอัปเดตเครื่อง
สถานที่:
- component คือคอมโพเนนต์ Edge ที่จะอัปเดต ค่าที่เป็นไปได้ ได้แก่
cs
: Cassandraedge
: คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ, เราเตอร์, เซิร์ฟเวอร์ QPID, เซิร์ฟเวอร์ Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: 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
- component คือคอมโพเนนต์ Edge ที่จะอัปเดต ค่าที่เป็นไปได้ ได้แก่
- รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในโหนดทั้งหมดที่ใช้คอมโพเนนต์ดังกล่าว หากยังไม่ได้ดำเนินการ
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี
apigee-validate
ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในทดสอบการติดตั้ง
- ดาวน์โหลดไฟล์
หากในภายหลังคุณตัดสินใจที่จะเปลี่ยนกลับการอัปเดต ให้ทำตามขั้นตอนที่อธิบายไว้ในเปลี่ยนกลับเป็น 4.53.00
อัปเดตเป็น 4.53.00 จากที่เก็บข้อมูลในเครื่อง
หากโหนด Edge อยู่หลังไฟร์วอลล์ หรือถูกห้ามไม่ให้เข้าถึงที่เก็บ Apigee ผ่านอินเทอร์เน็ตด้วยวิธีอื่น คุณจะอัปเดตจากที่เก็บข้อมูลในเครื่องหรือมิเรอร์ของที่เก็บ Apigee ได้
หลังจากสร้างที่เก็บข้อมูล Edge ในพื้นที่แล้ว คุณจะมี 2 ตัวเลือกในการอัปเดต Edge จากที่เก็บข้อมูลในเครื่อง ดังนี้
- สร้างไฟล์ .tar ของที่เก็บ คัดลอกไฟล์ .tar ไปยังโหนด แล้วอัปเดต Edge จากไฟล์ .tar
- ติดตั้งเว็บเซิร์ฟเวอร์บนโหนดที่มีที่เก็บข้อมูลในเครื่องเพื่อให้โหนดอื่นๆ เข้าถึงได้ Apigee มีเว็บเซิร์ฟเวอร์ Nginx ให้ใช้งาน หรือคุณจะใช้เว็บเซิร์ฟเวอร์ของคุณเองก็ได้
วิธีอัปเดตจากที่เก็บข้อมูล 4.53.00 ในพื้นที่
- สร้างที่เก็บข้อมูล 4.53.00 ในพื้นที่ตามที่อธิบายไว้ใน "สร้างที่เก็บข้อมูล Apigee ในพื้นที่" ที่ ติดตั้งยูทิลิตี apigee-setup ของ Edge
- วิธีติดตั้ง apigee-service จากไฟล์ .tar
- ในโหนดที่มีที่เก็บข้อมูลในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บข้อมูลในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ
/opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- คัดลอกไฟล์ .tar ไปยังโหนดที่ต้องการอัปเดต Edge เช่น คัดลอกไปยังไดเรกทอรี
/tmp
ในโหนดใหม่ - ในโหนดใหม่ ให้แตกไฟล์ไปยังไดเรกทอรี
/tmp
โดยทำดังนี้tar -xzf apigee-4.53.00.tar.gz
คำสั่งนี้จะสร้างไดเรกทอรีใหม่ชื่อ
repos
ในไดเรกทอรีที่มีไฟล์ .tar เช่น/tmp/repos
- ติดตั้งยูทิลิตี
apigee-service
ของ Edge และไลบรารีต่อไปนี้จาก/tmp/repos
sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
โปรดทราบว่าคุณใส่เส้นทางไปยังไดเรกทอรี repos ในคําสั่งนี้
- ในโหนดที่มีที่เก็บข้อมูลในเครื่อง ให้ใช้คำสั่งต่อไปนี้เพื่อจัดแพ็กเกจที่เก็บข้อมูลในเครื่องเป็นไฟล์ .tar ไฟล์เดียวชื่อ
- วิธีติดตั้ง apigee-service โดยใช้เว็บเซิร์ฟเวอร์ Nginx
- กำหนดค่าเว็บเซิร์ฟเวอร์ Nginx ตามที่อธิบายไว้ใน "ติดตั้งจากรีโปโดยใช้เว็บเซิร์ฟเวอร์ Nginx" ที่หัวข้อติดตั้งยูทิลิตี apigee-setup
- ในโหนดระยะไกล ให้ดาวน์โหลดไฟล์
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 ของโหนดที่เก็บ
- ในโหนดระยะไกล ให้ติดตั้งยูทิลิตี
apigee-setup
ของ Edge และข้อกําหนดต่อไปนี้sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
โดยที่ uName:pWord คือชื่อผู้ใช้และรหัสผ่านของ repo
- ใช้
apigee-service
เพื่ออัปเดตยูทิลิตีapigee-setup
ดังที่แสดงในตัวอย่างต่อไปนี้/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- อัปเดตยูทิลิตี
apigee-validate
ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- อัปเดตยูทิลิตี
apigee-provision
ในเซิร์ฟเวอร์การจัดการ ดังที่แสดงในตัวอย่างต่อไปนี้/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- เรียกใช้ยูทิลิตี
update
ในโหนดตามลำดับที่อธิบายไว้ในลำดับการอัปเดตเครื่อง/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
สถานที่:
- component คือคอมโพเนนต์ Edge ที่จะอัปเดต โดยทั่วไปแล้ว คุณจะต้องอัปเดตคอมโพเนนต์ต่อไปนี้
cs
: Cassandraedge
: คอมโพเนนต์ Edge ทั้งหมดยกเว้น UI ของ Edge: เซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ เซิร์ฟเวอร์ QPID เซิร์ฟเวอร์ Postgresldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: 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
- component คือคอมโพเนนต์ Edge ที่จะอัปเดต โดยทั่วไปแล้ว คุณจะต้องอัปเดตคอมโพเนนต์ต่อไปนี้
- รีสตาร์ทคอมโพเนนต์ UI ในโหนดทั้งหมดที่ใช้อยู่ หากยังไม่ได้ดำเนินการ
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- ทดสอบการอัปเดตโดยเรียกใช้ยูทิลิตี
apigee-validate
ในเซิร์ฟเวอร์การจัดการ ตามที่อธิบายไว้ในทดสอบการติดตั้ง
หากในภายหลังคุณตัดสินใจที่จะเปลี่ยนกลับการอัปเดต ให้ทำตามขั้นตอนที่อธิบายไว้ในเปลี่ยนกลับเป็น 4.53.00
ลำดับการอัปเดตเครื่อง
ลำดับที่คุณอัปเดตเครื่องในการติดตั้ง Edge มีความสำคัญ ดังนี้
- คุณต้องอัปเดตโหนด Cassandra และ ZooKeeper ทั้งหมดก่อนอัปเดตโหนดอื่นๆ
- สำหรับเครื่องที่มีคอมโพเนนต์ Edge หลายรายการ (เซิร์ฟเวอร์การจัดการ เครื่องประมวลผลข้อความ รูทเตอร์ เซิร์ฟเวอร์ QPID แต่ไม่ใช่เซิร์ฟเวอร์ Postgres) ให้ใช้ตัวเลือก
-c edge
เพื่ออัปเดตทั้งหมดพร้อมกัน - หากขั้นตอนหนึ่งระบุว่าควรดำเนินการในหลายเครื่อง ให้ดำเนินการตามลำดับเครื่องที่ระบุ
- คุณไม่จำเป็นต้องอัปเดตการสร้างรายได้แยกต่างหาก ระบบจะอัปเดตเมื่อคุณระบุตัวเลือก
-c edge
การอัปเกรดแบบสแตนด์อโลน 1 โหนด
วิธีอัปเกรดการกำหนดค่าแบบสแตนด์อโลน 1 โ nod เป็น 4.53.00
- อัปเดตคอมโพเนนต์ทั้งหมด
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (หากคุณติดตั้ง
apigee-adminapi
) อัปเดตยูทิลิตีapigee-adminapi
โดยทำดังนี้/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
การอัปเกรดแบบสแตนด์อโลน 2 โหนด
อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งแบบสแตนด์อโลน 2 โหนด
ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง
- อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- อัปเดต Postgres ในเครื่องที่ 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- อัปเดต LDAP ในเครื่องที่ 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- อัปเดตคอมโพเนนต์ Edge ในเครื่องที่ 2 และ 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- อัปเดต Qpid ในเครื่องที่ 2
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต UI ในเครื่องที่ 1 โดยทำดังนี้
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (หากคุณติดตั้ง
apigee-adminapi
) อัปเดตยูทิลิตีapigee-adminapi
ในเครื่องที่ 1 โดยทำดังนี้/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
- รีสตาร์ทคอมโพเนนต์ UI ของ Edge ในเครื่องที่ 1 โดยทำดังนี้
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
การอัปเกรด 5 โหนด
อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้ง 5 โ nod
ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง
- อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- อัปเดต Postgres ในเครื่องที่ 4
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- อัปเดต Postgres ในเครื่อง 5
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- อัปเดต LDAP ในเครื่องที่ 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- อัปเดตคอมโพเนนต์ Edge ในเครื่อง 4, 5, 1, 2, 3
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- อัปเดต Qpid ในเครื่องที่ 4
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต Qpid ในเครื่อง 5
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต 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
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้อัปเดตคอมโพเนนต์
- (หากคุณติดตั้ง
apigee-adminapi
) อัปเดตยูทิลิตีapigee-adminapi
ในเครื่องที่ 1 โดยทำดังนี้/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
- รีสตาร์ทคอมโพเนนต์ 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
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์
การอัปเกรดคลัสเตอร์ 9 โหนด
อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 9 นอต
ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง
- อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- อัปเดต Postgres ในเครื่อง 8
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- อัปเดต Postgres ในเครื่อง 9
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- อัปเดต LDAP ในเครื่องที่ 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- อัปเดตคอมโพเนนต์ Edge ในเครื่อง 6, 7, 8, 9, 1, 4 และ 5 ตามลำดับดังนี้
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- อัปเดต Qpid ในเครื่อง 6 และ 7
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต UI ใหม่ (
ue
) หรือ UI แบบคลาสสิก (ui
) ในเครื่องที่ 1 โดยทำดังนี้/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (หากคุณติดตั้ง
apigee-adminapi
) อัปเดตยูทิลิตีapigee-adminapi
ในเครื่องที่ 1 โดยทำดังนี้/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 1 โดยทำดังนี้
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
- รีสตาร์ทคอมโพเนนต์ 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
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์
การอัปเกรดคลัสเตอร์ 13 โหนด
อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 13 นอต
ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง
- อัปเดต Cassandra และ ZooKeeper ในเครื่องที่ 1, 2 และ 3
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- อัปเดต Postgres ในเครื่อง 8
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- อัปเดต Postgres ในเครื่อง 9
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- อัปเดต LDAP ในเครื่องที่ 4 และ 5 โดยทำดังนี้
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- อัปเดตคอมโพเนนต์ Edge ในเครื่อง 12, 13, 8, 9, 6, 7, 10 และ 11 ตามลำดับ
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- อัปเดต Qpid ในเครื่อง 12 และ 13
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต UI ใหม่ (
ue
) หรือ UI แบบคลาสสิก (ui
) ในเครื่องที่ 6 และ 7 โดยทำดังนี้/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (หากคุณติดตั้ง
apigee-adminapi
) อัปเดตยูทิลิตีapigee-adminapi
ในเครื่องที่ 6 และ 7/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO ในเครื่องที่ 6 และ 7 โดยทำดังนี้
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
- รีสตาร์ทคอมโพเนนต์ 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
- UI แบบคลาสสิก: หากคุณใช้ UI แบบคลาสสิก ให้รีสตาร์ทคอมโพเนนต์
การอัปเกรดคลัสเตอร์ 12 โหนด
อัปเดตคอมโพเนนต์ต่อไปนี้สําหรับการติดตั้งคลัสเตอร์ 12 โหนด
ดูรายการโทโพโลยี Edge และจำนวนโหนดได้ที่โทโพโลยีการติดตั้ง
- อัปเดต Cassandra และ ZooKeeper โดยทำดังนี้
- ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- ในเครื่อง 7, 8 และ 9 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- ในเครื่อง 1, 2 และ 3 ในศูนย์ข้อมูล 1
- อัปเดต Postgres
- เครื่อง 6 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- เครื่อง 12 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- เครื่อง 6 ในศูนย์ข้อมูล 1
- อัปเดต LDAP
- เครื่อง 1 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- เครื่อง 7 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- เครื่อง 1 ในศูนย์ข้อมูล 1
- อัปเดตคอมโพเนนต์ Edge โดยทำดังนี้
- เครื่อง 4, 5, 6, 1, 2, 3 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- เครื่อง 10, 11, 12, 7, 8, 9 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- เครื่อง 4, 5, 6, 1, 2, 3 ในศูนย์ข้อมูล 1
- อัปเดต qpidd
- เครื่อง 4, 5 ในศูนย์ข้อมูล 1
- อัปเดต
qpidd
ในเครื่อง 4/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต
qpidd
ในเครื่อง 5/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต
- เครื่อง 10, 11 ในศูนย์ข้อมูล 2
- อัปเดต
qpidd
ในเครื่อง 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต
qpidd
ในเครื่อง 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- อัปเดต
- เครื่อง 4, 5 ในศูนย์ข้อมูล 1
- อัปเดต UI ใหม่ (
ue
) หรือ UI แบบคลาสสิก (ui
) โดยทำดังนี้- เครื่อง 1 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- เครื่อง 7 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- เครื่อง 1 ในศูนย์ข้อมูล 1
- (หากคุณติดตั้ง
apigee-adminapi
) อัปเดตยูทิลิตีapigee-adminapi
โดยทำดังนี้- เครื่อง 1 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- เครื่อง 7 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- เครื่อง 1 ในศูนย์ข้อมูล 1
- (หากคุณติดตั้ง Apigee SSO) อัปเดต Apigee SSO โดยทำดังนี้
- เครื่อง 1 ในศูนย์ข้อมูล 1
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- เครื่อง 7 ในศูนย์ข้อมูล 2
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
โดยที่ sso_config_file คือไฟล์การกําหนดค่าที่คุณสร้างขึ้นเมื่อติดตั้ง SSO
- เครื่อง 1 ในศูนย์ข้อมูล 1
- รีสตาร์ทคอมโพเนนต์ 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 ตามลำดับต่อไปนี้
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge ซึ่งหมายถึงโปรไฟล์ "-c edge" ในโหนดทั้งหมดตามลําดับคือโหนดที่มีเซิร์ฟเวอร์ Qpid, เซิร์ฟเวอร์ Edge Postgres, เซิร์ฟเวอร์การจัดการ, โปรแกรมประมวลผลข้อความ และเราเตอร์
- qpidd
- UI ของ Edge (แบบคลาสสิกหรือแบบใหม่)
apigee-adminapi
- SSO ของ Apigee
หลังจากอัปเดตเสร็จแล้ว อย่าลืมรีสตาร์ทคอมโพเนนต์ UI ของ Edge ในเครื่องทั้งหมดที่ใช้คอมโพเนนต์ดังกล่าว