تحديث Apigee Edge 4.17.09 إلى 4.19.01

Edge for Private Cloud الإصدار 4.19.01

يوضّح هذا القسم كيفية إجراء الترقيات التالية:

  • من الإصدار 4.17.09 إلى الإصدار 4.19.01

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

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

بعد تثبيت حِزم RPM الخاصة بـ Edge، يمكن لأي مستخدم ضبطها.

ما هي المكوّنات التي يجب تعديلها؟

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

الحفاظ على التوافق

عند ترقية Apigee Edge for Private Cloud إلى الإصدار 4.19.01، يجب التأكّد من أنّ عملية التنفيذ الناتجة تشير فقط إلى السمات المتوافقة في ملفات الإعداد.

الموقع الموقع الجغرافي الوصف
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties أزِل هذه السمة من ملف router.properties. To set retry options in 4.19.01, use the virtual host configuration properties.

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

إذا ضبطت أي مواقع من خلال تعديل ملفات .properties في /opt/apigee/customer/application، سيتم الاحتفاظ بهذه القيم من خلال التحديث.

الترقية المطلوبة إلى Postgres 9.6

يتضمّن هذا الإصدار من Edge ترقية إلى Postgres 9.6. وكجزء من هذه الترقية، يتم نقل جميع بيانات Postgres إلى Postgres 9.6.

تستخدم معظم أنظمة إنتاج 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.17.09)، وليس للإصدار 4.19.01.

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

لإنشاء عقدة احتياطية جديدة في Postgres:

  1. في قاعدة بيانات 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 للعقدة الاحتياطية الجديدة.

  2. أعِد تشغيل apigee-postgresql على Postgres الرئيسي: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. تحقَّق من إضافة العقدة الاحتياطية الجديدة من خلال الاطّلاع على ملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf على العقدة الرئيسية. من المفترض أن تظهر لك الأسطر التالية في هذا الملف: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. ثبِّت خادم Postgres الاحتياطي الجديد:
    1. عدِّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من 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
    2. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.
    3. نزِّل ملف Edge bootstrap_4.17.09.sh إلى /tmp/bootstrap_4.17.09.sh : 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    4. ثبِّت أداة Edge apigee-service والتبعيات: 
      sudo bash /tmp/bootstrap_4.17.09.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-check-standby

      تأكَّد من أنّه يشير إلى أنّه في وضع الاستعداد.

إيقاف عقدة Postgres

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

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

    إذا لم يكن Postgres قيد التشغيل، ابدأ تشغيله: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. احصل على المعرّف الفريد العالمي (UUID) للعقدة الاحتياطية الجديدة من خلال تنفيذ أمر curl التالي على العقدة الاحتياطية الجديدة: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    من المفترض أن يظهر لك معرّف UUID للعقدة في نهاية الناتج، بالشكل التالي: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. أوقِف عقدة الاستعداد الجديدة من خلال تشغيل الأمر التالي على عقدة الاستعداد الجديدة: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. في العقدة الرئيسية في 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
  5. أعِد تشغيل apigee-postgresql على Postgres الرئيسي: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. تحقَّق من إزالة عقدة الاستعداد الجديدة من خلال الاطّلاع على ملف /opt/apigee/apigee-postgresql/conf/pg_hba.conf في العقدة الرئيسية. من المفترض أن يظهر لك السطر التالي فقط في هذا الملف: 
    host replication apigee existing_standby_ip/32 trust
  7. احذف معرّف 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

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

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

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

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

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

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

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

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

تحديث بدون توقّف

يتيح لك التحديث بدون وقت توقّف أو التحديث المتجدّد تعديل إعدادات Edge بدون إيقاف Edge.

لا يمكن إجراء تحديث بدون توقّف إلا من خلال إعدادات تتضمّن 5 عُقد أو أكثر.

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

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

يُرجى الانتباه إلى ما يلي قبل التحديث أو بعده:

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

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

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

