تحديث Apigee Edge 4.53.00 أو 4.53.01 إلى 4.54.00

تتيح Apigee ترقية Edge for Private Cloud مباشرةً من الإصدار 4.53.00 أو 4.53.01 إلى الإصدار 4.54.00. توضّح هذه الصفحة كيفية إجراء هذه الترقيات.

للحصول على نظرة عامة على مسارات الترقية المتوافقة، يُرجى الاطّلاع على مصفوفة توافق الترقية لإصدارات Edge for Private Cloud.

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

يجب أن يكون المستخدم الذي يُجري التحديث هو نفسه المستخدم الذي ثبَّت Edge في الأصل، أو مستخدمًا لديه إذن الوصول الجذر.

بعد تثبيت حِزم RPM الخاصة بـ Edge، يمكن لأي مستخدم ضبطها.

ما هي المكوّنات التي يجب تعديلها؟

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

مواد القراءة التحضيرية

يُرجى مراجعة المواضيع التالية للحصول على معلومات مهمة حول التغييرات التي تم إجراؤها في الإصدار 4.54.00 من Edge for Private Cloud:

• التغييرات في الإصدار 4.54.00: يمكنك مراجعة التغييرات في بروتوكول أمان طبقة النقل (TLS) وJava Callout التي تتطلّب الاستعداد قبل الترقية. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في الإصدار 4.54.00.

• بنية بيئة التشغيل Dual-Java (الإصداران Java 17 وJava 21): اعتبارًا من الإصدار 4.54.00، ستتم إزالة توافق Edge for Private Cloud مع الإصدار Java 8 وتشغيل المكوّنات على الإصدار Java 17 أو Java 21. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في الإصدار 4.54.00.

• عدم تثبيت Java تلقائيًا أثناء عملية الإعداد: يتيح الإصدار 4.54.00 من Edge for Private Cloud اكتشاف عمليات تثبيت Java والتحقّق من تثبيت الإصدارَين 17 و21 من Java.

• واجهة مستخدم Edge الجديدة في الإصدار 4.54.00: تعرَّف على الانتقال إلى واجهة مستخدم Edge الجديدة كواجهة الإدارة التلقائية وإزالة واجهة المستخدم الكلاسيكية (edge-ui). لمزيد من المعلومات، يُرجى الاطّلاع على واجهة مستخدم Edge الجديدة.

• الدخول المُوحَّد (SSO) في Apigee في الإصدار 4.54.00: يمكنك التعرّف على بنية الدخول المُوحَّد (SSO) المعدَّلة وتغييرات الإعدادات للمصادقة. لمزيد من المعلومات، يُرجى الاطّلاع على الدخول المُوحَّد (SSO) في Apigee.

• ‫Nginx 1.30 في الإصدار 4.54.00: راجِع الترقية التلقائية إلى Nginx 1.30.x على Edge Routers، والتأثيرات المحتملة على وقت التشغيل، وخطوات الحدّ من المخاطر. لمزيد من المعلومات، يُرجى الاطّلاع على تغييرات Nginx 1.30.

المتطلبات الأساسية للترقية

تأكَّد من استيفاء المتطلبات الأساسية التالية قبل ترقية Apigee Edge:

• مراجعة ملاحظات الإصدار والميزات الجديدة

  يُرجى التأكّد من مراجعة وفهم جميع الميزات الجديدة والتغييرات في السلوك وعمليات الإيقاف المفصّلة في ملاحظات إصدار Edge for Private Cloud بدقة قبل بدء عملية الترقية.

• اكتشاف ملفات Java الثنائية تلقائيًا والتعايش معها أثناء الترقية: يمكنك تثبيت Java باستخدام مدراء الحزم العادية (مثل yum) أو المواقع العادية (مثل ‎ /usr/lib/jvm أو update-alternatives). ولست بحاجة إلى ضبط كلا الإصدارَين في مسار النظام في الوقت نفسه. لا تلغِ تثبيت Java 8 قبل الترقية. يجب إبقاء Java 8 مثبّتًا إلى جانب Java 17 وJava 21 لكي تستمر خدمات Edge for Private Cloud 4.53.xx الحالية في العمل بدون انقطاع إلى أن يتم تحديثها.

• الاحتفاظ بنسخة احتياطية من جميع العُقد

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

• الاحتفاظ بنسخة احتياطية من ملف الإعداد الصامت

  تأكَّد من الاحتفاظ بنُسخ احتياطية من ملفات الإعداد الصامت للإصدار 4.53.00 أو 4.53.01 من Edge for Private Cloud لتسهيل عملية العودة إلى إصدار سابق إذا لزم الأمر.

• التأكّد من تشغيل Edge

  تأكَّد من أنّ Edge يعمل أثناء عملية التحديث باستخدام الأمر:

  /opt/apigee/apigee-service/bin/apigee-all status

• التحقّق من المتطلبات الأساسية لـ Cassandra

  إذا سبق لك الترقية من إصدار قديم من Edge for Private Cloud إلى الإصدار 4.53.00 (أو) 4.53.01 وتخطّط الآن للترقية إلى الإصدار 4.54.00، تأكَّد من إكمال الخطوات المطلوبة بعد الترقية لـ Cassandra. تم توضيح هذه الخطوات في مستندات الترقية للإصدار 4.53.00 (أو) 4.53.01، كما تم ذكرها ضمن المتطلبات الأساسية لترقية Cassandra. إذا لم تكن متأكدًا من اكتمال هذه الخطوات أثناء الترقية السابقة، فأكمِلها مرة أخرى قبل المتابعة في الترقية إلى الإصدار 4.54.00.

• إيقاف apigee-monit: إذا كان apigee-monit قيد التشغيل على العقدة، أوقِفه باستخدام /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop قبل الترقية. يمنع ذلك apigee-monit من إعادة تشغيل المكوّنات تلقائيًا أثناء ترقيتها. أعِد تفعيلها باستخدام الأمر apigee-service apigee-monit start بعد اكتمال الترقية.

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

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

