تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

ملاحظة: بما أنّ إصدار Edge for Private Cloud 4.52.02 يتضمّن ترقية كبيرة لإصدار Cassandra، لا يُنصح بإجراء هذه الترقية لمركز بيانات واحد في كل مرة. تستند خطوات الترقية المُدرَجة في هذا المستند والبيانات التي تمّ تقديمها (مثل عدم التأثير في عدد زيارات الخادم الوكيل أثناء التشغيل) إلى افتراض أنّه يتم اتّباع خطوات الترقية كما هو موضّح في المستند: إكمال ترقية مجموعة Cassandra في جميع مراكز البيانات أولاً، ثم ترقية عقد التطبيقات، مثل edge-management-server وedge-message-processor وما إلى ذلك.

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

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

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

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

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

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

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

الاحتفاظ بنسخة احتياطية من جميع العقد
قبل التحديث، ننصحك بالاحتفاظ بنسخة احتياطية كاملة من جميع العقد لأسباب تتعلق بالأمان. اتّبِع الإجراء الخاص بالإصدار الحالي من Edge لإجراء عملية الاحتفاظ بنسخة احتياطية.
يتيح لك ذلك الحصول على خطة احتياطية في حال عدم عمل التحديث إلى إصدار جديد بشكل صحيح. لمزيد من المعلومات عن الاحتفاظ بنسخة احتياطية، يُرجى الاطّلاع على مقالة الاحتفاظ بنسخة احتياطية واستعادة البيانات.
التأكّد من تشغيل Edge
تأكَّد من تشغيل Edge أثناء عملية التحديث باستخدام الأمر التالي:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
تأكَّد من أنّ استراتيجية تجميع Cassandra هي LeveledCompactionStrategy
لإجراء التغييرات اللازمة على استراتيجية تجميع Cassandra، يُرجى الاعتماد على الإصدار الحالي. اتّبِع الخطوات التالية ثم ارجع إلى الإجراء الرئيسي للترقية:
- في حال الترقية من الإصدار 4.51.00، يُرجى الرجوع إلى مستند استراتيجية تجميع Cassandra للإصدار 4.51.00.
- إذا كنت بصدد الترقية من الإصدار 4.52.00، راجِع مستند استراتيجية تجميع Cassandra للإصدار 4.52.00.
- في حال الترقية من الإصدار 4.52.01، راجِع مستند استراتيجية تجميع Cassandra للإصدار 4.52.01.

الخطوات الخاصة التي يجب مراعاتها عند الترقية

للترقية إلى الإصدار 4.52.02 من Edge for Private Cloud، ننصحك بتنفيذ خطوات محدّدة لترقية برامج معيّنة. تعتمد الخطوات اللازمة على إصدارك الحالي. اطّلِع على الجدول أدناه للاطّلاع على البرامج المختلفة التي تتطلّب خطوات تكميلية، واتّبِع التعليمات التفصيلية لكل برنامج. بعد إكمال المهام اللازمة، ارجع إلى إجراء الترقية الرئيسي لمواصلة عملية الترقية.

الإصدار الحالي	البرامج التي تتطلّب خطوات خاصة للترقية إلى الإصدار 4.52.02	مَراجع
4.52.01	كاساندرا	تغيير استراتيجية تجميع Cassandra
4.52.00	Cassandra وZookeeper وQpid	تغيير استراتيجية تجميع Cassandra
4.51.00	Cassandra وZookeeper وQpid وPostgres	تغيير استراتيجية تجميع Cassandra

بعد تنفيذ الخطوات اللازمة استنادًا إلى إصدارك، يُرجى الرجوع إلى إجراء الترقية الرئيسي للمتابعة.

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

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

الترقية المطلوبة إلى Cassandra 3.11.16

يتضمّن الإصدار 4.52.02 من Apigee Edge for Private Cloud ترقية لنظام Cassandra إلى الإصدار 3.11.16. تشكّل Cassandra عنصرًا مهمًا في Apigee، وتشمل هذه الترقية أيضًا تعديلات على برنامج برنامج التشغيل في مكوّنات التشغيل والإدارة المختلفة المستخدَمة لطلب البيانات من Cassandra وكتابتها فيها.

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

