ย้อนกลับ Apigee Edge 4.54.00

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

คุณสามารถย้อนกลับ Edge 4.54.00 เป็นเวอร์ชันหลักที่เผยแพร่ต่อไปนี้ได้

  • เวอร์ชัน 4.53.00
  • เวอร์ชัน 4.53.01

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

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

การย้อนกลับคอมโพเนนต์ควรทำในลำดับย้อนกลับจากที่อัปเกรด ลำดับการย้อนกลับทั่วไปสำหรับ Private Cloud 4.54.00 จะมีลักษณะดังนี้

  • ย้อนกลับ Cassandra, Zookeeper
  • ย้อนกลับ Qpid, คอมโพเนนต์อื่นๆ ที่เกี่ยวข้องกับการวิเคราะห์ และ Postgres
  • ย้อนกลับ UI
  • ย้อนกลับ LDAP
  • ย้อนกลับเซิร์ฟเวอร์การจัดการ
  • ย้อนกลับเราเตอร์และ Message Processor

ตัวอย่างเช่น สมมติว่าคุณอัปเกรดเราเตอร์และตัวประมวลผลข้อความทั้งหมด เซิร์ฟเวอร์การจัดการทั้งหมด LDAP และโหนด UI บางรายการเป็นเวอร์ชัน 4.54.00 จากเวอร์ชัน 4.53.00 (หรือ) 4.53.01 และต้องการย้อนกลับ ในกรณีนี้ คุณจะต้องดำเนินการดังนี้

  • ย้อนกลับโหนด UI ที่อัปเกรดแล้ว
  • ย้อนกลับโหนด LDAP
  • ย้อนกลับโหนดเซิร์ฟเวอร์การจัดการทีละรายการ
  • ย้อนกลับ RMP ทั้งหมดทีละรายการ

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

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

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

ย้อนกลับ Cassandra

เมื่อมีการอัปเกรด Cassandra ครั้งใหญ่ในโหนดที่เฉพาะเจาะจง Cassandra จะแก้ไขสคีมาของข้อมูลที่จัดเก็บไว้ในโหนดนั้น ด้วยเหตุนี้ การย้อนกลับโดยตรงจึงเป็นไปไม่ได้

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

ตารางต่อไปนี้สรุปกลยุทธ์การย้อนกลับที่คุณใช้ได้

สถานการณ์ กลยุทธ์การย้อนกลับ
DC เดียว อัปเกรดโหนด Cassandra บางรายการแล้ว ใช้ข้อมูลสำรอง
DC หลายรายการ, อัปเกรดโหนดบางรายการใน DC รายการเดียว สร้างใหม่จากเอกสารรับรองดิจิทัลที่มีอยู่
DC หลายรายการ, โหนด Cassandra ทั้งหมดใน DC บางรายการได้รับการอัปเกรดแล้ว สร้างใหม่จาก DC ที่มีอยู่
โหนด DC, Cassandra หลายรายการของ DC สุดท้ายที่กำลังอัปเกรด พยายามอัปเกรดให้เสร็จสิ้น หากทำไม่ได้ ให้ย้อนกลับ 1 DC โดยใช้ข้อมูลสำรอง สร้าง DC ที่เหลือใหม่จาก DC ที่ย้อนกลับ

ข้อควรพิจารณาทั่วไป

โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อพิจารณาการย้อนกลับ

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

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

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

  • คุณกำลังใช้งานคลัสเตอร์ Edge for Private Cloud 4.53.00/4.53.01 ในศูนย์ข้อมูลหลายแห่ง
  • คุณกำลังอัปเกรด Cassandra จาก 4.0.X เป็น 5.0.X และพบปัญหาในระหว่างการอัปเกรด
  • คุณมีศูนย์ข้อมูลที่ใช้งานได้อย่างสมบูรณ์อย่างน้อย 1 แห่งในคลัสเตอร์ที่ยังคงใช้ Cassandra เวอร์ชันเก่า (Cassandra 4.0.X)

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

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

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

