تحديث 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 في الأصل، أو مستخدمًا لديه إذن الوصول الجذر.

بعد تثبيت حِزم RPM الخاصة بـ Edge، يمكن لأي مستخدم ضبطها.

ما هي المكوّنات التي يجب تعديلها؟

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

   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

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

   "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 التالي على عقدة خادم الإدارة:

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

الخطوات التي يجب اتّباعها بعد ترقية Postgres

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

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

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

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

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

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

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

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

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

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

لتحديث مكوّن واجهة مستخدم Edge، يُرجى مراعاة إصدار Edge for Private Cloud الذي تتم الترقية منه:

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

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

لتحديث 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. تأكَّد من إمكانية الوصول إلى جهاز التوجيه.
• على عُقد جهاز توجيه واحدة:
  • قبل التحديث، اجعل جهاز التوجيه غير قابل للوصول.
  • بعد التحديث، اجعل جهاز التوجيه قابلاً للوصول إليه.
• على عُقد معالج الرسائل الفردية:
  • قبل التحديث، اجعل معالج الرسائل غير قابل للوصول.
  • بعد التحديث، اجعل معالج الرسائل قابلاً للوصول إليه.

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

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

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

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

   7. أعِد تشغيل مكوّنات واجهة مستخدم Edge على جميع العُقد التي تشغّلها، إذا لم يسبق لك ذلك:

      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|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 محلي" في تثبيت أداة apigee-setup في Edge.
   2. لتثبيت apigee-service من ملف ‎ .tar:
      1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /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

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

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

         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 (في حال تثبيت الدخول الموحّد)
        • ue واجهة مستخدم Edge الجديدة
        • ui: واجهة مستخدم Edge الكلاسيكية
        • zk: Zookeeper
      • ‫configFile هو ملف الإعداد نفسه الذي استخدمته من أجل تحديد مكوّنات Edge أثناء تثبيت الإصدار 4.50.00 أو 4.51.00.

      يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف شخصي لتثبيت Edge All-in-One (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 و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. (في حال تثبيت الدخول الموحّد (SSO) في Apigee) حدِّث الدخول الموحّد (SSO) في Apigee على الجهاز 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

   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 ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

   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 ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

   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. (في حال تثبيت الدخول الموحّد في Apigee) حدِّث الدخول الموحّد في Apigee على الجهازَين 6 و7:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

   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. (في حال تثبيت Apigee SSO) حدِّث Apigee SSO:
      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 ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

   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. Cassandra
   3. qpidd, ps
   4. LDAP
   5. Edge، أي الملف الشخصي "-c edge" على جميع العُقد بالترتيب: العُقد التي تتضمّن خادم Qpid وEdge Postgres Server وManagement Server وMessage Processor وRouter.
   6. واجهة مستخدم Edge (سواء كانت كلاسيكية أو جديدة)
   7. apigee-adminapi
   8. الدخول الموحّد (SSO) في Apigee

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