تحديث Apigee Edge 4.16.01/4.16.05 إلى 4.17.09

Edge for Private Cloud‏ 4.17.09

إصدارات Edge التي يمكنك تحديثها إلى 4.17.09

يمكنك تحديث الإصدار 4.16.01.0x و4.16.05.x من Apigee Edge إلى الإصدار 4.17.09 باستخدام هذه الإجراء.

إذا كان لديك إصدار Edge سابق إلى الإصدار 4.16.01، فيجب عليك أولاً الانتقال إلى الإصدار 4.16.01 ثم التحديث إلى الإصدار 4.17.09.

  • يمكنك نقل الإصدار 4.15.07 إلى الإصدار 4.16.01 من Apigee Edge.
  • إذا كان لديك إصدار من Edge أقدم من الإصدار 4.15.07، عليك أولاً نقل بياناتك إلى الإصدار 4.15.07 ثم إلى الإصدار 4.16.01.
    • إذا كنت بصدد نقل البيانات من الإصدار 4.14.04 من Edge أو إصدار أحدث: يمكنك نقل البيانات مباشرةً إلى الإصدار 4.15.07.
    • في حال نقل البيانات من الإصدار 4.14.01 من Edge: عليك أولاً نقل البيانات إلى الإصدار 4.14.04، ثم نقل البيانات إلى الإصدار 4.15.07.

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

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

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

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

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

الرجوع إلى إصدار سابق من Zookeeper في حال التحديث من 4.16.01

إصدار حزمة RPM الخاصة بخدمة Zookeeper في Edge for Private Cloud 4.16.01 هو apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. في الإصدارات اللاحقة من Edge، تم تغيير إصدار Zookeeper مرة أخرى إلى apigee-zookeeper-3.4.5-0.0.94x. يمنع هذا الإجراء أداة yum من ترقية Zookeeper إلى إصدارات أحدث من 4.16.01. وطريقة تصحيح هذا الموقف هي تشغيل yum downgrade apigee-zookeeper قبل تحديث Zookeeper.

يمكنك التحقق من إصدار Zookeeper باستخدام الأمر التالي:

> rpm -qa |grep apigee-zookeeper

في حال كان هذا الأمر يعرض إصدار Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

بعد ذلك، عليك الرجوع إلى إصدار سابق.

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

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

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

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

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

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

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

التعامل مع تحديث تعذّر إتمامه

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

إذا كان الخطأ يتطلّب الرجوع إلى الإصدار السابق، يُرجى الاطّلاع على عملية الرجوع إلى الإصدار 4.17.09 لمعرفة المزيد من المعلومات.

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

تُسجِّل الأداة update.sh معلومات السجلّ تلقائيًا في:

/opt/apigee/var/log/apigee-setup/update.log

إذا لم يتمكن المستخدم الذي يشغّل الأداة update.sh من الوصول إلى هذا الدليل، يكتب السجلّ في دليل /tmp كملف باسم update_username.log.

إذا لم يكن لدى المستخدم إذن الوصول إلى ‎/tmp، ستتعطّل الأداة update.sh.

الترقية المطلوبة للإصدار 8 من Java JDK

يتطلّب هذا الإصدار من Edge تثبيت الإصدار 8 من Java JDK على جميع عقد معالجة Edge. يمكنك تثبيت Oracle JDK 8 أو OpenJDK 8. إذا لم يكن Java JDK 8 مثبّتًا من قبل، يمكن للنص البرمجي للتحديث تثبيته نيابةً عنك.

كجزء من تحديث Java 8، لم تعُد بعض رموز التشفير الخاصة ببروتوكول النقل الآمن للطبقات (TLS) متاحة في Oracle JDK 8. للحصول على القائمة الكاملة، يُرجى الاطّلاع على قسم "مجموعات التشفير المُعطَّلة تلقائيًا" (Default Disabled Cipher Suites) على الرابط http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

مطلوب لتفعيل مستودع EPEL

يجب تفعيل الحزم الإضافية لنظام التشغيل Enterprise Linux (أو EPEL) لتثبيت Edge أو تحديثه. يعتمد الأمر الذي تستخدمه على إصدار RedHat/CentOS:

  • بالنسبة إلى RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • بالنسبة إلى RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

