العودة إلى الإصدار السابق من Apigee Edge 4.52.01

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

يمكنك إعادة الإصدار 4.52.01 من Edge إلى الإصدارات الرئيسية التالية:

  • الإصدار 4.52.00
  • الإصدار 4.51.00

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

  1. العودة إلى إصدار رئيسي أو ثانوي سابق: على سبيل المثال من 4.52.01 إلى 4.52.00.
  2. العودة إلى إصدار تصحيح سابق في الإصدار نفسه الإصدار. على سبيل المثال، من الإصدار 4.52.00.02 إلى الإصدار 4.52.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.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. لإلغاء تثبيت أيّ من المكوّنات التي تتضمّن رمزًا شائعًا في node، يجب إلغاء تثبيتها كلها من خلال إلغاء تثبيت مجموعة المكوّنات 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.52.01 من تطبيق apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. تثبيت الإصدار 4.51.00 من "apigee-service" وتبعياته. يوضح المثال التالي تثبيت الإصدار 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. كرر هذه العملية لكل عقدة تستضيف المكون الذي تقوم بالعودة إليه.

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

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

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

  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 القديم باستخدام الإجراء في يؤدي إيقاف عقدة 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