تحديث Apigee Edge 4.16.01/4.16.05 إلى 4.18.01

الإصدار 4.18.01 من Edge الخاص بخدمة Private Cloud

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

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

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

• يمكنك نقل الإصدار 4.15.07 من Apigee Edge إلى الإصدار 4.16.01.
• إذا كان لديك إصدار من Edge سابق للإصدار 4.15.07، يجب عليك أولاً الانتقال إلى الإصدار 4.15.07 ثم إلى الإصدار 4.16.01.
  • في حال نقل البيانات من الإصدار 4.14.04 من Edge أو الإصدارات الأحدث: عليك نقل البيانات مباشرةً إلى الإصدار 4.15.07.
  • في حال نقل البيانات من الإصدار 4.14.01 من Edge: يجب أولاً الانتقال إلى الإصدار 4.14.04، ثم الانتقال إلى الإصدار 4.15.07.

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

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

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

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

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

الرجوع إلى إصدار سابق من Zookeeper في حال التحديث من 4.16.01

إصدار Zookeeper RPM في Edge لـ Private Cloud 4.16.01 هو apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. في الإصدارات اللاحقة من Edge، تم تغيير إصدار Zookeeper مرة أخرى إلى apigee-zookeeper-3.4.5-0.0.94x. وهذا يمنع yum من ترقية Zookeeper إلى إصدار أحدث من 4.16.01. وتتمثل طريقة تصحيح هذا الموقف في تنفيذ yum خفض مستوى apigee-zookeeper قبل تحديث Zookeeper.

يمكنك التحقق من إصدار Zookeeper باستخدام الأمر التالي:

> rpm -qa |grep apigee-zookeeper

في حال عرض هذا الأمر إصدار Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

عليك بعد ذلك الرجوع إلى إصدار سابق.

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

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

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

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

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

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

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

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

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

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

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

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

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

يلزم الترقية إلى الإصدار 8 من Java JDK

يتطلب هذا الإصدار من Edge تثبيت الإصدار 8 من Java JDK على جميع عُقد معالجة Edge. يمكنك تثبيت Oracle JDK 8 أو OpenJDK 8. إذا لم يكن Java JDK 8 مثبتًا من قبل، يمكن للبرنامج النصي للتحديث تثبيته نيابةً عنك.

كجزء من التحديث إلى Java 8، لم تعد بعض رموز TLS متوفرة في Oracle JDK 8. للحصول على القائمة الكاملة، يُرجى مراجعة القسم "مجموعات الرموز التلقائية غير المفعّلة" على http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

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

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

• بالنسبة إلى RedHat/CentOS 7.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-Release-latest-7.norc.rpm; rpm -ivh epel-Release-latest-7.norc.rpm
• بالنسبة إلى RedHat/CentOS 6.x:
  wget https://dl.fedoraproject.org/pub/epel/epel-Release-latest-6.norc.rpm; rpm -ivh epel-Release-latest-6.norc.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.18.01:

IS_EXTERNAL_AUTH="true"

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

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

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

الترقية مطلوبة إلى الإصدار 9.6 من Postgres

يتضمن هذا الإصدار من Edge ترقية إلى Postgres 9.6. وكجزء من هذه الترقية، يتم نقل جميع بيانات Postgres إلى إصدار Postgres 9.6.

أثناء عملية التحديث، عندما تكون عُقد Postgres متوقّفة للتحديث، تظل بيانات الإحصاءات مكتوبة في عُقد Qpid. بعد تعديل عُقد Postgres وإعادة عرضها على الإنترنت، يتم إرسال بيانات الإحصاءات إلى عُقد Postgres.

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

تثبيت عقدة Postgres جديدة في وضع الاستعداد

يقوم هذا الإجراء بإنشاء خادم وضع الاستعداد Postgres على عقدة جديدة. احرص على تثبيت خادم وضع الاستعداد الجديد Postgres للإصدار الحالي من Edge (4.16.01 أو 4.16.05)، وليس للإصدار 4.18.01.

