تحديث Apigee Edge 4.17.05 أو 4.17.09 إلى 4.18.05

الإصدار 4.18.05 من Edge for Private Cloud

يوضِّح هذا القسم كيفية إجراء الترقيات التالية:

• من 4.17.05 إلى 4.18.05
• من 4.17.09 إلى 4.18.05

جميع مسارات الترقية

يعرض الجدول التالي مسارات الترقية للإصدار 4.18.05:

من 4.18.01	الترقية مباشرةً من 4.18.01 ← 4.18.05
من 4.17.09	الترقية مباشرةً من 4.17.09 ← 4.18.05
من 4.17.05	الترقية مباشرةً من 4.17.05 ← 4.18.05
من 4.17.01	الترقية من الإصدارات 4.17.01 ← 4.18.01، ثم الترقية من 4.18.01 ← 4.18.05
من 4.16.09	الترقية من الإصدارات 4.16.09 ← 4.18.01، ثم الترقية من 4.18.01 ← 4.18.05
من 4.16.05	الترقية من الإصدارات 4.16.05 ← 4.18.01، ثم الترقية من 4.18.01 ← 4.18.05
من 4.16.01	الترقية من الإصدارات 4.16.01 ← 4.18.01، ثم الترقية من 4.18.01 ← 4.18.05
من 4.15.0x	الترقية من الإصدارات 4.15.0x ← 4.16.01، ثم الترقية من 4.16.01 ← 4.18.01، ثم الترقية من 4.18.01 ← 4.18.05

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

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

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

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

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

الحفاظ على التوافق

عند ترقية Apigee Edge for Private Cloud إلى الإصدار 4.18.05، يجب التأكد من أنّ الناتج إلى الخصائص المتوافقة فقط في ملفات الإعداد الخاصة به.

الموقع	الموقع الجغرافي	الوصف
conf_load_balancing_load.balancing.   driver.nginx.server.retry	router.properties	أزِل هذه السمة من ملف router.properties. لتعيين خيارات إعادة المحاولة في 4.18.05، يمكنك استخدام واجهة برمجة التطبيقات خصائص إعداد المضيف.

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

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

إضافة SMTPmailFROM مَعلمة إعداد

أضاف الإصدار 4.17.05 من Edge مَعلمة جديدة مطلوبة إلى ملف الإعدادات المستخدَم عند التفعيل. خادم SMTP.

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

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

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

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

• إذا كنت تستخدم تخزين البيانات المحلي مع عُقد Postgres، يجب: تثبيت عقدة الاستعداد الجديدة لـ Postgres طوال مدة الترقية. بعد اكتملت عملية الترقية، يمكنك إنهاء عقدة وضع الاستعداد الجديدة في Postgres.

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

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

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

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

تثبيت Postgres جديد عقدة وضع الاستعداد

ينشئ هذا الإجراء خادم استعداد لـ Postgres على عقدة جديدة. تأكد من تثبيت رمز جديد خادم وضع الاستعداد لـ Postgres للإصدار الحالي من Edge (4.17.05 أو 4.17.09)، وليس للإصدار 4.18.05.

لإجراء عملية التثبيت، استخدِم ملف الإعداد نفسه الذي استخدمته لتثبيت الإصدار الحالي. من Edge.

لإنشاء عقدة وضع الاستعداد جديدة في Postgres:

1. في صفحة Postgres الرئيسية الحالية، عدِّل /opt/apigee/customer/application/postgresql.properties لتعيين الرمز المميز التالي. إذا لم يكن هذا الملف متوفّرًا، أنشئه:

   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

   حيث existing_slave_ip هو عنوان IP لمجموعة Postgres الحالية خادم وضع الاستعداد وnew_slave_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_slave_ip/32 trust
   host replication apigee new_slave_ip/32 trust

