تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تحديث Apigee Edge إلى الإصدار 4.16.09

Edge for Private Cloud‏ 4.16.09

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

يمكنك تحديث الإصدار 4.16.01.0x و4.16.05.x من Apigee Edge إلى الإصدار 4.16.09.

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

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

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

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

الترقية المطلوبة إلى الإصدار 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.

الرجوع إلى إصدار سابق من 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 يعمل أثناء عملية التحديث باستخدام الأمر:

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

التعامل مع التحديث الذي تعذّر تنفيذه

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

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

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

تُسجِّل الأداة update.sh معلومات السجلّ تلقائيًا في:

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

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

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

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

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

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

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

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

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

لتنفيذ عملية التثبيت، استخدِم ملف الإعداد نفسه الذي استخدمته لتثبيت الإصدار الحالي من 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 كما هو موضّح في مقالة تثبيت Edge util-apigee-setup.
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. ثبِّت أداة وتبعيات Edge apigee:
  > 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
استخدِم الأمر cURL التالي.
أوقِف العقدة الاحتياطية الجديدة من خلال تنفيذ الأمر التالي على العقدة الاحتياطية الجديدة:
> /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.16.09 على عقدة متصلة بالإنترنت الخارجي

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

إذا كنت تستخدِم حاليًا ميزة "النسخ الاحتياطي للمشغّل الرئيسي" في Postgres، ثبِّت عقدة Postgres جديدة في وضع الاستعداد كما هو موضّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
أوقِف أي مهام CRON تم إعدادها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
ملاحظة: على الرغم من أنّ تثبيت RPM يتطلب الوصول إلى الجذر، يمكنك تنفيذ إعدادات Edge بدون الوصول إلى الجذر.
أوقِف SELinux كما هو موضّح في مقالة تثبيت أداة apigee-setup في Edge.
نزِّل ملف Edge 4.16.09 bootstrap_4.16.09.sh إلى /tmp/bootstrap_4.16.09.sh:
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.
ثبِّت الأداة apigee-service و عناصرها التابعة في Edge 4.16.09:
> sudo bash /tmp/bootstrap_4.16.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 بنفسك.
استخدِم 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/binge في <inst_dir>.
  
  إذا سبق لك تثبيت الأداة 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 في <inst_dir>/apigee/apigee-setup/bin.
3. إذا ثبّتْت الإصدار 4.16.05 مباشرةً أو من خلال تحديث، عليك تحديث util-apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  يؤدي هذا التحديث إلى apigee-service إلى تثبيت utility-update.sh في <inst_dir>/apigee/apigee-setup/bin.
استنادًا إلى الإصدار الحالي من Edge، عليك تثبيت أو تحديث أداة apigee-validate على خادم الإدارة.
1. إذا كنت تستخدم حاليًا الإصدار 4.16.05 من Edge: عليك تحديث الأداة apigee-verifyate على خادم الإدارة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
2. إذا كنت تستخدم حاليًا الإصدار 4.16.01 من Edge: ثبِّت الأداة apigee-validate على Management Server:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
  
  ملاحظة: إذا سبق لك تثبيت الأداة apigee-validate على node Message Processor عند تثبيت الإصدار 4.16.01، يمكنك تعديلها باستخدام الأمر التالي على هذه العقدة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  
  ومع ذلك، اعتبارًا من الإصدار 4.16.05 والإصدارات الأحدث، تنصح Apigee بتثبيت الأداة apigee-validate وتشغيلها على Management Server.
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
اختبِر التحديث من خلال تشغيل أداة التحقّق من صحة واجهة برمجة التطبيقات (apigee) على "خادم الإدارة"، كما هو موضّح في اختبار التثبيت.
في حال تثبيت عقدة وضع الاستعداد جديدة من Postgres، يجب إيقاف العُقدة كما هو موضَّح أعلاه في إيقاف عقدة Postgres.

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

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

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

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

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

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

إذا كنت تستخدِم حاليًا ميزة "النسخ الاحتياطي للمشغّل الرئيسي" في Postgres، ثبِّت عقدة Postgres جديدة في وضع الاستعداد كما هو موضّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
أنشئ مستودعًا محليًا من الإصدار 4.16.09 كما هو موضّح في مقالة "إنشاء مستودع Apigee محلي" ضمن تثبيت أداة Edge apigee-setup.
ملاحظة: إذا كان لديك حاليًا مستودع 4.16.01 أو 4.16.05، يمكنك إضافة المستودع 4.16.09 إليه كما هو موضّح في "تحديث مستودع Apigee محلي" على تثبيت أداة Edge apigee-setup.
لتثبيت خدمة apigee من ملف .tar:
1. في العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لتجميع المستودع المحلي في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-4.16.09.tar.gz:
2. انسخ ملف ‎.tar إلى العقدة التي تريد تحديث Edge عليها. على سبيل المثال، يمكنك نسخه إلى الدليل /tmp على العقدة الجديدة.
3. في العقدة الجديدة، فكِّ ضغط الملف إلى الدليل ‎ /tmp:
  > tar -xzf apigee-4.16.09.tar.gz
  
  ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف tar. على سبيل المثال، ‎ /tmp/repos.
4. ثبِّت أداة Edge apigee-service والتبعيات من /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  لاحظ أنك تضمّن المسار في هذا الأمر.
لتثبيت apigee-service باستخدام خادم الويب Nginx:
1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم ويب Nginx" في تثبيت الأداة المساعدة Edge apigee-setup.
3. على العقدة البعيدة، ثبِّت الأداة Edge apigee-service والتبعيات:
  > sudo bash /tmp/bootstrap_4.16.09.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 في <inst_dir>/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 في <inst_dir>/apigee/apigee-setup/bin.
3. إذا ثبَّتْت الإصدار 4.16.05 مباشرةً أو من خلال تحديث، عليك تحديث أداة apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  يؤدي هذا التحديث لـ apigee-service إلى تثبيت أداة update.sh في <inst_dir>/apigee/apigee-setup/bin.
استنادًا إلى الإصدار الحالي من Edge، عليك تثبيت أو تحديث أداة apigee-validate على خادم الإدارة.
1. إذا كنت تستخدِم حاليًا الإصدار 4.16.05 من Edge: عدِّل الأداة apigee-validate على Management Server:
  > /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-verifyate يتطلب استخدام السمات التالية:
  APIGEE_ADMINPW=sysAdminPword
  MP_POD=gateway
  Region=dc-1
  
  في هذا الإصدار، لا يتطلب ملف الإعداد سوى السمة APIGEE_ADMINPW. يمكنك إزالة الموقعَين الآخرين من الملف.
عدِّل الأداة apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
شغِّل الأداة update على العقد بالترتيب الموضّح أدناه في "ترتيب تعديل الجهاز" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

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

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

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

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

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