ملاحظة: لم تعُد أداة cassandra-cli متوافقة مع Cassandra 3.X ولا يمكن استخدامها.

التراجع عن التغييرات على مستوى عالٍ

يمكنك تطبيق ترقيات Cassandra على عقدة واحدة في كل مرة. بعد تعديل عقدة، تسري تغييرات معيّنة على المخطّط لا يمكن التراجع عنها مباشرةً. اقرأ القسم الخاص بإلغاء التغييرات بعناية، لأنّه يمكن استخدام أساليب مختلفة حسب نسبة الترقية التي تم إجراؤها على المجموعة.

إذا كنت بحاجة إلى إلغاء الترقية بعد ترقية مجموعة Cassandra بالكامل، فإنّ الخيار الوحيد هو استعادة النُسخ الاحتياطية. استعد لذلك وتعرَّف على كيفية استعادة النسخة الاحتياطية من Cassandra. إذا كان بإمكانك استعادة اللقطات على مستوى الأجهزة الافتراضية بشكل أسرع من النُسخ الاحتياطية في Apigee، استخدِم لقطات الأجهزة الافتراضية لاستعادة الأجهزة الافتراضية في Cassandra إلى حالة سابقة.

لمزيد من التفاصيل، يُرجى الرجوع إلى قسم التراجع عن تحديث Cassandra 3.11.16.

توثيق واجهات برمجة التطبيقات في بوابة المطوّرين

توفّر بوابة المطوّرين في Apigee Drupal ميزات مختلفة لتوثيق واجهات برمجة التطبيقات. على الرغم من أنّه يُنصح بالتوقف عن استخدام بوابة المطوّرين المستندة إلى Drupal 7، إذا كنت لا تزال تستخدمها وتستفيد من ميزة SmartDocs، ينطبق عليك مستند استخدام واجهات برمجة تطبيقات SmartDocs. إذا كنت تستخدم إصدارات أحدث من "بوابة المطوّرين"، لن يكون هناك أي تأثير على مستندات واجهة برمجة التطبيقات أثناء عملية الترقية هذه.

عند ترقية Apigee إلى الإصدار 4.52.02، لن يتم نقل أي نماذج لواجهات برمجة التطبيقات تم إنشاؤها باستخدام ميزة SmartDocs في بوابة المطوّرين في Drupal 7 إلى الإصدار الأحدث تلقائيًا. من المفترض أن تُصدِّر كل نموذج يدويًا باستخدام بوابة المطوّرين وتستورده مرة أخرى بعد إكمال الترقية.

المصطلحات المستخدَمة في الأقسام التالية

وقت التشغيل: يشمل وقت التشغيل معالجة عدد الزيارات الواردة من الخادم الوكيل في وقت التشغيل. ويشمل ذلك جميع العمليات التي ينفّذها "أجهزة التوجيه" و"معالجات الرسائل" لمعالجة طلب البيانات من واجهة برمجة التطبيقات بشكل فعّال للوكلاء الحاليين. ومع ذلك، لا يشمل ذلك نشر أدوات وكيل جديدة أو نُسخ جديدة من أدوات الوكيل.

الإدارة: تشمل الإدارة إدارة نظام Apigee Edge. ويشمل ذلك، على سبيل المثال لا الحصر، عمليات النشر والتعديلات على التطبيقات والمنتجات والخوادم المستهدَفة ومستودعات المفاتيح وما إلى ذلك. ويتم تضمين جميع واجهات برمجة التطبيقات لإدارة الخدمات (وبرامجها مثل واجهة مستخدم Apigee وبوابة المطوّرين) في هذا النطاق.

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

الخطوة 0: حالة البدء

Cassandra في Apigee التي تعمل بالإصدار 2.1.22
مكونات Edge for Private Cloud 4.52.02:

يتواصل خادم الإدارة مع Cassandra عبر بروتوكول thrift قديم.
خوادم التشغيل (معالجات الرسائل وأجهزة التوجيه) التي تتواصل مع Cassandra عبر بروتوكول thrift قديم

