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

ตัวอย่างเช่น ถ้าคุณมีเซิร์ฟเวอร์การจัดการ เราเตอร์ และโปรแกรมประมวลผลข้อความติดตั้งอยู่ ถ้าต้องการย้อนกลับโหนดใดโหนดหนึ่ง คุณต้องย้อนกลับทั้ง 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 Router คุณต้องลบเนื้อหาของ /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 ของระบบ ตัวอย่างต่อไปนี้ติดตั้งเวอร์ชัน 4.50.00 apigee-service: 
    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.51.00 จากเวอร์ชัน 4.19.06 หรือ 4.50.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 เวอร์ชันที่คุณกำลังอัปโหลดอยู่ กลับไป) ในโหนดสแตนด์บายเดิม ขั้นตอนที่แน่นอนอาจแตกต่างกันไปตามว่าคุณใช้ การติดตั้งผ่านอินเทอร์เน็ตหรือออฟไลน์ การเรียกใช้ Bootstrapped ของ 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 เป็นชื่อเริ่มต้นของฟิลด์ Analytics และกลุ่มผู้บริโภค masterUUID,standbyUUID อยู่ในลำดับเดียวกันกับ ปรากฏด้านบนเมื่อดูข้อมูล Analytics และข้อมูลกลุ่มผู้ใช้ทั่วไปด้านบน คุณ อาจต้องระบุเป็น 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 แบบเดิมโดยใช้ขั้นตอนใน อัปเดต 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