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

يوضّح هذا القسم كيفية الترقية من Apigee Edge 4.19.06 أو 4.50.00 إلى 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 جديدة. في الإجراءات أدناه، يمكنك تخطّي الخطوات التي تحدّد تثبيت node 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 الذي تريد الترقية منه:
      • إذا كنت بصدد الترقية من Edge 4.19.06، نزِّل ملف Edge bootstrap_4.19.06.sh إلى /tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        بعد ذلك، ثبِّت أداة apigee-service وأدواتها المساعِدة في Edge: 

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • إذا كنت بصدد الترقية من Edge 4.50.00، نزِّل ملف 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

        بعد ذلك، ثبِّت أداة apigee-service وأدواتها المساعِدة في Edge: 

        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. شغِّل الأمر setup على المضيف الرئيسي: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. شغِّل الأمر configure على المضيف الرئيسي: 
    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 لـ "السحابة الإلكترونية الخاصة" الذي تتم الترقية منه:

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

لتعديل Apigee mTLS، اتّبِع الخطوات التالية:

التراجع عن تحديث

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

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

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

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

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

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

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

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

يتيح لك التحديث بدون إيقاف الخدمة أو التحديث التلقائي تحديث تثبيت Edge بدون إيقاف Edge.

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

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

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

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

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

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

التحديث إلى الإصدار 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 في 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. ثبِّت الأداة apigee-service ومستلزماتها في Edge 4.51.00 من خلال تنفيذ الأمر التالي: 
    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: الدخول المُوحَّد في Apigee (في حال تثبيت الدخول المُوحَّد)
      • ue: واجهة مستخدم Edge الجديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: حارس حديقة الحيوانات
    • configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكونات Edge أثناء تثبيت الإصدار 4.19.06 أو 4.50.00.

    يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت لجهاز Edge الكل في واحد. على سبيل المثال:

    /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 محلي" على الرابط تثبيت أداة إعداد Edge apigee.
  2. لتثبيت apigee-service من ملف ‎ .tar:
    1. على العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لحزمة المستودع المحلي في ملف tar .واحد باسم /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. تثبيت أداة apigee-service في Edge والتبعيات من /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. لتثبيت apigee-service باستخدام خادم الويب NGINX:
    1. اضبط خادم الويب NGINX كما هو موضّح في قسم "التثبيت من المستودع باستخدام خادم الويب NGINX" في مقالة تثبيت أداة Edge apigee-setup.
    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. على العقدة البعيدة، ثبِّت أداة apigee-setup وتبعياتها في Edge: 
      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: الدخول المُوحَّد في Apigee (في حال تثبيت الدخول المُوحَّد)
      • ue واجهة مستخدم Edge الجديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: حارس حديقة الحيوانات
    • configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكوّنات Edge أثناء تثبيت الإصدار 4.19.06 أو 4.50.00.

    يمكنك تشغيل update.sh على جميع المكوّنات من خلال ضبط component على "الكل"، ولكن فقط إذا كان لديك ملف تعريف تثبيت لجهاز Edge الكل في واحد. على سبيل المثال:

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

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

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

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

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

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

  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 SSO) عدِّل Apigee SSO على الجهازَين 6 و7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  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 هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).

  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. كاساندرا
  3. qpidd وps
  4. LDAP
  5. Edge، أي الملف الشخصي "-c edge" على جميع العقد بالترتيب: العقد التي تحتوي على خادم Qpid، وخادم Edge Postgres، وخادم الإدارة، ومعالج الرسائل، وجهاز التوجيه.
  6. واجهة مستخدم Edge (سواء كانت واجهة مستخدم Edge الكلاسيكية أو الجديدة)
  7. apigee-adminapi
  8. Apigee SSO

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