العودة إلى الإصدار 4.52.02 من Apigee Edge

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

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

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

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

العودة إلى الإصدار	اعتبارات خاصة للبرامج
4.52.01	كاساندرا
4.52.00	كاساندرا، Zookeeper، Qpid
4.51.00	"كاساندرا" و"حديقة الحيوانات" و"Qpid" و"Postgres"

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

1. العودة إلى إصدار رئيسي أو ثانوي سابق: على سبيل المثال من 4.52.02 حتى 4.52.00.
2. العودة إلى إصدار تصحيح سابق في الإصدار نفسه الإصدار. على سبيل المثال، من 4.52.00.02 إلى 4.52.00.01.

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

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

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

في ما يلي الترتيب العام النموذجي للعودة إلى Private Cloud 4.52.02:

1. التراجع عن Postgres وQpid والمكوّنات الأخرى ذات الصلة بالإحصاءات
2. العودة إلى الإصدارات السابقة من أجهزة التوجيه ومعالجات الرسائل
3. العودة إلى الإصدار السابق من "كاساندرا"، المعروف باسم Zookeeper
4. خادم إدارة العودة إلى الحالة السابقة

لنفترض مثلاً أنّك أجريت ترقية لمجموعة Cassandra بالكامل، وجميع خوادم الإدارة، وبعض بروتوكولات RMP إلى الإصدار 4.52.02 من الإصدار 4.52.01 وتريد العودة إلى الإصدار السابق. في هذه الحالة، عليك:

1. العودة إلى جميع الإصدارات السابقة واحدًا تلو الآخر
2. العودة إلى الإصدار السابق من مجموعة Cassandra بالكامل باستخدام النُسخ الاحتياطية
3. العودة إلى الإصدارات السابقة من عُقد خادم إدارة الحافة واحدًا تلو الآخر

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

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

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

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

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

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

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

العودة إلى فعالية "كاساندرا"

عند إجراء ترقية رئيسية لـ "كاساندرا" على عقدة معينة لـ Cassandra، تعدّل "كاساندرا" مخطط البيانات المخزنة على العقدة، مما يجعل العودة المباشرة غير قابلة للتنفيذ. هناك منهجيتان للعودة إلى الحالة السابقة. ستستخدم إحدى هذه المنهجيات استنادًا إلى حالة الترقية التي تتراجع عنها.

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

• محو العُقد الحالية في المجموعة واستخدام العُقد الحالية لإعادة إنشاء العُقدة
• محو بيانات النسخة الاحتياطية أو لقطة الجهاز الافتراضي واستعادتها

أزِل العُقد الحالية في المجموعة واستخدِم العُقد الحالية لإعادة إنشاء العُقدة

يمكن اتباع هذا الإجراء إذا كان لديك مركز بيانات واحد على الأقل يعمل بكامل طاقته في المجموعة العنقودية لا يزال في الإصدار القديم من كاساندرا (Cassandra 2.1.22). في حال ترقية مجموعة Cassandra بالكامل وأردت العودة إلى الإصدار السابق، عليك اتّباع الخطوات الواردة في محو النسخة الاحتياطية أو لقطة الجهاز الافتراضي واستعادتها.

خطوات العودة إلى الإصدار السابق

1. ابدأ بالعقدة التي تريد العودة إليها:
   • أوقِف "كاساندرا" على العقدة:

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

   • إلغاء تثبيت برنامج Cassandra من العقدة:

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

   • إزالة دليل البيانات من العقدة:

     rm -rf /opt/apigee/data/apigee-cassandra

   • نزِّل برنامج التشغيل السريع للإصدار القديم من Edge for Private Cloud الذي تريد العودة إليه وشغِّله.

   مثال: للعودة إلى الإصدار 4.52.01،

   • تنزيل التمهيد بالإصدار 4.52.01:

     curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’

   • تنفيذ التمهيد لـ 4.52.01:

     sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

   • قم بإعداد Cassandra على العقدة:

     /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile

   • نفِّذ عملية إعادة الإنشاء على العقدة من خلال إدخال اسم مركز البيانات الوظيفي:

     /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>

   • كرِّر الخطوات المذكورة أعلاه على كل عقدة تريد العودة إليها، واحدة تلو الأخرى.
