تراجع Apigee Edge 4.51.00

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

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

  • الإصدار 4.50.00
  • الإصدار 4.19.06

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

  1. الرجوع إلى إصدار ميزة سابق على سبيل المثال من 4.51.00 إلى 4.50.00.
  2. العودة إلى إصدار التحديث السابق على الإصدار نفسه الإصدار. على سبيل المثال، من 4.50.00.02 إلى 4.50.00.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)

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

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

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

  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، يجب حذف محتويات ملف /opt/nginx/conf.d بالإضافة إلى إلغاء تثبيت edge-gateway مجموعة المكونات: 
      cd /opt/nginx/conf.d
rm -rf *
  5. إلغاء تثبيت الإصدار 4.51.00 من apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. تثبيت الإصدار 4.19.06 أو 4.50.00 من apigee-service وتبعياته. يوضح المثال التالي تثبيت الإصدار 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. كرر هذه العملية لكل عقدة تستضيف المكون الذي تقوم بالعودة إليه.

العودة إلى الإصدار 10.17 من Postgres

في حال الترقية إلى الإصدار 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. نزِّل الإصدار السابق لتمرين التمهيد وشغِّله (لإصدار Apigee الذي تستعمله حاليًا). مرة أخرى) على عقدة الاستعداد القديمة. قد تختلف الخطوات الدقيقة بناءً على ما إذا كنت تستخدم تثبيت مستند إلى الإنترنت أو بدون اتصال بالإنترنت. في حال تشغيل الإصدار الأقدم من Apigee Bootstراب، يُرجى إعداد مستودعات 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

    يعرض هذا الأمر اسم مجموعة الإحصاءات في الحقل 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

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

    "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 الاسمين التلقائيين لـ التحليلات ومجموعات المستهلكين. masterUUID,standbyUUID بنفس الترتيب الذي تظهر فيه أعلاه عند عرض الإحصاءات الحالية ومعلومات مجموعة المستهلكين أعلاه. إِنْتَ تحديدها على أنها standbyUUID,masterUUID.

    من المفترض أن تكون سمة datastores لـ consumer-groups الآن على النحو التالي: فارغ.

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

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

  15. أعِد تشغيل خادم إدارة Edge: 
    /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. كرِّر الخطوة السابقة بعد إجراء العديد من طلبات واجهة برمجة التطبيقات لضمان وجود العُقد في المزامنة.
  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