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

تحديث Apigee Edge 4.16.05.x إلى الإصدار 4.16.05

Edge for Private Cloud الإصدار 4.16.05

يحتوي هذا المستند على الإجراء الذي تستخدمه لتحديث تثبيت 4.16.05 الحالي لاستخدام أحدث ملفات RPM وملفات الدعم من Apigee. يستخدم هذا الإجراء الأداة المساعدة update.sh لإجراء التحديث.

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

يمكنك فقط تحديث إصدار Apigee Edge الحالي 4.16.05.x إلى أحدث إصدار 4.16.05.

إذا كنت تستخدم حاليًا الإصدار 4.16.01.0x من Edge أو إصدارًا أقدم، عليك أولاً نقل البيانات إلى الإصدار 4.16.05. يُرجى الاطّلاع على تحديث Apigee Edge من الإصدار 4.16.01 إلى الإصدار 4.16.05 للحصول على معلومات حول كيفية نقل البيانات إلى الإصدار 4.16.05.

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

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

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

متطلبات مساحة القرص للتحديث

تأكَّد من توفُّر مساحة خالية على القرص لا تقل عن 1 غيغابايت قبل إجراء التحديث.

النشر التلقائي لإعدادات الموقع من الإصدار 4.16.05.x

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

المتطلبات الأساسية للتحديث

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

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

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

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

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

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

إذا تطلّب الفشل العودة إلى الإصدار السابق، يُرجى الاطّلاع على عملية العودة إلى الإصدار السابق 4.16.05.

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

بشكل تلقائي، تكتب الأداة المساعدة update.sh معلومات السجلّ في:

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

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

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

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

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

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

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

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

جعل جهاز التوجيه ومعالج الرسائل غير قابلين للوصول

في إعدادات الإنتاج، سيكون لديك عدة أجهزة توجيه ومعالجات رسائل لتحقيق الأداء الأمثل، ويجب تفعيل/إيقاف إمكانية الوصول إلى أجهزة التوجيه ومعالجات الرسائل هذه قبل التحديث أو بعده.

يضبط طلب البيانات التالي من واجهة برمجة التطبيقات عقدة على أنّها قابلة للوصول أو غير قابلة للوصول:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

حيث UUID هو المعرّف الفريد العالمي (UUID) لمعالج الرسائل أو جهاز التوجيه، ويتم ضبط reachable على true أو false.

إذا كنت بحاجة إلى تحديد المعرّف الفريد العالمي (UUID) لجهاز التوجيه، استخدِم أمر cURL التالي:

> curl http://<routerIP>:8081/v1/servers/self

إذا كنت بحاجة إلى تحديد المعرّف الفريد العالمي (UUID) لمعالج الرسائل، استخدِم أمر cURL التالي:

> curl http://<mpIP>:8082/v1/servers/self

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

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

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

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

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

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

في حال توفّر أي مهام CRON تم ضبطها لإجراء عملية إصلاح على Cassandra، عليك إيقافها إلى أن يكتمل التحديث.
سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حزم RPM في Edge
ملاحظة: على الرغم من أنّ تثبيت حزم RPM يتطلب الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون الوصول إلى الجذر.
أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.
امسح جميع ذاكرات التخزين المؤقت في Yum:
> sudo yum clean all
نزِّل أحدث ملف 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
حدِّث أداة apigee-service والتبعيات في Edge:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان تلقيتهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخالها.
استخدِم apigee-service لتحديث أداة apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

يؤدي هذا التحديث إلى apigee-service إلى تثبيت أداة update.sh في /<inst_dir>/apigee/apigee-setup/bin.
شغِّل أداة التحديث المساعدة على العُقد بالترتيب الموضَّح أدناه في "ترتيب تحديث الجهاز" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

استخدِم الخيار "‎-c" لتحديد المكوّن المطلوب تحديثه. تشمل قائمة المكوّنات المحتملة ما يلي:
- ldap = OpenLDAP
- cs = Cassandr
- ‫zk‏ = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =All Edge components except Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
- ui = Edge UI
- all = update all components on machine (only use for an Edge aio installation profile or an API BaaS asa installation profile)
- e = ElasticSearch
- b = حزمة API BaaS
- p = بوابة API BaaS
- ‫ebp = ‏ElasticSearch وAPI BaaS Stack وAPI BaaS Portal على العقدة نفسها
اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate، اختبار التثبيت.

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

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

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

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

للتحديث من مستودع محلي للإصدار 4.16.05:

تأكَّد من توفّر مستودع محلي للإصدار 4.16.05 على النحو الموضّح في تثبيت مكوّنات Edge على عقدة.
حدِّث المستودع المحلي:
1. نزِّل أحدث ملف 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
2. نفِّذ المزامنة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
لتثبيت apigee-service من ملف ‎ .tar:
1. في العقدة التي تحتوي على المستودع المحلي، استخدِم الأمر التالي لإنشاء حزمة للمستودع المحلي في ملف ‎ .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. انسخ ملف ‎ .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى الدليل ‎/tmp على العقدة الجديدة.
3. في العقدة الجديدة، فُكّ ضغط الملف إلى الدليل ‎ /tmp:
  > tar -xzf apigee-4.16.05.tar.gz
  
  ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف ‎ .tar. على سبيل المثال، ‎ /tmp/repos.
4. سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم RPM في Edge
  ملاحظة: على الرغم من أنّ تثبيت حِزم RPM يتطلّب الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون الوصول إلى الجذر.
5. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.
6. ثبِّت أداة apigee-service في Edge والتبعيات من /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  يُرجى ملاحظة أنك تُدرج المسار إلى دليل المستودعات في هذا الأمر.
لتثبيت apigee-service باستخدام خادم الويب Nginx:
1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب Nginx" في تثبيت مكوّنات Edge على عقدة.
2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.16.05.sh إلى ‎/tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان حددتهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة المستودع.
3. سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم RPM في Edge
  ملاحظة: على الرغم من أنّ تثبيت حِزم RPM يتطلّب الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون الوصول إلى الجذر.
4. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.
5. على العقدة البعيدة، ثبِّت أداة apigee-service في Edge والتبعيات:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  حيث uName:pWord هما اسم المستخدم وكلمة المرور للمستودع.
في حال توفّر أي مهام CRON تم ضبطها لإجراء عملية إصلاح على Cassandra، عليك إيقافها إلى أن يكتمل التحديث.
استخدِم apigee-service لتحديث أداة apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

يؤدي هذا التحديث إلى apigee-service إلى تثبيت أداة update.sh في <inst_dir>/apigee/apigee-setup/bin.
شغِّل أداة التحديث المساعدة على العُقد بالترتيب الموضَّح أدناه في "ترتيب تحديث الجهاز" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

استخدِم الخيار "‎-c" لتحديد المكوّن المطلوب تحديثه. تشمل قائمة المكوّنات المحتملة ما يلي:
- ldap = OpenLDAP
- cs = Cassandr
- ‫zk‏ = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =All Edge components except Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server
- ui = Edge UI
- all = update all components on machine (only use for an Edge aio installation profile or an API BaaS asa installation profile)
- e = ElasticSearch
- b = حزمة API BaaS
- p = بوابة API BaaS
- ‫ebp = ‏ElasticSearch وAPI BaaS Stack وAPI BaaS Portal على العقدة نفسها
اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate، اختبار التثبيت.

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

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

يجب تحديث جميع عُقد Cassandra وZooKeeper قبل تحديث أي عُقد أخرى.
يجب تحديث جميع عُقَد qpidd وpostgresql قبل تحديث أيّ من عُقَد "الموجّه" و"معالج الرسائل".
بالنسبة إلى أي جهاز يتضمّن مكوّنات Edge متعددة (خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres)، استخدِم الخيار "‎-c edge" لتحديثها جميعًا في الوقت نفسه.
إذا كانت إحدى الخطوات تحدّد أنّه يجب تنفيذها على أجهزة متعددة، نفِّذها بالترتيب المحدّد للأجهزة.
ما مِن خطوة منفصلة لتعديل ميزة تحقيق الربح. ويتم تعديلها عند تحديد الخيار "-c edge".
بعد تحديث عقدة جهاز توجيه، يجب إزالة جميع الملفات من الدليل /opt/nginx/conf.d، ثم إعادة تشغيل جهاز التوجيه.