ترقية جهاز التوجيه ومعالج الرسائل

يمكنك ترقية جميع عُقد "الموجّهات" و"معالج الرسائل" في مراكز البيانات واحدة تلو الأخرى:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

ترقية خادم الإدارة

يمكنك ترقية جميع عُقد Management Server في مراكز البيانات واحدة تلو الأخرى:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

الترقية إلى الإصدار 2.6.10 من OpenLDAP

يقدّم الإصدار 4.54.00 من Edge for Private Cloud الإصدار 2.6.10 من OpenLDAP. تنطبق هذه الترقية على جميع بُنى نشر Apigee OpenLDAP: الخادم الفردي، والنشط-السلبي، والنشط-النشط (متعدد الأجهزة الرئيسية).

التحضير والتثبيت (جميع خوادم LDAP)

الترقية إلى واجهة مستخدم Edge الجديدة وخدمة الدخول المُوحَّد (SSO) في Apigee (في حال التثبيت)

في الإصدار 4.54.00 من Apigee Edge for Private Cloud، تمت إزالة واجهة المستخدم الكلاسيكية (edge-ui) واستبدالها بواجهة مستخدم Edge الجديدة (edge-management-ui). بناءً على ما إذا كان قد تم تثبيت خدمة الدخول الموحّد (SSO) من Apigee واستخدامها في الإعداد، اتّبِع أحد الخيارَين أدناه:

# Authentication mode for New Edge UI (Basic Authentication - No Apigee SSO)
AUTH_MODE=basic

# Access configuration for the New Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_SCHEME=http

/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

apigee-service apigee-sso stop

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f configFile

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

apigee-service apigee-sso uninstall

الترقية إلى Qpid 10.0.1

تضمن هذه الطريقة عدم توقّف بيئة وقت تشغيل Edge وتقلّل من فقدان بيانات وقت التشغيل، إن وُجدت، التي تم الحصول عليها لأغراض الإحصاءات.

لإجراء ترقية في مكانه بدون توقّف إلى Qpid:

1. اختَر عقدة Qpid واحدة للبدء بها.

2. أوقِف وسيط Qpid على العقدة:

   apigee-service apigee-qpidd stop

3. احظر حركة البيانات الواردة على منفذ الوسيط 5672 من جميع معالِجات الرسائل من خلال تطبيق جدار حماية. يمكنك تطبيق جدار الحماية هذا على مستوى مثيل عقدة Qpid أو بعض مكوّنات جدار الحماية/الشبكة الخارجية الأخرى.

   ننصحك بتنفيذ الخطوة نفسها لجميع عناوين IP الخاصة بمعالِجات الرسائل. على سبيل المثال، لإسقاط الطلبات الواردة من عناوين IP الخاصة بمعالج الرسائل إلى عقدة Qpid على المنفذ 5672 باستخدام IPTables، يمكنك استخدام أمر مثل هذا:

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

4. ابدأ تشغيل وسيط Qpid مرة أخرى لتفريغ الرسائل الحالية، إن وجدت:

   apigee-service apigee-qpidd start

5. تأكَّد من أنّ قوائم الانتظار الحالية فارغة:

   /opt/apigee/apigee-qpidd/bin/qpid-stat -q

   إذا كانت الرسائل عالقة في قائمة انتظار الرسائل غير الصالحة (DLQ) (ax-q-axgroup-001-consumer-group-001-dl)، يمكنك تفريغ قائمة الانتظار باتّباع خطوات حلّ مشكلة بيانات الإحصاءات العالقة في قائمة انتظار الرسائل غير الصالحة.

6. بعد التأكّد من إفراغ قوائم الانتظار على العقدة القديمة، أوقِف apigee-qpidd:

   apigee-service apigee-qpidd stop

7. ترقية Qpid على العقدة:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

8. إعادة تشغيل "edge-qpid-server":

   apigee-service edge-qpid-server restart

9. أزِل قاعدة جدار الحماية التي تم تطبيقها في الخطوة 3.

   نفِّذ خطوة الإزالة نفسها لجميع عناوين IP الخاصة بمعالِجات الرسائل التي تم تطبيق جدار الحماية عليها. بعد إزالة جدران الحماية، سيتم قبول الطلبات الواردة من عناوين IP الخاصة بمعالج الرسائل إلى عقدة Qpid على المنفذ 5672. إذا استخدمت iptables لإضافة جدار الحماية، يمكنك استخدام أوامر مثل ما يلي لإزالة جدار الحماية وإدراج الإعدادات الحالية:

   iptables -F
   iptables -L

10. استخدِم ميزة "مراقبة الويب" للتأكّد من أنّ قوائم انتظار Qpid تتلقّى الرسائل:

    http://QPID_NODE_IP:8090

11. كرِّر الخطوات من 1 إلى 9 لكل عقدة Qpid.

الترقية إلى Postgres 18.6

يتضمّن هذا الإصدار من Edge ترقية إلى Postgres 18.6. كجزء من هذه الترقية، يتم نقل جميع بيانات Postgres إلى Postgres 18.6

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

تعتمد طريقة إجراء تحديث Postgres على كيفية ضبط مساحة تخزين البيانات لعُقد Postgres:

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

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

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

تثبيت عقدة احتياطية جديدة في Postgres