حالة وقت التشغيل في هذه المرحلة	حالة الإدارة في هذه المرحلة
بيئة التشغيل تعمل بكامل طاقتها	الإدارة تعمل بكامل طاقتها

الخطوة 1: الاستعداد للترقية

تُعدّ الخطوات أدناه إضافةً إلى الملفات العادية التي تنشئها عادةً، مثل ملف الإعدادات العادي في Apigee لتفعيل ترقيات المكوّنات.

غيِّر Cassandra لاستخدام LeveledCompactionStrategy.
يمكنك الاحتفاظ بنسخة احتياطية من Cassandra باستخدام Apigee.
يمكنك أخذ لقطات شاشة للأجهزة الافتراضية لعقد Cassandra (إذا كان ذلك ممكنًا).
أنشِئ ملف إعدادات ترقية Cassandra على كل عقدة Cassandra في /opt/apigee/apigee-cassandra/cass_upgrade.conf يتضمّن المحتوى التالي:
```
# IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    
```
إذا تعذّر إنشاء الملف في /opt/apigee/apigee-cassandra/cass_upgrade.conf، أنشئ الملف /opt/silent.conf بالمحتوى نفسه على كل عقدة من عقد Cassandra.
تحذير: سيبحث برنامج تثبيت الترقية في Apigee عن الملف في المواقع الجغرافية المدرَجة أعلاه. إذا لم يكن الملف متوفّرًا في أيّ من المواقع الجغرافية المدرَجة أعلاه، ستتعذّر الترقية وستظهر رسالة مثل ما يلي:
```
could not read env location: '/opt/apigee/apigee-cassandra/cass_upgrade.conf'
file does not exist or cannot be sourced
could not read env location: '/opt/silent.conf'
file does not exist or cannot be sourced
```
في هذه الحالة، ستتعذّر الترقية، ولكن من المرجّح أن تكون خدمة Cassandra على العقدة في حالة إيقاف. يمكنك بدء خدمة Cassandra كالمعتاد وإعادة محاولة الترقية من خلال وضع ملف الإعدادات في أيٍّ من المواقع المتوقّعة. بالإضافة إلى ذلك، إذا تم العثور على الملف ولكن الإعدادات المقدَّمة غير صحيحة (على سبيل المثال، بيانات اعتماد Cassandra غير صحيحة)، سيتعذّر الترقية وسيظهر خطأ مثل ما يلي:
```
Error in PREIN scriptlet in rpm package apigee-cassandra-X.XX.XX-X.X.XXXX.noarch
```
في هذه الحالة، يمكنك أيضًا بدء خدمة Cassandra إذا تم إيقافها عند تعذُّر الترقية وإعادة محاولة الترقية بعد إصلاح الإعدادات في الملف.

إذا كنت تستخدم ميزة SmartDocs في بوابة المطوّرين في Apigee Drupal 7، اصدِر كل نموذج من نماذجك من خلال تنزيلها بتنسيق JSON من واجهة مستخدم بوابة المطوّرين. يجب استيراد هذه النماذج مرة أخرى إلى Apigee بعد تحديث خوادم الإدارة.
تأكَّد من إمكانية الوصول إلى المنفذَين 9160 و9042 من جميع مكوّنات Edge for Private Cloud 4.52.02 إلى عقد Cassandra إذا لم تكن متوفّرة. يُرجى الاطّلاع على متطلبات المنفذ للحصول على مزيد من المعلومات.

الخطوة 2: ترقية جميع عقد Cassandra

ترقية جميع عقد Cassandra في جميع المناطق واحدة تلو الأخرى شغِّل الأوامر التالية على كلّ عقدة:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
بعد تعديل عقدة، نفِّذ الأمر التالي على العقدة لإجراء بعض عمليات التحقّق قبل المتابعة:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

سيؤدي ما سبق إلى عرض ما يلي تقريبًا:

Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

حالة وقت التشغيل في هذه المرحلة	حالة الإدارة في هذه المرحلة
بيئة التشغيل تعمل بكامل طاقتها	يتمّ خفض أداء وظيفة الإدارة التالية بعد ترقية Cassandra: استخدام Management API لإنشاء منتج واجهة برمجة تطبيقات مع بيئة استخدام Management API لتعديل منتج واجهة برمجة التطبيقات مع البيئة استخدام Management API لحذف مؤسسة

