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

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

الأشخاص الذين يمكنهم إجراء التحديث

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

بعد تثبيت Edge RPMs، يمكن لأي مستخدم ضبطه.

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

يجب تحديث جميع مكونات 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 Cloudes ترقية إلى Zookeeper 3.8.3. وكجزء من هذه الترقية، سيتم نقل كل بيانات Zookeeper إلى إصدار Zookeeper 3.8.3.

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

أثناء عملية التحديث، قد يحدث تأخير مؤقت أو تعذُّر الكتابة في Zookeeper عندما يتم إيقاف عقدة البداية. قد يؤثر ذلك في عمليات الإدارة التي تتم في Zookeeper، مثل عملية نشر خادم وكيل، وتغييرات البنية الأساسية لـ Apigee، مثل إضافة معالج رسائل أو إزالته، وما إلى ذلك. من المفترض ألا يكون هناك أي تأثير على واجهات برمجة تطبيقات Apigee أثناء التشغيل (ما لم تكن واجهات برمجة التطبيقات لإدارة الطلبات API في وقت التشغيل) أثناء ترقية 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. عليك تنزيل إصدار تمهيد Edge من برنامج 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 profile) أو يمكنك ترقية المكوّنات الأخرى لاحقًا. تنصح 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 لخدمة Private Cloud مثل 4.50 و4.51 يجب أن تكون متوافقة مع إصدار Zookeeper في Edge الخاص بخدمة Private Cloud 4.52.

ترقية Qpid

يتضمن إصدار Edge for Private Cloud هذا ترقية إلى Qpid J-Broker. نقترح عليك اختيار إحدى الطرق التالية لإجراء ترقية Qpid:

• الترقية داخل المتجر بدون أي فترات استراحة
• تنفيذ عقدة Qpid جديدة

ترقية التطبيق داخل المتجر بدون أي فترات استراحة

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

لإجراء عملية في التطبيق، لا يمكن ترقية وقت الاستراحة إلى Qpid:

1. اختر عقدة Qpid واحدة لتبدأ بها.
2. أوقِف وسيط Qpid في العقدة:

   apigee-service apigee-qpidd stop

3. احظر حركة الزيارات الواردة عبر منفذ الوسيط رقم 5672 من جميع معالجات الرسائل من خلال تطبيق جدار حماية. يمكنك تطبيق جدار الحماية هذا على مستوى مثيل عقدة Qpid أو بعض المكونات الخارجية الأخرى لجدار الحماية/الشبكة.

   ننصحك بتنفيذ الخطوة نفسها لجميع عناوين IP لمعالج الرسائل. على سبيل المثال، لمعالجة طلبات DROP الواردة من عناوين 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 لمعالج الرسائل. على سبيل المثال، لمعالجة طلبات DROP الواردة من عناوين 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 لمعالج الرسائل. على سبيل المثال، لمعالجة طلبات DROP الواردة من عناوين 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 تتطلب إيقاف المصادقة الأساسية واستخدام موفِّر الهوية مثل SAML أو LDAP.

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

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

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

• من 4.51.00 إلى 4.52.00 (بعد تثبيت واجهة مستخدم Edge الجديدة): استخدِم تعليمات الترقية الواردة في هذا القسم للمكوِّن edge-management-ui.

التعديل باستخدام Apigee mTLS

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

• ألغِ تثبيت Apigee mTLS.
• أعِد تثبيت Apigee mTLS.

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

وفي حال تعذُّر التحديث، يمكنك محاولة تصحيح المشكلة، ثم تنفيذ update.sh مرة أخرى. يمكنك تشغيل التحديث عدة مرات ومتابعة التحديث من النقطة التي توقفت عندها.

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

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

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

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

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

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

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

يتيح لك تحديث "وقت الاستراحة" أو "التحديث الدوري" تحديث تثبيت Edge بدون إزالة Edge.

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

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

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

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

• في عُقدة "جهاز التوجيه" و"معالج الرسائل" المدمجة:
  • قبل التحديث، نفِّذ ما يلي:
    1. تعذر الوصول إلى جهاز التوجيه.
    2. تسبب في عدم إمكانية الوصول إلى معالج الرسائل.
  • بعد التحديث، يمكنك تنفيذ ما يلي:
    1. إتاحة الوصول إلى معالج الرسائل
    2. إتاحة الوصول إلى جهاز التوجيه
• في عُقد جهاز التوجيه الفردية:
  • قبل التحديث، اجعل جهاز التوجيه غير قابل للوصول.
  • بعد التحديث، اجعل جهاز التوجيه قابلاً للوصول إليه.
