تحديث Apigee Edge 4.16.09 إلى 4.17.05

الإصدار 4.17.05 من Edge for Private Cloud

ما هي إصدارات Edge التي يمكنك تحديثها إلى الإصدار 4.17.05؟

يمكنك تحديث الإصدار 4.16.09.0x من Apigee Edge إلى الإصدار 4.17.05 باستخدام هذا الإجراء.

إذا كان لديك إصدار من Edge أقدم من الإصدار 4.16.01، عليك أولاً نقل البيانات إلى الإصدار 4.16.01.x ثم التحديث إلى الإصدار 4.17.05.

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

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

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

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

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

الترقية المطلوبة إلى Qpid 1.35

يتضمّن هذا الإصدار تحديثًا مطلوبًا لـ Qpid 1.35. كجزء من تحديث عقدة Qpid، عليك:

• يمكنك منع أجهزة التوجيه ومعالِجات الرسائل مؤقتًا من الكتابة في عقدة Qpid من خلال حظر المنفذ 5672 على عقدة Qpid. يمكنك استخدام الأمر التالي لحظر هذا المنفذ على عقدة Qpid:
  > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
• انتظِر حتى تفرغ قائمة انتظار Qpid من الرسائل للتأكّد من أنّ عقدة Qpid قد عالجت جميع الرسائل قبل التحديث. استخدِم الأمر التالي للتأكّد من أنّ قائمة انتظار رسائل Qpid فارغة:
  > qpid-stat -q
• عدِّل عقدة Qpid.
• أزِل حظر المنفذ 5672 على عقدة Qpid للسماح بالوصول من أجهزة التوجيه ومعالجات الرسائل. يمكنك استخدام الأمر التالي لإلغاء حظر هذا المنفذ:
  > sudo iptables -F
  
  يُرجى العِلم أنّه في حال استخدام iptables لقواعد أخرى، يمكنك استخدام الخيار -D لإلغاء التغيير المحدّد:
  > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

يتم شرح هذه العملية بالتفصيل أدناه لكل بنية Edge.

مطلوب لتفعيل مستودع EPEL

يجب تفعيل الحِزم الإضافية لنظام التشغيل Enterprise Linux (أو EPEL) لتثبيت Edge أو تحديثه. يعتمد الأمر الذي تستخدمه على إصدار RedHat/CentOS:

• بالنسبة إلى RedHat/CentOS 7.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
• بالنسبة إلى RedHat/CentOS 6.x:
  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

يجب إضافة مَعلمة الإعداد SMTPMAILFROM

أضاف الإصدار 4.17.05 من Edge مَعلمة جديدة مطلوبة إلى ملف الإعداد المستخدَم عند تفعيل خادم SMTP. يجب الآن ضبط SMTPMAILFROM في ملف الإعداد عند تفعيل خادم SMTP. تتّخذ هذه المَعلمة الشكل التالي:

SMTPMAILFROM="My Company <myco@company.com>"

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

يمكنك دمج خدمة دليل خارجية في تثبيت Apigee Edge Private Cloud الحالي. تم تصميم هذه الميزة للعمل مع أي خدمة دليل متوافقة مع بروتوكول LDAP، مثل Active Directory وOpenLDAP وغيرهما. يتيح حلّ LDAP الخارجي لمشرفي النظام إدارة بيانات اعتماد المستخدمين من خدمة إدارة دليل مركزية، خارج الأنظمة التي تستخدمها مثل Apigee Edge.

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

عند تفعيل المصادقة الخارجية، يستخدم معظم العملاء حقل اسم حساب SAM في Active Directory كاسم مستخدم للمصادقة، بدلاً من عنوان البريد الإلكتروني الذي يستخدمه خادم Edge OpenLDAP.

إذا كنت قد أجريت عملية تكامل مع خدمة دليل خارجية، أضِف السطر التالي إلى ملف الإعداد عند تحديث Edge إلى الإصدار 4.17.05:

