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

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

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

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

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

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

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

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

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

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

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

الإصدار الحالي البرامج التي تتطلّب خطوات خاصة للترقية إلى الإصدار 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، يُرجى الرجوع إلى الخطوات الواردة في الترقية المطلوبة إلى 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 ترقية إلى الإصدار 3.11.16 من Cassandra. ‫Cassandra هي أحد المكوّنات المهمة في Apigee، ويتضمّن هذا التحديث أيضًا تحديثات لبرامج التشغيل في مختلف مكوّنات وقت التشغيل والإدارة المستخدَمة لإجراء طلبات بحث في Cassandra والكتابة إليها.

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

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

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

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

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

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

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

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

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

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

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

يُرجى الرجوع إلى القسم العودة إلى الحالة السابقة لتحديث 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 - [اختيارية] استيراد مستندات smartdocs التي تم تصديرها سابقًا

بعد ترقية جميع خوادم الإدارة، يمكنك استيراد نماذج المستندات الذكية التي سبق لك تصديرها في الخطوة 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

على الرغم من أنّ 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 الجديدة للسحابة الخاصة.

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

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

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

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

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

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

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

لتعديل Apigee mTLS ، اتّبِع الخطوات التالية:

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

في حال تعذُّر إجراء التحديث، يمكنك محاولة حلّ المشكلة، ثم تنفيذ الأمر update.sh مرة أخرى. يمكنك إجراء التحديث عدة مرات وسيتم استئنافه من حيث توقّف آخر مرة.

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

معلومات حول تحديث التسجيل

تكتب الأداة المساعدة update.sh تلقائيًا معلومات السجلّ إلى:

/opt/apigee/var/log/apigee-setup/update.log

إذا لم يكن لدى المستخدم الذي يشغّل الأداة update.sh إذن بالوصول إلى هذا الدليل، ستكتب الأداة السجلّ في الدليل /tmp كملف باسم update_username.log.

إذا لم يكن لديك إذن الوصول إلى /tmp، ستتعذّر عملية استخدام الأداة update.sh.

تحديث بدون توقّف

يتيح لك التحديث بدون توقّف أو التحديث المتداول تعديل عملية تثبيت Edge بدون إيقاف Edge.

لا يمكن إجراء التحديث بدون توقّف إلا باستخدام إعدادات 5 عُقد أو أكثر.

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

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

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

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

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

      يمكنك تنفيذ update.sh على جميع المكوّنات من خلال ضبط component على "all"، ولكن فقط إذا كان لديك ملف تعريف تثبيت 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 على &quot;خادم الإدارة&quot;، كما هو موضّح في اختبار التثبيت.

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

    يمكنك تنفيذ update.sh على جميع المكوّنات من خلال ضبط component على "all"، ولكن فقط إذا كان لديك ملف تعريف تثبيت 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 على &quot;خادم الإدارة&quot;، كما هو موضّح في اختبار التثبيت.

إذا قرّرت لاحقًا التراجع عن التحديث، اتّبِع الإجراء الموضّح في التراجع عن الإصدار 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 الجديدة وعُقد تسجيل الدخول الموحّد في جميع مراكز البيانات
  • ليس هناك خطوة منفصلة لتعديل إعدادات "تحقيق الربح". يتم تعديله عند تحديد خيار الحافة -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. حظر حركة المرور في مركز البيانات 1 (DC-1) والتأكّد من إعادة توجيه كل حركة المرور إلى مركز البيانات 2 (DC-2)

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