ย้อนกลับ Apigee Edge 4.52.02

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

คุณย้อนกลับ Edge 4.52.02 ไปยังเวอร์ชันหลักต่อไปนี้ได้

  • เวอร์ชัน 4.52.01
  • เวอร์ชัน 4.52.00
  • เวอร์ชัน 4.51.00

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

ย้อนกลับเป็นเวอร์ชัน สิ่งที่ควรพิจารณาเป็นพิเศษสำหรับซอฟต์แวร์
4.52.01 Cassandra
4.52.00 Zookeeper, Cassandra, Qpid
4.51.00 Zookeeper, Postgres, Cassandra, Qpid

คุณอาจต้องดำเนินการย้อนกลับใน 2 สถานการณ์ต่อไปนี้

  1. เปลี่ยนกลับไปใช้รุ่นหลักหรือรุ่นย่อยก่อนหน้า เช่น จาก 4.52.02 เป็น 4.52.00
  2. เปลี่ยนกลับไปใช้แพตช์รุ่นก่อนหน้าในรุ่นเดียวกัน เช่น จาก 4.52.00.02 เป็น 4.52.00.01

ดูข้อมูลเพิ่มเติมได้ที่กระบวนการเผยแพร่ Apigee Edge

ลำดับของการย้อนกลับ

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

ลำดับทั่วไปของการย้อนกลับสำหรับ Private Cloud 4.52.02 จะมีลักษณะดังนี้

ศูนย์ข้อมูลแห่งเดียว

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

  1. เปลี่ยน Qpid และคอมโพเนนต์อื่นๆ ที่เกี่ยวข้องกับการวิเคราะห์กลับ
  2. ย้อนกลับเราเตอร์และ Message Processor
  3. ย้อนกลับ Cassandra
  4. เซิร์ฟเวอร์การจัดการการย้อนกลับ
  5. เปลี่ยนกลับ Postgres และ Zookeeper

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

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

  1. เปลี่ยน Qpid และคอมโพเนนต์อื่นๆ ที่เกี่ยวข้องกับการวิเคราะห์กลับใน DC ทั้งหมด
  2. บล็อกการเข้าชมในศูนย์ข้อมูลแห่งแรกและเปลี่ยนเส้นทางการเข้าชมไปยังศูนย์ข้อมูลอื่นๆ
  3. เปลี่ยนเส้นทางเราเตอร์และโปรแกรมประมวลผลข้อความในศูนย์ข้อมูลแห่งแรกกลับ
  4. เปลี่ยนกลับ Cassandra ในศูนย์ข้อมูลแห่งแรก
  5. เซิร์ฟเวอร์การจัดการการย้อนกลับในศูนย์ข้อมูลแห่งแรก
  6. เลิกบล็อกการรับส่งข้อมูลในศูนย์ข้อมูลแห่งแรก แล้วทำตามขั้นตอนที่ 2 ถึง 6 จนกว่าศูนย์ข้อมูลแห่งสุดท้ายจะรีเซ็ตโหนดรันไทม์, Cassandra และเซิร์ฟเวอร์การจัดการ
  7. เปลี่ยนกลับ Postgres, Zookeeper และ LDAP ใน DC ทั้งหมด

ตัวอย่างที่เข้าใจง่ายคือสมมติว่าคุณได้อัปเกรดคลัสเตอร์ Cassandra ทั้งหมด, เซิร์ฟเวอร์การจัดการทั้งหมด และตัวประมวลผลข้อความรันไทม์ (RMP) 2-3 ตัวจากเวอร์ชัน 4.52.01 เป็น 4.52.02 และจำเป็นต้องทำการย้อนกลับ ในกรณีนี้ คุณควรดำเนินการย้อนกลับดังนี้

  1. บล็อกการรับส่งข้อมูลไปยังศูนย์ข้อมูลแห่งแรก (ศูนย์ข้อมูล) และเปลี่ยนเส้นทางการรับส่งข้อมูลไปยังศูนย์ข้อมูลที่ใช้งานอยู่แห่งอื่นเพื่อให้บริการทำงานอย่างต่อเนื่อง
  2. เปลี่ยนเส้นทางเราเตอร์และโปรแกรมประมวลผลข้อความในศูนย์ข้อมูลแห่งแรก
  3. เปลี่ยนกลับ Cassandra ในศูนย์ข้อมูลแห่งแรกโดยการกู้คืนจากข้อมูลสํารองหรือสแนปชอต VM
  4. เปลี่ยนเซิร์ฟเวอร์การจัดการกลับในศูนย์ข้อมูลแห่งแรก
  5. เลิกบล็อกการเข้าชมไปยังศูนย์ข้อมูลแห่งแรก
  6. ทำซ้ำขั้นตอนที่ 1 ถึง 5 สำหรับแต่ละศูนย์ข้อมูลที่เหลือจนกว่าระบบจะเปลี่ยนกลับโหนดรันไทม์, Cassandra และเซิร์ฟเวอร์การจัดการทั้งหมด

