تحديث Apigee Edge 4.50.00 أو 4.51.00 إلى 4.52.00

تتيح Apigee ترقية Edge for Private Cloud من الإصدار 4.50.00 أو الإصدار 4.51.00 مباشرةً إلى الإصدار 4.52.00. توضّح هذه الصفحة كيفية إجراء أي ترقية.

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

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

بعد تثبيت Edge RPM، يمكن لأي شخص إعداده.

المكوّنات التي يجب تحديثها

يجب عليك تحديث جميع مكونات Edge. لا يدعم Edge الإعداد الذي يحتوي على مكونات من إصدارات متعددة.

تعديل المتطلبات الأساسية

تأكّد من استيفاء المتطلبات الأساسية التالية قبل ترقية Apigee Edge:

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

    يتيح لك ذلك الحصول على خطة احتياطية، في حال تعذّر عليك يعمل بشكل صحيح. لمزيد من المعلومات حول الاحتفاظ بنسخة احتياطية، راجِع القسم الاحتفاظ بنسخة احتياطية. و"الاستعادة":

  • التأكُّد من تشغيل Edge
    تأكَّد من أنّ Edge يعمل أثناء عملية التحديث باستخدام الأمر:
    /opt/apigee/apigee-service/bin/apigee-all status
  • التأكّد من أنّ استراتيجية التوافق مع "كاساندرا" هي LeveledCompactionStrategy
    تأكد من تعيين استراتيجية توافق Cassandra على LeveledCompactionStrategy، كما هو موضّح في تغيير استراتيجية ضغط Cassandra

النشر التلقائي لإعدادات الموقع

إذا كنت قد ضبطت أي خصائص من خلال تعديل ملفات .properties في /opt/apigee/customer/application ثم يحتفظ التحديث بهذه القيم.

الترقية المطلوبة إلى Zookeeper 3.8.0

يشمل هذا الإصدار من Edge for Private Cloudes ترقية إلى الإصدار 3.8.0 من Zookeeper. كجزء من هذه الترقية، سيتم ترحيل جميع بيانات Zookeeper إلى الإصدار 3.8.0 من Zookeeper.

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

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

على مستوى عالٍ، تتضمن عملية الترقية نسخ نسخة احتياطية من كل عقدة. يتبع ذلك من خلال ترقية جميع المراقبين والمتابعين، وأخيرًا ترقية عقدة القائد.

الاحتفاظ بنسخة احتياطية

احتفظ بنسخة احتياطية من جميع عُقد Zookeeper لاستخدامها في حال الحاجة إلى العودة إلى الإصدار السابق. لاحظ أن ستؤدي العودة إلى استعادة Zookeeper إلى الحالة التي تم فيها الاحتفاظ بنسخة احتياطية. ملاحظة: أي عمليات نشر أو تغييرات البنية الأساسية في Apigee منذ الحصول على النسخة الاحتياطية (التي يتم تخزين معلوماتها في Zookeeper) أثناء الاستعادة.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

في حال استخدام أجهزة افتراضية ولديك هذه الإمكانية، يمكن أيضًا استخدام لقطات من الجهاز الافتراضي أو نُسخ احتياطية منها. الاستعادة أو العودة إلى الحالة السابقة (إذا لزم الأمر).

تحديد القادة والمتابعين والمراقبين

ملاحظة: تستخدم نماذج الأوامر أدناه أداة nc لإرسال البيانات إلى Zookeeper. يمكنك استخدام المرافق البديلة لإرسال البيانات إلى Zookeeper أيضًا.

  1. في حال لم يتم تثبيته على عقدة ZooKeeper، ثبّت nc:
      sudo yum install nc
  2. شغّل الأمر nc التالي على العقدة، حيث يكون 2181 هو منفذ ZooKeeper:
      echo stat | nc localhost 2181

    من المفترض أن تظهر لك نتيجة على النحو التالي:

      Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
      Clients:
       /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
      
      Latency min/avg/max: 0/0.2518/41
      Received: 647228
      Sent: 647339
      Connections: 4
      Outstanding: 0
      Zxid: 0x400018b15
      Mode: follower
      Node count: 100597

    في سطر الإخراج Mode للعُقد، من المفترض أن يظهر لك مراقب أو قائد أو تابع (أي ناخب ليس القائد) بناءً على تهيئة العقدة. ملاحظة: في عملية تثبيت مستقلة لشبكة Edge مع عقدة ZooKeeper واحدة، Mode تم تعيينها على "مستقلة".

  3. كرِّر الخطوتين 1 و2 في كل عقدة ZooKeeper.

ترقية Zookeeper على عُقد المراقب والمتابع