IS_EXTERNAL_AUTH="true"

يضبط هذا السطر Edge لإتاحة استخدام اسم حساب، بدلاً من عنوان بريد إلكتروني، كاسم مستخدم.

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

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

المتطلبات الأساسية للتحديث

يُرجى مراعاة المتطلبات الأساسية التالية قبل ترقية Apigee Edge:

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

التعامل مع تحديث تعذّر إجراؤه

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

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

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

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

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

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

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

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

1. في حال توفّر أي مهام CRON تم ضبطها لإجراء عملية إصلاح على Cassandra، عليك إيقافها إلى أن يكتمل التحديث.
2. سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم RPM في Edge.
   ملاحظة: على الرغم من أنّ تثبيت RPM يتطلّب الوصول إلى الجذر، يمكنك ضبط Edge بدون الوصول إلى الجذر.
3. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.
4. نزِّل ملف Edge 4.17.05 bootstrap_4.17.05.sh إلى /tmp/bootstrap_4.17.05.sh:
   > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
5. ثبِّت أداة apigee-service في Edge 4.17.05 والتبعيات:
   > sudo bash /tmp/bootstrap_4.17.05.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 بنفسك.
6. (CentOS-6.x وRedHat-6.x فقط) على جميع عُقد Qpid، نفِّذ الأمر التالي للتأكّد من تنزيل إصدار Qpid الصحيح:
   > yum install apigee-qpidd --disablerepo=epel
7. استخدِم apigee-service لتحديث الأداة المساعدة apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
8. حدِّث الأداة المساعدة apigee-validate على خادم الإدارة:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
9. حدِّث الأداة المساعدة apigee-provision:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
10. شغِّل أداة التحديث المساعدة على العُقد بالترتيب الموضَّح أدناه في "ترتيب تحديث الجهاز" أدناه:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    الشرط الوحيد في ملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول أو القراءة من قِبل مستخدم "apigee".
    
    استخدِم الخيار "‎-c" لتحديد المكوّن المطلوب تحديثه. تتضمّن قائمة المكوّنات المحتملة ما يلي:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres
    ui = واجهة مستخدم Edge
    all = تحديث جميع المكوّنات على الجهاز (يُستخدم فقط لملف تعريف تثبيت Edge aio أو ملف تعريف تثبيت API BaaS asa)
    e = ElasticSearch
    b = حزمة واجهة برمجة التطبيقات BaaS
    p = بوابة واجهة برمجة التطبيقات BaaS
    ebp = ElasticSearch وحزمة واجهة برمجة التطبيقات BaaS وبوابة واجهة برمجة التطبيقات BaaS على العقدة نفسها
11. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.

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

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

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

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

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

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

1. أنشئ مستودعًا محليًا للإصدار 4.17.05 كما هو موضّح في "إنشاء مستودع Apigee محلي" في تثبيت أداة apigee-setup في Edge.
   ملاحظة: إذا كان لديك مستودع 4.16.09 حالي، يمكنك إضافة مستودع 4.17.05 إليه كما هو موضّح في "تحديث مستودع Apigee محلي" في تثبيت أداة إعداد Edge apigee.
2. لتثبيت apigee-service من ملف ‎ .tar:
   1. في العقدة التي تحتوي على المستودع المحلي، استخدِم الأمر التالي لإنشاء حزمة للمستودع المحلي في ملف ‎ .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   2. انسخ ملف ‎ .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى الدليل ‎/tmp على العقدة الجديدة.
   3. في العقدة الجديدة، فُكّ ضغط الملف في الدليل ‎ /tmp:
      > tar -xzf apigee-4.17.05.tar.gz
      
      ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف ‎ .tar. على سبيل المثال، ‎ /tmp/repos.
   4. ثبِّت أداة apigee-service في Edge والتبعيات من /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      يُرجى ملاحظة أنّه عليك تضمين المسار إلى دليل المستودعات في هذا الأمر.
