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

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

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

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

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

وإصدار Zookeeper RPM في 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. طريقة تصحيح في هذه الحالة، يمكن الرجوع إلى إصدار سابق apigee-zookeeper قبل تحديث Zookeeper.

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

> rpm -qa |grep apigee-zookeeper

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

apigee-zookeeper-3.4.5-1.0.905

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

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

في حال إعداد أي مواقع من خلال تعديل ملفات .properties في .properties عندها يتم الاحتفاظ بالقيم من خلال التحديث.

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

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

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

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

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

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

في حال تعذُّر التحديث، يمكنك محاولة حلّ المشكلة، ثم تنفيذ 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. بالنسبة القائمة الكاملة، راجع قسم "مجموعات التشفير المعطلة تلقائيًا" على 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; دورة في الدقيقة - إيفا epel-release-latest-7.noarch.rpm
  • لأجهزة RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; دورة في الدقيقة - إيفا 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 للدليل النشط كاسم مستخدم للمصادقة، بدلاً من عنوان البريد الإلكتروني الذي يستخدمه خادم Edge OpenLDAP.

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

IS_EXTERNAL_AUTH="true"

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

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

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

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

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

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

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

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

وأثناء عملية التحديث، بينما تكون عُقد 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_replication.connection=host واجهة برمجة التطبيقات للنسخ المتماثل existing_slave_ip/32 Trust\ \nالنسخ المتماثل للمضيف apigee new_slave_ip/32Trust

    حيث يكون existing_slave_ip هو عنوان IP لنظام Postgres الحالي. خادم وضع الاستعداد وnew_slave_ip هو عنوان IP لوضع الاستعداد الجديد العقدة.
  2. أعِد تشغيل apigee-postgresql. على خبير Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlreset
  3. تحقَّق من إضافة عقدة وضع الاستعداد الجديدة من خلال عرض /opt/apigee/apigee-postgresql/conf/pg_hba.conf ملف على الصفحة الرئيسية. من المفترض أن تظهر لك السطور التالية في هذا الملف:
    واجهة برمجة تطبيقات النسخ المتماثل للمضيف الحالية_slave_ip/32 Trust
    نسخة طبق الأصل من المضيف apigee new_slave_ip/32Trust
  4. تثبيت خادم وضع الاستعداد الجديد لـ Postgres:
    1. عدّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:

      # عنوان IP للعنوان الحالي الشريحة الرئيسية:
      PG_MASTER=192.168.56.103
      # عنوان IP لعقدة وضع الاستعداد الجديدة
      PG_STANDBY=192.168.56.102
    2. تعطيل SELinux كما هو موضح في Install the Edge. أداة إعداد apigee.
    3. نزِّل ملف Bootstrap_4.16.05.sh على Edge إلى /tmp/bootstrap_4.16.05.sh:
      > ضفيرة https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      ملاحظة: إذا كنت بصدد التحديث من الإصدار 4.16.01، يمكنك تنزيل ملف bootstrap.sh من Edge.
    4. ثبِّت الأداة والتبعيات في خدمة Edge apigee:
      &gt; sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. استخدم apigee-service لتثبيت الأداة المساعدة apigee-setup:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. تثبيت Postgres:
      &gt; /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. على عقدة وضع الاستعداد الجديدة، نفِّذ الأمر التالي:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql التحقق من وضع Postgres

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

إيقاف وظيفة Postgres العقدة

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

  1. تأكد من تشغيل Postgres:
    &gt; /opt/apigee/apigee-service/bin/apigee-all status

    إذا كانت أداة Postgres ليست قيد التشغيل، عليك تشغيلها:
    &gt; /opt/apigee/apigee-service/bin/apigee-all start
  2. يمكنك الحصول على المعرّف الفريد العالمي (UUID) لعقدة وضع الاستعداد الجديدة من خلال تشغيل أمر cURL التالي على الجهاز الجديد عقدة وضع الاستعداد:
    &gt; ضفيرة -u sysAdminEmail:password http://&lt;node_IP&gt;:8084/v1/servers/self

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

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

