تحديث 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 ترقية إلى Postgres 10.17. وكجزء من هذه الترقية، يتم نقل جميع بيانات 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.
   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

لإجراء ترقية في الموضع إلى الإصدار 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. شغِّل أمر Configuration (ضبط) على المضيف الرئيسي:

   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. يمكنك الحصول على المعرّف الفريد العالمي لعقدة الاستعداد الجديدة من خلال تشغيل الأمر 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. احذف 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 لـ Private Cloud.

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

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

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

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

• من 4.19.06 أو 4.50.00 إلى 4.51.00 (مع تثبيت واجهة مستخدم Edge الجديدة): استخدِم تعليمات الترقية الواردة في هذا القسم للمكوِّن edge-management-ui.

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

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

• ألغِ تثبيت 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. تابع تحديث أي أجهزة متبقية في عملية التثبيت.

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

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

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

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

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

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

1. وفي حال توفُّرها، أوقِف أي مهام cron تم إعدادها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
2. سجِّل الدخول إلى العُقدة كجذر لتثبيت Edge RPMs.
3. تثبيت yum-utils وyum-plugin-priorities:

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. أوقِف SELinux كما هو موضح في تثبيت الأداة المساعدة لإعداد واجهة Edge في 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. نزِّل ملف bootstrap_4.51.00.sh لبرنامج Edge 4.51.00 إلى /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 من ملف repo، وانسخ ملف .tar إلى عقدة، ثم حدِّث Edge من ملف .tar.
• قم بتثبيت خادم ويب على العقدة باستخدام الريبو المحلي حتى تتمكن العُقد الأخرى من الوصول إليه. يوفر لك Apigee خادم ويب NGINX لتستخدمه، أو يمكنك استخدام خادم الويب الخاص بك.

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

1. أنشِئ مستودع 4.51.00 محليًا كما هو موضَّح في "إنشاء مستودع Apigee محلي" في تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge.
2. لتثبيت apigee-service من ملف .tar:
   1. في العقدة التي تتضمّن repo المحلي، استخدِم الأمر التالي لتجميع ملفات repo المحلية في ملف .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

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

3. لتثبيت خدمة apigee باستخدام خادم الويب NGINX:
   1. اضبط خادم الويب NGINX كما هو موضّح في القسم "التثبيت من المخزن باستخدام خادم الويب NGINX" في تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات 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. في العقدة البعيدة، ثبِّت الأداة 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: كاساندرا
     • 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 و 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 هو ملف الإعداد الذي أنشأته عند تثبيت الدخول المُوحَّد (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

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

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