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

Edge for Private Cloud‏ 4.17.09

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

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

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

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

يجب أن يكون المستخدم الذي ينفِّذ التحديث هو نفسه المستخدم الذي ثبَّت 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/Oracle 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/Oracle 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. إذا كنت بصدد التحديث من الإصدار 4.17.01، عليك ضبط SMTPMAILFROM في ملف الإعدادات عند تفعيل خادم SMTP.

أضاف الإصدار 4.17.09 من واجهة برمجة التطبيقات BaaS أيضًا إمكانية استخدام السمة SMTPMAILFROM. عند تحديث BaaS لواجهة برمجة التطبيقات، يجب ضبط SMTPmailFROM في ملف الإعداد.

يكون شكل هذه المَعلمة على النحو التالي:

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

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

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

اطّلِع على إعداد مصادقة خارجية لمعرفة المزيد.

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

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

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.09 لمعرفة المزيد من المعلومات.

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

تُسجِّل الأداة 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.09 على عقدة متصلة بالإنترنت الخارجي

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

1. أوقِف أي مهام CRON تم إعدادها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
   ملاحظة: على الرغم من أنّ تثبيت RPM يتطلب الوصول إلى الجذر، يمكنك تنفيذ إعدادات Edge بدون الوصول إلى الجذر.
3. ثبِّت yum-utils و yum-plugin-priorities:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
4. أوقِف SELinux كما هو موضّح في مقالة تثبيت أداة apigee-setup في Edge.
5. فعِّل مستودع EPEL كما هو موضّح أعلاه.
6. في حال التثبيت على AWS، شغِّل الأمر yum-configure-manager التالي:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
7. نزِّل ملف bootstrap_4.17.09.sh الخاص بإصدار Edge 4.17.09 إلى ‎/tmp/bootstrap_4.17.09.sh:
   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
8. ثبِّت أداة apigee-service و ملحقاتها في Edge 4.17.09:
   > sudo bash /tmp/bootstrap_4.17.09.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 بنفسك.
9. استخدِم apigee-service/bin/apigee-service apigee-setup:
   
10. عدِّل الأداة apigee-validate على خادم الإدارة:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
11. عدِّل الأداة apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
12. شغِّل أداة التحديث على العقد بالترتيب الموضّح أدناه في "ترتيب تعديل الأجهزة" أدناه:
    > ‎/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 = حِزمة API BaaS
    p = بوابة API BaaS
    ebp = ElasticSearch وحِزمة API BaaS وبوابة API BaaS على العقدة نفسها
13. اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم الإدارة"، كما هو описан في اختبار عملية التثبيت.

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

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

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

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

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

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

1. أنشئ مستودعًا محليًا من الإصدار 4.17.09 كما هو موضّح في مقالة "إنشاء مستودع Apigee محلي" على الرابط تثبيت أداة Edge apigee-setup.
   ملاحظة: إذا كان لديك مستودع حالي من الإصدار 4.16.09، يمكنك إضافة مستودع الإصدار 4.17.09 إليه كما هو موضّح في "تعديل مستودع Apigee على الجهاز" في تثبيت أداة إعداد Edge apigee.
2. لتثبيت apigee-service من ملف ‎ .tar:
   1. في العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لتجميع المستودع المحلي في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-4.17.09.tar.gz:
      
   2. انسخ ملف ‎.tar إلى العقدة التي تريد تحديث Edge عليها. على سبيل المثال، يمكنك نسخه إلى الدليل /tmp على العقدة الجديدة.
   3. في العقدة الجديدة، فكِّ ضغط الملف إلى الدليل ‎ /tmp:
      > tar -xzf apigee-4.17.09.tar.gz
      
      ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف tar. على سبيل المثال، /tmp/repos.
   4. ثبِّت أداة apigee-service ومستلزماتها في Edge من ‎ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      يُرجى ملاحظة أنّك تُدرِج مسار دليل repos في هذا الأمر.
3. لتثبيت apigee-service باستخدام خادم الويب Nginx:
   1. اضبط خادم الويب Nginx كما هو موضّح في قسم "التثبيت من المستودع باستخدام خادم الويب Nginx" في مقالة تثبيت أداة Edge apigee-setup.
   2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.17.09.sh إلى ‎/tmp/bootstrap_4.17.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
      
      حيث يكون uName:pWord هما اسم المستخدم وكلمة المرور اللذان ضبطتهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لشدَّة العقدة المستودع.
   3. على العقدة البعيدة، ثبِّت الأداة Edge apigee-service والتبعيات:
      > sudo bash /tmp/bootstrap_4.17.09.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. عدِّل أداة التحقق من صحة واجهة برمجة التطبيقات API في "خادم الإدارة".
   > ‎/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
   
   الشرط الوحيد لملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول إليه أو مقروءًا من قِبل مستخدم "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 = حِزمة API BaaS
   p = بوابة API BaaS
   ebp = ElasticSearch وحِزمة API BaaS وبوابة API BaaS على العقدة نفسها
8. اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم الإدارة"، كما هو описан في اختبار عملية التثبيت.

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

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

من المهم ترتيب تحديث الأجهزة في عملية تثبيت Edge. في ما يلي أهم النقاط التي يجب أخذها في الاعتبار عند إجراء تحديث:

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

في ما يتعلّق بالتركيب المستقل على مضيف واحد

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
   
   واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "الرسالة" 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
   
   واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "الرسالة" 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="شركتي <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="شركتي <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
         
         واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "الرسالة" 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

لتركيب 7 مضيفين لخدمات BaaS لواجهة برمجة التطبيقات

# 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"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

للحصول على مثال كامل لملف الإعدادات، يُرجى الاطّلاع على تركيب واجهة برمجة التطبيقات لخدمات 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 على الجهازَين 1 و2 و3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

3. تحديث واجهة برمجة التطبيقات BaaS Portal على الجهاز 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"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

للحصول على مثال كامل لملف الإعدادات، يُرجى الاطّلاع على تركيب واجهة برمجة التطبيقات لخدمات 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 Stack على الأجهزة 4 و5 و6:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
4. تحديث واجهة برمجة التطبيقات BaaS Portal على الجهاز 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

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