4. تثبيت خادم وضع الاستعداد الجديد لـ Postgres:
   1. عدّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. إيقاف SELinux كما هو موضح في ثبِّت الأداة المساعدة لإعداد واجهة برمجة التطبيقات Edge على Edge.
   3. يمكنك تنزيل ملف Bootstrap_4.17.0x.sh على Edge، حيث يشير x إلى الملف 5 (للإصدار 4.17.05) أو 9 (للإصدار 4.17.09) إلى /tmp/bootstrap_4.17.0x.sh :

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

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

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

   5. استخدم apigee-service لتثبيت الأداة apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   6. تثبيت Postgres:

      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile

   7. في عقدة وضع الاستعداد الجديدة، شغِّل الأمر التالي:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      تأكَّد من أنّ الجهاز في وضع الاستعداد.

إيقاف تشغيل عقدة Postgres

بعد اكتمال التحديث، عليك إيقاف عقدة وضع الاستعداد الجديدة:

1. تأكد من أن Postgres قيد التشغيل:

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

   إذا لم تكن أداة Postgres قيد التشغيل، عليك تشغيلها:

   /opt/apigee/apigee-service/bin/apigee-all start

2. يمكنك الحصول على المعرّف الفريد العالمي (UUID) لعقدة وضع الاستعداد الجديدة من خلال تشغيل أمر cURL التالي على الجهاز الجديد عقدة وضع الاستعداد:

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

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

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

3. أوقف عقدة وضع الاستعداد الجديدة من خلال تشغيل الأمر التالي على عقدة الاستعداد الجديدة:

   /opt/apigee/apigee-service/bin/apigee-all stop

4. في عقدة Postgres الرئيسية، عدِّل /opt/apigee/customer/application/postgresql.properties لإزالة عقدة وضع الاستعداد الجديدة من conf_pg_hba_replication.connection:

   conf_pg_hba_replication.connection=host replication apigee existing_slave_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_slave_ip/32 trust

7. احذف المعرّف الفريد العالمي لعقدة وضع الاستعداد من ZooKeeper من خلال إجراء إدارة Edge التالية استدعاء واجهة برمجة التطبيقات في عقدة خادم الإدارة:

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

تعديل المتطلبات الأساسية

يجب استيفاء المتطلبات الأساسية التالية قبل ترقية Apigee Edge:

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

  يتيح لك ذلك الحصول على خطة احتياطية، في حال تعذّر عليك يعمل بشكل صحيح. لمزيد من المعلومات حول الاحتفاظ بنسخة احتياطية، راجِع القسم الاحتفاظ بنسخة احتياطية. و"الاستعادة":

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

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

جارٍ التعامل مع التحديث الذي تعذّر تنفيذه

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

إذا كان الإخفاق يتطلب إعادة التحديث إلى الإصدار السابق، يمكنك الاطّلاع على يمكنك العودة إلى الإصدار 4.18.05 للحصول على المزيد.

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

بشكل تلقائي، تكتب الأداة المساعدة 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. سهِّل على جهاز التوجيه الوصول إليه.
• على عقدة موجه واحدة:
  • قبل إجراء التحديث، تأكَّد من أنّه لا يمكن الوصول إلى جهاز التوجيه.
  • بعد إجراء التحديث، يمكنك تسهيل الوصول إلى جهاز التوجيه.
• في عقدة واحدة لمعالجة الرسائل:
  • قبل التحديث، تأكد من عدم إمكانية الوصول إلى معالج الرسائل.
  • بعد التحديث، يمكنك الوصول إلى معالج الرسائل.

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

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

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

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

1. إذا كنت تستخدم حاليًا النسخ المماثل من وضع الاستعداد الرئيسي لـ Postgres مع التخزين المحلي، تثبيت عقدة وضع الاستعداد جديدة من Postgres كما هو موضح في تثبيت عقدة Postgres جديدة عقدة وضع الاستعداد.

   إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، خذ لقطة الشبكة لمخزن البيانات المستخدم بواسطة Postgres. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

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

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