ผู้ที่สามารถดำเนินการย้อนกลับ

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

โดยค่าเริ่มต้น คอมโพเนนต์ Edge จะทํางานในฐานะผู้ใช้ "apigee" ในบางกรณี คุณอาจใช้งานคอมโพเนนต์ Edge ในฐานะผู้ใช้คนละราย เช่น หากเราเตอร์ต้องเข้าถึงพอร์ตที่มีสิทธิ์ เช่น พอร์ตที่ต่ำกว่า 1,000 คุณจะต้องเรียกใช้เราเตอร์ในฐานะรูทหรือในฐานะผู้ใช้ที่มีสิทธิ์เข้าถึงพอร์ตเหล่านั้น หรืออาจเรียกใช้คอมโพเนนต์หนึ่งในฐานะผู้ใช้รายหนึ่ง และเรียกใช้คอมโพเนนต์อื่นในฐานะผู้ใช้รายอื่น

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

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

  • edge-management-server (เซิร์ฟเวอร์การจัดการ)
  • edge-message-processor (Message Processor)
  • edge-router (เราเตอร์)
  • edge-postgres-server (เซิร์ฟเวอร์ Postgres)
  • edge-qpid-server (เซิร์ฟเวอร์ Qpid)

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

การย้อนกลับของ Cassandra

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

วิธีการย้อนกลับ

สถานการณ์การย้อนกลับ

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

ส่วนนี้จะอธิบายสถานการณ์การย้อนกลับต่างๆ พร้อมกับวิธีการที่แนะนำซึ่งควรทำตาม โดยอิงตามแนวทางที่อธิบายไว้ข้างต้น

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

การดำเนินการนี้ควรทำในศูนย์ข้อมูลแห่งละแห่ง
ศูนย์ข้อมูลหลายแห่ง มีการอัปเกรดโหนด Cassandra บาง/ทั้งหมดของศูนย์ข้อมูลล่าสุด
ศูนย์ข้อมูลหลายแห่ง โหนด Cassandra ทั้งหมด เซิร์ฟเวอร์การจัดการ และโหนดรันไทม์ที่อัปเกรดในศูนย์ข้อมูลทั้งหมด

การดำเนินการนี้ควรทำทีละศูนย์ข้อมูล

โดยทั่วไปแล้ว คุณควรพิจารณาสิ่งต่อไปนี้ขณะที่เปลี่ยนกลับ Cassandra

  1. การย้อนกลับรันไทม์หรือคอมโพเนนต์การจัดการ

    หากต้องการเปลี่ยนคอมโพเนนต์ เช่น Edge Management Server หรือ Edge Message Processor กลับไปเป็นเวอร์ชัน Edge Private Cloud เวอร์ชันก่อนหน้าในศูนย์ข้อมูล (DC) ใดก็ตาม โปรดตรวจสอบว่าได้เปลี่ยน Cassandra กลับไปเป็นเวอร์ชันก่อนหน้าในศูนย์ข้อมูลนั้นด้วยในเวลาเดียวกัน ซึ่งจําเป็นเพื่อป้องกันไม่ให้การจัดการและการเข้าชมรันไทม์ล้มเหลว

  2. เปลี่ยนกลับโดยใช้ข้อมูลสํารอง

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

  3. การแยกศูนย์ข้อมูลสำหรับการย้อนกลับ

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

