4.18.01 عملية العودة إلى الحالة السابقة

الإصدار 4.18.01 من Edge for Private Cloud

في حالة حدوث خطأ أثناء التحديث إلى Edge 4.18.01، يمكنك إعادة المكون الذي تسبب في الخطأ ثم حاول التحديث مرة أخرى. على سبيل المثال، إذا كان التحديث إلى الإصدار 9.6 من Postgres يمكنك العودة إلى عُقد Postgres فقط ومحاولة التحديث مرة أخرى.

هناك حالتان قد تحتاج فيهما إلى العودة إلى الإصدار السابق:

  1. العودة إلى إصدار قديم على سبيل المثال من 4.18.01 إلى 4.17.01.
  2. العودة إلى إصدار سابق في الإصدار نفسه

استخدِم الإجراء أدناه للعودة إلى الحالة السابقة لكلا السيناريوهَين.

المستخدمون الذين يمكنهم تنفيذ العودة إلى الحالة السابقة

يجب أن يكون المستخدم الذي يجري العودة إلى الإصدار السابق هو نفسه المستخدم الذي حدّث متصفح Edge في الأصل، أو مستخدم يعمل كجذر.

بشكل تلقائي، يتم تشغيل مكونات Edge باعتبارها واجهة المستخدم "apigee". في بعض الحالات، قد تستخدم شبكة Edge والمكونات كمستخدمين مختلفين. على سبيل المثال، إذا كان على جهاز التوجيه الوصول إلى المنافذ المميزة، مثل تلك التي كانت أقل من 1, 000، عليك تشغيل جهاز التوجيه كجذر أو كمستخدم لديه إذن بالوصول إلى هذه الأجهزة متعددة. أو، يمكنك تشغيل مكون واحد كمستخدم واحد، ومكون آخر كمستخدم آخر.

المكوّنات التي يمكن التراجع عنها

يجب أن تكون على دراية بالشروط التالية عند تنفيذ العودة إلى الإصدارات السابقة:

  • تشترك مكونات Edge الخمسة المذكورة أدناه في رمز مشترك. لذلك، يمكن التراجع عن أي من المكونات الخمسة في أي عقدة، يجب عليك إرجاع أي من المكونات الخمسة المثبتة على العقدة. بالنسبة فإذا كان خادم الإدارة وجهاز التوجيه ومعالج الرسائل مثبتًا على للخروج من أي منها، يجب العودة إلى جميع الأجزاء الثلاثة.

    المكونات الخمسة التي تشترك في التعليمة البرمجية هي:

    • خادم الإدارة
    • جهاز التوجيه
    • معالج الرسائل
    • خادم Qpid
    • خادم Postgres
  • إذا كنت تجري التحديث من الإصدار 4.16.01 من Edge (Edge)، فلا تُرجع Cassandra. هذا النمط يحتوي إصدار Edge على إصدار محدَّث من Cassandra. في حال العودة إلى الإصدارات السابقة لأي مكوّنات، اترك كاساندرا بالإصدار 4.18.01.

العودة إلى الإصدار السابق من 4.18.01

يحتوي هذا القسم على الإجراء للعودة إلى الإصدار السابق من Edge 4.18.01. هذا النمط ينقسم إلى جزأين:

  • التراجع عن تحديث Postgres
    الجزء الأخير من كل إجراء تحديث هو تحديث عُقد Postgres إلى الإصدار 9.6. إذا كان ذلك أخفق التحديث، فيمكنك حينئذٍ استخدام هذا الإجراء للعودة إلى النسخة السابقة من التحديث.
  • إعادة جميع مكونات Edge الأخرى
    استخدم هذا الإجراء للعودة إلى أي من مكونات Edge الأخرى.

العودة إلى الإصدار السابق من تحديث Postgres 9.6