يتيح لك التحديث بدون توقف أو بدون انقطاع تحديث تثبيت Edge بدون جلب Edge.

لا يمكن تعديل وقت الاستراحة إلا باستخدام إعدادات مكونة من 5 عُقد وأكبر.

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

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

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

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

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

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

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

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

  1. إذا كنت تستخدم حاليًا تكرار وضع الاستعداد الرئيسي في Postgres، عليك تثبيت إصدار جديد من Postgres. عقدة وضع الاستعداد كما هو موضح أعلاه في تثبيت عقدة الاستعداد الجديدة لـ Postgres.
  2. إيقاف أي مهام CRON تم ضبطها لتنفيذ عملية إصلاح على Cassandra، في حال توفّرها إلى ما بعد اكتمال التحديث.
  3. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
    ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
  4. ثبِّت yum-utils ثم yum-plugin-priorities:
    > sudo yum install yum-utils
    &gt; sudo yum install yum-plugin-priorities
  5. إيقاف SELinux كما هو موضح في Install the Edge apigee-setup .
  6. تفعيل مستودع EPEL كما هو موضح أعلاه.
  7. في حال التثبيت على AWS، شغِّل الأمر yum-configure-manager:
    &gt; sudo yum-config-manager --تفعيل rhui-Region-rhel-server-extras rhui- وبذلك-rhel-server-OPTIONAL
  8. نزِّل ملف Edge 4.17.09 bootstrap_4.17.09.sh إلى /tmp/bootstrap_4.17.09.sh:
    . > ضفيرة https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  9. تثبيت أداة apigee-service في Edge 4.17.09 التبعيات:
    > sudo bash /tmp/bootstrap_4.17.09.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:
    1. في حال تثبيت الإصدار 4.16.01 من خلال ترقية الإصدار 4.15.07.0x من Edge، يجب تثبيت أداة إعداد واجهة برمجة التطبيقات:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

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

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

      يثبّت هذا التحديث الذي تم إجراؤه على apigee-service الأداة update.sh في /opt/apigee/apigee-setup/bin.
    3. إذا تم تثبيت الإصدار 4.16.05 مباشرةً أو عن طريق التحديث، يجب تحديث أداة إعداد apigee:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

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

      ملاحظة: في حال تثبيت أداة apigee-validate في رسالة عقدة المعالج عند تثبيت 4.16.01، يمكنك تحديثها باستخدام الأمر التالي على هذه العقدة:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate

      ومع ذلك، فاعتبارًا من الإصدار 4.16.05 والإصدارات الأحدث، تنصح Apigee بتثبيت واجهة برمجة التطبيقات أداة apigee-validate على خادم الإدارة.
    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
  13. شغِّل أداة التحديث على العُقد بالترتيب الموضح أدناه في "ترتيب الجهاز تحديث" أدناه:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    استخدِم الخيار "-c" لتحديد المكوِّن المطلوب تحديثه. قائمة الخيارات المحتملة تشمل المكونات ما يلي:
    ldap = OpenLDAP
    cs = كاساندرا
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
    ui = Edge UI
    all = تحديث جميع المكونات على الجهاز (يُستخدم فقط لملف تثبيت Edge aio أو لتثبيت واجهة برمجة التطبيقات BaaS asa الملف الشخصي)
    e = ElasticSearch
    b = واجهة برمجة التطبيقات BaaS Stack
    p = بوابة BaaS لواجهة برمجة التطبيقات
    ebp = ElasticSearch, API BaaS الحزمة وبوابة BaaS API الخاصة بواجهة برمجة التطبيقات على العقدة نفسها
  14. اختبر التحديث عن طريق تشغيل أداة التحقق من صحة واجهة برمجة التطبيقات (apigee) على خادم الإدارة، كما هو موضح في اختبار التثبيت.
  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:
      &gt; tar -xzf apigee-4.17.09.tar.gz

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

      لاحظ أنك قمت بتضمين المسار إلى دليل repos في هذا الأمر.
  4. لتثبيت خدمة apigee باستخدام خادم ويب Nginx:
    1. قم بتهيئة خادم الويب Nginx كما هو موضح في "التثبيت من المستودع باستخدام Nginx webserver&quot; في تثبيت Edge أداة إعداد apigee.
    2. في العقدة البعيدة، نزِّل ملف 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 أو اسم نظام أسماء النطاقات عقدة repo.
    3. في العقدة البعيدة، عليك تثبيت أداة خدمة واجهة برمجة التطبيقات Edge والتبعيات:
      &gt; sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      حيث تكون uName:pWord هي اسم المستخدم وكلمة المرور للمستودع.
  5. استخدِم apigee-service من أجل: لتحديث الأداة المساعدة لإعداد apigee:
    1. في حال تثبيت الإصدار 4.16.01 من خلال ترقية الإصدار 4.15.07.0x من Edge، يجب تثبيت أداة إعداد واجهة برمجة التطبيقات:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

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

      إذا كنت قد ثبتّ أداة apigee-setup من قبل، فحدِّث هي:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. إذا تم تثبيت الإصدار 4.16.01 مباشرةً، يعني هذا أنّك لم تقم بإجراء ترقية من 4.15.07.0x، يجب تحديث الأداة المساعدة لإعداد apigee:
      &gt; /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:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      يثبّت هذا التحديث الذي تم إجراؤه على apigee-service الأداة update.sh في /opt/apigee/apigee-setup/bin.
  6. بناءً على الإصدار الذي تستخدمه حاليًا من Edge، يجب عليك إما تثبيت أو تحديث apigee-validate على خادم الإدارة.
    1. إذا كنت تستخدم حاليًا Edge 4.16.05: حدِّث الأداة apigee-validate على الرابط. خادم الإدارة:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
    2. إذا كنت تستخدم حاليًا Edge 4.16.01: ثبّت التحقق من واجهة برمجة التطبيقات API. على خادم الإدارة:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate install

      ملاحظة: في حال تثبيت أداة apigee-validate على رسالة عقدة المعالج عند تثبيت 4.16.01، يمكنك تحديثها باستخدام الأمر التالي على هذه العقدة:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-checkate

      ومع ذلك، فاعتبارًا من الإصدار 4.16.05 والإصدارات الأحدث، تنصح Apigee بتثبيت واجهة برمجة التطبيقات التحقق من صحة apigee على خادم الإدارة.
    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
  8. شغِّل أداة التحديث على العُقد بالترتيب الموضّح أدناه في قسم "ترتيب الجهاز". تَحْدِيثْ" أدناه:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    استخدِم الخيار "-c" لتحديد المكوِّن المطلوب تحديثه. قائمة الخيارات المحتملة تشمل المكونات ما يلي:
    ldap = OpenLDAP
    cs = كاساندرا
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
    ui = Edge UI
    all = تحديث جميع المكونات على الجهاز (يُستخدم فقط لملف تثبيت Edge aio أو لتثبيت واجهة برمجة التطبيقات BaaS asa الملف الشخصي)
    e = ElasticSearch
    b = واجهة برمجة التطبيقات BaaS Stack
    p = بوابة BaaS لواجهة برمجة التطبيقات
    ebp = ElasticSearch, API BaaS الحزمة وبوابة BaaS API الخاصة بواجهة برمجة التطبيقات على العقدة نفسها
  9. اختبر التحديث عن طريق تشغيل أداة التحقق من صحة واجهة برمجة التطبيقات (apigee) على خادم الإدارة، كما هو موضح في اختبار التثبيت.
  10. في حال تثبيت عقدة وضع الاستعداد جديدة من Postgres، يجب فصل العقدة كما هو موضح أعلاه في إيقاف عقدة Postgres.

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

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

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

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

