العودة إلى الإصدار 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 كمستخدمين مختلفين. على سبيل المثال، إذا كان على جهاز التوجيه الوصول إلى منافذ مميزة، مثل المنافذ التي تقل عن 1000 منافذ، يجب تشغيل جهاز التوجيه باعتباره الجذر أو كمستخدم لديه إمكانية الوصول إلى هذه المنافذ. أو، يمكنك تشغيل مكون واحد كمستخدم واحد، ومكون آخر كمستخدم آخر.

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

تشترك مكونات 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 Router، يجب حذف محتوى ملف /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