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

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

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

الترقية إلى Postgres 14

  • في حال الترقية من الإصدار 4.51.00 من Edge for Private Cloud إلى الإصدار 4.52.02، عليك اتّباع خطوات ترقية Postgres، على الرغم من أنّ الإصدار 4.52.02 من Edge for Private Cloud لا يتضمّن ترقية Postgres. تتطلّب الترقية من Edge for Private Cloud 4.51.00 إلى 4.52.02 خطوات إضافية لترقية Postgres. يُرجى الرجوع إلى قسم الترقية المطلوبة إلى Postgres 14.
  • في حال الترقية من الإصدار 4.52.00 أو 4.52.01 من Edge for Private Cloud إلى الإصدار 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 لضمان الأداء الأمثل في الإصدارات الأحدث. على الرغم من أنّ هذه التغييرات طفيفة، إلا أنّ عملية الترقية تؤدي إلى تعطيل بعض واجهات Management API عند بدء الترقية. يتم إدراج واجهات Management API المحدّدة التي تتعطّل بشكل عام في الأقسام ذات الصلة أدناه.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • واجهات برمجة التطبيقات لوقت التشغيل التي تُعيد تحميل رموز OAuth المميّزة
  • واجهات برمجة التطبيقات لوقت التشغيل التي تستخدم سياسة Access Entity
  • واجهات Management API التي تعرض تطبيقات المطوّرين
  • واجهات Management API التي تعرض المنتجات

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

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

  • التأثير أثناء العودة إلى الحالة السابقة

    تؤثر عملية العودة من 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 2.1.x من النُسخ الاحتياطية، ولكن قد يؤدي هذا النهج إلى توقّف الخدمة وفقدان البيانات المحتمل.

إعادة المجموعات التي تتضمّن عدة مراكز بيانات إلى الحالة السابقة

تتبع عملية العودة إلى الإصدار السابق في مراكز بيانات متعددة نهجًا يعتمد على مركز بيانات تلو الآخر (DC-by-DC). في هذا النهج، تتم إعادة توجيه الزيارات من مركز البيانات الذي تتم العودة إلى إصدار سابق منه إلى مراكز بيانات وظيفية أخرى، ما يضمن عملية عودة إلى إصدار سابق خاضعة للتحكّم ومعزولة لكل من Cassandra وخادم الإدارة وعُقد وقت التشغيل لتجنُّب انقطاع الزيارات.

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

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

  • تمت ترقية مكوّنات Zookeeper وPostgres وLDAP إلى الإصدارات 4.52.02. مجموعة Edge for Private Cloud مستقرة وتعمل بشكل صحيح. إذا كانت عملية العودة إلى إصدار سابق مطلوبة، ستتم إعادة المجموعة إلى هذه الحالة.
  • ‫Cassandra في Apigee تعمل بالإصدار 2.1.22
  • مكوّنات Edge:
    • يتواصل خادم الإدارة مع 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 والمكوّنات الأخرى المتبقية للإصدار 4.52.02 من Private Cloud

ترقية جميع عُقد 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.

  • في حال الترقية من الإصدار 4.51.00 أو 4.52.00 من Edge for Private Cloud إلى الإصدار 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 for Private Cloud الذي تتم الترقية منه:

التحديث باستخدام بروتوكول 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. واصِل التحديث لأي أجهزة متبقية في عملية التثبيت.

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

استخدام ملف إعداد للتثبيت غير التفاعلي

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

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

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

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

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

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

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. أعِد تشغيل مكوّنات واجهة مستخدم Edge على جميع العُقد التي تشغّلها، إذا لم يسبق لك إجراء ذلك: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.

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

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

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

بعد إنشاء مستودع Edge محلي، يتوفّر لك خياران لتحديث Edge من المستودع المحلي:

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

للتحديث من مستودع محلي 4.52.02:

  1. أنشئ مستودعًا محليًا للإصدار 4.52.02 كما هو موضّح في "إنشاء مستودع Apigee محلي" في تثبيت أداة apigee-setup في Edge.
  2. لتثبيت apigee-service من ملف ‎ .tar:
    1. On the node with the local repo, use the following command to package the local repo into a single .tar file named /opt/apigee/data/apigee-mirror/apigee-4.52.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. ثبِّت أداة Edge apigee-service والتبعيات من /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. لتثبيت apigee-service باستخدام خادم الويب Nginx:
    1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب Nginx" في تثبيت أداة apigee-setup في Edge.
    2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.52.02.sh إلى /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. على العقدة البعيدة، ثبِّت أداة Edge apigee-setup والتبعيات: 
      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: كاساندرا
      • edge: جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم Qpid وخادم Postgres
      • ldap: OpenLDAP
      • ‫ps: postgresql
      • ‫qpid: qpidd
      • sso: الدخول الموحّد (SSO) في Apigee (إذا ثبّتّ الدخول الموحّد)
      • واجهة مستخدم Edge الجديدة في ue
      • ui: واجهة مستخدم Edge الكلاسيكية
      • ‫zk: حارس حديقة حيوانات
    • ‫configFile هو ملف الإعداد نفسه الذي استخدمته من أجل تحديد مكوّنات Edge أثناء تثبيت الإصدار 4.50.00 أو 4.51.00.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. أعِد تشغيل مكوّنات واجهة المستخدم على جميع العُقد التي تشغّلها، إذا لم تكن قد فعلت ذلك من قبل: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.

إذا قررت لاحقًا التراجع عن التحديث، استخدِم الإجراء الموضَّح في التراجع عن الإصدار 4.52.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 وManagement Server وMessage Processor وRouter، مركز بيانات واحد في كل مرة، إلى أن تتم ترقية جميع مراكز البيانات.
  • يجب تحديث مكوّنات edge-qpid-server وedge-postgres-server في جميع مراكز البيانات.
  • يجب ترقية عُقد Qpid في جميع مراكز البيانات. في حال الترقية من Edge Private Cloud 4.51.00 (أو) 4.52.00، عليك أيضًا اتّباع خطوات إضافية لترقية Qpid.
  • تعديل واجهة مستخدم Edge وواجهة مستخدم Edge الجديدة وعُقد الدخول الموحّد (SSO) في جميع مراكز البيانات
  • ليست هناك خطوة منفصلة لتعديل ميزة تحقيق الربح. يتم تحديثه عند تحديد خيار الحافة -c.

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

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

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

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

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

  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. حظر الزيارات في DC-1 والتأكّد من إعادة توجيه جميع الزيارات إلى DC-2

  5. تحديث Cassandra على الجهاز 1 و2 و3 في DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. تحديث خادم الإدارة على الجهاز 1 في DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. تحديث الموجّه ومعالج الرسائل على الجهازَين 2 و3 في DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. إلغاء حظر حركة البيانات في DC-1 والتحقّق من DC-1 والمتابعة مع DC-2 من خلال حظر حركة البيانات في DC-2 وإعادة توجيهها إلى DC-1
  9. تحديث Cassandra على الأجهزة 7 و8 و9 في DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. تحديث خادم الإدارة على الجهاز 7 في DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. تحديث الموجّه ومعالج الرسائل على الجهاز 8,9 في DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. إزالة حظر حركة البيانات في DC-2، والآن سيتعامل كلا مركزي البيانات مع حركة البيانات
  13. أعِد تشغيل أمر التحديث في جميع خوادم الإدارة في مراكز البيانات على الجهازَين 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