العودة إلى الإصدار السابق Apigee Edge 4.19.06

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

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

  • الإصدار 4.19.01
  • الإصدار 4.18.05
  • الإصدار 4.18.01

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

  1. العودة إلى إصدار ميزة سابق: على سبيل المثال من 4.19.06 إلى 4.18.05.
  2. العودة إلى إصدار محدّث سابق في الإصدار نفسه: على سبيل المثال، من 4.19.01.02 إلى 4.19.01.01.

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

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

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

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

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

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

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

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

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

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

  1. نزِّل ملف bootstrap.sh للإصدار الذي تريد الرجوع إليه:

    • للرجوع إلى الإصدار 4.19.01، يجب تنزيل bootstrap_4.19.01.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • للرجوع إلى الإصدار 4.18.05، يجب تنزيل bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    • للرجوع إلى الإصدار 4.18.01، يجب تنزيل bootstrap_4.18.01.sh: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.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.19.06 من apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. ثبِّت الإصدار 4.19.01 أو 4.18.05 أو 4.18.01 من الأداة المساعدة apigee-service وملحقاتها. في المثال التالي، يتم تثبيت الإصدار 4.18.01 من apigee-service: 
    sudo bash /tmp/bootstrap_4.18.01.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.01-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. كرر هذه العملية لكل عقدة تستضيف المكون الذي تريد التراجع عنه.