إضافة مَعلمة الضبط SMTPMAILFROM المطلوبة

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

بالإضافة إلى ذلك، أضاف الإصدار 4.17.09 من واجهة برمجة التطبيقات BaaS إمكانية استخدام السمة SMTPmailFROM. عند تعديل واجهة برمجة التطبيقات BaaS، يجب ضبط SMTPMAILFROM فيملف الإعدادات.

يكون شكل هذه المَعلمة على النحو التالي:

SMTPMAILFROM="My Company <myco@company.com>"

هذا الحقل مطلوب في حال التحديث عند استخدام مصادقة خارجية.

يمكنك دمج خدمة دليل خارجي في عملية تثبيت حالية على Apigee Edge Private Cloud. تم تصميم هذه الميزة للعمل مع أي خدمة دليل تتيح استخدام بروتوكول LDAP، مثل Active Directory وOpenLDAP وغيرها. يسمح حل LDAP الخارجي لمشرفي النظام بإدارة بيانات اعتماد المستخدم من خدمة مركزية لإدارة الدليل، خارج الأنظمة التي تستخدمها، مثل Apigee Edge.

اطّلِع على إعداد مصادقة خارجية لمعرفة المزيد.

عند تفعيل المصادقة الخارجية، يستخدم معظم العملاء حقل اسم حساب SAM في Active Directory كاسم مستخدم للمصادقة، بدلاً من عنوان البريد الإلكتروني الذي يستخدمه خادم OpenLDAP في Edge.

إذا كنت قد دمجت مع خدمة دليل خارجي، أضِف السطر التالي إلىملف الإعدادات عند تحديث Edge إلى الإصدار 4.17.09:

IS_EXTERNAL_AUTH="true"

يضبط هذا السطر Edge للسماح باستخدام اسم حساب بدلاً من عنوان بريد إلكتروني كاسم المستخدم.

الترقية المطلوبة إلى Qpid 1.35

يتضمّن هذا الإصدار تحديثًا مطلوبًا لإصدار Qpid 1.35. كجزء من تعديل عقدة Qpid، يجب عليك:

  • يمكنك منع أجهزة التوجيه ومعالجات الرسائل مؤقتًا من الكتابة إلى عقدة Qpid من خلال حظر المنفذ 5672 على عقدة Qpid. يمكنك استخدام الأمر التالي لحظر هذا المنفذ على العقدة Qpid:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  • انتظِر حتى تصبح قائمة انتظار Qpid فارغة من الرسائل لضمان معالجة عقدة Qpid لجميع الرسائل قبل إجراء التعديل. استخدِم الأمر التالي للتأكّد من أنّ "قائمة انتظار رسائل Qpid" فارغة:
    > qpid-stat -q
  • عدِّل عقدة Qpid.
  • أزِل الحظر عن المنفذ 5672 على عقدة Qpid للسماح بالوصول من أجهزة التوجيه ومعالجات الرسائل. يمكنك استخدام الأمر التالي لإلغاء حظر هذا المنفذ:
    > sudo iptables -F

    تجدر الإشارة إلى أنّه إذا كنت تستخدم iptables لقواعد أخرى، يمكنك استخدام الخيار -D لعكس التغيير المحدّد:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 . -s `hostname` -i eth0 -j DROP

تم وصف هذه العملية بالتفصيل أدناه لكل طوبولوجيا Edge.

الترقية المطلوبة إلى Postgres 9.4

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

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

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

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

يؤدّي هذا الإجراء إلى إنشاء خادم احتياطي على Postgres في عقدة جديدة. تأكَّد من تثبيت خادم احتياطي جديد لـ Postgres للإصدار الحالي من Edge (4.16.01 أو 4.16.05)، وليس للإصدار 4.17.09.

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