لمضيف واحد مستقل التثبيت

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

    متابعة التحقّق من قائمة الانتظار إلى أن يظهر العدد في "الرسالة" العمود 0. لا يمكنك ترقية Qpid إلى أن ينتهي من معالجة جميع الرسائل.
  6. تعديل qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. مسح iptables:
    &gt; sudo iptables -F
  8. تعديل LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. أوقِف خادم Postgres Server وخادم Qpid وPostgreSQL:
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
    &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-serverstop
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  10. تعديل postgresql:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. عدِّل قاعدة بيانات Postgres:
    . &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. تحديث مكونات Edge المتبقية:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  13. تحديث واجهة مستخدم Edge:
    &gt; /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:
    &gt; الرجوع إلى إصدار سابق حديقة حيوان
  3. تحديث Cassandra و ZooKeeper على الجهاز 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. ضبط قاعدة iptables على الجهاز 2:
    &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  5. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 2:
    &gt; qpid-stat -q

    متابعة التحقّق من قائمة الانتظار إلى أن يظهر العدد في "الرسالة" العمود 0. لا يمكنك ترقية Qpid إلى أن ينتهي من معالجة جميع الرسائل.
  6. تعديل qpidd على الجهاز 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. مسح ملفات iptable على الجهاز 2:
    &gt; sudo iptables -F
  8. تحديث LDAP على الجهاز 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. تحديث مكونات Edge على الجهاز 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. تحديث واجهة المستخدم على الجهاز 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  11. تحديث postgresql على الجهاز 2:
    1. أوقِف خادم Postgres وخادم Qpid وpostgresql:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. تعديل postgresql:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. عدِّل قاعدة بيانات Postgres:
      . &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. تحديث مكونات Edge على الجهاز 2 والجهاز 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. تحديث مكونات Edge على الجهاز 2:
    &gt; /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 على الإصدارات macine 1 و2 و3:
    &gt; الرجوع إلى إصدار سابق حديقة حيوان
  4. تحديث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. ضبط قاعدة iptables التالية على الجهاز 4:
    &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  6. تحقَّق من قائمة انتظار رسائل Qpid على الجهاز 4:
    &gt; qpid-stat -q

    متابعة التحقّق من قائمة الانتظار إلى أن يظهر العدد في "الرسالة" العمود 0. لا يمكنك ترقية Qpid إلى أن ينتهي من معالجة جميع الرسائل.
  7. تعديل qpidd على الجهاز 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. مسح ملفات iptable على الجهاز 4:
    &gt; sudo iptables -F
  9. كرر الخطوات من 5 إلى 8 على الجهاز 5.
  10. تحديث LDAP على الجهاز 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. تحديث مكونات Edge على الجهاز 1 و2 و3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. تحديث واجهة المستخدم على الجهاز 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. أجهزة التحديث 4 و5:
    1. إيقاف خادم Postgres وخادم Qpid على الجهاز 4:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-serverstop
    2. إيقاف خادم Postgres وخادم Qpid وpostgresql على الجهاز 5:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. أوقف خادم Postgres وpostgresql في عقدة الاستعداد الجديدة التي أضفتها إلى العودة إلى الحالة السابقة:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. تعديل postgresql على الأجهزة 4:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. عدِّل قاعدة بيانات Postgres على الجهاز 4 (إصدار Postgres الرئيسي فقط):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. تعديل Postgresql على الأجهزة 5:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. بدء خادم Postgres وخادم Qpid على الجهازين 4 و5:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    8. يمكنك ضبط Postgres كعقدة وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز. 5:
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql إعداد-النسخ-الفعلي-لوضع الاستعداد -f
      configFile
    9. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. تشير رسالة الأشكال البيانية نتائج مماثلة على كلا الخادمين لضمان النسخ المتماثل:

      على الجهاز 4، العقدة الرئيسية، شغِّل:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Postgres-check-master

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

      في الجهاز 5، عقدة وضع الاستعداد:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql التحقق من وضع Postgres

      تأكَّد من أنّ الجهاز في وضع الاستعداد.
  14. تحديث مكونات Edge على الجهاز 4، 5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  15. تأكد من إنهاء عقدة وضع الاستعداد الجديدة باستخدام الإجراء الموضح أعلاه في إيقاف أجهزة Postgres العقدة.