2. بعد إرجاع جميع العُقد وإعادة إنشائها:
   • نفِّذ عملية إعداد أي عقدة خادم الإدارة. تأكَّد من أنّ خادم الإدارة ينتمي إلى الإصدار السابق. وإذا لم يحدث ذلك، عليك العودة إلى خادم الإدارة أيضًا.
   • أوقِف خادم الإدارة:

     /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop

   • إذا كنت تستخدم ميزة تحقيق الربح، يجب إلغاء تثبيتها أيضًا:

     /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall

   • إلغاء تثبيت خادم الإدارة:

     /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall

   • نزِّل برنامج التشغيل السريع للإصدار القديم ونفِّذه. على سبيل المثال، نفِّذ الخطوات التالية لتنزيل برنامج تمهيد الإصدار 4.52.01 وتنفيذه:

     curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
     sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

   • تشغيل إعداد عقدة واحدة لخادم الإدارة:

     /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile

التحسين بعد إعادة الإنشاء

في الخطوات المذكورة أعلاه، يتم بث جميع البيانات في العقدة من مركز البيانات البعيد أثناء إعادة الإنشاء. يمكنك تحسين هذه العملية باستخدام عملية إصلاح بعد بث جميع النُسخ المطابقة إلى مركز البيانات المحلي. يؤدي ذلك إلى تجنب البث عبر وحدات التحكم في النطاق (DC) ويجب أن يكون أسرع من إعادة إنشاء جميع العُقد من وحدة تحكُّم في النطاق (DC) بعيدة.

مثال: لنفترض أن لديك ست عُقد Cassandra في مركز البيانات المحلي. بشكل افتراضي، يكون عامل النسخ في Apigee ثلاثة، ولذلك تمتلك كل عقدة 50٪ من البيانات. في هذه الحالة، يمكنك إعادة إنشاء العُقدتَين رقم 1 و4 باتّباع الإجراء الوارد أعلاه. بالنسبة إلى العُقد رقم 2 و3 و5 و6، اتّبِع الخطوات التالية لاستعادة النسخة الاحتياطية وتنفيذ عملية إصلاح.

1. اتبع الإجراء حتى الخطوة السادسة كما هو موثق لإعادة إنشاء النسخ المكررة في مركز البيانات المحلي.
2. بالنسبة إلى العُقد المتبقية، اتبع الخطوات أدناه على كل عقدة متبقية، واحدة تلو الأخرى.
   • استعِد النسخة الاحتياطية التي حصلت عليها في هذه العقدة (ملاحظة: من المحتمل أن تحتوي هذه النسخة الاحتياطية على بيانات قديمة لأنّه تم الحصول على هذه النسخة الاحتياطية قبل بدء ترقية Cassandra):

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

   • إذا كانت لديك لقطة جهاز افتراضي للعقدة، يمكنك استعادة اللقطة بدلاً من استعادة النسخة الاحتياطية لـ "كاساندرا".
   • بعد استعادة النسخة الاحتياطية، ابدأ خدمة Cassandra على العقدة:

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

   • نفِّذ عملية إصلاح للعقدة بحيث يمكن بث أحدث البيانات من مركز بيانات حالي:

     /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>

   • كرر الخطوات من ثلاثة إلى ستة على كل عقدة تريد إصلاحها.

محو البيانات واستعادة لقطة الجهاز الافتراضي أو النسخة الاحتياطية

هذا الإجراء هو الإجراء الوحيد المتاح إذا تمت ترقية مجموعة Cassandra بالكامل وأردت العودة إلى الإصدار السابق.