ย้อนกลับ Cassandra โดยใช้การสร้างใหม่

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

  1. คุณกำลังใช้งานคลัสเตอร์ Edge for Private Cloud 4.51.00 / 4.52.00 / 4.52.01 ในศูนย์ข้อมูลหลายแห่ง
  2. คุณกําลังอัปเกรด Cassandra จาก 2.1.X เป็น 3.11.X และพบปัญหาระหว่างการอัปเกรด
  3. คุณมีศูนย์ข้อมูลที่ใช้งานได้อย่างสมบูรณ์อย่างน้อย 1 แห่งในคลัสเตอร์ที่ใช้ Cassandra เวอร์ชันเก่า (Cassandra 2.1.X)

ขั้นตอนระดับสูง

  1. เลือกศูนย์ข้อมูล 1 แห่ง (อัปเกรดบางส่วนหรือทั้งหมด) ที่ต้องการเปลี่ยนกลับ เปลี่ยนเส้นทางการรับส่งข้อมูลแอปพลิเคชันทั้งหมดจากศูนย์ข้อมูลนี้ไปยังศูนย์ข้อมูลอื่นที่ใช้งานได้อย่างเต็มรูปแบบ
  2. หากมีการอัปเกรดเราเตอร์และโปรแกรมประมวลผลข้อความ ให้เปลี่ยนกลับโหนดเราเตอร์และโปรแกรมประมวลผลข้อความทั้งหมดในศูนย์ข้อมูลทีละโหนด
  3. หยุด Cassandra ในโหนดหนึ่ง ถอนการติดตั้ง และล้างข้อมูลที่เกี่ยวข้องทั้งหมด
  4. ติดตั้ง Bootstrap เวอร์ชันก่อนหน้าและตั้งค่า Cassandra เวอร์ชัน 2.1.x ในโหนดที่ล้างข้อมูลแล้ว
  5. สร้างโหนดอีกครั้งจากศูนย์ข้อมูลที่ใช้งานได้อยู่ซึ่งยังคงใช้ Cassandra 2.1.x
  6. ทำตามขั้นตอนที่ 3 ถึง 5 ในโหนด Cassandra ที่เหลือแต่ละโหนดในศูนย์ข้อมูลทีละโหนด
  7. เรียกใช้การตั้งค่าเซิร์ฟเวอร์การจัดการในศูนย์ข้อมูลอีกครั้ง
  8. ทำการทดสอบเพื่อตรวจสอบการย้อนกลับ เมื่อยืนยันแล้ว ให้เปลี่ยนเส้นทางการรับส่งข้อมูลของแอปพลิเคชันกลับไปที่ศูนย์ข้อมูลที่กู้คืน
  9. ทำตามขั้นตอนข้างต้นซ้ำสำหรับศูนย์ข้อมูลอื่นๆ ที่ต้องทำการย้อนกลับทีละศูนย์ข้อมูล

ขั้นตอนโดยละเอียดในการล้างข้อมูลและใช้โหนดที่มีอยู่ในคลัสเตอร์เพื่อสร้างโหนดขึ้นมาใหม่

เริ่มด้วยโหนดที่ต้องการย้อนกลับ

  1. ตรวจสอบว่ามีการเปลี่ยนเส้นทางการรับส่งข้อมูลไปยังศูนย์ข้อมูลที่ใช้งานได้อย่างสมบูรณ์ก่อนที่จะดำเนินการขั้นตอนถัดไป
  2. หากมีการอัปเกรดเราเตอร์และโปรแกรมประมวลผลข้อความ ให้เปลี่ยนกลับโหนดเราเตอร์และโปรแกรมประมวลผลข้อความทั้งหมดเป็นเวอร์ชันก่อนหน้าในศูนย์ข้อมูลทีละโหนด
  3. หยุด Cassandra ในโหนดโดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. ถอนการติดตั้งซอฟต์แวร์ Cassandra จากโหนด 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. นำไดเรกทอรีข้อมูลออกจากโหนด 
    rm -rf /opt/apigee/data/apigee-cassandra

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

    ตัวอย่าง: การย้อนกลับเป็น 4.52.01

  7. ดาวน์โหลด Bootstrap ของ 4.52.01 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. เรียกใช้ Bootstrap ของ 4.52.01 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. ติดตั้งซอฟต์แวร์ Cassandra ในโหนด โดยทำดังนี้ 
    apigee-service apigee-cassandra install
  10. เพิ่มพร็อพเพอร์ตี้ด้านล่างในไฟล์ /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh 
    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

    ตัวอย่างเช่น 

    JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

  11. ตั้งค่า Cassandra ในโหนด 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  12. หลังจาก Cassandra ทำงานได้ ให้นำ CWC ด้านบนออกจากไฟล์ /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh ด้านล่าง
  13. รีสตาร์ทโหนด Cassandra 
    apigee-service apigee-cassandra restart
  14. ดำเนินการสร้างใหม่ในโหนดโดยระบุชื่อศูนย์ข้อมูลที่ใช้งานได้ 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>

    ตัวอย่างเช่น 

    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2

  15. ทำขั้นตอนข้างต้นซ้ำทีละโหนดในศูนย์ข้อมูลที่ต้องการย้อนกลับ