3. لتثبيت apigee-service باستخدام خادم الويب Nginx:
   1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب Nginx" في تثبيت أداة apigee-setup في Edge.
   2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.17.05.sh إلى ‎/tmp/bootstrap_4.17.05.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      
      حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان حدّدتهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة المستودع.
   3. على العقدة البعيدة، ثبِّت أداة apigee-service في Edge والتبعيات:
      > sudo bash /tmp/bootstrap_4.17.05.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. شغِّل أداة التحديث على العُقد بالترتيب الموضَّح أدناه في "ترتيب تحديث الجهاز":
   > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
   
   الشرط الوحيد لملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول أو القراءة من قِبل مستخدم "apigee".
   
   استخدِم الخيار "‎-c" لتحديد المكوّن المطلوب تحديثه. تتضمّن قائمة المكوّنات المحتملة ما يلي:
   ldap = OpenLDAP
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   edge =جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres
   ui = واجهة مستخدم Edge
   all = تحديث جميع المكوّنات على الجهاز (يُستخدم فقط لملف تعريف تثبيت Edge aio أو ملف تعريف تثبيت API BaaS asa)
   e = ElasticSearch
   b = حزمة واجهة برمجة التطبيقات BaaS
   p = بوابة واجهة برمجة التطبيقات BaaS
   ebp = ElasticSearch وحزمة واجهة برمجة التطبيقات BaaS وبوابة واجهة برمجة التطبيقات BaaS على العقدة نفسها
8. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.

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

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

يُعدّ ترتيب تحديث الأجهزة في عملية تثبيت Edge أمرًا مهمًا. وأهم الاعتبارات التي يجب مراعاتها عند إجراء تحديث هي:

• يجب تحديث جميع عُقد Cassandra وZooKeeper قبل تحديث أي عُقد أخرى.
• For any machine with multiple Edge components (Management Server, Message Processor, Router, QPID Server but not Postgres Server), use the "-c edge" option to update them all at the same time.
• إذا كانت إحدى الخطوات تحدّد أنّه يجب تنفيذها على أجهزة متعددة، نفِّذها بالترتيب المحدّد للأجهزة.
• ما مِن خطوة منفصلة لتعديل ميزة تحقيق الربح. ويتم تعديلها عند تحديد الخيار "-c edge".
• (CentOS-6.x وRedHat-6.x فقط) على جميع عُقد Qpid التي تتضمّن اتصالاً خارجيًا بالإنترنت، تأكَّد من تشغيل الأمر التالي لتنزيل إصدار Qpid الصحيح كما هو موضّح أعلاه:
  > yum install apigee-qpidd --disablerepo=epel

للتثبيت المستقل على مضيف واحد

1. اضبط SMTPMAILFROM في ملف الإعداد إذا فعّلت SMTP على Edge. تتخذ هذه المَعلمة الشكل التالي:
   SMTPMAILFROM="My Company <myco@company.com>"
2. حدِّث Cassandra وZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. اضبط قاعدة iptables التالية:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. تحقَّق من قائمة انتظار رسائل Qpid:
   > qpid-stat -q
   
   واصِل التحقُّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg"‏ 0. لا يمكنك ترقية Qpid إلى أن تتم معالجة جميع الرسائل.
5. حدِّث qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. مسح iptables:
   > sudo iptables -F
7. تعديل postgresql:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. ابدأ postgresql:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. تعديل LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. حدِّث مكوّنات Edge المتبقية:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. تحديث واجهة مستخدم Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

للتثبيت المستقل على مضيفَين

يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

1. اضبط SMTPMAILFROM في ملف الإعداد إذا فعّلت SMTP على Edge. تتخذ هذه المَعلمة الشكل التالي:
   SMTPMAILFROM="My Company <myco@company.com>"