لإجراء التثبيت، استخدِم ملف الإعداد نفسه الذي استخدمته لتثبيت الإصدار الحالي من Edge.

لإنشاء عقدة Postgres جديدة في وضع الاستعداد:

1. في مشرف Postgres الرئيسي الحالي، عدِّل الملف /opt/apigee/customer/application/postgresql.properties لضبط الرمز المميّز التالي. إذا لم يكن هذا الملف موجودًا، يمكنك إنشاؤه:
   
   conf_pg_hba_replification.connection=host النسخ المماثل apigee existing_slave_ip/32 Trust\ \nالنسخ المتماثل للمضيف apigee existing_slave_ip/32 Trust
   
   حيث يكون existing_slave_ip هو عنوان IP الحالي في وضع الاستعداد existing_slave_ip
2. أعِد تشغيل apigee-postgresql على Postgres master:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql إعادة تشغيل
3. تأكَّد من إضافة عقدة وضع الاستعداد الجديدة من خلال عرض الملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على المشرف الرئيسي. من المفترض أن تظهر لك السطور التالية في ذلك الملف:
   host تمثيل apigee existing_slave_ip/32Trust
   نسخ المضيف apigee new_slave_ip/32Trust
4. ثبِّت خادم وضع الاستعداد الجديد Postgres:
   1. عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
      
      عنوان IP واحد للنسخة الرئيسية الحالية:
      PG_MASTER=192.168.56.103
      عنوان IP واحد لعقدة وضع الاستعداد الجديدة
      PG_STANDBY=192.168.56.102
   2. أوقِف SELinux كما هو موضح في تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات Edge.
   3. عليك تنزيل ملف Edge Bootstrap_4.16.05.sh إلى /tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh/tmp/bootstrap_4.16.05.sh
      
      
   4. ثبِّت أداة Edge apigee-service والتبعيات التالية:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   5. استخدِم apigee-service لتثبيت الأداة المساعدة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   6. ثبِّت Postgres:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
   7. في عقدة وضع الاستعداد الجديد، شغِّل الأمر التالي:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-frontby
      
      تحقَّق من اختيار وضع الاستعداد.

إيقاف عقدة Postgres

بعد اكتمال التحديث، عليك إيقاف عقدة وضع الاستعداد الجديد:

1. تأكَّد من أنّ Postgres مفعَّلة:
   > /opt/apigee/apigee-service/bin/apigee-all status
   
   إذا لم تكن Postgres مفعَّلة، يمكنك تشغيلها:
   > /opt/apigee/apigee-service/bin/apigee-all start
