تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

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

يمكنك نقل بيانات الإصدار 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 في الأصل، أو مستخدمًا يعمل كمستخدم جذر.

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

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

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

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

إصدار Zookeeper RPM في Edge for 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 downgrade 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.17.05 Rollback Process لمزيد من المعلومات.

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

بشكل تلقائي، تكتب الأداة المساعدة 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.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
بالنسبة إلى RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

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

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

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

أضِف هذه المَعلمة إلى ملف الإعداد قبل إجراء التحديث.

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

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

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

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

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

IS_EXTERNAL_AUTH="true"

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

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

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

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

يُرجى العِلم أنّه في حال استخدام iptables لقواعد أخرى، يمكنك استخدام الخيار -D لإلغاء التغيير المحدّد:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

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

الترقية المطلوبة إلى Postgres 9.4

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

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

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

تثبيت عقدة احتياطية جديدة في Postgres

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

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

لإنشاء عقدة احتياطية جديدة في Postgres:

في قاعدة بيانات Postgres الرئيسية الحالية، عدِّل الملف /opt/apigee/customer/application/postgresql.properties لضبط الرمز المميّز التالي. إذا لم يكن هذا الملف متوفّرًا، أنشئه:

conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

حيث existing_slave_ip هو عنوان IP لخادم Postgres الاحتياطي الحالي وnew_slave_ip هو عنوان IP للعقدة الاحتياطية الجديدة.
أعِد تشغيل apigee-postgresql على Postgres الرئيسي:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
تحقَّق من إضافة عقدة الاستعداد الجديدة من خلال الاطّلاع على الملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على العقدة الرئيسية. من المفترض أن تظهر لك الأسطر التالية في هذا الملف:
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
ثبِّت خادم Postgres الاحتياطي الجديد:
1. عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
  
  # عنوان IP للعقدة الرئيسية الحالية:
  PG_MASTER=192.168.56.103
  # عنوان IP للعقدة الاحتياطية الجديدة
  PG_STANDBY=192.168.56.102
2. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في 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
  
  ملاحظة: في حال التحديث من الإصدار 4.16.01، نزِّل ملف Edge bootstrap.sh.
4. ثبِّت أداة apigee-service في Edge والعناصر التابعة:
  > 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-standby
  
  تأكَّد من أنّها عقدة الاستعداد.

إيقاف عقدة Postgres

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

تأكَّد من أنّ Postgres قيد التشغيل:
> /opt/apigee/apigee-service/bin/apigee-all status

إذا لم يكن Postgres قيد التشغيل، ابدأ تشغيله:
> /opt/apigee/apigee-service/bin/apigee-all start
احصل على المعرّف الفريد العالمي (UUID) لعقدة الاستعداد الجديدة من خلال تشغيل أمر cURL التالي على عقدة الاستعداد الجديدة:
> curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

من المفترض أن يظهر لك المعرّف الفريد العالمي (UUID) للعقدة في نهاية الناتج، على النحو التالي:
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
أوقِف عقدة الاستعداد الجديدة من خلال تشغيل الأمر التالي على عقدة الاستعداد الجديدة:
> /opt/apigee/apigee-service/bin/apigee-all stop
في العقدة الرئيسية في Postgres، عدِّل /opt/apigee/customer/application/postgresql.properties لإزالة العقدة الاحتياطية الجديدة من conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
أعِد تشغيل apigee-postgresql على Postgres الرئيسي:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
تأكَّد من إزالة العقدة الاحتياطية الجديدة من خلال الاطّلاع على ملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على العقدة الرئيسية. من المفترض أن يظهر لك السطر التالي فقط في هذا الملف:
host replication apigee existing_slave_ip/32 trust
احذف المعرّف الفريد العالمي (UUID) للعقدة الاحتياطية من ZooKeeper من خلال إجراء طلب بيانات من واجهة برمجة التطبيقات لإدارة Edge على عقدة خادم الإدارة:
> curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

تحديث بدون توقّف

يتيح لك التحديث بدون توقّف أو التحديث المتجدّد تحديث تثبيت Edge بدون إيقاف Edge.

لا يمكن إجراء تحديث بدون توقّف إلا من خلال إعدادات تتضمّن 5 عُقد أو أكثر.

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

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

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

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

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

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

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

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

إذا كنت تستخدم حاليًا النسخ المتماثل الرئيسي الاحتياطي في Postgres، ثبِّت عقدة احتياطية جديدة في Postgres كما هو موضّح أعلاه في تثبيت عقدة احتياطية جديدة في Postgres.
في حال توفّر أي مهام CRON تم ضبطها لإجراء عملية إصلاح على Cassandra، عليك إيقافها إلى أن يكتمل التحديث.
سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم RPM في Edge.
ملاحظة: على الرغم من أنّ تثبيت RPM يتطلّب الوصول إلى الجذر، يمكنك ضبط Edge بدون الوصول إلى الجذر.
أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.
نزِّل ملف Edge 4.17.05 bootstrap_4.17.05.sh إلى /tmp/bootstrap_4.17.05.sh:
> curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
ثبِّت أداة apigee-service في Edge 4.17.05 والتبعيات:
> sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان تلقيتهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخالها.