لإنشاء عقدة احتياطية جديدة في Postgres:

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

    conf_pg_hba_repliations.connection=host واجهة برمجة التطبيقات النسخ الاحتياطي في واجهة برمجة التطبيقات existing_slave_ip/32Trust\ \nالنسخ المتماثل للمضيف apigee new_slave_ip/32 Trust

    يكون فيها existing_slave_ip عنوان IP الجديد هو عنوان IP الخاص بـ base_slave_ip الحالي، وexisting_slave_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 للصفحة الرئيسية الحالية:
      PG_MASTER=192.168.56.103
      # عنوان IP لعقدة وضع الاستعداد الجديدة
      PG_STANDBY=192.168.56.102
    2. أوقِف SELinux كما هو موضّح في تثبيت الأداة المساعدة Edge apigee-setup.
    3. نزِّل ملف Edge bootstrap_4.16.05.sh إلى ‎/tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      ملاحظة: في حال التحديث من الإصدار 4.16.01، نزِّل ملف Edge bootstrap.sh.
    4. ثبِّت أداة apigee-service وتبعياتها في Edge:
      > sudo bash /tmp/bootstrap_4.16.05.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

    من المفترض أن يظهر لك معرّف UUID للعقدة في نهاية الإخراج، على النحو التالي:
    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. أوقِف عقدة وضع الاستعداد الجديدة من خلال تنفيذ الأمر التالي على عقدة وضع الاستعداد الجديدة:
    > /opt/apigee/apigee-service/bin/apigee-allstop
  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 على العقدة الرئيسية. من المفترض أن يظهر لك السطر التالي فقط في هذا الملف:
    واجهة برمجة تطبيقات النسخ المماثل للمضيف existing_slave_ip/32 Trust
  7. يمكنك حذف معرّف UUID للعقدة الاحتياطية من ZooKeeper من خلال إجراء طلب برمجي يليه واجهة برمجة تطبيقات لإدارة Edge على عقدة "خادم الإدارة":
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

تحديث بدون توقّف

يتيح لك التحديث بدون إيقاف الخدمة أو التحديث التلقائي تحديث تثبيت Edge بدون إيقاف Edge.

لا يمكن إجراء التحديث بدون أي فترة إيقاف إلا من خلال إعداد 5 عقد أو أكثر.

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

  1. حدِّث الأجهزة بالترتيب الصحيح لإجراء عملية التثبيت على النحو الموضّح أدناه في القسم "طلب تحديث الجهاز".
  2. عندما يحين وقت تحديث "أجهزة التوجيه"، اختَر أي جهاز توجيه لكي لا يمكن الوصول إليه، كما هو موضّح في مقالة تفعيل أو إيقاف إمكانية الوصول إلى الخادم (معالج الرسائل أو جهاز التوجيه).
  3. حدِّث جهاز التوجيه المحدد وجميع مكونات Edge الأخرى على نفس جهاز جهاز التوجيه. تعرض جميع إعدادات Edge جهاز توجيه ومعالج رسائل في العقدة نفسها.
  4. اجعل جهاز التوجيه متاحًا للاتصال به مرة أخرى.
  5. كرِّر الخطوات من 2 إلى 4 لأجهزة التوجيه المتبقية.
  6. واصِل عملية التحديث لأي أجهزة متبقية في عملية التثبيت.