5. عطّل SELinux كما هو موضح في Install أداة Edge apigee-setup.
6. في حال التثبيت على الإصدار Oracle 7.x، شغِّل الأمر التالي:

   sudo yum-config-manager --enable ol7_optional_latest

7. في حال التثبيت باستخدام AWS، يُرجى تشغيل ما يلي: yum-configure-manager أوامر:

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

8. نزِّل ملف Edge 4.18.05 bootstrap_4.18.05.sh من أجل /tmp/bootstrap_4.18.05.sh:

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

9. ثبّت الأداة المساعدة والتبعيات apigee-service على Edge 4.18.05:

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

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

   بشكل تلقائي، تتحقّق أداة التثبيت من أنّك مثبّت Java 1.8. إذا لم تقم بذلك، بتثبيتها من أجلك. يمكنك استخدام الخيار JAVA_FIX لتحديد كيفية التعامل مع Java التثبيت. تأخذ JAVA_FIX القيم التالية:

   • I = تثبيت OpenJDK 1.8 (تلقائي)
   • C = متابعة بدون تثبيت Java
   • Q = إنهاء. لتنفيذ هذا الخيار، يجب تثبيت Java بنفسك.
10. استخدم apigee-service لتحديث أداة apigee-setup:

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

11. تحديث الأداة apigee-validate على خادم الإدارة:

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

12. تحديث أداة apigee-provision:

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

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

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

    المطلب الوحيد على ملف الإعداد هو أن يكون ملف الإعداد قابلاً للوصول أو قابلة للقراءة بواسطة "apigee" المستخدم.

    يمكنك استخدام الخيار -c لتحديد المكوِّن المطلوب تحديثه. قائمة الخيارات المحتملة تشمل المكونات ما يلي:

    • "cs" = كاساندرا
    • "e" = ElasticSearch
    • "الحافة" =جميع مكونات Edge باستثناء Edge UI. "الحافة" يتضمن المكوِّن خادم الإدارة، معالج الرسائل، جهاز التوجيه، خادم QPID، خادم Edge Postgres
    • "بروتوكول LDAP" = OpenLDAP
    • "ps" = postgresql
    • "qpid" = Qpidd
    • "الدخول الموحّد" (SSO) = الدخول الموحَّد (SSO) من شبكة Edge
    • "واجهة المستخدم" = Edge UI
    • "zk" = حديقة الحيوانات

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

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

14. أعد تشغيل مكون واجهة مستخدم Edge على جميع الأجهزة التي تقوم بتشغيله، إذا لم تكن قد قمت بذلك بالفعل:

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

15. اختبار التحديث من خلال تشغيل أداة apigee-validate في "الإدارة" الخادم، كما هو موضَّح في اختبار التثبيت.
16. في حال تثبيت عقدة وضع الاستعداد جديدة من Postgres، يجب فصل العقدة كما هو موضَّح في إيقاف عقدة Postgres.

    إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. عرض الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على المزيد من الميزات

للعودة إلى الإصدار السابق من التحديث لاحقًا، يمكنك استخدام الإجراء الموضّح في العودة الإصدار 4.18.05.

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

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

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

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

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

1. إذا كنت تستخدم حاليًا تكرار وضع الاستعداد الرئيسي في Postgres، عليك تثبيت إصدار جديد من Postgres. عقدة وضع الاستعداد كما هو موضح في تثبيت أداة Postgres جديدة عقدة وضع الاستعداد.

   إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، خذ لقطة الشبكة لمخزن البيانات المستخدم بواسطة Postgres. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

2. أنشِئ مستودعًا محليًا للإصدار 4.18.05 كما هو موضَّح في قسم "إنشاء مستودع محلي في Apigee". في تثبيت أداة Edge apigee-setup
   