يؤدي هذا الإجراء إلى إنشاء خادم احتياطي Postgres على عقدة جديدة. تأكَّد من تثبيت خادم احتياطي جديد لـ Postgres لإصدار Edge الحالي (4.53.00 أو 4.53.01)، وليس للإصدار 4.54.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 primary(master):
      PG_MASTER=PG_MASTER_NODE_IP
      # IP address of the new standby node
      PG_STANDBY=PG_STANDBY_NODE_IP

   2. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge.

   3. نزِّل نص Bootstrap البرمجي وشغِّله استنادًا إلى إصدار Edge الحالي:

      • إذا كنت تستخدم حاليًا الإصدار 4.53.00 من Edge:

        نزِّل ملف Edge bootstrap_4.53.00.sh على /tmp/bootstrap_4.53.00.sh:

        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

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

        bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

      • إذا كنت تستخدم حاليًا الإصدار 4.53.01 من Edge:

        نزِّل ملف Edge bootstrap_4.53.01.sh على /tmp/bootstrap_4.53.01.sh:

        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

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

        bash /tmp/bootstrap_4.53.01.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، اتّبِع الخطوات التالية على كل من المضيف الأساسي والمضيف الاحتياطي لتعديل السمة max_locks_per_transaction في apigee-postgresql:

1. إذا لم يكن الملف متوفّرًا، أنشِئ الملف /opt/apigee/customer/application/postgresql.properties .

2. غيِّر ملكية هذا الملف إلى apigee :

   chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

3. أضِف السمة التالية إلى الملف:

   conf/postgresql.conf+max_locks_per_transaction=30000

4. اضبط apigee-postgresql :

   apigee-service apigee-postgresql configure

5. أعِد تشغيل apigee-postgresql :

   apigee-service apigee-postgresql restart

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

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

1. ترقية postgres على المضيف الأساسي

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

2. شغِّل أمر الإعداد على المضيف الأساسي:

   apigee-service apigee-postgresql setup -f configFile

3. نفِّذ أمر الضبط على المضيف الأساسي:

   apigee-service apigee-postgresql configure

4. أعِد تشغيل المضيف الأساسي:

   apigee-service apigee-postgresql restart

5. اضبطه كجهاز أساسي:

   apigee-service apigee-postgresql setup-replication-on-master -f configFile

6. تأكَّد من بدء المضيف الأساسي:

   apigee-service apigee-postgresql wait_for_ready

7. لإيقاف وضع الاستعداد:

   apigee-service apigee-postgresql stop

8. ترقية الجهاز الاحتياطي

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

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

9. تأكَّد من إيقاف وضع الاستعداد:

   apigee-service apigee-postgresql stop

10. أزِل الإعدادات الاحتياطية القديمة:

    rm -rf /opt/apigee/data/apigee-postgresql/

11. إعداد النسخ المتماثل على الخادم الاحتياطي:

    apigee-service apigee-postgresql setup-replication-on-standby -f configFile

12. أزِل السطر conf/postgresql.conf+max_locks_per_transaction=30000 من الملف /opt/apigee/customer/application/postgresql.properties على كل من المضيف الأساسي والمضيف الاحتياطي. تمت إضافة هذا السطر في الخطوة التمهيدية .

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

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

الخطوات التي يجب اتّباعها بعد ترقية Postgres

بعد ترقية Postgres الرئيسية، يتم محو الإحصاءات الداخلية لـ Postgres. تساعد هذه الإحصاءات مخطِّط طلبات البحث في Postgres على استخدام الفهارس والمسارات الأكثر ملاءمةً لتنفيذ الطلبات.

يمكن لـ Postgres إعادة إنشاء إحصاءاته تدريجيًا بمرور الوقت أثناء تنفيذ طلبات البحث وعند تشغيل برنامج autovacuum daemon. ومع ذلك، قد تكون طلبات البحث بطيئة إلى أن تتم إعادة إنشاء الإحصاءات.

لحلّ هذه المشكلة، نفِّذ الأمر ANALYZE على جميع الجداول في قاعدة البيانات على عقدة Postgres الأساسية. بدلاً من ذلك، يمكنك تنفيذ ANALYZE لعدد قليل من الجداول في كل مرة.

الترقية إلى ZooKeeper 3.8.5

يتضمّن هذا الإصدار من Edge for Private Cloud ترقية إلى ZooKeeper 3.8.5. كجزء من هذه الترقية، سيتم نقل جميع بيانات ZooKeeper إلى الإصدار 3.8.5 من ZooKeeper.

قبل ترقية ZooKeeper، اطّلِع على دليل صيانة ZooKeeper. تستخدم معظم أنظمة إنتاج Edge مجموعة من عُقد ZooKeeper موزّعة على مراكز بيانات متعددة. يتم ضبط بعض هذه العُقد كمصوّتين يشاركون في انتخاب قائد ZooKeeper، ويتم ضبط الباقي كمراقبين. لمزيد من التفاصيل، يُرجى الاطّلاع على لمحة عن القادة والمتابعين والمصوّتين والمراقبين. تنتخب عُقد التصويت قائدًا، وبعد ذلك تصبح عُقد التصويت نفسها تابعة.

أثناء عملية التحديث، قد يحدث تأخير مؤقت أو فشل في الكتابة في ZooKeeper عند إيقاف العقدة الرئيسية. قد يؤثر ذلك في عمليات الإدارة التي تتم كتابتها في ZooKeeper، مثل عملية نشر خادم وكيل، وتغييرات البنية الأساسية في Apigee، مثل إضافة معالج رسائل أو إزالته، وما إلى ذلك. من المفترض ألا يكون هناك أي تأثير في واجهات برمجة التطبيقات الخاصة بوقت التشغيل في Apigee (ما لم تطلب واجهات برمجة التطبيقات الخاصة بوقت التشغيل هذه واجهات برمجة تطبيقات الإدارة) أثناء ترقية ZooKeeper مع اتّباع الإجراء أدناه.

بشكل عام، تتضمن عملية الترقية أخذ نسخة احتياطية من كل عقدة. ويلي ذلك ترقية جميع المراقبين والمتابعين، وأخيرًا ترقية العقدة الرئيسية.

الاحتفاظ بنسخة احتياطية