يتحقّق المثبِّت تلقائيًا من تثبيت Java 1.8. وإذا لم يكن مثبّتًا، سيتم تثبيته نيابةً عنك. استخدِم الخيار JAVA_FIX لتحديد كيفية التعامل مع تثبيت Java. JAVA_FIX يأخذ القيم التالية:

I = تثبيت OpenJDK 1.8 (تلقائي)
C = المتابعة بدون تثبيت Java
Q = إنهاء. بالنسبة إلى هذا الخيار، عليك تثبيت Java بنفسك.
(CentOS-6.x وRedHat-6.x فقط) على جميع عُقد Qpid، نفِّذ الأمر التالي للتأكّد من تنزيل إصدار Qpid الصحيح:
> yum install apigee-qpidd --disablerepo=epel
استخدِم apigee-service لتحديث أداة apigee-setup:
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/apigee-setup/bin.
  
  إذا سبق لك تثبيت الأداة المساعدة 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 إلى تثبيت الأداة المساعدة update.sh في /opt/apigee/apigee-setup/bin.
3. إذا ثبّت الإصدار 4.16.05 مباشرةً أو من خلال التحديث، عليك تحديث الأداة المساعدة apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  يؤدي هذا التحديث إلى apigee-service إلى تثبيت الأداة المساعدة update.sh في /opt/apigee/apigee-setup/bin.
استنادًا إلى الإصدار الحالي من Edge، عليك تثبيت الأداة المساعدة apigee-validate أو تحديثها على خادم الإدارة.
1. إذا كنت تستخدم حاليًا الإصدار 4.16.05 من Edge: حدِّث الأداة المساعدة apigee-validate على خادم الإدارة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. إذا كنت تستخدم حاليًا الإصدار 4.16.01 من Edge: ثبِّت الأداة المساعدة apigee-validate على خادم الإدارة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  ملاحظة: إذا كنت قد ثبّت الأداة المساعدة apigee-validate على عقدة معالج الرسائل عند تثبيت الإصدار 4.16.01، يمكنك تحديثها باستخدام الأمر التالي على تلك العقدة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  ومع ذلك، اعتبارًا من الإصدار 4.16.05 والإصدارات الأحدث، تنصح Apigee بتثبيت الأداة المساعدة apigee-validate وتشغيلها على خادم الإدارة.
3. في حال الترقية من الإصدار 4.16.01: عدِّل ملف الإعداد الذي تم تمريره إلى الأداة المساعدة apigee-validate. في الإصدار 4.16.01 من Edge، تطلّب ملف الإعدادات الذي تستخدمه apigee-validate السمات التالية:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  في هذا الإصدار، يتطلّب ملف الإعدادات السمة APIGEE_ADMINPW فقط. ويمكنك إزالة الموقعَين الآخرَين من الملف.
حدِّث الأداة المساعدة apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
شغِّل أداة التحديث المساعدة على العُقد بالترتيب الموضَّح أدناه في "ترتيب تحديث الجهاز" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

الشرط الوحيد في ملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول أو القراءة من قِبل مستخدم "apigee".

استخدِم الخيار "‎-c" لتحديد المكوّن المطلوب تحديثه. تتضمّن قائمة المكوّنات المحتملة ما يلي:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres
ui = واجهة مستخدم Edge
all = تحديث جميع المكوّنات على الجهاز (يُستخدم فقط لملف تعريف تثبيت Edge aio أو ملف تعريف تثبيت API BaaS asa)
e = ElasticSearch
b = حزمة واجهة برمجة التطبيقات BaaS
p = بوابة واجهة برمجة التطبيقات BaaS
ebp = ElasticSearch وحزمة واجهة برمجة التطبيقات BaaS وبوابة واجهة برمجة التطبيقات BaaS على العقدة نفسها
اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.
إذا ثبّت عقدة احتياطية جديدة في Postgres، عليك إيقاف العقدة نهائيًا كما هو موضّح أعلاه في إيقاف عقدة Postgres نهائيًا.

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

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

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

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

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

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

