تحديث Apigee Edge 4.51.00 أو 4.52.00 أو 4.52.01 إلى 4.52.02

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

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

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

بعد تثبيت Edge RPM، يمكن لأي شخص إعداده.

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

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

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

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

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

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

  • التأكُّد من تشغيل Edge
    تأكَّد من تشغيل Edge أثناء عملية التحديث باستخدام الأمر:
    /opt/apigee/apigee-service/bin/apigee-all status
  • التأكّد من أنّ استراتيجية ضغط Cassandra هي LeveledCompactionStrategy
    يجب التأكّد من ضبط استراتيجية ضغط Cassandra على LeveledCompactionStrategy، كما هو موضّح في تغيير استراتيجية ضغط Cassandra.

الخطوات الخاصة التي يجب مراعاتها للترقية

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

الإصدار الحالي البرامج التي تتطلب خطوات خاصة للترقية إلى الإصدار 4.52.02
4.52.01 كاساندرا
4.52.00 كاساندرا، Zookeeper، Qpid
4.51.00 "كاساندرا" و"حديقة الحيوانات" و"Qpid" و"Postgres"

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

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

الترقية المطلوبة إلى إصدار Cassandra 3.11.16

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

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

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

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

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

لمزيد من التفاصيل، يُرجى الاطّلاع على القسم إعادة تحديث Cassandra 3.11.16.

توثيق واجهات برمجة التطبيقات في بوابة المطوّرين

توفّر بوابة مطوّري برامج Apigee Drupal ميزات متنوعة لتوثيق واجهات برمجة التطبيقات. على الرغم من أنّنا ننصح بالتوقّف عن استخدام بوابة المطوّرين المستنِدة إلى Drupal 7، إذا كنت لا تزال تستخدم هذه البوابة وتستخدم ميزة Smart Docs الخاصة بها، ينطبق عليك مستند استخدام واجهات برمجة تطبيقات Smartالمستندات. إذا كنت تستخدم إصدارات أحدث من بوابة المطوّرين، لن يكون هناك أي تأثير في وثائق واجهة برمجة التطبيقات أثناء هذه الترقية.

عند ترقية Apigee إلى الإصدار 4.52.02، لن يتم تلقائيًا نقل أي نماذج لواجهة برمجة تطبيقات تم إنشاؤها باستخدام ميزة Smartالمستندات في بوابة المطوّرين 7 على Drupal 7 إلى الإصدار الأحدث. ومن المتوقّع أن يتم تصدير كل نموذج يدويًا باستخدام بوابة المطوّرين واستيراده مرة أخرى بعد إكمال عملية الترقية.

المصطلحات المستخدَمة في الأقسام التالية

وقت التشغيل: يشمل "بيئة التشغيل" معالجة حركة بيانات الخادم الوكيل لبيئة التشغيل. تشمل هذه العمليات جميع العمليات التي تجريها أجهزة التوجيه ومعالِجات الرسائل (Routes) لمعالجة طلب البيانات من واجهة برمجة التطبيقات (API) الخاص بوقت التشغيل للخوادم الوكيلة الحالية. ومع ذلك، فهو لا يشمل نشر خوادم وكيلة جديدة أو مراجعات جديدة للخوادم الوكيلة.

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

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

الخطوة 0: حالة البدء

  1. تعمل "كاساندرا" في Apigee بالإصدار 2.1.22.
  2. مكونات Edge for Private Cloud 4.52.02:
    • خادم إداري يتواصل مع "كاساندرا" عبر بروتوكول سرقة قديم.
    • خوادم وقت التشغيل (معالِجات الرسائل وأجهزة التوجيه) تتصل بـ "كاساندرا" من خلال بروتوكول توفير قديم.