• في عُقد معالج الرسائل الفردية:
  • قبل التحديث، احظر الوصول إلى معالج الرسائل.
  • بعد التحديث، اجعل "معالج الرسائل" متاحًا للتواصل.

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

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

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

استخدم الإجراء التالي لتحديث مكونات Edge على أي عقدة:

1. وفي حال توفُّرها، أوقِف أي مهام cron تم ضبطها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
2. سجِّل الدخول إلى العُقدة كجذر لتثبيت Edge RPMs.
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. قم بتثبيت الأداة المساعدة Edge 4.52.01 apigee-service والتبعيات الخاصة بها عن طريق تنفيذ الأمر التالي:

      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: كاساندرا
        • edge: جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة، ومعالج الرسائل، وجهاز التوجيه، وخادم QPID، وخادم Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: خدمة Apigee المُوحَّد (SSO) (في حال تثبيت خدمة الدخول المُوحَّد (SSO))
        • ue: واجهة مستخدم Edge الجديدة
        • ui: واجهة مستخدم Classic Edge
        • zk: Zookeeper
      • 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-ui restart

   8. اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم الإدارة"، كما هو موضّح في القسم اختبار التثبيت.

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

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

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

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

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

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

1. أنشئ مستودعًا محليًا للإصدار 4.52.01 كما هو موضَّح في قسم "إنشاء مستودع Apigee محلي" في تثبيت أداة إعداد apigee المساعدة في Edge.
2. لتثبيت apigee-service من ملف .tar:
   1. في العقدة التي تتضمّن repo المحلي، استخدِم الأمر التالي لتجميع repo المحلي في ملف .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

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

3. لتثبيت خدمة apigee باستخدام خادم الويب Nginx:
   1. اضبط خادم الويب Nginx كما هو موضَّح في "التثبيت من repo باستخدام خادم الويب Nginx" في تثبيت الأداة المساعدة لإعداد apigee في Edge.
   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 هو اسم المستخدم وكلمة المرور اللذان ضبطتهما سابقًا في repo، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة repo.

   3. في العقدة البعيدة، ثبِّت أداة apigee-setup Edge والتبعيات:

      sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور الخاصَّين بـ Repo.

4. استخدِم apigee-service لتحديث الأداة apigee-setup، كما يوضِّح المثال التالي:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. يمكنك تحديث الأداة apigee-validate في "خادم الإدارة"، كما يوضِّح المثال التالي:

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. يمكنك تحديث الأداة apigee-provision في "خادم الإدارة"، كما يوضِّح المثال التالي:

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. شغِّل الأداة update على العُقد بالترتيب الموضّح في طلب تحديث الجهاز:

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

   المكان:

   • component هو مكوّن Edge المطلوب تحديثه. يمكنك عادةً تعديل المكوّنات التالية:
     • cs: كاساندرا
     • edge: جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة، ومعالج الرسائل، وجهاز التوجيه، وخادم QPID، وخادم Postgres
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: خدمة Apigee المُوحَّد (SSO) (في حال تثبيت خدمة الدخول المُوحَّد (SSO))
     • ue واجهة مستخدم Edge الجديدة
     • ui: واجهة مستخدم Classic Edge
     • zk: Zookeeper
   • 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. يجب تحديث "كاساندرا" و"حديقة الحيوانات" على الجهاز 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. (في حال تثبيت ApigeeSSO)، يجب تعديل الدخول المُوحَّد (SSO) لتطبيق Apigee على الجهاز 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. يجب تحديث "كاساندرا" و"حديقة الحيوانات" على الجهاز 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. (في حال تثبيت ApigeeSSO)، يجب تعديل الدخول المُوحَّد (SSO) لتطبيق Apigee على الجهاز 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. يجب تحديث "كاساندرا" و"حديقة الحيوانات" على الجهاز 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. (في حال تثبيت ApigeeSSO)، يجب تعديل الدخول المُوحَّد (SSO) لتطبيق Apigee على الجهاز 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. يجب تحديث "كاساندرا" و"زول كيوبر" على الأجهزة 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)) على الجهازَين 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. (في حال تثبيت خدمة ApigeeSSO)، يُرجى تعديل خدمة الدخول المُوحَّد (SSO) إلى Apigee:
   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

   حيث يكون 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. ويشير إلى الملف الشخصي " -c Edge" على جميع العُقد بالترتيب: العُقد التي تتضمّن خادم Qpid وخادم Edge Postgres وخادم الإدارة و"معالج الرسائل" و"جهاز التوجيه".
6. qpidd
7. واجهة مستخدم Edge (إما كلاسيكية أو جديدة)
8. apigee-adminapi
9. الدخول المُوحَّد (SSO) إلى Apigee

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