احتفِظ بنسخة احتياطية من جميع عُقد ZooKeeper لاستخدامها في حال الحاجة إلى العودة إلى إصدار سابق. يُرجى العِلم أنّ عملية العودة إلى إصدار سابق ستؤدي إلى استعادة ZooKeeper إلى الحالة التي كان عليها عند الاحتفاظ بالنسخة الاحتياطية.

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

إذا كنت تستخدم أجهزة افتراضية ولديك الإمكانية، يمكن أيضًا أخذ لقطات أو نُسخ احتياطية من الأجهزة الافتراضية لاستعادتها أو التراجع عنها (إذا لزم الأمر).

تحديد القائد والمتابعين والمراقبين

1. إذا لم يكن مثبّتًا على عقدة ZooKeeper، ثبِّت nc:

   yum install nc

2. نفِّذ الأمر nc التالي على العقدة، حيث 2181 هو منفذ ZooKeeper:

   echo stat | nc localhost 2181

   من المفترض أن تظهر لك نتيجة مثل ما يلي:

   Zookeeper version: 3.8.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-03 21:35 UTC
   Clients:
    /[0:0:0:0:0:0:0:1]:40696[0](queued=0,recved=1,sent=0)
   
   Latency min/avg/max: 3/4.3333/6
   Received: 4
   Sent: 3
   Connections: 1
   Outstanding: 0
   Zxid: 0x500000005
   Mode: follower

   في السطر Mode من الناتج للعُقد، من المفترض أن يظهر لك "مراقب" أو "قائد" أو "تابع" (أي ناخب ليس القائد) حسب إعدادات العقدة.

1. كرِّر الخطوتَين 1 و2 على كل عقدة ZooKeeper.

ترقية ZooKeeper على عُقد المراقبة والمتابعة

يمكنك ترقية ZooKeeper على كلّ من عُقد المراقِب والمتابع على النحو التالي:

1. نزِّل برنامج الإعداد Edge for Private Cloud 4.54.00 وشغِّله، كما هو موضّح في التحديث إلى الإصدار 4.54.00 على عقدة تتضمّن اتصالاً خارجيًا بالإنترنت . من المرجّح أن تختلف العملية استنادًا إلى ما إذا كان العقدة يتضمّن اتصالاً خارجيًا بالإنترنت أو إذا كنت تُجري عملية تثبيت بلا إنترنت.

2. ترقية مكوّن ZooKeeper:

   /opt/apigee/apigee-setup/bin/update.sh -c zk -f silent-config-file

   ملاحظة: إذا كانت هذه العُقد تحتوي على مكوّنات أخرى مثبّتة (مثل Cassandra)، يمكنك ترقيتها أيضًا الآن (مثل ملف zk,cs الشخصي) أو يمكنك ترقية المكوّنات الأخرى لاحقًا. تنصح Apigee بترقية ZooKeeper فقط أولاً والتأكّد من أنّ المجموعة تعمل بشكل صحيح قبل ترقية المكوّنات الأخرى.

3. كرِّر الخطوات أعلاه على كل عُقدة مراقبة ومتابعة في ZooKeeper.

أوقِف المتصدّر

بعد ترقية جميع عُقد المراقبة والمتابعة، أوقِف العقدة الرئيسية. على العقدة المحدّدة كقائد، نفِّذ الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

يُرجى العِلم أنّه خلال هذا الحدث، وقبل انتخاب قائد جديد، قد تحدث حالات تأخير مؤقتة أو حالات فشل في الكتابة في ZooKeeper. قد يؤثر ذلك في العمليات التي تتم كتابتها في ZooKeeper، مثل إجراء نشر الخوادم الوكيلة أو تغييرات البنية الأساسية في Apigee، مثل إضافة معالجات الرسائل أو إزالتها وما إلى ذلك.

التحقّق من انتخاب القائد الجديد

باستخدام الخطوات الواردة في قسم تحديد القائد والمتابعين والمراقبين أعلاه، تأكَّد من انتخاب قائد جديد من المتابعين، بعد إيقاف القائد الحالي. يُرجى العِلم أنّه من الممكن أن يكون قد تم اختيار القائد في مركز بيانات مختلف عن القائد الحالي.

ترقية القائد

اتّبِع الخطوات نفسها الموضّحة في قسم ترقية ZooKeeper على عُقد المراقبة والمتابعة أعلاه.

بعد ترقية عقدة القائد القديمة أيضًا، تحقَّق من سلامة المجموعة وتأكَّد من وجود عقدة قائد.

الترقية إلى Cassandra 5.0.8

يتضمّن الإصدار 4.54.00 من Apigee Edge for Private Cloud ترقية Cassandra إلى الإصدار 5.0.8.

الترقيات والعودة إلى إصدار سابق

• تتم الترقية من Cassandra 4.0.X إلى Cassandra 5.0.X بشكل تدريجي.

• لا يمكن العودة مباشرةً من الإصدار 5.0.X من Cassandra إلى الإصدار 4.0.X. إنّ العودة إلى إصدار سابق باستخدام النُسخ المتماثلة أو النُسخ الاحتياطية هو إجراء معقّد وقد يؤدي إلى توقّف الخدمة و/أو فقدان البيانات. يُفضَّل تحديد المشاكل وحلّها والترقية إلى الإصدار 5.0.X من Cassandra بدلاً من العودة إلى إصدار سابق.

• من المهم التعرّف على إجراءات العودة إلى الإصدار السابق قبل محاولة الترقية. من المهم مراعاة الفروق الدقيقة في عملية العودة إلى إصدار سابق أثناء الترقية لضمان توفّر مسارات مناسبة للعودة إلى إصدار سابق.

مركز بيانات واحد