حالة بيئة التشغيل في هذه المرحلة حالة الإدارة في هذه المرحلة
بيئة التشغيل تعمل بكامل طاقتها إدارة كاملة الوظائف

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

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

  1. غيِّر "كاساندرا" لاستخدام LeveledCompactionStrategy.
  2. يُرجى الاحتفاظ بنسخة احتياطية من بيانات "كاساندرا" باستخدام Apigee.
  3. التقِط لقطات VM لعُقد Cassandra (إذا كان ذلك ممكنًا)
  4. أنشِئ ملف إعداد ترقية لـ Cassandra في كل عقدة Cassandra في /opt/apigee/apigee-cassandra/cass_upgrade.conf. يتضمّن المحتوى التالي:
    # IP Address of node
    HOSTIP=10.0.0.1
    
    # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
    CASS_USERNAME=<cassuser>
    
    # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
    CASS_PASSWORD=<casspass>
    
    # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
    CASS_PORT=9160
    
    # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
    CASS_CQL_PORT=9042
    
    # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
    # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
    CASS_TMP_DIR=/tmp/cass_upgrade_scripts
        
    إذا تعذّر إنشاء الملف على /opt/apigee/apigee-cassandra/cass_upgrade.conf، أنشِئ الملف /opt/silent.conf باستخدام المحتوى نفسه في كل عقدة Cassandra.
  • إذا كنت تستخدم ميزة Smartالمستندات في بوابة مطوّري البرامج في Apigee Drupal 7، يمكنك تصدير كل نموذج من نماذجك من خلال تنزيلها بتنسيق JSON من واجهة مستخدم بوابة المطوِّر. يجب استيراد هذه النماذج مرة أخرى إلى Apigee بعد تحديث خوادم الإدارة.
  • تأكَّد من إمكانية الوصول إلى المنفذين 9160 و9042 من جميع مكونات Edge for Private Cloud 4.52.02 إلى عُقد Cassandra إذا لم تكن متوفّرة. راجِع متطلبات المنافذ لمعرفة مزيد من المعلومات.

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

  1. ترقية جميع عُقد Cassandra في جميع المناطق واحدة تلو الأخرى نفِّذ الطلبات التالية على كل عقدة:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. بعد تعديل إحدى العُقد، شغِّل الأمر التالي على العقدة لإجراء بعض عمليات التحقُّق قبل المتابعة:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. سيؤدي ما سبق إلى عرض نص على غرار:
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
حالة بيئة التشغيل في هذه المرحلة حالة الإدارة في هذه المرحلة
بيئة التشغيل تعمل بكامل طاقتها يتم إيقاف دالة الإدارة التالية بعد ترقية "كاساندرا":

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

ترقية جميع عُقد الإدارة في جميع المناطق واحدة تلو الأخرى:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
حالة بيئة التشغيل حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها تخفيض مستوى واجهة برمجة تطبيقات الإدارة:

الخطوة 3 (أ): [اختياري] استيراد تطبيق Smartالمستندات التي تم تصديرها سابقًا

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

حالة بيئة التشغيل حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها إدارة كاملة الوظائف

الخطوة 4: ترقية جميع عُقد بيئة التشغيل

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
حالة بيئة التشغيل حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها إدارة كاملة الوظائف

الخطوة 5: ترقية جميع مكوّنات Edge المتبقية للإصدار Private Cloud 4.52.02

يجب ترقية كل عُقدة edge-qpid-server وedge-postgres-server المتبقية في جميع المناطق واحدة تلو الأخرى.

في هذه المرحلة، إذا كنت بصدد الترقية من إصدارات أقدم من Edge for Private Cloud 4.52.01، وكنت تتّبع خطوات إضافية لترقية Qpid أو Postgres، عليك اتّباع الخطوات المناسبة للترقية.

حالة بيئة التشغيل حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها إدارة كاملة الوظائف

الخطوة 6: ما بعد خطوات الترقية

قم بتشغيل الأمر التالي على كل عقدة Cassandra واحدًا تلو الآخر بعد اكتمال الترقية:

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