2. يمكنك الحصول على المعرّف الفريد العالمي لعقدة وضع الاستعداد الجديد من خلال تنفيذ الأمر cURL التالي على عقدة الاستعداد الجديدة:
   > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self
   
   من المفترض أن يظهر لك المعرّف الفريد العالمي للعقدة في نهاية [العُقدة-4" : "7"
   
   
3. أوقِف عقدة وضع الاستعداد الجديدة عن طريق تنفيذ الأمر التالي على عقدة وضع الاستعداد الجديدة:
   > /opt/apigee/apigee-service/bin/apigee-all يطلّ
4. في عقدة Postgres الرئيسية، عدِّل /opt/apigee/customer/application/postgresql.properties لإزالة عقدة وضع الاستعداد الجديدة من conf_pg_hba_replction.connection:
   conf_pg_hba_replction.connection=host Backupgee existing_slave_ip/32Trust
5. أعِد تشغيل apigee-postgresql على شريحة Postgres الرئيسية:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql إعادة تشغيل
6. تأكَّد من إزالة عقدة وضع الاستعداد الجديدة من خلال عرض الملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على الصفحة الرئيسية. من المفترَض أن يظهر لك السطر التالي فقط في هذا الملف:
   host تمثيل apigee existing_slave_ip/32Trust
7. احذف UUID لعقدة الاستعداد من ZooKeeper عن طريق إجراء استدعاء واجهة برمجة تطبيقات إدارة Edge التالي في عقدة خادم الإدارة:
   > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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

يتيح لك التحديث الشامل أو التحديث الدوري إمكانية تحديث تثبيت Edge بدون إسقاط Edge.

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

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

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

عليك مراعاة ما يلي قبل التحديث أو بعده:

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

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

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

وهو إجراء التحديث إلى الإصدار 4.18.01 على عقدة متصلة بالإنترنت خارجيًا.

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

1. إذا كنت تستخدم حاليًا النسخ المماثل في وضع الاستعداد الرئيسي Postgres، ثبِّت عقدة Postgres جديدة في وضع الاستعداد كما هو موضَّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
2. وفي حال توفُّرها، أوقِف أي مهام CRON تم ضبطها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
3. سجِّل الدخول إلى العُقدة كجذر لتثبيت Edge RPMs.
   ملاحظة: على الرغم من أنّ تثبيت RPM يتطلب الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون الوصول إلى الجذر.
4. ثبِّت yum-utils وyum-extension-priorities:
   > sudo yum install yum-utils
   > sudo yum install yum-extension-priorities.
5. أوقِف SELinux كما هو موضح في تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge.
6. فعِّل مستودع EPEL كما هو موضّح أعلاه.
7. إذا كنت تقوم بالتثبيت على Oracle 7.x، شغِّل الأمر التالي:
   > sudo yum-config-manager --enable ol7_optional_latest
8. إذا كنت تقوم بالتثبيت على AWS، فشغّل أوامر yum-configure-manager التالية:
   > yum update rh-amazon-rhui-client.norc
   > sudo yum-config-manager --enable rhui-Region-rhel-server-extras rhui-Region-rhel-server-optional
9. نزِّل ملف Edge 4.18.01 bootstrap_4.18.01.sh من أجل /tmp/bootstrap_4.18.01.sh:
   > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_1.sh
10. ثبِّت أداة Edge 4.18.01 apigee-service والتبعيات التالية:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
    
    حيث يكون uName:pWord إذا حذفت pWord، سيُطلب منك إدخالها.
    
    تتحقق أداة التثبيت تلقائيًا من تثبيت Java 1.8. وإذا لم يكن لديك حساب، سيتم تثبيته نيابةً عنك. استخدِم الخيار JAVA_FIX لتحديد كيفية التعامل مع تثبيت Java. تستخدم JAVA_FIX القيم التالية:
    
    I = تثبيت OpenJDK 1.8 (الإعداد التلقائي)
    C = المتابعة بدون تثبيت Java
    Q = إنهاء. للاستفادة من هذا الخيار، عليك تثبيت Java بنفسك.
11. استخدِم apigee-service لتحديث الأداة المساعدة لإعداد apigee:
    1. في حال تثبيت الإصدار 4.16.01 من خلال ترقية الإصدار 4.15.07.0x من Edge، عليك تثبيت الأداة المساعدة apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
       
       يؤدّي هذا الأمر إلى تثبيت الأداة update.sh في /opt/apigee/setup.
       
       إذا سبق لك تثبيت الأداة apigee-setup، عليك تحديثها:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. في حال تثبيت الإصدار 4.16.01 مباشرةً، أي أنّه لم يتم إجراء ترقية من الإصدار 4.15.07.0x، عليك تحديث الأداة المساعدة apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
       
       يؤدّي هذا التحديث إلى تثبيت apigee-service/optshupdate apigee-service/optshupdate apigee-service/update.
    3. إذا تم تثبيت الإصدار 4.16.05 مباشرةً أو من خلال تحديث، عليك تحديث الأداة المساعدة apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup
       
       يؤدّي هذا التحديث إلى apigee-service إلى تثبيت الأداة update.sh في /opt/apigee/apigee/
12. بناءً على الإصدار الحالي من Edge، يجب تثبيت أو تحديث الأداة المساعدة apigee-validate على "خادم الإدارة".
    1. إذا كنت تستخدم Edge 4.16.05 حاليًا: عليك تحديث الأداة apigee-validate من خادم الإدارة:
       > /opt/apigee/apigee-service/bin/apigee-service apigee- التسوّق تحديث
    2. إذا كنت تستخدم الإصدار 4.16.01 من Edge حاليًا: عليك تثبيت الأداة apigee-validate على خادم الإدارة:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-التحقّق install
       
       ملاحظة: إذا كنت قد ثبّت الأداة apigee-validate على العقدة/apige-التحقّق من صحة
       -apigee> على عقدة apigee-validate لاحقًا عند تثبيت الأداة apigee-شغّل/apige 1 على تنفيذ الأمر apigee-validate التالي:
    3. في حال الترقية من الإصدار 4.16.01: عدِّل ملف الإعداد الذي تم تمريره إلى أداة apigee-validate. في إصدار 4.16.01 Edge، يتطلب ملف الإعداد الذي يستخدمه apigee-validate السمات التالية:
       APIGEE_ADMINPW=sysAdminPword
       MP_POD=gateway
       ISSUE=dc-1
       
       في هذا الإصدار، لا يتطلب ملف الإعداد سوى السمة apigee-validate. ويمكنك إزالة السمتَين الأخريين من الملف.
13. حدِّث الأداة المساعدة apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
14. شغِّل الأداة المساعدة للتحديث على العُقد بالترتيب الموضح أدناه في قسم "ترتيب تحديث الجهاز" أدناه:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    الشرط الوحيد في ملف الإعداد هو أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل المستخدم.
    
    استخدِم الخيار " -c" لتحديد المكوّن المطلوب تحديثه. تشمل قائمة المكوّنات المحتملة ما يلي:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =All Edge UI باستثناء Edge UI: خادم Management Server، أو Message Processor، Router، أو Post gresID Server، أو Post gresID Server
    
    
    
    
    
    
15. اختبر التحديث من خلال تشغيل أداة التحقق من واجهة برمجة التطبيقات على خادم الإدارة، كما هو موضح في اختبار التثبيت.
16. في حال تثبيت عقدة Postgres جديدة في وضع الاستعداد، عليك إيقاف العُقدة على النحو الموضّح أعلاه في إيقاف عقدة Postgres.

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

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

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

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

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

للتعديل من مستودع محلي في الإصدار 4.18.01:

1. إذا كنت تستخدم حاليًا النسخ المماثل في وضع الاستعداد الرئيسي Postgres، ثبِّت عقدة Postgres جديدة في وضع الاستعداد كما هو موضَّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
2. أنشِئ مستودع 4.18.01 محليًا كما هو موضَّح في "إنشاء مستودع Apigee محلي" في تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات Edge.
   ملاحظة: إذا كان لديك حاليًا الإصدار 4.16.01 أو 4.16.05 من الريبو، يمكنك إضافة الريبو 4.18.01 إليه كما هو موضَّح في القسم "تحديث مستودع Apigee محليًا" في تثبيت الأداة المساعدة لإعداد Edge في Edge.
3. لتثبيت apigee-service من ملف .tar:
   1. في العُقدة التي تتضمن Repo المحلي، استخدِم الأمر التالي لتجميع repo المحلي في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-service package
   2. انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى الدليل /tmp على العقدة الجديدة.
   3. في العقدة الجديدة، أزِل الملف إلى دليل /tmp:
      > tar -xzf apigee-4.18.01.tar.gz
      
      ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف .tar. على سبيل المثال /tmp/repos.
   4. يمكنك تثبيت الأداة المساعدة Edge apigee-service والتبعيات من /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      لاحِظ أنّك تُدرِج المسار إلى دليل الأمر repos هذا.
4. لتثبيت خدمة apigee باستخدام خادم الويب Nginx:
   1. اضبط خادم الويب Nginx كما هو موضّح في القسم "التثبيت من المخزن باستخدام خادم الويب Nginx" في تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات Edge.
   2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.18.01.sh إلى /tmp/bootstrap_4.18.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo. :3939/bootstrap_4.
      
      
   3. في العقدة البعيدة، ثبِّت الأداة المساعدة Edge apigee-service والتبعيات:
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeepassword=pWord
      
      
5. استخدِم apigee-service لتحديث الأداة المساعدة لإعداد apigee:
   1. في حال تثبيت الإصدار 4.16.01 من خلال ترقية الإصدار 4.15.07.0x من Edge، عليك تثبيت الأداة المساعدة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      
      يؤدّي هذا الأمر إلى تثبيت الأداة update.sh في /opt/apigee/setup.
      
      إذا سبق لك تثبيت الأداة apigee-setup، عليك تحديثها:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
   2. في حال تثبيت الإصدار 4.16.01 مباشرةً، أي أنّه لم يتم إجراء ترقية من الإصدار 4.15.07.0x، عليك تحديث الأداة المساعدة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      يؤدّي هذا التحديث إلى تثبيت apigee-service/optshupdate apigee-service/optshupdate apigee-service/update.
   3. إذا تم تثبيت الإصدار 4.16.05 مباشرةً أو من خلال تحديث، عليك تحديث الأداة المساعدة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup
      
      يؤدّي هذا التحديث على apigee-service إلى تثبيت الأداة update.sh في /opt/apigee/apigee/
6. بناءً على الإصدار الحالي من Edge، يجب تثبيت أو تحديث الأداة المساعدة apigee-validate على "خادم الإدارة".
   1. إذا كنت تستخدم Edge 4.16.05 حاليًا: عليك تحديث الأداة apigee-validate من خادم الإدارة:
      > /opt/apigee/apigee-service/bin/apigee-service apigee- التسوّق تحديث
   2. إذا كنت تستخدم حاليًا <br class="brph- المكون -2- عدّل-} <br/ توضّح خدمة-
      
      
      
      
      
      
   3. في حال الترقية من الإصدار 4.16.01: عدِّل ملف الإعداد الذي تم تمريره إلى أداة apigee-validate. في إصدار 4.16.01 Edge، يتطلب ملف الإعداد الذي يستخدمه apigee-validate السمات التالية:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      ISSUE=dc-1
      
      في هذا الإصدار، لا يتطلب ملف الإعداد سوى السمة apigee-validate. ويمكنك إزالة السمتَين الأخريين من الملف.
7. حدِّث الأداة المساعدة apigee-provision:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
8. شغِّل الأداة المساعدة للتحديث على العُقد بالترتيب الموضح أدناه في قسم "ترتيب تحديث الجهاز" أدناه:
   > /opt/apigee/apigee-setup/bin/update.sh -ccomponent -f configFile
   
   الشرط الوحيد في ملف الإعداد هو أن يكون ملف الإعداد قادرًا على الوصول إليه أو قراءته من قِبل مستخدم "apigee".
   
   استخدِم الخيار " -c" لتحديد المكوّن المطلوب تحديثه. تشمل قائمة المكوّنات المحتملة ما يلي:
   ldap = OpenLDAP
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   edge =All Edge UI باستثناء Edge UI: خادم Management Server، أو Message Processor، Router، أو Post gresID Server، أو Post gresID Server
   
   
   
   
   
   
9. اختبر التحديث من خلال تشغيل أداة التحقق من واجهة برمجة التطبيقات على خادم الإدارة، كما هو موضح في اختبار التثبيت.
10. في حال تثبيت عقدة Postgres جديدة في وضع الاستعداد، عليك إيقاف العُقدة على النحو الموضّح أعلاه في إيقاف عقدة Postgres.

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

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

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

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

لإجراء تثبيت مستقل لمضيف واحد

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

لإجراء تثبيت مستقل لمضيفَين

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

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

لإجراء تثبيت مجمّع يضم 5 مضيفين

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

1. اضبط SMTPMailFROM في ملف الإعداد إذا فعّلت بروتوكول SMTP على Edge. وتكون هذه المَعلمة على النحو التالي:
   SMTPMailFROM="My Company <myco@company.com>"
2. تأكَّد من تثبيت عقدة Postgres جديدة في وضع الاستعداد كما هو موضَّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
3. في حال التحديث من الإصدار 4.16.01، يجب الرجوع إلى إصدار سابق من Zookeeper على الأجهزة 1 و2 و3:
   > yum خفض مستوى apigee-zookeeper
4. حدِّث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. اضبط قاعدة iptables التالية على الجهاز 4:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 4:
   > qpid-stat -q
   
   واصِل التحقّق من قائمة الانتظار حتى يكون العدد في عمود "الرسالة" هو 0. لا يمكنك ترقية Qpid حتى يعالج جميع الرسائل.
7. حدِّث qpidd على الجهاز 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. مسح iptables على الجهاز 4:
   > sudo iptables -F
9. كرِّر الخطوات من 5 إلى 8 على الجهاز 5.
10. تحديث LDAP على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. تحديث مكونات Edge على الأجهزة 1 و2 و3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
12. تحديث واجهة المستخدم على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. تحديث الجهازين 4 و5:
    1. أوقِف خادم Postgres وخادم Qpid على الجهاز 4:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server إيقاف
    2. أوقِف خادم Postgres وخادم Qpid وpostgresql على الجهاز 5:
       > /opt/apigee/apigee-service/bin/apigee-service محرّك حافة-postgres-server
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-service traffic-qpid-serverstop
       > /apigee/apige/serverspace
       
    3. أوقِف خادم Postgres وpostgresql في عقدة الاستعداد الجديدة التي أضفتها لعملية العودة إلى الحالة السابقة:
       > /opt/apigee/apigee-service/bin/apigee-service محرّك حافة-postgres-server
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    4. تحديث postgresql على الأجهزة 4:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. عدِّل قاعدة بيانات Postgres على الجهاز 4 (Postgres master فقط):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. تحديث Postgresql على الأجهزة 5:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. شغِّل خادم Postgres وخادم Qpid على الجهازين 4 و5:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
       > /opt/apigee/apigee-service/bin/apigee-service محرّك حافة-qpid-server بدء
    8. اضبط Postgres كعقدة في وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز 5:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql- configFile
    9. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. ومن المفترض أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان نجاح النسخ المتماثل:
       
       على الجهاز 4، شغِّل العقدة الرئيسية:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       تحقَّق من أنّها الخادم الرئيسي.
       
       في الجهاز 5، تكون عقدة وضع الاستعداد:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-frontby
       
       تأكَّد من توفّر وضع الاستعداد.
14. تحديث مكوّنات Edge على الجهازين 4 و5:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
15. احرص على الخروج من عُقدة الاستعداد الجديدة باتّباع الإجراء الموضّح أعلاه في القسم إيقاف عقدة Postgres.

لإجراء تثبيت مجمّع يضم 9 مضيفين

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

1. اضبط SMTPMailFROM في ملف الإعداد إذا فعّلت بروتوكول SMTP على Edge. وتكون هذه المَعلمة على النحو التالي:
   SMTPMailFROM="My Company <myco@company.com>"
2. تأكَّد من تثبيت عقدة Postgres جديدة في وضع الاستعداد كما هو موضَّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
3. في حال التحديث من الإصدار 4.16.01، يجب الرجوع إلى إصدار سابق من Zookeeper على أجهزة macine 1 و2 و3:
   > yum خفض مستوى apigee-zookeeper
4. حدِّث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. اضبط قاعدة iptables التالية على الجهاز 6:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 6:
   > qpid-stat -q
   
   واصِل التحقّق من قائمة الانتظار حتى يكون العدد في عمود "الرسالة" هو 0. لا يمكنك ترقية Qpid حتى يعالج جميع الرسائل.
7. حدِّث qpidd على الجهاز 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. مسح iptables على الجهاز 6:
   > sudo iptables -F
9. كرِّر الخطوات من 5 إلى 8 على الجهاز 7.
10. تحديث LDAP على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. حدِّث مكوّنات Edge على الأجهزة 6 و7 و1 و4 و5 بهذا الترتيب:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
12. تحديث واجهة المستخدم على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. تحديث الجهازين 8 و9:
    1. أوقِف خادم Postgres على الجهاز 8:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server off
    2. أوقِف خادم Postgres وpostgresql على الجهاز 9:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server off
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    3. أوقِف خادم Qpid على الجهازين 6 و7:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server إيقاف
    4. أوقِف خادم Postgres وpostgresql في عقدة الاستعداد الجديدة التي أضفتها لعملية العودة إلى الحالة السابقة:
       > /opt/apigee/apigee-service/bin/apigee-service محرّك حافة-postgres-server
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    5. تحديث postgresql على الأجهزة 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. تعديل قاعدة بيانات Postgres على الجهاز 8 (Postgres master فقط):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. تحديث postgresql على الأجهزة 9:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. شغِّل خادم Postgres على الجهازين 8 و9:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. شغِّل خادم Qpid على الجهازين 6 و7:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. اضبط Postgres كعقدة في وضع الاستعداد عن طريق تنفيذ الأوامر التالية على الجهاز 9:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql- configFile
    11. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. ومن المفترض أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان إجراء النسخ المماثل بنجاح:
        على الجهاز 8، تُشغِّل العقدة الرئيسية ما يلي:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        تحقَّق من أنّها الخادم الرئيسي.
        
        في الجهاز 9، تكون عقدة وضع الاستعداد:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-frontby
        
        تأكَّد من توفّر وضع الاستعداد.
14. تحديث مكوّنات Edge على الجهازَين 8 و9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
15. احرص على الخروج من عُقدة الاستعداد الجديدة باتّباع الإجراء الموضّح أعلاه في القسم إيقاف عقدة Postgres.

لإجراء تثبيت مجمّع يضم 13 مضيفًا

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

1. اضبط SMTPMailFROM في ملف الإعداد إذا فعّلت بروتوكول SMTP على Edge. وتكون هذه المَعلمة على النحو التالي:
   SMTPMailFROM="My Company <myco@company.com>"
2. تأكَّد من تثبيت عقدة Postgres جديدة في وضع الاستعداد كما هو موضَّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
3. في حال التحديث من الإصدار 4.16.01، يجب الرجوع إلى إصدار سابق من Zookeeper على أجهزة macine 1 و2 و3:
   > yum خفض مستوى apigee-zookeeper
4. حدِّث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. اضبط قاعدة iptables التالية على الجهاز 12:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 12:
   > qpid-stat -q
   
   واصِل التحقّق من قائمة الانتظار حتى يكون العدد في عمود "msg" هو 0. لا يمكنك ترقية Qpid حتى يعالج جميع الرسائل.
7. حدِّث qpidd على الجهاز 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. مسح iptables على الجهاز 12:
   > sudo iptables -F
9. كرِّر الخطوات من 5 إلى 8 على الجهاز 13.
10. تحديث LDAP على الجهازين 4 و5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. عدِّل مكوّنات Edge على الأجهزة 12 و13 و6 و7 و10 و11 بهذا الترتيب:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
12. تحديث واجهة المستخدم على الجهازين 6 و7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. تحديث الجهازين 8 و9:
    1. أوقِف خادم Postgres على الجهاز 8:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server off
    2. أوقِف خادم Postgres وpostgresql على الجهاز 9:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server off
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    3. أوقِف خادم Qpid على الجهازين 12 و13:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server إيقاف
    4. أوقِف خادم Postgres وpostgresql في عقدة الاستعداد الجديدة التي أضفتها لعملية العودة إلى الحالة السابقة:
       > /opt/apigee/apigee-service/bin/apigee-service محرّك حافة-postgres-server
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    5. تحديث postgresql على الأجهزة 8:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. تعديل قاعدة بيانات Postgres على الجهاز 8 (Postgres master فقط):
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. تحديث postgresql على الأجهزة 9:
       > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. شغِّل خادم Postgres على الجهازين 8 و9:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. شغِّل خادم Qpid على الجهازين 12 و13:
       > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. اضبط Postgres كعقدة في وضع الاستعداد عن طريق تنفيذ الأوامر التالية على الجهاز 9:
        > cd /opt/apigee/data/apigee-postgresql/pgdata
        > rm -rf *
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql- configFile
    11. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. ومن المفترض أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان إجراء النسخ المماثل بنجاح:
        على الجهاز 8، تُشغِّل العقدة الرئيسية ما يلي:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
        
        تحقَّق من أنّها الخادم الرئيسي.
        
        في الجهاز 9، تكون عقدة وضع الاستعداد:
        > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-frontby
        
        تأكَّد من توفّر وضع الاستعداد.
14. تحديث مكوّنات Edge على الجهازَين 8 و9:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
15. احرص على الخروج من عُقدة الاستعداد الجديدة باتّباع الإجراء الموضّح أعلاه في القسم إيقاف عقدة Postgres.

لإجراء تثبيت مجمّع يضم 12 مضيفًا

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

1. اضبط SMTPMailFROM في ملف الإعداد إذا فعّلت بروتوكول SMTP على Edge. وتكون هذه المَعلمة على النحو التالي:
   SMTPMailFROM="My Company <myco@company.com>"
2. تأكَّد من تثبيت عقدة Postgres جديدة في وضع الاستعداد كما هو موضَّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
3. عدِّل Cassandra و ZooKeeper:
   1. في حال التحديث من الإصدار 4.16.01، يجب الرجوع إلى إصدار سابق من Zookeeper على أجهزة macine 1 و2 و3 في Data Center 1:
      > yum خفض مستوى الوصول إلى apigee-zookeeper
   2. على الأجهزة 1 و2 و3 في مركز البيانات 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   3. في حال التحديث من الإصدار 4.16.01، يجب الرجوع إلى إصدار سابق من Zookeeper على أجهزة macine 7 و8 و9 في "مركز البيانات 2":
      > yum خفض مستوى الوصول إلى apigee-zookeeper
   4. على الأجهزة 7 و8 و9 في مركز البيانات 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. تعديل 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.
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 و1 و2 و3 في مركز البيانات 1
      > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
   2. الأجهزة 10 و11 و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
8. تحديث الجهاز 6 في مركز البيانات 1 و12 في مركز البيانات 2:
   1. أوقِف خادم Postgres على الجهاز 6:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server off
   2. أوقِف خادم Postgres وpostgresql على الجهاز 12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server off
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
   3. أوقِف خادم Qpid على الأجهزة 4 و5 و10 و11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server إيقاف
   4. أوقِف خادم Postgres وpostgresql في عقدة الاستعداد الجديدة التي أضفتها لعملية العودة إلى الحالة السابقة:
      > /opt/apigee/apigee-service/bin/apigee-service محرّك حافة-postgres-server
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
   5. تحديث postgresql على الأجهزة 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. يُرجى تعديل قاعدة بيانات Postgres على الجهاز 6 (Postgres master فقط):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. تحديث postgresql على الأجهزة 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   8. شغِّل خادم Postgres على الجهازين 6 و12:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
   9. بدء خادم Qpid على الأجهزة 4 و5 و10 و11:
      > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
   10. اضبط Postgres كعقدة في وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز 12:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postbyplification-config configFile
   11. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. ومن المفترض أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان إجراء النسخ المماثل بنجاح:
       على الجهاز 6، تُشغِّل العقدة الرئيسية ما يلي:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       تحقَّق من أنّها الخادم الرئيسي.
       
       في الجهاز 12، تكون عقدة وضع الاستعداد:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check- readyby
       
       تأكَّد من توفّر وضع الاستعداد.
9. تحديث مكوّنات Edge على الجهازَين 6 و12:
   > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
10. احرص على الخروج من عُقدة الاستعداد الجديدة باتّباع الإجراء الموضّح أعلاه في القسم إيقاف عقدة Postgres.

لتثبيت واجهة برمجة التطبيقات ذات 7 مضيف أو 10 مضيفات BaaS

بالنسبة إلى عملية التثبيت غير العادية

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

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