ย้อนกลับ Apigee Edge 4.52.01

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

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

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

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

  1. ย้อนกลับไปดูรุ่นหลักหรือรุ่นย่อยก่อนหน้านี้ ตัวอย่างเช่น จาก 4.52.01 ถึง 4.52.00
  2. เปลี่ยนกลับไปใช้แพตช์รุ่นก่อนหน้าในรุ่นเดียวกัน ตัวอย่างเช่น จาก 4.52.00.02 เป็น 4.52.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)

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

ย้อนกลับไปใช้เวอร์ชันหลักหรือเวอร์ชันย่อยก่อนหน้า

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

  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. หากคุณจะย้อนกลับการสร้างรายได้ ให้ถอนการติดตั้งจากเซิร์ฟเวอร์การจัดการและข้อความทั้งหมด โหนดโปรเซสเซอร์: 
    /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.01: 
    /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.01 จากเวอร์ชัน 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 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 เป็นชื่อเริ่มต้นของฟิลด์ Analytics และกลุ่มผู้บริโภค 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. ยืนยันสถานะการจำลองโดยการออกสคริปต์ต่อไปนี้บนเซิร์ฟเวอร์ทั้งสอง ระบบ ควรแสดงผลลัพธ์ที่เหมือนกันทั้งสองเซิร์ฟเวอร์เพื่อให้การจำลองสำเร็จ:

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

    /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