ย้อนกลับ Apigee Edge 4.51.00

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

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

  • เวอร์ชัน 4.50.00
  • เวอร์ชัน 4.19.06

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

  1. ย้อนกลับไปใช้การเปิดตัวฟีเจอร์ก่อนหน้านี้ เช่น ตั้งแต่ 4.51.00 ถึง 4.50.00
  2. ย้อนกลับไปเป็นเวอร์ชันอัปเดตก่อนหน้าในรุ่นเดียวกัน เช่น ตั้งแต่ 4.50.00.02 ถึง 4.50.00.01

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

ใครทำการย้อนกลับได้

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

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

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

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

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

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

ย้อนกลับไปยังการเปิดตัวฟีเจอร์ก่อนหน้านี้

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

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

    • หากต้องการย้อนกลับไปเป็น 4.50.00 ให้ดาวน์โหลด bootstrap_4.50.00.sh: 
      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
    • หากต้องการย้อนกลับไปเป็น 4.19.06 ให้ดาวน์โหลด bootstrap_4.19.06.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.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. หากคุณจะย้อนกลับการสร้างรายได้ ให้ถอนการติดตั้งจากเซิร์ฟเวอร์การจัดการและโหนดผู้ประมวลผลข้อมูลข้อความทั้งหมด: 
    /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 คุณต้องลบเนื้อหาของไฟล์ /opt/nginx/conf.d นอกเหนือไปจากการถอนการติดตั้งกลุ่มคอมโพเนนต์ edge-gateway: 
      cd /opt/nginx/conf.d
rm -rf *
  5. ถอนการติดตั้ง apigee-setup เวอร์ชัน 4.51.00: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. ติดตั้งยูทิลิตี apigee-service เวอร์ชัน 4.19.06 หรือ 4.50.00 และทรัพยากร Dependency ตัวอย่างต่อไปนี้ติดตั้ง apigee-service เวอร์ชัน 4.50.00: 
    sudo bash /tmp/bootstrap_4.50.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.18.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.19.06 หรือ 4.50.00 เป็นเวอร์ชัน 4.51.00 คุณต้องย้อนกลับการอัปเดต Postgres นอกเหนือจากคอมโพเนนต์ Edge

หากต้องการย้อนกลับการอัปเดต Postgres เมื่ออัปเดต Postgres ในการกำหนดค่าสแตนด์บายหลัก ให้ทำดังนี้

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

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

  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 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 hattrap เวอร์ชันเก่าจะตั้งค่าที่เก็บ 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

    คำสั่งนี้จะแสดงชื่อกลุ่มข้อมูลวิเคราะห์ในช่อง 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 จะเรียงลำดับเหมือนกับที่ปรากฏด้านบนเมื่อคุณดูข้อมูล Analytics และข้อมูลกลุ่มผู้บริโภคด้านบน โดยคุณอาจต้องระบุเป็น standbyUUID,masterUUID

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

  12. นำโหนดหลักและโหนดสแตนด์บายเดิมออกจากกลุ่มการวิเคราะห์: 
    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 ใหม่กับ Analytics และกลุ่มผู้บริโภคดังนี้
    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 เดิมโดยใช้ขั้นตอนในอัปเดต Apigee Edge 4.16.01/4.16.05 เป็น 4.17.09

    หรือคุณจะถอนการติดตั้ง 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