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

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

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

يمكنك تحديث الإصدار 4.17.01.0x/4.17.05.0x من Apigee Edge إلى الإصدار 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 من API 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. سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم RPM في Edge.
   ملاحظة: على الرغم من أنّ تثبيت 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.17.09.sh
7. ثبِّت أداة 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 بنفسك.
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
    
    الشرط الوحيد في ملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول أو القراءة من قِبل مستخدم "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 على العقدة نفسها
12. اختبِر التحديث من خلال تشغيل الأداة المساعدة 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 محلي" في تثبيت أداة apigee-setup في Edge.
   ملاحظة: إذا كان لديك مستودع 4.17.01/4.17.05 حالي، يمكنك إضافة مستودع 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-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
      
      يُرجى ملاحظة أنك تُدرج المسار إلى دليل المستودعات في هذا الأمر.
3. لتثبيت apigee-service باستخدام خادم الويب Nginx:
   1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب Nginx" في تثبيت أداة apigee-setup في Edge.
   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. على العقدة البعيدة، ثبِّت أداة apigee-service في Edge والتبعيات:
      > 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 -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.09.

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

يُعدّ ترتيب تحديث الأجهزة في عملية تثبيت 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".

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

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="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 على الجهاز 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

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

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

3. حدِّث ElasticSearch وAPI BaaS Stack على الأجهزة 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="My Company <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 على الأجهزة 4 و5 و6:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
5. تحديث بوابة API BaaS على الجهاز 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

بالنسبة إلى تثبيت API Baas في مركزَي بيانات

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

1. اضبط SMTPMAILFROM في ملفات الإعداد. تتخذ هذه المَعلمة الشكل التالي:
   SMTPMAILFROM="My Company <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> select * من 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. حدِّث حزمة API BaaS على الأجهزة في مركز البيانات 1، جهازًا تلو الآخر:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
8. حدِّث حزمة API BaaS على الأجهزة في مركز البيانات 2، جهازًا تلو الآخر:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
9. حدِّث بوابة API 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 * من system.schema_keyspaces;
       4. اخرج من cqlsh:
          cqlsh> exit

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

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

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