للمضيفين المكوَّنين من 9 مضيفات التثبيت

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

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

    متابعة التحقّق من قائمة الانتظار إلى أن يظهر العدد في "الرسالة" العمود 0. لا يمكنك ترقية Qpid إلى أن ينتهي من معالجة جميع الرسائل.
  7. تعديل qpidd على الجهاز 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. مسح ملفات iptable على الجهاز 6:
    &gt; sudo iptables -F
  9. كرر الخطوات من 5 إلى 8 على الجهاز 7.
  10. تحديث LDAP على الجهاز 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. عليك تحديث مكونات Edge على الأجهزة 6 و7 و1 و4 و5 بهذا الترتيب:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. تحديث واجهة المستخدم على الجهاز 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. أجهزة التحديث 8 و9:
    1. إيقاف خادم Postgres على الجهاز 8:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
    2. إيقاف خادم Postgres وpostgresql على الجهاز 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. إيقاف خادم Qpid على الجهازين 6 و7:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-serverstop
    4. أوقف خادم Postgres وpostgresql في عقدة الاستعداد الجديدة التي أضفتها إلى العودة إلى الحالة السابقة:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. تعديل postgresql على الأجهزة 8:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. عدِّل قاعدة بيانات Postgres على الجهاز 8 (إصدار Postgres الرئيسي فقط):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. تعديل postgresql على الأجهزة 9:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. بدء خادم Postgres على الجهازَين 8 و9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. بدء خادم Qpid على الجهازين 6 و7:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. يمكنك ضبط Postgres كعقدة وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز. 9:
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql إعداد-النسخ-الفعلي-لوضع الاستعداد -f
      configFile
    11. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. تشير رسالة الأشكال البيانية نتائج مماثلة على كلا الخادمين لضمان النسخ المتماثل:
      على الجهاز 8، العقدة الرئيسية، شغِّل:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Postgres-check-master

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

      في الجهاز 9، عقدة وضع الاستعداد:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql التحقق من وضع Postgres

      تأكَّد من أنّ الجهاز في وضع الاستعداد.
  14. تحديث مكونات Edge على الجهازين 8 و9:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  15. تأكد من إنهاء عقدة وضع الاستعداد الجديدة باستخدام الإجراء الموضح أعلاه في إيقاف أجهزة Postgres العقدة.

