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

Edge for Private Cloud - الإصدار 4.17.01

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

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

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

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

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

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

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

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

يجب أن تكون على دراية بالشروط التالية عند إجراء تراجع:

  • تشترك مكونات Edge الخمسة المدرجة أدناه في رمز مشترك. بالتالي، للعودة إلى إصدار سابق من أي من المكونات الخمسة على عقدة، يجب إرجاع أي من المكونات الخمسة المثبّتة على العقدة. على سبيل المثال، إذا كان لديك خادم الإدارة وجهاز التوجيه ومعالج الرسائل مثبّتًا في العقدة، يجب الرجوع إلى جميع هذه الأجهزة الثلاثة.
    المكوّنات الخمسة التي تتشارك الرمز هي:
    • خادم الإدارة
    • جهاز التوجيه
    • معالج الرسائل
    • خادم Qpid
    • خادم Postgres
  • إذا كنت تقوم بالتحديث من الإصدار 4.16.01 من Edge، لا تتراجع عن Cassandra. يتضمّن هذا الإصدار من Edge إصدارًا محدَّثًا من Cassandra. في حال العودة إلى إصدار سابق من أي مكوّنات، اترك Cassandra في الإصدار 4.17.01.

العودة إلى الإصدار السابق 4.17.01

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

  • في حال التحديث من الإصدار 4.16.01 أو 4.16.05 فقط، سيتم الرجوع إلى الإصدار 9.4 من Postgres.
    الجزء الأخير من كل إجراء تحديث بدايةً من 4.16.01 أو 4.16.05 هو تحديث عُقد Postgres إلى الإصدار 9.4. وإذا تعذّر إجراء التحديث، يمكنك استخدام هذا الإجراء للتراجع عن التحديث.
  • إعادة جميع مكونات Edge الأخرى
    استخدم هذا الإجراء لإعادة أي مكونات Edge الأخرى.

للتراجع عن تحديث Postgres 9.4