إذا كنت تستخدم حاليًا النسخ المتماثل الرئيسي الاحتياطي في Postgres، ثبِّت عقدة احتياطية جديدة في Postgres كما هو موضّح أعلاه في تثبيت عقدة احتياطية جديدة في Postgres.
أنشئ مستودعًا محليًا للإصدار 4.17.05 كما هو موضّح في "إنشاء مستودع Apigee محلي" في تثبيت أداة apigee-setup في Edge.
ملاحظة: إذا كان لديك مستودع 4.16.01 أو 4.16.05 حالي، يمكنك إضافة مستودع 4.17.05 إليه كما هو موضّح في "تحديث مستودع Apigee محلي" في تثبيت أداة apigee-setup في Edge.
لتثبيت apigee-service من ملف ‎ .tar:
1. في العقدة التي تحتوي على المستودع المحلي، استخدِم الأمر التالي لإنشاء حزمة للمستودع المحلي في ملف ‎ .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. انسخ ملف ‎ .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى الدليل ‎/tmp على العقدة الجديدة.
3. في العقدة الجديدة، فُكّ ضغط الملف في الدليل ‎ /tmp:
  > tar -xzf apigee-4.17.05.tar.gz
  
  ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف ‎ .tar. على سبيل المثال، ‎ /tmp/repos.
4. ثبِّت أداة apigee-service في Edge والتبعيات من /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  يُرجى ملاحظة أنّه عليك تضمين المسار إلى دليل المستودعات في هذا الأمر.
لتثبيت apigee-service باستخدام خادم الويب Nginx:
1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب Nginx" في تثبيت أداة apigee-setup في Edge.
2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.17.05.sh إلى ‎/tmp/bootstrap_4.17.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  
  حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان حددتهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة المستودع.
3. على العقدة البعيدة، ثبِّت أداة apigee-service في Edge والتبعيات:
  > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  حيث uName:pWord هما اسم المستخدم وكلمة المرور للمستودع.
استخدِم apigee-service لتحديث أداة apigee-setup:
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/apigee-setup/bin.
  
  إذا سبق لك تثبيت الأداة المساعدة 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 إلى تثبيت أداة update.sh المساعدة في /opt/apigee/apigee-setup/bin.
3. إذا ثبّت الإصدار 4.16.05 مباشرةً أو من خلال التحديث، عليك تحديث الأداة المساعدة apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  يؤدي هذا التحديث إلى apigee-service إلى تثبيت الأداة المساعدة update.sh في /opt/apigee/apigee-setup/bin.
استنادًا إلى الإصدار الحالي من Edge، عليك تثبيت الأداة المساعدة apigee-validate أو تحديثها على خادم الإدارة.
1. إذا كنت تستخدم حاليًا الإصدار 4.16.05 من Edge: حدِّث الأداة المساعدة apigee-validate على خادم الإدارة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
2. إذا كنت تستخدم حاليًا الإصدار 4.16.01 من Edge: ثبِّت الأداة المساعدة apigee-validate على خادم الإدارة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  ملاحظة: إذا كنت قد ثبَّت الأداة المساعدة apigee-validate على عقدة معالج الرسائل عند تثبيت الإصدار 4.16.01، يمكنك تحديثها باستخدام الأمر التالي على تلك العقدة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  ومع ذلك، اعتبارًا من الإصدار 4.16.05 والإصدارات الأحدث، تنصح Apigee بتثبيت الأداة المساعدة apigee-validate وتشغيلها على خادم الإدارة.
3. في حال الترقية من الإصدار 4.16.01: عدِّل ملف الإعداد الذي تم تمريره إلى الأداة المساعدة apigee-validate. في الإصدار 4.16.01 من Edge، تطلّب ملف الإعدادات الذي تستخدمه apigee-validate السمات التالية:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  REGION=dc-1
  
  في هذا الإصدار، يتطلّب ملف الإعدادات السمة APIGEE_ADMINPW فقط. ويمكنك إزالة السمتَين الأخريَين من الملف.
حدِّث الأداة المساعدة apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
شغِّل أداة التحديث على العُقد بالترتيب الموضَّح أدناه في "ترتيب تحديث الجهاز":
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

الشرط الوحيد لملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول أو القراءة من قِبل مستخدم "apigee".

استخدِم الخيار "‎-c" لتحديد المكوّن المطلوب تحديثه. تتضمّن قائمة المكوّنات المحتملة ما يلي:
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres
ui = واجهة مستخدم Edge
all = تحديث جميع المكوّنات على الجهاز (يُستخدم فقط لملف تعريف تثبيت Edge aio أو ملف تعريف تثبيت API BaaS asa)
e = ElasticSearch
b = حزمة واجهة برمجة التطبيقات BaaS
p = بوابة واجهة برمجة التطبيقات BaaS
ebp = ElasticSearch وحزمة واجهة برمجة التطبيقات BaaS وبوابة واجهة برمجة التطبيقات BaaS على العقدة نفسها
اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.
إذا ثبّت عقدة احتياطية جديدة في Postgres، عليك إيقاف العقدة نهائيًا كما هو موضّح أعلاه في إيقاف عقدة Postgres نهائيًا.

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

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

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

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