ย้อนกลับ 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 (ตัวประมวลผลข้อความ)
  • 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.00: วันที่ 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. ติดตั้ง apigee-service เวอร์ชัน 4.51.00 ยูทิลิตีและ Dependency ของระบบ ตัวอย่างต่อไปนี้ติดตั้งเวอร์ชัน 4.51.00 apigee-service: วันที่ 
    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 ในการกำหนดค่าสแตนด์บายหลัก

  • เลื่อนขั้นโหนดสแตนด์บายใหม่ให้เป็นต้นแบบ 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 แบบเดิมโดยใช้ขั้นตอนใน การเลิกใช้งาน โหนด 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