العودة إلى الإصدار السابق Apigee Edge 4.19.01

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

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

يمكنك إعادة الإصدار 4.19.01 من Edge إلى إصدارات إصدار الميزات التالية:

  • الإصدار 4.18.05
  • الإصدار 4.18.01
  • الإصدار 4.17.09*

* للرجوع من 4.19.01 إلى 4.17.09، يجب عليك العودة إلى Postgres بالإضافة إلى التراجع عن المكونات على كل عقدة. في حال العودة إلى الإصدار 4.18.01 أو 4.18.05، لن تحتاج إلى العودة إلى الإصدار السابق Postgres أثناء الترقية. لم تتضمن عملية تحديث Postgres.

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

  1. الرجوع إلى إصدار ميزة سابق على سبيل المثال من من 4.19.01 إلى 4.18.05.
  2. العودة إلى إصدار تحديث سابق في الإصدار نفسه بالنسبة على سبيل المثال، من 4.19.01.02 إلى 4.19.01.01.

لمزيد من المعلومات، يُرجى الاطّلاع على إصدار Apigee Edge .

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

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

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

المكونات ذات الرمز الشائع

تشترك مكونات Edge التالية في الرمز المشترك. لذلك، يمكن إرجاع أي من هذه المكونات على عقدة، يجب عليك إرجاع جميع هذه المكونات الموجودة على تلك العقدة.

  • edge-management-server (خادم الإدارة)
  • edge-message-processor (معالج الرسائل)
  • edge-router (جهاز توجيه)
  • edge-postgres-server (خادم Postgres)
  • edge-qpid-server (خادم Qpid)

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

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

للرجوع من 4.19.01 إلى 4.17.09، يجب إعادة الحسابات إلى الحالة السابقة Postgres بالإضافة إلى العودة إلى الحالة السابقة للمكوّنات على كل عقدة. في حال العودة من الإصدار 4.18.01 أو 4.18.05، لن تحتاج إلى العودة إلى الإصدار السابق من Postgres أثناء الترقية. لم تتضمن عملية تحديث Postgres.

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

  1. يجب تنزيل ملف bootstrap.sh للإصدار الذي تريد الانتقال إليه. رجوع:

    • للرجوع إلى الإصدار 4.18.05، يمكنك تنزيل bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    • للعودة إلى الإصدار 4.18.01، نزِّل bootstrap_4.18.01.sh: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
    • للعودة إلى الإصدار 4.17.09، يُرجى تنزيل bootstrap_4.17.09.sh: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.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. إلغاء تثبيت الإصدار 4.19.01 من apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. تثبيت الإصدار 4.18.05 أو 4.18.01 أو 4.17.09 من apigee-service وتبعياته. يوضح المثال التالي تثبيت الإصدار 4.17.09 من apigee-service: 
    sudo bash /tmp/bootstrap_4.17.09.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. كرر هذه العملية لكل عقدة تستضيف المكون الذي تقوم بالعودة إليه.

للرجوع من 4.19.01 إلى 4.17.09، يجب إعادة الحسابات إلى الحالة السابقة Postgres بالإضافة إلى العودة إلى الحالة السابقة للمكوّنات على كل عقدة. في حال العودة من الإصدار 4.18.01 أو 4.18.05، لن تحتاج إلى العودة إلى الإصدار السابق من Postgres أثناء الترقية. لم تتضمن عملية تحديث Postgres.

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

لإعادة مكوِّن إلى إصدار معيّن من إصدار، عليك اتّباع الخطوات التالية في كل عقدة الذي يستضيف المكون:

  1. قم بتنزيل إصدار المكون المحدد: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    تتيح لك السياسة component_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

    لاحظ أنك تحدد اسم المكوِّن فقط عند تثبيته، وليس الإصدار.

  3. كرر هذه العملية لكل عقدة تستضيف المكون الذي تقوم بالعودة إليه.

للرجوع من 4.19.01 إلى 4.17.09، يجب إعادة الحسابات إلى الحالة السابقة Postgres بالإضافة إلى العودة إلى الحالة السابقة للمكوّنات على كل عقدة. في حال العودة من الإصدار 4.18.01 أو 4.18.05، لن تحتاج إلى العودة إلى الإصدار السابق من Postgres أثناء الترقية. لم تتضمن عملية تحديث Postgres.

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

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

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

  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

    تأكَّد من ظهور msg وmsgIn وmsgOut. بينما يعالج خادم Qpid الرسائل.

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