3. لتثبيت خدمة apigee من ملف .tar:
   1. في العقدة التي تضم المستودع المحلي، استخدم الأمر التالي لحزم المستودع المحلي في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz:

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

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

      tar -xzf apigee-4.18.05tar.gz

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

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

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

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

4. لتثبيت خدمة apigee باستخدام خادم ويب Nginx:
   1. قم بتهيئة خادم الويب Nginx كما هو موضح في "التثبيت من المستودع باستخدام Nginx webserver" في تثبيت Edge أداة apigee-setup.
   2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.18.05.sh من أجل /tmp/bootstrap_4.18.05.sh:

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

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

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

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

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

5. استخدم apigee-service لتحديث أداة apigee-setup:

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

6. تحديث الأداة apigee-validate على خادم الإدارة:

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

7. تحديث أداة apigee-provision:

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

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

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

   إن المتطلب الوحيد في ملف التهيئة هو أن يكون ملف التهيئة قابلاً للوصول أو قابلة للقراءة بواسطة "apigee" المستخدم.

   يمكنك استخدام الخيار -c لتحديد المكوِّن المطلوب تحديثه. قائمة الخيارات المحتملة تشمل المكونات ما يلي:

   • "cs" = كاساندرا
   • "e" = ElasticSearch
   • "الحافة" =جميع مكونات Edge باستثناء Edge UI. "الحافة" يتضمن المكوِّن خادم الإدارة، معالج الرسائل، جهاز التوجيه، خادم QPID، خادم Edge Postgres
   • "بروتوكول LDAP" = OpenLDAP
   • "ps" = postgresql
   • "qpid" = Qpidd
   • "الدخول الموحّد" (SSO) = الدخول الموحَّد (SSO) من شبكة Edge
   • "واجهة المستخدم" = Edge UI
   • "zk" = حديقة الحيوانات

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

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

9. أعد تشغيل مكون واجهة مستخدم Edge على جميع الأجهزة التي تقوم بتشغيله، إذا لم تكن قد قمت بذلك بالفعل:

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

10. اختبار التحديث من خلال تشغيل أداة apigee-validate في "الإدارة" الخادم، كما هو موضَّح في اختبار التثبيت.
11. في حال تثبيت عقدة وضع الاستعداد جديدة من Postgres، يجب فصل العقدة كما هو موضَّح في الإيقاف عقدة Postgres.

    إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

للعودة إلى الإصدار السابق من التحديث لاحقًا، يمكنك استخدام الإجراء الموضّح في العودة الإصدار 4.18.05.

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

يعد ترتيب تحديث الأجهزة أثناء تثبيت Edge أمرًا مهمًا. الأكثر اعتبارات مهمة للتحديث هي:

• يجب تحديث جميع عُقد Cassandra وZoKeeper قبل تحديث أي العقد الأخرى.
• بالنسبة لأي جهاز يحتوي على عدة مكونات Edge (خادم الإدارة ومعالج الرسائل جهاز التوجيه، خادم QPID ولكن ليس خادم Postgres)، استخدم "-c Edge" خيار تحديثها جميعًا في في نفس الوقت.
• إذا حددت الخطوة أنه يجب تنفيذها على أجهزة متعددة، فنفذها في ترتيب الجهاز المحدد.
• ولا تتوفّر خطوة منفصلة لتعديل ميزة "تحقيق الربح". يتم تحديثه عند تحديد "-c حافة .

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

1. تحديث Cassandra و ZooKeeper:

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

2. تعديل Qpid:

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

3. تحديث LDAP:

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

4. أوقِف خادم Postgres Server وخادم Qpid وPostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

5. تعديل postgresql:

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

6. عدِّل قاعدة بيانات Postgres:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

7. قم بتحديث مكونات Edge المتبقية:

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

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

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

9. (في حال تثبيت الدخول المُوحَّد (SSO) لتطبيق Edge) حدِّث الدخول الموحَّد (SSO) إلى Edge:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

10. أعِد تشغيل مكوِّن واجهة مستخدم Edge:

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