للتراجع عن تحديث Postgres عند تحديث Postgres في إعداد وضع الاستعداد الرئيسي، عليك إجراء ما يلي:

  • ترقية عقدة وضع الاستعداد الجديدة لتصبح المشرف الرئيسي في Postgres. وسيكون إصدار Postgres الرئيسي الجديد هو الإصدار نفسه الذي تم تثبيته عليه سابقًا.
  • قم بتهيئة عقدة وضع الاستعداد القديمة لتكون عقدة وضع الاستعداد للشريحة الرئيسية الجديدة. وستكون عقدة وضع الاستعداد القديمة هي نفسها إصدار 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 بدء-postgres-servicestope/apigee-servicestope/postgres/apigee-servicestope/apigee-all status
    في حال إيقاف Postgres.
  3. في حال التثبيت، ابدأ Qpid على عقدة وضع الاستعداد القديمة:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start

    ملاحظة: في العديد من الإعدادات، ستستضيف عقدة وضع الاستعداد القديمة Postgres فقط وليس Qpid.
  4. الترويج لعقدة وضع الاستعداد الجديدة باعتبارها وحدة Postgres الرئيسية:
    1. الترويج لعقدة وضع الاستعداد الجديدة لتصبح الكلمة الرئيسية الجديدة:
      > apigee-service apigee-postgresql promotion- ready-to-master new_stockby_IP

      إذا طُلب منك ذلك، أدخِل كلمة مرور Postgres لمستخدم "apigee"، الذي يتم ضبطه تلقائيًا على "postgres".
    2. عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
      # عنوان IP للواجهة الرئيسية الجديدة:
      PG_MASTER=new_standby_IP
      # عنوان IP لعقدة وضع الاستعداد القديم
      PG_STANDBY=old_ Standby_IP
    3. اضبُط النسخة الرئيسية الجديدة:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replction-on-master -f configFile
  5. أعِد إنشاء عقدة وضع الاستعداد القديمة:
    1. عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
      عنوان IP واحد للواجهة الرئيسية الجديدة:
      PG_MASTER=new_stockby_IP
      # عنوان IP لعقدة وضع الاستعداد القديم
      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-replction-on-stockby -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-groups. ويعرض أيضًا المعرّفات الفريدة العالمية لعُقد Postgres الرئيسية والاستعداد القديمة في الحقل postgres-server وفي حقل مخازن البيانات. {b6-dc-4-dc-12-32-3 "b2-3 "b2-3 "b/


















  8. "






    إذا كان خادم Postgres لا يعمل، يمكنك تشغيل الأمر التالي على خادم الإدارة لتحديد المعرّف الفريد العالمي (UUID):
    > curl -u sysAdminEmail:password http://<ms_IP>:8080/v1/servers?pod=analytics

    يسرد ناتج هذا الأمر المعرّف الفريد العالمي لعنوان IP لكل عقدة Postre.
  9. كرِّر الخطوة السابقة للحصول على عناوين IP لعقدة وضع الاستعداد القديمة وعقدة جديدة.
  10. أزل العُقد الرئيسية القديمة والجاهزة من مجموعة المستهلكين:
    > curl -u sysAdminEmail:password -X DELETE "http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-UID-001/data data

     تكون المَعلمة masterUUID,StandbyUUID بالترتيب نفسه الذي ظهر أعلاه عند عرض الإحصاءات الحالية ومعلومات مجموعة المستهلكين أعلاه. وقد تحتاج إلى تحديدهما على النحو التالي: StandbyUUID,masterUUID.

    يجب أن تكون سمة مخازن البيانات لمجموعات المستهلكين فارغة الآن.
  11. أزِل العُقدة الرئيسية والاستعدادية القديمة من مجموعة الإحصاءات:
    > curl -u sysAdminEmail:password -X DELETE "http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID-postes shouldby
    masterUUID-server-server

  12. "عليك التسجيل


  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 إعادة تشغيل
  15. أعِد تشغيل جميع خوادم Qpid:
    > /opt/apigee/apigee-service/bin/apigee-serviceedge-qpid-server إعادة تشغيل
  16. أعِد تشغيل جميع خوادم Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server إعادة تشغيل
  17. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. من المفترض أن يعرض النظام نتائج متطابقة على كلا الخادمين لضمان إجراء نسخ متماثل بنجاح:

    على الخادم الرئيسي الجديد، شغِّل:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    تحقّق من أنه المشرف الرئيسي.

    في عقدة وضع الاستعداد القديمة:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-frontby

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

    ملاحظة: إذا كانت العُقدة الرئيسية القديمة تشغّل Qpid، يمكنك ترك هذا الخادم قيد التشغيل لتشغيل Qpid. يُرجى التأكّد من أنّه قيد التشغيل. إذا لم يكن الأمر كذلك، ابدأ تشغيله:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-management-server start

    بدلاً من ذلك، يمكنك إلغاء تثبيت 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 و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 off
    > /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd تستخدمه
  5. إلغاء تثبيت خادم Qpid:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server إزالة
    > /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd إلغاء تثبيت

  6. > curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d 's 'http://<ms_IP>:8080/v1/analytics/groups/ax/axgroup/consumer-001

  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/server-001

  11. أعِد تشغيل جميع معالِجات الرسائل:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-message-processor إعادة تشغيل
  12. نفِّذ الأمر التالي على خادم Qpid الجديد للتحقّق من أنه تم إنشاء قوائم الانتظار:
    > qpid-stat -q

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

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

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

  • للرجوع إلى 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
      • > إيقاف جهاز توجيه الحافة لخدمة apigee
      • > إيقاف apigee-service Edge-messageمعالج البيانات
      • > apigee-service Edge-qpid-server إيقاف
      • > إيقاف خادم apigee-service Edge-postgres-server
    2. في حال التراجع عن أي مكوِّن آخر في العقدة، أوقِف هذا المكوّن فقط:
      • > إيقاف apigee-service comp
  2. في حال العودة إلى استخدام ميزة تحقيق الربح، يجب إلغاء تثبيتها من كل عُقد خادم الإدارة ومعالج الرسائل:
    > إلغاء تثبيت apigee-service Edge-mint-gateway.
  3. ألغِ تثبيت المكوِّن للعودة إلى الحالة السابقة على العُقدة:
    1. في حال استعادة أي من المكوّنات التالية على العقدة، يجب إلغاء تثبيت كل هذه المكوّنات: خادم الإدارة أو جهاز التوجيه أو معالج الرسائل أو خادم Qpid أو خادم Postgres:
      > إلغاء تثبيت بوابة الحافة لخدمة apigee
    2. إذا كنت تريد استعادة أي مكوِّن آخر على العُقدة، عليك إلغاء تثبيت هذا المكوّن فقط:
      > apigee-service comp إلغاء تثبيت
    3. إذا كنت تعود جهاز التوجيه إلى الحالة السابقة، عليك حذف محتوى /opt/nginx/conf.d:
      > cd /opt/nginx/conf.d
      > rm -rf *
  4. للتراجع عن المكوِّن:
    1. ألغِ تثبيت الإصدار 4.17.01 من apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup إلغاء
    2. عليك تنزيل Bootstrap.sh للإصدار 4.16.01 أو 4.16.05 أو 4.16.09:

      على سبيل المثال، للإصدار 4.16.09:
      > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /trap_9
    3. ثبِّت الأداة المساعدة apigee-service أو 4.16.01 أو 4.16.05 أو 4.16.09 والتبعيات.

      على سبيل المثال، بالنسبة إلى الإصدار 4.16.09:
      > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord

      حيث يكون كل من uName وpWord هما اسم المستخدم وكلمة المرور إذا حذفت pWord، سيُطلب منك إدخالها.
    4. ثبِّت الإصدار 4.16.01 أو 4.16.05 أو 4.16.09 من apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. ثبِّت الإصدار 4.16.01 أو 4.16.05 أو 4.16.09 من المكوِّن:
      > /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

      حيث يكون .comp هو المكوّن الذي تريد تثبيته، 4. 4.6 أو .4 comp.
    6. في حال الرجوع إلى Qpid، اضغط على iptables:
      > sudo iptables -F
  5. لإعادة المكوّن إلى إصدار محدد من الإصدار 4.17.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.01-0.0.3749 install

      إذا كنت تستخدم مستودع Apigee على الإنترنت، يمكنك تحديد إصدارات المكوّنات المتاحة باستخدام الأمر التالي: > yum --showshows list



    2. استخدِم apigee-setup لتثبيت المكوِّن:
      > /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

      على سبيل المثال:
      > /opt/apigee/apigee/apigee/apigee/apigee/apigee-setup/bin/setup.sh -p تحديد كيفية تثبيت المكوّن فقط
      ملف ui -f

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