تحديث Apigee Edge 4.17.01/4.17.05 إلى 4.17.09

Edge for Private Cloud‏ 4.17.09

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

يمكنك تحديث إصدار Apigee Edge 4.17.01.0x/4.17.05.0x إلى 4.17.09 باستخدام هذه العملية.

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

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

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

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

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

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

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

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

إضافة مَعلمة الضبط SMTPMAILFROM المطلوبة

أضافت الإصدار 4.17.05 من Edge مَعلمة مطلوبة جديدة إلى ملف الإعدادات المستخدَم عند تفعيل خادم SMTP. إذا كنت بصدد التحديث من الإصدار 4.17.01، عليك ضبط SMTPMAILFROM في ملف الإعدادات عند تفعيل خادم SMTP.

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

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

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

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

يجب استيفاء المتطلبات الأساسية التالية قبل ترقية 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.17.01.

الإجراء المتعلّق بالتحديث إلى الإصدار 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. في حال التثبيت على AWS، شغِّل الأمر yum-configure-manager التالي:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
6. نزِّل ملف Edge 4.17.09 bootstrap_4.17.09.sh إلى /tmp/bootstrap_4.17.09.sh:
   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.
7. ثبِّت أداة apigee-service و ملحقاتها في Edge 4.17.09:
   > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
   
   حيث يكون uName:pWord هما اسم المستخدم وكلمة المرور اللذان تلقّيتَهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخالها.
   
   تتحقّق أداة التثبيت تلقائيًا ممّا إذا كان الإصدار 1.8 من Java مثبّتًا. وإذا لم تفعل ذلك، سيقوم التطبيق بتثبيته نيابةً عنك. استخدِم الخيار JAVA_FIX لتحديد كيفية التعامل مع تثبيت Java. تستخدم دالة JAVA_FIX القيم التالية:
   
   I = تثبيت OpenJDK 1.8 (تلقائي)
   C = المتابعة بدون تثبيت Java
   Q = إنهاء. لتنفيذ هذا الخيار، يجب تثبيت Java بنفسك.
8. استخدِم apigee-service لتعديل أداة apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
9. عدِّل الأداة apigee-validate على خادم الإدارة:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
10. عدِّل الأداة apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
11. شغِّل أداة التحديث على العُقد بالترتيب الموضّح أدناه في قسم "ترتيب تحديث الجهاز" أدناه:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    الشرط الوحيد في ملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول إليه أو يمكن للمستخدم قراءته
    
    استخدِم الخيار "-c" لتحديد المكوِّن المطلوب تحديثه.
    
    
    
    
    
    
    
    
    
    
    
    ldap
12. اختبِر التحديث من خلال تشغيل أداة التحقّق من صحة واجهة برمجة التطبيقات (apigee) على "خادم الإدارة"، كما هو موضّح في اختبار التثبيت.

لإلغاء التحديث لاحقًا، استخدِم الإجراء الموضّح في 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.17.01/4.17.05، يمكنك إضافة مستودع الإصدار 4.17.09 إليه كما هو موضّح في "تعديل مستودع Apigee على الجهاز" في مقالة تثبيت أداة Edge apigee-setup.
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-mirror package
   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 Edge bootstrap_4.17.09.sh وEd bootst.4.17.09.sh. الخاص به إلى. / to /tmp/bootstrap.4.17.09.sh.
      .99. Edge bootstrap_4.17.09.sh ثم Edge bootstrap_4.17.09.sh الخاص الخاصة به إلى 2.0. أيضًا إلى 3.0، ثم استخدامه ثم /t. ثم /t. أيضًا. /tmp/boot.3.17.09.sh.
      .
      . Download the Edge bootstrap_4.17.09.sh ملف Edge. إلى /tmp/boot.9.9.9EG. مقتلته. أيضًا إلى 3.9.
   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. عدِّل الأداة 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 -ccomponent -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) على "خادم الإدارة"، كما هو موضّح في اختبار التثبيت.

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

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

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

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

بالنسبة إلى تثبيت مستقل لمضيف واحد

1. إذا كنت تريد التحديث من الإصدار 4.17.01، اضبط 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. تحديث Qpid وPostgres:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. ابدأ postgresql:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. تعديل LDAP:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. عدِّل مكوّنات Edge المتبقية:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. تعديل واجهة مستخدم Edge:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

بالنسبة إلى التثبيت المستقلّ:

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

1. في حال التحديث من الإصدار 4.17.01، اضبط 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. حدِّث Qpid وPostgres على الجهاز 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. بدء postgresql على الجهاز 2:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. تعديل LDAP على الجهاز 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. تعديل مكوّنات Edge على الجهازَين 2 و1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. تعديل واجهة المستخدم على الجهاز 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

في ما يتعلّق بتركيب 5 مضيفين

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

1. إذا كنت تريد التحديث من الإصدار 4.17.01، اضبط 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. تحديث Qpid وPostgres على الجهاز 4:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. ابدأ postgresql على الجهاز 4:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. كرِّر الخطوتين 3 و4 على الجهاز رقم 5.
6. تعديل LDAP على الجهاز 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. عدِّل مكوّنات Edge على الأجهزة 4 و5 و1 و2 و3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. تعديل واجهة المستخدم على الجهاز 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

للتثبيت المجمّع باستخدام 9 مضيفات

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

1. في حال التحديث من الإصدار 4.17.01، اضبط 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. تعديل Qpid وPostgres على الجهاز 6:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. ابدأ postgresql على الجهاز 6:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. كرِّر الخطوتَين 3 و4 على الجهاز 7.
6. تعديل LDAP على الجهاز 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. عدِّل مكوّنات Edge على الأجهزة 6 و7 و8 و9 و1 و4 و5 بهذا الترتيب:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. تعديل واجهة المستخدم على الجهاز 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