يُرجى مراعاة ما يلي قبل التحديث أو بعده:

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

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

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

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

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

  1. إذا كنت تستخدِم حاليًا ميزة "النسخ الاحتياطي للمشغّل الرئيسي" في Postgres، ثبِّت عقدة Postgres جديدة في وضع الاستعداد كما هو موضّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
  2. أوقِف أي مهام CRON تم إعدادها لإجراء عملية إصلاح على Cassandra إلى أن يكتمل التحديث.
  3. سجِّل الدخول إلى عقدتك بصفتك مشرفًا لتثبيت حِزم RPM لنظام التشغيل Edge.
    ملاحظة: على الرغم من أنّ تثبيت حِزم RPM يتطلّب إذن الوصول إلى الجذر، يمكنك ضبط إعدادات Edge بدون إذن الوصول إلى الجذر.
  4. ثبِّت yum-utils و yum-plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. أوقِف SELinux كما هو موضّح في مقالة تثبيت أداة apigee-setup في Edge.
  6. فعِّل مستودع EPEL كما هو موضّح أعلاه.
  7. في حال التثبيت على AWS، شغِّل الأمر yum-configure-manager التالي:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. نزِّل ملف Edge 4.17.09 bootstrap_4.17.09.sh إلى /tmp/bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.
  9. ثبِّت الأداة المساعدة وتبعيات Edge 4.17.09 apigee-service:
    > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

    حيث تم إدخال uName:pWorde إذا حذفت pWord، سيُطلب منك إدخالها.

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

    I = تثبيت OpenJDK 1.8 (تلقائي)
    C = المتابعة بدون تثبيت Java
    Q = إنهاء. وبالنسبة إلى هذا الخيار، عليك تثبيت Java بنفسك.
  10. استخدِم apigee-service لتعديل الأداة apigee-setup:
    1. إذا ثبَّتْت الإصدار 4.16.01 من خلال ترقية الإصدار 4.15.07.0x من Edge، عليك تثبيت الأداة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      يعمل هذا الأمر على تثبيت الأداة update.sh في /opt/apigee/apigee-setup/bin.

      إذا سبق لك تثبيت الأداة apigee-setup، عليك تحديثها:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. إذا ثبَّتْت الإصدار 4.16.01 مباشرةً، أي أنّك لم تُجري ترقية من 4.15.07.0x، عليك تحديث الأداة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      يؤدي هذا التعديل على apigee-service إلى تثبيت الأداة update.sh في /opt/apigee/apigee-setup/bin.
    3. إذا ثبَّتْت الإصدار 4.16.05 مباشرةً أو من خلال تحديث، عليك تحديث util-apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      يؤدي هذا التحديث إلى apigee-service إلى تثبيت util-update.sh في /opt/apigee/apigee-setup/bin.
  11. استنادًا إلى الإصدار الحالي من Edge، عليك تثبيت أو تحديث أداة apigee-validate على خادم الإدارة.
    1. إذا كنت تستخدِم حاليًا الإصدار 4.16.05 من Edge: عدِّل الأداة apigee-validate على Management Server:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. إذا كنت تستخدم حاليًا الإصدار 4.16.01 من Edge: ثبِّت الأداة apigee-validate على Management Server:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      ملاحظة: إذا سبق لك تثبيت الأداة apigee-validate على node Message Processor عند تثبيت الإصدار 4.16.01، يمكنك تعديلها باستخدام الأمر التالي على هذه العقدة:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      ومع ذلك، اعتبارًا من الإصدار 4.16.05 والإصدارات الأحدث، تنصح Apigee بتثبيت الأداة apigee-validate وتشغيلها على Management Server.
    3. في حال الترقية من الإصدار 4.16.01: عدِّل ملف الإعدادات الذي تم تمريره إلى أداة apigee-validate. في الإصدار 4.16.01 من Edge، كان ملف الإعدادات المستخدَم من قِبل apigee-validate يتطلّب السمات التالية:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      في هذا الإصدار، لا يتطلّب ملف الإعدادات سوى السمة APIGEE_ADMINPW. يمكنك إزالة الموقعَين الآخرين من الملف.
  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" لتحديد المكوّن المطلوب تعديله. تشمل قائمة المكونات المحتمَلة ما يلي:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
    ui = واجهة مستخدم Edge
    all = تحديث جميع المكونات على الجهاز (لا تستخدِم هذا الخيار إلّا لملف تعريف تثبيت Edge aio أو ملف تعريف تثبيت API BaaS asa)
    e = ElasticSearch
    b = حِزمة API BaaS
    p = بوابة API BaaS
    ebp = ElasticSearch وحِزمة API BaaS وبوابة API BaaS على العقدة نفسها
  14. اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم الإدارة"، كما هو описан في اختبار عملية التثبيت.
  15. إذا ثبَّتْت عقدة احتياطية جديدة في Postgres، أوقِف العقدة كما هو موضّح أعلاه في إيقاف عقدة Postgres.

لإلغاء التحديث لاحقًا، استخدِم الإجراء الموضّح في 4.17.09 عملية إلغاء التحديث.

الإجراء المُتبع للتحديث إلى الإصدار 4.17.09 من مستودع محلي

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

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

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

