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

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

يمكنك الرجوع إلى الإصدارات التالية من الإصدارات التجريبية من 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 Router، يجب حذف محتوى ملف /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. كرر هذه العملية لكل عقدة تستضيف المكون الذي تقوم بالعودة إليه.