تثبيت مستقل بعقدة 2

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

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

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

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

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

3. تحديث LDAP على الجهاز 1:

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

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

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

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

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

6. (في حال تثبيت الدخول المُوحَّد (SSO) لتطبيق Edge) حدِّث الدخول الموحَّد (SSO) إلى Edge على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

7. تحديث postgresql على الجهاز 2:
   1. أوقِف خادم Postgres وخادم Qpid وpostgresql:
      

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   2. تعديل postgresql:

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

   3. عدِّل قاعدة بيانات Postgres:

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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

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

8. أعد تشغيل مكون واجهة مستخدم Edge على الجهاز 1:

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

تثبيت 5 عُقد

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

1. تأكد من تثبيت عقدة وضع الاستعداد جديدة من Postgres كما هو موضح في التثبيت عقدة وضع الاستعداد جديدة من Postgres.

   إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، خذ لقطة الشبكة لمخزن البيانات المستخدم بواسطة Postgres. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

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

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

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

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

4. تحديث LDAP على الجهاز 1:

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

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

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

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

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

7. (في حال تثبيت الدخول المُوحَّد (SSO) لتطبيق Edge) حدِّث الدخول الموحَّد (SSO) إلى Edge على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

8. أجهزة التحديث 4 و5:
   1. إيقاف خادم Postgres وخادم Qpid على الجهاز 4:
      

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

   2. أوقف خادم Postgres وخادم Qpid وpostgresql على الجهاز 5:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. في حال التثبيت، أوقِف خادم Postgres وpostgresql على وضع الاستعداد الجديد. العقدة التي أضفتها للعودة إلى الحالة السابقة:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   4. تحديث postgresql على الأجهزة 4:

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

   5. عدِّل قاعدة بيانات Postgres على الجهاز 4 (إصدار Postgres الرئيسي فقط):

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

   6. تحديث Postgresql على الأجهزة 5:

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

   7. ابدأ خادم Postgres وخادم Qpid على الجهازين 4 و5:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   8. يمكنك ضبط Postgres كعقدة وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز 5:

      cd /opt/apigee/data/apigee-postgresql/pgdata
      rm -rf *
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   9. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. تشير رسالة الأشكال البيانية نتائج مماثلة على كلا الخادمين لضمان النسخ المتماثل بنجاح:
      • على الجهاز 4، شغِّل العقدة الرئيسية:

        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

        تحقق من أنه العنوان الرئيسي.

      • في الجهاز 5، تكون عقدة وضع الاستعداد:

        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

        تأكَّد من أنّ الجهاز في وضع الاستعداد.

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

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

10. تأكد من إيقاف عقدة وضع الاستعداد الجديدة كما هو موضح في الإيقاف عقدة Postgres.

    إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

11. أعد تشغيل مكون واجهة مستخدم Edge على الجهاز 1:

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

9 عُقد مجمعة التثبيت

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

1. تأكَّد من تثبيت عقدة وضع الاستعداد جديدة من Postgres كما هو موضَّح. في تثبيت عقدة وضع الاستعداد جديدة من Postgres.

   إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، خذ لقطة الشبكة لمخزن البيانات المستخدم بواسطة Postgres. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

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

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

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

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

4. تحديث LDAP على الجهاز 1:

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

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

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

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

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

7. (في حال تثبيت الدخول المُوحَّد (SSO) لتطبيق Edge) حدِّث الدخول الموحَّد (SSO) إلى Edge على الجهاز 1:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

