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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الترقية إلى 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.

الترقية إلى Cassandra 3.11.16

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

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

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

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

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

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

المصطلحات المستخدَمة أدناه

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

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

أثناء عملية الترقية هذه، تتأثّر زيارات Runtime وManagement في المنطقة أو مركز البيانات (DC) حيث يتم تنفيذ التحديث. بغض النظر عن مركز البيانات الذي يتم تعديله، سيتأثر عدد من واجهات برمجة التطبيقات لإدارة المنتجات في جميع مراكز البيانات. ويتم تسجيل هذا التأثير بعد كل خطوة.

في كل خطوة أدناه، يتم وصف حالة وقت التشغيل والإدارة أثناء تقدّمك في المراحل المختلفة لإجراء الترقية.

ترقية الاستراتيجيات

مراكز بيانات متعدّدة

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

مركز بيانات واحد

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

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

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

  • واجهات برمجة التطبيقات لوقت التشغيل التي تُعيد تحميل رموز OAuth المميزة
  • واجهات برمجة التطبيقات في وقت التشغيل التي تستخدم سياسة الوصول إلى الكيانات
  • واجهات برمجة التطبيقات لإدارة إدراج تطبيقات المطوّرين
  • واجهات برمجة التطبيقات لإدارة المنتجات

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

التراجع - مستوى عالٍ

  • التأثير أثناء التراجع

    يؤثّر التراجع عن الترقية من Cassandra 3.11.x إلى 2.1.x في كلّ من وقت التشغيل وعدد زيارات الإدارة داخل مركز البيانات (DC) الذي يتمّ فيه إجراء التراجع. بالإضافة إلى ذلك، قد تواجه بعض واجهات برمجة التطبيقات لإدارة عمليات انقطاع في جميع مراكز البيانات، بغض النظر عن مركز البيانات الذي يتم التراجع عنه حاليًا.

  • اتّباع نهج التراجع عن التغييرات في "الإصدارات العلنية" من خلال "الإصدارات العلنية"

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

  • التراجع عن ترقية مجموعة جزئية

    إذا ظلّ مركز بيانات واحد على الأقل يعمل بكامل طاقته على الإصدار الأقدم من Cassandra (2.1.22)، يمكن التراجع عن ترقية مراكز البيانات الأخرى من خلال إعادة إنشائها من مركز بيانات Cassandra 2.1.X ذي الأداء الكامل.

  • التراجع على مستوى المجموعة

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

  • النقاط التي يجب مراعاتها قبل الترقية

    من المهم التعرّف على إجراءات التراجع قبل محاولة الترقية. من المهمّ مراعاة التفاصيل الدقيقة لعمليات التراجع أثناء الترقية لضمان توفّر مسارات التراجع المناسبة.

التراجع عن المجموعات باستخدام مركز بيانات واحد

يمكن أن يؤثّر ترقية Cassandra من الإصدار 2.1.x إلى الإصدار 3.11.x بشكل كبير في عدد الزيارات أثناء التشغيل وبعض واجهات برمجة التطبيقات لإدارة Cassandra. تنطبق هذه التأثيرات أيضًا أثناء التراجع عن التغييرات، وقد تؤدي إلى توقُّف الخدمة أو فقدان البيانات.

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

إذا لم تكن إضافة مركز بيانات جديد ممكنة ولكن لا تزال إمكانية التراجع مطلوبة، تأكّد من الاحتفاظ بنسخ احتياطية موثوقة قبل الترقية. من الممكن استعادة Cassandra 2.1.x من النُسخ الاحتياطية، ولكن قد يتضمن هذا النهج فترة توقف الخدمة وفقدان البيانات المحتمَل.

التراجع عن مجموعات البيانات في مراكز بيانات متعددة

يتبع التراجع عن التغييرات في مراكز بيانات متعددة نهجًا مركزيًا لكل مركز بيانات. في هذا النهج، تتم إعادة توجيه الزيارات الواردة من مركز البيانات الذي يتم التراجع عنه إلى مراكز بيانات وظيفية أخرى، ما يضمن عملية تراجع خاضعة للتحكم ومعزولة لكل من Cassandra وManagement Server وRuntime nodes لتجنُّب انقطاع الزيارات.

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

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

  • سبق أن تمت ترقية مكوّنات Zookeeper وPostgres وLDAP إلى الإصدار 4.52.02. يجب أن تكون مجموعة Edge لسحابة خاصة مستقرة وتعمل بشكل سليم. إذا كان من الضروري التراجع، ستتم إعادة المجموعة إلى هذه الحالة.
  • Cassandra في Apigee التي تعمل بالإصدار 2.1.22
  • مكونات الحافة:
    • يتواصل خادم الإدارة مع Cassandra عبر بروتوكول thrift قديم.
    • خوادم وقت التشغيل (معالجات الرسائل وأجهزة التوجيه) التي تتواصل مع Cassandra عبر بروتوكول thrift قديم