قم بتشغيل الأمر التالي لإسقاط الجداول القديمة غير المستخدمة من مجموعة Cassandra. وحتى يتم تشغيل هذا الإعداد، لا يمكنك استخدام ميزات معينة من Cassandra (مثل إعداد مصادقة جديدة - وسيستمر عمل آليات المصادقة القديمة). يمكن تنفيذ هذا الأمر على عقدة واحدة فقط في المجموعة:

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

أكمل الخطوة 3 (أ) إذا لم تكن قد أكملتها من قبل.

حالة بيئة التشغيل حالة الإدارة
بيئة التشغيل تعمل بكامل طاقتها إدارة كاملة الوظائف

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

على الرغم من أنّ Edge for Private Cloud 4.52.02 لا يتضمّنان ترقية إلى Zookeeper، إذا كنتم بصدد الترقية من إصدارات أقدم من 4.52.01، يجب اتّباع الخطوات لترقية Zookeeper.

  • في حال الترقية من الإصدار 4.51.00 أو 4.52.00 من Edge for Private Cloud، يُرجى الرجوع إلى الخطوات الواردة في الترقية المطلوبة إلى Zookeeper 3.8.3 لترقية Zookeeper.
  • إذا كنت بصدد الترقية من الإصدار 4.52.01 من Edge for Private Cloud، من المفترض أنّك تستخدم الإصدار 3.8.3 من Zookeeper، ولا تحتاج إلى اتّباع أي خطوات خاصة لترقية Zookeeper.

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

  • في حال الترقية من Edge for Private Cloud 4.51.00 إلى 4.52.02، يجب اتّباع الخطوات اللازمة لترقية Postgres، على الرغم من أنّ Edge for Private Cloud 4.52.02 لا يشتمل على ترقية Postgres. تتطلب الترقية من Edge for Private Cloud 4.51.00 إلى 4.52.02 خطوات ترقية إضافية لـ Postgres. يُرجى الرجوع إلى قسم الترقية المطلوبة إلى Postgres 14.
  • في حال الترقية من Edge for Private Cloud 4.52.00 أو 4.52.01 إلى 4.52.02، ليس عليك اتخاذ أي خطوات إضافية للترقية باستخدام Postgres.

الترقية المطلوبة إلى Qpid J-Broker

على الرغم من أنّ Edge for Private Cloud 4.52.02 لا يتضمّنان ترقية إلى QPID، إذا كنت تعمل على الترقية من إصدارات أقدم من 4.52.01، يجب اتّباع الخطوات لترقية QPID.

  • في حال الترقية من Edge for Private Cloud 4.51.00 أو 4.52.00 إلى 4.52.02، يجب اتّباع خطوات ترقية QPID الإضافية. يُرجى الرجوع إلى قسم ترقية Qpid إذا كنت بصدد الترقية من الإصدار 4.51.00 أو 4.52.00 إلى 4.52.02.
  • في حال الترقية من Edge for Private Cloud 4.52.01 إلى 4.52.02، من المفترَض أنّك تستخدم أحدث إصدار من وسيط Qpid، وليس عليك اتخاذ أي خطوات إضافية لترقية QPID.

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

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

تثبيت واجهة مستخدم Edge

بعد إكمال عملية التثبيت الأولية، تنصحك Apigee بتثبيت واجهة مستخدم Edge، وهي واجهة مستخدم محسَّنة لمطوّري ومشرفي Apigee Edge for Private Cloud.

يُرجى العلم أنّ واجهة مستخدم Edge تتطلّب إيقاف المصادقة الأساسية واستخدام موفِّر الهوية مثل SAML أو LDAP.

للمزيد من المعلومات، يُرجى الاطّلاع على تثبيت واجهة مستخدم Edge الجديدة.

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

لتحديث مكوّن واجهة مستخدم Edge، ننصحك باستخدام إصدار Edge الخاص بالسحابة الخاصة الذي ستتم الترقية منه:

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

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

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

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

إذا تعذّر عليك الرجوع إلى الإصدار السابق، راجِع العودة إلى الإصدار 4.52.00 للحصول على تعليمات تفصيلية.

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