ขั้นตอนโดยละเอียด

  1. เลือกศูนย์ข้อมูล 1 แห่งที่มีการอัปเกรดโหนด Cassandra ทั้งหมดหรือบางส่วน เปลี่ยนเส้นทางการเข้าชมพร็อกซีรันไทม์และการเข้าชมการจัดการทั้งหมดจากศูนย์ข้อมูลนี้ขณะที่โหนด Cassandra ในศูนย์ข้อมูลนี้กำลังย้อนกลับ ตรวจสอบว่าโหนด Cassandra ทั้งหมดอยู่ในสถานะ UN (Up/Normal) เมื่อเรียกใช้คำสั่ง nodetool ring ในโหนด หากโหนดบางโหนดไม่ทำงาน ให้แก้ปัญหาและทำให้โหนดเหล่านั้นกลับมาทำงานอีกครั้งก่อนดำเนินการต่อ

    ดูตัวอย่างด้านล่าง

    /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    คุณสามารถเรียกใช้ nodetool describecluster บนโหนดเพื่อทำความเข้าใจสถานะปัจจุบันของทั้งคลัสเตอร์ ตัวอย่างเช่น ข้อมูลต่อไปนี้แสดงอินสแตนซ์ของคลัสเตอร์ 2 ศูนย์ข้อมูลที่โหนด DC-1 ทั้งหมดใช้ Cassandra เวอร์ชัน 4 ในขณะที่โหนด DC-2 ทั้งหมดใช้ Cassandra เวอร์ชัน 3

    # On nodes where Cassandra is upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    5.0.8: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    4.0.13: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. ระบุโหนดเริ่มต้นในศูนย์ข้อมูล: ดูส่วนวิธีระบุโหนดเริ่มต้นในภาคผนวก ทำตามขั้นตอนด้านล่างในโหนดเริ่มต้น
  3. หยุด ถอนการติดตั้ง และล้างข้อมูลจากโหนดของ Cassandra เลือกโหนดเริ่มต้นแรกใน Cassandra เวอร์ชัน 5 ในศูนย์ข้อมูลนี้ หยุดเถอะ 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. ติดตั้งซอฟต์แวร์ Cassandra เวอร์ชันเก่าในโหนดและกำหนดค่าบางอย่าง เรียกใช้ไฟล์ Bootstrap ของ Edge สำหรับ Private Cloud 4.53.00/4.53.01 
    5. # Download bootstrap of 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap of 4.53.00
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
  5. สร้างหรือแก้ไขไฟล์ /opt/apigee/customer/application/cassandra.properties
  6. เพิ่มเนื้อหาต่อไปนี้ลงในไฟล์ ipOfNode คือที่อยู่ IP ของโหนดที่ Cassandra ใช้สื่อสารกับโหนด Cassandra อื่นๆ 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  7. ตรวจสอบว่าผู้ใช้ apigee เป็นเจ้าของและอ่านไฟล์ได้ โดยทำดังนี้ 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  8. ติดตั้งและตั้งค่า Cassandra โดยทำดังนี้
    9. # Install cassandra version 4.0.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
# Setup cassandra while passing standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
# Ensure Cassandra version is correct and service is running
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  9. ตรวจสอบว่าโหนดเริ่มทำงานแล้ว ตรวจสอบคำสั่งต่อไปนี้ในโหนดนี้และโหนดอื่นๆ ในคลัสเตอร์ โหนดควรรายงานว่าอยู่ในสถานะ "UN" (Up/Normal) ดังนี้ 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  10. นำการกำหนดค่าเพิ่มเติมที่เพิ่มไว้ก่อนหน้านี้ออกจากไฟล์ /opt/apigee/customer/application/cassandra.properties
  11. ทำขั้นตอนที่ 3-10 ซ้ำในโหนดเริ่มต้นของ Cassandra ทั้งหมดในศูนย์ข้อมูลทีละโหนด
  12. ทำซ้ำขั้นตอนที่ 3-10 ในโหนด Cassandra ที่เหลือทั้งหมดในศูนย์ข้อมูลทีละโหนด
  13. สร้างโหนดทั้งหมดในศูนย์ข้อมูลใหม่จากศูนย์ข้อมูลที่ใช้ Cassandra เวอร์ชันเก่า ทำขั้นตอนนี้ทีละโหนด 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>

    กระบวนการนี้อาจใช้เวลาสักครู่ คุณปรับ streamingthroughput ได้หากต้องการ ตรวจสอบ nodetool netstats เพื่อดูสถานะการดำเนินการเสร็จสมบูรณ์

  14. (ไม่บังคับ) เรียกใช้คำสั่งซ่อมในโหนด Cassandra หากระบบไม่สร้างข้อมูลใหม่ 
    /opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr
  15. รีสตาร์ทคอมโพเนนต์ edge-* ทั้งหมดในศูนย์ข้อมูลทีละรายการ โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  16. ตรวจสอบและเปลี่ยนเส้นทางการเข้าชมกลับไปยังศูนย์ข้อมูลนี้ เรียกใช้การตรวจสอบบางอย่างสำหรับการเข้าชมรันไทม์และ Management API ในศูนย์ข้อมูลนี้ และเริ่มเปลี่ยนเส้นทางการเข้าชมพร็อกซีและการเข้าชม Management API กลับไปยังศูนย์ข้อมูลนี้
  17. ทำขั้นตอนข้างต้นซ้ำสำหรับศูนย์ข้อมูลแต่ละแห่งที่ต้องการย้อนกลับ

ย้อนกลับ Cassandra โดยใช้ข้อมูลสำรอง

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

  1. คุณกำลังอัปเกรด Cassandra จาก 4.0.X เป็น 5.0.X และพบปัญหาระหว่างการอัปเกรด
  2. คุณมีข้อมูลสำรองสำหรับโหนดที่จะย้อนกลับ ระบบได้สำรองข้อมูลก่อนที่จะพยายามอัปเกรดจาก 4.0.X เป็น 5.0.X

