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

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

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

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

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

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

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

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

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

ترتيب التراجع

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

سيظهر الترتيب العام النموذجي لعمليات التراجع في Private Cloud 4.52.02 على النحو التالي:

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

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

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

المستخدمون الذين يمكنهم التراجع

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

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

المكوّنات التي تتضمّن رمزًا شائعًا

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

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

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

التراجع عن التغييرات في Cassandra

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

منهجيات التراجع

• محو العقد الحالية في المجموعة واستخدامها لإعادة إنشاء العقدة
• محو النسخة الاحتياطية أو لقطة VM واستعادتها

محو العقد الحالية في المجموعة واستخدامها لإعادة إنشاء العقدة

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

خطوات التراجع

1. ابدأ بالعقدة التي تريد التراجع عنها:
   • أوقِف 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

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

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

   • تنزيل حزمة bootstrap من الإصدار 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

   • نزِّل ونفِّذ عملية الإعداد المبدئي للإصدار الأقدم. على سبيل المثال، نفِّذ الخطوات التالية لتنزيل وتنفيذ أداة bootstrap للإصدار 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

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

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

مثال: لنفترض أنّ لديك ستة عقد من 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.
   • بعد استعادة النسخة الاحتياطية، ابدأ خدمة 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 خاصة بالعقدة. لا يمكن استعادة نسخة احتياطية تم أخذها من عقدة إلى أخرى. تتضمّن نُسخ Cassandra الاحتياطية معلومات البيانات الوصفية للعقد (مثل عنوان 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

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

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

   • تنزيل حزمة bootstrap من الإصدار 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

   • استعادة النسخة الاحتياطية على العقدة باستخدام الإجراء الموضّح في الاستعادة من نسخة احتياطية
   • أوقِف Cassandra على العقدة:

     /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، يمكنك الرجوع إلى Zookeeper كما يمكنك الرجوع إلى أي برنامج، كما هو موضّح في قسم الرجوع إلى إصدار رئيسي أو ثانوي سابق أدناه.

إعادة تحميل Qpid

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

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

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

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