لتحديث الإصدار من مستودع 4.17.09 على الجهاز:

  1. إذا كنت تستخدِم حاليًا ميزة "النسخ الاحتياطي للمشغّل الرئيسي" في Postgres، ثبِّت عقدة Postgres جديدة في وضع الاستعداد كما هو موضّح أعلاه في تثبيت عقدة Postgres جديدة في وضع الاستعداد.
  2. أنشِئ مستودعًا محليًا للإصدار 4.17.09 كما هو موضَّح في "إنشاء مستودع محلي في Apigee" في تثبيت الأداة المساعدة Edge apigee-setup.
    ملاحظة: إذا كان لديك مستودع حالي من الإصدار 4.16.01 أو 4.16.05، يمكنك إضافة المستودع 4.17.09 إليه كما هو موضّح في "تعديل مستودع Apigee محلي" في مقالة تثبيت أداة Edge apigee-setup.
  3. لتثبيت خدمة apigee من ملف .tar:
    1. على العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لحزمة المستودع المحلي في ملف tar .‎ واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. انسخ ملف ‎.tar إلى العقدة التي تريد تحديث Edge عليها. على سبيل المثال، يمكنك نسخه إلى الدليل /tmp على العقدة الجديدة.
    3. في العقدة الجديدة، عليك إلغاء نقل الملف إلى دليل /tmp:
      > tar -xzf apigee-4.17.09.tar.gz

      ينشئ هذا الأمر دليلاً جديدًا باسم repos، في الدليل الذي يحتوي على ملف .tar. على سبيل المثال، ‎ /tmp/repos.
    4. ثبِّت أداة apigee-service ومستلزماتها في Edge من ‎ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      يُرجى ملاحظة أنّك تُدرِج مسار دليل repos في هذا الأمر.
  4. لتثبيت apigee-service باستخدام خادم الويب Nginx:
    1. اضبط خادم الويب Nginx كما هو موضّح في قسم "التثبيت من المستودع باستخدام خادم الويب Nginx" في مقالة تثبيت أداة Edge apigee-setup.
    2. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.17.09.sh إلى ‎/tmp/bootstrap_4.17.09.sh:
      ‎> /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

      حيث يكون uName:pWord هما اسم المستخدم وكلمة المرور اللذان ضبطتهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لشدَّة العقدة المستودع.
    3. في العقدة البعيدة، ثبِّت أداة Edge apigee-service والتبعيات:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=WordrepoName apigeepassword=Worde.

  5. استخدِم apigee-service لتعديل الأداة apigee-setup:
    1. إذا ثبَّتْت الإصدار 4.16.01 من خلال ترقية الإصدار 4.15.07.0x من Edge، عليك تثبيت الأداة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      يعمل هذا الأمر على تثبيت الأداة update.sh في /opt/apigee/apigee-setup/bin.

      إذا سبق لك تثبيت الأداة apigee-setup، يُرجى تعديلها:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. إذا ثبّتْت الإصدار 4.16.01 مباشرةً، أي أنّك لم تُجري ترقية من 4.15.07.0x، عليك تحديث الأداة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      يؤدي هذا التعديل على apigee-service إلى تثبيت الأداة update.sh في /opt/apigee/apigee-setup/bin.
    3. في حال تثبيت الإصدار 4.16.05 مباشرةً أو من خلال التحديث، عليك تحديث الأداة المساعدة apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update،

      يثبّت هذا التحديث الذي يطلق على apigee-service الأداة update/apigee/apigee.
  6. استنادًا إلى الإصدار الحالي من Edge، عليك تثبيت أو تحديث أداة apigee-validate على خادم الإدارة.
    1. إذا كنت تستخدم حاليًا الإصدار 4.16.05 من Edge: عليك تحديث الأداة apigee-verifyate على خادم الإدارة:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate






    3. في حال الترقية من الإصدار 4.16.01: عدِّل ملف الإعدادات الذي تم تمريره إلى أداة apigee-validate. في الإصدار 4.16.01 من Edge، كان ملف الإعدادات المستخدَم من قِبل apigee-validate يتطلّب السمات التالية:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1

      في هذا الإصدار، لا يتطلّب ملف الإعدادات سوى السمة APIGEE_ADMINPW. يمكنك إزالة الموقعَين الآخرين من الملف.
  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" لتحديد المكوّن المطلوب تعديله. تشمل قائمة المكونات المحتمَلة ما يلي:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
    ui = واجهة مستخدم Edge
    all = تحديث جميع المكونات على الجهاز (لا تستخدِم هذا الخيار إلّا لملف تعريف تثبيت Edge aio أو ملف تعريف تثبيت API BaaS asa)
    e = ElasticSearch
    b = حِزمة API BaaS
    p = بوابة API BaaS
    ebp = ElasticSearch وحِزمة API BaaS وبوابة API BaaS على العقدة نفسها
  9. اختبِر التحديث من خلال تشغيل الأداة apigee-validate على "خادم الإدارة"، كما هو описан في اختبار عملية التثبيت.
  10. في حال تثبيت عقدة وضع الاستعداد جديدة من Postgres، يجب إيقاف العُقدة كما هو موضَّح أعلاه في إيقاف عقدة Postgres.

