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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

أثناء عملية التحديث، قد يحدث تأخير مؤقت أو تعذّر الكتابة في Zookeeper عند إيقاف تشغيل العقدة الرئيسية. قد يؤثر ذلك في عمليات الإدارة التي تُجري عمليات كتابة في Zookeeper، مثل عملية نشر الخادم الوكيل وتغييرات بنية Apigee الأساسية، مثل إضافة أو إزالة معالِج الرسائل وما إلى ذلك. من المفترض ألا يكون هناك أي تأثير على IDE واجهات برمجة التطبيقات الخاصة Apigee (ما لم تطلب IDE واجهات برمجة تطبيقات الإدارة) أثناء ترقية 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.3-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 من إخراج العقد، من المفترض أن يظهر لك "مراقب" أو "قائد" أو "مُتّبع" (أي مُنتخب ليس القائد) استنادًا إلى إعدادات العقدة. ملاحظة: في عملية تثبيت مستقلة لـ Edge باستخدام عقدة ZooKeeper واحدة، يتم ضبط Mode على "مستقل".

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

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

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

  1. نزِّل وشغِّل أداة Bootstrap لإصدار Edge for Private Cloud 4.52، كما هو موضّح في مقالة التحديث إلى الإصدار 4.52.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 على عقدتَي المراقب والمتابع أعلاه.

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

التراجع

في حال الحاجة إلى التراجع:

  1. نفِّذ خطوات التراجع في ما يتعلّق بالمراقبين والمتابعين أولاً.
  2. نزِّل ونفِّذ ملف التمهيد للإصدار الذي تريد الرجوع إليه، سواء كان 4.50 أو 4.51. من المحتمل أن تختلف العملية حسب ما إذا كانت العقدة متصلة بالإنترنت خارجيًا أو كنت تتبع عملية التثبيت بلا إنترنت.
  3. أوقِف Zookeeper إذا كان قيد التشغيل على العقدة: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. ألغِ تثبيت zookeeper الحالي: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. ثبِّت Zookeeper كالمعتاد: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. بعد التراجع عن جميع عمليات الربط بالتابعين والمراقبين، يمكنك التراجع عن عملية الربط بوحدة القيادة باتّباع الخطوات من 2 إلى 5 في وحدة القيادة.
  7. بعد التراجع عن جميع العقد، تحقَّق من حالة المجموعة وتأكَّد من توفُّر عقدة رئيسية في المجموعة.

استعادة النسخة الاحتياطية

راجِع مقالة استعادة البيانات من نسخة احتياطية. يُرجى العلم أنّ النُسخ الاحتياطية من Zookeeper التي تم الحصول عليها من الإصدارات السابقة من Edge for Private Cloud، مثل 4.50 و4.51، يجب أن تكون متوافقة مع إصدار Zookeeper في Edge for Private Cloud 4.52.

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

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

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

ترقية Qpid

يتضمّن إصدار Edge for Private Cloud هذا ترقية إلى Qpid J-Broker.

ننصحك باختيار إحدى الطريقتَين التاليتَين لإجراء ترقية Qpid:

الترقية على الموقع بدون أي وقت توقف

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

لتنفيذ ترقية بدون إيقاف الخدمة إلى Qpid:

  1. اختَر عقدة Qpid واحدة للبدء.
  2. أوقِف وكيل Qpid على العقدة: 
    apigee-service apigee-qpidd stop
  3. يمكنك حظر حركة البيانات الواردة على منفذ الوسيط 5672 من جميع معالجات الرسائل من خلال تطبيق جدار حماية. يمكنك تطبيق جدار الحماية هذا على مستوى مثيل عقدة Qpid أو أي عنصر آخر لجدار الحماية/الشبكة الخارجي.

    ننصحك بتنفيذ الخطوة نفسها لجميع عناوين IP لمعالج الرسائل. على سبيل المثال، لإسقاط الطلبات الواردة من عناوين IP لمعالج الرسائل إلى عقدة Qpid على المنفذ 5672 باستخدام IPTables، يمكنك استخدام أمر مثل هذا:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. ابدأ وكيل Qpid مرة أخرى لتفريغ الرسائل الحالية، إن توفّرت: 
    apigee-service apigee-qpidd start
  5. تأكَّد من أنّ قوائم الانتظار الحالية فارغة: 
    qpid-stat -q

    إذا كانت الرسائل عالقة في قائمة الرسائل غير القابلة للتسليم (DLQ) (ax-q-axgroup-001-consumer-group-001-dl)، عليك إفراغ القائمة باستخدام الخطوات لحلّ مشكلة بيانات الإحصاءات العالقة في قائمة الرسائل غير القابلة للتسليم.

  6. بعد التأكّد من تفريغ الطوابير على العقدة القديمة، أوقِف apigee-qpidd: 
    apigee-service apigee-qpidd stop
  7. ترقية Qpid على العقدة: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. إعادة تشغيل edge-qpid-server: 
    apigee-service edge-qpid-server restart

  9. أزِل قاعدة جدار الحماية التي تم تطبيقها في الخطوة 3.

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

    iptables -F
  iptables -L
  10. استخدِم ميزة "مراقبة الويب" للتأكّد من أنّ قوائم انتظار Qpid تتلقّى الرسائل: 
    http://QPID_NODE_IP:8090
  11. كرِّر الخطوات من 1 إلى 9 لكل عقدة Qpid.