เมื่อนํานอต Cassandra ทั้งหมดในศูนย์ข้อมูลกลับและสร้างใหม่แล้ว

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

    2. เปลี่ยนเซิร์ฟเวอร์การจัดการกลับไปเป็นเวอร์ชันเก่า

  2. หยุดเซิร์ฟเวอร์การจัดการ 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
  3. หากคุณใช้การสร้างรายได้ ให้ถอนการติดตั้งการสร้างรายได้ด้วย โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. ถอนการติดตั้ง edge-gateway และ apigee-cassandra-client 
    /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
     
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
  5. ดาวน์โหลดและเรียกใช้ Bootstrap ของเวอร์ชันเก่า เช่น ดำเนินการตามขั้นตอนต่อไปนี้เพื่อดาวน์โหลดและเรียกใช้ Bootstrap เวอร์ชัน 4.52.01 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
     
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    6. การตั้งค่าเซิร์ฟเวอร์การจัดการ

  6. เรียกใช้การตั้งค่าโหนดเซิร์ฟเวอร์การจัดการ 1 โหนด โดยทำดังนี้ 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile
  7. หลังจากทำตามขั้นตอนข้างต้นแล้ว ให้เปลี่ยนเส้นทางการรับส่งข้อมูลกลับไปยังศูนย์ข้อมูลที่เปลี่ยนกลับ

การเพิ่มประสิทธิภาพหลังจากสร้างใหม่

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

ตัวอย่าง: สมมติว่าคุณมีโหนด Cassandra 6 ตัวในศูนย์ข้อมูลในเครื่อง โดยค่าเริ่มต้น ตัวคูณการทําซ้ำของ Apigee คือ 3 ดังนั้นโหนดทุกโหนดจะมีข้อมูล 50% ในกรณีนี้ คุณสามารถสร้างโหนด #1 และ #4 อีกครั้งโดยทําตามขั้นตอนด้านบน สำหรับโหนด #2, #3, #5 และ #6 ให้ทำตามขั้นตอนด้านล่างเพื่อกู้คืนข้อมูลสำรองและทำการซ่อม

  1. ทำตามขั้นตอนจนถึงขั้นตอนด้านบนตามที่บันทึกไว้เพื่อสร้างสําเนาอีกครั้งในศูนย์ข้อมูลในเครื่อง
  2. สำหรับโหนดที่เหลือ ให้ทำตามขั้นตอนด้านล่างทีละโหนด
  3. กู้คืนข้อมูลสำรองที่คุณบันทึกไว้ในโหนดนี้ (หมายเหตุ: ข้อมูลสํารองนี้อาจมีข้อมูลที่ล้าสมัยเนื่องจากมีการสํารองข้อมูลนี้ก่อนที่คุณจะเริ่มอัปเกรด Cassandra) 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

    หากมีสแนปชอต VM ของโหนด คุณจะกู้คืนสแนปชอตแทนการกู้คืนข้อมูลสํารองของ Cassandra ได้

  4. หลังจากกู้คืนข้อมูลสํารองแล้ว ให้เริ่มบริการ Cassandra ในโหนดโดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  5. ดำเนินการซ่อมโหนดเพื่อให้สตรีมข้อมูลล่าสุดจากศูนย์ข้อมูลที่มีอยู่ได้ โดยทำดังนี้ 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>

    ตัวอย่างเช่น 

    /opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1

  6. ทำขั้นตอนทั้งหมดข้างต้นที่ระบุไว้ในขั้นตอนที่ 2 ซ้ำในแต่ละโหนดที่ต้องการซ่อม

เปลี่ยนกลับ Cassandra โดยใช้สแนปชอตการสำรองข้อมูล / VM