للعودة إلى الإصدار السابق من تحديث 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. إعادة إنشاء عقدة الاستعداد القديمة:
    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

      إذا لم يكن قيد التشغيل، ابدأ التشغيل:

      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  6. تحقق من إضافة عقدة وضع الاستعداد الجديدة من خلال عرض ملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على الشريحة الرئيسية الجديدة.
  7. يمكنك الاطّلاع على الإحصاءات الحالية ومعلومات عن مجموعات المستهلكين من خلال تنفيذ الأمر التالي. على خادم الإدارة: 
    > 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" : {
  }
}
  8. احصل على عنوان المعرّف الفريد العالمي (UUID) للجهاز الرئيسي القديم من خلال تشغيل أمر cURL التالي على العقدة الرئيسية: 
    > curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    من المفترض أن يظهر لك المعرّف الفريد العالمي للعقدة في نهاية الإخراج، على النحو التالي: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  9. كرر الخطوة السابقة للحصول على عناوين IP لعقدة الاستعداد القديمة والجديدة رئيسي.
  10. إزالة عُقدتي الرئيسية والاستعداد القديمة من مجموعة المستهلكين: 
    > 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 الآن على النحو التالي: فارغ.

  11. إزالة عُقد البيانات الرئيسية وعقود الاستعداد القديمة من مجموعة الإحصاءات: 
    > 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 فارغة الآن.

  12. تسجيل عُقد 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
  13. التحقّق من صحة مجموعة الإحصاءات: 
    > curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    من المفترض أن تظهر لك المعرّفات الفريدة العالمية (UUID) للعُقد الرئيسية والاستعداد الجديد والمدرَجة في مجموعة الإحصاءات مجموعة المستهلكين.

  14. أعِد تشغيل خادم إدارة Edge: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  15. أعِد تشغيل جميع خوادم Qpid:
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  16. أعِد تشغيل جميع خوادم Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  17. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. النظام يجب أن تعرض نتائج متطابقة على كلا الخادمين لضمان النسخ المتماثل بنجاح:

    في الشريحة الرئيسية الجديدة، شغِّل: 

    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    تحقق من أنه العنوان الرئيسي. في نقطة الاستعداد القديمة: 

    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    تأكَّد من أنّ الجهاز في وضع الاستعداد.

  18. كرِّر الخطوة السابقة بعد إجراء العديد من طلبات واجهة برمجة التطبيقات لضمان وجود العُقد في المزامنة.
  19. إلغاء تفويض مشرف Postgres القديم باستخدام الإجراء في تحديث Apigee Edge من 4.16.01/4.16.05 إلى 4.17.09.

    وبدلاً من ذلك، يمكنك إلغاء تثبيت Qpid من الصفحة الرئيسية القديمة وتثبيت Qpid على الصفحة الرئيسية الجديدة. كما هو موضح أدناه. بعد إلغاء تثبيت Qpid، يمكنك إلغاء تفويض الصفحة الرئيسية القديمة. العقدة.

إلغاء تثبيت Qpid من الشريحة الرئيسية القديمة وتثبيت Qpid على الصفحة الرئيسية الجديدة

استخدم الإجراء التالي لإزالة Qpid من الصفحة الرئيسية القديمة وتثبيته على التطبيق الجديد المشرف:

  1. حظر الوصول إلى منفذ Qpid رقم 5672 على الشريحة الرئيسية القديمة من الوصول بواسطة معالجات الرسائل من خلال تشغيل الأمر التالي على جميع معالِجات الرسائل: 
    > iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
  2. تأكَّد من أن قائمة انتظار رسائل Qpid فارغة من خلال تشغيل الأمر التالي. لا يمكنك إلغاء تثبيت Qpid إلى أن تتم معالجة جميع الرسائل المعلّقة: 
    > qpid-stat -q

    يعرض هذا الأمر جدولاً يحتوي على عدد msg, msgIn, and msgOut. ستتم معالجة جميع الرسائل عند msg=0 وmsgIn=msgOut.

  3. تحديد المعرّف الفريد العالمي لخادم Qpid على الشبكة الرئيسية القديمة من خلال تنفيذ الأمر التالي على الرئيسي القديم. احفظ هذه المعلومات لوقت لاحق في الإجراء: 
    > curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
  4. إيقاف Qpid على الشريحة الرئيسية القديمة: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
  5. إلغاء تثبيت خادم Qpid: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall
  6. أزِل خادم Qpid القديم من الإحصاءات ومجموعات المستهلكين: 
    > curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/qpid_UUID" -v
> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v
  7. إزالة خادم Qpid القديم من Zookeeper: 
    > curl -u sysAdminEmail:password -X DELETE
  http://ms_IP:8080/v1/servers/qpid_UUID
  8. تثبيت Qpid على الشريحة الرئيسية الجديدة: 
    > /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  9. تحديد المعرّف الفريد العالمي لخادم Qpid على الوحدة الرئيسية الجديدة من خلال تشغيل الأمر التالي على الرئيسي الجديد. احفظ هذه المعلومات لوقت لاحق في الإجراء: 
    > curl -u sysAdminEmail:password
  http://node_IP::8083/v1/servers/self
  10. سجِّل خادم Qpid الجديد لدى الإحصاءات ومجموعات المستهلكين: 
    > curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-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/consumers?uuid=qpid_UUID" -v
  11. إعادة تشغيل جميع معالِجات الرسائل: 
    > /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  12. شغِّل الأمر التالي على خادم Qpid الجديد للتأكّد من إنشاء قوائم الانتظار:
    > qpid-stat -q

    تأكَّد من أنّك ترى الرسالة وmsgIn وmsgOut يتم تحديثها كخادم Qpid وتعالج الرسائل.