عليك ترقية Zookeeper في كل عُقدة من عُقد المراقب والمتابع على النحو التالي:

  1. قم بتنزيل وتشغيل التمهيد لـ Edge for Private Cloud 4.52، كما هو موضح في التحديث إلى الإصدار 4.52.00 على عقدة ذات اتصال خارجي بالإنترنت من المحتمل أن تتضمن العملية اعتمادًا على ما إذا كان للعقدة اتصال خارجي بالإنترنت أو إجراء تثبيت في وضع عدم الاتصال.
  2. ترقية مكوِّن Zookeeper:
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
    ملاحظة: إذا كانت هذه العُقد تحتوي على مكونات أخرى تم تثبيتها (مثل Cassandra)، يمكنك الترقية عليها أيضًا الآن (كما هو الحال مع ملف تعريف cs,zk) أو يمكنك ترقية المكونات الأخرى لاحقًا. Apigee نقترح ترقية Zookeeper أولاً والتأكّد من أنّ مجموعتك تعمل بشكل صحيح قبل ترقية المكونات الأخرى.
  3. كرِّر الخطوات أعلاه على كل عُقدة من عُقد المراقب والمتابع في Zookeeper.

إغلاق القائد

بعد ترقية جميع عُقد المراقب والمتابع، يمكنك إغلاق القائد. على العقدة المحدد كقائد، قم بتشغيل الأمر أدناه:

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

لاحظ أنه خلال هذا الحدث، قبل انتخاب قائد جديد، قد يكون هناك تأخيرات مؤقتة أو كتابة الإخفاقات في Zookeeper. قد يؤثر هذا على العمليات التي تتم كتابتها في Zookeeper مثل إجراء نشر الخوادم الوكيلة أو تغييرات بنية Apigee الأساسية، مثل إضافة أو إزالة معالجات الرسائل وما إلى ذلك

التحقق من انتخاب الرئيس الجديد

باستخدام الخطوات الواردة في تحديد القائد، المتابعين والمراقبين أعلاه، تحقَّق من اختيار قائد جديد من المتابعين، بعد إيقاف القائد الحالي. تجدر الإشارة إلى أنّه كان من الممكن انتخاب القائد في مركز بيانات مختلف عن القائد الحالي.

ترقية قائد المجموعة

اتبع الخطوات نفسها الواردة في جارٍ ترقية Zookeeper في عُقد المراقب والمتابع أعلاه.

بعد ترقية عقدة القائد القديمة كذلك، تحقق من صحة المجموعة لضمان وجود عقدة رئيسية.

العودة إلى الحالة السابقة