ขั้นตอนนี้เป็นขั้นตอนเดียวที่ใช้ได้หากคุณได้อัปเกรดคลัสเตอร์ Cassandra ทั้งหมดและต้องการย้อนกลับ นอกจากนี้ การสำรองข้อมูล Apigee จะเจาะจงเฉพาะโหนด คุณกู้คืนข้อมูลสำรองที่ถ่ายจากโหนดหนึ่งไปยังอีกโหนดหนึ่งไม่ได้ ข้อมูลสํารองของ Cassandra ประกอบด้วยข้อมูลเมตาของโหนด (เช่น ที่อยู่ IP ตําแหน่งวงแหวน ฯลฯ)

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

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

ขั้นตอนระดับสูง

  1. เลือกศูนย์ข้อมูล (อัปเกรดบางส่วนหรือทั้งหมด) เพื่อเปลี่ยนกลับ เปลี่ยนเส้นทางการเข้าชมรันไทม์ทั้งหมดจากศูนย์ข้อมูลนี้ไปยังศูนย์ข้อมูลอีกแห่งที่ใช้งานได้อย่างเต็มรูปแบบ
  2. หากมีการอัปเกรดเราเตอร์และโปรแกรมประมวลผลข้อความ ให้เปลี่ยนกลับโหนดเราเตอร์และโปรแกรมประมวลผลข้อความทั้งหมดในศูนย์ข้อมูลทีละโหนด
  3. หยุด Cassandra ในโหนดหนึ่ง ถอนการติดตั้ง และล้างข้อมูลที่เกี่ยวข้องทั้งหมด
  4. ติดตั้ง Bootstrap เวอร์ชันก่อนหน้าและตั้งค่า Cassandra เวอร์ชัน 2.1.x ในโหนดที่ล้างข้อมูลแล้ว
  5. หยุดโหนด Cassandra และล้างข้อมูลที่เกี่ยวข้องทั้งหมด
  6. กู้คืนโหนด Cassandra จากข้อมูลสํารองที่เก็บไว้ก่อนการอัปเกรด
  7. ทำขั้นตอนที่ 3 ถึง 6 ซ้ำสำหรับโหนด Cassandra ที่เหลือแต่ละโหนดในศูนย์ข้อมูลทีละโหนด
  8. เรียกใช้การตั้งค่าเซิร์ฟเวอร์การจัดการในศูนย์ข้อมูลอีกครั้ง
  9. ทำการทดสอบเพื่อตรวจสอบการย้อนกลับ เมื่อยืนยันแล้ว ให้เปลี่ยนเส้นทางการเข้าชมรันไทม์กลับไปที่ศูนย์ข้อมูลที่กู้คืน
  10. ทำตามขั้นตอนข้างต้นซ้ำสำหรับศูนย์ข้อมูลอื่นๆ ที่ต้องทำการย้อนกลับทีละศูนย์ข้อมูล
  11. (ไม่บังคับ) เรียกใช้คําสั่งการซ่อมในโหนด Cassandra ทั้งหมดในศูนย์ข้อมูลทั้งหมดหากข้อมูลไม่สอดคล้องกัน

ขั้นตอนโดยละเอียดในการย้อนกลับ Cassandra โดยใช้ข้อมูลสํารอง/สแนปชอต VM