للعودة إلى الإصدارات السابقة من مكونات فردية من 4.18.01

كجزء من تنفيذ العودة إلى الإصدارات السابقة، يجب تنزيل ملف Bootstrap.sh على الإصدار الحالي من Edge:

  • للرجوع إلى الإصدار 4.17.09، يمكنك تنزيل bootstrap_4.17.09.sh
  • للرجوع إلى الإصدار 4.17.05، يمكنك تنزيل bootstrap_4.17.05.sh
  • للرجوع إلى الإصدار 4.17.01، يمكنك تنزيل bootstrap_4.17.01.sh
  • للرجوع إلى الإصدار 4.16.09، يمكنك تنزيل bootstrap_4.16.09.sh
  • للرجوع إلى الإصدار 4.16.05، يمكنك تنزيل bootstrap_4.16.05.sh
  • للرجوع إلى الإصدار 4.16.01، يمكنك تنزيل bootstrap.sh

لكل عقدة تستضيف مكوِّنًا للرجوع إلى الإصدار السابق:

  1. أوقِف المكوِّن للعودة إلى الحالة السابقة:
    1. في حالة العودة إلى الإصدار السابق من أي من المكونات التالية على العقدة، يجب إيقاف الكل: خادم الإدارة، جهاز التوجيه، معالج الرسائل، خادم Qpid، أو Postgres الخادم: 
      • > apigee-service edge-management-server stop
      • > apigee-service edge-router stop
      • > apigee-service edge-message-processor stop
      • > apigee-service edge-qpid-server stop
      • > apigee-service edge-postgres-server stop
    2. في حال إعادة أي مكوّن آخر على العقدة، أوقِف ذلك المكوّن الإضافي: 
      • > apigee-service comp stop
  2. في حال العودة إلى الإصدار السابق من ميزة "تحقيق الربح"، يجب إلغاء تثبيتها من كلّ من "خادم الإدارة" و"الرسائل" عُقد المعالج: 
    > apigee-service edge-mint-gateway uninstall
  3. ألغِ تثبيت المكوِّن للعودة إلى النسخة السابقة من العقدة:
    1. في حال العودة إلى نسخة سابقة من أي من المكوّنات التالية على العقدة، إذًا إلغاء تثبيتها جميعًا: خادم الإدارة أو جهاز التوجيه أو معالج الرسائل أو خادم Qpid أو Postgres الخادم: 
      > apigee-service edge-gateway uninstall
    2. في حال العودة إلى الإصدارات السابقة لأي مكوّن آخر على العقدة، يجب إلغاء تثبيت المكوّن الإضافي: 
      > apigee-service comp uninstall
    3. إذا كنت تعمل على إعادة جهاز التوجيه، يجب حذف محتوى /opt/nginx/conf.d: 
      > cd /opt/nginx/conf.d
> rm -rf *
  4. لإعادة المكوِّن إلى الحالة السابقة:
    1. إلغاء تثبيت الإصدار 4.18.01 من apigee-setup: 
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
    2. نزِّل Bootstrap.sh للإصدار المطلوب: على سبيل المثال، للإصدار 4.16.09: 
      > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
    3. ثبِّت الأداة 4.16.01 أو 4.16.05 أو 4.16.09 apigee-service من أجل والتبعيات لديك. على سبيل المثال، بالنسبة إلى 4.16.09: 
      > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

      حيث يشير uName وpWord إلى اسم المستخدم وكلمة المرور اللذين تلقّيتهما من Apigee. إذا لم يتم حذف pWord، سيُطلب منك إدخال. بها.

    4. تثبيت "apigee-setup": 
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. تثبيت الإصدار المطلوب من المكوِّن: 
      > /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

      حيث comp هو المكون الذي يجب تثبيته وconfigFile هو ملف الإعداد للإصدار المطلوب.

    6. في حال العودة إلى الإصدار السابق من Qpid، يتم مسح iptables: 
      > sudo iptables -F
  5. لإعادة المكوِّن إلى إصدار سابق من الإصدار 4.18.01:
    1. قم بتنزيل إصدار المكون المحدد: 
      > /opt/apigee/apigee-service/bin/apigee-service comp-version install

      حيث comp-version هو المكون والإصدار المطلوب تثبيته. على سبيل المثال: 

      > /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-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

      لاحظ كيف يمكنك تحديد اسم المكوِّن عند إجراء التثبيت فقط.

يُرجى التواصل مع فريق دعم Apigee Edge في حال مواجهة مشاكل عند العودة إلى الإصدار السابق.