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

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

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

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

يمكنك تحديث الإصدار 4.16.01.0x و4.16.05.x من Apigee Edge إلى الإصدار 4.17.01 باستخدام هذا الإجراء.

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

يمكنك نقل الإصدار 4.15.07 إلى الإصدار 4.16.01 من Apigee Edge.
إذا كان لديك إصدار Edge سابق إلى الإصدار 4.15.07، فيجب عليك أولاً الانتقال إلى إلى الإصدار 4.15.07 ثم إلى الإصدار 4.16.01.
- إذا كنت بصدد نقل البيانات من الإصدار 4.14.04 أو إصدار أحدث من Edge: انتقِل إلى الإصدار مباشرةً. 4.15.07.
- في حالة النقل من الإصدار 4.14.01 من Edge: يجب عليك الانتقال أولاً إلى الإصدار 4.14.04، ثم الانتقال إلى الإصدار 4.15.07.

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

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

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

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

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

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

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

> rpm -qa |grep apigee-zookeeper

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

apigee-zookeeper-3.4.5-1.0.905

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

مطلوب لتفعيل مستودع EPEL

يجب تفعيل الحزم الإضافية لـ Enterprise Linux (أو EPEL) لتثبيت Edge أو تحديثه. يعتمد الأمر الذي تستخدمه على الإصدار الذي تستخدمه من RedHat/CentOS:

لأجهزة RedHat/CentOS 7.x:
> wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; دورة في الدقيقة - إيفا epel-release-latest-7.noarch.rpm
لأجهزة RedHat/CentOS 6.x:
wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; دورة في الدقيقة - إيفا epel-release-latest-6.noarch.rpm

مطلوب في حال التحديث عند استخدام مصادقة خارجية

يمكنك دمج خدمة دليل خارجي في خدمة Apigee Edge Private Cloud حالية. التثبيت. تم تصميم هذه الميزة للعمل مع أي خدمة دليل تدعم LDAP، مثل Active Directory وOpenLDAP وغير ذلك. يسمح حل LDAP الخارجي للنظام المشرفين بإدارة بيانات اعتماد المستخدم من خدمة إدارة دليل مركزية، خارجية عن أنظمة مثل Apigee Edge التي تستخدمها.

عرض مصادر خارجية إعدادات المصادقة لمزيد من المعلومات.

عند تفعيل المصادقة الخارجية، يستخدم معظم العملاء حساب SAM للدليل النشط كاسم مستخدم للمصادقة، بدلاً من عنوان البريد الإلكتروني الذي يستخدمه خادم Edge OpenLDAP.

في حال الدمج مع خدمة دليل خارجي، أضِف السطر التالي إلى ملف التهيئة عند تحديث Edge إلى 4.17.01:

IS_EXTERNAL_AUTH="true"

يهيئ هذا السطر Edge لدعم اسم الحساب، بدلاً من عنوان البريد الإلكتروني، كـ اسم المستخدم.

الترقية المطلوبة إلى Qpid 1.35

يحتوي هذا الإصدار على تحديث مطلوب لمعيار Qpid 1.35. كجزء من تحديث عقدة Qpid، يمكنك يجب أن:

منع أجهزة التوجيه ومعالجات الرسائل مؤقتًا من الكتابة إلى عقدة Qpid من خلال حظر المنفذ 5672 على عقدة Qpid. يمكنك استخدام الأمر التالي لحظر هذا المنفذ على عقدة Qpid:
> sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
انتظر حتى تفرغ قائمة انتظار Qpid للرسائل للتأكد من أن عقدة Qpid قد عالجت جميع الرسائل. الرسائل قبل التحديث. استخدم الأمر التالي للتأكد من أن قائمة انتظار رسائل Qpid فارغة:
> qpid-stat -q
تعديل عقدة Qpid
يمكنك إزالة حظر المنفذ 5672 في عقدة Qpid للسماح بالوصول من أجهزة التوجيه ومعالجات الرسائل. يمكنك استخدام الأمر التالي لإزالة حظر هذا المنفذ:
> sudo iptables -F

تجدر الإشارة إلى أنّه إذا كنت تستخدم iptables لقواعد أخرى، يمكنك استخدام خيار -D لعكس تغيير محدّد:
> sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