ขั้นตอน

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

  2. หยุด ถอนการติดตั้ง และล้างโหนด Cassandra โดยทำดังนี้

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. ติดตั้งซอฟต์แวร์ Cassandra เวอร์ชันเก่าในโหนดและกำหนดค่าโดยทำดังนี้

    • เรียกใช้ไฟล์ Bootstrap สำหรับ Edge for Private Cloud 4.53.00/4.53.01 โดยทำดังนี้
      • # Download bootstrap for 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap for 4.53.00
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    • สร้างหรือแก้ไขไฟล์ /opt/apigee/customer/application/cassandra.properties:
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • ตรวจสอบว่าไฟล์เป็นของผู้ใช้ Apigee และอ่านได้ โดยทำดังนี้
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • ติดตั้งและตั้งค่า Cassandra โดยทำดังนี้
      • # Install Cassandra version 4.0.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

    ตรวจสอบว่าโหนดเริ่มทำงานแล้ว ตรวจสอบคำสั่งต่อไปนี้ในโหนดนี้และโหนดอื่นๆ ในคลัสเตอร์ โหนดควรรายงานว่าโหนดนี้อยู่ในสถานะ "UN" ดังนี้

    /opt/apigee/apigee-cassandra/bin/nodetool status

  4. หยุดบริการ Cassandra แล้วกู้คืนข้อมูลสำรอง ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบการสำรองและกู้คืนข้อมูล

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. เมื่อกู้คืนข้อมูลสำรองแล้ว ให้นำการกำหนดค่าเพิ่มเติมออกโดยทำดังนี้

    นำการกำหนดค่าที่เพิ่มไว้ก่อนหน้านี้ออกจากไฟล์ /opt/apigee/customer/application/cassandra.properties

  6. เริ่มบริการ Cassandra ในโหนดโดยทำดังนี้

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

  7. ทำขั้นตอนซ้ำในแต่ละโหนด Cassandra ที่คุณต้องการย้อนกลับโดยใช้ การสำรองข้อมูลทีละรายการ

  8. เมื่อกู้คืนโหนด Cassandra ทั้งหมดแล้ว ให้รีสตาร์ทคอมโพเนนต์ edge-* ทั้งหมดทีละรายการ

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

การเพิ่มประสิทธิภาพการสำรองข้อมูล (ตัวเลือกขั้นสูง)

คุณอาจลด (หรือกำจัด) การสูญหายของข้อมูลขณะกู้คืนข้อมูลสำรองได้หากมีตัวจำลองที่มีข้อมูลล่าสุดพร้อมใช้งาน หากมีตัวจำลอง หลังจากกู้คืนข้อมูลสำรองแล้ว ให้เรียกใช้การซ่อมแซมในโหนดที่กู้คืน

ภาคผนวก

วิธีระบุโหนดเริ่มต้น

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

คำสั่งจะแสดงผลหลายบรรทัด มองหาบรรทัดสุดท้ายของเอาต์พุต ที่อยู่ IP ที่แสดงในบรรทัดสุดท้ายคือโหนดเริ่มต้น ในตัวอย่างด้านล่าง DC-1-IP1, DC-1-IP2, DC-2-IP1 และ DC-2-IP2 คือ IP ของโหนดเริ่มต้น

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

ย้อนกลับ ZooKeeper

ย้อนกลับ

ในกรณีที่ต้องย้อนกลับ ให้ทำดังนี้

  1. ทำตามขั้นตอนการย้อนกลับในผู้สังเกตการณ์และผู้ติดตามก่อน โปรดดูหัวข้อระบุผู้นำ ผู้ติดตาม และผู้สังเกตการณ์เพื่อเลือกผู้สังเกตการณ์และผู้ติดตาม
  2. ดาวน์โหลดและเรียกใช้ Bootstrap ของเวอร์ชันที่คุณจะย้อนกลับไป ซึ่งอาจเป็น 4.53.00/4.53.01 กระบวนการนี้อาจแตกต่างกันไปขึ้นอยู่กับว่าโหนดมีการเชื่อมต่ออินเทอร์เน็ตภายนอกหรือคุณกำลังทำการติดตั้งแบบออฟไลน์
  3. หยุด Zookeeper หากทำงานอยู่ในโหนด โดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. ถอนการติดตั้ง zookeeper ที่มีอยู่: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. ติดตั้ง Zookeeper ตามปกติโดยทำดังนี้ 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. เมื่อย้อนกลับโหนดผู้ติดตามและโหนดผู้สังเกตการณ์ทั้งหมดแล้ว ให้ย้อนกลับโหนดผู้นำโดยทำตามขั้นตอนที่ 2 ถึง 5 ในโหนดผู้นำ
  7. หลังจากย้อนกลับโหนดทั้งหมดแล้ว ให้ตรวจสอบสถานะคลัสเตอร์และตรวจสอบว่ามี โหนดผู้นำในคลัสเตอร์

คืนค่าข้อมูลสำรอง

โปรดดูหัวข้อกู้คืนจากข้อมูลสำรอง

ย้อนกลับ Qpid

หากต้องการย้อนกลับไปใช้ Feature Release เวอร์ชันก่อนหน้า โปรดดาวน์โหลดไฟล์ bootstrap.sh สำหรับเวอร์ชันที่ต้องการย้อนกลับ หากต้องการย้อนกลับไปใช้ v 4.53.00/4.53.01 ให้ดาวน์โหลด bootstrap_4.53.00.sh

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

  1. หยุดโบรกเกอร์ Qpid ที่มีอยู่ 
    apigee-service apigee-qpidd stop
  2. บล็อกการเข้าชมขาเข้าในพอร์ตโบรกเกอร์ 5672 จาก Message Processor ทั้งหมดโดยใช้ไฟร์วอลล์ คุณใช้ไฟร์วอลล์นี้ได้ที่ระดับอินสแตนซ์โหนด Qpid หรือไฟร์วอลล์/คอมโพเนนต์เครือข่ายภายนอกอื่นๆ

    เราขอแนะนำให้คุณทำตามขั้นตอนเดียวกันสำหรับที่อยู่ IP ของ Message Processor ทั้งหมด ตัวอย่างเช่น หากต้องการยกเลิก (DROP) คำขอที่มาจากที่อยู่ IP ของ Message Processor ไปยังโหนด Qpid ในพอร์ต 5672 โดยใช้ IPTables คุณสามารถใช้คำสั่งต่อไปนี้

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. เริ่มนายหน้า Qpid อีกครั้งเพื่อระบายข้อความที่มีอยู่ (หากมี) 
    apigee-service apigee-qpidd start
  4. ตรวจสอบว่าคิวที่มีอยู่ว่างเปล่า หากต้องการตรวจสอบ ให้เข้าสู่ระบบพอร์ทัลการจัดการ Qpid โดยทำดังนี้ 
    http://QPID_NODE_IP:8090
  5. หลังจากตรวจสอบว่าคิวว่างแล้ว ให้หยุดและถอนการติดตั้ง Qpid โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall
  6. ลบไดเรกทอรีข้อมูล Qpid โดยทำดังนี้ 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. ติดตั้งโบรกเกอร์ Qpid อีกครั้ง 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. เมื่อติดตั้ง Qpid Broker อีกครั้งแล้ว ให้นำการตั้งค่าไฟร์วอลล์ออกและแสดงรายการการตั้งค่าที่มีอยู่โดยใช้คำสั่งต่อไปนี้ 
    iptables -F