تتم ترقية Cassandra من الإصدار 4.0.X إلى الإصدار 5.0.X ضمن مركز بيانات واحد بسلاسة، ولكن عملية العودة إلى الإصدار السابق معقّدة وقد تؤدي إلى توقّف الخدمة وفقدان البيانات. بالنسبة إلى أعباء العمل في مرحلة الإنتاج، ننصح بشدة بإضافة مركز بيانات جديد يتضمّن على الأقل عُقد Cassandra في مركز البيانات الجديد قبل بدء الترقية. سيؤدي ذلك إلى تفعيل عملية العودة إلى إصدار سابق من Cassandra بدون فقدان البيانات أو انقطاع في زيارات واجهة برمجة التطبيقات. ويمكن إيقاف تشغيل مركز البيانات الإضافي هذا بعد الانتهاء من الترقية.

إذا لم تكن إضافة مركز بيانات جديد ممكنة ولكن لا تزال إمكانية العودة إلى الإصدار السابق مطلوبة، ستكون النُسخ الاحتياطية ضرورية لاستعادة Cassandra 4.0.X. ومع ذلك، من المرجّح أن تتضمّن هذه الطريقة كلاً من فترة التوقّف عن العمل وفقدان البيانات.

مراكز بيانات متعددة

يوفّر تشغيل مراكز بيانات متعددة باستخدام Edge for Private Cloud 4.53.00 (أو) 4.53.01 مرونة أكبر في عمليات العودة إلى الإصدارات السابقة أثناء الترقية إلى Edge for Private Cloud 4.54.00.

• تتطلّب عمليات العودة إلى الإصدار السابق وجود مركز بيانات واحد على الأقل يشغّل إصدار Cassandra السابق (4.0.X).

منهجية الترقية المقترَحة

1. ترقية مركز بيانات Cassandra واحد في كل مرة: ابدأ بترقية عُقد Cassandra بشكل فردي داخل مركز بيانات واحد. أكمِل ترقيات جميع عُقد Cassandra في مركز بيانات واحد قبل الانتقال إلى المركز التالي.

2. الإيقاف المؤقت والتحقّق: بعد ترقية مركز بيانات واحد، أوقِف العملية مؤقتًا للتأكّد من أنّ مجموعة السحابة الإلكترونية الخاصة، خاصةً مركز البيانات الذي تمت ترقيته، تعمل بشكل صحيح.

3. تذكير: يمكنك العودة إلى إصدار Cassandra السابق فقط إذا كان لديك مركز بيانات واحد على الأقل لا يزال يشغّل الإصدار القديم.

4. حساسة للوقت: على الرغم من أنّه يمكنك الإيقاف مؤقتًا لفترة قصيرة (يُنصح ببضع ساعات) للتحقّق من الوظائف، لا يمكنك البقاء في حالة الإصدار المختلط إلى أجل غير مسمى. ويرجع ذلك إلى أنّ مجموعة Cassandra غير الموحّدة (التي تحتوي على عُقد في إصدارات مختلفة) لها قيود تشغيلية.

5. الاختبار الشامل: تنصح Apigee بشدة بإجراء اختبار شامل للأداء والوظائف قبل ترقية مركز البيانات التالي. بعد ترقية جميع مراكز البيانات، لا يمكن العودة إلى الإصدار السابق.

عملية العودة إلى نقطة التحقّق السابقة

نقطة تحقّق واحدة للتراجع: عند ترقية جميع المكوّنات إلى الإصدار 4.54.00، يظل التراجع عن Cassandra ممكنًا فقط إذا استمر مركز بيانات Cassandra واحد على الأقل في تشغيل الإصدار الأقدم. بعد ترقية مركز بيانات Cassandra النهائي، تكتمل الترقية إلى الإصدار 4.54.00 من Edge for Private Cloud، ولن يعود من الممكن التراجع عن الترقية.

مثال

لنفترض أنّ لديك مجموعة بيانات تتألف من مركزَي بيانات:

1. حالة البدء: عُقد Cassandra في كلا مركزَي البيانات تعمل بالإصدار 4.0.X. وتكون جميع العُقد الأخرى على الإصدار 4.54.00 من Edge for Private Cloud. افترِض أنّ هناك ثلاث عُقد Cassandra لكل مركز بيانات.

2. ترقية DC-1: يمكنك ترقية عُقد Cassandra الثلاث في DC-1 واحدة تلو الأخرى.

3. الإيقاف المؤقت والتحقّق: أوقِف العملية مؤقتًا للتأكّد من أنّ المجموعة، لا سيما DC-1، تعمل بشكل صحيح (تحقَّق من الأداء والوظائف). يمكنك العودة إلى الحالة الأولية باستخدام عُقد Cassandra في DC-2. يُرجى العِلم أنّ هذا الإيقاف المؤقت يجب أن يكون مؤقتًا بسبب القيود المفروضة على مجموعة Cassandra ذات الإصدارات المختلطة.

4. ترقية DC-2: يمكنك ترقية عُقد Cassandra الثلاث المتبقية في DC-2. بعد ترقية جميع عُقد Cassandra في DC-2 بنجاح، تكتمل ترقية Edge for Private Cloud 4.54.00.

المتطلبات الأساسية لترقية Cassandra

يجب استخدام Cassandra 4.0.X مع Edge for Private Cloud 4.53.00 (أو) 4.53.01 والتأكّد مما يلي:

1. اضبط Java 17 كإصدار Java التلقائي على الخادم: يزيل Cassandra 5.0.X التوافق مع Java 8. لا يمكنك تشغيل Cassandra 5.0.X أو أداة nodetool المساعدة باستخدام Java 8. تأكَّد من تثبيت Java 17 على كل عقدة Cassandra واضبط Java 17 كإصدار Java التلقائي قبل تنفيذ خطوات ترقية Cassandra لكي يتم تنفيذ أوامر nodetool باستخدام Java 17:

   alternatives --set java JAVA_17_PATH/bin/java

   تأكَّد من أنّ إصدار Java التلقائي النشط هو Java 17:

   java -version