2. حدِّث Cassandra وZooKeeper على الجهاز 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. اضبط قاعدة iptables التالية على الجهاز 2:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 2:
   > qpid-stat -q
   
   واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg" هو 0. لا يمكنك ترقية Qpid إلى أن تتم معالجة جميع الرسائل.
5. تحديث qpidd على الجهاز 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. امسح iptables على الجهاز 2:
   > sudo iptables -F
7. حدِّث postgresql على الجهاز 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. ابدأ postgresql على الجهاز 2:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. حدِّث LDAP على الجهاز 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. حدِّث مكوّنات Edge على الجهازَين 2 و1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. تحديث واجهة المستخدم على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

للتثبيت في مجموعة من 5 مضيفين

يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

1. اضبط SMTPMAILFROM في ملف الإعداد إذا فعّلت SMTP على Edge. تتخذ هذه المَعلمة الشكل التالي:
   SMTPMAILFROM="My Company <myco@company.com>"
2. حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. اضبط قاعدة iptables التالية على الجهاز 4:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 4:
   > qpid-stat -q
   
   واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg"‏ 0. لا يمكنك ترقية Qpid إلى أن تتم معالجة جميع الرسائل.
5. حدِّث qpidd على الجهاز 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. محو iptables على الجهاز 4:
   > sudo iptables -F
7. كرِّر الخطوات من 3 إلى 6 على الجهاز 5.
8. تحديث postgresql على الجهاز 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. ابدأ postgresql على الجهاز 4:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. كرِّر الخطوتَين 8 و9 على الجهاز 5.
11. حدِّث LDAP على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. حدِّث مكوّنات Edge على الأجهزة 4 و5 و1 و2 و3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. تحديث واجهة المستخدم على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

للتثبيت في مجموعة من 9 مضيفين

يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

1. اضبط SMTPMAILFROM في ملف الإعداد إذا فعّلت SMTP على Edge. تتخذ هذه المَعلمة الشكل التالي:
   SMTPMAILFROM="My Company <myco@company.com>"
2. حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. اضبط قاعدة iptables التالية على الجهاز 6:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 6:
   > qpid-stat -q
   
   واصِل التحقُّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg"‏ 0. لا يمكنك ترقية Qpid إلى أن تتم معالجة جميع الرسائل.
5. تحديث qpidd على الجهاز 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. إزالة iptables على الجهاز 6:
   > sudo iptables -F
7. كرِّر الخطوات من 3 إلى 6 على الجهاز 7.
8. حدِّث postgresql على الجهاز 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. ابدأ postgresql على الجهاز 6:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. كرِّر الخطوتَين 8 و9 على الجهاز 7.
11. حدِّث LDAP على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. حدِّث مكوّنات Edge على الأجهزة 6 و7 و8 و9 و1 و4 و5 بهذا الترتيب:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. تحديث واجهة المستخدم على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

للتثبيت في مجموعة من 13 مضيفًا

يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

1. اضبط SMTPMAILFROM في ملف الإعداد إذا فعّلت SMTP على Edge. تتخذ هذه المَعلمة الشكل التالي:
   SMTPMAILFROM="My Company <myco@company.com>"
2. حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. اضبط قاعدة iptables التالية على الجهاز 12:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 12:
   > qpid-stat -q
   
   واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg"‏ 0. لا يمكنك ترقية Qpid إلى أن تتم معالجة جميع الرسائل.
5. تحديث qpidd على الجهاز 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. مسح iptables على الجهاز 12:
   > sudo iptables -F
7. كرِّر الخطوات من 3 إلى 6 على الجهاز 13.
8. حدِّث postgresql على الجهاز 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. ابدأ postgresql على الجهاز 12:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. كرِّر الخطوتَين 8 و9 على الجهاز 13.
11. حدِّث LDAP على الجهازَين 4 و5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. حدِّث مكوّنات Edge على الأجهزة 12 و13 و8 و9 و6 و7 و10 و11 بهذا الترتيب:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. تحديث واجهة المستخدم على الجهازَين 6 و7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