iptables -L

ย้อนกลับ Postgres

หากต้องการดาวน์เกรดจากเวอร์ชัน 4.54.00 เป็นเวอร์ชัน 4.53.00/4.53.01 คุณต้องย้อนกลับการอัปเดต Postgres นอกเหนือจากคอมโพเนนต์ Edge

วิธีเปลี่ยนกลับการอัปเดต Postgres เมื่ออัปเดต Postgres ในการกำหนดค่าแบบ Master-Standby มีดังนี้

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

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

ก่อนเริ่มต้น

ก่อนที่จะย้อนกลับ Postgres 18 เป็น 17/14 ให้ทำตามขั้นตอนต่อไปนี้ทั้งในโฮสต์สแตนด์บายใหม่และโฮสต์สแตนด์บายเก่าเพื่ออัปเดตพร็อพเพอร์ตี้ max_locks_per_transaction ใน apigee-postgresql

  1. หากไม่มี ให้สร้างไฟล์ /opt/apigee/customer/application/postgresql.properties
  2. เปลี่ยนการเป็นเจ้าของไฟล์นี้เป็น apigee โดยทำดังนี้ 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. เพิ่มพร็อพเพอร์ตี้ต่อไปนี้ลงในไฟล์ 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. กำหนดค่า apigee-postgresql 
    apigee-service apigee-postgresql configure
  5. รีสตาร์ท apigee-postgresql: 
    apigee-service apigee-postgresql restart

ขั้นตอนการย้อนกลับโดยละเอียด

  1. ตรวจสอบว่าโหนด Postgres สแตนด์บายใหม่ทำงานอยู่ 
    /opt/apigee/apigee-service/bin/apigee-all status

    หาก Postgres ไม่ทำงาน ให้เริ่มการทำงานโดยทำดังนี้

    /opt/apigee/apigee-service/bin/apigee-all start
  2. ตรวจสอบว่า Postgres หยุดทำงานในโหนดหลักเก่าและโหนดสแตนด์บายเก่าแล้ว โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-all status

    หาก Postgres ทำงานอยู่ ให้หยุดการทำงานโดยทำดังนี้ 

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop  
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  3. หากติดตั้งแล้ว ให้เริ่ม Qpid ในโหนดสแตนด์บายเก่าโดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. เลื่อนระดับโหนดสแตนด์บายใหม่ให้เป็นมาสเตอร์ Postgres โดยทำดังนี้
    1. เลื่อนระดับโหนดสแตนด์บายใหม่ให้เป็นมาสเตอร์ใหม่ 
      apigee-service apigee-postgresql promote-standby-to-master old_master_IP

      หากได้รับข้อความแจ้ง ให้ป้อนรหัสผ่าน Postgres สำหรับผู้ใช้ "apigee" ซึ่งค่าเริ่มต้นคือ "postgres"

    2. แก้ไขไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง Edge เวอร์ชันปัจจุบันเพื่อระบุสิ่งต่อไปนี้ 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    3. กำหนดค่ามาสเตอร์ใหม่:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. หากอัปเกรดโหนดสแตนด์บายเก่าเป็นเวอร์ชันใหม่กว่าแล้ว คุณต้อง ดาวน์เกรดซอฟต์แวร์ Apigee ในโหนดสแตนด์บายเก่าก่อน หากคุณยังมีเวอร์ชันเก่าในโหนดสแตนด์บายเก่า คุณสามารถข้ามขั้นตอนนี้และทำตามขั้นตอนที่ 6 ต่อได้
    1. หยุด Postgres ในโหนดสแตนด์บายเก่า 
      apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
    2. ถอนการติดตั้ง Postgres จากโหนดสแตนด์บายเก่า โดยทำดังนี้ 
      apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