2. تكون المجموعة بالكامل قيد التشغيل وتعمل بكامل طاقتها مع Cassandra 4.0.X.

3. تم ضبط استراتيجية الضغط على LeveledCompactionStrategy (شرط أساسي للترقية إلى الإصدار 4.53.00 (أو) 4.53.01).

4. تأكَّد من إكمال كل خطوة أدناه كجزء من الترقية الأولية لإصدار Cassandra 4.0.X في Edge for Private Cloud من الإصدار 4.53.00 (أو) 4.53.01.

   • تم تنفيذ الأمر post_upgrade على كل عقدة Cassandra أثناء الترقية السابقة

   • تم تنفيذ الأمر drop_old_tables على مجموعة Cassandra بالكامل أثناء الترقية السابقة.

إذا لم تكن متأكدًا من تنفيذ الأمرَين post_upgrade وdrop_old_tables على Cassandra 4.0.X أثناء استخدام Edge for Private Cloud 4.53.00 (أو) 4.53.01، يمكنك إعادة تشغيلهما بأمان قبل محاولة الترقية إلى 4.54.00.

الخطوة 1: الاستعداد للترقية

تُضاف الخطوات أدناه إلى الملفات العادية التي تنشئها عادةً، مثل ملف الإعداد العادي في Apigee لتفعيل ترقيات المكوّنات.

1. الاحتفاظ بنسخة احتياطية من Cassandra باستخدام Apigee

2. التقاط لقطات من الأجهزة الافتراضية لعُقد Cassandra (إذا كان ذلك ممكنًا)

3. تأكَّد من إمكانية الوصول إلى المنفذ 9042 من جميع مكوّنات Edge for Private Cloud، بما في ذلك خادم الإدارة ومعالج الرسائل وجهاز التوجيه وQpid وPostgres، إلى عُقد Cassandra إذا لم يتم ضبطها من قبل. يُرجى الاطّلاع على متطلبات المنفذ لمزيد من المعلومات.

الخطوة 2: ترقية جميع عُقد Cassandra

يجب تحديث جميع عُقد Cassandra واحدة تلو الأخرى في كل مركز بيانات، مركز بيانات واحد في كل مرة. بين ترقيات العُقد داخل مركز بيانات، انتظِر بضع دقائق للتأكّد من أنّ العقدة التي تم تعديلها قد بدأت بالكامل وانضمت إلى المجموعة قبل المتابعة في ترقية عقدة أخرى في مركز البيانات نفسه.

بعد ترقية جميع عُقد Cassandra داخل مركز بيانات، انتظِر لبعض الوقت (من 30 دقيقة إلى بضع ساعات) قبل المتابعة مع العُقد في مركز البيانات التالي. خلال هذه الفترة، راجِع مركز البيانات الذي تم تحديثه بدقة وتأكَّد من أنّ مقاييس الأداء والوظائف لمجموعة Apigee سليمة. هذه الخطوة ضرورية لضمان استقرار مركز البيانات الذي تمت فيه ترقية Cassandra إلى الإصدار 5.0.X، بينما تمت ترقية بقية مكوّنات Apigee إلى الإصدار 4.54.00.

1. لترقية عقدة Cassandra، نفِّذ الأمر التالي:

   /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

2. بعد تعديل عقدة، نفِّذ الأمر التالي على العقدة لإجراء بعض عمليات التحقّق قبل المتابعة:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile

3. سيؤدي ما سبق إلى إخراج شيء على غرار:

   Cassandra version is verified - [cqlsh 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
   Metadata is verified

4. نفِّذ الأمر post_upgrade التالي على عقدة Cassandra:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

5. نفِّذ الأمر cleanup_old_index التالي على عقدة Cassandra:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index

6. نفِّذ أوامر nodetool التالية لإعادة إنشاء الفهارس على عقدة Cassandra:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx    
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx

إذا كنت تستخدم ميزة تحقيق الربح، يمكنك أيضًا تشغيل أوامر إعادة إنشاء الفهارس التالية ذات الصلة بمساحات مفاتيح تحقيق الربح:

/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

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

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

• إلغاء تثبيت Apigee mTLS .

• أعِد تثبيت Apigee mTLS .

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

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

إذا تطلّب تعذُّر التحديث العودة إلى الإصدار السابق، يُرجى الاطّلاع على العودة إلى الإصدار 4.54.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 for Private Cloud 4.53.00 أو 4.53.01، قد تحتاج إلى إجراء تغييرات على مكوّنات مثل واجهة المستخدم والدخول الموحّد (SSO)، كما هو موضّح في الترقية إلى واجهة مستخدم Edge الجديدة وApigee SSO (في حال تثبيتها).

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

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

1. في حال توفّر أي مهام cron تم ضبطها لإجراء عملية إصلاح على Cassandra، يجب إيقافها إلى أن يكتمل التحديث.

2. سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم RPM في Edge.

   ملاحظة: على الرغم من أنّ تثبيت RPM يتطلّب الوصول إلى الجذر، يمكنك ضبط Edge بدون الوصول إلى الجذر.

3. أوقِف SELinux على النحو الموضّح في تثبيت أداة apigee-setup في Edge .

4. في حال التثبيت على AWS ، نفِّذ أوامر yum-configure-manager التالية:

   yum update rh-amazon-rhui-client.noarch
   yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

5. إذا كنت تستخدم حاليًا الإصدار 4.53.00 (أو) 4.53.01 من Edge for Private Cloud:

   1. نزِّل ملف Edge bootstrap_4.54.00.sh إلى /tmp/bootstrap_4.54.00.sh :

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

   2. ثبِّت أداة Edge 4.54.00 apigee-service والتبعيات من خلال تنفيذ الأمر التالي:

      bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

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

      يتحقّق برنامج التثبيت تلقائيًا من تثبيت Java 17 و21.

   3. استخدِم apigee-service لتحديث الأداة المساعدة apigee-setup، كما هو موضّح في المثال التالي:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. عدِّل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في المثال التالي:

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. عدِّل الأداة المساعدة apigee-provision على خادم الإدارة، كما هو موضّح في المثال التالي:

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. شغِّل الأداة المساعدة update على العُقد من خلال تنفيذ الأمر التالي:

      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

      المكان:

      • ‫component هو مكوّن Edge المطلوب تحديثه. تشتمل القيم المحتملة ما يلي:

        • edge : جميع مكوّنات Edge باستثناء واجهة مستخدم Edge الجديدة: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres

        • ldap : OpenLDAP

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

        • ‫qpid : Apigee Qpid

        • ‫ps : Apigee Postgresql

        • ‫zk : ZooKeeper

        • ‫cs : Cassandra

      • ‫configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكوّنات Edge أثناء تثبيت الإصدار 4.53.00 (أو) 4.53.01.

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

   7. أعِد تشغيل مكوّنات واجهة مستخدم Edge الجديدة على جميع العُقد التي تشغّلها، إذا لم يسبق لك إجراء ذلك:

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

   8. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.

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

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

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

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

• أنشئ ملف ‎ .tar للمستودع، وانسخ ملف ‎ .tar إلى عقدة، ثم حدِّث Edge من ملف ‎ .tar.

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

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

1. أنشئ مستودعًا محليًا للإصدار 4.54.00 كما هو موضّح في "إنشاء مستودع Apigee محلي" في تثبيت أداة apigee-setup في Edge.

2. ثبِّت apigee-service على العُقد المستهدَفة باستخدام إحدى الطرق التالية:

   • الخيار 1: تثبيت apigee-service من ملف ‎ .tar

     1. على العقدة التي تحتوي على المستودع المحلي، استخدِم الأمر التالي لإنشاء حزمة للمستودع المحلي في ملف ‎ .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz:

        /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

     2. انسخ ملف ‎ .tar إلى العقدة التي تريد تحديث Edge فيها. على سبيل المثال، انسخه إلى الدليل /tmp على العقدة الجديدة.

     3. على العقدة الجديدة، فُكّ ضغط الملف إلى الدليل /tmp:

        tar -xzf apigee-4.54.00.tar.gz

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

     4. ثبِّت أداة Edge apigee-service والتبعيات من /tmp/repos:

        bash /tmp/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

   • الخيار 2: تثبيت apigee-service باستخدام خادم الويب Nginx

     1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم الويب Nginx" في تثبيت أداة إعداد Edge apigee-setup.

     2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.54.00.sh إلى /tmp/bootstrap_4.54.00.sh:

        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

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

     3. على العقدة البعيدة، ثبِّت أداة Edge apigee-service والتبعيات:

        bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

3. استخدِم apigee-service لتحديث الأداة المساعدة apigee-setup، كما هو موضّح في المثال التالي:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

4. عدِّل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في المثال التالي:

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

5. عدِّل الأداة المساعدة apigee-provision على خادم الإدارة، كما هو موضّح في المثال التالي:

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

6. شغِّل الأداة المساعدة update على العُقد بالترتيب الموضَّح في ترتيب تحديث الجهاز:

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   المكان:

   • ‫component هو مكوّن Edge المطلوب تحديثه. تشتمل القيم المحتملة ما يلي:

     • edge : جميع مكوّنات Edge باستثناء واجهة مستخدم Edge الجديدة: خادم الإدارة ومعالج الرسائل والموجّه وخادم QPID وخادم Postgres

     • ldap : OpenLDAP

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

     • ‫qpid : Apigee Qpid

     • ‫ps : Apigee Postgresql

     • ‫zk : ZooKeeper

     • ‫cs : Cassandra

   • ‫configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكوّنات Edge أثناء تثبيت الإصدار 4.53.00 (أو) 4.53.01.

     ملاحظة: يجب أن يكون ملف الإعداد قابلاً للقراءة من قِبل مستخدم "apigee". لتغيير المالك، استخدِم الأمر التالي:

     chown apigee:apigee configFile

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

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

7. أعِد تشغيل مكوّنات واجهة المستخدم على جميع العُقد التي تشغّلها، إذا لم تكن قد فعلت ذلك من قبل:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

8. اختبِر التحديث من خلال تشغيل الأداة المساعدة apigee-validate على خادم الإدارة، كما هو موضّح في اختبار التثبيت.

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

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

يُعدّ ترتيب تحديث الأجهزة في عملية تثبيت Edge أمرًا مهمًا. يُرجى ترقية المكوّنات بالترتيب التالي.

1. يمكنك ترقية جميع عُقد "الموجّه" و"معالج الرسائل" في جميع مراكز البيانات باستخدام الخيار -c edge.

2. يمكنك ترقية جميع عُقد خادم الإدارة في جميع مراكز البيانات باستخدام الخيار -c edge.

3. ترقية جميع عُقد LDAP في جميع مراكز البيانات في حال الترقية من Edge for Private Cloud 4.53.00، عليك اتّباع خطوات إضافية لترقية LDAP

4. ترقية واجهة المستخدم وخدمة الدخول المُوحَّد (SSO) في Apigee (إذا كانت مثبّتة) في جميع مراكز البيانات:

   1. في حال عدم تثبيت apigee-sso: اتّبِع الخيار 1: ترقية واجهة المستخدم (بدون Apigee SSO) للترقية إلى واجهة مستخدم Edge الجديدة.

   2. في حال تثبيت apigee-sso: اتّبِع الخيار 2: ترقية واجهة المستخدم (باستخدام Apigee SSO) للترقية إلى واجهة مستخدم Edge الجديدة وApigee SSO.

5. يمكنك ترقية جميع مكوّنات Qpid وedge-qpid-server في جميع مراكز البيانات باتّباع الخطوات الخاصة بـ Qpid.

6. ترقية جميع مكوّنات Postgresql وedge-postgres-server في جميع مراكز البيانات باتّباع الخطوات الخاصة بـ Postgres

7. يمكنك ترقية جميع مكوّنات Zookeeper في جميع مراكز البيانات باتّباع الخطوات الخاصة لترقية Zookeeper.

8. يمكنك ترقية جميع مكوّنات Cassandra في جميع مراكز البيانات باتّباع الخطوات الخاصة بترقية Cassandra.

9. ما مِن خطوة منفصلة لتعديل ميزة تحقيق الربح. ويتم تعديله عند تحديد الخيار -c edge.

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

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

عند الترقية من الإصدار 4.53.00 من Edge for Private Cloud، يجب ترقية LDAP أولاً باتّباع خطوات الترقية من الإصدار 4.53.00 إلى الإصدار 4.54.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. تحديث مكوّنات Edge على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

2. تعديل LDAP على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

3. تحديث واجهة مستخدم Edge الجديدة على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

4. تحديث مكوّنات Edge على الجهاز 2:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. تحديث Qpid على الجهاز 2:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

6. تحديث Postgres على الجهاز 2:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

7. تحديث Cassandra وZooKeeper على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

8. (في حال تثبيت apigee-adminapi) حدِّث الأداة المساعدة apigee-adminapi على الجهاز 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

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

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

1. تحديث مكوّنات Edge على الجهاز 2 و3 و1:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

2. تعديل LDAP على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

3. تحديث واجهة مستخدم Edge الجديدة في الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

4. تحديث مكوّنات Edge على الجهازَين 4 و5:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. تحديث Qpid على الجهاز 4 و5:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

6. تعديل Postgres على الجهازَين 4 و5:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

7. حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3:

   /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

8. (في حال تثبيت apigee-adminapi) حدِّث الأداة المساعدة apigee-adminapi على الجهاز 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ترقية مجمّعة من 9 عُقد

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

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

1. تحديث مكوّنات Edge على الأجهزة 4 و5 و1 (جهاز التوجيه ومعالج الرسائل وخادم الإدارة) بهذا الترتيب:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

2. تعديل LDAP على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

3. تحديث واجهة مستخدم Edge الجديدة في الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

4. حدِّث مكوّنات Edge على الأجهزة 6 و7 و8 و9 بهذا الترتيب:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. تحديث Qpid على الجهازين 6 و7:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

6. تحديث Postgres على الجهاز 8:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

7. تحديث Postgres على الجهاز 9:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

8. حدِّث Cassandra وZooKeeper على الأجهزة 1 و2 و3:

   /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

9. (في حال تثبيت apigee-adminapi) حدِّث الأداة المساعدة apigee-adminapi على الجهاز 1:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ترقية مجموعة من 13 عقدة

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

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

1. حدِّث مكوّنات Edge على الأجهزة 10 و11 و6 و7 بهذا الترتيب:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

2. تعديل LDAP على الجهازَين 4 و5:

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

3. تحديث واجهة مستخدم Edge الجديدة في الجهازَين 6 و7:

   /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

4. حدِّث مكوّنات Edge على الأجهزة 12 و13 و8 و9 بهذا الترتيب:

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. تحديث Qpid على الجهازين 12 و13:

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

6. تحديث Postgres على الجهاز 8:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

7. تحديث Postgres على الجهاز 9:

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

8. تحديث Cassandra وZooKeeper على الأجهزة 1 و2 و3:

   /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

9. (في حال تثبيت apigee-adminapi) حدِّث الأداة المساعدة apigee-adminapi على الجهازَين 6 و7:

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ترقية مجموعة من 12 عقدة

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

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

1. تعديل مكوّنات Edge (الموجّه ومعالج الرسائل):

   • على الجهازَين 2 و3 في مركز البيانات 1:

     /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   • على الجهازَين 8 و9 في مركز البيانات 2:

     /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

2. تحديث مكوّنات Edge (خادم الإدارة):

   • على الجهاز 1 في مركز البيانات 1:

     /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   • على الجهاز 7 في مركز البيانات 2:

     /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

3. تعديل LDAP:

   • الجهاز 1 في مركز البيانات 1:

     /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   • الجهاز 7 في مركز البيانات 2:

     /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. تحديث مكوّنات واجهة مستخدم New Edge:

   • على الجهاز 1 في مركز البيانات 1:

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

   • على الجهاز 7 في مركز البيانات 2:

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

5. تحديث مكوّنات Edge:

   • الأجهزة 4 و5 و6 في مركز البيانات 1:

     /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   • الأجهزة 10 و11 و12 في مركز البيانات 2:

     /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. تعديل qpidd:

   • الجهازان 4 و5 في مركز البيانات 1:

     /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   • الجهازان 10 و11 في مركز البيانات 2:

     /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

7. تعديل Postgres:

   • الجهاز 6 في مركز البيانات 1:

     /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   • الجهاز 12 في مركز البيانات 2:

     /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

8. تحديث Cassandra وZooKeeper:

   • الأجهزة 1 و2 و3 في مركز البيانات 1:

     /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

   • على الأجهزة 7 و8 و9 في مركز البيانات 2:

     /opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile

9. (في حال تثبيت apigee-adminapi) حدِّث الأداة المساعدة apigee-adminapi:

   • الجهاز 1 في مركز البيانات 1:

     /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   • الجهاز 7 في مركز البيانات 2:

     /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

لإعداد غير عادي

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

1. جهاز التوجيه

2. معالج الرسائل

3. خادم الإدارة

4. LDAP

5. واجهة المستخدم (إما واجهة المستخدم الكلاسيكية أو واجهة المستخدم الجديدة)

6. الدخول المُوحَّد (SSO) (إن توفّر)

7. ‫Qpid وedge-qpid-server

8. ‫Postgres وedge-postgres-server

9. ZooKeeper

10. Cassandra

11. apigee-adminapi