للمضيفين المكوَّنين من 13 مضيفًا التثبيت

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

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

    متابعة التحقّق من قائمة الانتظار إلى أن يظهر العدد في "الرسالة" العمود 0. لا يمكنك ترقية Qpid إلى أن ينتهي من معالجة جميع الرسائل.
  7. تعديل qpidd على الجهاز 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. مسح ملفات iptable على الجهاز 12:
    &gt; sudo iptables -F
  9. كرر الخطوات من 5 إلى 8 على الجهاز 13.
  10. تحديث LDAP على الجهاز 4 و5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. عليك تحديث مكونات Edge على الأجهزة 12 و13 و6 و7 و10 و11 بهذا الترتيب:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  12. تحديث واجهة المستخدم على الجهازين 6 و7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. أجهزة التحديث 8 و9:
    1. إيقاف خادم Postgres على الجهاز 8:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
    2. إيقاف خادم Postgres وpostgresql على الجهاز 9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. إيقاف خادم Qpid على الجهازين 12 و13:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-serverstop
    4. أوقف خادم Postgres وpostgresql في عقدة الاستعداد الجديدة التي أضفتها إلى العودة إلى الحالة السابقة:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. تعديل postgresql على الأجهزة 8:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. عدِّل قاعدة بيانات Postgres على الجهاز 8 (إصدار Postgres الرئيسي فقط):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. تعديل postgresql على الأجهزة 9:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. بدء خادم Postgres على الجهازَين 8 و9:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. بدء خادم Qpid على الجهازين 12 و13:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. يمكنك ضبط Postgres كعقدة وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز. 9:
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql إعداد-النسخ-الفعلي-لوضع الاستعداد -f
      configFile
    11. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. تشير رسالة الأشكال البيانية نتائج مماثلة على كلا الخادمين لضمان النسخ المتماثل:
      على الجهاز 8، العقدة الرئيسية، شغِّل:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Postgres-check-master

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

      في الجهاز 9، عقدة وضع الاستعداد:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql التحقق من وضع Postgres

      تأكَّد من أنّ الجهاز في وضع الاستعداد.
  14. تحديث مكونات Edge على الجهازين 8 و9:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  15. تأكد من إنهاء عقدة وضع الاستعداد الجديدة باستخدام الإجراء الموضح أعلاه في إيقاف أجهزة Postgres العقدة.