apigee-service edge-analytics uninstall
    3. ลบไดเรกทอรีข้อมูล Postgres ออกจากโหนดสแตนด์บายเก่า 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    4. ดาวน์โหลดและเรียกใช้ Bootstrap เวอร์ชันเก่า (สำหรับเวอร์ชัน Apigee ที่คุณจะย้อนกลับไป) ในโหนดสแตนด์บายเก่า ขั้นตอนที่แน่นอนอาจแตกต่างกันไปโดยขึ้นอยู่กับว่าคุณใช้การติดตั้งผ่านอินเทอร์เน็ตหรือแบบออฟไลน์ การเรียกใช้ Apigee Bootstrap เวอร์ชันเก่าจะ ตั้งค่าที่เก็บ yum ด้วยข้อมูล Apigee เวอร์ชันเก่า
    5. ตั้งค่าคอมโพเนนต์ Postgres ในโหนดสแตนด์บายเก่า 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. ตรวจสอบและยืนยันว่าคอมโพเนนต์ Postgres ในโหนดสแตนด์บายเก่า ได้รับการเปลี่ยนกลับเป็นเวอร์ชันเก่าแล้ว 
      apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
  6. สร้างโหนดสแตนด์บายเก่าขึ้นมาใหม่
    1. แก้ไขไฟล์การกำหนดค่าที่คุณใช้ติดตั้ง Edge เวอร์ชันปัจจุบันเพื่อระบุสิ่งต่อไปนี้ 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    2. นำไดเรกทอรีข้อมูลในโหนดสแตนด์บายเก่าออกโดยทำดังนี้ 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    3. กำหนดค่าโหนดสแตนด์บายเก่าใหม่ให้เป็นโหนดสแตนด์บายของมาสเตอร์ใหม่ โดยทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. ตรวจสอบว่า Postgres ทำงานอยู่ในโหนดสแตนด์บายเก่า 
      /opt/apigee/apigee-service/bin/apigee-all status

      หาก Postgres ไม่ได้ทำงาน ให้เริ่มทำงานโดยทำดังนี้

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. ยืนยันว่าได้เพิ่มโหนดสแตนด์บายใหม่แล้วโดยดูไฟล์ /opt/apigee/apigee-postgresql/conf/pg_hba.conf ในมาสเตอร์ใหม่
  8. ดูข้อมูลการวิเคราะห์และกลุ่มผู้ใช้ปัจจุบันโดยเรียกใช้คำสั่งต่อไปนี้ในเซิร์ฟเวอร์การจัดการ 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    คำสั่งนี้จะแสดงชื่อกลุ่ม Analytics ในช่อง name และชื่อกลุ่มผู้บริโภคในช่อง name ใต้ consumer-groups นอกจากนี้ยังแสดง UUID ของโหนดหลักและโหนดสแตนด์บาย Postgres เก่าในฟิลด์ postgres-server และในฟิลด์ datastores ด้วย คุณควรเห็นเอาต์พุตในรูปแบบต่อไปนี้ 

    {
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}
  9. รับที่อยู่ UUID ของมาสเตอร์เก่าโดยเรียกใช้คำสั่ง curl ต่อไปนี้ในโหนดมาสเตอร์เก่า 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    คุณควรเห็น UUID ของโหนดที่ส่วนท้ายของเอาต์พุตในรูปแบบต่อไปนี้

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  10. ทำซ้ำขั้นตอนก่อนหน้าเพื่อรับที่อยู่ IP ของโหนดสแตนด์บายเก่าและมาสเตอร์ใหม่
  11. นำโหนดหลักและโหนดสแตนด์บายเก่าออกจากกลุ่มผู้ใช้ 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    โดย axgroup-001 และ consumer-group-001 คือชื่อเริ่มต้นของ กลุ่มข้อมูลวิเคราะห์และกลุ่มผู้บริโภค masterUUID,standbyUUID อยู่ในลำดับเดียวกับที่ปรากฏด้านบนเมื่อคุณดูข้อมูลการวิเคราะห์และกลุ่มผู้บริโภคปัจจุบันด้านบน คุณอาจต้องระบุเป็น standbyUUID,masterUUID

    พร็อพเพอร์ตี้ datastores สำหรับ consumer-groups ควรว่างเปล่าแล้ว

  12. นำโหนดหลักและโหนดสแตนด์บายเก่าออกจากกลุ่ม Analytics โดยทำดังนี้ 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    ตอนนี้พร็อพเพอร์ตี้ postgres-server ในส่วน uuids ควรว่างเปล่า

  13. ลงทะเบียนโหนดหลักและโหนดสแตนด์บาย PG ใหม่กับกลุ่มการวิเคราะห์และกลุ่มผู้บริโภค
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
  14. ตรวจสอบกลุ่ม Analytics โดยทำดังนี้ 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

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

  15. รีสตาร์ท Edge Management Server โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. รีสตาร์ทเซิร์ฟเวอร์ Qpid ทั้งหมดโดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. รีสตาร์ทเซิร์ฟเวอร์ Postgres ทั้งหมดโดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. ยืนยันสถานะการจำลองโดยเรียกใช้สคริปต์ต่อไปนี้ในเซิร์ฟเวอร์ทั้ง 2 เครื่อง ระบบ ควรแสดงผลลัพธ์ที่เหมือนกันในทั้ง 2 เซิร์ฟเวอร์เพื่อให้การจำลองแบบสำเร็จ

    เรียกใช้คำสั่งต่อไปนี้ในมาสเตอร์ใหม่

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    ตรวจสอบว่าอุปกรณ์อยู่ในโหมดสแตนด์บาย

  19. ทำซ้ำขั้นตอนก่อนหน้าหลังจากส่งคำขอ API หลายรายการเพื่อให้แน่ใจว่าโหนดซิงค์กัน
  20. เลิกใช้งาน Postgres Master เดิม:

    หรือคุณจะถอนการติดตั้ง Qpid จากมาสเตอร์เก่าและติดตั้ง Qpid ในโหนดมาสเตอร์ใหม่ก็ได้ หลังจากถอนการติดตั้ง Qpid แล้ว คุณสามารถเลิกใช้งานโหนดหลักเก่าได้

