تحديث Apigee Edge 4.17.05 أو 4.17.09 إلى 4.18.05

الإصدار 4.18.05 من Edge الخاص بخدمة Private Cloud

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

  • من 4:17 إلى 4:18
  • من 4:17 صباحًا إلى 4:18.05

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

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

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

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

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

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

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

الموقع الموقع الجغرافي الوصف
conf_load_balancing_load.balancing.
  driver.nginx.server.retry
router.properties أزِل هذه السمة من ملف router.properties. لإعداد خيارات إعادة المحاولة في الإصدار 4.18.05، استخدِم سمات ضبط المضيف الافتراضي.

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

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

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

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

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

يتضمن هذا الإصدار من 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.

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

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

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

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

يقوم هذا الإجراء بإنشاء خادم وضع الاستعداد Postgres على عقدة جديدة. احرص على تثبيت خادم وضع الاستعداد الجديد Postgres للإصدار الحالي من Edge (4.17.05 أو 4.17.09)، وليس للإصدار 4.18.05.

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

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

  1. في الصفحة الرئيسية الحالية لتطبيق Postgres، يمكنك تعديل ملف /opt/apigee/customer/application/postgresql.properties لضبط الرمز المميّز التالي. إذا لم يكن الملف متوفّرًا، يمكنك إنشاؤه:
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    حيث يكون existing_slave_ip هو عنوان IP لخادم Postgres الحالي وnew_slave_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_slave_ip/32 trust
    host replication apigee new_slave_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 كما هو موضح في تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات Edge.
    3. نزِّل ملف Edge Bootstrap_4.17.0x.sh، حيث يكون x إما 5 (للإصدار 4.17.05) أو 9 (للإصدار 4.17.09) إلى /tmp/bootstrap_4.17.0x.sh :
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. ثبِّت أداة Edge apigee-service وملحقاتها:
      sudo bash /tmp/bootstrap_4.17.0x.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. يمكنك الحصول على المعرّف الفريد العالمي لعقدة الاستعداد الجديدة من خلال تنفيذ الأمر cURL التالي على عقدة وضع الاستعداد الجديدة:
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
    .

    من المفترض أن يظهر لك المعرّف الفريد العالمي للعقدة في نهاية الناتج، على النحو التالي:

    "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_slave_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_slave_ip/32 trust
  7. احذف UUID لعقدة الاستعداد من ZooKeeper عن طريق إجراء استدعاء واجهة برمجة تطبيقات إدارة Edge التالي على عقدة خادم الإدارة:
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

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

يُرجى مراعاة المتطلبات الأساسية التالية قبل ترقية Apigee Edge:

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

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

  • التأكد من تشغيل Edge
    تأكد من أن Edge قيد التشغيل أثناء عملية التحديث باستخدام الأمر:
    /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

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

تكتب الأداة 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. جعل جهاز التوجيه يمكن الوصول إليه.
  • في عقدة جهاز توجيه واحدة:
    • قبل التحديث، اجعل جهاز التوجيه لا يمكن الوصول إليه.
    • بعد التحديث، يمكنك جعل جهاز التوجيه قابلاً للوصول إليه.
  • في عُقدة واحدة لمعالج الرسائل:
    • قبل التحديث، اجعل الوصول إلى "معالج الرسائل" غير متاح.
    • بعد التحديث، اجعل "معالج الرسائل" قابلاً للوصول إليه.

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

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

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

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

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

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

  2. وفي حال توفُّرها، أوقِف أي مهام CRON تم ضبطها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
  3. سجِّل الدخول إلى العُقدة كجذر لتثبيت Edge RPMs.
  4. تثبيت yum-utils وyum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  5. أوقِف SELinux كما هو موضح في تثبيت الأداة المساعدة لإعداد واجهة Edge في 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. نزِّل ملف bootstrap_4.18.05.sh لبرنامج Edge 4.18.05 إلى /tmp/bootstrap_4.18.05.sh:
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. ثبِّت الأداة المساعدة Edge 4.18.05 apigee-service والتبعيات:
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذين تلقّيتهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخاله.

    تتحقّق أداة التثبيت تلقائيًا من تثبيت Java 1.8. وإذا لم يكن لديك حساب، سيتم تثبيته نيابةً عنك. استخدِم الخيار JAVA_FIX لتحديد كيفية التعامل مع تثبيت Java. يتم استخدام القيم التالية لـ JAVA_FIX:

    • I = تثبيت OpenJDK 1.8 (التلقائي)
    • C = المتابعة بدون تثبيت Java
    • س = إنهاء. للاستفادة من هذا الخيار، عليك تثبيت 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" = كاساندرا
    • "e" = بحث ElasticSearch
    • "edge" =جميع مكونات Edge باستثناء واجهة مستخدم Edge. ويتضمن المكوِّن "Edge" و"خادم الإدارة" و"معالج الرسائل" و"جهاز التوجيه" و"خادم QPID" و"خادم Edge Postgres".
    • "ldap" = بروتوكول OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = الدخول الموحَّد (SSO) على Edge
    • "ui" = واجهة مستخدم Edge
    • "zk" = حديقة الحيوانات

    يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف شخصي للتثبيت على متصفّح Edge الشامل (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.18.05.

تحديث التطبيق إلى الإصدار 4.18.05 من مستودع محلي

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

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

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

للتعديل من مستودع محلي في الإصدار 4.18.05:

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

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

  2. أنشئ مستودعًا محليًا للإصدار 4.18.05 كما هو موضَّح في "إنشاء مستودع Apigee محلي" في تثبيت الأداة المساعدة لإعداد apigee في Edge.
  3. لتثبيت apigee-service من ملف .tar:
    1. في العقدة التي تتضمّن repo المحلي، استخدِم الأمر التالي لتجميع ملفات repo المحلية في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz:
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. انسخ ملف .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخها إلى الدليل /tmp على العقدة الجديدة.
    3. في العقدة الجديدة، أزِل الملف إلى الدليل /tmp:
      tar -xzf apigee-4.18.05tar.gz

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

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

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

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

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

    3. في العقدة البعيدة، ثبِّت الأداة apigee-service Edge والتبعيات:
      sudo bash /tmp/bootstrap_4.18.05.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" = كاساندرا
    • "e" = بحث ElasticSearch
    • "edge" =جميع مكونات Edge باستثناء واجهة مستخدم Edge. ويتضمن المكوِّن "Edge" و"خادم الإدارة" و"معالج الرسائل" و"جهاز التوجيه" و"خادم QPID" و"خادم Edge Postgres".
    • "ldap" = بروتوكول OpenLDAP
    • "ps" = postgresql
    • "qpid" = qpidd
    • "sso" = الدخول الموحَّد (SSO) على Edge
    • "ui" = واجهة مستخدم Edge
    • "zk" = حديقة الحيوانات

    يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف شخصي للتثبيت على متصفّح Edge الشامل (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.

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

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

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

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

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

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

  1. تحديث "كاساندرا" و"زول كيبر":
    /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. تعديل قاعدة بيانات Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. عدِّل مكوّنات Edge المتبقية:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. تحديث واجهة مستخدم Edge:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. (في حال تثبيت الدخول المُوحَّد (SSO) على Edge) يجب تحديث الدخول المُوحَّد (SSO) إلى Edge:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  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. (في حال تثبيت الدخول المُوحَّد (SSO) على Edge) يجب تحديث الدخول المُوحَّد (SSO) إلى Edge على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  7. تحديث 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. تعديل قاعدة بيانات Postgres:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. تحديث مكوّنات Edge على الجهاز 2:
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. أعِد تشغيل مكوِّن واجهة مستخدم Edge على الجهاز 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

تركيب 5 عُقد

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

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

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

  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. (في حال تثبيت الدخول المُوحَّد (SSO) على Edge) يجب تحديث الدخول المُوحَّد (SSO) إلى Edge على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  8. تحديث الجهازين 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. تحديث قاعدة بيانات Postgres على الجهاز 4 (Postgres master فقط):
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. تحديث Postgresql على الأجهزة 5:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. شغِّل خادم 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
    8. اضبط 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
    9. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. يجب أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان إجراء نسخ متماثل بنجاح:
      • على الجهاز 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

        يُرجى التأكّد من أنّها في وضع الاستعداد.

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

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

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

تثبيت مجمّع من 9 عُقد

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

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

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

  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. (في حال تثبيت الدخول المُوحَّد (SSO) على Edge) يجب تحديث الدخول المُوحَّد (SSO) إلى Edge على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  8. تحديث الجهازين 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. تحديث قاعدة بيانات Postgres على الجهاز 8 (Postgres master فقط):
      /-->
      opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. تحديث Postgresql على الأجهزة 9:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. بدء خادم Postgres على الجهازَين 8 و9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. بدء خادم Qpid على الجهازين 6 و7:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. اضبط 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
    11. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. يجب أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان إجراء نسخ متماثل بنجاح:
      • على الجهاز 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

        يُرجى التأكّد من أنّها في وضع الاستعداد.

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

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

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

تثبيت مجمّع من 13 عقدة

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

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

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

  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. (في حال تثبيت خدمة الدخول المُوحَّد (SSO) على Edge) يجب تحديث الدخول المُوحَّد (SSO) إلى Edge على الجهازين 6 و7:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  8. تحديث الجهازين 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. تحديث قاعدة بيانات Postgres على الجهاز 8 (Postgres master فقط):
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. تحديث Postgresql على الأجهزة 9:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. تشغيل خادم Postgres على الجهازين 8 و9:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. بدء خادم Qpid على الجهازين 12 و13:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. اضبط 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
    11. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. يجب أن يعرض النظام نتائج متطابقة على كلا الخادمَين لضمان إجراء نسخ متماثل بنجاح:
      • على الجهاز 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

        يُرجى التأكّد من أنّها في وضع الاستعداد.

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

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

  11. أعِد تشغيل مكوِّن واجهة مستخدم 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. (في حال تثبيت الدخول المُوحَّد (SSO) على Edge) يجب تعديل الدخول المُوحَّد (SSO) إلى Edge:
    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 هو ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد (SSO).

  8. تحديث الجهاز 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. تحديث قاعدة بيانات Postgres على الجهاز 6 (Postgres master فقط):
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. تحديث Postgresql على الأجهزة 12:
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. بدء خادم Postgres على الجهازَين 6 و12:
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. بدء خادم Qpid على الأجهزة 4 و5 و10 و11:
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. اضبط 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
    11. تحقق من حالة النسخ المماثل عن طريق إصدار النصوص البرمجية التالية على كلا الخادمين. ومن المفترض أن يعرض النظام نتائج متطابقة على كلا الخادمين لضمان إجراء نسخ متماثل بنجاح:

      في الجهاز 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

      يُرجى التأكّد من أنّها في وضع الاستعداد.

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

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

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

بالنسبة إلى عملية التثبيت غير العادية

إذا كان لديك عملية تثبيت غير عادية، عليك تحديث مكونات Edge بالترتيب التالي:

  1. ZooKeeper
  2. من الفئة العمرية 31-45
  3. qpidd ، ps
  4. LDAP
  5. Edge، بمعنى الملف الشخصي " -c Edge" في جميع العُقد بالترتيب: العُقد التي تتضمّن خادم Qpid وEdge Postgres Server و"خادم الإدارة" و"معالج الرسائل" و"جهاز التوجيه".
  6. واجهة مستخدم Edge
  7. الدخول الموحَّد (SSO) إلى Edge

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