ملاحظة: في حال الترقية من Edge Private Cloud 4.51.00 أو 4.52.00، عليك أيضًا اتّباع خطوات إضافية لترقية Zookeeper. على الرغم من أنّ Zookeeper وCassandra قد يكونان مُجمَّعين على العقد نفسها، إلا أنّه يُنصح بترقية Zookeeper وCassandra بشكل منفصل.

يمكنك استخدام الأمر التالي على إحدى العقد لترقية Zookeeper:

/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile

يمكن استخدام الأمر التالي على عقدة لترقية Cassandra:

/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

إذا كنت بصدد الترقية من Edge Private Cloud 4.52.01 إلى 4.52.02، تكون عملية ترقية Zookeeper عملية ترقية بسيطة ويمكن إجراؤها إلى جانب Cassandra. لترقية كلّ من Cassandra وZookeeper من خلال أمر واحد على العقد التي تمّ وضعهما فيها بشكلٍ مشترَك، استخدِم الأمر أدناه. لا يُنصح بتنفيذ ذلك إلا إذا كنت تستخدم حاليًا إصدار Zookeeper 3.8.3 في إصدار Private Cloud 4.52.01:

/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

الخطوة 3: ترقية جميع العقد الإدارية

ترقية جميع العقد الإدارية في جميع المناطق واحدة تلو الأخرى:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

حالة وقت التشغيل	حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها	واجهة برمجة تطبيقات الإدارة ذات أداء متدنٍّ: لا تعرض ميزة SmartDocs في بوابة المطوّرين في Drupal 7 أي بيانات.

الخطوة 3(أ): [اختياري] استيراد مستندات SmartDocs التي تم تصديرها سابقًا

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

حالة وقت التشغيل	حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها	الإدارة تعمل بكامل طاقتها

الخطوة 4: ترقية جميع عقد Runtime

ترقية جميع أجهزة التوجيه ووحدات معالجة الرسائل في جميع المناطق واحدة تلو الأخرى:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

حالة وقت التشغيل	حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها	الإدارة تعمل بكامل طاقتها

الخطوة 5: ترقية جميع مكوّنات Edge for Private Cloud 4.52.02 المتبقية

ترقية جميع عقد edge-qpid-server وedge-postgres-server المتبقية في جميع المناطق واحدة تلو الأخرى

في هذه المرحلة، إذا كنت بصدد الترقية من إصدارات أقدم من Edge for Private Cloud 4.52.01، وكنت تتّبع خطوات إضافية لترقية Qpid أو Postgres، اتّبِع الخطوات ذات الصلة لترقية البرنامج نفسه.

حالة وقت التشغيل	حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها	الإدارة تعمل بكامل طاقتها

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

بعد اكتمال عملية الترقية، شغِّل الأمر التالي على كل عقدة من عقد Cassandra واحدة تلو الأخرى:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

شغِّل الأمر التالي لحذف الجداول القديمة غير المستخدَمة من مجموعة Cassandra. إلى أن يتم تنفيذ هذا الإجراء، لا يمكنك استخدام ميزات معيّنة في Cassandra (مثل إعداد مصادقة جديدة، وسيستمر عمل آليات المصادقة القديمة). لا يمكن تنفيذ هذا الأمر إلا على عقدة واحدة فقط في المجموعة:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

أكمِل الخطوة 3(أ) إذا لم يسبق لك ذلك.

حالة وقت التشغيل	حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها	الإدارة تعمل بكامل طاقتها

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

على الرغم من أنّ إصدار Edge for Private Cloud 4.52.02 لا يتضمّن ترقية إلى Zookeeper، إذا كنت بصدد الترقية من إصدارات أقدم من 4.52.01، عليك اتّباع خطوات ترقية Zookeeper.