للمضيفين المكوَّنين من 12 مضيفًا التثبيت

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

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

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

        متابعة التحقّق من قائمة الانتظار إلى أن يظهر العدد في "الرسالة" العمود 0. لا يمكنك ترقية Qpid إلى أن يعالج جميع الرسائل.
      3. عدِّل qpidd على الجهاز 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. مسح ملفات iptable على الجهاز 10:
        &gt; sudo iptables -F
      5. كرِّر الخطوات من 1 إلى 4 على الجهاز 11.
  5. تحديث LDAP:
    1. الأجهزة 1 في مركز البيانات 1
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. الأجهزة 7 في مركز البيانات 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. تحديث مكونات Edge:
    1. الأجهزة 4 و5 و1 و2 و3 في مركز البيانات 1
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
    2. الأجهزة 10 و11 و7 و8 و9 في مركز البيانات 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  7. تحديث واجهة المستخدم:
    1. الجهاز 1 في مركز البيانات 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. الجهاز 7 في مركز البيانات 2:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. تحديث الجهاز 6 في مركز البيانات 1 و12 في مركز البيانات 2:
    1. إيقاف خادم Postgres على الجهاز 6:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
    2. إيقاف خادم Postgres وpostgresql على الجهاز 12:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. إيقاف خادم Qpid على الأجهزة 4 و5 و10 و11:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-serverstop
    4. أوقف خادم Postgres وpostgresql في عقدة الاستعداد الجديدة التي أضفتها إلى العودة إلى الحالة السابقة:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-serverstop
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. تعديل Postgresql على الأجهزة 6:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. عدِّل قاعدة بيانات Postgres على الجهاز 6 (إصدار Postgres الرئيسي فقط):
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. تعديل postgresql على الأجهزة 12:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. بدء خادم Postgres على الجهازين 6 و12:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-postgres-server start
    9. بدء خادم Qpid على الأجهزة 4 و5 و10 و11:
      &gt; /opt/apigee/apigee-service/bin/apigee-service Edge-qpid-server start
    10. يمكنك ضبط Postgres كعقدة وضع الاستعداد عن طريق تشغيل الأوامر التالية على الجهاز. 12:
      &gt; cd /opt/apigee/data/apigee-postgresql/pgdata
      &gt; rm -rf *
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql إعداد-النسخ-الفعلي-لوضع الاستعداد -f
      configFile
    11. تحقق من حالة النسخ المماثل من خلال إصدار النصوص البرمجية التالية على كلا الخادمين. تشير رسالة الأشكال البيانية نتائج مماثلة على كلا الخادمين لضمان النسخ المتماثل:
      على الجهاز 6، العقدة الرئيسية، شغِّل:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql Postgres-check-master

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

      في الجهاز 12، عقدة وضع الاستعداد:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql التحقق من وضع Postgres

      تأكَّد من أنّ الجهاز في وضع الاستعداد.
  9. تحديث مكونات Edge على الجهازين 6 و12:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
  10. تأكد من إنهاء عقدة وضع الاستعداد الجديدة باستخدام الإجراء الموضح أعلاه في إيقاف أجهزة Postgres العقدة.

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

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

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

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