التحديث إلى الإصدار 4.19.01 على عقدة تتضمّن اتصالاً خارجيًا بالإنترنت

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

  1. إذا كنت تستخدم حاليًا النسخ المتماثل الرئيسي الاحتياطي في Postgres مع مساحة تخزين محلية، ثبِّت عقدة احتياطية جديدة في Postgres كما هو موضّح في تثبيت عقدة احتياطية جديدة في Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، يمكنك أخذ لقطة شبكة لمخزن البيانات الذي تستخدمه Postgres. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

  2. في حال توفّر أي مهام CRON تم ضبطها لإجراء عملية إصلاح على Cassandra، عليك إيقافها إلى أن يكتمل التحديث.
  3. سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم RPM في Edge.
  4. ثبِّت yum-utils وyum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.
  6. إذا كنت تثبّت على Oracle 7.x، شغِّل الأمر التالي: 
    sudo yum-config-manager --enable ol7_optional_latest
  7. في حال التثبيت على 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
  8. نزِّل ملف Edge 4.19.01 bootstrap_4.19.01.sh إلى /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  9. ثبِّت أداة Edge 4.19.01 apigee-service والتبعيات: 
    sudo bash /tmp/bootstrap_4.19.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 بنفسك.
  10. استخدِم apigee-service لتحديث الأداة المساعدة apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. حدِّث أداة apigee-validate المساعدة على خادم الإدارة: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. تحديث أداة "apigee-provision": 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. شغِّل أداة التحديث على العُقد بالترتيب الموضَّح في ترتيب تحديث الجهاز: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    استخدِم الخيار -c لتحديد المكوّن المطلوب تحديثه. وتشمل قائمة المكوّنات المحتملة ما يلي:

    • "cs" = Cassandra
    • "edge" =جميع مكوّنات Edge باستثناء Edge UI يتضمّن مكوّن "edge" خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Edge Postgres.
    • ‫"ldap"‏ = OpenLDAP
    • ‫"ps"‏ = postgresql
    • "qpid" = qpidd
    • ‫"sso" = Edge SSO
    • ‫"ui" = واجهة مستخدم Edge
    • ‫"zk"‏ = Zookeeper

    يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف شخصي لإعدادات Edge All-in-One (AIO). على سبيل المثال:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. أعِد تشغيل مكوّن واجهة مستخدم Edge على جميع الأجهزة التي تشغّله، إذا لم تكن قد فعلت ذلك: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.
  16. إذا ثبّت عقدة احتياطية جديدة في Postgres، عليك إيقاف تشغيل العقدة كما هو موضّح في إيقاف تشغيل عقدة Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6 لمزيد من المعلومات.

للتراجع عن التحديث لاحقًا، استخدِم الإجراء الموضّح في التراجع عن الإصدار 4.19.01.

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

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

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

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

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

  1. إذا كنت تستخدم حاليًا النسخ المتماثل الرئيسي الاحتياطي في Postgres، ثبِّت عقدة احتياطية جديدة في Postgres كما هو موضّح في تثبيت عقدة احتياطية جديدة في Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، يمكنك أخذ لقطة شبكة لمخزن البيانات الذي تستخدمه Postgres. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

  2. أنشئ مستودعًا محليًا للإصدار 4.19.01 كما هو موضّح في "إنشاء مستودع Apigee محلي" في تثبيت أداة apigee-setup في Edge.
  3. لتثبيت apigee-service من ملف ‎ .tar:
    1. 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.19.01.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. انسخ ملف ‎ .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp على العقدة الجديدة.
    3. على العقدة الجديدة، فُكّ ضغط الملف إلى الدليل ‎ /tmp: 
      tar -xzf apigee-4.19.01tar.gz

      ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف ‎ .tar. على سبيل المثال، ‎ /tmp/repos.

    4. ثبِّت أداة Edge apigee-service والتبعيات من /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      لاحظ أنك تقوم بتضمين المسار إلى دليل المستودعات في هذا الأمر.

  4. لتثبيت apigee-service باستخدام خادم الويب Nginx:
    1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب Nginx" في تثبيت أداة Edge apigee-setup.
    2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.19.01.sh إلى /tmp/bootstrap_4.19.01.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

      حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان حددتهما سابقًا للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة المستودع.

    3. على العقدة البعيدة، ثبِّت أداة Edge apigee-service والتبعيات: 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      حيث uName:pWord هما اسم المستخدم وكلمة المرور للمستودع.

  5. استخدِم apigee-service لتحديث الأداة المساعدة apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. حدِّث أداة apigee-validate المساعدة على خادم الإدارة: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. تحديث أداة "apigee-provision": 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. شغِّل الأداة المساعدة update على العُقد بالترتيب الموضَّح في ترتيب تحديث الجهاز: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    استخدِم الخيار -c لتحديد المكوّن المطلوب تحديثه. وتشمل قائمة المكوّنات المحتملة ما يلي:

    • "cs" = Cassandra
    • "edge" =جميع مكوّنات Edge باستثناء Edge UI يتضمّن مكوّن "edge" خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Edge Postgres.
    • ‫"ldap"‏ = OpenLDAP
    • ‫"ps"‏ = postgresql
    • "qpid" = qpidd
    • ‫"sso" = Edge SSO
    • ‫"ui" = واجهة مستخدم Edge
    • ‫"zk"‏ = Zookeeper

    يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف شخصي لإعدادات Edge All-in-One (AIO). على سبيل المثال:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. أعِد تشغيل مكوّن واجهة مستخدم Edge على جميع الأجهزة التي تشغّله، إذا لم تكن قد فعلت ذلك: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.
  11. إذا ثبّت عقدة احتياطية جديدة في Postgres، عليك إيقاف تشغيل العقدة كما هو موضّح في إيقاف تشغيل عقدة Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

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

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

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

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

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

  1. تحديث Cassandra وZooKeeper: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تحديث Qpid: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. تعديل LDAP: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. أوقِف خادم Postgres وخادم Qpid وPostgreSQL: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. تعديل postgresql: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. حدِّث مكوّنات Edge المتبقية: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. تحديث واجهة مستخدم Edge: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (في حال تثبيت apigee-adminapi) تم تحديث الأداة المساعدة apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (في حال تثبيت Edge SSO) حدِّث Edge SSO: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

  10. أعِد تشغيل مكوّن واجهة مستخدم Edge: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ترقية مستقلة من عقدتَين

يمكنك الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

  1. تحديث Cassandra وZooKeeper على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تحديث Qpid على الجهاز 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. تعديل LDAP على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. تحديث مكوّنات Edge على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. تعديل واجهة المستخدم على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (في حال تثبيت apigee-adminapi) تم تحديث أداة apigee-adminapi المساعدة على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (في حال تثبيت Edge SSO) حدِّث Edge SSO على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

  8. تحديث postgresql على الجهاز 2:
    1. أوقِف خادم Postgres وخادم Qpid وpostgresql:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. تعديل postgresql: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. تحديث مكوّنات Edge على الجهاز 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. أعِد تشغيل مكوّن واجهة مستخدم Edge على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ترقية إلى 5 عُقد

يمكنك الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

  1. تأكَّد من تثبيت عقدة احتياطية جديدة في Postgres كما هو موضّح في تثبيت عقدة احتياطية جديدة في Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، يمكنك أخذ لقطة شبكة لمخزن البيانات الذي تستخدمه Postgres. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

  2. حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. تحديث Qpid على الجهازَين 4 و5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. تعديل LDAP على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. تحديث مكوّنات Edge على الأجهزة 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. تعديل واجهة المستخدم على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (في حال تثبيت apigee-adminapi) تم تحديث أداة apigee-adminapi المساعدة على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (في حال تثبيت Edge SSO) حدِّث Edge SSO على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

  9. تحديث الجهازَين 4 و5:
    1. أوقِف خادم Postgres وخادم Qpid على الجهاز 4:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. أوقِف خادم Postgres وخادم Qpid وpostgresql على الجهاز 5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. في حال تثبيته، أوقِف خادم Postgres وpostgresql على عقدة الاستعداد الجديدة التي أضفتها للعودة إلى الإصدار السابق: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. تحديث postgresql على الأجهزة 4: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. تحديث postgresql على الأجهزة 5: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. ابدأ تشغيل خادم Postgres وخادم Qpid على الجهازَين 4 و5: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    7. اضبط Postgres كعقدة احتياطية من خلال تنفيذ الأوامر التالية على الجهاز 5: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    8. تحقَّق من حالة النسخ المتماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمَين. يُفترض أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان نجاح عملية النسخ المتماثل:
      • على الجهاز 4، العقدة الرئيسية، شغِّل: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        تأكَّد من أنّه يشير إلى أنّه الجهاز الرئيسي.

      • على الجهاز 5، عُقدة الاستعداد: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        تأكَّد من أنّه يشير إلى أنّه في وضع الاستعداد.

  10. تحديث مكوّنات Edge على الجهازَين 4 و5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. تأكَّد من إيقاف تشغيل عقدة الاستعداد الجديدة كما هو موضّح في إيقاف تشغيل عقدة Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

  12. أعِد تشغيل مكوّن واجهة مستخدم Edge على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ترقية مجمّعة من 9 عُقد

يمكنك الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

  1. تأكَّد من تثبيت عقدة احتياطية جديدة في Postgres كما هو موضّح في تثبيت عقدة احتياطية جديدة في Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، يمكنك أخذ لقطة شبكة لمخزن البيانات الذي تستخدمه Postgres. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

  2. حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. تحديث Qpid على الجهازَين 6 و7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. تعديل LDAP على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. حدِّث مكوّنات Edge على الأجهزة 6 و7 و1 و4 و5 بهذا الترتيب: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. تعديل واجهة المستخدم على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (في حال تثبيت apigee-adminapi) تم تحديث أداة apigee-adminapi المساعدة على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (في حال تثبيت Edge SSO) حدِّث Edge SSO على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

  9. تحديث الجهازَين 8 و9:
    1. إيقاف خادم Postgres على الجهاز 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. أوقِف خادم Postgres وpostgresql على الجهاز 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. أوقِف خادم Qpid على الجهازَين 6 و7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. في حال تثبيته، أوقِف خادم Postgres وpostgresql على عقدة الاستعداد الجديدة التي أضفتها للعودة إلى الإصدار السابق: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. تعديل postgresql على الأجهزة 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. تحديث postgresql على الأجهزة 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. ابدأ تشغيل خادم Postgres على الجهازَين 8 و9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. ابدأ تشغيل خادم Qpid على الجهازَين 6 و7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. اضبط Postgres كعقدة احتياطية من خلال تنفيذ الأوامر التالية على الجهاز 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. تحقَّق من حالة النسخ المتماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمَين. يُفترض أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان نجاح عملية النسخ المتماثل:
      • على الجهاز 8، العقدة الرئيسية، نفِّذ ما يلي: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        تأكَّد من أنّه يشير إلى أنّه الجهاز الرئيسي.

      • على الجهاز 9، عُقدة الاستعداد: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        تأكَّد من أنّه يشير إلى أنّه في وضع الاستعداد.

  10. تحديث مكوّنات Edge على الجهازين 8 و9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. تأكَّد من إيقاف تشغيل عقدة الاستعداد الجديدة كما هو موضّح في إيقاف تشغيل عقدة Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

  12. أعِد تشغيل مكوّن واجهة مستخدم Edge على الجهاز 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ترقية مجموعة من 13 عقدة

يمكنك الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

  1. تأكَّد من تثبيت عقدة احتياطية جديدة في Postgres كما هو موضّح في تثبيت عقدة احتياطية جديدة في Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، يمكنك أخذ لقطة شبكة لمخزن البيانات الذي تستخدمه Postgres. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

  2. حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. تحديث Qpid على الجهازَين 12 و13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. تعديل LDAP على الجهازَين 4 و5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. حدِّث مكوّنات Edge على الأجهزة 12 و13 و6 و7 و10 و11 بهذا الترتيب: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. تعديل واجهة المستخدم على الجهازَين 6 و7: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (في حال تثبيت apigee-adminapi) تم تحديث أداة apigee-adminapi المساعدة على الجهازَين 6 و7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (في حال تثبيت Edge SSO) حدِّث Edge SSO على الجهازَين 6 و7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

  9. تحديث الجهازَين 8 و9:
    1. إيقاف خادم Postgres على الجهاز 8: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. أوقِف خادم Postgres وpostgresql على الجهاز 9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. أوقِف خادم Qpid على الجهازَين 12 و13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. في حال تثبيته، أوقِف خادم Postgres وpostgresql على عقدة الاستعداد الجديدة التي أضفتها للعودة إلى الإصدار السابق: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. تعديل postgresql على الأجهزة 8: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. تحديث postgresql على الأجهزة 9: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. ابدأ تشغيل خادم Postgres على الجهازَين 8 و9: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. ابدأ تشغيل خادم Qpid على الجهازَين 12 و13: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. اضبط Postgres كعقدة احتياطية من خلال تنفيذ الأوامر التالية على الجهاز 9: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. تحقَّق من حالة النسخ المتماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمَين. يُفترض أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان نجاح عملية النسخ المتماثل:
      • على الجهاز 8، العقدة الرئيسية، نفِّذ ما يلي: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        تأكَّد من أنّه يشير إلى أنّه الجهاز الرئيسي.

      • على الجهاز 9، عُقدة الاستعداد: 
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        تأكَّد من أنّه يشير إلى أنّه في وضع الاستعداد.

  10. تحديث مكوّنات Edge على الجهازين 8 و9: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. تأكَّد من إيقاف تشغيل عقدة الاستعداد الجديدة كما هو موضّح في إيقاف تشغيل عقدة Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. لمزيد من المعلومات، يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6.

  12. أعِد تشغيل مكوّن واجهة مستخدم Edge على الجهازَين 6 و7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ترقية مجموعة من 12 عقدة

يمكنك الاطّلاع على مخططات التثبيت للحصول على قائمة بمخططات Edge وأرقام العُقد.

  1. تأكَّد من تثبيت عقدة احتياطية جديدة في Postgres كما هو موضّح في تثبيت عقدة احتياطية جديدة في Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، يمكنك أخذ لقطة شبكة لمخزن البيانات الذي تستخدمه Postgres. يمكنك الاطّلاع على الترقية المطلوبة إلى Postgres 9.6 لمزيد من المعلومات.

  2. تحديث Cassandra وZooKeeper:
    1. على الأجهزة 1 و2 و3 في مركز البيانات 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. على الأجهزة 7 و8 و9 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. تعديل qpidd:
    1. الجهازان 4 و5 في مركز البيانات 1
      1. تعديل qpidd على الجهاز 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. كرِّر الخطوة 1 على الجهاز 5.
    2. الجهازان 10 و11 في مركز البيانات 2
      1. تعديل qpidd على الجهاز 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. كرِّر الخطوة 1 على الجهاز 11.
  4. تعديل LDAP:
    1. الجهاز 1 في مركز البيانات 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. الأجهزة 7 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. تحديث مكوّنات Edge:
    1. الأجهزة 4 و5 و1 و2 و3 في مركز البيانات 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. الأجهزة 10 و11 و7 و8 و9 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. تعديل واجهة المستخدم:
    1. الجهاز 1 في مركز البيانات 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. الجهاز 7 في مركز البيانات 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (في حال تثبيت apigee-adminapi) تم تحديث أداة apigee-adminapi المساعدة:
    1. الجهاز 1 في مركز البيانات 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. الجهاز 7 في مركز البيانات 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (في حال تثبيت Edge SSO) حدِّث Edge SSO:
    1. الجهاز 1 في مركز البيانات 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. الجهاز 7 في مركز البيانات 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. حيث يمثّل sso_config_file ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد.

  9. تحديث الجهاز 6 في مركز البيانات 1 والجهاز 12 في مركز البيانات 2:
    1. أوقِف خادم Postgres على الجهاز 6: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. أوقِف خادم Postgres وpostgresql على الجهاز 12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. أوقِف خادم Qpid على الأجهزة 4 و5 و10 و11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. في حال تثبيته، أوقِف خادم Postgres وpostgresql على عقدة الاستعداد الجديدة التي أضفتها للعودة إلى الإصدار السابق: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. تحديث postgresql على الأجهزة 6: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. تحديث postgresql على الأجهزة 12: 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. ابدأ تشغيل خادم Postgres على الجهازين 6 و12: 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    8. ابدأ تشغيل خادم Qpid على الأجهزة 4 و5 و10 و11: 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    9. اضبط Postgres كعقدة احتياطية من خلال تنفيذ الأوامر التالية على الجهاز 12: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    10. تحقَّق من حالة النسخ المتماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمَين. من المفترض أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان نجاح عملية النسخ المتماثل:

      على الجهاز 6، العقدة الرئيسية، نفِّذ ما يلي:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      تأكَّد من أنّه يشير إلى أنّه الجهاز الرئيسي.

      على الجهاز 12، العقدة الاحتياطية:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      تأكَّد من أنّه يشير إلى أنّه في وضع الاستعداد.

  10. تحديث مكوّنات Edge على الجهازَين 6 و12: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. تأكَّد من إيقاف تشغيل عقدة الاستعداد الجديدة كما هو موضّح في إيقاف تشغيل عقدة Postgres.

    إذا كنت تستخدم مساحة تخزين على الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. يُرجى الاطّلاع على الترقية المطلوبة إلى Postgres 9.6 لمزيد من المعلومات.

  12. أعِد تشغيل مكوّن واجهة مستخدم Edge على الجهازَين 1 و7: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

لإجراء ترقية غير عادية

إذا كان لديك إعداد غير عادي، عدِّل مكوّنات Edge بالترتيب التالي:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge، أي الملف الشخصي "-c edge" على جميع العُقد بالترتيب: العُقد التي تتضمّن خادم Qpid وEdge Postgres Server وManagement Server وMessage Processor وRouter.
  6. Edge UI
  7. apigee-adminapi
  8. Edge SSO

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