إذا كنت بصدد الترقية من الإصدار 4.51.00 أو 4.52.00 من Edge for Private Cloud، اطّلِع على الخطوات الواردة في مقالة الترقية المطلوبة إلى Zookeeper 3.8.3 لترقية Zookeeper.
إذا كنت بصدد الترقية من الإصدار 4.52.01 من Edge for Private Cloud، من المفترض أن تكون تستخدم الإصدار 3.8.3 من Zookeeper، ولن تحتاج إلى اتّباع أي خطوات خاصة لترقية Zookeeper.

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

إذا كنت بصدد الترقية من Edge for Private Cloud 4.51.00 إلى 4.52.02، عليك اتّباع خطوات ترقية Postgres، على الرغم من أنّ Edge for Private Cloud 4.52.02 لا يتضمّن ترقية Postgres. تتطلّب الترقية من Edge for Private Cloud 4.51.00 إلى 4.52.02 خطوات إضافية لترقية Postgres. يُرجى الرجوع إلى قسم الترقية المطلوبة إلى Postgres 14.
في حال الترقية من Edge for Private Cloud 4.52.00 أو 4.52.01 إلى 4.52.02، لن تكون هناك حاجة إلى خطوات إضافية لترقية Postgres.

ترقية مطلوبة إلى Qpid J-Broker

على الرغم من أنّ إصدار Edge for Private Cloud 4.52.02 لا يتضمّن ترقية إلى QPID، إذا كنت بصدد الترقية من إصدارات أقدم من 4.52.01، عليك اتّباع خطوات ترقية QPID.

إذا كنت بصدد الترقية من Edge for Private Cloud 4.51.00 أو 4.52.00 إلى 4.52.02، عليك اتّباع خطوات إضافية لترقية QPID. يُرجى الرجوع إلى قسم ترقية Qpid في حال الترقية من الإصدار 4.51.00 أو 4.52.00 إلى 4.52.02.
إذا كنت بصدد الترقية من Edge for Private Cloud 4.52.01 إلى 4.52.02، من المفترض أن تكون تستخدم أحدث إصدار من Qpid Broker، ولا يلزم اتخاذ أي خطوات إضافية لترقية QPID.

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

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

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

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

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

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

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

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

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

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

لتعديل 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 عقد أو أكثر.

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

عدِّل الأجهزة بالترتيب الصحيح للتركيب كما هو موضّح في ترتيب تحديث الأجهزة.
عندما يحين وقت تعديل أجهزة التوجيه، اختَر أي جهاز توجيه واجعله غير قابل للوصول إليه، كما هو описан في تفعيل/إيقاف إمكانية الوصول إلى الخادم (معالج الرسائل/جهاز التوجيه).
عدِّل جهاز التوجيه المحدّد وجميع مكوّنات Edge الأخرى على الجهاز نفسه الذي يعمل عليه جهاز التوجيه. تعرض جميع إعدادات Edge جهاز توجيه ومعالج رسائل في العقدة نفسها.
اجعل جهاز التوجيه متاحًا للاتصال به مرة أخرى.
كرِّر الخطوات من 2 إلى 4 لأجهزة التوجيه المتبقية.
واصِل عملية التحديث لأي أجهزة متبقية في عملية التثبيت.

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

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

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

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

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

اتّبِع الإجراء التالي لتعديل مكوّنات Edge على إحدى العقد:

أوقِف أي مهام cron تم إعدادها لإجراء عملية إصلاح على Cassandra، إن توفّرت، إلى أن تكتمل عملية التحديث.
سجِّل الدخول إلى عقدتك بصفتك مشرفًا لتثبيت حِزم RPM لنظام التشغيل Edge.
ملاحظة: على الرغم من أنّ تثبيت حِزم RPM يتطلّب إذن الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون إذن الوصول إلى الجذر.
ثبِّت yum-utils وyum-plugin-priorities:
ملاحظة: إذا كان نظام التشغيل هو RHEL 8.0 - 8.6، تخطَّ هذه الخطوة.
```
sudo yum install yum-utils
sudo yum install yum-plugin-priorities
```
أوقِف SELinux كما هو موضّح في مقالة تثبيت أداة إعداد apigee في Edge.
في حال التثبيت على Oracle 7.x، نفِّذ الأمر التالي:
```
sudo yum-config-manager --enable ol7_optional_latest
```

في حال التثبيت على 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

