العودة إلى الإصدار السابق من Apigee Edge 4.52.01

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

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

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

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

  1. العودة إلى إصدار رئيسي أو ثانوي سابق: على سبيل المثال من 4.52.01 إلى 4.52.00.
  2. العودة إلى إصدار تصحيح سابق في الإصدار نفسه: على سبيل المثال، من 4.52.00.02 إلى 4.52.00.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.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.01 من 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 Online repo، يمكنك تحديد إصدارات المكوّنات المتاحة باستخدام الأمر التالي: 

    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. كرِّر هذه العملية لكل عقدة تستضيف المكوِّن الذي ترجعه.

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

في حال الترقية إلى 4.52.01 من الإصدار 4.50.00 أو 4.51.00، عليك الرجوع إلى الإصدار السابق من تحديث Postgres بالإضافة إلى مكوّنات Edge.

للتراجع عن تحديث Postgres عند تحديث Postgres في إعدادات الاستعداد الرئيسي:

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

عند الانتهاء من العودة إلى الإصدار السابق، لن تكون العُقدة الرئيسية القديمة ضرورية. ويمكنك بعد ذلك إيقاف العقدة الرئيسية القديمة.

  1. تأكَّد من أنّ عقدة Postgres الجديدة قيد التشغيل: 
    /opt/apigee/apigee-service/bin/apigee-all status

    إذا لم تكن Postgres قيد التشغيل، فيمكنك تشغيلها:

    /opt/apigee/apigee-service/bin/apigee-all start
  2. تأكَّد من إيقاف Postgres في العُقدة الرئيسية القديمة وعقدة وضع الاستعداد القديمة: 
    /opt/apigee/apigee-service/bin/apigee-all status

    في حال تشغيل Postgres، يمكنك إيقافها: 

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

  3. في حال تثبيت دالة Qpid، ابدأ في عقدة وضع الاستعداد القديمة: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. الترويج لعقدة وضع الاستعداد الجديدة بصفتك المشرف على Postgres:
    1. ترقية عقدة وضع الاستعداد الجديدة لتصبح المجموعة الرئيسية الجديدة: 
      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      أدخِل كلمة مرور Postgres لمستخدم "apigee"، الذي يتم ضبطه تلقائيًا على "postgres".

    2. عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    3. ضبط الشريحة الرئيسية الجديدة:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. إذا سبق لك ترقية عقدة وضع الاستعداد القديمة إلى الإصدار الأحدث، عليك أولاً الرجوع إلى إصدار سابق من برنامج Apigee في عقدة وضع الاستعداد القديمة. إذا كان لا يزال لديك الإصدار القديم في عقدة وضع الاستعداد القديم، يمكنك تخطّي هذه الخطوة والمتابعة إلى الخطوة 6.
    1. لإيقاف Postgres في عقدة وضع الاستعداد القديمة: 
      apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
    2. ألغِ تثبيت Postgres من عقدة وضع الاستعداد القديمة: 
      apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
    3. احذف دليل بيانات Postgres من عقدة وضع الاستعداد القديمة: 
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    4. عليك تنزيل إصدار Bootstrapped للإصدار القديم (لإصدار Apigee الذي تستعيده حاليًا) في عقدة وضع الاستعداد القديمة. قد تختلف الخطوات الدقيقة استنادًا إلى ما إذا كنت تستخدم تثبيتًا على الإنترنت أو بلا إنترنت. سيؤدي تشغيل الإصدار القديم من Apigee إلى إعداد مستودعات Yum مع بيانات Apigee ذات الإصدار القديم.
    5. إعداد مكوّنات Postgres في عقدة وضع الاستعداد القديمة: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. تحقَّق من أنّ مكوّنات Postgres في عقدة وضع الاستعداد القديمة قد عادت إلى الإصدار القديم: 
      apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
      .
  6. أعِد إنشاء عقدة وضع الاستعداد القديمة:
    1. عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    2. أزِل دليل البيانات في عقدة وضع الاستعداد القديمة: 
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
      .
    3. أعِد ضبط عقدة وضع الاستعداد القديمة لتكون عقدة احتياطية في الشريحة الرئيسية الجديدة: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. تأكَّد من أنّ Postgres قيد التشغيل في عقدة وضع الاستعداد القديمة: 
      /opt/apigee/apigee-service/bin/apigee-all status

      إذا لم تكن Postgres قيد التشغيل، فيمكنك تشغيلها:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. تحقَّق من إضافة عقدة وضع الاستعداد الجديدة من خلال عرض ملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على الصفحة الرئيسية الجديدة.
  8. يمكنك الاطّلاع على الإحصاءات الحالية ومعلومات مجموعة المستهلكين من خلال تنفيذ الأمر التالي على خادم الإدارة: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    يعرض هذا الأمر اسم مجموعة الإحصاءات في الحقل name واسم مجموعة المستهلكين في الحقل name ضمن consumer-groups. وتعرض أيضًا أرقام التعريف الفريدة العالمية (UUID) لعُقد Postgres الرئيسية والاستعداد القديمة في الحقل postgres-server، وفي الحقل datastores. من المفترَض أن تظهر لك النتيجة على النحو التالي: 

    {
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}

  9. يمكنك الحصول على عنوان UUID للصفحة الرئيسية القديمة من خلال تشغيل الأمر curl التالي على العقدة الرئيسية القديمة: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    من المفترض أن يظهر لك المعرّف الفريد العالمي للعقدة في نهاية الناتج، بالشكل التالي:

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  10. كرِّر الخطوة السابقة للحصول على عناوين IP لعقدة وضع الاستعداد القديمة وعقدة جديدة.
  11. إزالة العُقد الرئيسية والقديمة في وضع الاستعداد من مجموعة المستهلكين: 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    حيث يكون axgroup-001 وconsumer-group-001 هما الاسمان التلقائيان لمجموعة الإحصاءات ومجموعات المستهلكين. تكون السمة masterUUID,standbyUUID بنفس الترتيب الذي كانت تظهر به أعلاه عند عرض الإحصاءات الحالية ومعلومات مجموعات المستهلكين أعلاه. وقد تحتاج إلى تحديدها باعتبارها standbyUUID,masterUUID.

    ومن المفترض أن تكون السمة datastores للسمة consumer-groups فارغة الآن.

  12. أزِل العُقد الرئيسية والقديمة في وضع الاستعداد من مجموعة الإحصاءات: 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    من المفترض أن تكون السمة postgres-server ضمن uuids فارغة الآن.

  13. تسجيل عُقد PG الرئيسية وعُقد الاستعداد الجديدة في الإحصاءات ومجموعات المستهلكين:
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
  14. التحقّق من صحة مجموعة الإحصاءات: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    من المفترض أن تظهر لك أرقام التعريف الفريدة العالمية (UUID) للعُقد الرئيسية الجديدة وعُقد الاستعداد الجديدة، وذلك ضمن مجموعة الإحصاءات ومجموعة المستهلكين.

  15. أعِد تشغيل خادم إدارة Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. أعِد تشغيل جميع خوادم Qpid: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. أعِد تشغيل جميع خوادم Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. ومن المفترض أن يعرض النظام نتائج متطابقة على كلا الخادمين لضمان إجراء نسخ متماثل بنجاح:

    على الشريحة الرئيسية الجديدة، شغِّل:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    تحقق من أنه هو الرئيسي. في نقطة وضع الاستعداد القديمة: 

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    تأكَّد من أنّ الجهاز في وضع الاستعداد.

  19. كرِّر الخطوة السابقة بعد إجراء عدة طلبات من واجهة برمجة التطبيقات للتأكّد من أنّ العُقد متزامنة.
  20. عليك إيقاف مشرف Postgres الرئيسي القديم باستخدام الإجراء الوارد في إيقاف عقدة Postgres.

    بدلاً من ذلك، يمكنك إلغاء تثبيت Qpid من الصفحة الرئيسية القديمة وتثبيت Qpid على العقدة الرئيسية الجديدة. بعد إلغاء تثبيت Qpid، يمكنك إيقاف العقدة الرئيسية القديمة.

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