تحديث 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

• التأكّد من أنّ استراتيجية تجميع Cassandra هي LeveledCompactionStrategy
  يجب ضبط استراتيجية التوافق مع Cassandra على LeveledCompactionStrategy، كما هو موضّح في تغيير استراتيجية ضغط Cassandra.

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

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

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

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

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

أثناء عملية التحديث، قد يحدث تأخير مؤقت أو تعذُّر الكتابة في Zookeeper عند إيقاف تشغيل عقدة القائد. قد يؤثر ذلك في عمليات الإدارة التي تُجري عمليات كتابة في Zookeeper، مثل عملية نشر الخادم الوكيل وتغييرات بنية Apigee الأساسية، مثل إضافة وحدة معالجة الرسائل أو إزالتها وما إلى ذلك. من المفترض ألا يكون هناك أي تأثير على IDE واجهات برمجة التطبيقات الخاصة Apigee (ما لم تطلب IDE واجهة برمجة تطبيقات الإدارة) أثناء ترقية 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. ألغِ تثبيت zookeeper الحالي:

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

استعادة النسخة الاحتياطية

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

الترقية المطلوبة إلى Postgres 14

يتضمن هذا الإصدار من Edge ترقية إلى Postgres 14. كجزء من عملية الترقية هذه، يتم نقل جميع data Postgres إلى Postgres 14.

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

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

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

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

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

• إذا كنت تستخدم مساحة تخزين الشبكة لعُقد Postgres، وفقًا لما تنصح به Apigee، لن تحتاج إلى تثبيت عقدة Postgres جديدة. في الإجراءات أدناه، يمكنك تخطّي الخطوات التي تحدّد تثبيت node 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 على النحو الموضّح في مقالة تثبيت أداة إعداد apigee-setup في 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. ثبِّت أداة apigee-service في Edge والتبعيات:

         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. ثبِّت أداة apigee-service في Edge والتبعيات:

         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، عليك اتّباع الخطوات التالية على كلّ من المضيف الأساسي والمضيف الاحتياطي لتعديل 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

تنفيذ الترقية على الفور

لإجراء ترقية في المكان إلى Postgres 14، اتّبِع الخطوات التالية:

1. ترقية postgres على المضيف الرئيسي

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

2. شغّل أمر الإعداد على المضيف الرئيسي:

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. شغِّل الأمر configure على المضيف الرئيسي:

   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. احذف معرّف UUID للعقدة الاحتياطية من ZooKeeper من خلال إجراء طلب بيانات من واجهة برمجة التطبيقات التالية لإدارة Edge على عقدة Management Server:

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

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

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

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

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

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

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

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

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

يُرجى العِلم أنّ واجهة مستخدم Edge تتطلّب إيقاف المصادقة الأساسية واستخدام موفِّر هوية مثل SAML أو LDAP.

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

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

لتحديث مكوّن واجهة مستخدم Edge، ننصحك بالاطّلاع على إصدار Edge لـ "السحابة الإلكترونية الخاصة" الذي تتم الترقية منه:

• من 4.51.00 إلى 4.52.00 (مع تثبيت واجهة مستخدم Edge الجديدة حاليًا): اتّبِع تعليمات الترقية الواردة في هذا القسم للمكوِّن edge-management-ui.

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

لتعديل Apigee mTLS، اتّبِع الخطوات التالية:

• ألغِ تثبيت 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. تابع إجراء التحديث لأي أجهزة متبقية في عملية التثبيت.

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

• في عقدة "المعالج" و"جهاز التوجيه" المجمّعة:
  • قبل التحديث، عليك تنفيذ ما يلي:
    1. يجب جعل جهاز التوجيه غير قابل للوصول إليه.
    2. جعل "معالج الرسائل" غير قابل للوصول إليه
  • بعد التحديث، عليك تنفيذ ما يلي:
    1. يجب أن يكون من الممكن الوصول إلى "معالج الرسائل".
    2. سهِّل على جهاز التوجيه الوصول إليه.
• في عقد أجهزة التوجيه الفردية:
  • قبل التحديث، اجعل جهاز التوجيه غير قابل للوصول إليه.
  • بعد التحديث، اجعل جهاز التوجيه قابلاً للوصول إليه.
• في عقد "معالج الرسائل" الفردية:
  • قبل التحديث، اجعل "معالج الرسائل" غير قابل للوصول.
  • بعد التحديث، اجعل "معالج الرسائل" متاحًا للوصول إليه.

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

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

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

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

1. في حال توفُّرها، يمكنك إيقاف أي مهام cron تم ضبطها لإجراء عملية إصلاح في Cassandra إلى أن يكتمل التحديث.
2. سجِّل الدخول إلى عقدتك بصفتك مشرفًا لتثبيت حِزم RPM لنظام التشغيل Edge.
3. ثبِّت yum-utils وyum-plugin-priorities:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. أوقِف SELinux كما هو موضّح في مقالة تثبيت أداة إعداد apigee في Edge.
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. ثبِّت الأداة والتبعيات apigee-service في Edge 4.52.00 من خلال تنفيذ الأمر التالي:

      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: Cassandra
        • edge: جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة، ومعالج الرسائل، وجهاز التوجيه، وخادم QPID، وخادم Postgres
        • ‫ldap: OpenLDAP
        • ‫ps: postgresql
        • qpid: qpidd
        • sso: الدخول المُوحَّد في Apigee (في حال تثبيت الدخول المُوحَّد)
        • ue: واجهة مستخدم Edge الجديدة
        • ui: واجهة مستخدم Edge الكلاسيكية
        • zk: حارس حديقة الحيوانات
      • configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكونات Edge أثناء تثبيت الإصدار 4.50.00 أو 4.51.00.

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

      /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 apigee-setup.
   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. ثبِّت أداة apigee-service في Edge والتبعيات من /tmp/repos:

         sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

   3. لتثبيت apigee-service باستخدام خادم الويب Nginx:
      1. اضبط خادم الويب Nginx كما هو موضّح في قسم "التثبيت من المستودع باستخدام خادم الويب Nginx " في مقالة تثبيت أداة Edge apigee-setup.
      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 أو اسم نظام أسماء النطاقات الخاص بعقدة المستودع.

      3. في العقدة البعيدة، ثبِّت أداة apigee-setup وتبعياتها في Edge:

         sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور للملفّ الشخصي.

   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: Cassandra
        • 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 الكل في واحد. على سبيل المثال:

      /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 وZooKeeper قبل تحديث أي عقد أخرى.
   • في أي جهاز يحتوي على مكوّنات 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

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

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

   اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم 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. (في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 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. (في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 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. (في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 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

      حيث يكون 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. Edge، أي الملف الشخصي "-c edge" على جميع العقد بالترتيب: العقد التي تحتوي على خادم Qpid، وخادم Edge Postgres، وخادم الإدارة، ومعالج الرسائل، وجهاز التوجيه.
   6. Edge UI (إما الإصدار الكلاسيكي أو الجديد)
   7. apigee-adminapi
   8. Apigee SSO

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