لإلغاء التحديث لاحقًا، استخدِم الإجراء الموضّح في 4.17.09 عملية إلغاء التحديث.

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

من المهم ترتيب تحديث الأجهزة في عملية تثبيت Edge. في ما يلي أهم النقاط التي يجب أخذها في الاعتبار عند إجراء تحديث:

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

في ما يتعلّق بالتركيب المستقل على مضيف واحد

  1. اضبط SMTPMAILFROM فيملف الإعدادات إذا فعّلت بروتوكول SMTP على Edge. يكون شكل هذه المَعلمة على النحو التالي:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. في حال التحديث من الإصدار 4.16.01، عليك الرجوع إلى إصدار أقدم من Zookeeper:
    > yum downgrade apigee-zookeeper
  3. عدِّل Cassandra وZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. اضبط قاعدة iptables التالية:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  5. تحقَّق من قائمة انتظار رسائل Qpid:
    > qpid-stat -q

    واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg" 0. لا يمكنك ترقية Qpid إلى أن يعالج جميع الرسائل.
  6. حدِّث qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. تفريغ iptables:
    > sudo iptables -F
  8. حدِّث LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. أوقِف خادم Postgres Server وQpid وPostgreSQL:
    > /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
    > /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    > /opt/apigee/apigee
  10. تعديل postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. عدِّل قاعدة بيانات Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. عدِّل مكوّنات Edge المتبقية:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. تعديل واجهة مستخدم Edge:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

في ما يتعلّق بالتركيب المستقل على مضيفَين

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

  1. اضبط SMTPMAILFROM فيملف الإعدادات إذا فعّلت بروتوكول SMTP على Edge. وتكون هذه المَعلمة على النحو التالي:
    SMTPmailFROM="شركتي <myco@company.com>"
  2. في حال التحديث من الإصدار 4.16.01، عليك الرجوع إلى إصدار أقدم من Zookeeper على الجهاز 1:
    > yum downgrade apigee-zookeeper
  3. تحديث Cassandra وZooKeeper على الجهاز 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. اضبط قاعدة iptables على الجهاز 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  5. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 2:
    > qpid-stat -q

    واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "الرسالة" 0. لا يمكنك ترقية Qpid إلى أن يعالج جميع الرسائل.
  6. حدِّث qpidd على الجهاز 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. تفريغ iptables على الجهاز 2:
    > sudo iptables -F
  8. تعديل LDAP على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. تعديل مكوّنات Edge على الجهاز 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. تعديل واجهة المستخدم على الجهاز 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  11. تعديل 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 و1:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. تعديل مكوّنات Edge على الجهاز 2:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

في ما يتعلّق بتركيب 5 مضيفين

يمكنك الاطّلاع على سياسات التثبيت للحصول على قائمة طوابق نظام Edge وأرقام العقد.

  1. اضبط SMTPMAILFROM فيملف الإعدادات إذا فعّلت بروتوكول SMTP على Edge. وتكون هذه المَعلمة على النحو التالي:
    SMTPmailFROM="شركتي <myco@company.com>"
  2. تأكَّد من تثبيت عقدة Postgres احتياطية جديدة كما هو موضّح أعلاه في مقالة تثبيت عقدة Postgres الاحتياطية الجديدة.
  3. في حال التحديث من الإصدار 4.16.01، عليك الرجوع إلى إصدار أقدم من حزمة Zookeeper على الأجهزة 1 و2 و3:
    > yum downgrade apigee-zookeeper
  4. عدِّل Cassandra وZooKeeper على الجهازَين 1 و2 و3:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. اضبط قاعدة iptables التالية على الجهاز 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 4:
    > qpid-stat -q

    واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "الرسالة" 0. لا يمكنك ترقية Qpid حتى يعالج جميع الرسائل.
  7. حدِّث qpidd على الجهاز 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. تفريغ iptables على الجهاز 4:
    > sudo iptables -F
  9. كرِّر الخطوات من 5 إلى 8 على الجهاز 5.
  10. تعديل LDAP على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. تحديث مكونات Edge على الجهاز 1 و2 و3:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. تحديث واجهة المستخدم على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. تعديل الجهازَين 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-serverstop
      > /opt/apigee/apigee-service/bin/apigee-service Edge-apige-service-serverstop
      >
    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 master فقط):
      > ‎/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

      تأكَّد من أنّه يُشار إلى أنّها العقدة الاحتياطية.
  14. تعديل مكوّنات Edge على الجهازَين 4 و5:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. تأكَّد من إيقاف الإصدار الاحتياطي الجديد باستخدام الإجراء أعلاه في مقالة إيقاف node Postgres.