حالة وقت التشغيل في هذه المرحلة حالة الإدارة في هذه المرحلة
بيئة التشغيل تعمل بكامل طاقتها الإدارة تعمل بكامل طاقتها

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

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

  1. تغيير Cassandra لاستخدام LeveledCompactionStrategy
  2. الاحتفاظ بنسخة احتياطية من Cassandra باستخدام Apigee:
  3. يمكنك أخذ لقطات شاشة للأجهزة الافتراضية لعقد Cassandra (إذا كان ذلك ممكنًا).
  4. أنشِئ ملف إعدادات ترقية 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.
  5. إذا كنت تستخدم ميزة SmartDocs في بوابة المطوّرين في Apigee Drupal 7، اصدِر كل نموذج من نماذجك من خلال تنزيله بتنسيق JSON من واجهة مستخدم بوابة المطوّرين. يجب استيراد هذه النماذج مرة أخرى إلى Apigee بعد تحديث خوادم الإدارة.
  6. تأكَّد من إمكانية الوصول إلى المنفذَين 9160 و9042 من جميع مكوّنات Edge إلى عقد Cassandra إذا لم تكن متوفّرة. يُرجى الاطّلاع على متطلبات المنفذ للحصول على مزيد من المعلومات.

الخطوة 2: إعادة توجيه الزيارات بعيدًا عن مركز البيانات الأول

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

الخطوة 3: ترقية جميع عقد Cassandra في مركز البيانات الأول

  1. عليك ترقية جميع عقد Cassandra في مركز البيانات واحدة تلو الأخرى. شغِّل الأوامر التالية على كل عقدة واحدة تلو الأخرى: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. بعد تعديل عقدة، نفِّذ الأمر التالي على العقدة لإجراء بعض عمليات التحقّق قبل المتابعة: 
    /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
  3. بعد اكتمال عملية الترقية، نفِّذ الأمر post_upgrade التالي على كل عقدة من عقد Cassandra واحدة تلو الأخرى: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
حالة وقت التشغيل في هذه المرحلة حالة الإدارة في هذه المرحلة
  • حظر حركة الزيارات في وقت التشغيل في مراكز البيانات التي تتم ترقيتها
  • وقت التشغيل يعمل بشكل كامل في مراكز البيانات الأخرى

الخطوة 4: ترقية جميع العقد الإدارية في مركز البيانات الأول

ترقية جميع العقد الإدارية في مركز البيانات:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
حالة وقت التشغيل في هذه المرحلة حالة الإدارة في هذه المرحلة
  • حظر حركة الزيارات في وقت التشغيل في مراكز البيانات التي تتم ترقيتها
  • بيئة التشغيل تعمل بكامل طاقتها

الخطوة 5: ترقية جميع العقد في وقت التشغيل في مركز البيانات الأول

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
حالة وقت التشغيل في هذه المرحلة حالة الإدارة في هذه المرحلة
  • حظر حركة الزيارات في وقت التشغيل في مراكز البيانات التي تتم ترقيتها
  • وقت التشغيل يعمل بشكل كامل في مراكز البيانات الأخرى

الخطوة 6: إعادة توجيه الزيارات إلى مركز البيانات الأول

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

الخطوة 7: ترقية مراكز البيانات الأخرى

كرِّر الخطوة 1 إلى الخطوة 6 في مراكز البيانات المتبقية، واحدة تلو الأخرى، من خلال إعادة توجيه الزيارات بعيدًا عن مراكز البيانات هذه وتعديل برنامج Apigee وإعادة تفعيل الزيارات في مراكز البيانات هذه.

الخطوة 8: إعادة تنفيذ خطوة الترقية في جميع عقد الإدارة

أعِد تشغيل أمر الترقية التالي في جميع عقد الإدارة في جميع مراكز البيانات:

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

الخطوة 9 - [اختياري] استيراد المستندات الذكية التي تم تصديرها سابقًا

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

لا تحتاج إلى إجراء ذلك إلا إذا كنت تستخدم بوابة المطوّرين المستندة إلى Drupal 7 وكنت تستخدِم ميزة smartdocs.

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

الخطوة 10: إسقاط الجداول غير المستخدَمة

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

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

الخطوة 11: ترقية جميع مكونات Edge والمكونات الأخرى المتبقية لإصدار Private Cloud 4.52.02

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

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

الترقية إلى Qpid J-Broker

على الرغم من أنّ الإصدار 4.52.02 من Edge for Private Cloud لا يتضمّن ترقية إلى 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.
  • إذا كنت بصدد الترقية من الإصدار 4.52.01 من Edge for Private Cloud إلى الإصدار 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 لـ "السحابة الإلكترونية الخاصة" الذي تتم الترقية منه:

التحديث باستخدام 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 عقد أو أكثر.

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

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

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

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

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

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

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

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

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

    1. نزِّل ملف bootstrap_4.52.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. ثبِّت أداة apigee-service Edge 4.52.02 والتبعيات من خلال تنفيذ الأمر التالي: 
      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-management-ui|edge-ui] restart
    8. اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم التحكّم "، كما هو موضّح في اختبار عملية التثبيت.

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

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

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

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

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

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

  1. أنشئ مستودعًا محليًا من الإصدار 4.52.02 كما هو موضّح في مقالة "إنشاء مستودع Apigee محلي" على الرابط تثبيت أداة إعداد Edge apigee.
  2. لتثبيت 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

      يُرجى ملاحظة أنّك تضمّن المسار إلى دليل المستودعات في هذا الأمر.

  3. لتثبيت 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 هو اسم المستخدم وكلمة المرور للملفّ الشخصي.

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

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

ترتيب تحديث الجهاز - الترقية من 4.51.00 (أو) 4.52.00 (أو) 4.52.01

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

  • يجب تحديث جميع عقد ZooKeeper في مراكز البيانات قبل ترقية جميع المكوّنات الأخرى. في حال الترقية من Edge Private Cloud 4.51.00 (أو) 4.52.00، عليك أيضًا اتّباع خطوات إضافية لترقية zookeeper.
  • يجب تحديث Postgresql في جميع مراكز البيانات. إذا كنت بصدد الترقية من Edge Private Cloud 4.51.00، عليك أيضًا اتّباع خطوات إضافية لترقية postgres.
  • يجب تعديل عقد LDAP في جميع مراكز البيانات.
  • يجب تحديث جميع عقد Cassandra وخادم الإدارة ومعالج الرسائل وعقد التوجيه، مركز بيانات واحد في كل مرة، إلى أن تتم ترقية جميع مراكز البيانات.
  • يجب تعديل مكوّنات edge-qpid-server وedge-postgres-server في جميع مراكز البيانات.
  • يجب ترقية عقد Qpid في جميع مراكز البيانات. إذا كنت بصدد الترقية من Edge Private Cloud 4.51.00 (أو) 4.52.00، عليك أيضًا اتّباع خطوات إضافية لترقية Qpid.
  • تعديل واجهة مستخدِم Edge وواجهة مستخدِم Edge الجديدة وعقد SSO في جميع مراكز البيانات
  • ما مِن خطوة منفصلة لتعديل ميزة "تحقيق الربح". ويتم تعديله عند تحديد الخيار -c edge.

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

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

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

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

ترقية 5 عقد

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

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

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

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

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

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

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

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

  11. إعادة تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر 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. عدِّل ZooKeeper على الأجهزة 1 و2 و3 و7 و8 و9 في كلا مركزَي البيانات:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. عدِّل Postgres على الجهازَين 6 و12 في كلا مركزَي البيانات: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. عدِّل LDAP على الجهازَين 1 و7 في كل من الخادمَين الدليلَين: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. حظر الزيارات في "مركز البيانات 1" والتأكّد من إعادة توجيه جميع الزيارات إلى "مركز البيانات 2"

  5. تعديل Cassandra على الجهاز 1 و2 و3 في مركز البيانات 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. تعديل Management Server على الجهاز 1 في DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. تعديل جهاز التوجيه ومعالج الرسائل على الجهازَين 2 و3 في مركز البيانات 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. إزالة حظر حركة البيانات في "مركز البيانات 1" والتحقّق منه ثم المتابعة مع "مركز البيانات 2" من خلال حظر حركة البيانات في "مركز البيانات 2" وإعادة توجيهها إلى "مركز البيانات 1"
  9. عليك تحديث Cassandra على الأجهزة 7 و8 و9 في مركز البيانات 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. Update Management Server على الجهاز 7 في DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. تعديل جهاز التوجيه ومعالج الرسائل على الجهازَين 8 و9 في مركز البيانات 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. أزِل حظر الزيارات في "مركز البيانات 2"، وسيتولى الآن كلا مركزَي البيانات معالجة الزيارات.
  13. أعِد تشغيل الأمر update في جميع خوادم الإدارة على خوادم التحكم في حدود الجلسة على الجهازَين 1 و7: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. عدِّل edge-qpid-server وedge-postgres-server على الأجهزة 4 و5 و6 و10 و11 و12 في كلتا نقطتَي التحكّم في البيانات: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. عدِّل Qpid على الأجهزة 4 و5 و10 و11 في كلتا نقطتَي التوجيه: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. عدِّل إما واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) في كلتا نقطتَي التحكّم في البيانات: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (في حال تثبيت apigee-adminapi) عدِّل apigee-adminapi في كلتا نقطتَي التحكّم في البيانات: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (في حال تثبيت Apigee SSO) عدِّل عقد Apigee SSO في كلتا نقطتَي التحكّم في البيانات: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. أعِد تشغيل مكوّن واجهة مستخدم Edge الجديد (edge-management-ui) أو مكوّن واجهة مستخدم Edge الكلاسيكي (edge-ui) في كل من الخادمَين الإداريَين: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart