تحديث Apigee Edge 4.19.06 أو 4.50.00 إلى 4.51.00

يوضّح هذا القسم كيفية الترقية من الإصدار 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:

  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 الذي تتم الترقية منه:
      • في حال الترقية من الإصدار 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، نزِّل ملف Edge bootstrap_4.50.00.sh إلى /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. استخدِم apigee-service لتثبيت الأداة المساعدة apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. تثبيت Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. في عقدة الاستعداد الجديدة، نفِّذ الأمر التالي: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

إجراء ترقية موضعية لـ Postgres

لإجراء ترقية موضعية إلى Postgres 10.17، اتّبِع الخطوات التالية:

  1. ترقية postgres على المضيف الرئيسي 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. نفِّذ أمر الإعداد على المضيف الرئيسي: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. نفِّذ أمر الضبط على المضيف الرئيسي: 
    apigee-service apigee-postgresql configure
  4. أعِد تشغيل المضيف الرئيسي: 
    apigee-service apigee-postgresql restart
  5. اضبطه كجهاز رئيسي: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. تأكَّد من بدء تشغيل المضيف الرئيسي: 
    apigee-service apigee-postgresql wait_for_ready
  7. لإيقاف وضع الاستعداد: 
    apigee-service apigee-postgresql stop
  8. ترقية الجهاز الاحتياطي

    ملاحظة: إذا حدث خطأ في هذه الخطوة أو تعذّر تنفيذها، يمكن تجاهلها. سيحاول update.sh بدء تشغيل خادم الاستعداد باستخدام إعدادات غير صحيحة. ويمكن تجاهل الخطأ في حال ترقية تثبيت Postgres إلى الإصدار 10.17.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. تأكَّد من إيقاف وضع الاستعداد: 
    apigee-service apigee-postgresql stop
  10. أزِل الإعدادات الاحتياطية القديمة: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. إعداد النسخ المتماثل على الخادم الاحتياطي: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

بعد إكمال هذا الإجراء، سيبدأ تشغيل الجهاز الاحتياطي بنجاح.

إيقاف عقدة 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

واجهة مستخدم Edge الجديدة

يسرد هذا القسم الاعتبارات المتعلقة بواجهة مستخدم Edge. لمزيد من المعلومات، يُرجى الاطّلاع على واجهة مستخدم Edge الجديدة لـ Private Cloud.

تثبيت واجهة مستخدم Edge

بعد إكمال عملية التثبيت الأولية، تنصحك Apigee بتثبيت واجهة مستخدم Edge، وهي واجهة مستخدم محسّنة لمطوّري ومشرفي Apigee Edge for Private Cloud.

يُرجى العِلم أنّ واجهة مستخدم Edge تتطلّب إيقاف المصادقة الأساسية واستخدام IDP مثل SAML أو LDAP.

لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت واجهة مستخدم Edge الجديدة.

تعديل واجهة مستخدم Edge

لتحديث مكوّن واجهة مستخدم Edge، يُرجى مراعاة إصدار Edge for Private Cloud الذي تتم الترقية منه:

التحديث باستخدام Apigee mTLS

لتحديث 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 عُقد أو أكثر.

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

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

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

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

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

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

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

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

    ويمكنك تنفيذ ذلك بالترتيب الموضّح في ترتيب تحديث الجهاز.

    المكان:

    • ‫component هو مكوّن Edge المطلوب تحديثه. تشتمل القيم المحتملة ما يلي:
      • ‫cs: Cassandra
      • edge: جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres
      • ldap: OpenLDAP
      • ‫ps: postgresql
      • ‫qpid: qpidd
      • sso: الدخول الموحّد (SSO) في Apigee (في حال تثبيت الدخول الموحّد)
      • ue: واجهة مستخدم Edge الجديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: Zookeeper
    • ‫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
  13. أعِد تشغيل مكوّن واجهة مستخدم Edge على جميع العُقد التي تشغّله، إذا لم يسبق لك ذلك: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.

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

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

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

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

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

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

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

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

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

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

  3. لتثبيت apigee-service باستخدام خادم الويب NGINX:
    1. اضبط خادم الويب NGINX كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب NGINX" في تثبيت أداة apigee-setup في Edge.
    2. على العقدة البعيدة، نزِّل ملف 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 أو اسم نظام أسماء النطاقات لعقدة المستودع.

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

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

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

    المكان:

    • ‫component هو مكوّن Edge المطلوب تحديثه. يمكنك عادةً تعديل المكوّنات التالية:
      • ‫cs: Cassandra
      • edge: جميع مكوّنات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres
      • ldap: OpenLDAP
      • ‫ps: postgresql
      • ‫qpid: qpidd
      • sso: الدخول الموحّد (SSO) في Apigee (في حال تثبيت الدخول الموحّد)
      • ue واجهة مستخدم Edge الجديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: Zookeeper
    • ‫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
  8. أعِد تشغيل مكوّنات واجهة المستخدم على جميع العُقد التي تشغّلها، إذا لم تكن قد فعلت ذلك من قبل: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.

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

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

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

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

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

لترقية إعداد مستقل من عقدة واحدة إلى الإصدار 4.51.00:

  1. تعديل جميع المكوّنات: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (في حال تثبيت apigee-adminapi) تم تحديث الأداة المساعدة apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

حدِّث المكوّنات التالية لتثبيت مستقلّ على عقدتَين:

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

  1. تحديث Cassandra وZooKeeper على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تحديث Qpid وPostgres على الجهاز 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  3. تعديل LDAP على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. تحديث مكوّنات Edge على الجهازَين 2 و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. (في حال تثبيت الدخول الموحّد (SSO) في Apigee) حدِّث الدخول الموحّد (SSO) في Apigee على الجهاز 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

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

عدِّل المكوّنات التالية لتثبيت 5 عُقد:

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

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

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

  9. أعِد تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل مكوّن 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 وأرقام العُقد.

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

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

  10. أعِد تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل مكوّن 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 وأرقام العُقد.

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

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

  10. أعِد تشغيل مكوّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، أعِد تشغيل مكوّن 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 وأرقام العُقد.

  1. تحديث 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
  2. تعديل qpidd:
    1. الجهازان 4 و5 في مركز البيانات 1
      1. تعديل qpidd على الجهاز 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. تعديل qpidd على الجهاز 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. الجهازان 10 و11 في مركز البيانات 2
      1. تعديل qpidd على الجهاز 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. تعديل qpidd على الجهاز 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. تعديل Postgres:
    1. الجهاز 6 في مركز البيانات 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. الجهاز 12 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  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 و6 و1 و2 و3 في مركز البيانات 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. الأجهزة 10 و11 و12 و7 و8 و9 في مركز البيانات 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. عدِّل واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui):
    1. الجهاز 1 في مركز البيانات 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. الجهاز 7 في مركز البيانات 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -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. (في حال تثبيت Apigee SSO) حدِّث Apigee 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. أعِد تشغيل مكوّن واجهة مستخدم Edge الجديدة (edge-management-ui) أو واجهة مستخدم Edge الكلاسيكية (edge-ui) على الجهازَين 1 و7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-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 (سواء كانت كلاسيكية أو جديدة)
  7. apigee-adminapi
  8. الدخول الموحّد (SSO) في Apigee

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