ย้อนกลับ UI ใหม่ของ Edge

Apigee Edge สำหรับ Private Cloud 4.54.00 จะแทนที่ UI แบบคลาสสิก (edge-ui) ด้วย UI ของ Edge ใหม่ (edge-management-ui) เนื่องจากการเปลี่ยนแปลงคอมโพเนนต์ UI ใน 4.54.00 การย้อนกลับไปใช้เวอร์ชัน 4.53.00 หรือ 4.53.01 จึงต้องถอนการติดตั้ง edge-management-ui และติดตั้งโปรไฟล์ UI ก่อนหน้าอีกครั้ง โดยทำดังนี้

  • UI แบบคลาสสิก (edge-ui): ติดตั้งโปรไฟล์ ui อีกครั้ง
  • Edge UI ใหม่ (edge-ui และ edge-management-ui): ติดตั้งทั้งโปรไฟล์ ui และ ue อีกครั้งในโหนดที่เกี่ยวข้อง

วิธีย้อนกลับ UI ในโหนด

  1. หยุดและถอนการติดตั้ง UI ของ Edge เวอร์ชัน 4.54.00 ใหม่ แล้วติดตั้งเวอร์ชันก่อนหน้าเพื่อย้อนกลับ
    1. หยุดและถอนการติดตั้ง UI ของ New Edge 4.54.00 (edge-management-ui): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui stop
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui uninstall
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui-static uninstall
    2. เรียกใช้ไฟล์ Bootstrap สำหรับ Apigee Edge สำหรับ Private Cloud 4.53.00/4.53.01: 
      # Download bootstrap for 4.53.00
curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh -u uName:pWord

# Execute bootstrap for 4.53.00
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    3. ย้อนกลับ apigee-setup จาก 4.54.00 เป็นเวอร์ชันก่อนหน้า โดยทำดังนี้ 
      # Uninstall apigee-setup
/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

# Install apigee-setup
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  2. กู้คืนการกำหนดค่า UI เวอร์ชัน 4.53.00/4.53.01
    • หากคุณสำรองข้อมูลไฟล์การกำหนดค่าแบบไม่มีการโต้ตอบจากการติดตั้งเวอร์ชัน 4.53.00 หรือ 4.53.01 ให้ใช้ไฟล์ข้อมูลสำรองนั้นสำหรับขั้นตอนการย้อนกลับ ไม่เช่นนั้น ในไฟล์การกำหนดค่าแบบไม่มีการโต้ตอบ 4.54.00 ให้กู้คืนหรือยกเลิกการทำเครื่องหมายเป็นความคิดเห็นสำหรับพร็อพเพอร์ตี้ UI 4.53.00 หรือ 4.53.01 ที่ถูกนำออกหรือทำเครื่องหมายเป็นความคิดเห็นระหว่างการอัปเกรด โปรดดูข้อมูลอ้างอิงในส่วนการอัปเกรด UI
    • หาก /opt/apigee/customer/application/ui.properties ถูกลบระหว่างการอัปเกรด ให้กู้คืนจากไดเรกทอรีสำรองข้อมูล ดังนี้ 
      cp -rf /opt/apigee/backup/ui/customer/application/ui.properties /opt/apigee/customer/application/
chown apigee:apigee /opt/apigee/customer/application/ui.properties
  3. ติดตั้งและกำหนดค่า UI เวอร์ชันก่อนหน้าอีกครั้ง
    • ย้อนกลับไปใช้ UI แบบคลาสสิก (edge-ui)
      1. ติดตั้งและตั้งค่า Classic UI (สำหรับการตรวจสอบสิทธิ์พื้นฐาน ไม่จำเป็นต้องทำขั้นตอนเพิ่มเติม) 
        /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
      2. หากเปิดใช้ SSO ให้กำหนดค่า SSO ใน UI แบบคลาสสิก (ตรวจสอบว่า apigee-sso ทำงานก่อน) 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
    • ย้อนกลับไปใช้ Edge UI เวอร์ชัน 4.53.00 หรือ 4.53.01 (edge-management-ui และ Shoehorn edge-ui):
      1. ตรวจสอบว่าได้ตั้งค่า EDGEUI_ENABLE_UNIFIED_UI=y ในไฟล์การกำหนดค่าแบบไม่โต้ตอบแล้ว จากนั้นติดตั้งและตั้งค่าโปรไฟล์ ui และ ue โดยทำดังนี้ 
        /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
/opt/apigee/apigee-setup/bin/setup.sh -p ue -f configFile
      2. หากเปิดใช้ SSO ให้กำหนดค่า SSO ในคอมโพเนนต์ UI ทั้ง 2 รายการ (ตรวจสอบว่า apigee-sso ทำงานก่อน) 
        /opt/apigee/apigee-service/bin/apigee-service edge-ui configure-sso -f configFile
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile
  4. ตรวจสอบสถานะและเวอร์ชันของ UI ที่ย้อนกลับ
    • สำหรับ UI แบบคลาสสิก (edge-ui) ให้ทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui status
/opt/apigee/apigee-service/bin/apigee-service edge-ui version
    • สำหรับ Edge UI ใหม่ (edge-management-ui) ให้ทำดังนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui status
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui version

ย้อนกลับ OpenLDAP

