يوضّح هذا القسم كيفية الترقية من الإصدار 4.19.06 أو 4.50.00 من Apigee Edge إلى الإصدار 4.51.00.
المستخدمون الذين يمكنهم إجراء التحديث
يجب أن يكون المستخدم الذي يُجري التحديث هو نفسه المستخدم الذي ثبَّت Edge في الأصل، أو مستخدمًا لديه إذن الوصول كجذر.
بعد تثبيت حِزم RPM لمتصفّح Edge، يمكن لأي مستخدم ضبطها.
ما هي المكوّنات التي يجب تحديثها؟
يجب تحديث جميع مكوّنات Edge. لا يتيح Edge إعدادًا يحتوي على مكوّنات من إصدارات متعددة.
النشر التلقائي لإعدادات الموقع
إذا ضبطت أي مواقع من خلال تعديل ملفات .properties في /opt/apigee/customer/application، سيتم الاحتفاظ بهذه القيم من خلال التحديث.
الترقية المطلوبة إلى Postgres 10.17
يتضمّن هذا الإصدار من Edge ترقية إلى Postgres 10.17. كجزء من هذه الترقية، يتم نقل جميع بيانات Postgres إلى Postgres 10.17.
تستخدم معظم أنظمة إنتاج Edge عقدتَي Postgres تم إعدادهما للنسخ المتماثل الرئيسي-الاحتياطي. أثناء عملية التحديث، عندما تكون عُقد Postgres متوقفة عن العمل لإجراء التحديث، لا تزال بيانات الإحصاءات تُكتب في عُقد Qpid. بعد تعديل عُقد Postgres وإعادة اتصالها بالإنترنت، يتم إرسال بيانات الإحصاءات إلى عُقد Postgres.
تعتمد طريقة إجراء تحديث Postgres على كيفية ضبط مساحة تخزين البيانات لعُقد Postgres:
- إذا كنت تستخدم ميزة "تخزين البيانات محليًا" لعُقد Postgres، عليك
تثبيت عقدة Postgres احتياطية جديدة طوال مدة الترقية. بعد اكتمال الترقية، يمكنك إيقاف عقدة Postgres الاحتياطية الجديدة.
يجب توفير عقدة Postgres الاحتياطية الإضافية إذا كنت بحاجة إلى التراجع عن التحديث لأي سبب. إذا اضطررت إلى التراجع عن التحديث، تصبح عقدة Postgres الاحتياطية الجديدة هي عقدة Postgres الرئيسية بعد التراجع. لذلك، عند تثبيت عقدة Postgres الاحتياطية الجديدة، يجب أن تكون على عقدة تستوفي جميع متطلبات الأجهزة لخادم Postgres، كما هو محدّد في متطلبات تثبيت Edge.
في إعدادات Edge التي تتضمّن عقدة واحدة وعقدتَين، وهي الطوبولوجيا المستخدَمة لإنشاء النماذج الأولية والاختبار، يكون لديك عقدة Postgres واحدة فقط. يمكنك تعديل عُقد Postgres هذه مباشرةً بدون الحاجة إلى إنشاء عقدة Postgres جديدة.
- إذا كنت تستخدم مساحة تخزين على الشبكة لعُقد Postgres، كما
تنصح Apigee، لن تحتاج إلى تثبيت عقدة Postgres جديدة. في
الإجراءات أدناه، يمكنك تخطّي الخطوات التي تحدّد تثبيت عقدة احتياطية جديدة في Postgres
وإيقافها لاحقًا.
قبل بدء عملية التحديث، عليك أخذ لقطة شبكة لمخزن البيانات الذي يستخدمه Postgres. بعد ذلك، في حال حدوث أي أخطاء أثناء التحديث واضطررت إلى التراجع، يمكنك استعادة عقدة Postgres من تلك اللقطة.
تثبيت عقدة احتياطية جديدة في Postgres
ينشئ هذا الإجراء خادم Postgres احتياطيًا على عقدة جديدة. تأكَّد من تثبيت خادم Postgres احتياطي جديد لإصدار Edge الحالي (4.19.06 أو 4.50.00)، وليس للإصدار 4.51.00.
لإجراء التثبيت، استخدِم ملف الإعداد نفسه الذي استخدمته لتثبيت الإصدار الحالي من Edge.
لإنشاء عقدة احتياطية جديدة في Postgres، اتّبِع الخطوات التالية:
- في قاعدة بيانات Postgres الرئيسية الحالية، عدِّل ملف
/opt/apigee/customer/application/postgresql.propertiesلضبط الرمز المميّز التالي. إذا لم يكن هذا الملف متوفّرًا، أنشئه:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
حيث existing_standby_ip هو عنوان IP لخادم Postgres الاحتياطي الحالي وnew_standby_ip هو عنوان IP للعقدة الاحتياطية الجديدة.
- أعِد تشغيل
apigee-postgresqlعلى Postgres الرئيسي:/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- تأكَّد من إضافة العقدة الاحتياطية الجديدة من خلال الاطّلاع على ملف
/opt/apigee/apigee-postgresql/conf/pg_hba.confفي العقدة الرئيسية. من المفترض أن تظهر لك الأسطر التالية في هذا الملف:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- ثبِّت خادم Postgres الاحتياطي الجديد:
- عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
# IP address of the current master: PG_MASTER=192.168.56.103 # IP address of the new standby node PG_STANDBY=192.168.56.102
- أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.
- نفِّذ أحد الإجراءات التالية، استنادًا إلى إصدار Edge الذي تتم الترقية منه:
- في حال الترقية من الإصدار 4.19.06 من Edge،
نزِّل ملف bootstrap_4.19.06.sh من Edge إلى
/tmp/bootstrap_4.19.06.sh:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
بعد ذلك، ثبِّت أداة Edge
apigee-serviceوالتبعيات:sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
- في حال الترقية من الإصدار 4.50.00 من Edge،
نزِّل ملف bootstrap_4.50.00.sh من Edge إلى
/tmp/bootstrap_4.50.00.sh:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
بعد ذلك، ثبِّت أداة Edge
apigee-serviceوالتبعيات:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- في حال الترقية من الإصدار 4.19.06 من Edge،
نزِّل ملف bootstrap_4.19.06.sh من Edge إلى
- استخدِم
apigee-serviceلتثبيت الأداة المساعدةapigee-setup:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- تثبيت Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- على عقدة الاستعداد الجديدة، نفِّذ الأمر التالي:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
تأكَّد من أنّه يشير إلى أنّه في وضع الاستعداد.
- عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
إجراء ترقية موضعية لـ Postgres
لإجراء ترقية موضعية إلى Postgres 10.17، اتّبِع الخطوات التالية:
- ترقية postgres على المضيف الرئيسي
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- نفِّذ أمر الإعداد على المضيف الرئيسي:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- نفِّذ أمر الضبط على المضيف الرئيسي:
apigee-service apigee-postgresql configure
- أعِد تشغيل المضيف الرئيسي:
apigee-service apigee-postgresql restart
- اضبطه كجهاز رئيسي:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- تأكَّد من بدء المضيف الرئيسي:
apigee-service apigee-postgresql wait_for_ready
- لإيقاف وضع الاستعداد:
apigee-service apigee-postgresql stop
- ترقية وضع الاستعداد
ملاحظة: إذا حدث خطأ في هذه الخطوة أو تعذّر تنفيذها، يمكن تجاهلها. سيحاول
update.shبدء تشغيل خادم الاستعداد باستخدام إعدادات غير صحيحة. إذا تمت ترقية تثبيت Postgres إلى الإصدار 10.17، يمكن تجاهل الخطأ./opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- تأكَّد من إيقاف وضع الاستعداد:
apigee-service apigee-postgresql stop
- أزِل الإعدادات الاحتياطية القديمة:
rm -rf /opt/apigee/data/apigee-postgresql/
- إعداد النسخ المتماثل على الخادم الاحتياطي:
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
بعد إكمال هذا الإجراء، ستبدأ عملية الاستعداد بنجاح.
إيقاف عقدة Postgres
بعد اكتمال التحديث، أوقِف عقدة الاستعداد الجديدة:
- تأكَّد من تشغيل Postgres:
/opt/apigee/apigee-service/bin/apigee-all status
إذا لم يكن Postgres قيد التشغيل، ابدأ تشغيله:
/opt/apigee/apigee-service/bin/apigee-all start
- احصل على المعرّف الفريد العالمي (UUID) للعقدة الاحتياطية الجديدة من خلال تنفيذ أمر
curlالتالي على العقدة الاحتياطية الجديدة:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
من المفترض أن يظهر لك معرّف UUID للعقدة في نهاية الناتج، بالشكل التالي:
"type" : [ "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 replication apigee existing_standby_ip/32 trust
- أعِد تشغيل apigee-postgresql على Postgres الرئيسي:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- تأكَّد من إزالة عقدة الاستعداد الجديدة من خلال الاطّلاع على ملف
/opt/apigee/apigee-postgresql/conf/pg_hba.confفي العقدة الرئيسية. من المفترض أن يظهر لك السطر التالي فقط في هذا الملف:host replication apigee existing_standby_ip/32 trust
- احذف معرّف UUID لعقدة الاستعداد من ZooKeeper من خلال إجراء طلب بيانات من واجهة برمجة التطبيقات لإدارة Edge التالي على عقدة خادم الإدارة:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
المتطلبات الأساسية للتحديث
يُرجى الاهتمام بالمتطلبات الأساسية التالية قبل ترقية Apigee Edge:
- الاحتفاظ بنسخة احتياطية من جميع العُقد
قبل التحديث، ننصحك بالاحتفاظ بنسخة احتياطية كاملة من جميع العُقد لأسباب تتعلّق بالسلامة. استخدِم الإجراء الخاص بإصدار Edge الحالي لإجراء عملية الاحتفاظ بنسخة احتياطية.يتيح لك ذلك وضع خطة احتياطية في حال عدم عمل التحديث إلى إصدار جديد بشكل صحيح. لمزيد من المعلومات حول الاحتفاظ بنسخة احتياطية، يُرجى الاطّلاع على الاحتفاظ بنسخة احتياطية واستعادة البيانات.
- التأكّد من تشغيل Edge
تأكَّد من أنّ Edge قيد التشغيل أثناء عملية التحديث باستخدام الأمر:/opt/apigee/apigee-service/bin/apigee-all status
واجهة مستخدم Edge الجديدة
يسرد هذا القسم الاعتبارات المتعلقة بواجهة مستخدم Edge. لمزيد من المعلومات، يُرجى الاطّلاع على واجهة مستخدم Edge الجديدة لـ Private Cloud.
تثبيت واجهة مستخدم Edge
بعد إكمال عملية التثبيت الأولية، تنصحك Apigee بتثبيت واجهة مستخدم Edge، وهي واجهة مستخدم محسّنة لمطوّري ومشرفي Apigee Edge for Private Cloud.
يُرجى العِلم أنّ واجهة مستخدم Edge تتطلّب إيقاف المصادقة الأساسية واستخدام IDP مثل SAML أو LDAP.
لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت واجهة مستخدم Edge الجديدة.
تحديث واجهة مستخدم Edge
لتحديث مكوّن واجهة مستخدم Edge، يُرجى مراعاة إصدار Edge for Private Cloud الذي تتم الترقية منه:
- من الإصدار 4.19.06 أو 4.50.00 إلى الإصدار 4.51.00 (مع تثبيت واجهة مستخدم Edge الجديدة): استخدِم
تعليمات الترقية في هذا القسم للمكوّن
edge-management-ui.
التحديث باستخدام بروتوكول mTLS في Apigee
لتحديث Apigee mTLS، اتّبِع الخطوات التالية:
العودة إلى إصدار سابق من التحديث
في حال تعذّر التحديث، يمكنك محاولة حلّ المشكلة، ثم تنفيذ
update.sh مرة أخرى. يمكنك تشغيل التحديث عدة مرات، وسيواصل التحديث
من حيث توقف في المرة الأخيرة.
إذا تطلّب الفشل العودة إلى الإصدار السابق، يُرجى الاطّلاع على العودة إلى الإصدار 4.51.00 للحصول على تعليمات مفصّلة.
تسجيل معلومات التحديث
تكتب الأداة المساعدة 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 لأجهزة التوجيه المتبقية.
- واصِل التحديث لأي أجهزة متبقية في عملية التثبيت.
يُرجى الانتباه إلى ما يلي قبل التحديث وبعده:
- في عقدة "الموجّه" و"معالج الرسائل" المجمّعة:
- قبل التحديث، يُرجى تنفيذ ما يلي:
- اجعل جهاز التوجيه غير قابل للوصول إليه.
- اجعل معالج الرسائل غير قابل للوصول.
- بعد التحديث، نفِّذ ما يلي:
- اجعل معالج الرسائل قابلاً للوصول إليه.
- تأكَّد من إمكانية الوصول إلى جهاز التوجيه.
- قبل التحديث، يُرجى تنفيذ ما يلي:
- على عُقد جهاز التوجيه الفردية:
- قبل التحديث، اجعل جهاز التوجيه غير قابل للوصول.
- بعد التحديث، اجعل جهاز التوجيه قابلاً للوصول إليه.
- على عُقد معالج الرسائل الفردية:
- قبل التحديث، اجعل معالج الرسائل غير قابل للوصول.
- بعد التحديث، اجعل معالج الرسائل قابلاً للوصول إليه.
استخدام ملف إعداد للتثبيت غير التفاعلي
يجب تمرير ملف إعداد للتثبيت غير التفاعلي إلى أمر التحديث. يجب أن يكون ملف الإعداد للتثبيت غير التفاعلي هو نفسه الذي استخدمته لتثبيت الإصدار 4.19.06 أو 4.50.00 من Edge.
التحديث إلى الإصدار 4.51.00 على عقدة تتضمّن اتصالاً خارجيًا بالإنترنت
اتّبِع الإجراء التالي لتحديث مكوّنات Edge على عقدة:
- في حال توفّر أي وظائف
cronتم ضبطها لإجراء عملية إصلاح على Cassandra، عليك إيقافها إلى أن يكتمل التحديث. - سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم Edge RPM.
- ثبِّت
yum-utilsوyum-plugin-priorities:sudo yum install yum-utils
sudo yum install yum-plugin-priorities - أوقِف SELinux كما هو موضّح في تثبيت أداة إعداد Edge apigee.
- في حال التثبيت على Oracle 7.x، نفِّذ الأمر التالي:
sudo yum-config-manager --enable ol7_optional_latest
- في حال التثبيت على AWS، نفِّذ أوامر
yum-configure-managerالتالية:yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - نزِّل ملف Edge 4.51.00
bootstrap_4.51.00.shإلى/tmp/bootstrap_4.51.00.sh:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- ثبِّت الأداة المساعدة Edge 4.51.00
apigee-serviceوالتبعيات من خلال تنفيذ الأمر التالي:sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان تلقّيتهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخاله.
يتحقّق المثبِّت تلقائيًا من تثبيت Java 1.8. وإذا لم يكن مثبّتًا، ستتولى أداة التثبيت تثبيته نيابةً عنك.
استخدِم الخيار
JAVA_FIXلتحديد كيفية التعامل مع تثبيت Java. تتّخذ السمةJAVA_FIXالقيم التالية:I: تثبيت OpenJDK 1.8 (تلقائي)C: المتابعة بدون تثبيت JavaQ: الخروج بالنسبة إلى هذا الخيار، يجب تثبيت 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-validate update
- عدِّل الأداة المساعدة
apigee-provisionعلى خادم الإدارة، كما هو موضّح في المثال التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- شغِّل الأداة المساعدة
updateعلى العُقد من خلال تنفيذ الأمر التالي:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
ويمكنك تنفيذ ذلك بالترتيب الموضّح في ترتيب تحديث الجهاز.
المكان:
- component هو مكوّن Edge المطلوب تحديثه. تشتمل القيم المحتملة ما يلي:
-
cs: كاساندرا edge: جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgresldap: OpenLDAP-
ps: postgresql -
qpid: qpidd sso: الدخول الموحّد (SSO) في Apigee (إذا ثبّتّ الدخول الموحّد)ue: واجهة مستخدم Edge الجديدةui: واجهة مستخدم Edge الكلاسيكية-
zk: حارس حديقة حيوانات
-
- configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكوّنات Edge أثناء تثبيت الإصدار 4.19.06 أو 4.50.00.
يمكنك تشغيل
update.shعلى جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف شخصي لتثبيت Edge All-in-One (AIO). على سبيل المثال:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component هو مكوّن Edge المطلوب تحديثه. تشتمل القيم المحتملة ما يلي:
- أعِد تشغيل مكوّن واجهة مستخدم Edge على جميع العُقد التي تشغّله، إذا لم يسبق لك ذلك:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- اختبِر التحديث من خلال تشغيل الأداة المساعدة
apigee-validateعلى خادم الإدارة، كما هو موضّح في اختبار التثبيت.
إذا قررت لاحقًا التراجع عن التحديث، استخدِم الإجراء الموضّح في التراجع عن الإصدار 4.51.00.
التحديث إلى الإصدار 4.51.00 من مستودع محلي
إذا كانت عُقد Edge خلف جدار حماية أو تم منعها بطريقة أخرى من الوصول إلى مستودع Apigee عبر الإنترنت، يمكنك إجراء التحديث من مستودع محلي أو نسخة مطابقة من مستودع Apigee.
بعد إنشاء مستودع Edge محلي، يتوفّر لك خياران لتحديث Edge من المستودع المحلي:
- أنشئ ملف .tar للمستودع، وانسخ ملف .tar إلى عقدة، ثم حدِّث Edge من ملف .tar.
- ثبِّت خادم ويب على العقدة التي تحتوي على المستودع المحلي حتى تتمكّن العُقد الأخرى من الوصول إليه. توفّر Apigee خادم الويب NGINX لتستخدمه، أو يمكنك استخدام خادم الويب الخاص بك.
للتحديث من مستودع محلي للإصدار 4.51.00:
- أنشئ مستودعًا محليًا للإصدار 4.51.00 كما هو موضّح في "إنشاء مستودع Apigee محلي" في تثبيت أداة apigee-setup في Edge.
- لتثبيت apigee-service من ملف .tar:
- On the node with the local repo, use the following command to package the local repo
into a single .tar file named
/opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى
دليل
/tmpعلى العقدة الجديدة. - على العقدة الجديدة، فُكّ ضغط الملف إلى الدليل
/tmp:tar -xzf apigee-4.51.00.tar.gz
ينشئ هذا الأمر دليلاً جديدًا باسم
reposفي الدليل الذي يحتوي على ملف .tar. على سبيل المثال:/tmp/repos. - ثبِّت أداة Edge
apigee-serviceوالتبعيات من/tmp/repos:sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
لاحظ أنك تقوم بتضمين المسار إلى دليل المستودعات في هذا الأمر.
- On the node with the local repo, use the following command to package the local repo
into a single .tar file named
- لتثبيت apigee-service باستخدام خادم الويب NGINX:
- اضبط خادم الويب NGINX كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب NGINX" في تثبيت أداة apigee-setup في Edge.
- على العقدة البعيدة، نزِّل ملف Edge
bootstrap_4.51.00.shإلى/tmp/bootstrap_4.51.00.sh:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان حددتهما سابقًا للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة المستودع.
- على العقدة البعيدة، ثبِّت أداة Edge
apigee-setupوالتبعيات:sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
حيث uName: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-validate update
- عدِّل الأداة المساعدة
apigee-provisionعلى خادم الإدارة، كما هو موضّح في المثال التالي:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- شغِّل الأداة المساعدة
updateعلى العُقد بالترتيب الموضَّح في ترتيب تحديث الجهاز:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
المكان:
- component هو مكوّن Edge المطلوب تحديثه. يمكنك عادةً تعديل المكوّنات التالية:
-
cs: كاساندرا edge: جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgresldap: OpenLDAP-
ps: postgresql -
qpid: qpidd sso: الدخول الموحّد (SSO) في Apigee (إذا ثبّتّ الدخول الموحّد)- واجهة مستخدم Edge الجديدة في
ue ui: واجهة مستخدم Edge الكلاسيكية-
zk: حارس حديقة حيوانات
-
- configFile هو ملف الإعداد نفسه الذي استخدمته من أجل تحديد مكوّنات Edge أثناء تثبيت الإصدار 4.19.06 أو 4.50.00.
يمكنك تشغيل
update.shعلى جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف شخصي لتثبيت Edge All-in-One (AIO). على سبيل المثال:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component هو مكوّن Edge المطلوب تحديثه. يمكنك عادةً تعديل المكوّنات التالية:
- أعِد تشغيل مكوّنات واجهة المستخدم على جميع العُقد التي تشغّلها، إذا لم تكن قد فعلت ذلك من قبل:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- اختبِر التحديث من خلال تشغيل الأداة المساعدة
apigee-validateعلى خادم الإدارة، كما هو موضّح في اختبار التثبيت.
إذا قررت لاحقًا التراجع عن التحديث، استخدِم الإجراء الموضّح في التراجع عن الإصدار 4.51.00.
ترتيب تحديث الأجهزة
يُعدّ ترتيب تحديث الأجهزة في عملية تثبيت Edge أمرًا مهمًا:
- يجب تحديث جميع عُقد Cassandra وZooKeeper قبل تحديث أي عُقد أخرى.
- بالنسبة إلى أي جهاز يتضمّن عدة مكوّنات Edge (خادم الإدارة، معالج الرسائل،
الموجّه، خادم QPID، ولكن ليس خادم Postgres)، استخدِم الخيار
-c edgeلتحديثها جميعًا في الوقت نفسه. - إذا كانت إحدى الخطوات تحدّد أنّه يجب تنفيذها على أجهزة متعدّدة، نفِّذها بالترتيب المحدّد للأجهزة.
- ليست هناك خطوة منفصلة لتعديل ميزة تحقيق الربح. ويتم تعديلها عند تحديد الخيار
-c edge.
ترقية مستقلة لعقدة واحدة
لترقية إعداد مستقل من عقدة واحدة إلى الإصدار 4.51.00:
- تعديل جميع المكوّنات:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (في حال تثبيت
apigee-adminapi) تم تحديث أداةapigee-adminapiالمساعدة:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
ترقية مستقلة من عقدتَين
حدِّث المكوّنات التالية لتثبيت مستقل على عقدتَين:
يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.
- تحديث Cassandra وZooKeeper على الجهاز 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- تحديث Qpid وPostgres على الجهاز 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
- تعديل LDAP على الجهاز 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- تحديث مكوّنات Edge على الجهازَين 2 و1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- تعديل واجهة المستخدم على الجهاز 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (في حال تثبيت
apigee-adminapi) تم تحديث أداةapigee-adminapiالمساعدة على الجهاز 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (في حال تثبيت Apigee SSO) حدِّث Apigee SSO على الجهاز 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.
- أعِد تشغيل مكوّن واجهة مستخدم Edge على الجهاز 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
ترقية 5 عُقد
عدِّل المكوّنات التالية لتثبيت 5 عُقد:
يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.
- تحديث Cassandra وZooKeeper على الأجهزة 1 و2 و3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- تحديث Qpid وPostgres على الجهاز 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- تحديث Qpid وPostgres على الجهاز 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- تعديل LDAP على الجهاز 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- تحديث مكوّنات Edge على الأجهزة 4 و5 و1 و2 و3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- تعديل واجهة مستخدم Edge:
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، عليك تحديث المكوّن
uiعلى الجهاز 1، كما هو موضّح في المثال التالي:/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- واجهة مستخدم Edge الجديدة: إذا ثبّتّ واجهة مستخدم Edge الجديدة، عليك تحديث مكوّن
ueعلى الجهاز المناسب (قد لا يكون الجهاز 1):/opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، عليك تحديث المكوّن
- (في حال تثبيت
apigee-adminapi) تم تحديث أداةapigee-adminapiالمساعدة على الجهاز 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (في حال تثبيت Apigee SSO) حدِّث Apigee SSO على الجهاز 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.
- أعِد تشغيل مكوّن واجهة المستخدم:
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل المكوّن
edge-uiعلى الجهاز 1، كما هو موضّح في المثال التالي:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- واجهة مستخدم Edge الجديدة: إذا ثبّت واجهة مستخدم Edge الجديدة، أعِد تشغيل مكوّن
edge-management-uiعلى الجهاز المناسب (قد لا يكون الجهاز 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل المكوّن
ترقية مجمّعة من 9 عُقد
عدِّل المكوّنات التالية لتثبيت مجموعة من 9 عُقد:
يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.
- تحديث Cassandra وZooKeeper على الأجهزة 1 و2 و3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- تحديث Qpid على الجهازين 6 و7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- تحديث Postgres على الجهاز 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- تحديث Postgres على الجهاز 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- تعديل LDAP على الجهاز 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- حدِّث مكوّنات Edge على الأجهزة 6 و7 و8 و9 و1 و4 و5 بهذا الترتيب:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- تعديل واجهة المستخدم الجديدة (
ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهاز 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (في حال تثبيت
apigee-adminapi) حدِّث الأداة المساعدةapigee-adminapiعلى الجهاز 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (في حال تثبيت Apigee SSO) حدِّث Apigee SSO على الجهاز 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.
- أعِد تشغيل مكوّن واجهة المستخدم:
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل المكوّن
edge-uiعلى الجهاز 1، كما هو موضّح في المثال التالي:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- واجهة مستخدم Edge الجديدة: إذا ثبّت واجهة مستخدم Edge الجديدة، أعِد تشغيل مكوّن
edge-management-uiعلى الجهاز المناسب (قد لا يكون الجهاز 1):/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل المكوّن
ترقية مجموعة من 13 عقدة
عدِّل المكوّنات التالية لتثبيت مجموعة من 13 عقدة:
يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.
- حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- تحديث Qpid على الجهازين 12 و13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- تحديث Postgres على الجهاز 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- تحديث Postgres على الجهاز 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- تعديل LDAP على الجهازَين 4 و5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- حدِّث مكوّنات Edge على الأجهزة 12 و13 و8 و9 و6 و7 و10 و11 بهذا الترتيب:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- تعديل واجهة المستخدم الجديدة (
ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهازَين 6 و7:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (في حال تثبيت
apigee-adminapi) تم تحديث أداةapigee-adminapiالمساعدة على الجهازَين 6 و7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (في حال تثبيت Apigee SSO) حدِّث Apigee SSO على الجهازين 6 و7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.
- أعِد تشغيل مكوّن واجهة المستخدم:
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل مكوّن
edge-uiعلى الجهازَين 6 و7، كما هو موضّح في المثال التالي:/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- واجهة مستخدم Edge الجديدة: في حال تثبيت واجهة مستخدم Edge الجديدة، أعِد تشغيل المكوّن
edge-management-uiعلى الجهازَين 6 و7:/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
- واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل مكوّن
ترقية مجموعة من 12 عقدة
عدِّل المكوّنات التالية لتثبيت مجموعة من 12 عقدة:
يُرجى الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.
- تحديث Cassandra وZooKeeper:
- على الأجهزة 1 و2 و3 في مركز البيانات 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- على الأجهزة 7 و8 و9 في مركز البيانات 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- على الأجهزة 1 و2 و3 في مركز البيانات 1:
- تعديل qpidd:
- الجهازان 4 و5 في مركز البيانات 1
- تعديل
qpiddعلى الجهاز 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- تعديل
qpiddعلى الجهاز 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- تعديل
- الجهازان 10 و11 في مركز البيانات 2
- تعديل
qpiddعلى الجهاز 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- تحديث
qpiddعلى الجهاز 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- تعديل
- الجهازان 4 و5 في مركز البيانات 1
- تعديل Postgres:
- الجهاز 6 في مركز البيانات 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- الجهاز 12 في مركز البيانات 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- الجهاز 6 في مركز البيانات 1
- تعديل LDAP:
- الجهاز 1 في مركز البيانات 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- الجهاز 7 في مركز البيانات 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- الجهاز 1 في مركز البيانات 1
- تحديث مكوّنات Edge:
- الأجهزة 4 و5 و6 و1 و2 و3 في مركز البيانات 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- الأجهزة 10 و11 و12 و7 و8 و9 في مركز البيانات 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- الأجهزة 4 و5 و6 و1 و2 و3 في مركز البيانات 1
- عدِّل واجهة المستخدم الجديدة (
ue) أو واجهة المستخدم الكلاسيكية (ui):- الجهاز 1 في مركز البيانات 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- الجهاز 7 في مركز البيانات 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- الجهاز 1 في مركز البيانات 1:
- (في حال تثبيت
apigee-adminapi) تم تحديث أداةapigee-adminapi:- الجهاز 1 في مركز البيانات 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- الجهاز 7 في مركز البيانات 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- الجهاز 1 في مركز البيانات 1:
- (في حال تثبيت Apigee SSO) حدِّث Apigee SSO:
- الجهاز 1 في مركز البيانات 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- الجهاز 7 في مركز البيانات 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.
- الجهاز 1 في مركز البيانات 1:
- أعِد تشغيل مكوّن واجهة مستخدم Edge الجديدة (
edge-management-ui) أو واجهة مستخدم Edge الكلاسيكية (edge-ui) على الجهازَين 1 و7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
لإعداد غير عادي
إذا كان لديك إعداد غير عادي، عدِّل مكوّنات Edge بالترتيب التالي:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge، أي الملف الشخصي "-c edge" على جميع العُقد بالترتيب: العُقد التي تتضمّن خادم Qpid، وخادم Edge Postgres، وخادم الإدارة، ومعالج الرسائل، وجهاز التوجيه.
- واجهة مستخدم Edge (سواء كانت كلاسيكية أو جديدة)
apigee-adminapi- الدخول الموحّد (SSO) في Apigee
بعد الانتهاء من التحديث، احرص على إعادة تشغيل مكوّن واجهة مستخدم Edge على جميع الأجهزة التي تشغّله.