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

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

Edge for Private Cloud - الإصدار 4.17.09

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

يمكنك تحديث Apigee Edge الإصدار 4.17.01.0x/4.17.05.0x إلى 4.17.09 باستخدام هذا الإجراء.

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

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

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

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

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

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

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

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

الإضافة المطلوبة لمعلَمة الإعداد SMTPMailFROM

أضاف الإصدار 4.17.05 من Edge مَعلمة جديدة مطلوبة إلى ملف الإعداد الذي يتم استخدامه عند تفعيل خادم SMTP. إذا كنت بصدد التحديث من الإصدار 4.17.01، يجب ضبط SMTPMailFROM في ملف الإعداد عند تفعيل خادم SMTP.

أضاف الإصدار 4.17.09 من واجهة برمجة التطبيقات BaaS أيضًا دعمًا للخاصية SMTPMailFROM. عند تعديل BaaS لواجهة برمجة التطبيقات من 4.17.01 أو 4.17.05، يجب ضبط SMTPMailFROM في ملف الإعداد.

ويكون لهذه المعلمة الشكل التالي:

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

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

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

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

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

> /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

وفي حال توفُّرها، أوقِف أي مهام CRON تم ضبطها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
سجِّل الدخول إلى العُقدة كجذر لتثبيت Edge RPMs.
ملاحظة: على الرغم من أنّ تثبيت RPM يتطلب الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون الوصول إلى الجذر.
ثبِّت yum-utils وyum-extension-priorities:
> sudo yum install yum-utils
> sudo yum install yum-extension-priorities.
أوقِف SELinux كما هو موضح في تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات Edge.
إذا كنت تقوم بالتثبيت على AWS، فشغِّل الأمر yum-configure-manager التالي:
> sudo yum-config-manager --enable rhui-ISSUE-rhel-server-extras rhui-ستعرض-rhel-server-optional
نزِّل ملف Edge 4.17.09 bootstrap_4.17.09.sh من أجل /tmp/bootstrap_4.17.09.sh:
> curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/1tstrap_9.sh
ثبِّت الأداة المساعدة Edge 4.17.09 apigee-service والتبعيات:
> sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

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

I = تثبيت OpenJDK 1.8 (الإعداد التلقائي)
C = المتابعة بدون تثبيت Java
Q = إنهاء. للاستفادة من هذا الخيار، عليك تثبيت Java بنفسك.
استخدِم apigee-service لتحديث الأداة apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
حدِّث أداة apigee-validate على خادم الإدارة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-refresh update
حدِّث الأداة المساعدة apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
شغِّل الأداة المساعدة للتحديث على العُقد بالترتيب الموضح أدناه في قسم "ترتيب تحديث الجهاز" أدناه:
> /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
اختبر التحديث من خلال تشغيل أداة التحقق من واجهة برمجة التطبيقات على خادم الإدارة، كما هو موضح في اختبار التثبيت.

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

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

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

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

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

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

أنشِئ مستودعًا محليًا للإصدار 4.17.09 كما هو موضَّح في "إنشاء مستودع Apigee محلي" في تثبيت أداة Edge apigee-setup.
ملاحظة: إذا كان لديك حاليًا الإصدار 4.17.01/4.17.05 من الريبو، يمكنك إضافة الريبو 4.17.09 إليه كما هو موضَّح في القسم "تحديث مستودع Apigee محليًا" في تثبيت الأداة المساعدة لإعداد واجهة Edge apigee.
لتثبيت apigee-service من ملف .tar:
1. في العقدة التي تتضمن repo المحلي، استخدِم الأمر التالي لتجميع repo المحلي في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-service package
2. انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى الدليل /tmp على العقدة الجديدة.
3. في العقدة الجديدة، أزِل الملف إلى دليل /tmp:
  > tar -xzf apigee-4.17.09.tar.gz
  
  ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف .tar. على سبيل المثال /tmp/repos.
4. عليك تثبيت الأداة المساعدة Edge apigee-service والتبعيات من /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  لاحِظ أنّك تُدرِج المسار إلى دليل الأمر repos هذا.
لتثبيت خدمة apigee باستخدام خادم الويب Nginx:
1. اضبط خادم الويب Nginx كما هو موضّح في القسم "التثبيت من المخزن باستخدام خادم الويب Nginx" في تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات Edge.
2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.17.09.sh إلى /tmp/bootstrap_4.17.09.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepot.
3. في العقدة البعيدة، ثبِّت الأداة المساعدة Edge apigee-service والتبعيات:
  > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord apigeepassword=pWord
استخدِم apigee-service لتحديث الأداة apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
حدِّث أداة apigee-validate على خادم الإدارة.
> /opt/apigee/apigee-service/bin/apigee-service apigee- التسوّق تحديث
حدِّث الأداة المساعدة apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
شغِّل الأداة المساعدة للتحديث على العُقد بالترتيب الموضح أدناه في قسم "ترتيب تحديث الجهاز" أدناه:
> /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
اختبر التحديث من خلال تشغيل أداة التحقق من واجهة برمجة التطبيقات على خادم الإدارة، كما هو موضح في اختبار التثبيت.

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

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

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

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