تم وصف هذه العملية بالتفصيل أدناه لكل طوبولوجيا Edge.

الترقية المطلوبة للإصدار 9.4 من Postgres

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

وأثناء عملية التحديث، بينما تكون عُقد Postgres معطلة للحصول على التحديث، تتم إزالة لا تزال مكتوبة إلى عُقد Qpid. بعد تحديث عُقد Postgres واتصالها بالإنترنت مرة أخرى، ثم يتم دفع البيانات إلى عقد Postgres.

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

تثبيت Postgres جديد عقدة وضع الاستعداد

ينشئ هذا الإجراء خادم استعداد لـ Postgres على عقدة جديدة. تأكد من تثبيت رمز جديد خادم وضع استعداد Postgres للإصدار الحالي من Edge (4.16.01 أو 4.16.05)، وليس للإصدار 4.17.01.

لإجراء عملية التثبيت، استخدِم ملف الإعداد نفسه الذي استخدمته لتثبيت الإصدار الحالي. من Edge.

لإنشاء عقدة وضع الاستعداد جديدة في Postgres:

في صفحة Postgres الرئيسية الحالية، عدِّل /opt/apigee/customer/application/postgresql.properties لتعيين الرمز المميز التالي. إذا لم يكن هذا الملف متوفّرًا، أنشئه:

conf_pg_hba_replication.connection=host واجهة برمجة التطبيقات للنسخ المتماثل existing_slave_ip/32 Trust\ \nالنسخ المتماثل للمضيف apigee new_slave_ip/32Trust

حيث يكون existing_slave_ip هو عنوان IP لنظام Postgres الحالي. خادم وضع الاستعداد وnew_slave_ip هو عنوان IP لوضع الاستعداد الجديد العقدة.
أعِد تشغيل apigee-postgresql. على خبير Postgres:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlreset
تحقَّق من إضافة عقدة وضع الاستعداد الجديدة من خلال عرض /opt/apigee/apigee-postgresql/conf/pg_hba.conf ملف على الصفحة الرئيسية. من المفترض أن تظهر لك السطور التالية في هذا الملف:
واجهة برمجة تطبيقات النسخ المتماثل للمضيف الحالية_slave_ip/32 Trust
نسخة طبق الأصل من المضيف apigee new_slave_ip/32Trust
تثبيت خادم وضع الاستعداد الجديد لـ Postgres:
1. عدّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
  
  # عنوان IP للعنوان الحالي الشريحة الرئيسية:
  PG_MASTER=192.168.56.103
  # عنوان IP لعقدة وضع الاستعداد الجديدة
  PG_STANDBY=192.168.56.102
2. تعطيل SELinux كما هو موضح في Install the Edge. أداة إعداد apigee.
3. نزِّل ملف Bootstrap_4.16.05.sh على Edge إلى /tmp/bootstrap_4.16.05.sh:
  > ضفيرة https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  
  ملاحظة: إذا كنت بصدد التحديث من الإصدار 4.16.01، يمكنك تنزيل ملف bootstrap.sh من Edge.
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
  
  تأكَّد من أنّ الجهاز في وضع الاستعداد.

إيقاف وظيفة Postgres العقدة

بعد اكتمال التحديث، عليك إيقاف عقدة وضع الاستعداد الجديدة:

تأكد من تشغيل Postgres:
> /opt/apigee/apigee-service/bin/apigee-all status

إذا كانت أداة Postgres ليست قيد التشغيل، عليك تشغيلها:
> /opt/apigee/apigee-service/bin/apigee-all start
يمكنك الحصول على المعرّف الفريد العالمي (UUID) لعقدة وضع الاستعداد الجديدة من خلال تشغيل أمر cURL التالي على الجهاز الجديد عقدة وضع الاستعداد:
> ضفيرة -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