للتثبيت في مجموعة من 12 مضيفًا

يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

1. اضبط SMTPMAILFROM في ملف الإعداد إذا فعّلت SMTP على Edge. تتخذ هذه المَعلمة الشكل التالي:
   SMTPMAILFROM="My Company <myco@company.com>"
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. تعديل qpidd:
   1. الجهازان 4 و5 في مركز البيانات 1
      1. اضبط قاعدة iptables التالية على الجهاز 4:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 4:
         > qpid-stat -q
         
         واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg"‏ 0. لا يمكنك ترقية Qpid حتى تتم معالجة جميع الرسائل.
      3. تحديث qpidd على الجهاز 4:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. محو iptables على الجهاز 4:
         > sudo iptables -F
      5. كرِّر الخطوات من 1 إلى 4 على الجهاز 5.
   2. الجهازان 10 و11 في مركز البيانات 2
      1. اضبط قاعدة iptables التالية على الجهاز 10:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 10:
         > qpid-stat -q
         
         واصِل التحقُّق من قائمة الانتظار حتى يصبح العدد في عمود "msg" هو 0. لا يمكنك ترقية Qpid حتى تتم معالجة جميع الرسائل.
      3. حدِّث qpidd على الجهاز 10:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. إزالة iptables على الجهاز 10:
         > sudo iptables -F
      5. كرِّر الخطوات من 1 إلى 4 على الجهاز 11.
4. تعديل postgresql:
   1. الجهاز 6 في مركز البيانات 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
   2. الأجهزة 12 في مركز البيانات 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. تعديل 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
6. تحديث مكوّنات 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
7. تعديل واجهة المستخدم:
   1. الجهاز 1 في مركز البيانات 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. الجهاز 7 في مركز البيانات 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

بالنسبة إلى تثبيت واجهة برمجة تطبيقات BaaS على 7 مضيفين

يجب إضافة موقعَين جديدَين إلى ملف الإعداد قبل تنفيذ إجراء الترقية:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

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

يجب أيضًا التأكّد من أنّ المنفذ 2551 مفتوح على جميع عُقد Stack للوصول من جميع عُقد Stack الأخرى.

يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

1. حدِّث Cassandra على الأجهزة 5 و6 و7:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

2. حدِّث ElasticSearch وAPI BaaS Stack على الأجهزة 1 و2 و3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

3. تحديث بوابة API BaaS على الجهاز 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

بالنسبة إلى تثبيت واجهة برمجة تطبيقات BaaS على 10 مضيفين

يجب إضافة موقعَين جديدَين إلى ملف الإعداد قبل تنفيذ إجراء الترقية:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

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

يجب أيضًا التأكّد من أنّ المنفذ 2551 مفتوح على جميع عُقد Stack للوصول من جميع عُقد Stack الأخرى.

يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

1. حدِّث Cassandra على الأجهزة 8 و9 و10:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
2. حدِّث ElasticSearch على الأجهزة 1 و2 و3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
3. تحديث حزمة API BaaS على الأجهزة 4 و5 و6:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
4. تحديث بوابة API BaaS على الجهاز 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

للتثبيت غير العادي

إذا كان لديك تثبيت غير عادي، يُرجى تحديث مكوّنات Edge بالترتيب التالي:

1. ZooKeeper
2. Cassandra
3. qpidd, ps
4. LDAP
5. Edge، أي الملف الشخصي "-c edge" على جميع العُقد بالترتيب: العُقد التي تتضمّن خادم Qpid وخادم Postgres وخادم الإدارة ومعالج الرسائل وجهاز التوجيه.
   ملاحظة: إذا كانت العقدة تحتوي على خادم Qpid وخادم Postgres، نفِّذ خطوة الملف الشخصي "-c edge".
6. Edge UI