بشكل تلقائي، تكتب الأداة المساعدة update.sh معلومات السجل إلى:

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. في حال توفُّرها، يمكنك إيقاف أي مهام cron تم ضبطها لتنفيذ عملية إصلاح في Cassandra إلى أن يكتمل التحديث.
  2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
  3. تثبيت yum-utils وyum-plugin-priorities:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. أوقِف SELinux كما هو موضّح في تثبيت الأداة المساعدة Edge apigee-setup.
  5. في حال التثبيت على الإصدار Oracle 7.x، نفِّذ الأمر التالي:
    sudo yum-config-manager --enable ol7_optional_latest
  6. في حال تثبيت التطبيق على AWS، نفِّذ أوامر yum-configure-manager التالية:
    yum update rh-amazon-rhui-client.noarch
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. إذا كنت تستخدم حاليًا الإصدار 4.51.00 من Edge:

    1. نزِّل ملف Edge bootstrap_4.52.02.sh إلى /tmp/bootstrap_4.52.02.sh:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. ثبِّت الأداة المساعدة apigee-service والتبعيات من Edge 4.52.02 من خلال تنفيذ الأمر التالي:
      sudo bash /tmp/bootstrap_4.52.02.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 بنفسك.
    3. استخدِم apigee-service لتحديث الأداة apigee-setup، كما يبيِّن المثال التالي:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. تحديث الأداة apigee-validate على خادم الإدارة، كما يبيِّن المثال التالي:
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. تحديث الأداة apigee-provision على خادم الإدارة، كما يبيِّن المثال التالي:
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. شغِّل أداة update على العُقد من خلال تنفيذ الأمر التالي:
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

      المكان:

      • component هو مكوِّن Edge الذي يجب تحديثه. وتشمل القيم المتاحة ما يلي:
        • cs: كاساندرا
        • edge: جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: الدخول المُوحَّد (SSO) في Apigee (في حال تثبيت الدخول المُوحَّد (SSO))
        • ue: واجهة مستخدم Edge جديدة
        • ui: واجهة مستخدم Edge الكلاسيكية
        • zk: حارس حديقة الحيوان
      • configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكونات Edge أثناء التثبيت 4.50.00 أو 4.51.00.

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

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. أعِد تشغيل مكوِّن واجهة مستخدم Edge على جميع العُقد التي يشغلها، إذا لم يسبق لك فعل ذلك:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    8. اختبر التحديث من خلال تشغيل أداة apigee-validate على خادم الإدارة، كما هو موضح في اختبار التثبيت.

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

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

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

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

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

للتحديث من مستودع محلي 4.52.02:

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

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

    4. ثبِّت أداة Edge apigee-service والتبعيات من /tmp/repos:
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. لتثبيت خدمة apigee باستخدام خادم ويب Nginx:
    1. اضبط خادم الويب Nginx كما هو موضّح في "التثبيت من المستودع باستخدام خادم ويب Nginx" في تثبيت الأداة المساعدة Edge apigee-setup.
    2. في العقدة البعيدة، نزِّل ملف Edge bootstrap_4.52.02.sh على /tmp/bootstrap_4.52.02.sh:
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

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

    3. في العقدة البعيدة، ثبِّت أداة Edge apigee-setup والتبعيات:
      sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  4. استخدِم apigee-service لتحديث الأداة apigee-setup، كما يبيِّن المثال التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
  5. تحديث الأداة apigee-validate على خادم الإدارة، كما يبيِّن المثال التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. تحديث الأداة apigee-provision على خادم الإدارة، كما يبيِّن المثال التالي:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. شغِّل أداة update على العُقد بالترتيب الموضّح في ترتيب تحديث الجهاز:
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    المكان:

    • component هو مكوِّن Edge الذي يجب تحديثه. تُجري عادةً تعديلاً لالمكوّنات التالية:
      • cs: كاساندرا
      • edge: جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: الدخول المُوحَّد (SSO) في Apigee (في حال تثبيت الدخول المُوحَّد (SSO))
      • ue واجهة مستخدم Edge الجديدة
      • ui: واجهة مستخدم Edge الكلاسيكية
      • zk: حارس حديقة الحيوان
    • configFile هو ملف الإعداد نفسه الذي استخدمته لتحديد مكونات Edge أثناء التثبيت 4.50.00 أو 4.51.00.

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

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. أعِد تشغيل مكونات واجهة المستخدم على جميع العُقد التي تستخدمها، إذا لم يسبق لك إجراء ذلك:
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. اختبر التحديث من خلال تشغيل أداة apigee-validate على خادم الإدارة، كما هو موضح في اختبار التثبيت.

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

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

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

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

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

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

  1. تعديل جميع المكوّنات:
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (في حالة تثبيت apigee-adminapi) حدّث الأداة apigee-adminapi:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