تفعيل عقدة Qpid جديدة

تعمل هذه الطريقة على إعداد apigee-qpidd وedge-qpid-server وتثبيتهما على عقدة جديدة.

  1. أضِف عقدة Qpid جديدة. تعمل هذه الخطوة على إعداد عقدة Qpid باستخدام J-broker. للاطّلاع على الخطوات التفصيلية، راجِع مقالة إضافة خادم Qpid.
  2. اختَر عقدة Qpid حالية (عقدة من الإصدار الذي يتم الترقية منه).
  3. أوقِف وكيل Qpid على العقدة: 
    apigee-service apigee-qpidd stop
  4. يمكنك حظر حركة البيانات الواردة على منفذ الوسيط 5672 من جميع معالجات الرسائل من خلال تطبيق جدار حماية. يمكنك تطبيق جدار الحماية هذا على مستوى مثيل عقدة Qpid أو أي عنصر آخر لجدار الحماية/الشبكة الخارجي.

    ننصحك بتنفيذ الخطوة نفسها لجميع عناوين IP لمعالج الرسائل. على سبيل المثال، لإسقاط الطلبات الواردة من عناوين IP لمعالج الرسائل إلى عقدة Qpid على المنفذ 5672 باستخدام IPTables، يمكنك استخدام أمر مثل هذا:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. ابدأ وكيل Qpid مرة أخرى لتفريغ الرسائل الحالية، إن توفّرت: 
    apigee-service apigee-qpidd start
  6. تأكَّد من أنّ قوائم الانتظار الحالية فارغة: 
    qpid-stat -q

    إذا كانت الرسائل عالقة في "قائمة الرسائل غير القابلة للتسليم" (DLQ)‏ (ax-q-axgroup-001-consumer-group-001-dl)، عليك تفريغ القائمة باتّباع الخطوات الواردة في موضوع تحديد المشاكل وحلّها بيانات "إحصاءات Google" عالقة في قائمة الرسائل غير القابلة للتسليم في Qpidd.

  7. بعد التأكّد من تفريغ قوائم الانتظار على العقدة القديمة، أوقِف apigee-qpidd 
    apigee-service apigee-qpidd stop
  8. ألغِ تسجيل عقدة Qpid القديمة باتّباع الخطوات الواردة في مقالة إزالة خادم Qpid.
  9. واصِل إضافة عقدة جديدة وإزالة عقدة قديمة واحدة تلو الأخرى إلى أن تتم ترقية جميع عقد Qpid.

التراجع

للرجوع إلى إصدار سابق من الإصدارات التجريبية، احرص على تنزيل ملف bootstrap.sh ل الإصدار الذي تريد الرجوع إليه. للرجوع إلى الإصدار 4.52.00، نزِّل bootstrap_4.52.00.sh.

