تحديث Apigee Edge 4.52.02 أو 4.53.00 إلى 4.53.01

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

للحصول على نظرة عامة على مسارات الترقية المتوافقة، راجِع مصفوفة توافق الترقية لإصدارات Edge for Private Cloud.

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

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

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

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

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

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

مراجعة التغييرات في الإصدار 4.53.01 من Edge for Private Cloud

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

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

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

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

  • التأكّد من تشغيل Edge
    تأكَّد من أنّ Edge يعمل أثناء عملية التحديث باستخدام الأمر التالي: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • التحقّق من المتطلبات الأساسية لـ Cassandra

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

  • ضبط مفاتيح وشهادات موفِّر الهوية في Edge for Private Cloud 4.53.01

    في Edge for Private Cloud 4.53.01، يتم الآن ضبط مفاتيح وشهادات موفِّر الهوية المستخدَمة في مكوّن apigee-sso من خلال ملف تخزين مفاتيح. عليك تصدير المفتاح والشهادة اللذين استخدمتهما سابقًا إلى ملف تخزين مفاتيح. اتّبِع الخطوات الواردة في قسم خطوات تعديل Apigee SSO من الإصدارات القديمة للحصول على خطوات تفصيلية قبل تعديل مكوّن الدخول المُوحَّد (SSO).

  • متطلبات Python
    تأكَّد من تثبيت Python 3 على جميع العُقد، بما في ذلك عُقد Cassandra، قبل محاولة الترقية.

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

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

الإصدار الحالي البرامج التي تتطلّب خطوات خاصة للترقية إلى الإصدار 4.53.01
4.52.02 ‫LDAP وCassandra وZookeeper وPostgres
4.53.00 LDAP وZookeeper وPostgres

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

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

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

يجب الترقية إلى OpenLDAP 2.6

في ما يلي الإجراءات التفصيلية لترقية خدمة LDAP الأساسية في Apigee Edge for Private Cloud من الإصدار القديم OpenLDAP 2.4 إلى OpenLDAP 2.6. هذه الترقية هي شرط إلزامي لتحديث الإصدار 4.53.01 والإصدارات الأحدث من Apigee Edge for Private Cloud. تنطبق هذه الترقية على جميع طُرق نشر Apigee LDAP: خادم واحد، وخادم نشط/خامل، وخادم نشط/نشط (متعدد المصادر).

المتطلّبات الأساسية والاعتبارات

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

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

الإعداد والتثبيت (جميع خوادم LDAP)

إنّ الخطوات الواردة في هذا القسم (من الخطوة 2 إلى الخطوة 5) متطابقة لجميع طُرق نشر LDAP. يجب تنفيذ هذه الإجراءات على كل خادم تم تثبيت مكوّن apigee-openldap عليه، بغض النظر عن دوره.

  1. يُرجى التأكّد من إيقاف جميع edge-management-server وedge-ui قبل المتابعة في ترقية LDAP. 
    apigee-service edge-management-server stop
