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

يصف هذا القسم كيفية الترقية من Apigee Edge 4.19.06 أو 4.50.00 إلى 4.51.00.

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

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

بعد تثبيت Edge RPM، يمكن لأي شخص إعداده.

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

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

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

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

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

يشتمل هذا الإصدار من Edge على ترقية إلى الإصدار 10.17 من Postgres. وفي إطار هذه الترقية، يتم نقل بيانات Postgres إلى الإصدار 10.17 من Postgres.

تستخدم معظم أنظمة إنتاج 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.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 كما هو موضح في ثبِّت الأداة المساعدة لإعداد واجهة برمجة التطبيقات Edge على 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

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

        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

        بعد ذلك، ثبِّت أداة 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

لإجراء ترقية في الموضع إلى الإصدار 10.17 من Postgres، اتبع الخطوات التالية:

  1. ترقية المنشورات على المضيف الرئيسي 
    /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

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

    "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. احذف المعرّف الفريد العالمي لعقدة وضع الاستعداد من 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 الجديدة للسحابة الإلكترونية الخاصة

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

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

لاحظ أن واجهة مستخدم Edge تتطلب منك تعطيل المصادقة الأساسية واستخدام IDP، مثل SAML أو LDAP.

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

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

لتحديث مكون واجهة مستخدم Edge، ضع في اعتبارك إصدار Edge الخاص بالسحابة الخاصة الذي تريد تتم الترقية من:

التحديث باستخدام 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. تابع إجراء التحديث لأي أجهزة متبقية في عملية التثبيت.

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

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

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

تحديث إلى 4.51.00 على عقدة ذات اتصال إنترنت خارجي

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

  1. يمكنك إيقاف أي مهام "cron" تم ضبطها لإجراء عملية إصلاح في حال توفّرها. "كاساندرا" إلى ما بعد اكتمال التحديث.
  2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
  3. تثبيت yum-utils وyum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. عطّل SELinux كما هو موضح في Install أداة Edge apigee-setup.
  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: كاساندرا
      • edge: جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة، الرسائل معالج، جهاز توجيه، خادم QPID، خادم Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: الدخول المُوحَّد (SSO) في Apigee (في حال تثبيت الدخول المُوحَّد (SSO))
      • ue: واجهة مستخدم Edge جديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: حارس حديقة الحيوان
    • configFile هو ملف الإعداد نفسه الذي استخدمته تحديد Edge الخاص بك المكونات أثناء التثبيت 4.19.06 أو 4.50.00.

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

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

  3. لتثبيت خدمة apigee باستخدام خادم ويب NGINX:
    1. اضبط خادم الويب NGINX كما هو موضَّح في "التثبيت من المستودع باستخدام NGINX". webserver" في تثبيت Edge أداة إعداد apigee.
    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 أو اسم نظام أسماء النطاقات لعقدة repo.

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

      حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور في Repo.

  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: كاساندرا
      • edge: جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه خادم QPID، خادم Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: الدخول المُوحَّد (SSO) في Apigee (في حال تثبيت الدخول المُوحَّد (SSO))
      • ue واجهة مستخدم Edge الجديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: حارس حديقة الحيوان
    • configFile هو ملف الإعداد نفسه الذي استخدمته تحديد مكونات Edge أثناء التثبيت 4.19.06 أو 4.50.00.

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

ترقية مستقلة بعقدة ثنائية

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

يمكنك الاطلاع على منهجيات التثبيت للحصول على قائمة طوابق 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 هو ملف الإعداد الذي أنشأته عند خدمة الدخول المُوحَّد (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. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) عدِّل الدخول المُوحَّد (SSO) في Apigee على الجهاز 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. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) عدِّل الدخول المُوحَّد (SSO) في Apigee على الجهاز 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. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee): تعديل الدخول المُوحَّد (SSO) في Apigee على الجهازين 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. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) عدِّل الدخول المُوحَّد (SSO) في Apigee:
    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. الحافة، بمعنى "حافة-c" على جميع العقد بالترتيب: العقدة ذات خادم Qpid، خادم Edge Postgres وخادم الإدارة ومعالج الرسائل وجهاز التوجيه
  6. Edge UI (إما الإصدار الكلاسيكي أو الجديد)
  7. apigee-adminapi
  8. الدخول المُوحَّد (SSO) في Apigee

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