لإلغاء التغييرات التي تم إجراؤها على Qpid، اتّبِع الخطوات التالية على جميع مضيفي Qpid:

  1. أوقِف وكيل Qpid الحالي. 
    apigee-service apigee-qpidd stop
  2. حظر حركة البيانات الواردة على منفذ الوسيط 5672 من جميع معالجات الرسائل من خلال تطبيق جدار حماية يمكنك تطبيق جدار الحماية هذا على مستوى مثيل عقدة Qpid أو أي عنصر آخر لجدار الحماية/الشبكة الخارجي.

    ننصحك بتنفيذ الخطوة نفسها لجميع عناوين IP لمعالج الرسائل. على سبيل المثال، لإسقاط الطلبات الواردة من عناوين IP لمعالج الرسائل إلى عقدة Qpid على المنفذ 5672 باستخدام IPTables، يمكنك استخدام أمر مثل هذا:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. ابدأ وكيل qpid مرة أخرى لتفريغ الرسائل الحالية إن توفّرت: 
    apigee-service apigee-qpidd start
  4. تأكَّد من أنّ قوائم الانتظار الحالية فارغة. للتحقّق من ذلك، يُرجى تسجيل الدخول إلى بوابة إدارة Qpid: 
    http://QPID_NODE_IP:8090
     ملاحظة: في حال تعذّر الوصول إلى المنفذ 8090 على عقدة QPID، يمكنك استخدام آليات بديلة مثل إعادة توجيه منفذ SSH للوصول إلى عنوان URL هذا.
  5. بعد التأكّد من تفريغ الطوابير، أوقِف Qpid وألغِ تثبيته: 
    apigee-service apigee-apidd uninstall
  6. حذف دليل بيانات Qpid: 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. أعِد تثبيت وكيل Qpid: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. بعد إعادة تثبيت وسيط Qpid، عليك إزالة إعدادات جدار الحماية وعرض أي إعدادات حالية باستخدام الأوامر التالية: 
    iptables -F
     
    iptables -L

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

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

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

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

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

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

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

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

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

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

التراجع عن تحديث

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

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

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

تُسجِّل الأداة المساعدة update.sh معلومات السجلّ تلقائيًا في:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    1. نزِّل ملف bootstrap_4.52.01.sh في Edge إلى /tmp/bootstrap_4.52.01.sh: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. ثبِّت أداة apigee-service Edge 4.52.01 والموارد الاعتمادية من خلال تنفيذ الأمر التالي: 
      sudo bash /tmp/bootstrap_4.52.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 (في حال تثبيت الدخول المُوحَّد)
        • ue: واجهة مستخدم Edge الجديدة
        • ui: واجهة مستخدم Edge الكلاسيكية
        • zk: حارس حديقة الحيوانات
      • configFile هو ملف الإعداد نفسه الذي استخدمته ل تحديد مكونات Edge أثناء تثبيت الإصدار 4.50.00 أو 4.51.00.

      يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت لجهاز Edge الكل في واحد. على سبيل المثال:

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

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

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

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

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

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

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

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

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

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

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

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

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

    3. في العقدة البعيدة، ثبِّت أداة apigee-setup وتبعياتها في Edge: 
      sudo bash /tmp/bootstrap_4.52.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 (في حال تثبيت الدخول المُوحَّد)
      • ue واجهة مستخدم Edge الجديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: حارس حديقة الحيوانات
    • configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكوّنات Edge أثناء تثبيت الإصدار 4.50.00 أو 4.51.00.

    يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت لجهاز Edge الكل في واحد. على سبيل المثال:

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

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

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

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

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

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

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

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

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

ترقية 5 عقد

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

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

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

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

  11. إعادة تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر edge-ui على الجهاز 1، كما هو موضّح في المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • واجهة مستخدم Edge الجديدة: إذا ثبّتْت واجهة مستخدم Edge الجديدة، أعِد تشغيل العنصر edge-management-ui على الجهاز المناسب (قد لا يكون الجهاز 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

ترقية مجموعة تتألف من 9 عقد

عدِّل المكوّنات التالية لتركيب مجموعات من 9 عقد:

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

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

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

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

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

  10. إعادة تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل العنصر 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. تحديث 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
  2. تعديل 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
  3. تعديل 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
  4. تعديل مكوّنات Edge:
    1. الأجهزة 4 و5 و6 و1 و2 و3 في مركز البيانات 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. الأجهزة 10 و11 و12 و7 و8 و9 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. تعديل 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
  6. تعديل واجهة المستخدم الجديدة (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
  7. (في حال تثبيت 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
  8. (في حال تثبيت 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 هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).

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

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

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

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

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