تحديث 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 في الأصل، أو مستخدم لديه امتيازات الجذر.

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

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

يجب تحديث جميع مكوّنات 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" والتأثيرات المحتملة في وقت التشغيل وخطوات التخفيف. لمزيد من المعلومات، يُرجى الاطّلاع على تغييرات Nginx 1.30.

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

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

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

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

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

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

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

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

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

• التأكّد من تشغيل 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)

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

في الإصدار 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 الخفي. ومع ذلك، قد تكون طلبات البحث بطيئة إلى أن تتم إعادة إنشاء الإحصاءات.

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

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

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

قبل ترقية 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. نزِّل وأشغِل برنامج bootstrap الخاص بالإصدار 4.54.00 من Edge for Private Cloud، كما هو موضّح في التحديث إلى الإصدار 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. الإيقاف المؤقت والتحقّق من الصحة: بعد ترقية أحد مراكز البيانات، أوقِف العملية مؤقتًا للتأكّد من أنّ مجموعة Private Cloud، وخاصةً مركز البيانات الذي تمت ترقيته، تعمل بشكلٍ سليم.

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

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

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

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

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

مثال

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

1. حالة البدء: عُقد Cassandra في كلا مركزَي البيانات تعمل بالإصدار 4.0.X. تتوفّر جميع العُقد الأخرى على Edge للإصدار 4.54.00 من السحابة الخاصة. افترِض ثلاث عُقد 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

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

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 كما هو موضّح في تثبيت أداة Edge apigee-setup .

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، سيُطلب منك إدخاله.

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

   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 باستثناء واجهة مستخدم New 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 باستثناء واجهة مستخدم New 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:

عند الترقية من Edge for Private Cloud 4.53.00، يجب أولاً ترقية 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. تعديل واجهة مستخدم New 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