تحديث 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 RPMs، يمكن لأي مستخدم ضبطه.

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

يجب تحديث جميع مكونات 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 أثناء التشغيل (ما لم تكن واجهات برمجة التطبيقات لإدارة الطلبات API في وقت التشغيل) أثناء ترقية 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. عليك تنزيل وتشغيل إصدار Bootstrapped في 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 profile) أو يمكنك ترقية المكوّنات الأخرى لاحقًا. تنصح 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 لخدمة Private Cloud مثل 4.50 و4.51 يجب أن تكون متوافقة مع إصدار Zookeeper في Edge الخاص بخدمة 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 من 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. ترقية الرسائل على المضيف الرئيسي

   /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. يمكنك الحصول على المعرّف الفريد العالمي لعقدة وضع الاستعداد الجديدة من خلال تنفيذ الأمر 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 في عقدة Management Server:

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

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

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

تثبيت واجهة مستخدم 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.

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

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

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

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

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

1. وفي حال توفُّرها، أوقِف أي مهام cron تم ضبطها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
2. سجِّل الدخول إلى العُقدة كجذر لتثبيت Edge RPMs.
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. قم بتثبيت الأداة المساعدة 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: خدمة Apigee المُوحَّد (SSO) (في حال تثبيت خدمة الدخول المُوحَّد (SSO))
        • ue: واجهة مستخدم Edge الجديدة
        • ui: واجهة مستخدم Classic Edge
        • zk: Zookeeper
      • 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 من repo المحلي:

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

   لإجراء التحديث من مستودع محلي في 4.52.00:

   1. أنشئ مستودعًا محليًا للإصدار 4.52.00 كما هو موضَّح في قسم "إنشاء مستودع Apigee محلي" في تثبيت أداة إعداد apigee المساعدة في Edge.
   2. لتثبيت apigee-service من ملف .tar:
      1. في العقدة التي تتضمّن repo المحلي، استخدِم الأمر التالي لتجميع repo المحلي في ملف .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 باستخدام خادم الويب Nginx:
      1. اضبط خادم الويب Nginx كما هو موضَّح في "التثبيت من repo باستخدام خادم الويب Nginx" في تثبيت الأداة المساعدة لإعداد apigee في Edge.
      2. في العقدة البعيدة، نزِّل ملف bootstrap_4.52.00.sh Edge على /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 هو اسم المستخدم وكلمة المرور اللذان ضبطتهما سابقًا في repo، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة repo.

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

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

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