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

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

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

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

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

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

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

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

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

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

تحذير: لا يتوافق هذا الإصدار من Edge مع الإصدار JDK 7. إذا كنت حاليًا باستخدام JDK 7، يجب الترقية إلى JDK 8. في حالة العودة إلى الإصدار السابق من تثبيت Edge 4.16.05، يمكنك يمكنك إعادة ضبط Edge بشكل اختياري لاستخدام Java JDK 7.

خفض مستوى وصول مدير حديقة الحيوان

وإصدار 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.948. وهذا يمنع من ترقية Zookeeper إلى إصدار أحدث من 4.16.01. طريقة تحريف هذا الموقف هو تشغيل yum الأقل تكلفة apigee-zookeeper قبل تحديث Zookeeper.

يمكنك التحقق من إصدار Zookeeper باستخدام الأمر التالي:

> rpm -qa |grep apigee-zookeeper

في حال كان هذا الأمر يعرض إصدار Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

بعد ذلك، يجب الرجوع إلى إصدار سابق.

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

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

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

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

تحديث الأداة المساعدة للتحقق من صحة واجهة برمجة التطبيقات API

في الإصدار 4.16.01، تم تثبيت أداة apigee-validate وتشغيلها على رسالة عقدة معالِج البيانات. في الإصدار 4.16.05، تم إيقاف أداة apigee-validate تحديث للتشغيل على العقدة Management Server.

عند التحديث إلى الإصدار 4.16.05، يتوفّر لك خياران لتحديث أداة apigee-validate:

يُنصَح باستخدام Apigee - لتثبيت أداة apigee-validate وتشغيلها على عقدة خادم الإدارة.

يمكنك اختياريًا إلغاء تثبيت أداة apigee-validate من عُقد معالج الرسائل. إذا تركته في عقدة معالج الرسائل، فيجب تحديثها إلى 4.16.05.
بدلاً من ذلك، يمكنك تحديث أداة apigee-validate على عقدة معالج الرسائل، وقم بتشغيلها من هناك. ومع ذلك، تنصحك Apigee بتثبيت من خادم الإدارة.

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

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

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

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

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

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

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

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

إيقاف أي مهام CRON تم ضبطها لتنفيذ عملية إصلاح على Cassandra، في حال توفّرها إلى ما بعد اكتمال التحديث.
سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPMs.
ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
إيقاف SELinux كما هو موضح في Install the Edge apigee-setup .
نزِّل ملف bootstrap_4.16.05.sh في Edge 4.16.05 على /tmp/bootstrap_4.16.05.sh:
. > ضفيرة https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
تثبيت أداة apigee-service في Edge 4.16.05 التبعيات:
> sudo bash /tmp/bootstrap_4.16.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 بنفسك.
استخدِم apigee-service من أجل: تعديل apigee-setup فائدة:
1. في حال تثبيت الإصدار 4.16.01 من خلال ترقية الإصدار 4.15.07.0x من Edge، يجب عليك تثبيت الأداة المساعدة apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service تثبيت apigee-setup
  يثبّت هذا الأمر الأداة المساعدة 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
  يثبّت هذا التحديث لخدمة واجهة برمجة التطبيقات الأداة update.sh في <inst_dir>/apigee/apigee-setup/bin.