بالنسبة إلى عملية تثبيت في مجموعة تضم 9 مضيفين

يمكنك الاطّلاع على سياسات التثبيت للحصول على قائمة طوابق نظام Edge وأرقام العقد.

  1. اضبط SMTPmailFROM في ملف الإعداد في حال تفعيل SMTP على Edge. وتكون هذه المَعلمة على النحو التالي:
    SMTPmailFROM="شركتي <myco@company.com>"
  2. تأكَّد من تثبيت عقدة Postgres احتياطية جديدة كما هو موضّح أعلاه في مقالة تثبيت عقدة Postgres الاحتياطية الجديدة.
  3. في حال التحديث من الإصدار 4.16.01، عليك الرجوع إلى إصدار أقدم من حزمة Zookeeper على الأجهزة 1 و2 و3:
    > yum downgrade apigee-zookeeper
  4. عدِّل Cassandra وZooKeeper على الجهازَين 1 و2 و3:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. اضبط قاعدة iptables على الجهاز 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 6:
    > qpid-stat -q

    استمر في التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg" يساوي 0. لا يمكنك ترقية Qpid إلى أن يعالج جميع الرسائل.
  7. تعديل qpidd على الجهاز 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. مسح iptables على الجهاز 6:
    > sudo iptables -F
  9. كرِّر الخطوات من 5 إلى 8 على الجهاز 7.
  10. حدِّث LDAP على الجهاز 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. عليك تحديث مكونات Edge على الأجهزة 6 و7 و1 و4 و5 بهذا الترتيب:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. تعديل واجهة المستخدم على الجهاز 1:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. تعديل الجهازَين 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-serverstop
    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 master فقط):
      > ‎/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

      تأكَّد من أنّه يُشار إلى أنّها العقدة الاحتياطية.
  14. تعديل مكوّنات Edge على الجهازَين 8 و9:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. تأكَّد من إيقاف الإصدار الاحتياطي الجديد باستخدام الإجراء أعلاه في مقالة إيقاف node Postgres.

لتركيب 13 مضيفًا في مجموعات

اطّلِع على تصاميم التركيب للحصول على قائمة بتصاميم Edge وأرقام العقد.

  1. اضبط SMTPmailFROM في ملف الإعداد في حال تفعيل SMTP على Edge. يكون شكل هذه المَعلمة على النحو التالي:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. تأكَّد من تثبيت عقدة Postgres احتياطية جديدة كما هو موضّح أعلاه في مقالة تثبيت عقدة Postgres الاحتياطية الجديدة.
  3. في حال التحديث من الإصدار 4.16.01، عليك الرجوع إلى إصدار أقدم من Zookeeper على الأجهزة 1 و2 و3:
    > yum downgrade apigee-zookeeper
  4. عدِّل Cassandra وZooKeeper على الجهازَين 1 و2 و3:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. اضبط قاعدة iptables التالية على الجهاز 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 12:
    > qpid-stat -q

    استمر في التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg" يساوي 0. لا يمكنك ترقية Qpid إلى أن يعالج جميع الرسائل.
  7. تعديل qpidd على الجهاز 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. تفريغ iptables على الجهاز 12:
    > sudo iptables -F
  9. كرر الخطوات من 5 إلى 8 على الجهاز 13.
  10. تعديل LDAP على الجهازَين 4 و5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. عدِّل مكوّنات Edge على الأجهزة 12 و13 و6 و7 و10 و11 بهذا الترتيب:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. تعديل واجهة المستخدم على الجهازَين 6 و7:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. تعديل الجهازَين 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 master فقط):
      > ‎/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. اضبط File Postgres كعقدة وضع الاستعداد من خلال تنفيذ الأوامر التالية على الجهاز 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql       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

      تأكَّد من أنّه يُشار إلى أنّها العقدة الاحتياطية.
  14. تعديل مكوّنات Edge على الجهازَين 8 و9:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. تأكَّد من إيقاف الإصدار الاحتياطي الجديد باستخدام الإجراء أعلاه في مقالة إيقاف node Postgres.