เริ่มต้นด้วยโหนด Cassandra 1 ตัวในคลัสเตอร์

  1. ตรวจสอบว่ามีการเปลี่ยนเส้นทางการรับส่งข้อมูลไปยังศูนย์ข้อมูลที่ใช้งานได้อย่างสมบูรณ์ก่อนที่จะดำเนินการขั้นตอนถัดไป
  2. หากมีการอัปเกรดเราเตอร์และโปรแกรมประมวลผลข้อความ ให้เปลี่ยนกลับโหนดเราเตอร์และโปรแกรมประมวลผลข้อความทั้งหมดเป็นเวอร์ชันก่อนหน้าในศูนย์ข้อมูลทีละโหนด
  3. หยุด Cassandra ในโหนดโดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  4. ถอนการติดตั้งซอฟต์แวร์ Cassandra จากโหนด 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
  5. นำไดเรกทอรีข้อมูลออกจากโหนด 
    rm -rf /opt/apigee/data/apigee-cassandra

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

    ตัวอย่าง: หากต้องการเปลี่ยนกลับไปเป็น 4.52.01

  7. ดาวน์โหลด Bootstrap ของ 4.52.01 
    curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
  8. เรียกใช้ Bootstrap ของ 4.52.01 
    sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
  9. ตั้งค่า Cassandra ในโหนด 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
  10. หยุด Cassandra ในโหนดโดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
  11. ลบไดเรกทอรีข้อมูลในโหนด 
    rm -rf /opt/apigee/data/apigee-cassandra/data
  12. กู้คืนข้อมูลสำรอง 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
  13. เริ่มบริการ Cassandra ในโหนด 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
  14. ทำซ้ำขั้นตอนในโหนด Cassandra แต่ละโหนดทีละโหนด
  15. เรียกใช้การตั้งค่าโหนดเซิร์ฟเวอร์การจัดการในศูนย์ข้อมูลที่กำลังจะเปลี่ยนกลับ ตรวจสอบว่าเซิร์ฟเวอร์การจัดการมาจากเวอร์ชันที่ย้อนกลับ หากไม่ ให้เปลี่ยนเซิร์ฟเวอร์การจัดการกลับด้วย
  16. หลังจากทำตามขั้นตอนข้างต้นแล้ว ให้เปลี่ยนเส้นทางการรับส่งข้อมูลกลับไปยังศูนย์ข้อมูลที่เปลี่ยนกลับ
  17. (ไม่บังคับ) เรียกใช้คําสั่งการซ่อมในโหนด Cassandra ทั้งหมดในศูนย์ข้อมูลทั้งหมดหากข้อมูลไม่สอดคล้องกัน 
    /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

เปลี่ยนกลับการอัปเดต Zookeeper 3.8.3

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

หากจะย้อนกลับไปเป็นเวอร์ชัน 4.52.01 ให้ย้อนกลับ Zookeeper เช่นเดียวกับการย้อนกลับซอฟต์แวร์อื่นๆ ตามที่ระบุไว้ในส่วนย้อนกลับไปเป็นเวอร์ชันหลักหรือรองก่อนหน้าด้านล่าง

ย้อนกลับ Qpid

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

หากจะเปลี่ยนกลับไปเป็นเวอร์ชัน 4.52.01 ให้เปลี่ยนกลับไปใช้ Qpid เช่นเดียวกับการเปลี่ยนกลับไปใช้ซอฟต์แวร์เวอร์ชันเก่าตามที่ระบุไว้ในเปลี่ยนกลับไปใช้รุ่นหลักหรือรุ่นย่อยก่อนหน้า

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

หากต้องการเปลี่ยนกลับไปเป็นเวอร์ชัน 4.51.00 คุณจะต้องดูขั้นตอนพิเศษบางอย่างก่อนเปลี่ยนกลับไปใช้ Postgres ขั้นตอนเหล่านี้แสดงอยู่ในการย้อนกลับ

หากจะเปลี่ยนกลับไปเป็นเวอร์ชัน 4.52.01 หรือ 4.52.00 ให้เปลี่ยนกลับไปใช้ Postgres เช่นเดียวกับการเปลี่ยนกลับไปใช้ซอฟต์แวร์อื่นๆ ตามที่ระบุไว้ในส่วนเปลี่ยนกลับไปใช้รุ่นหลักหรือรุ่นย่อยก่อนหน้าด้านล่าง

เปลี่ยนกลับไปเป็นรุ่นหลักหรือรุ่นย่อยก่อนหน้า