ส่วนนี้จะแสดงคำแนะนำทีละขั้นตอนสำหรับการย้อนกลับ Symas OpenLDAP 2.6.10 ใน Edge for Private Cloud 4.54.00 เป็น OpenLDAP 2.4.46 (Edge for Private Cloud 4.53.00) หรือ Symas OpenLDAP 2.6.7 (Edge for Private Cloud 4.53.01) คุณต้องดำเนินการย้อนกลับในคลัสเตอร์ LDAP ทั้งหมดโดยใช้ข้อมูลสำรอง LDAP ก่อนการอัปเกรดที่ถูกต้อง

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

ก่อนเริ่มต้น

  • ความไม่เข้ากันของข้อมูลสำรอง: ใช้ข้อมูลสำรองก่อนการอัปเกรดจาก OpenLDAP 2.4.46 (Edge for Private Cloud 4.53.00) หรือ Symas OpenLDAP 2.6.7 (Edge for Private Cloud 4.53.01) ที่ดำเนินการโดยใช้ apigee-service apigee-openldap backup ก่อนที่จะพยายามอัปเกรด ข้อมูลสำรองที่สร้างขึ้นหลังจากการอัปเกรดจะใช้ร่วมกันไม่ได้และใช้งานไม่ได้
  • การหยุดทำงานของ Management API: ในระหว่างการย้อนกลับ LDAP, Management API จะใช้งานไม่ได้ ซึ่งอาจส่งผลต่อการดูแลระบบ ปิดอินสแตนซ์ทั้งหมดของ edge-management-server และ edge-ui ก่อนดำเนินการย้อนกลับ LDAP
  • ความเสี่ยงที่ข้อมูลจะสูญหาย: การดำเนินการต่อโดยไม่มีข้อมูลสำรองที่ถูกต้องและเข้ากันได้อาจทำให้ข้อมูลสูญหายอย่างถาวร
  • ข้อมูลสำรองที่ถูกต้อง: ต้องมีข้อมูลสำรอง LDAP ก่อนการอัปเกรดที่ถูกต้อง
  • การสำรองข้อมูลไฟล์ silent.conf: เก็บข้อมูลสำรองของไฟล์ silent.conf ทั้งจากเวอร์ชันก่อนหน้าและเวอร์ชันปัจจุบันเพื่อป้องกันไม่ให้เกิดความสับสนในการกำหนดค่าระหว่างขั้นตอนการอัปเกรดและการย้อนกลับ
  • ลำดับการย้อนกลับ: ทำตามขั้นตอนการย้อนกลับสำหรับ Cassandra, ZooKeeper, Qpid, PostgreSQL, apigee-sso และ Edge UI ให้เสร็จสิ้นก่อนที่จะย้อนกลับ OpenLDAP

ขั้นตอนการย้อนกลับ

  1. ปิดเซิร์ฟเวอร์การจัดการและ UI: ปิดอินสแตนซ์ edge-management-server และ edge-ui ทั้งหมดก่อนดำเนินการย้อนกลับ LDAP 
    apigee-service edge-management-server stop
apigee-service edge-ui stop
  2. บันทึกจำนวนรายการ LDAP ปัจจุบัน (ก่อนหยุด LDAP): รับจำนวนระเบียนทั้งหมดเพื่อใช้อ้างอิงจากเซิร์ฟเวอร์ LDAP ทั้งหมด โดยแทนที่ YOUR_PASSWORD ด้วยรหัสผ่านผู้จัดการ LDAP ปัจจุบัน (จำนวนระเบียนต้องตรงกันในเซิร์ฟเวอร์ LDAP ทั้งหมด) 
    # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
  3. หยุดและถอนการติดตั้ง LDAP 2.6 ใหม่: หยุดบริการ apigee-openldap และลบไดเรกทอรีการกำหนดค่าและข้อมูล ทำขั้นตอนนี้ในเซิร์ฟเวอร์ LDAP ทั้งหมดทีละโหนดในคลัสเตอร์เพื่อให้มั่นใจว่ามีความสอดคล้องกัน 
    apigee-service apigee-openldap stop