تثبيت apigee-validate على خادم الإدارة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-integerate install
ملاحظة: في حال تثبيت أداة apigee-validate على عقدة معالج الرسائل، يمكنك تحديثها باستخدام الأمر التالي في تلك العقدة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
ومع ذلك، بالنسبة إلى الإصدار 4.16.05، تنصح Apigee بتثبيت أداة التحقق من صحة apigee وتشغيلها على خادم الإدارة.
عدِّل ملف الإعداد الذي تم تمريره إلى الأداة apigee-validate. في جلسة المعمل، إصدار Edge السابق، كان ملف الإعداد الذي تستخدمه ميزة apigee-validate يتطلب السمات التالية:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
Region=dc-1
في هذا الإصدار، لا يتطلب ملف الإعداد سوى السمة APIGEE_ADMINPW. يمكنك إزالة خاصيتين أخريين من الملف.
شغِّل أداة التحديث على العُقد بالترتيب الموضّح أدناه في قسم "ترتيب الجهاز". تَحْدِيثْ" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
إن المتطلب الوحيد في ملف التهيئة هو أن يكون ملف التهيئة قابلاً للوصول أو قابلة للقراءة بواسطة "apigee" المستخدم. على سبيل المثال، ضع الملف في دليل /tmp على العقدة.
استخدِم الخيار "-c" لتحديد المكوِّن المطلوب تحديثه. قائمة الخيارات المحتملة تشمل المكونات ما يلي:
- ldap = OpenLDAP
- cs = كاساندرا
- zk = حديقة الحيوانات
- qpid = qpidd
- ps = postgresql
- edge =All Edge باستثناء Edge UI [خادم الإدارة، ومعالج الرسائل، وجهاز التوجيه، وخادم QPID، خادم Postgres
- ui = واجهة مستخدم Edge
- all = تحديث الكل المكونات على الجهاز (يُستخدم فقط لملف تعريف تثبيت Edge aio أو واجهة برمجة التطبيقات BaaS asa ملف التثبيت)
- e = ElasticSearch
- b = حزمة BaaS لواجهة برمجة التطبيقات
- p = BaaS لواجهة برمجة التطبيقات البوابة
- ebp = ElasticSearch, واجهة برمجة التطبيقات BaaS Stack وبوابة BaaS لواجهة برمجة التطبيقات على العقدة نفسها
اختبر التحديث عن طريق تشغيل أداة التحقق من صحة واجهة برمجة التطبيقات (apigee) على خادم الإدارة، كما هو موضح في اختبار التثبيت.

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

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

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

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

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

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

أنشِئ مستودعًا محليًا للإصدار 4.16.05 كما هو موضَّح في قسم "إنشاء مستودع محلي في Apigee". في تثبيت Edge apigee-setup .
ملاحظة: إذا كان لديك مستودع 4.16.01 حالي، يمكنك إضافة الإصدار 4.16.05. والمستودع.
لتثبيت خدمة apigee من ملف .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. ثبّت أداة خدمة Edge apigee والتبعيات من /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  لاحظ أنك قمت بتضمين المسار إلى دليل repos في هذا الأمر.
لتثبيت خدمة apigee باستخدام خادم ويب Nginx:
1. قم بتهيئة خادم الويب Nginx كما هو موضح في "التثبيت من المستودع باستخدام Nginx webserver" في تثبيت Edge أداة إعداد apigee.
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. في العقدة البعيدة، عليك تثبيت أداة خدمة واجهة برمجة التطبيقات Edge والتبعيات:
  > sudo bash /tmp/bootstrap_4.16.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
  يثبّت هذا الأمر الأداة 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.
تثبيت أداة apigee-validate عقدة خادم الإدارة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-Verifyate install
ملاحظة: في حال تثبيت أداة apigee-validate على عقدة معالج الرسائل، يمكنك تحديثها باستخدام الأمر التالي في تلك العقدة:

> /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
في المقابل، بالنسبة إلى الإصدار 4.16.05، تنصح Apigee بتثبيت وتشغيل التحقق من صحة apigee على خادم الإدارة.
عدِّل ملف الإعداد الذي تم تمريره إلى الأداة apigee-validate. ضِمن إصدار Edge السابق، يتطلب ملف الإعداد الذي تستخدمه ميزة apigee-validate السمات التالية:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
Region=dc-1
في هذا الإصدار، لا يتطلب ملف الإعداد سوى السمة APIGEE_ADMINPW. يمكنك إزالة خاصيتين أخريين من الملف.
شغِّل أداة التحديث على العُقد بالترتيب الموضّح أدناه في قسم "ترتيب الجهاز". تَحْدِيثْ" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
إن المتطلب الوحيد في ملف التهيئة هو أن يكون ملف التهيئة قابلاً للوصول أو قابلة للقراءة بواسطة "apigee" المستخدم. على سبيل المثال، ضع الملف في دليل /tmp على العقدة.
استخدِم الخيار "-c" لتحديد المكوِّن المطلوب تحديثه. قائمة الخيارات المحتملة تشمل المكونات ما يلي:
- ldap = OpenLDAP
- cs = كاساندرا
- zk = حديقة الحيوانات
- qpid = qpidd
- ps = postgresql
- edge =All Edge باستثناء Edge UI [خادم الإدارة، ومعالج الرسائل، وجهاز التوجيه، وخادم QPID، خادم Postgres
- ui = واجهة مستخدم Edge
- all = تحديث الكل المكونات على الجهاز (يُستخدم فقط لملف تعريف تثبيت Edge aio أو واجهة برمجة التطبيقات BaaS asa ملف التثبيت)
- e = ElasticSearch
- b = حزمة BaaS لواجهة برمجة التطبيقات
- p = BaaS لواجهة برمجة التطبيقات البوابة
- ebp = ElasticSearch, واجهة برمجة التطبيقات BaaS Stack وبوابة BaaS لواجهة برمجة التطبيقات على العقدة نفسها
اختبر التحديث عن طريق تشغيل أداة التحقق من صحة واجهة برمجة التطبيقات (apigee) على خادم الإدارة، كما هو موضح في اختبار التثبيت.

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

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

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