ย้อนกลับ Apigee Edge 4.52.00

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

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

  • เวอร์ชัน 4.51.00

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

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

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

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

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

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

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

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

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

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

ย้อนกลับไปใช้ฟีเจอร์ที่ออกก่อนหน้า

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

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

    • หากต้องการย้อนกลับไปใช้เวอร์ชัน 4.51.00 ให้ดาวน์โหลด bootstrap_4.51.00.sh ดังนี้ 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/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. หากคุณกำลังย้อนกลับการสร้างรายได้ ให้ถอนการติดตั้งจากโหนด Management Server และ Message Processor ทั้งหมด โดยทำดังนี้ 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. ถอนการติดตั้งคอมโพเนนต์เพื่อย้อนกลับในโหนด โดยทำดังนี้
    1. หากต้องการย้อนกลับคอมโพเนนต์ที่มีโค้ดทั่วไปในโหนด คุณต้องถอนการติดตั้งคอมโพเนนต์ทั้งหมดโดยถอนการติดตั้งกลุ่มคอมโพเนนต์ edge-gateway ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. หากต้องการย้อนกลับคอมโพเนนต์อื่นๆ ในโหนด ให้ถอนการติดตั้งเฉพาะคอมโพเนนต์นั้น ดังตัวอย่างต่อไปนี้ 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

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

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

    เช่น

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

    เช่น

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

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

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

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

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

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

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

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

  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 Master โดยทำดังนี้
    1. โปรโมตโหนดสแตนด์บายใหม่ให้เป็นมาสเตอร์ใหม่ โดยทำดังนี้ 
      apigee-service apigee-postgresql promote-standby-to-master new_standby_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
    3. ลบไดเรกทอรีข้อมูล Postgres ออกจากโหนดสแตนด์บายเก่า โดยทำดังนี้ 
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    4. ดาวน์โหลดและเรียกใช้ Bootstrap เวอร์ชันเก่า (สำหรับเวอร์ชัน Apigee ที่คุณจะย้อนกลับไป) ในโหนดสแตนด์บายเก่า ขั้นตอนที่แน่นอนอาจแตกต่างกันไปโดยขึ้นอยู่กับว่าคุณใช้การติดตั้งผ่านอินเทอร์เน็ตหรือแบบออฟไลน์ การเรียกใช้บูตสแตรป Apigee เวอร์ชันเก่าจะตั้งค่าที่เก็บ 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 หลักเก่าโดยใช้ขั้นตอนในหัวข้อการเลิกใช้งานโหนด Postgres

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

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