หากต้องการเปลี่ยนกลับไปใช้รุ่นหลักหรือรุ่นย่อยก่อนหน้า ให้ทําดังนี้ในแต่ละโหนดที่โฮสต์คอมโพเนนต์

  1. ดาวน์โหลดไฟล์ bootstrap.sh สำหรับเวอร์ชันที่ต้องการย้อนกลับ

    • หากต้องการเปลี่ยนกลับไปใช้เวอร์ชัน 4.51.00 ให้ดาวน์โหลด bootstrap_4.51.00.sh
  2. วิธีหยุดคอมโพเนนต์เพื่อเปลี่ยนกลับ
    1. หากต้องการเปลี่ยนกลับคอมโพเนนต์ที่มีโค้ดทั่วไปในโหนด คุณต้องหยุดคอมโพเนนต์ทั้งหมดดังที่แสดงในตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. หากต้องการเปลี่ยนกลับคอมโพเนนต์อื่นๆ ในโหนด ให้หยุดเฉพาะคอมโพเนนต์นั้นๆ โดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. หากต้องการเลิกใช้การสร้างรายได้ ให้ถอนการติดตั้งจากเซิร์ฟเวอร์การจัดการและโหนดโปรแกรมประมวลผลข้อความทั้งหมด ดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. ถอนการติดตั้งคอมโพเนนต์เพื่อเปลี่ยนกลับในโหนด โดยทำดังนี้
    1. หากต้องการเปลี่ยนกลับคอมโพเนนต์ที่มีโค้ดทั่วไปในโหนด คุณต้องถอนการติดตั้งทั้งหมดโดยถอนการติดตั้งกลุ่มคอมโพเนนต์ edge-gateway และ apigee-cassandra-client ดังที่แสดงในตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
    2. หากต้องการเปลี่ยนคอมโพเนนต์อื่นๆ ในโหนด ให้ถอนการติดตั้งเฉพาะคอมโพเนนต์นั้น ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      โดยที่ component คือชื่อคอมโพเนนต์

    3. หากต้องการเปลี่ยนกลับเราเตอร์ Edge คุณต้องลบเนื้อหาของไฟล์ /opt/nginx/conf.d นอกเหนือจากการถอนการติดตั้งกลุ่มคอมโพเนนต์ edge-gateway 
      cd /opt/nginx/conf.d
rm -rf *
  5. ถอนการติดตั้ง apigee-setup เวอร์ชัน 4.52.02 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. ติดตั้งยูทิลิตี apigee-service เวอร์ชัน 4.51.00 และรายการที่เกี่ยวข้อง ตัวอย่างต่อไปนี้จะติดตั้ง apigee-service เวอร์ชัน 4.51.00 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

    หากพบข้อผิดพลาด ให้ตรวจสอบว่าคุณได้ดาวน์โหลดไฟล์ bootstrap.sh ในขั้นตอนที่ 1

  7. วิธีติดตั้ง apigee-setup 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. ติดตั้งคอมโพเนนต์เวอร์ชันเก่า 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    โดยที่ component คือคอมโพเนนต์ที่จะติดตั้ง และ configFile คือไฟล์การกําหนดค่าสําหรับเวอร์ชันเก่า

  9. หากจะเปลี่ยนกลับไปใช้ Qpid ให้ล้าง iptables โดยทำดังนี้ 
    sudo iptables -F
  10. ทำตามกระบวนการนี้ซ้ำสำหรับโหนดแต่ละโหนดที่โฮสต์คอมโพเนนต์ที่คุณจะเปลี่ยนกลับ

เปลี่ยนกลับไปใช้แพตช์รุ่นก่อนหน้า

หากต้องการเปลี่ยนคอมโพเนนต์กลับไปเป็นรุ่นแพตช์ที่เฉพาะเจาะจง ให้ทำดังนี้ในแต่ละโหนดที่โฮสต์คอมโพเนนต์

  1. ดาวน์โหลดคอมโพเนนต์เวอร์ชันที่ต้องการ 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    โดยที่ component_version คือคอมโพเนนต์และรุ่นแพตช์ที่จะติดตั้ง เช่น

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install

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

    yum --showduplicates list component

    เช่น

    yum --showduplicates list edge-ui
  2. ใช้ apigee-setup เพื่อติดตั้งคอมโพเนนต์ 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    เช่น

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    โปรดทราบว่าคุณระบุเฉพาะชื่อคอมโพเนนต์เมื่อติดตั้งเท่านั้น ไม่ใช่เวอร์ชัน

  3. ทำตามกระบวนการนี้ซ้ำสำหรับโหนดแต่ละโหนดที่โฮสต์คอมโพเนนต์ที่คุณจะเปลี่ยนกลับ

เปลี่ยนกลับ mTLS

หากต้องการเปลี่ยนกลับการอัปเดต mTLS ให้ทำตามขั้นตอนต่อไปนี้ในโฮสต์ทั้งหมด

  1. หยุด Apigee 
    apigee-all stop
  2. วิธีหยุดใช้ mTLS 
    apigee-service apigee-mtls uninstall
  3. ติดตั้ง mTLS อีกครั้งโดยทำดังนี้ 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf