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

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

Edge for Private Cloud، الإصدار 4.17.05

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

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

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

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

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

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

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

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

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

في حال إعداد أي مواقع من خلال تعديل ملفات .properties في .properties عندها يتم الاحتفاظ بالقيم من خلال التحديث.

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

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

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

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

يجب استيفاء المتطلبات الأساسية التالية قبل ترقية Apigee Edge:

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

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

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

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

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

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

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

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

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

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

إجراء التحديث إلى الإصدار 4.17.05 على عقدة ذات اتصال إنترنت خارجي

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

إيقاف أي مهام CRON تم ضبطها لتنفيذ عملية إصلاح على Cassandra، في حال توفّرها إلى ما بعد اكتمال التحديث.
سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
عطّل SELinux كما هو موضح في Install أداة Edge apigee-setup.
نزّل ملف Edge 4.17.05 bootstrap_4.17.05.sh إلى /tmp/bootstrap_4.17.05.sh:
. > ضفيرة 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 الصحيح:
> رائع في التثبيت apigee-qpidd --disablerepo=epel
استخدِم apigee-service من أجل: تعديل apigee-setup شركة الطاقة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
تعديل apigee-validate على خادم الإدارة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
تعديل apigee-provision شركة الطاقة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision
شغِّل أداة التحديث على العُقد بالترتيب الموضح أدناه في "ترتيب الجهاز تحديث" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

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

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

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

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

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

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

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

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

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

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

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

يعد ترتيب تحديث الأجهزة أثناء تثبيت Edge أمرًا مهمًا. الأكثر اعتبارات مهمة للتحديث هي:

يجب تحديث جميع عُقد Cassandra وZoKeeper قبل تحديث أي العقد الأخرى.
بالنسبة لأي جهاز يحتوي على عدة مكونات Edge (خادم الإدارة ومعالج الرسائل جهاز التوجيه، خادم QPID ولكن ليس خادم Postgres)، استخدم "-c Edge" خيار تحديثها جميعًا في في نفس الوقت.
إذا حددت الخطوة أنه يجب تنفيذها على أجهزة متعددة، فنفذها في ترتيب الجهاز المحدد.
ولا تتوفّر خطوة منفصلة لتعديل ميزة "تحقيق الربح". يتم تحديثه عند تحديد "-c حافة .
(CentOS-6.x وRedHat-6.x فقط) على جميع عُقد Qpid التي تتضمن اتصال إنترنت خارجي، فتأكد من تشغيل الأمر التالي لتنزيل إصدار Qpid الصحيح كما هو موضح أعلاه:
> لذيذ تثبيت apigee-qpidd --disablerepo=epel