8. أجهزة التحديث 8 و9:
   1. أوقف خادم Postgres على الجهاز 8:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

   2. أوقف خادم Postgres وpostgresql على الجهاز 9:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. إيقاف خادم Qpid على الجهازين 6 و7:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

   4. في حال التثبيت، أوقِف خادم Postgres وpostgresql على وضع الاستعداد الجديد. العقدة التي أضفتها للعودة إلى الحالة السابقة:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   5. تحديث Postgresql على الأجهزة 8:

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

   6. عدِّل قاعدة بيانات Postgres على الجهاز 8 (إصدار Postgres الرئيسي فقط):

      /-->
      opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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

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

   8. بدء خادم Postgres على الجهازين 8 و9:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   9. بدء خادم Qpid على الجهازين 6 و7:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   10. يمكنك ضبط Postgres كعقدة وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز 9:

       cd /opt/apigee/data/apigee-postgresql/pgdata
       rm -rf *
       /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   11. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. تشير رسالة الأشكال البيانية نتائج مماثلة على كلا الخادمين لضمان النسخ المتماثل بنجاح:
       • على الجهاز 8، شغِّل العقدة الرئيسية:

         /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

         تحقق من أنه العنوان الرئيسي.

       • في الجهاز 9، تكون عقدة وضع الاستعداد:

         /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

         تأكَّد من أنّ الجهاز في وضع الاستعداد.

9. تحديث مكونات Edge على الجهازين 8 و9:

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

10. تأكد من إيقاف عقدة وضع الاستعداد الجديدة كما هو موضح في الإيقاف عقدة Postgres.

    إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

11. أعد تشغيل مكون واجهة مستخدم Edge على الجهاز 1:

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

تثبيت مجمّع من 13 عقدة

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

1. تأكَّد من تثبيت عقدة وضع الاستعداد جديدة من Postgres كما هو موضَّح. في تثبيت عقدة وضع الاستعداد جديدة من Postgres.

   إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، خذ لقطة الشبكة لمخزن البيانات المستخدم بواسطة Postgres. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

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

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

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

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

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

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

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

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

6. تحديث واجهة المستخدم على الجهازين 6 و7:

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

7. (في حال تثبيت الدخول المُوحَّد (SSO) لتطبيق Edge) حدِّث الدخول الموحَّد (SSO) إلى Edge على الجهازين 6 و7:

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

8. أجهزة التحديث 8 و9:
   1. أوقف خادم Postgres على الجهاز 8:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

   2. أوقف خادم Postgres وpostgresql على الجهاز 9:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. إيقاف خادم Qpid على الجهازين 12 و13:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

   4. في حال التثبيت، أوقِف خادم Postgres وpostgresql على وضع الاستعداد الجديد. العقدة التي أضفتها للعودة إلى الحالة السابقة:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   5. تحديث postgresql على الأجهزة 8:

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

   6. عدِّل قاعدة بيانات Postgres على الجهاز 8 (إصدار Postgres الرئيسي فقط):

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

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

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

   8. بدء خادم Postgres على الجهازين 8 و9:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   9. بدء خادم Qpid على الجهازين 12 و13:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   10. يمكنك ضبط Postgres كعقدة وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز 9:

       cd /opt/apigee/data/apigee-postgresql/pgdata
       rm -rf *
       /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   11. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. تشير رسالة الأشكال البيانية نتائج مماثلة على كلا الخادمين لضمان النسخ المتماثل بنجاح:
       • على الجهاز 8، شغِّل العقدة الرئيسية:

         /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

         تحقق من أنه العنوان الرئيسي.

       • في الجهاز 9، تكون عقدة وضع الاستعداد:

         /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

         تأكَّد من أنّ الجهاز في وضع الاستعداد.

9. تحديث مكونات Edge على الجهازين 8 و9:

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

10. تأكد من إيقاف عقدة وضع الاستعداد الجديدة كما هو موضح في الإيقاف عقدة Postgres.

    إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

11. إعادة تشغيل مكون واجهة مستخدم Edge على الجهازين 6 و7:

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

تثبيت مجمّع من 12 عقدة

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