من المفترض أن يظهر لك المعرّف الفريد العالمي للعقدة في نهاية الإخراج على النحو التالي:
"النوع" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
أوقِف عقدة وضع الاستعداد الجديدة من خلال تنفيذ الأمر التالي على عقدة وضع الاستعداد الجديدة:
> /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 نسخة طبق الأصل من واجهة برمجة التطبيقات existing_slave_ip/32 Trust
أعِد تشغيل apigee-postgresql في صفحة Postgres الرئيسية:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql rename
تحقَّق من إزالة عقدة وضع الاستعداد الجديدة من خلال عرض /opt/apigee/apigee-postgresql/conf/pg_hba.conf. ملف على الصفحة الرئيسية. من المفترض أن يظهر لك السطر التالي فقط في هذا الملف:
واجهة برمجة تطبيقات النسخ المتماثل للمضيف existing_slave_ip/32 Trust
احذف المعرّف الفريد العالمي لعقدة وضع الاستعداد من ZooKeeper من خلال إجراء إدارة Edge التالية طلب بيانات من واجهة برمجة التطبيقات على عقدة خادم الإدارة:
> ضفيرة -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. سهِّل على جهاز التوجيه الوصول إليه.
على عقدة موجه واحدة:
- قبل إجراء التحديث، تأكَّد من أنّه لا يمكن الوصول إلى جهاز التوجيه.
- بعد إجراء التحديث، يمكنك تسهيل الوصول إلى جهاز التوجيه.
في عقدة واحدة لمعالجة الرسائل:
- قبل التحديث، تأكد من عدم إمكانية الوصول إلى معالج الرسائل.
- بعد التحديث، يمكنك الوصول إلى معالج الرسائل.

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

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

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

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

إذا كنت تستخدم حاليًا تكرار وضع الاستعداد الرئيسي في Postgres، عليك تثبيت إصدار جديد من Postgres. عقدة وضع الاستعداد كما هو موضح أعلاه في تثبيت عقدة الاستعداد الجديدة لـ Postgres.
إيقاف أي مهام CRON تم ضبطها لتنفيذ عملية إصلاح على Cassandra، في حال توفّرها إلى ما بعد اكتمال التحديث.
سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
إيقاف SELinux كما هو موضح في Install the Edge apigee-setup .
نزِّل ملف bootstrap_4.17.01.sh من Edge 4.17.01 إلى /tmp/bootstrap_4.17.01.sh:
. > ضفيرة https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
تثبيت أداة apigee-service في Edge 4.17.01 التبعيات:
> sudo bash /tmp/bootstrap_4.17.01.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:
1. في حال تثبيت الإصدار 4.16.01 من خلال ترقية الإصدار 4.15.07.0x من Edge، يجب تثبيت أداة إعداد واجهة برمجة التطبيقات:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  
  يثبِّت هذا الأمر الأداة المساعدة update.sh في /opt/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:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  يثبّت هذا التحديث الذي تم إجراؤه على apigee-service الأداة update.sh في /opt/apigee/apigee-setup/bin.
3. إذا تم تثبيت الإصدار 4.16.05 مباشرةً أو عن طريق التحديث، يجب تحديث أداة إعداد apigee:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  
  يثبّت هذا التحديث الذي تم إجراؤه على apigee-service الأداة update.sh في /opt/apigee/apigee-setup/bin.
بناءً على الإصدار الذي تستخدمه حاليًا من Edge، يجب عليك إما تثبيت أو تحديث apigee-validate على خادم الإدارة.
1. إذا كنت تستخدم حاليًا Edge 4.16.05: حدِّث الأداة apigee-validate على الرابط. خادم الإدارة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
2. إذا كنت تستخدم حاليًا Edge 4.16.01: ثبِّت الأداة apigee-validate على خادم الإدارة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-Verifyate install
  
  ملاحظة: في حال تثبيت أداة apigee-validate في رسالة عقدة المعالج عند تثبيت 4.16.01، يمكنك تحديثها باستخدام الأمر التالي على هذه العقدة:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
  
  ومع ذلك، فاعتبارًا من الإصدار 4.16.05 والإصدارات الأحدث، تنصح Apigee بتثبيت واجهة برمجة التطبيقات أداة apigee-validate على خادم الإدارة.
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
شغِّل أداة التحديث على العُقد بالترتيب الموضح أدناه في "ترتيب الجهاز تحديث" أدناه:
> /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) على خادم الإدارة، كما هو موضح في اختبار التثبيت.
في حال تثبيت عقدة وضع الاستعداد جديدة من Postgres، يجب فصل العقدة كما هو موضح أعلاه في إيقاف عقدة Postgres.

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

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

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

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

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

للتحديث من مستودع محلي 4.17.01:

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

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

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

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