apigee-service apigee-openldap uninstall
rm -rf /opt/apigee/data/apigee-openldap/*
  4. ติดตั้ง LDAP เวอร์ชันก่อนหน้า 2.4.46 หรือ 2.6.7:
    • ติดตั้ง LDAP เวอร์ชันเก่า: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f /opt/silent.conf
    • ตรวจสอบเวอร์ชัน LDAP: 
      source ~/.bash_profile
ldapsearch -VV

# Expected output if rolled back to 4.53.00:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.4.46

# Expected output if rolled back to 4.53.01:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7
    • ทำขั้นตอนย่อยก่อนหน้าในขั้นตอนที่ 4 ซ้ำในแต่ละโหนด LDAP ทีละรายการ
  5. ล้างข้อมูลที่ตกค้าง: หยุดบริการที่ติดตั้งใหม่ในเซิร์ฟเวอร์ LDAP ทั้งหมดทีละรายการ และล้างไดเรกทอรีข้อมูลเพื่อเตรียมพร้อมสำหรับการกู้คืนจากข้อมูลสำรอง โดยทำดังนี้ 
    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/*
  6. กู้คืนข้อมูล LDAP: สำหรับการตั้งค่าเซิร์ฟเวอร์เดียว ให้ไปที่ขั้นตอนที่ 6b โดยตรง สำหรับการตั้งค่าแบบหลายเซิร์ฟเวอร์ ให้ทำตามขั้นตอนที่ 6ก
    1. ระบุเซิร์ฟเวอร์ LDAP ที่ใช้งานอยู่: ก่อนกู้คืนข้อมูล LDAP ให้ระบุเซิร์ฟเวอร์ (ผู้ให้บริการ) ที่ใช้งานอยู่โดยเรียกใช้คำสั่งต่อไปนี้ 
      grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*.ldif
    2. กู้คืนข้อมูล LDAP (ตรวจสอบว่าขั้นตอนที่ 5 เสร็จสมบูรณ์ในเซิร์ฟเวอร์ทั้งหมดก่อนกู้คืน)
      • ในเซิร์ฟเวอร์ LDAP เดียวหรือที่ใช้งานอยู่ (กำหนดในขั้นตอนที่ 6ก) ให้ไปที่ไดเรกทอรีข้อมูลสำรองและกู้คืนข้อมูลสำรองก่อนการอัปเกรด (เช่น 2025.07.28,13.59.00 หรือละเว้นการประทับเวลาหากข้อมูลสำรองก่อนการอัปเกรดเป็นข้อมูลสำรองล่าสุดในไดเรกทอรี) โดยทำดังนี้ 
        cd /opt/apigee/backup/openldap

# To restore a specific backup, provide the timestamp as shown below:
apigee-service apigee-openldap restore 2025.07.28,13.59.00

# Note: If no timestamp is provided, the latest available backup will be restored by default:
apigee-service apigee-openldap restore

# It is recommended to specify the backup explicitly to avoid restoring an unintended version.
      • เริ่มบริการ apigee-openldap 
        apigee-service apigee-openldap start
  7. เริ่มเซิร์ฟเวอร์ LDAP ที่เหลือ: หากคุณมีการตั้งค่าแบบหลายเซิร์ฟเวอร์ ให้เริ่มบริการในเซิร์ฟเวอร์ LDAP ที่เหลือแต่ละเครื่องโดยทำดังนี้ 
    apigee-service apigee-openldap start
  8. การตรวจสอบขั้นสุดท้าย:
    • ตรวจสอบว่าการย้อนกลับสำเร็จและข้อมูลสอดคล้องกันทั่วทั้งคลัสเตอร์ LDAP
    • เรียกใช้คำสั่งตรวจสอบความถูกต้องในเซิร์ฟเวอร์ LDAP ทั้งหมด โดยแทนที่ YOUR_PASSWORD ด้วยรหัสผ่านผู้จัดการ LDAP ปัจจุบัน จำนวนระเบียนต้องเหมือนกันในเซิร์ฟเวอร์ทั้งหมด และต้องตรงกับจำนวนที่คุณบันทึกไว้ในขั้นตอนที่ 2 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • หลังจากยืนยันว่าข้อมูลถูกต้องและสอดคล้องกันแล้ว ให้เริ่ม edge-management-server, edge-ui และคอมโพเนนต์อื่นๆ ที่เกี่ยวข้องตามขั้นตอนมาตรฐานขององค์กร

ย้อนกลับคอมโพเนนต์ Edge

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

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

  • edge-management-server (เซิร์ฟเวอร์การจัดการ)
  • edge-message-processor (ตัวประมวลผลข้อความ)
  • edge-router (เราเตอร์)
  • edge-postgres-server (เซิร์ฟเวอร์ Postgres)
  • edge-qpid-server (เซิร์ฟเวอร์ Qpid)

ตัวอย่างเช่น หากคุณติดตั้ง Management Server, เราเตอร์ และ Message Processor ไว้ในโหนด หากต้องการย้อนกลับรายการใดรายการหนึ่ง คุณต้องย้อนกลับทั้ง 3 รายการ

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

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

    • หากต้องการย้อนกลับไปใช้เวอร์ชัน 4.53.00/4.53.01 ให้ดาวน์โหลด bootstrap_4.53.00.sh/bootstrap_4.53.01.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. หากคุณกำลังย้อนกลับการสร้างรายได้ ให้ถอนการติดตั้งจากโหนด Management Server และ Message Processor ทั้งหมด โดยทำดังนี้ 
    /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. วิธีย้อนกลับ Nginx 
      ### Find the apigee-nginx RPM
rpm -qa | grep -i "apigee-nginx"

### Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.30.x
    3. หากต้องการย้อนกลับคอมโพเนนต์อื่นๆ ในโหนด ให้ถอนการติดตั้งเฉพาะคอมโพเนนต์นั้น ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

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

    4. หากต้องการย้อนกลับ Edge Router คุณต้องลบเนื้อหาของไฟล์ /opt/nginx/conf.d นอกเหนือจากการถอนการติดตั้งกลุ่มคอมโพเนนต์ edge-gateway ดังนี้ 
      cd /opt/nginx/conf.d
rm -rf *
  5. ถอนการติดตั้ง apigee-setup เวอร์ชัน 4.54.00 โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. ติดตั้งยูทิลิตี apigee-service เวอร์ชัน 4.53.00 และทรัพยากร Dependency ตัวอย่างต่อไปนี้จะติดตั้ง apigee-service เวอร์ชัน 4.53.00 
    sudo bash /tmp/bootstrap_4.53.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. ทำกระบวนการนี้ซ้ำกับแต่ละโหนดที่โฮสต์คอมโพเนนต์ที่คุณ กำลังย้อนกลับ

ย้อนกลับ 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