ترقية مستقلة بعقدة ثنائية

حدِّث المكونات التالية لتثبيت مستقل بعقدة 2:

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

  1. تحديث Cassandra و ZooKeeper على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تحديث Postgres على الجهاز 2:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تحديث LDAP على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. تحديث مكونات Edge على الجهازين 2 و1:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. تعديل Qpid على الجهاز 2:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. تحديث واجهة المستخدم على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (في حال تثبيت apigee-adminapi) حدّثت الأداة apigee-adminapi على الجهاز 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) يُرجى تعديل الدخول المُوحَّد (SSO) في Apigee على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  9. أعِد تشغيل مكوِّن واجهة مستخدم Edge على الجهاز 1:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

ترقية 5 عُقد

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

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

  1. تحديث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تحديث Postgres على الجهاز 4:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تحديث Postgres على الجهاز 5:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. تحديث LDAP على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. تحديث مكونات Edge على الجهاز 4 و5 و1 و2 و3:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. تحديث Qpid على الجهاز 4:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. تحديث Qpid على الجهاز 5:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. تحديث واجهة مستخدم Edge:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، يجب تحديث المكوِّن ui على الجهاز رقم 1، كما هو موضّح في المثال التالي:
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • واجهة مستخدم Edge الجديدة: في حال تثبيت واجهة مستخدم Edge الجديدة، يجب تحديث المكوِّن ue على الجهاز المناسب (قد لا يكون الجهاز 1):
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (في حال تثبيت apigee-adminapi) حدّثت الأداة apigee-adminapi على الجهاز 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) يُرجى تعديل الدخول المُوحَّد (SSO) في Apigee على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. أعِد تشغيل مكوِّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، يجب إعادة تشغيل المكوِّن edge-ui على الجهاز رقم 1، كما هو موضّح في المثال التالي:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • واجهة مستخدم Edge الجديدة: إذا تم تثبيت واجهة مستخدم Edge الجديدة، أعِد تشغيل المكوِّن edge-management-ui على الجهاز المناسب (قد لا يكون الجهاز 1):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. تحديث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تحديث Postgres على الجهاز 8:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تحديث Postgres على الجهاز 9:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. تحديث LDAP على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. عليك تحديث مكونات Edge على الأجهزة 6 و7 و8 و9 و1 و4 و5 بهذا الترتيب:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. تعديل Qpid على الجهازين 6 و7:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. تحديث واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (في حال تثبيت apigee-adminapi) حدِّث أداة "apigee-adminapi" على الجهاز 1:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) يُرجى تعديل الدخول المُوحَّد (SSO) في Apigee على الجهاز 1:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. أعِد تشغيل مكوِّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، يجب إعادة تشغيل المكوِّن edge-ui على الجهاز رقم 1، كما هو موضّح في المثال التالي:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • واجهة مستخدم Edge الجديدة: إذا تم تثبيت واجهة مستخدم Edge الجديدة، أعِد تشغيل المكوِّن edge-management-ui على الجهاز المناسب (قد لا يكون الجهاز 1):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. تحديث Cassandra و ZooKeeper على الأجهزة 1 و2 و3:
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. تحديث Postgres على الجهاز 8:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. تحديث Postgres على الجهاز 9:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. تحديث LDAP على الجهازين 4 و5:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. تحديث مكونات Edge على الأجهزة 12 و13 و8 و9 و6 و7 و10 و11 بهذا الترتيب:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. تعديل Qpid على الجهازين 12 و13:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. تحديث إما واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui) على الجهازين 6 و7:
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (في حال تثبيت apigee-adminapi) حدّثت الأداة apigee-adminapi على الجهازين 6 و7:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee): تعديل الدخول المُوحَّد (SSO) في Apigee على الجهازين 6 و7:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. أعِد تشغيل مكوِّن واجهة المستخدم:
    • واجهة المستخدم الكلاسيكية: إذا كنت تستخدم واجهة المستخدم الكلاسيكية، يجب إعادة تشغيل المكوِّن edge-ui على الجهازين 6 و7 على النحو الموضّح في المثال التالي:
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • واجهة مستخدم Edge الجديدة: في حال تثبيت واجهة مستخدم Edge الجديدة، يُرجى إعادة تشغيل المكوِّن edge-management-ui على الجهازين 6 و7:
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. تحديث Cassandra و ZooKeeper:
    1. على الأجهزة 1 و2 و3 في "مركز البيانات" 1:
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. على الأجهزة 7 و8 و9 في "مركز البيانات" 2
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. عدِّل Postgres:
    1. الجهاز 6 في مركز البيانات 1
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. الجهاز 12 في مركز البيانات 2
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. عدِّل 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
  4. حدِّث مكونات Edge:
    1. الأجهزة 4 و5 و6 و1 و2 و3 في مركز البيانات رقم 1
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. الأجهزة 10 و11 و12 و7 و8 و9 في مركز البيانات 2
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. عدِّل qpidd:
    1. الجهازان 4 و5 في مركز البيانات 1
      1. تحديث qpidd على الجهاز 4:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. تحديث qpidd على الجهاز 5:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. الجهازان 10 و11 في مركز البيانات 2
      1. التحديث qpidd على الجهاز 10:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. التحديث qpidd على الجهاز 11:
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. تحديث إما واجهة المستخدم الجديدة (ue) أو واجهة المستخدم الكلاسيكية (ui):
    1. الجهاز 1 في مركز البيانات 1:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. الجهاز 7 في مركز البيانات 2:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (في حال تثبيت apigee-adminapi) حدّثت الأداة apigee-adminapi:
    1. الجهاز 1 في مركز البيانات 1:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. الجهاز 7 في مركز البيانات 2:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (في حال تثبيت الدخول المُوحَّد (SSO) في Apigee) عدِّل الدخول المُوحَّد (SSO) في Apigee:
    1. الجهاز 1 في مركز البيانات 1:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. الجهاز 7 في مركز البيانات 2:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    3. حيث sso_config_file هو ملف الإعداد الذي أنشأته عند تثبيت خدمة الدخول المُوحَّد (SSO).

  9. أعِد تشغيل واجهة مستخدم Edge الجديد (edge-management-ui) أو عنصر واجهة مستخدم Edge الكلاسيكي (edge-ui) على الجهازين 1 و7:
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

بالنسبة إلى الإعدادات غير العادية

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

  1. ZooKeeper
  2. كاساندرا
  3. ps
  4. LDAP
  5. وEdge، أي ملف تعريف "-c Edge" على جميع العُقد بالترتيب: العقد التي تتضمّن خادم Qpid وخادم Edge Postgres وخادم الإدارة ومعالج الرسائل وجهاز التوجيه.
  6. Qpidd
  7. Edge UI (إما الإصدار الكلاسيكي أو الجديد)
  8. apigee-adminapi
  9. الدخول المُوحَّد (SSO) في Apigee

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