في حال كانت العودة مطلوبة:

  1. قم بإجراء خطوات العودة إلى الحالة السابقة على المراقبين والمتابعين أولاً.
  2. نزِّل برنامج التشغيل المبدئي للإصدار الذي تريد الرجوع إليه ونفِّذه، إما 4.50 أو 4.51. ستختلف هذه العملية على الأرجح استنادًا إلى ما إذا كان للعقدة اتصال خارجي بالإنترنت أم لا أو أنك تتابع التثبيت بلا اتصال بالإنترنت.
  3. إيقاف Zookeeper إذا كان قيد التشغيل على العقدة:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. إلغاء تثبيت مدير حديقة الحيوان الحالي:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  • تثبيت Zookeeper كالمعتاد:
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  • بمجرد إعادة جميع المتابعين والمراقبين، يمكنك العودة إلى الإصدار السابق من عقدة القائد من خلال اتباع الخطوات من 2 إلى 5 في العقدة الرئيسية.
  • بعد إعادة جميع العُقد إلى الحالة السابقة، تحقَّق من سلامة المجموعة وتأكَّد من عقدة رائدة في المجموعة العنقودية.
  • استعادة النسخة الاحتياطية

    راجِع مقالة الاستعادة من نسخة احتياطية. لاحظ أن النسخ الاحتياطية من Zookeeper المأخوذة من الإصدارات السابقة من Edge for Private Cloud مثل 4.50 و4.51 يجب أن تكون متوافق مع إصدار Zookeeper في Edge for Private Cloud 4.52.

    الترقية المطلوبة للإصدار 14 من Postgres

    يتضمن هذا الإصدار من Edge ترقية إلى Postgres 14. وفي إطار هذه الترقية، يتم نقل بيانات Postgres إلى الإصدار 14 من Postgres.

    تستخدم معظم أنظمة إنتاج Edge عُقدتين من Postgres تم تكوينهما للنسخ المتماثل في وضع الاستعداد الرئيسي. وأثناء عملية التحديث، وبينما تكون عُقد Postgres معطلة للحصول على التحديث، تظل بيانات التحليل كتابتها إلى عُقد Qpid. بعد تحديث عُقد Postgres ومعاودة الاتصال بالإنترنت، ستلاحظ ثم يتم دفعها إلى عقد Postgres.

    تعتمد طريقة إجراء تحديث Postgres على كيفية ضبط تخزين البيانات عُقد Postgres:

    • إذا كنت تستخدم تخزين البيانات المحلي مع عُقد Postgres، يجب: تثبيت عقدة الاستعداد الجديدة لـ Postgres طوال مدة الترقية. بعد اكتملت عملية الترقية، يمكنك إنهاء عقدة وضع الاستعداد الجديدة في Postgres.

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

      في التكوين المكون من عقدة واحدة وعقدة 2 لـ Edge، طوبوغرافيا المستخدمة لإنشاء النماذج الأولية والاختبار، يمكنك تحتوي على عقدة Postgres واحدة فقط. يمكنك تحديث عُقد Postgres هذه مباشرةً بدون لإنشاء عقدة Postgres جديدة.

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

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

    تثبيت Postgres جديد عقدة وضع الاستعداد

    ينشئ هذا الإجراء خادم استعداد لـ Postgres على عقدة جديدة. تأكد من تثبيت رمز جديد خادم وضع الاستعداد لـ Postgres للإصدار الحالي من Edge (4.50.00 أو 4.51.00)، وليس للإصدار 4.52.00.

    لإجراء عملية التثبيت، استخدِم ملف الإعداد نفسه الذي استخدمته لتثبيت الإصدار الحالي. من Edge.

    لإنشاء عقدة وضع الاستعداد جديدة في Postgres:

    1. في صفحة Postgres الرئيسية الحالية، عدِّل /opt/apigee/customer/application/postgresql.properties لتعيين الرمز المميز التالي. إذا لم يكن هذا الملف متوفّرًا، أنشئه:
      conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

      حيث existing_standby_ip هو عنوان IP لمجموعة Postgres الحالية خادم وضع الاستعداد وnew_standby_ip هو عنوان IP لعقدة الاستعداد الجديدة.

    2. أعِد تشغيل apigee-postgresql في شريحة Postgres الرئيسية:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    3. تحقق من إضافة عقدة وضع الاستعداد الجديدة من خلال عرض ملف واحد (/opt/apigee/apigee-postgresql/conf/pg_hba.conf) على الصفحة الرئيسية. من المفترض أن ترى الأسطر التالية في هذا الملف:
      host replication apigee existing_standby_ip/32 trust
      host replication apigee new_standby_ip/32 trust
    4. تثبيت خادم وضع الاستعداد الجديد لـ Postgres:
      1. عدّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
        # IP address of the current master:
        PG_MASTER=192.168.56.103
        # IP address of the new standby node
        PG_STANDBY=192.168.56.102
      2. إيقاف SELinux كما هو موضح في ثبِّت الأداة المساعدة لإعداد واجهة برمجة التطبيقات Edge على Edge.
      3. إذا كنت تستخدم حاليًا الإصدار 4.51.00 من Edge:

        1. قم بتنزيل ملف Edge Bootstrap_4.51.00.sh إلى /tmp/bootstrap_4.51.00.sh :
          curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
        2. تثبيت أداة Edge apigee-service والتبعيات:
          sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

        إذا كنت تستخدم حاليًا الإصدار 4.50.00 من Edge:

        1. قم بتنزيل ملف Edge Bootstrap_4.50.00.sh إلى /tmp/bootstrap_4.50.00.sh :
          curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
        2. تثبيت أداة Edge apigee-service والتبعيات:
          sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
      4. استخدم apigee-service لتثبيت الأداة apigee-setup:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      5. تثبيت Postgres:
        /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
      6. في عقدة وضع الاستعداد الجديدة، شغِّل الأمر التالي:
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

    إجراء ترقية في المكان لـ Postgres

    ملاحظة: يجب تنفيذ الخطوة الأولية التالية قبل إجراء ترقية في المكان الصحيح لـ Postgres.

    الخطوة الأولية

    قبل إجراء ترقية في الموضع إلى Postgres، اتبع الخطوات التالية على كل من الصفحة الرئيسية والمضيف والاستعداد، لتحديث فندق واحد (max_locks_per_transaction) على apigee-postgresql:

    1. إذا لم يكن متوفرًا، أنشئ الملف /opt/apigee/customer/application/postgresql.properties
    2. تغيير ملكية هذا الملف إلى apigee:
      sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
    3. أضِف السمة التالية إلى الملف:
      conf/postgresql.conf+max_locks_per_transaction=30000
    4. ضبط apigee-postgresql:
      apigee-service apigee-postgresql configure
    5. إعادة تشغيل "apigee-postgresql":
      apigee-service apigee-postgresql restart

    إجراء الترقية في الموضع

    لإجراء ترقية في الموضع إلى الإصدار 14 من Postgres، اتبع الخطوات التالية:

    1. ترقية المنشورات على المضيف الرئيسي
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    2. شغّل أمر الإعداد على المضيف الرئيسي:
      apigee-service apigee-postgresql setup -f /opt/silent.conf
    3. شغِّل أمر التهيئة على المضيف الرئيسي:
      apigee-service apigee-postgresql configure
    4. إعادة تشغيل المضيف الرئيسي:
      apigee-service apigee-postgresql restart
    5. ضبطه كرئيسي:
      apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
    6. تأكَّد من أنّ المضيف الرئيسي قد بدأ:
      apigee-service apigee-postgresql wait_for_ready
    7. أوقِف وضع الاستعداد:
      apigee-service apigee-postgresql stop
    8. عليك ترقية وضع الاستعداد.

      ملاحظة: في حال تعذّر إتمام هذه الخطوة، يمكن تجاهلها. سيحاول update.sh لبدء تشغيل خادم الاستعداد بتهيئة غير صحيحة. تم توفير ملفات Postgres إلى 14، فيمكن تجاهل الخطأ.

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
    9. تأكَّد من إيقاف وضع الاستعداد:
      apigee-service apigee-postgresql stop
    10. أزِل إعدادات وضع الاستعداد القديمة:
      rm -rf /opt/apigee/data/apigee-postgresql/
    11. إعداد النسخ المتماثل على خادم الاستعداد:
      apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
    12. إزالة السطر conf/postgresql.conf+max_locks_per_transaction=30000 من الملف /opt/apigee/customer/application/postgresql.properties على كليهما المضيف الرئيسي والاستعداد. كان هذا الخط تمت إضافتها في الخطوة الأولية.

    بعد إكمال هذا الإجراء، سيبدأ وضع الاستعداد بنجاح.

    إيقاف تشغيل عقدة Postgres

    بعد اكتمال التحديث، عليك إيقاف عقدة وضع الاستعداد الجديدة:

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

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

      /opt/apigee/apigee-service/bin/apigee-all start

    2. يمكنك الحصول على المعرّف الفريد العالمي (UUID) لعقدة وضع الاستعداد الجديدة من خلال تنفيذ الأمر curl التالي على الجهاز الجديد عقدة وضع الاستعداد:
      curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

      من المفترض أن يظهر لك المعرّف الفريد العالمي للعقدة في نهاية الإخراج، على النحو التالي:

      "type" : [ "postgres-server" ],
      "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

    3. أوقف عقدة وضع الاستعداد الجديدة من خلال تشغيل الأمر التالي على عقدة الاستعداد الجديدة:
      /opt/apigee/apigee-service/bin/apigee-all stop
    4. في عقدة Postgres الرئيسية، عدِّل /opt/apigee/customer/application/postgresql.properties لإزالة عقدة وضع الاستعداد الجديدة من conf_pg_hba_replication.connection:
      conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
    5. أعد تشغيل apigee-postgresql في صفحة Postgres الرئيسية:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
    6. تحقق من أن عقدة وضع الاستعداد الجديدة قد تمت إزالتها من خلال عرض ملف واحد (/opt/apigee/apigee-postgresql/conf/pg_hba.conf) على الصفحة الرئيسية. من المفترض أن ترى السطر التالي فقط في هذا الملف:
      host replication apigee existing_standby_ip/32 trust
    7. احذف المعرّف الفريد العالمي لعقدة وضع الاستعداد من ZooKeeper من خلال إجراء إدارة Edge التالية استدعاء واجهة برمجة التطبيقات في عقدة خادم الإدارة:
      curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

    خطوات ما بعد الترقية لتطبيق Postgres

    بعد إجراء ترقية كبيرة لـ Postgres، يتم مسح الإحصاءات الداخلية لـ Postgres. تساعد هذه الإحصائيات مخطط استعلامات Postgres في استخدام أفضل الفهارس والمسارات لتنفيذ الاستعلامات.

    يمكن لـ Postgres إعادة إنشاء إحصاءاتها تدريجيًا بمرور الوقت، حيث يتم تنفيذ طلبات البحث وعند تشغيل البرنامج الخفي للمكنسة التلقائية. ومع ذلك، قد تكون طلبات البحث بطيئة إلى أن تتم إعادة إنشاء الإحصاءات.

    لمعالجة هذه المشكلة، يمكنك تنفيذ ANALYZE على جميع الجداول في قاعدة البيانات على عقدة Postgres الرئيسية. بدلاً من ذلك، يمكنك تنفيذ ANALYZE لبعض الجداول في كل مرة.

    واجهة مستخدم Edge الجديدة

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

    تثبيت واجهة مستخدم Edge

    بعد إكمال عملية التثبيت الأولية، تنصحك Apigee بتثبيت واجهة المستخدم Edge، وهي واجهة مستخدم محسَّنة لمطوّري ومشرفي Apigee Edge for Private Cloud.

    لاحظ أن واجهة مستخدم Edge تتطلب منك تعطيل المصادقة الأساسية واستخدام IDP، مثل SAML أو LDAP.

    للمزيد من المعلومات، يُرجى الاطّلاع على تثبيت واجهة مستخدم Edge الجديدة.

    تحديث واجهة مستخدم Edge

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

    التحديث باستخدام Apigee mTLS

    لتحديث Apigee mTLS، يُرجى تنفيذ الخطوات التالية الخطوات:

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

    في حال تعذُّر التحديث، يمكنك محاولة تصحيح المشكلة ثم تنفيذ العملية. update.sh مرة أخرى. يمكنك إجراء عملية التحديث عدة مرات مع مواصلة التحديث. من حيث توقف آخر مرة.

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

    معلومات تعديل التسجيل

    بشكل تلقائي، تكتب الأداة المساعدة update.sh معلومات السجل إلى:

    /opt/apigee/var/log/apigee-setup/update.log

    إذا لم يكن لدى الشخص الذي يشغل أداة update.sh إمكانية الوصول إلى هذا الدليل، يكتب السجل إلى الدليل /tmp كملف باسم update_username.log

    إذا لم يكن لدى الشخص إذن بالوصول إلى /tmp، أداة update.sh فشل.

    تعديل وقت الاستراحة

    يتيح لك التحديث بدون توقف أو بدون انقطاع تحديث تثبيت Edge بدون جلب Edge.

    لا يمكن تعديل وقت الاستراحة إلا باستخدام إعدادات مكونة من 5 عُقد وأكبر.

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

    1. تحديث الأجهزة بالترتيب الصحيح للتركيب كما هو موضح ترتيب تحديث الجهاز:
    2. عندما يحين وقت تحديث "أجهزة التوجيه"، اختَر أي جهاز توجيه وتجنَّب الوصول إليه، كما هو موضح في تمكين/إيقاف الخادم إمكانية الوصول إلى (معالج الرسائل/جهاز التوجيه)
    3. حدِّث جهاز التوجيه المحدد وجميع مكونات Edge الأخرى على نفس جهاز جهاز التوجيه. تعرض جميع إعدادات Edge جهاز التوجيه ومعالج الرسائل على نفس العقدة.
    4. اجعل جهاز التوجيه قابلاً للوصول إليه مرة أخرى.
    5. كرر الخطوات من 2 إلى 4 لأجهزة التوجيه المتبقية.
    6. تابع إجراء التحديث لأي أجهزة متبقية في عملية التثبيت.

    عليك مراعاة ما يلي قبل التحديث وبعده:

    استخدام ملف إعداد صامت

    يجب تمرير ملف إعداد صامت إلى الأمر update. ملف الإعداد الصامت يجب أن يكون نفس الشيء الذي استخدمته لتثبيت Edge 4.50.00 أو 4.51.00.

    تحديث إلى 4.52.00 على عقدة ذات اتصال إنترنت خارجي

    استخدم الإجراء التالي لتحديث مكونات Edge على عقدة:

    1. يمكنك إيقاف أي مهام "cron" تم ضبطها لإجراء عملية إصلاح في حال توفّرها. "كاساندرا" إلى ما بعد اكتمال التحديث.
    2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
    3. تثبيت yum-utils وyum-plugin-priorities:
      sudo yum install yum-utils
      sudo yum install yum-plugin-priorities
    4. عطّل SELinux كما هو موضح في Install أداة Edge apigee-setup.
    5. في حال التثبيت على الإصدار Oracle 7.x، نفِّذ الأمر التالي:
      sudo yum-config-manager --enable ol7_optional_latest
    6. في حال التثبيت باستخدام AWS، يُرجى تنفيذ ما يلي: yum-configure-manager أوامر:
      yum update rh-amazon-rhui-client.noarch
      sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
    7. إذا كنت تستخدم حاليًا الإصدار 4.51.00 من Edge:

      1. قم بتنزيل ملف bootstrap_4.52.00.sh على Edge من أجل /tmp/bootstrap_4.52.00.sh:
        curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
      2. تثبيت الأداة المساعدة Edge 4.52.00 apigee-service والتبعيات من خلال لتنفيذ الأمر التالي:
        sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

        حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذين تلقّيتهما من Apigee. إذا كنت احذف pWord، سيُطلب منك إدخاله.

        بشكل تلقائي، تتحقق أداة التثبيت من تثبيت Java 1.8. إذا لم تقم بذلك، سيتم أداة مثبت التثبيت من أجلك.

        استخدِم الخيار JAVA_FIX لتحديد طريقة التعامل. تثبيت Java. تأخذ JAVA_FIX القيم التالية:

        • I: تثبيت OpenJDK 1.8 (تلقائي)
        • C: المتابعة بدون تثبيت Java
        • Q: إنهاء لتنفيذ هذا الخيار، يجب تثبيت Java بنفسك.
      3. استخدِم apigee-service لتحديث الأداة apigee-setup، مثل يوضح المثال التالي:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      4. تحديث الأداة apigee-validate على خادم الإدارة، على النحو التالي مثال يوضح:
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      5. تحديث الأداة apigee-provision على خادم الإدارة، على النحو التالي مثال يوضح:
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      6. شغِّل الأداة update على العُقد من خلال تنفيذ الأمر التالي:
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

        نفِّذ ذلك بالترتيب الموضّح في مقالة ترتيب الجهاز. تحديث.

        المكان:

        • component هو مكوِّن Edge الذي يجب تحديثه. وتشمل القيم المتاحة ما يلي:
          • cs: كاساندرا
          • edge: جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة، الرسائل معالج، جهاز توجيه، خادم QPID، خادم Postgres
          • ldap: OpenLDAP
          • ps: postgresql
          • qpid: qpidd
          • sso: الدخول المُوحَّد (SSO) في Apigee (في حال تثبيت الدخول المُوحَّد (SSO))
          • ue: واجهة مستخدم Edge جديدة
          • ui: واجهة مستخدم Edge الكلاسيكية
          • zk: حارس حديقة الحيوان
        • configFile هو ملف الإعداد نفسه الذي استخدمته تحديد Edge الخاص بك المكونات أثناء التثبيت 4.50.00 أو 4.51.00.

        يمكنك تنفيذ update.sh على جميع المكوّنات من خلال ضبط component. إلى "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت Edge الشامل (AIO). على سبيل المثال:

        /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
      7. أعِد تشغيل مكوِّن واجهة مستخدم Edge على جميع العُقد التي تعمل عليه، إذا لم تكن قد فعلت ذلك من قبل:
        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
      8. اختبار التحديث من خلال تشغيل أداة apigee-validate في "الإدارة" الخادم، كما هو موضَّح في اختبار التثبيت.

      إذا قررت لاحقًا العودة إلى الإصدار السابق من التحديث، استخدِم الإجراء الموضّح في العودة 4.52.00

      التحديث إلى الإصدار 4.52.00 من مستودع محلي

      إذا كانت عُقد Edge محمية بجدار حماية أو يُحظر الوصول إليها بطريقة أخرى مستودع Apigee على الإنترنت، ويمكنك عندئذٍ إجراء التحديث من أي مستودع محلي، أو النسخ المطابق لمستودع Apigee.

      بعد إنشاء مستودع محلي على Edge، لديك خياران لتحديث Edge من القائمة المستودع المحلي:

      • أنشئ ملف tar .للمستودع، وانسخ ملف .tar إلى عقدة، ثم حدِّث Edge من .tar
      • تثبيت خادم ويب على العقدة مع المستودع المحلي بحيث يمكن للعقد الأخرى الوصول إليه. توفّر Apigee خادم ويب Nginx لك لاستخدامها، أو يمكنك استخدام خادم ويب خادم الويب.

      للتحديث من مستودع 4.52.00 محلي:

      1. إنشاء مستودع 4.52.00 محلي كما هو موضّح في قسم "إنشاء مستودع Apigee محلي" بنسبة ثبِّت الأداة المساعدة لإعداد واجهة برمجة التطبيقات Edge على Edge.
      2. لتثبيت خدمة apigee من ملف .tar:
        1. في العقدة التي تضم المستودع المحلي، استخدم الأمر التالي لحزم المستودع المحلي في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz:
          /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
        2. انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp على العقدة الجديدة.
        3. في العقدة الجديدة، يمكنك إلغاء الملف في الدليل /tmp:
          tar -xzf apigee-4.52.00.tar.gz

          ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل. تحتوي على ملف .tar. على سبيل المثال: /tmp/repos.

        4. تثبيت أداة Edge apigee-service والتبعيات من /tmp/repos:
          sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

          لاحظ أنك قمت بتضمين المسار إلى دليل repos في هذا الأمر.

      3. لتثبيت خدمة apigee باستخدام خادم ويب Nginx:
        1. قم بتهيئة خادم الويب Nginx كما هو موضح في "التثبيت من المستودع باستخدام Nginx webserver&quot; في تثبيت Edge أداة إعداد apigee.
        2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.52.00.sh من أجل /tmp/bootstrap_4.52.00.sh:
          /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh

          حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذين حددتهما سابقًا والمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة repo.

        3. في العقدة البعيدة، ثبِّت أداة Edge apigee-setup والتبعيات:
          sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

          حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور في Repo.

      4. استخدِم apigee-service لتحديث الأداة apigee-setup، مثل يوضح المثال التالي:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
      5. تحديث الأداة apigee-validate على خادم الإدارة، على النحو التالي مثال يوضح:
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      6. تحديث الأداة apigee-provision على خادم الإدارة، على النحو التالي مثال يوضح:
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      7. شغِّل الأداة المساعدة update على العُقد بالترتيب الموضح في ترتيب تحديث الجهاز:
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

        المكان:

        • component هو مكوِّن Edge الذي يجب تحديثه. عادةً ما تقوم بتحديث المكونات التالية:
          • cs: كاساندرا
          • edge: جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه خادم QPID، خادم Postgres
          • ldap: OpenLDAP
          • ps: postgresql
          • qpid: qpidd
          • sso: الدخول المُوحَّد (SSO) في Apigee (في حال تثبيت الدخول المُوحَّد (SSO))
          • ue واجهة مستخدم Edge الجديدة
          • ui: واجهة مستخدم Edge الكلاسيكية
          • zk: حارس حديقة الحيوان
        • configFile هو ملف الإعداد نفسه الذي استخدمته تحديد مكونات Edge أثناء التثبيت 4.50.00 أو 4.51.00.

        يمكنك تنفيذ update.sh على جميع المكوّنات من خلال ضبط component. إلى "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت Edge الشامل (AIO). على سبيل المثال:

        /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
      8. أعِد تشغيل مكونات واجهة المستخدم على جميع العُقد التي تستخدمها، إذا لم يسبق لك إجراء ذلك:
        /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
      9. اختبار التحديث من خلال تشغيل أداة apigee-validate في "الإدارة" الخادم، كما هو موضَّح في اختبار التثبيت.

      إذا قررت لاحقًا العودة إلى الإصدار السابق من التحديث، استخدِم الإجراء الموضّح في العودة 4.52.00

      ترتيب تحديث الجهاز

      يعد ترتيب تحديث الأجهزة أثناء تثبيت Edge أمرًا مهمًا:

      • يجب تحديث جميع عُقد Cassandra وZoKeeper قبل تحديث أي العقد الأخرى.
      • بالنسبة لأي جهاز يحتوي على عدة مكونات Edge (خادم الإدارة ومعالج الرسائل جهاز التوجيه، خادم QPID ولكن ليس خادم Postgres)، يمكنك استخدام الخيار -c edge للتحديث جميعهم في نفس الوقت.
      • إذا حددت الخطوة أنه يجب تنفيذها على أجهزة متعددة، فنفذها في ترتيب الجهاز المحدد.
      • ولا تتوفّر خطوة منفصلة لتعديل ميزة "تحقيق الربح". ويتم تحديثه عند تحديد الخيار -c edge.

      ترقية مستقلة بعقدة واحدة

      لترقية الإعدادات المستقلة ذات العُقدة الواحدة إلى 4.52.00:

      1. تعديل جميع المكوّنات:
        /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
      2. (إذا قمت بتثبيت apigee-adminapi) قم بتحديث الأداة المساعدة apigee-adminapi:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

      ترقية مستقلة بعقدة ثنائية

      حدِّث المكونات التالية لتثبيت مستقل بعقدة 2:

      يمكنك الاطلاع على منهجيات التثبيت للحصول على قائمة طوابق Edge وأرقام العقد.

      1. تحديث Cassandra و ZooKeeper على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. تحديث Qpid وPostgres على الجهاز 2:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
      3. تحديث LDAP على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      4. تحديث مكونات Edge على الجهازين 2 و1:
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      5. تحديث واجهة المستخدم على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
      6. (في حالة تثبيت apigee-adminapi) حدّث الأداة المساعدة apigee-adminapi على الجهاز 1:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      7. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) عدِّل الدخول المُوحَّد (SSO) في Apigee على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        حيث sso_config_file هو ملف الإعداد الذي أنشأته عند خدمة الدخول المُوحَّد (SSO) المثبَّتة.

      8. أعد تشغيل مكون واجهة مستخدم Edge على الجهاز 1:
        /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

      ترقية 5 عُقد

      حدِّث المكونات التالية لتثبيت 5 عُقد:

      يمكنك الاطلاع على منهجيات التثبيت للحصول على قائمة طوابق Edge وأرقام العقد.

      1. تحديث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. تحديث Qpid وPostgres على الجهاز 4:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      3. تحديث Qpid وPostgres على الجهاز 5:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
      4. تحديث LDAP على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      5. تحديث مكونات Edge على الجهاز 4 و5 و1 و2 و3:
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      6. تحديث واجهة مستخدم Edge:
        • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، يجب تحديث المكوِّن ui على الجهاز 1، كما يبيِّن المثال التالي:
          /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
        • واجهة مستخدم Edge الجديدة: إذا كنت قد ثبَّتّ واجهة مستخدم Edge الجديدة، عليك تحديث ue على الجهاز المناسب (قد لا يكون الجهاز 1):
          /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
      7. (في حالة تثبيت apigee-adminapi) حدّث الأداة المساعدة apigee-adminapi على الجهاز 1:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      8. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) عدِّل الدخول المُوحَّد (SSO) في Apigee على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        حيث sso_config_file هو ملف الإعداد الذي أنشأته عند خدمة الدخول المُوحَّد (SSO) المثبَّتة.

      9. أعِد تشغيل مكوِّن واجهة المستخدم:
        • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، يجب إعادة تشغيل المكوِّن edge-ui على الجهاز 1، كما يبيِّن المثال التالي:
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • واجهة مستخدم Edge الجديدة: إذا كنت قد ثبَّتّ واجهة مستخدم Edge الجديدة، عليك إعادة تشغيل المكوِّن edge-management-ui على الجهاز المناسب (قد لا يكون الجهاز 1):
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      ترقية مجمّعة في 9 عُقد

      تحديث المكونات التالية لتثبيت مجمع مكون من 9 عُقد:

      يمكنك الاطلاع على منهجيات التثبيت للحصول على قائمة طوابق Edge وأرقام العقد.

      1. تحديث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. تحديث Qpid على الجهازين 6 و7:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. تحديث Postgres على الجهاز 8:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. تحديث Postgres على الجهاز 9:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      5. تحديث LDAP على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      6. حدِّث مكونات Edge على الأجهزة 6 و7 و8 و9 و1 و4 و5 بهذا الترتيب:
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      7. تحديث إما واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      8. (إذا تم تثبيت apigee-adminapi) حدِّث الأداة apigee-adminapi على الجهاز 1:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      9. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) عدِّل الدخول المُوحَّد (SSO) في Apigee على الجهاز 1:
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        حيث sso_config_file هو ملف الإعداد الذي أنشأته عند خدمة الدخول المُوحَّد (SSO) المثبَّتة.

      10. أعِد تشغيل مكوِّن واجهة المستخدم:
        • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، يجب إعادة تشغيل المكوِّن edge-ui على الجهاز 1، كما يبيِّن المثال التالي:
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • واجهة مستخدم Edge الجديدة: إذا كنت قد ثبَّتّ واجهة مستخدم Edge الجديدة، عليك إعادة تشغيل المكوِّن edge-management-ui على الجهاز المناسب (قد لا يكون الجهاز 1):
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      ترقية مجمعة مكونة من 13 عقدة

      تحديث المكونات التالية لتثبيت مجمع مكون من 13 عقدة:

      يمكنك الاطلاع على منهجيات التثبيت للحصول على قائمة طوابق Edge وأرقام العقد.

      1. تحديث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
        /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. تعديل Qpid على الجهازين 12 و13:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. تحديث Postgres على الجهاز 8:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. تحديث Postgres على الجهاز 9:
        /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      5. تحديث LDAP على الجهاز 4 و5:
        /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      6. تحديث مكونات Edge على الأجهزة 12 و13 و8 و9 و6 و7 و10 و11 بهذا الترتيب:
        /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      7. تحديث واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهازين 6 7:
        /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      8. (في حالة تثبيت apigee-adminapi) حدّث الأداة apigee-adminapi على الجهازين 6 و7:
        /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      9. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee): تعديل الدخول المُوحَّد (SSO) في Apigee على الجهازين 6 و7:
        /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

        حيث sso_config_file هو ملف الإعداد الذي أنشأته عند خدمة الدخول المُوحَّد (SSO) المثبَّتة.

      10. أعِد تشغيل مكوِّن واجهة المستخدم:
        • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، يجب إعادة تشغيل المكوِّن edge-ui على الجهازين 6 و7، كما يبيِّن المثال التالي:
          /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
        • واجهة مستخدم Edge الجديدة: إذا كنت قد ثبَّتّ واجهة مستخدم Edge الجديدة، عليك إعادة تشغيل المكوِّن edge-management-ui على الجهازين 6 و7:
          /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

      ترقية مجمعة مكونة من 12 عقدة

      تحديث المكونات التالية لتثبيت مجمع مكون من 12 عقدة:

      يمكنك الاطلاع على منهجيات التثبيت للحصول على قائمة طوابق Edge وأرقام العقد.

      1. تحديث Cassandra و ZooKeeper:
        1. على الأجهزة 1 و2 و3 في "مركز البيانات" 1:
          /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
        2. على الأجهزة 7 و8 و9 في "مركز البيانات" 2
          /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
      2. تعديل qpidd:
        1. الجهازان 4 و5 في مركز البيانات 1
          1. تحديث qpidd على الجهاز 4:
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
          2. تحديث qpidd على الجهاز 5:
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
        2. الجهازان 10 و11 في مركز البيانات 2
          1. التحديث qpidd على الجهاز 10:
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
          2. التحديث qpidd على الجهاز 11:
            /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      3. تحديث Postgres:
        1. الجهاز 6 في مركز البيانات 1
          /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
        2. الجهاز 12 في مركز البيانات 2
          /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      4. تحديث LDAP:
        1. الجهاز 1 في مركز البيانات 1
          /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
        2. الجهاز 7 في مركز البيانات 2
          /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
      5. تحديث مكونات Edge:
        1. الأجهزة 4، 5، 6، 1، 2، 3 في مركز البيانات 1
          /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
        2. الأجهزة 10، 11، 12، 7، 8، 9 في مركز البيانات 2
          /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
      6. تحديث إما واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui):
        1. الجهاز 1 في مركز البيانات 1:
          /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
        2. الجهاز 7 في مركز البيانات 2:
          /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
      7. (إذا قمت بتثبيت apigee-adminapi) قم بتحديث الأداة المساعدة apigee-adminapi:
        1. الجهاز 1 في مركز البيانات 1:
          /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
        2. الجهاز 7 في مركز البيانات 2:
          /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
      8. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) عدِّل الدخول المُوحَّد (SSO) في Apigee:
        1. الجهاز 1 في مركز البيانات 1:
          /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
        2. الجهاز 7 في مركز البيانات 2:
          /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
        3. حيث sso_config_file هو ملف الإعداد الذي أنشأته عند خدمة الدخول المُوحَّد (SSO) المثبَّتة.

      9. إعادة تشغيل واجهة مستخدم Edge الجديدة (edge-management-ui) أو واجهة مستخدم Edge الكلاسيكية (edge-ui) على الجهازين 1 و7:
        /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

      بالنسبة إلى الإعدادات غير العادية

      إذا كانت لديك تهيئة غير قياسية، فاحرص على تحديث مكونات Edge كما يلي الترتيب:

      1. ZooKeeper
      2. كاساندرا
      3. qpidd وps
      4. LDAP
      5. الحافة، بمعنى "حافة-c" على جميع العقد بالترتيب: العقدة ذات خادم Qpid، خادم Edge Postgres وخادم الإدارة ومعالج الرسائل وجهاز التوجيه
      6. Edge UI (إما الإصدار الكلاسيكي أو الجديد)
      7. apigee-adminapi
      8. الدخول المُوحَّد (SSO) في Apigee

      بعد الانتهاء من التحديث، تأكد من إعادة تشغيل مكون واجهة مستخدم Edge على جميع الأجهزة التي تعمل بها.