إذا كنت تستخدم حاليًا الإصدار 4.51.00 من Edge:
1. نزِّل ملف bootstrap_4.52.02.sh في Edge إلى /tmp/bootstrap_4.52.02.sh:
```
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
2. ثبِّت أداة Edge 4.52.02 apigee-service والموارد الاعتمادية من خلال تنفيذ الأمر التالي:
```
sudo bash /tmp/bootstrap_4.52.02.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.02.

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

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

بعد إنشاء مستودع Edge على الجهاز، يتوفّر لك خياران لتعديل Edge من المستودع على الجهاز:

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

لتحديث الإصدار من مستودع 4.52.02 على الجهاز:

أنشئ مستودعًا محليًا من الإصدار 4.52.02 كما هو موضّح في مقالة "إنشاء مستودع Apigee محلي" على الرابط تثبيت أداة إعداد Edge apigee.
ملاحظة: إذا كان لديك مستودع حالي، يمكنك إضافة مستودع 4.52.02 إليه كما هو موضّح في مقالة "تعديل مستودع Apigee محلي" على الرابط تثبيت أداة Edge apigee-setup.
لتثبيت apigee-service من ملف ‎ .tar:
1. على العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لحزمة المستودع المحلي في ملف ‎ .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
2. انسخ ملف ‎ .tar إلى العقدة التي تريد تحديث Edge عليها. على سبيل المثال، انسخها إلى الدليل /tmp على العقدة الجديدة.
3. على العقدة الجديدة، فك ضغط الملف في الدليل /tmp:
```
tar -xzf apigee-4.52.02.tar.gz
```
  ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف ‎ .tar. على سبيل المثال /tmp/repos.
4. ثبِّت أداة apigee-service في Edge والتبعيات من /tmp/repos:
```
sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
  يُرجى ملاحظة أنّك تضمّن المسار إلى دليل المستودعات في هذا الأمر.
لتثبيت apigee-service باستخدام خادم الويب Nginx:
1. اضبط خادم الويب Nginx كما هو موضّح في قسم "التثبيت من المستودع باستخدام خادم الويب Nginx" في مقالة تثبيت أداة Edge apigee-setup.
2. في العقدة البعيدة، نزِّل ملف bootstrap_4.52.02.sh في Edge إلى /tmp/bootstrap_4.52.02.sh:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
```
  حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذان ضبطتهما سابقًا للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات الخاص بعقدة المستودع.
3. في العقدة البعيدة، ثبِّت أداة apigee-setup وتبعياتها في Edge:
```
sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
  حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور للملفّ الشخصي.
استخدِم apigee-service لتعديل الأداة apigee-setup، كما هو موضَّح في المثال التالي:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
```
عدِّل الأداة apigee-validate على "خادم الإدارة"، كما هو موضَّح في المثال التالي:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
عدِّل الأداة apigee-provision على "خادم الإدارة"، كما هو موضَّح في المثال التالي:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
شغِّل الأداة 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.
  ملاحظة: يجب أن يكون ملف الإعدادات قابلاً للقراءة من قِبل مستخدِم "apigee". لتغيير المالك، استخدِم الأمر التالي:
```
chown apigee:apigee configFile
```
يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت لجهاز Edge الكل في واحد. على سبيل المثال:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
```
أعِد تشغيل مكوّنات واجهة المستخدم على جميع العقد التي تعمل عليها، إذا لم يسبق لك إجراء ذلك:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
```
اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم التحكّم"، كما هو موضّح في اختبار عملية التثبيت.

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

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

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

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

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

لترقية إعدادات مستقلة تتضمّن عقدة واحدة إلى الإصدار 4.52.02:

تعديل جميع المكوّنات:

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

(في حال تثبيت apigee-adminapi) تعديل الأداة apigee-adminapi:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

ترقية مستقلة لعقدتَين

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

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

عدِّل Cassandra وZooKeeper على الجهاز 1:

/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

عدِّل Postgres على الجهاز 2:

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

تعديل LDAP على الجهاز 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

عدِّل مكوّنات Edge على الجهازَين 2 و1:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

تعديل Qpid على الجهاز 2:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