في ما يتعلّق بتركيب 12 مضيفًا في عناقيد

يمكنك الاطّلاع على سياسات التثبيت للحصول على قائمة طوابق نظام Edge وأرقام العقد.

  1. اضبط SMTPMAILFROM فيملف الإعدادات إذا فعّلت بروتوكول SMTP على Edge. يكون شكل هذه المَعلمة على النحو التالي:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. تأكَّد من تثبيت عقدة Postgres احتياطية جديدة كما هو موضّح أعلاه في مقالة تثبيت عقدة Postgres الاحتياطية الجديدة.
  3. حدِّث "كاساندرا" و"حديقة الحيوانات":
    1. في حال التحديث من الإصدار 4.16.01، عليك الرجوع إلى إصدار أقدم من Zookeeper على الأجهزة 1 و2 و3 في مركز البيانات 1:
      > yum downgrade apigee-zookeeper
    2. على الأجهزة 1 و2 و3 في مركز البيانات 1:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. في حال التحديث من الإصدار 4.16.01، عليك الرجوع إلى إصدار أقدم من Zookeeper على الأجهزة 7 و8 و9 في مركز البيانات 2:
      > yum downgrade apigee-zookeeper
    4. على الأجهزة 7 و8 و9 في مركز البيانات 2
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. تعديل qpidd:
    1. الجهازان 4 و5 في مركز البيانات 1
      1. اضبط قاعدة iptables التالية على الجهاز 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 4:
        > qpid-stat -q

        واصِل التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg" يساوي 0. ولا يمكنك ترقية Qpid حتى يعالج جميع الرسائل.
      3. تعديل qpidd على الجهاز 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. تفريغ iptables على الجهاز 4:
        > sudo iptables -F
      5. كرِّر الخطوات من 1 إلى 4 على الجهاز 5.
    2. الجهازان 10 و11 في مركز البيانات 2
      1. اضبط قاعدة iptables التالية على الجهاز 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. التحقّق من قائمة انتظار رسائل Qpid على الجهاز 10:
        > qpid-stat -q

        يُرجى مواصلة التحقّق من قائمة الانتظار إلى أن يصبح العدد في عمود "msg" يساوي 0. لا يمكنك ترقية Qpid إلى أن يعالج جميع الرسائل.
      3. تعديل qpidd على الجهاز 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. تفريغ iptables على الجهاز 10:
        > sudo iptables -F
      5. كرِّر الخطوات من 1 إلى 4 على الجهاز 11.
  5. عدِّل 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
  6. تعديل مكوّنات 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
  7. تعديل واجهة المستخدم:
    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
  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 master فقط):
      > /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.

لتثبيت BaaS لواجهة برمجة التطبيقات ذات 7 مضيفات أو 10 مضيفات

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

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

  1. ZooKeeper
  2. كاساندرا
  3. qpidd
  4. LDAP
  5. Edge، أي الملف الشخصي "-c edge" على جميع العقد بالترتيب: العقد التي تحتوي على خادم Qpid ولكن ليس خادم Postgres والخادم الإداري ومعالج الرسائل وجهاز التوجيه
    ملاحظة: إذا كانت العقدة تحتوي على خادم Qpid وخادم Postgres مثبَّتَين، شغِّل خطوة الملف الشخصي "-c edge" كجزء من الخطوة 8.
  6. واجهة مستخدم Edge
  7. postgresql على خادم Postgres الرئيسي، بما في ذلك الترقية
  8. postgresql في وضع الاستعداد في Postgres
  9. Edge، أي الملف الشخصي "-c edge" على جميع عقد Qpid وPostgres المجمّعة، أو على أي عقد Postgres مستقلة