لتركيب 13 مضيفًا في مجموعات

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

1. في حال التحديث من الإصدار 4.17.01، اضبط 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. تعديل Qpid وPostgres على الجهاز 12:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. شغِّل postgresql على الجهاز 12:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. كرِّر الخطوتَين 3 و4 على الجهاز 13.
6. تعديل LDAP على الجهازَين 4 و5:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. عدِّل مكوّنات Edge على الأجهزة 12 و13 و8 و9 و6 و7 و10 و11 بهذا الترتيب:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. تحديث واجهة المستخدم على الجهازين 6 و7:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

في ما يتعلّق بتركيب 12 مضيفًا في عناقيد

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

1. في حال التحديث من الإصدار 4.17.01، اضبط 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. عدِّل qpidd على الجهاز 4:
         > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. كرِّر الخطوة 1 على الجهاز 5.
   2. الجهازان 10 و11 في مركز البيانات 2
      1. تعديل qpidd على الجهاز 10:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. كرِّر الخطوة 1 على الجهاز 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 لواجهة برمجة التطبيقات

1. اضبط SMTPMAILFROM في ملف الضبط. وتكون هذه المَعلمة على النحو التالي:
   SMTPmailFROM="شركتي <myco@company.com>"
2. يجب تحديث Cassandra على الأجهزة 5 و6 و7:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

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

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

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

1. اضبِط SMTPmailFROM في ملف الإعداد. وتكون هذه المَعلمة على النحو التالي:
   SMTPmailFROM="شركتي <myco@company.com>"
2. عدِّل Cassandra على الجهازَين 8 و9 و10:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
3. تعديل ElasticSearch على الجهاز 1 و2 و3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
4. عدِّل حِزمة API BaaS Stack على الأجهزة 4 و5 و6:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
5. تحديث واجهة برمجة التطبيقات BaaS Portal على الجهاز 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

لتركيب Baas باستخدام واجهة برمجة تطبيقات في مركزَي بيانات

يتطلّب هذا الإجراء تعديل عقد Cassandra في كلا مركزَي البيانات. إذا كنت تتمكّن من مشاركة عقد Cassandra هذه مع Edge، يمكنك عادةً تعديل هذه العقد كجزء من تعديل Edge.

1. اضبط SMTPmailFROM في ملفات الإعداد. وتكون هذه المَعلمة على النحو التالي:
   SMTPmailFROM="شركتي <myco@company.com>"
2. عدِّل مساحات مفاتيح Cassandra باستخدام عامل التكرار الصحيح لكلا مركزَي البيانات. ما عليك سوى تنفيذ هذه الخطوة مرة واحدة فقط على أي خادم من خوادم Cassandra في أيّ من مركزَي البيانات:
   
   ملاحظة: تضبط الأوامر الواردة أدناه عامل النسخ على "3"، ما يشير إلى ثلاث عقد Cassandra في المجموعة. عدِّل هذه القيمة حسب الحاجة لعملية التثبيت.
   1. ابدأ أداة Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
   2. نفِّذ أوامر CQL التالية في موجه "cqlsh>" لضبط مستويات النسخ المتعدّد لمساحات مفاتيح Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. اعرض مساحة المفاتيح باستخدام الأمر:
         cqlsh> اختَر * من system.schema_keyspaces;
      7. للخروج من cqlsh:
         cqlsh> exit
3. (فقط إذا لم تكن قد عدّلت Cassandra كجزء من تعديل Edge) عدِّل عقد Cassandra في مركز البيانات 1، جهاز واحد في كل مرة:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
4. (فقط إذا لم تكن قد عدّلت Cassandra كجزء من تحديث Edge) عدِّل عقد Cassandra في مركز البيانات 2، جهاز واحد في كل مرة:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
5. عدِّل ElasticSearch على الأجهزة في مركز البيانات 1، جهاز واحد في كل مرة:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
6. عدِّل ElasticSearch على الأجهزة في مركز البيانات 2، جهاز واحد في كل مرة:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
7. عدِّل واجهة برمجة التطبيقات BaaS Stack على الأجهزة المتوفّرة في مركز البيانات 1، على جهاز واحد في كل مرة:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
8. عدِّل حِزمة API BaaS Stack على الأجهزة في مركز البيانات 2، جهاز واحد في كل مرة:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
9. تحديث بوابة واجهة برمجة التطبيقات BaaS على الأجهزة في مركز البيانات 1، على جهاز واحد في كل مرة:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
10. عدِّل بوابة API BaaS على الأجهزة في مركز البيانات 2، جهاز واحد في كل مرة:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
11. عدِّل قيم مساحة مفاتيح BaaS. يجب ضبط مساحة المفاتيح هذه للتكرار في وقت التثبيت، ولكن ليس في وقت التشغيل. تؤدي إزالة النسخ المتعدّد أيضًا إلى توفير ذاكرة Cassandra.
    
    عليك تنفيذ هذه الخطوة مرة واحدة فقط على أي خادم من خوادم Cassandra في أيّ من مركزَي البيانات:
    1. ابدأ أداة Cassandra cqlsh:
       > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. نفِّذ أوامر CQL التالية لضبط مستويات النسخ في مساحات مفاتيح Cassandra :
       1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
       2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
       3. يمكنك عرض مساحات المفاتيح باستخدام الأمر:
          cqlsh> select * from system.schema_keyspaces;
       4. الخروج من الملف cqlsh:
          cqlsh> خروج

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

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

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