تعديل واجهة المستخدم على الجهاز 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
(في حال تثبيت apigee-adminapi) عدِّل الأداة apigee-adminapi على الجهاز 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).
أعِد تشغيل مكوّن واجهة مستخدم Edge على الجهاز 1:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
```

ترقية 5 عقد

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

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

عدِّل Cassandra وZooKeeper على الجهاز 1 و2 و3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

عدِّل Postgres على الجهاز 4:

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

تعديل Postgres على الجهاز 5:

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

تعديل LDAP على الجهاز 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

تعديل مكوّنات Edge على الأجهزة 4 و5 و1 و2 و3:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

عدِّل Qpid على الجهاز 4:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

عدِّل Qpid على الجهاز 5:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

تعديل واجهة مستخدم 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
```
(في حال تثبيت apigee-adminapi) عدِّل الأداة apigee-adminapi على الجهاز 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).
إعادة تشغيل مكوّن واجهة المستخدم:
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر 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 وأرقام العقد.

عدِّل Cassandra وZooKeeper على الجهاز 1 و2 و3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

تعديل Postgres على الجهاز 8:

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

تعديل Postgres على الجهاز 9:

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

عدِّل LDAP على الجهاز 1:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

عدِّل مكوّنات Edge على الأجهزة 6 و7 و8 و9 و1 و4 و5 بهذا الترتيب:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

عدِّل Qpid على الجهازَين 6 و7:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

عدِّل واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهاز 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(في حال تثبيت apigee-adminapi) عدِّل الأداة apigee-adminapi على الجهاز 1:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهاز 1:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).
إعادة تشغيل مكوّن واجهة المستخدم:
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر 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 وأرقام العقد.

عدِّل Cassandra وZooKeeper على الأجهزة 1 و2 و3:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
```

تعديل Postgres على الجهاز 8:

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

تعديل Postgres على الجهاز 9:

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

عدِّل LDAP على الجهازَين 4 و5:

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

عدِّل مكوّنات Edge على الأجهزة 12 و13 و8 و9 و6 و7 و10 و11 بهذا الترتيب:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```

تعديل Qpid على الجهازَين 12 و13:

/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

عليك تحديث واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهازَين 6 و 7:
```
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
```
(في حال تثبيت apigee-adminapi) تعديل الأداة apigee-adminapi على الجهازَين 6 و7:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```
(في حال تثبيت Apigee SSO) عدِّل Apigee SSO على الجهازَين 6 و7:
```
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
```
حيث يكون sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).
إعادة تشغيل مكوّن واجهة المستخدم:
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر 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 وأرقام العقد.

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

تعديل Postgres:

الجهاز 6 في مركز البيانات 1

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

الجهاز 12 في مركز البيانات 2

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

تعديل LDAP:

الجهاز 1 في مركز البيانات 1

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

الجهاز 7 في مركز البيانات 2

/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

تعديل مكوّنات 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
```
تعديل 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
```
يمكنك تحديث واجهة المستخدم الجديدة (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
```
(في حال تثبيت 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
```
(في حال تثبيت 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
```
يُرجى إعادة تشغيل مكوّن واجهة مستخدم Edge الجديدة (edge-management-ui) أو واجهة مستخدم Edge الكلاسيكية (edge-ui) على الجهازَين 1 و7:
```
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
```

لإعداد غير عادي

إذا كانت لديك إعدادات غير عادية، عدِّل مكونات Edge بالترتيب التالي:

ZooKeeper
كاساندرا
ps
LDAP
Edge، أي الملف الشخصي "-c edge" على جميع العقد بالترتيب: العقد التي تحتوي على خادم Qpid، وخادم Edge Postgres، وخادم الإدارة، ومعالج الرسائل، وجهاز التوجيه.
ملاحظة: إذا كانت العقدة تحتوي على خادم Qpid وخادم Edge Postgres المثبَّتَين، شغِّل خطوة الملف الشخصي "-c edge".
qpidd
واجهة مستخدم Edge (سواء كانت واجهة مستخدم Edge الكلاسيكية أو الجديدة)
apigee-adminapi
Apigee SSO

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