apigee-service edge-ui stop

  2. الاحتفاظ بنسخة احتياطية من بيانات LDAP الحالية

    قبل إجراء أي تغييرات، عليك إجراء نسخة احتياطية كاملة من بيانات LDAP الحالية من جميع خوادم LDAP. يؤدي ذلك إلى إنشاء نقطة استعادة آمنة.

    • نفِّذ أمر الاحتفاظ بنسخة احتياطية. ينشئ هذا الإجراء أرشيفًا احتياطيًا يتضمّن طابعًا زمنيًا ضمن الدليل /opt/apigee/backup/openldap. 
      apigee-service apigee-openldap backup
    • الحصول على إجمالي عدد السجلات: سجِّل عدد السجلات في الدليل للتحقّق من صحة عملية الترقية (يجب أن يتطابق عدد السجلات على جميع خوادم LDAP). هذا هو التحقّق من صحة البيانات. 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

  3. إيقاف LDAP وتنظيف أدلة البيانات

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

    • أوقِف خدمة LDAP. 
      apigee-service apigee-openldap stop
    • أزِل نهائيًا بيانات LDAP القديمة وأدلة الإعدادات. 
      rm -rf /opt/apigee/data/apigee-openldap/*

  4. تثبيت إصدار LDAP الجديد وضبطه

    على جميع خوادم LDAP، استخدِم نصوص Apigee البرمجية العادية لتنزيل إصدار المكوّن الجديد وتثبيته.

    • تثبيت مكوّن LDAP الجديد: يقرأ نص التحديث ملف الإعداد ويثبّت حزمة apigee-openldap الجديدة. 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf
    • التحقّق من صحة إصدار LDAP الجديد:بعد اكتمال عملية التثبيت، أعِد تحميل الملف الشخصي وتأكَّد من تثبيت إصدار LDAP الجديد بشكلٍ صحيح. 
      source ~/.bash_profile
ldapsearch -VV
Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

  5. إيقاف LDAP على جميع الخوادم قبل استعادة البيانات

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

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*

  6. استعادة بيانات LDAP

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

    1. تحديد الخادم النشط الأول لاستعادة البيانات

      • في حال إعداد خادم واحد: هذا هو خادم LDAP الوحيد. يمكنك الانتقال مباشرةً إلى الخطوة التالية.
      • بالنسبة إلى عمليات الإعداد النشطة وغير النشطة والنشطة والنشطة: نفِّذ أمر التشخيص التالي على كل خادم LDAP: 
        grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
Note:
-If this command returns output, the server is a passive server.
-If it returns no output, the server is the active server.

    2. استعادة البيانات من النسخة الاحتياطية

      قبل المتابعة، تأكَّد من إكمال الخطوة 5 بنجاح على جميع خوادم LDAP.

      • في الخادم النشط الأول الذي حدّدته أعلاه، انتقِل إلى دليل النسخ الاحتياطي. 
        cd /opt/apigee/backup/openldap
      • نفِّذ الأمر restore. ننصحك بشدة بتحديد الطابع الزمني الدقيق للنسخة الاحتياطية من الخطوة 2 لمنع استعادة إصدار غير مقصود أو قديم. 
        # To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
      • بعد اكتمال عملية الاستعادة بنجاح، ابدأ خدمة LDAP على الخادم النشط الأول. 
        apigee-service apigee-openldap start

  7. بدء تشغيل خوادم LDAP المتبقية

    في حال إعداد خوادم متعددة، ابدأ الخدمة على كل خادم من خوادم LDAP: 

    apigee-service apigee-openldap start

  8. التحقّق النهائي من الصحة

    الخطوة الأخيرة هي التأكّد من أنّ عملية الترقية تمت بنجاح وأنّ البيانات متسقة في جميع مجموعات LDAP.

    • نفِّذ أمر التحقّق من الصحة على جميع خوادم LDAP. يجب أن يكون عدد السجلات متطابقًا على جميع الخوادم، ويجب أن يتطابق مع العدد الذي سجّلته في الخطوة 2.
      • # Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • بعد التأكّد من صحة البيانات وتناسقها، يكتمل ترقية LDAP. يمكنك الآن المتابعة وبدء edge-management-server وedge-ui وأي مكونات أخرى تابعة وفقًا لإجراءات الترقية العادية في مؤسستك.

ترقية إلزامية إلى الإصدار 4.0.18 من Cassandra

يتضمّن الإصدار 4.53.01 من Apigee Edge Private Cloud ترقية Cassandra إلى الإصدار 4.0.18.

الترقيات والرجوع إلى الإصدار السابق

  • تُعدّ عملية الترقية من Cassandra 3.11.X إلى Cassandra 4.0.X عملية سلسة. يتوافق الإصدار Cassandra 4.0.X، الذي تم إصداره مع Edge for Private Cloud 4.53.00، مع مكوّنات وقت التشغيل والإدارة في الإصدار Private Cloud 4.52.02.
  • لا يمكن الرجوع مباشرةً إلى الإصدار 3.11.X من الإصدار 4.0.X من Cassandra. إنّ التراجع باستخدام النُسخ المتماثلة أو النُسخ الاحتياطية هو إجراء معقّد وقد يتضمّن وقت تعطل و/أو فقدان البيانات. يُفضّل تحديد المشاكل وحلّها والترقية إلى Cassandra 4.0.X بدلاً من الرجوع إلى إصدار أقدم.
  • من المهم التعرّف على إجراءات التراجع قبل محاولة الترقية. من المهم مراعاة الفروق الدقيقة في عملية الرجوع إلى الإصدار السابق أثناء الترقية لضمان توفُّر مسارات الرجوع المناسبة.

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

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

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

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

يتيح تشغيل مراكز بيانات متعددة باستخدام Edge for Private Cloud 4.52.02 المزيد من المرونة في عمليات الرجوع إلى الإصدار السابق أثناء الترقية إلى Edge for Private Cloud 4.53.00.

  • تعتمد عمليات الرجوع إلى الإصدار السابق على توفّر مركز بيانات واحد على الأقل يعمل بإصدار Cassandra الأقدم (3.11.X).
  • في حال تمت ترقية مجموعة Cassandra بالكامل إلى الإصدار 4.0.X، يجب عدم الرجوع إلى الإصدار 3.11.X من Cassandra. يجب مواصلة استخدام إصدار Cassandra الأحدث مع المكوّنات الأخرى من Private Cloud 4.53.00 أو 4.52.02.
  1. ترقية مركز بيانات Cassandra واحد في كل مرة: ابدأ بترقية عُقد Cassandra بشكل فردي ضمن مركز بيانات واحد. أكمِل ترقيات جميع عُقد Cassandra في مركز بيانات واحد قبل الانتقال إلى مركز البيانات التالي.
  2. الإيقاف المؤقت والتحقّق من الصحة: بعد ترقية أحد مراكز البيانات، أوقِف العملية مؤقتًا للتأكّد من أنّ مجموعة Private Cloud، وخاصةً مركز البيانات الذي تمت ترقيته، تعمل بشكلٍ سليم.
  3. ملاحظة: لا يمكنك العودة إلى إصدار Cassandra السابق إلا إذا كان لديك مركز بيانات واحد على الأقل لا يزال يعمل بالإصدار القديم.
  4. حساسية الوقت: يمكنك الإيقاف مؤقتًا لفترة قصيرة (ننصح ببضع ساعات) للتحقّق من صحة الوظائف، ولكن لا يمكنك البقاء في حالة إصدار مختلط إلى أجل غير مسمى. ويرجع ذلك إلى أنّ مجموعة Cassandra غير المتجانسة (التي تحتوي على عُقد بإصدارات مختلفة) لها قيود تشغيلية.
  5. الاختبار الشامل: تنصح Apigee بشدة بإجراء اختبار شامل للأداء والوظائف قبل ترقية مركز البيانات التالي. بعد ترقية جميع مراكز البيانات، لن يكون من الممكن الرجوع إلى الإصدار السابق.
الرجوع إلى الإصدار السابق كعملية تتضمّن نقطتَي تحقّق
  1. نقطة التحقّق 1: الحالة الأولية، مع توفّر جميع المكوّنات بالإصدار 4.52.02. يمكن إجراء عملية التراجع الكامل طالما أنّ مركز بيانات واحدًا على الأقل من Cassandra لا يزال يستخدم الإصدار الأقدم.
  2. نقطة التحقّق 2: بعد تعديل جميع عُقد Cassandra في جميع مراكز البيانات يمكنك الرجوع إلى هذه الحالة، ولكن لا يمكنك العودة إلى نقطة التحقّق 1.
مثال

لنفترض أنّ لديك مجموعة من مركزَي بيانات (DC):

  1. حالة البدء: عقد Cassandra في كلا مركزي البيانات تعمل بالإصدار 3.11.X. تتوفّر جميع العُقد الأخرى على الإصدار 4.52.02 من Edge for Private Cloud. افترِض ثلاث عُقد Cassandra لكل مركز بيانات.
  2. ترقية DC-1: قم بترقية عُقد Cassandra الثلاث في DC-1 واحدة تلو الأخرى.
  3. الإيقاف المؤقت والتحقّق من الصحة: أوقِف مؤقتًا للتأكّد من أنّ المجموعة، وخاصةً DC-1، تعمل بشكل صحيح (تحقَّق من الأداء والوظائف). يمكنك الرجوع إلى الحالة الأولية باستخدام عُقد Cassandra في DC-2. تذكَّر أنّ هذا الإيقاف المؤقت يجب أن يكون مؤقتًا بسبب قيود مجموعة Cassandra المختلطة الإصدارات.
  4. ترقية DC-2: قم بترقية عُقد Cassandra الثلاث المتبقية في DC-2. سيصبح هذا هو نقطة التحقّق الجديدة للرجوع إلى الإصدار السابق.
  5. ترقية المكوّنات الأخرى: يمكنك ترقية عقد الإدارة ووقت التشغيل والإحصاءات كالمعتاد في جميع مراكز البيانات، عقدة واحدة ومركز بيانات واحد في كل مرة. في حال حدوث مشاكل، يمكنك الرجوع إلى حالة الخطوة 4.

المتطلبات الأساسية لترقية Cassandra

يجب تشغيل Cassandra 3.11.16 مع Edge for Private Cloud 4.52.02 والتأكّد مما يلي:
  1. تعمل المجموعة بأكملها بشكل كامل مع Cassandra 3.11.16.
  2. تم ضبط استراتيجية الضغط على LeveledCompactionStrategy (وهو شرط أساسي للترقية إلى الإصدار 4.52.02).

  3. تأكَّد من إكمال كل خطوة من الخطوات أدناه كجزء من عملية الترقية الأولية لبرنامج Cassandra 3.11 في Edge for Private Cloud الإصدار 4.52.02.

    • تم تنفيذ الأمر post_upgrade على كل عقدة Cassandra أثناء الترقية السابقة
    • تم تنفيذ الأمر drop_old_tables على مجموعة Cassandra بأكملها أثناء عملية الترقية السابقة.

إذا لم تكن متأكدًا من تنفيذ الأمرين post_upgrade وdrop_old_tables على Cassandra 3.11 أثناء استخدام Edge for Private Cloud 4.52.02، يمكنك إعادة تنفيذهما بأمان قبل محاولة الترقية إلى الإصدار 4.53.01.

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

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

  1. احتفاظ Cassandra بنسخة احتياطية باستخدام Apigee
  2. أخذ لقطات من الأجهزة الافتراضية لعُقد Cassandra (إذا كان ذلك ممكنًا)
  3. تأكَّد من إمكانية الوصول إلى المنفذ 9042 من جميع مكوّنات Edge for Private Cloud، بما في ذلك "خادم الإدارة" و"معالج الرسائل" و"الموجّه" وQpid وPostgres، إلى عقد Cassandra إذا لم يتم إعدادها من قبل. لمزيد من المعلومات، يُرجى الاطّلاع على متطلبات المنفذ.

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

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

بعد ترقية جميع عُقد Cassandra في مركز بيانات، انتظر بعض الوقت (من 30 دقيقة إلى بضع ساعات) قبل المتابعة مع العُقد في مركز البيانات التالي. خلال هذه الفترة، راجِع مركز البيانات الذي تم تعديله بدقة وتأكَّد من أنّ مقاييس الأداء والوظائف لمجموعة Apigee لم تتأثّر. هذه الخطوة ضرورية لضمان استقرار مركز البيانات الذي تمت ترقية Cassandra فيه إلى الإصدار 4.0.X، بينما تظل بقية مكونات Apigee على الإصدار 4.52.02.

  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
  3. سيؤدي ما سبق إلى عرض نتيجة مشابهة لما يلي: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. نفِّذ أمر post_upgrade التالي على عقدة Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. نفِّذ أوامر nodetool التالية لإعادة إنشاء الفهارس على عقدة Cassandra: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     إذا كنت تستخدم تحقيق الربح، نفِّذ أيضًا أوامر إعادة إنشاء الفهارس التالية ذات الصلة بمساحات مفاتيح تحقيق الربح: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

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

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

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

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

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

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

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

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

يجب الترقية إلى الإصدار 3.8.4 من Zookeeper

يتضمّن هذا الإصدار من Edge for Private Cloud ترقية إلى Zookeeper 3.8.4. وكجزء من عملية الترقية هذه، سيتم نقل جميع بيانات Zookeeper إلى الإصدار 3.8.4 من Zookeeper.

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

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

على مستوى عالٍ، تتضمّن عملية الترقية أخذ نسخة احتياطية من كل عقدة. يلي ذلك ترقية جميع العُقد التابعة والمراقبة، وأخيرًا ترقية العقدة الرئيسية.

إنشاء نسخة احتياطية

احتفِظ بنسخة احتياطية من جميع عُقد Zookeeper لاستخدامها في حال الحاجة إلى التراجع عن التغييرات. يُرجى العِلم أنّ عملية الرجوع إلى إصدار سابق ستؤدي إلى استعادة Zookeeper إلى الحالة التي كانت عليها عند إنشاء النسخة الاحتياطية. ملاحظة: سيتم فقدان أي عمليات نشر أو تغييرات في البنية الأساسية في Apigee منذ إجراء النسخة الاحتياطية (التي يتم تخزين معلوماتها في Zookeeper) أثناء عملية الاستعادة. 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

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

تحديد القائد والمتابعين والمراقبين

ملاحظة: تستخدم عيّنات الأوامر أدناه الأداة المساعدة nc لإرسال البيانات إلى Zookeeper. يمكنك أيضًا استخدام أدوات مساعدة بديلة لإرسال البيانات إلى Zookeeper.

  1. إذا لم يكن مثبَّتًا على عقدة ZooKeeper، ثبِّت nc: 
      sudo yum install nc
  2. نفِّذ أمر nc التالي على العقدة، حيث 2181 هو منفذ ZooKeeper: 
      echo stat | nc localhost 2181

    من المفترض أن تظهر لك نتيجة مثل ما يلي:

      Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

    في السطر Mode من الناتج الخاص بالعُقد، من المفترض أن يظهر لك observer أو leader أو follower (أي مصوّت ليس هو القائد) استنادًا إلى إعدادات العقدة. ملاحظة: في عملية التثبيت المستقلة لـ Edge مع عقدة ZooKeeper واحدة، يتم ضبط Mode على مستقل.

  3. كرِّر الخطوتَين 1 و2 على كل عقدة ZooKeeper.

ترقية Zookeeper على عُقد المراقبة والمتابعة

يمكنك ترقية Zookeeper على كل من عقد المراقبة والمتابعة على النحو التالي:

  1. نزِّل برنامج bootstrap وشغِّله لإصدار Edge for Private Cloud 4.53.01، كما هو موضّح في التحديث إلى الإصدار 4.53.01 على عقدة متصلة بالإنترنت خارجيًا. من المحتمل أن تختلف العملية حسب ما إذا كانت العقدة متصلة بالإنترنت خارجيًا أو كنت بصدد إجراء عملية تثبيت بلا إنترنت.
  2. ترقية مكوّن Zookeeper: 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
     ملاحظة: إذا كانت هذه العُقد تتضمّن مكونات أخرى مثبّتة (مثل Cassandra)، يمكنك ترقيتها أيضًا الآن (كما هو الحال مع الملف الشخصي cs,zk) أو يمكنك ترقية المكونات الأخرى لاحقًا. تنصح Apigee بترقية Zookeeper أولاً فقط والتأكّد من أنّ مجموعتك تعمل بشكل صحيح قبل ترقية المكوّنات الأخرى.
  3. كرِّر الخطوات أعلاه على كل عقد مراقبة وعقد تابعة في Zookeeper.

إيقاف تشغيل الجهاز الرئيسي

بعد ترقية جميع عُقد المراقبة والمتابعة، أوقِف العقدة الرئيسية. على العقدة المحدّدة كعقدة رئيسية، نفِّذ الأمر التالي: 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

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

تأكَّد من انتخاب القائد الجديد

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

قائد الترقية

اتّبِع الخطوات نفسها الواردة في ترقية Zookeeper على عُقد المراقبة والنسخ المتماثل أعلاه.

بعد ترقية عقدة القائد القديمة أيضًا، تحقَّق من سلامة المجموعة وتأكَّد من توفّر عقدة قائد.

ترقية Nginx 1.26 في Edge-Router

لا تؤدي الترقية إلى Edge for Private Cloud 4.53.01 من الإصدارات السابقة إلى ترقية برنامج Nginx تلقائيًا إلى أحدث إصدار (1.26.x). يتم ذلك لمنع حدوث أي آثار جانبية غير مقصودة في وقت التشغيل نتيجة للتغييرات الموضّحة في تغييرات Nginx 1.26 في Apigee Edge 4.53.01. يمكنك ترقية Nginx يدويًا من الإصدار 1.20.x إلى الإصدار 1.26.x بعد إثبات الملكية في البيئات الأدنى. لإجراء الترقية يدويًا، اتّبِع الخطوات التالية:

  1. تأكَّد من أنّ عقدة جهاز توجيه الحافة تعمل بأحدث إصدار من البرنامج 4.53.01

    /opt/apigee/apigee-service/bin/apigee-service edge-router version

  2. التحقّق من إصدار Nginx الذي تستخدمه حاليًا

    /opt/nginx/sbin/nginx -V

    إذا كنت تستخدم إصدارًا قديمًا من Nginx، يمكنك اتّباع الخطوات التالية لترقية Nginx إلى الإصدار 1.26.X على عقدة جهاز التوجيه.

  3. إيقاف عملية جهاز التوجيه الطرفي على عقدة جهاز التوجيه

    /opt/apigee/apigee-service/bin/apigee-service edge-router stop

  4. ترقية برنامج nginx على عقدة جهاز التوجيه

    dnf update apigee-nginx

  5. التأكّد من تعديل إصدار Nginx

    /opt/nginx/sbin/nginx -V

  6. بدء عملية جهاز التوجيه على العُقدة

    /opt/apigee/apigee-service/bin/apigee-service edge-router start

  7. كرِّر العملية على كل عقدة جهاز توجيه، واحدة تلو الأخرى.

يجب الترقية إلى Postgres 17

يتضمّن هذا الإصدار من Edge ترقية إلى Postgres 17. وكجزء من عملية الترقية هذه، يتم نقل جميع بيانات Postgres إلى الإصدار 17 من Postgres.

تستخدم معظم أنظمة الإنتاج في Edge عقدتَي Postgres تم ضبطهما لتكرار البيانات من العقدة الرئيسية إلى العقدة الاحتياطية. أثناء عملية التحديث، عندما تكون عُقد Postgres غير متاحة للتحديث، يستمر تسجيل بيانات الإحصاءات في عُقد Qpid. بعد تعديل عُقد Postgres وإعادة اتصالها بالإنترنت، يتم إرسال بيانات الإحصاءات إلى عُقد Postgres.

تعتمد طريقة إجراء عملية تعديل Postgres على كيفية ضبط إعدادات تخزين البيانات لعُقد Postgres:

  • في حال استخدام ميزة "تخزين البيانات محليًا" لعُقد Postgres، عليك تثبيت عقدة احتياطية جديدة من Postgres طوال مدة الترقية. بعد اكتمال الترقية، يمكنك إيقاف عقدة Postgres الاحتياطية الجديدة.

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

    في إعداد Edge بعقدة واحدة وعقدتَين، وهي التصاميم المستخدَمة في إنشاء النماذج الأوّلية والاختبار، لا يتوفّر لديك سوى عقدة Postgres واحدة. يمكنك تعديل عقد Postgres هذه مباشرةً بدون الحاجة إلى إنشاء عقدة Postgres جديدة.

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

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

تثبيت عقدة احتياطية جديدة من Postgres

ينشئ هذا الإجراء خادمًا احتياطيًا لـ Postgres على عقدة جديدة. تأكَّد من تثبيت خادم احتياطي جديد من Postgres لإصدار Edge الحالي (‫4.52.02 أو 4.53.00)، وليس للإصدار 4.53.01.

لتنفيذ عملية التثبيت، استخدِم ملف الإعداد نفسه الذي استخدمته لتثبيت الإصدار الحالي من Edge.

لإنشاء عقدة احتياطية جديدة في Postgres، اتّبِع الخطوات التالية:

  1. في خادم Postgres الرئيسي الحالي، عدِّل الملف /opt/apigee/customer/application/postgresql.properties لضبط الرمز المميز التالي. إذا لم يكن هذا الملف متاحًا، أنشِئه باتّباع الخطوات التالية: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    حيث existing_standby_ip هو عنوان IP لخادم Postgres الاحتياطي الحالي وnew_standby_ip هو عنوان IP لعقدة الخادم الاحتياطي الجديدة.

  2. أعِد تشغيل apigee-postgresql على جهاز Postgres الرئيسي: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. تأكَّد من أنّه تمت إضافة العقدة الاحتياطية الجديدة من خلال عرض الملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على العقدة الرئيسية. من المفترض أن تظهر لك الأسطر التالية في هذا الملف: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. ثبِّت خادم Postgres الاحتياطي الجديد:
    1. عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.

    3. إذا كنت تستخدم حاليًا الإصدار 4.52.02 من 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.51.00.sh
      2. ثبِّت أداة Edge apigee-service والبرامج التابعة: 
        sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

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

      1. نزِّل ملف Edge bootstrap_4.53.00.sh إلى /tmp/bootstrap_4.53.00.sh : 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. ثبِّت أداة Edge apigee-service والبرامج التابعة: 
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    4. استخدِم apigee-service لتثبيت الأداة apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. ثبِّت Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. على عقدة الاستعداد الجديدة، نفِّذ الأمر التالي: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      تأكَّد من أنّها النسخة الاحتياطية.

إجراء ترقية موضعية لـ Postgres

ملاحظة: يجب اتّخاذ الخطوة التمهيدية التالية قبل إجراء ترقية موضعية لـ Postgres.

الخطوة التمهيدية

قبل إجراء ترقية موضعية إلى Postgres، اتّبِع الخطوات التالية على كل من المضيف الرئيسي والمضيف الاحتياطي لتعديل السمة max_locks_per_transaction في apigee-postgresql:

  1. إذا لم يكن الملف موجودًا، أنشِئ الملف /opt/apigee/customer/application/postgresql.properties.
  2. غيِّر ملكية هذا الملف إلى apigee: 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. أضِف السمة التالية إلى الملف: 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. إعداد apigee-postgresql: 
    apigee-service apigee-postgresql configure
  5. إعادة تشغيل apigee-postgresql: 
    apigee-service apigee-postgresql restart

تنفيذ الترقية الموضعية

لإجراء ترقية موضعية إلى Postgres 17، اتّبِع الخطوات التالية:

  1. ترقية postgres على المضيف الرئيسي 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. نفِّذ أمر الإعداد على المضيف الرئيسي: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. نفِّذ أمر الإعداد على المضيف الرئيسي: 
    apigee-service apigee-postgresql configure
  4. أعِد تشغيل الجهاز المضيف الرئيسي: 
    apigee-service apigee-postgresql restart
  5. اضبطه كجهاز رئيسي: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. تأكَّد من أنّ المضيف الرئيسي قد بدأ البث: 
    apigee-service apigee-postgresql wait_for_ready
  7. إيقاف وضع الاستعداد: 
    apigee-service apigee-postgresql stop
  8. ترقية جهاز الاستعداد

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

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. تأكَّد من إيقاف وضع الاستعداد: 
    apigee-service apigee-postgresql stop
  10. إزالة إعدادات وضع الاستعداد القديمة: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. إعداد النسخ المتماثل على الخادم الاحتياطي: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
  12. أزِل السطر conf/postgresql.conf+max_locks_per_transaction=30000 من الملف /opt/apigee/customer/application/postgresql.properties على كل من المضيف الرئيسي والمضيف الاحتياطي. تمت إضافة هذا السطر في الخطوة التمهيدية.

بعد إكمال هذا الإجراء، سيبدأ وضع الاستعداد بنجاح.

إيقاف عقدة Postgres

بعد اكتمال التحديث، أوقِف عقدة الاستعداد الجديدة:

  1. تأكَّد من أنّ Postgres قيد التشغيل: 
    /opt/apigee/apigee-service/bin/apigee-all status

    إذا لم يكن Postgres قيد التشغيل، ابدأ تشغيله: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. احصل على المعرّف الفريد العالمي (UUID) لعقدة الاستعداد الجديدة من خلال تنفيذ أمر curl التالي على عقدة الاستعداد الجديدة: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    من المفترض أن يظهر لك المعرّف الفريد العالمي (UUID) للعقدة في نهاية الناتج، بالشكل التالي: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. أوقِف عقدة الاستعداد الجديدة من خلال تنفيذ الأمر التالي على عقدة الاستعداد الجديدة: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. في عقدة Postgres الرئيسية، عدِّل /opt/apigee/customer/application/postgresql.properties لإزالة عقدة النسخة الاحتياطية الجديدة من conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. أعِد تشغيل apigee-postgresql على خادم Postgres الرئيسي: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. تأكَّد من إزالة العقدة الاحتياطية الجديدة من خلال عرض الملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على العقدة الرئيسية. من المفترض أن يظهر لك السطر التالي فقط في هذا الملف: 
    host replication apigee existing_standby_ip/32 trust
  7. احذف المعرّف الفريد العالمي (UUID) لعقدة الاستعداد من ZooKeeper من خلال إجراء طلب Edge Management API التالي على عقدة Management Server: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

خطوات ما بعد الترقية في Postgres

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

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

لحلّ هذه المشكلة، نفِّذ ANALYZE على جميع الجداول في قاعدة البيانات على عقدة Postgres الرئيسية. بدلاً من ذلك، يمكنك تنفيذ ANALYZE لعدّة جداول في المرة الواحدة.

خطوات تعديل Apigee SSO من الإصدارات القديمة

في Edge for Private Cloud 4.53.01، يتم الآن ضبط مفاتيح وشهادات موفِّر الهوية المستخدَمة في المكوّن apigee-sso من خلال ملف تخزين مفاتيح. عليك تصدير المفتاح والشهادة المستخدَمان سابقًا إلى ملف تخزين مفاتيح، وإعدادهما، ثم المتابعة في تحديث الدخول الموحّد كالمعتاد.

  1. حدِّد المفتاح والشهادة الحاليَّين المستخدَمَين لإعداد موفِّر الهوية:

    1. يمكنك استرداد الشهادة من خلال البحث عن قيمة SSO_SAML_SERVICE_PROVIDER_CERTIFICATE في ملف إعداد تثبيت الدخول المُوحَّد (SSO) أو من خلال طلب البحث من مكوّن apigee-sso عن conf_login_service_provider_certificate.

      استخدِم الأمر التالي على عقدة الدخول المُوحَّد (SSO) لطلب البحث عن مسار شهادة موفِّر الهوية (IDP) في apigee-sso. في النتيجة، ابحث عن القيمة في السطر الأخير. 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. يمكنك استرداد المفتاح من خلال البحث عن قيمة SSO_SAML_SERVICE_PROVIDER_KEY في ملف إعداد تثبيت الدخول المُوحَّد (SSO) أو من خلال طلب البحث من مكوّن apigee-sso عن conf_login_service_provider_key.

      استخدِم الأمر التالي على عقدة الدخول المُوحَّد (SSO) لطلب apigee-sso لمعرفة مسار مفتاح موفِّر الهوية (IDP). في الناتج، ابحث عن القيمة في السطر الأخير.

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. صدِّر المفتاح والشهادة إلى ملف تخزين مفاتيح:
    1. صدِّر المفتاح والشهادة إلى ملف تخزين مفاتيح PKCS12: 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      المَعلمات:

      • certificate_path: مسار ملف الشهادة الذي تم استرداده في الخطوة 1.أ.
      • key_path: مسار ملف المفتاح الخاص الذي تم استرداده في الخطوة 1.ب.
      • keystore_path: مسار ملف تخزين المفاتيح الذي تم إنشاؤه حديثًا والذي يحتوي على الشهادة والمفتاح الخاص
      • alias: الاسم المستعار المستخدَم لمفتاح وشهادة التشفير داخل ملف تخزين المفاتيح

      يُرجى الرجوع إلى مستندات OpenSSL للحصول على مزيد من التفاصيل.

    2. (اختياري) تصدير المفتاح والشهادة من PKCS12 إلى ملف تخزين مفاتيح JKS: 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      المَعلمات:

      • ‫PKCS12_keystore_path: مسار ملف تخزين المفاتيح PKCS12 الذي تم إنشاؤه في الخطوة 2 (أ)، والذي يحتوي على الشهادة والمفتاح
      • destination_keystore_path: مسار ملف تخزين مفاتيح JKS الجديد الذي سيتم تصدير الشهادة والمفتاح إليه
      • ‫alias: الاسم المستعار المستخدَم لمفتاح وشهادة التشفير في مخزن مفاتيح JKS.

      3. لمزيد من التفاصيل، يُرجى الرجوع إلى مستندات keytool.

  3. غيِّر مالك ملف تخزين المفاتيح الناتج إلى المستخدم "apigee": 
    sudo chown apigee:apigee <keystore_file>
  4. أضِف الخصائص التالية في ملف إعداد Apigee SSO وعدِّلها باستخدام مسار ملف تخزين المفاتيح وكلمة المرور ونوع تخزين المفاتيح والاسم المستعار: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. عدِّل برنامج Apigee SSO على عقدة الدخول المُوحَّد (SSO) كالمعتاد باستخدام الأمر التالي: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

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

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

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

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

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

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

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

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

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

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

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

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

تكتب الأداة المساعدة 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 for Private Cloud 4.52.02 أو 4.53.00.

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

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

  1. إذا كانت هذه الوظائف متوفّرة، عليك إيقاف أي وظائف cron تم ضبطها لإجراء عملية إصلاح على Cassandra إلى ما بعد اكتمال التحديث.
  2. سجِّل الدخول إلى العُقدة بصفتك مستخدمًا رئيسيًا لتثبيت حِزم Edge RPM.
  3. أوقِف SELinux على النحو الموضّح في تثبيت أداة Edge apigee-setup.
  4. إذا كنت تثبّت على 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

  5. إذا كنت تستخدم حاليًا الإصدار 4.52.02 أو 4.53.00 من Edge:

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

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

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

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

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

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

للتحديث من مستودع 4.53.01 محلي، اتّبِع الخطوات التالية:

  1. أنشئ مستودعًا محليًا بالإصدار 4.53.01 كما هو موضّح في "إنشاء مستودع Apigee محلي" ضمن تثبيت أداة apigee-setup المساعدة في Edge.
  2. لتثبيت apigee-service من ملف ‎ .tar:
    1. على العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لإنشاء حزمة للمستودع المحلي في ملف tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. انسخ ملف ‎ .tar إلى العُقدة التي تريد تعديل Edge فيها. على سبيل المثال، انسخها إلى الدليل /tmp على العقدة الجديدة.
    3. على العقدة الجديدة، فك ضغط الملف في الدليل /tmp: 
      tar -xzf apigee-4.53.01.tar.gz

      ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف ‎ .tar. على سبيل المثال /tmp/repos.

    4. ثبِّت أداة Edge apigee-service والملفات التابعة من /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. لتثبيت apigee-service باستخدام خادم الويب Nginx، اتّبِع الخطوات التالية:
    1. اضبط إعدادات خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب Nginx" في تثبيت أداة Edge apigee-setup.
    2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.53.01.sh إلى /tmp/bootstrap_4.53.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

      حيث يمثّل uName:pWord اسم المستخدم وكلمة المرور اللذين سبق أن ضبطتهما للمستودع، ويمثّل remoteRepo عنوان IP أو اسم نظام أسماء النطاقات لعقدة المستودع.

    3. على العُقدة البعيدة، ثبِّت أداة Edge apigee-setup والتبعيات: 
      sudo bash /tmp/bootstrap_4.53.01.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.52.02 أو 4.53.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.53.01.

ترتيب تحديث الآلات

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

  • يجب تعديل جميع عُقد LDAP قبل تعديل أي مكونات أخرى. عليك اتّباع خطوات خاصة لترقية LDAP.
  • يجب تعديل جميع عُقد Cassandra وZooKeeper. إذا كنت تريد الترقية من الإصدار 4.52.02، اتّبِع الخطوات الخاصة لترقية Cassandra. عليك اتّباع الخطوات الخاصة لترقية Zookeeper إلى الإصدار 4.52.02 أو 4.53.00.
  • يجب ترقية جميع "خوادم الإدارة" و"أجهزة التوجيه ومعالجة الرسائل" باستخدام الخيار -c edge لتعديلها.
  • يجب ترقية جميع عُقد Postgres باتّباع الخطوات الخاصة بترقية Postgres.
  • يجب تعديل مكوّنَي edge-qpid-server وedge-postgres-server في جميع مراكز البيانات.
  • يجب ترقية جميع عُقد Qpid.
  • يجب ترقية عُقد واجهة مستخدم Edge، بالإضافة إلى ترقية عُقد واجهة مستخدم Edge الجديدة وعُقد تسجيل الدخول المُوحَّد(إذا كان ذلك منطبقًا).
  • ليس هناك خطوة منفصلة لتعديل إعدادات تحقيق الربح. يتم تعديله عند تحديد خيار الحافة -c.

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

لترقية إعداد مستقل بعقدة واحدة إلى الإصدار 4.53.01، اتّبِع الخطوات التالية:

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

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

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

بالنسبة إلى الإعدادات غير العادية

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

  1. LDAP
  2. Cassandra
  3. Zookeeper
  4. خادم الإدارة
  5. معالج الرسائل
  6. جهاز التوجيه
  7. Postgres
  8. Edge، أي الملف الشخصي "-c edge" على جميع العُقد بالترتيب التالي: العُقد التي تتضمّن خادم Qpid، وخادم Edge Postgres.
  9. qpidd
  10. واجهة مستخدم Edge (إما الكلاسيكية أو الجديدة)
  11. apigee-adminapi
  12. Apigee SSO

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