بالإضافة إلى ذلك، تكون نسخ Apigee الاحتياطية خاصة بالعُقد. لا يمكن استعادة نسخة احتياطية مأخوذة من عقدة إلى أخرى. تتضمن نسخ كاساندرا الاحتياطية معلومات البيانات الوصفية للعقدة (مثل عنوان IP وموضع الحلقة وما إلى ذلك).

1. البدء بعقدة Cassandra واحدة في المجموعة:
   • إيقاف خدمة Cassandra على العقدة:

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

   • إلغاء تثبيت برنامج Cassandra من العقدة:

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

   • إزالة دليل البيانات من العقدة:

     rm -rf /opt/apigee/data/apigee-cassandra

   • نزِّل الإصدار السابق من Edge for Private Cloud وشغِّله.

   مثال: للرجوع إلى الإصدار 4.52.01

   • تنزيل التمهيد بالإصدار 4.52.01:

     curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’

   • تنفيذ التمهيد لـ 4.52.01:

     sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

   • قم بإعداد Cassandra على العقدة:

     /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile

   • استعِد النسخة الاحتياطية على العُقدة باستخدام الإجراء الوارد في الاستعادة من نسخة احتياطية.
   • أوقِف "كاساندرا" على العقدة:

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

   • حذف دليل البيانات:

     rm -rf /opt/apigee/data/apigee-cassandra/data

   • استعادة النسخة الاحتياطية:

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

   • بدء خدمة Cassandra على العقدة:

     /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

   • كرر الخطوات على كل عقدة Cassandra واحدة تلو الأخرى.
   • إجراء عملية الإصلاح في العُقد واحدًا تلو الآخر:

     /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

العودة إلى تحديث Zookeeper 3.8.3

في حال العودة إلى الإصدار 4.52.00 أو 4.51.00، سيكون عليك الرجوع إلى بعض الخطوات الخاصة قبل العودة إلى إصدار Zookeeper. يتم إدراج هذه الخطوات في العودة إلى الحالة السابقة.

في حال العودة إلى الإصدار 4.52.01، عليك العودة إلى الإصدار 4.52.01 من Zookeeper أثناء إعادة أي برنامج، كما هو موضَّح في قسم العودة إلى إصدار رئيسي أو ثانوي سابق أدناه.

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

إذا كنت تريد العودة إلى الإصدارين 4.52.00 أو 4.51.00، فستحتاج إلى الرجوع إلى بعض الخطوات الخاصة قبل العودة إلى الإصدار السابق من Qpid. يتم إدراج هذه الخطوات في العودة إلى الحالة السابقة.

في حال العودة إلى الإصدار 4.52.01، يجب العودة إلى إصدار Qpid السابق لأي برنامج كما هو موضَّح في العودة إلى إصدار رئيسي أو ثانوي سابق

العودة إلى الإصدار 10.17 من تحديث Postgres

في حالة العودة إلى الإصدار 4.51.00، سيكون عليك الرجوع إلى بعض الخطوات الخاصة قبل الرجوع إلى الإصدار 4.51.00 من Postgres. يتم إدراج هذه الخطوات في العودة إلى الحالة السابقة.

في حال العودة إلى الإصدار 4.52.01 أو 4.52.00، عليك الرجوع إلى الإصدار السابق من Postgres أثناء إعادة أي برنامج، كما هو موضَّح في قسم العودة إلى إصدار رئيسي أو ثانوي سابق أدناه.

العودة إلى إصدار رئيسي أو ثانوي سابق

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

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. للرجوع إلى أي من المكوّنات ذات الرمز المشترك على يجب إلغاء تثبيتها جميعًا من خلال إلغاء تثبيت مكوّن 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.02 من 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. كرر هذه العملية لكل عقدة تستضيف المكون الذي تقوم بالعودة إليه.

العودة إلى الإصدار السابق من 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