1. تأكَّد من تثبيت عقدة وضع الاستعداد جديدة من Postgres كما هو موضَّح. في تثبيت عقدة وضع الاستعداد جديدة من Postgres.

   إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، خذ لقطة الشبكة لمخزن البيانات المستخدم بواسطة Postgres. عرض الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على المزيد من الميزات

2. تحديث Cassandra و ZooKeeper:
   1. على الأجهزة 1 و2 و3 في "مركز البيانات" 1:

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

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

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

3. تعديل qpidd:
   1. الجهازان 4 و5 في مركز البيانات 1
      1. تحديث qpidd على الجهاز 4:

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

      2. كرِّر الخطوة 1 على الجهاز 5.
   2. الجهازان 10 و11 في مركز البيانات 2
      1. التحديث qpidd على الجهاز 10:

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

      2. كرِّر الخطوة 1 على الجهاز 11.
4. تحديث LDAP:
   1. الأجهزة 1 في مركز البيانات 1

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

   2. الأجهزة 7 في مركز البيانات 2

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

5. تحديث مكونات Edge:
   1. الأجهزة 4، 5، 1، 2، 3 في مركز البيانات 1

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

   2. الأجهزة 10، 11، 7، 8، 9 في مركز البيانات 2

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

6. تحديث واجهة المستخدم:
   1. الجهاز 1 في مركز البيانات 1:

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

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

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

7. (في حال تثبيت الدخول المُوحَّد (SSO) لتطبيق Edge) حدِّث الدخول الموحَّد (SSO) إلى Edge:
   1. الجهاز 1 في مركز البيانات 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

8. تعديل الجهاز 6 في الإصدارَين 1 و12 من "مركز البيانات" في "مركز البيانات" 2:
   1. أوقف خادم Postgres على الجهاز 6:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

   2. أوقف خادم Postgres وpostgresql على الجهاز 12:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   3. أوقِف خادم Qpid على الأجهزة 4 و5 و10 و11:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop

   4. في حال التثبيت، أوقِف خادم Postgres وpostgresql على وضع الاستعداد الجديد. العقدة التي أضفتها للعودة إلى الحالة السابقة:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

   5. تحديث postgresql على الأجهزة 6:

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

   6. عدِّل قاعدة بيانات Postgres على الجهاز 6 (إصدار Postgres الرئيسي فقط):

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade

   7. تحديث postgresql على الأجهزة 12:

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

   8. ابدأ تشغيل خادم Postgres على الجهازين 6 و12:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

   9. ابدأ خادم Qpid على الأجهزة 4 و5 و10 و11:

      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

   10. يمكنك ضبط Postgres كعقدة وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز 12:

       cd /opt/apigee/data/apigee-postgresql/pgdata
       rm -rf *
       /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   11. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. تشير رسالة الأشكال البيانية نتائج مماثلة على كلا الخادمين لضمان النسخ المتماثل:

       على الجهاز 6، العقدة الرئيسية، شغّل:

       /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

       تحقق من أنه العنوان الرئيسي.

       في الجهاز 12، تكون عقدة وضع الاستعداد:

       /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

       تأكَّد من أنّ الجهاز في وضع الاستعداد.

9. تحديث مكونات Edge على الجهازين 6 و12:

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

10. تأكد من إيقاف تشغيل عقدة وضع الاستعداد الجديدة كما هو موضح في إيقاف إحدى قوالب Postgres العقدة.

    إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. عرض الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من الميزات

11. إعادة تشغيل مكون واجهة مستخدم Edge على الجهازين 1 و7:

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

لعمليات التثبيت غير العادية

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

1. ZooKeeper
2. كاساندرا
3. qpidd وps
4. LDAP
5. الحافة، بمعنى "حافة-c" على جميع العقد بالترتيب: العقدة ذات خادم Qpid، خادم Edge Postgres وخادم الإدارة ومعالج الرسائل وجهاز التوجيه
6. واجهة مستخدم Edge
7. الدخول المُوحَّد (SSO) إلى شبكة Edge

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