متطلبات التثبيت

الإصدار 4.18.01 من Edge الخاص بخدمة Private Cloud

متطلبات الأجهزة

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

تشمل هذه الجداول متطلبات القرص الثابت بالإضافة إلى مساحة القرص الثابت التي يتطلبها نظام التشغيل. استنادًا إلى التطبيقات وحركة بيانات الشبكة، قد يتطلب التثبيت موارد أكثر أو أقل مما هو مدرج أدناه.

بالإضافة إلى ذلك، تنطبق المتطلبات التالية على متطلبات الأجهزة إذا أردت تثبيت "خدمات تحقيق الربح":

في ما يلي قائمة بمتطلبات الأجهزة إذا كنت تريد تثبيت نظام BaaS لواجهة برمجة التطبيقات:

متطلبات نظام التشغيل والبرامج الخارجية

تم اختبار تعليمات التثبيت هذه وملفات التثبيت المرفقة على أنظمة التشغيل والبرامج الخارجية المدرَجة في البرامج المتوافقة والإصدارات المتوافقة.

إنشاء مستخدم واجهة برمجة التطبيقات

ينشئ إجراء التثبيت مستخدم نظام Unix يُسمى "apigee". أمّا أدلة Edge وملفاتها، فهي مملوكة لـ "apigee"، وكذلك عمليات Edge. وهذا يعني أنّ مكونات Edge يتم تشغيلها كمستخدم "apigee". وعند الضرورة، يمكنك تشغيل المكونات كمستخدم مختلف.

دليل التثبيت

تكتب أداة التثبيت تلقائيًا جميع الملفات في دليل /opt/apigee. لا يمكنك تغيير موقع الدليل هذا. ومع أنّه لا يمكنك تغيير هذا الدليل، يمكنك إنشاء رابط رمزي لربط /opt/apigee بموقع جغرافي آخر، كما هو موضّح أدناه.

في التعليمات الواردة في هذا الدليل، تتم الإشارة إلى دليل التثبيت على النحو التالي: /opt/apigee.

إنشاء رابط رمزي من /opt/apigee

قبل إنشاء الرابط الرمزي، يجب أولاً إنشاء مستخدم ومجموعة باسم "apigee". وهذه هي المجموعة والمستخدم نفسهما اللتان تم إنشاؤهما بواسطة أداة تثبيت Edge.

لإنشاء الرابط الرمزي، نفذ هذه الخطوات قبل تنزيل ملف Bootstrap_4.18.01.sh. يجب تنفيذ كل هذه الخطوات كجذر:

1. إنشاء المستخدم والمجموعة "apigee":

   groupadd -r apigee > useradd -r -g apigee -d /opt/apigee -s /sbin/nologin -c "Apigee platform user" apigee

2. أنشِئ رابطًا رمزيًا من /opt/apigee إلى جذر التثبيت المطلوب:

   ln -Ts /srv/myInstallDir /opt/apigee

   حيث يكون /srv/myInstallDir هو الموقع المطلوب لملفات Edge.

3. غيِّر ملكية جذر التثبيت والرابط الرمزي لمستخدم "apigee":

   chown -h apigee:apigee /srv/myInstallDir /opt/apigee

Java

تحتاج إلى إصدار معتمد من Java 1.8 مثبت على كل جهاز قبل التثبيت. يتم إدراج أرقام JDK المتوافقة في البرامج المتوافقة والإصدارات المتوافقة.

وتأكَّد من أنّ JAVA_HOME يشير إلى جذر JDK للمستخدم الذي يُجري التثبيت.

SELinux

استنادًا إلى إعدادات SELinux، قد يواجه Edge مشكلات في تثبيت وبدء مكونات Edge. ويمكنك إذا لزم الأمر إيقاف SELinux أو ضبطه على الوضع المتساهِل أثناء التثبيت، ثم إعادة تفعيله بعد التثبيت. راجع تثبيت الأداة المساعدة لإعداد واجهة برمجة تطبيقات Edge لمزيد من المعلومات.

إعدادات الشبكة

ننصحك بالتحقّق من إعدادات الشبكة قبل التثبيت. ويتوقّع أداة التثبيت أن تكون جميع الأجهزة لها عناوين IP ثابتة. استخدِم الأوامر التالية للتحقق من صحة الإعداد:

• تعرض القيمة hostname اسم الجهاز.
• تعرض hostname -i عنوان IP لاسم المضيف الذي يمكن معالجته من الأجهزة الأخرى.

استنادًا إلى نوع نظام التشغيل وإصداره، قد تحتاج إلى تعديل /etc/hosts و/etc/sysconfig/network إذا لم يتم ضبط اسم المضيف بشكل صحيح. راجِع وثائق نظام التشغيل المحدّد للحصول على مزيد من المعلومات.

إذا كان الخادم يحتوي على بطاقات واجهة متعدّدة، يعرض الأمر "hostname -i" قائمة بعناوين IP مفصولة بمسافات. بشكل تلقائي، يستخدم مثبِّت Edge أول عنوان IP يتم عرضه، وقد لا يكون صحيحًا في جميع الحالات. يمكنك بدلاً من ذلك إعداد السمة التالية في ملف إعداد التثبيت:

ENABLE_DYNAMIC_HOSTIP=y

عند ضبط هذه السمة على "y"، تطلب منك أداة التثبيت اختيار عنوان IP لاستخدامه كجزء من عملية التثبيت. القيمة الافتراضية هي "n". راجِع مرجع ملف ضبط الحافة لمزيد من المعلومات.

مغلّفات TCP

يمكن أن تحظر برامج تغليف TCP الاتصال ببعض المنافذ وقد تؤثر في تثبيت OpenLDAP وPostgres وCassandra. في هذه العُقد، تحقَّق من /etc/hosts.allow و/etc/hosts.deny للتأكّد من عدم فرض أي قيود على المنافذ على منافذ OpenLDAP وPostgres وCassandra المطلوبة.

iptables

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

sudo/etc/init.d/iptables stop

على CentOS 7.x:

systemctl stop firewalld

تأكَّد من إمكانية وصول جهاز توجيه Edge إلى /etc/rc.d/init.d/functions.

تستخدم عُقد جهاز توجيه Edge وبوابة BaaS جهاز التوجيه Nginx وتتطلب إذن الوصول للقراءة إلى /etc/rc.d/init.d/functions.

إذا كانت عملية الأمان تتطلب منك ضبط الأذونات على /etc/rc.d/init.d/functions، لا تضبطها على 700 وإلا سيتعذّر تشغيل جهاز التوجيه. يمكن ضبط الأذونات على 744 للسماح بالوصول للقراءة إلى /etc/rc.d/init.d/functions.

من الفئة العمرية 31-45

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

تقوم Cassandra تلقائيًا بضبط حجم كومة الذاكرة المؤقتة بلغة Java بناءً على الذاكرة المتاحة. لمعرفة مزيد من المعلومات، يُرجى الاطّلاع على ضبط موارد Java. في حال تدهور الأداء أو استهلاك كبير للذاكرة.

بعد تثبيت Edge for Private Cloud، يمكنك التأكّد من ضبط Cassandra بشكل صحيح من خلال فحص ملف /opt/apigee/apigee-cassandra/conf/cassandra.yaml. على سبيل المثال، تأكَّد من أنّ النص البرمجي لتثبيت Edge for Private Cloud قد ضبط السمات التالية:

• cluster_name
• initial_token
• partitioner
• seeds
• listen_address
• rpc_address
• snitch

قاعدة بيانات PostgreSQL

بعد تثبيت Edge، يمكنك ضبط إعدادات قاعدة بيانات PostgreSQL التالية بناءً على حجم ذاكرة الوصول العشوائي المتاحة على نظامك:

conf_postgresql_shared_buffers = 35% of RAM      # min 128kB
conf_postgresql_effective_cache_size = 45% of RAM
conf_postgresql_work_mem = 512MB       # min 64kB

لضبط هذه القيم:

1. عدِّل ملف postgresql.properties:

   vi /opt/apigee/customer/application/postgresql.properties

   .

   إذا لم يكن الملف موجودًا، فأنشئه.

2. اضبط الخصائص المدرَجة أعلاه.
3. احفظ التعديلات.
4. أعِد تشغيل قاعدة بيانات PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

حدود النظام

احرص على ضبط حدود النظام التالية على عُقد Cassandra ومعالج الرسائل:

• في عُقد Cassandra، يمكنك ضبط حدود soft وثابتة وثابتة ومساحة العنوان (مثل) لمستخدمي التثبيت (القيمة التلقائية هي "apigee") في /etc/security/limits.d/90-apigee-edge-limits.conf كما هو موضّح أدناه:

  apigee soft memlock unlimited
  apigee hard memlock unlimited
  apigee soft nofile 32768
  apigee hard nofile 65536
  apigee soft as unlimited
  apigee hard as unlimited

• في عُقد معالج الرسائل، اضبط الحد الأقصى لعدد أدوات وصف الملفات المفتوحة على 64 ألف في /etc/security/limits.d/90-apigee-edge-limits.conf كما هو موضّح أدناه:

  apigee soft nofile 32768
  apigee hard nofile 65536

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

أداة jsvc

"jsvc" هو شرط أساسي لاستخدام نظام BaaS لواجهة برمجة التطبيقات. يتم تثبيت الإصدار 1.0.15 -dev عند تثبيت BaaS لواجهة برمجة التطبيقات.

خدمات أمان الشبكات (NSS)

خدمات أمان الشبكة (NSS) هي مجموعة من المكتبات التي تدعم تطوير تطبيقات العميل والخادم التي تم تفعيل الأمان عليها. يجب التأكّد من تثبيت الإصدار 3.19 أو الإصدارات الأحدث من NSS.

للتحقّق من الإصدار الحالي، يُرجى اتّباع الخطوات التالية:

yum info nss

لتحديث NSS:

yum update nss

للحصول على مزيد من المعلومات، يمكنك الاطّلاع على هذه المقالة من RedHat.

إيقاف بحث نظام أسماء النطاقات على IPv6 عند استخدام NSCD (برنامج خفي لذاكرة التخزين المؤقت لخدمة الأسماء)

إذا كنت قد ثبَّت وفعّلت برنامج NSCD (الخفي لذاكرة التخزين المؤقت لخدمة الأسماء)، ستُجري معالِجات الرسائل عمليتَي بحث لنظام أسماء النطاقات: أحدهما لبروتوكول IPv4 والآخر لبروتوكول IPv6. يجب إيقاف بحث نظام أسماء النطاقات على IPv6 عند استخدام NSCD.

لإيقاف بحث نظام أسماء النطاقات على IPv6:

1. تعديل /etc/nscd.conf في كل عقدة من عُقد معالج الرسائل
2. اضبط السمة التالية:

   enable-cache hosts no

إيقاف IPv6 على Google Cloud Platform لـ RedHat/CentOS 7

إذا كنت تثبّت Edge على RedHat 7 أو CentOS 7 على Google Cloud Platform، عليك إيقاف IPv6 على جميع عُقد Qpid.

راجِع مستندات RedHat أو CentOS لمعرفة إصدار نظام التشغيل الذي تستخدمه للحصول على تعليمات حول إيقاف IPv6. على سبيل المثال، يمكنك إجراء ما يلي:

1. فتح /etc/hosts في محرِّر
2. أدخِل الحرف "#" في العمود الأول من السطر التالي للتعليق عليه:

   #::1 localhost localhost.localdomain localhost6 localhost6.localdomain6

3. احفظ الملف.

AWS AMI

في حال تثبيت Edge على AWS Amazon Machine Image (AMI) لنظام التشغيل Red Hat Enterprise Linux 7.x، عليك أولاً تشغيل الأمر التالي:

yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

الأدوات

تستخدم أداة التثبيت أدوات UNIX التالية في الإصدار العادي كما هو موضّح في EL5 أو EL6.

بروتوكول ntpdate

يُوصى بمزامنة أوقات الخوادم. يمكن أن تخدم أداة ntpdate هذا الغرض إذا لم يتم إعدادها من قبل، الذي يتحقّق مما إذا كانت الخوادم متزامنة للوقت. يمكنك استخدام yum install ntp لتثبيت الأداة. وهذا مفيد على وجه الخصوص في تكرار إعدادات OpenLDAP. وتجدُر الإشارة إلى أنّك أعددت المنطقة الزمنية للخادم بالتوقيت العالمي المنسّق (UTC).

openldap 2.4

يتطلب التثبيت داخل المؤسسة الوصول إلى بروتوكول OpenLDAP 2.4. في حال كان خادمك متصلاً بالإنترنت، سيتم تنزيل البرنامج النصي لتثبيت Edge وتثبيته عبر بروتوكول OpenLDAP. إذا لم يكن الخادم متصلاً بالإنترنت، يجب التأكد من أنّ بروتوكول OpenLDAP قد تم تثبيته من قبل قبل تشغيل النص البرمجي لتثبيت Edge. في RHEL/CentOS، يمكنك تشغيل yum install openldap-clients openldap-servers لتثبيت OpenLDAP.

بالنسبة إلى عمليات التثبيت لـ 13 مضيفًا وعمليات التثبيت من 12 مضيفًا مع مركزَي بيانات، يجب طلب النسخ المماثل لخدمة OpenLDAP نظرًا لوجود عُقد متعددة تستضيف OpenLDAP.

جدران الحماية والمضيفون الافتراضيون

عادةً ما يتم تحميل مصطلح virtual بشكل زائد في مجال تكنولوجيا المعلومات، ولذلك فإنّه يحدث عند استخدام Apigee Edge مع نشر Private Cloud والمضيف الافتراضي. للتوضيح، هناك استخدامان أساسيان للمصطلح virtual:

• الأجهزة الافتراضية (VM): ليس مطلوبًا، ولكن تستخدم بعض عمليات النشر تكنولوجيا الأجهزة الافتراضية لإنشاء خوادم معزولة لمكوّنات Apigee. ويمكن أن تحتوي مضيفات الأجهزة الافتراضية، مثل المضيفين الفعليين، على واجهات شبكة وجدران حماية.
• المضيفون الافتراضيون: نقاط نهاية الويب، مشابهة لمضيف افتراضي Apache.

يمكن لجهاز التوجيه في جهاز افتراضي كشف عدة مضيفات افتراضية (طالما يختلفان عن بعضهما في الاسم المستعار الخاص بالمضيف أو في منفذ الواجهة).

وكمثال على التسمية، قد يشغّل خادم مادي واحد A جهازَين افتراضيَّين، باسم "VM1" و "VM2". لنفترض أنّ "VM1" يعرض واجهة إيثرنت افتراضية تحمل الاسم "eth0" داخل الجهاز الافتراضي، ويتم تخصيص عنوان IP له رقم 111.111.111.111 من خلال أجهزة المحاكاة الافتراضية أو خادم بروتوكول DHCP للشبكة. ثم لنفترض أنّ الجهاز VM2 يعرض واجهة إيثرنت افتراضية تُسمى أيضًا "eth0" ويتم تخصيص عنوان IP لها 111.111.111.222.

قد يكون لدينا جهاز توجيه Apigee يعمل في كل من الجهازين الافتراضيين. تعرض أجهزة التوجيه نقاط نهاية المضيف الافتراضية كما هو موضّح في هذا المثال الافتراضي:

يعرض جهاز توجيه Apigee في VM1 ثلاثة مضيفات افتراضية على واجهة eth0 (التي تحتوي على عنوان IP محدد) وapi.mycompany.com:80 وapi.mycompany.com:443 وtest.mycompany.com:80.

يعرض جهاز التوجيه في الجهاز الافتراضي VM2 api.mycompany.com:80 (الاسم والمنفذ نفسيهما اللذَين يظهران في الجهاز الافتراضي VM1).

قد يحتوي نظام تشغيل المضيف الفعلي على جدار حماية للشبكة، وفي هذه الحالة، يجب ضبط جدار الحماية هذا لتمرير حركة مرور بيانات TCP المرتبطة بالمنافذ التي يتم عرضها على الواجهات الافتراضية (111.111.111.111:{80, 443} و111.111.111.222:80). بالإضافة إلى ذلك، قد يوفّر كل نظام تشغيل افتراضي جدار حماية خاص به على واجهة ET0 الخاصة به، ويجب أن يسمح هذا الجدار الناري أيضًا بالاتصال عبر المنافذ 80 و443.

يمثل المسار الأساسي المكون الثالث في توجيه طلبات البيانات من واجهة برمجة التطبيقات إلى الخوادم الوكيلة المختلفة لواجهة برمجة التطبيقات التي ربما تكون نشرتها. يمكن لحِزم الخادم الوكيل لواجهة برمجة التطبيقات مشاركة نقطة نهاية إذا كان لها مسارات أساسية مختلفة. على سبيل المثال، يمكن تحديد مسار أساسي واحد باعتباره http://api.mycompany.com:80/ ومسارًا آخر باسم http://api.mycompany.com:80/salesdemo.

في هذه الحالة، ستحتاج إلى أداة لموازنة الحمل أو أداة لإدارة عدد الزيارات من نوع ما لتقسيم حركة الزيارات http://api.mycompany.com:80/ بين عنوانَي IP (111.111.111.111 على VM1 و111.111.111.222 على VM2). هذه الدالة خاصة بعملية التثبيت التي تجريها، ويتم ضبطها من خلال مجموعة الشبكات المحلية.

يتم تحديد المسار الأساسي عند نشر واجهة برمجة تطبيقات. من المثال أعلاه، يمكنك نشر واجهتَي برمجة تطبيقات، mycompany وtestmycompany، للمؤسسة mycompany-org من خلال المضيف الافتراضي الذي يتضمن الاسم المستعار للمضيف api.mycompany.com والمنفذ على 80. إذا لم تحدّد مسارًا أساسيًا في عملية النشر، لن يعرف الموجه أي واجهة برمجة تطبيقات يجب إرسال الطلبات الواردة إليها.

في المقابل، إذا نشرت واجهة برمجة التطبيقات testmycompany باستخدام عنوان URL الأساسي /salesdemo، سيصل المستخدمون إلى واجهة برمجة التطبيقات هذه باستخدام http://api.mycompany.com:80/salesdemo. في حال نشر واجهة برمجة التطبيقات mycompany باستخدام عنوان URL الأساسي /، سيصل المستخدمون إلى واجهة برمجة التطبيقات من خلال عنوان URL التالي: http://api.mycompany.com:80/.

متطلبات منفذ الحافة

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

توضح الصورة التالية متطلبات المنافذ لكل مكون من مكونات Edge:

ملاحظات في هذا المخطّط البياني:

• * يجب فتح منفذ 8082 على معالج الرسائل فقط للوصول إلى جهاز التوجيه عند إعداد بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة بين جهاز التوجيه ومعالج الرسائل. في حال عدم ضبط بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة بين جهاز التوجيه ومعالج الرسائل، يجب أن تكون الإعدادات التلقائية للمنفذ 8082 مفتوحة على معالج الرسائل لإدارة المكوّن، إلا أنّ جهاز التوجيه لا يطلب الوصول إليه.
• المنافذ التي يسبقها الرمز "M" هي منافذ تستخدم لإدارة المكوِّن ويجب أن تكون مفتوحة على المكوِّن ويجب أن تكون مفتوحة على المكوِّن للوصول إليها من خلال خادم الإدارة.
• تتطلب المكونات التالية الوصول إلى المنفذ 8080 على خادم الإدارة: جهاز التوجيه، ومعالج الرسائل، وواجهة المستخدم، وPostgres، وQpid.
• يجب أن يفتح "معالج الرسائل" المنفذ 4528 ليكون منفذ الإدارة الخاص به. إذا كانت لديك عدة معالجات رسائل، يجب أن تتمكن جميعها من الوصول إلى بعضها عبر المنفذ 4528 (ويشار إليه بسهم التكرار الحلقي في المخطط أعلاه للمنفذ 4528 في معالج الرسائل). وإذا كانت لديك عدة مراكز بيانات، يجب أن تتوفر إمكانية الوصول إلى المنفذ من جميع معالجات الرسائل في جميع مراكز البيانات.
• يمكنك فتح المنفذ 4527 على جهاز التوجيه للوصول إلى البيانات من خلال أي معالج رسائل، علمًا أنّه ليس مطلوبًا. بخلاف ذلك، قد تظهر لك رسائل خطأ في ملفات سجل معالج الرسائل.
• يجب أن يفتح جهاز التوجيه المنفذ 4527 ليكون منفذ الإدارة الخاص به. إذا كانت لديك عدة أجهزة توجيه، يجب أن يكون بمقدورها جميعًا الوصول إلى بعضها عبر المنفذ 4527 (يُشار إليه بسهم التكرار الحلقي في الرسم البياني أعلاه للمنفذ 4527 على جهاز التوجيه).
• تتطلّب واجهة مستخدم Edge الوصول إلى جهاز التوجيه، من خلال المنافذ التي تكشفها الخوادم الوكيلة لواجهة برمجة التطبيقات، لإتاحة استخدام الزر إرسال في أداة التتبُّع.
• يتطلب خادم الإدارة الوصول إلى منفذ JMX في عُقد Cassandra.
• يمكن تهيئة الوصول إلى منافذ JMX بحيث يتطلب اسم مستخدم/كلمة مرور. اطّلِع على كيفية المراقبة للحصول على مزيد من المعلومات.
• يمكنك اختياريًا ضبط إمكانية الوصول إلى بروتوكول أمان طبقة النقل أو طبقة المقابس الآمنة لبعض الاتصالات التي يمكنها استخدام منافذ مختلفة. راجِع بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة لمعرفة المزيد.
• في حال ضبط عقدتَين من Postgres لاستخدام النسخ المماثل في وضع الاستعداد الرئيسي، عليك فتح المنفذ 22 في كل عقدة للوصول إلى SSH. يمكنك اختياريًا فتح المنافذ على العُقد الفردية للسماح بالوصول إلى SSH.
• يمكنك ضبط خادم الإدارة وواجهة مستخدم Edge لإرسال الرسائل الإلكترونية من خلال خادم SMTP خارجي. في حال إجراء ذلك، يجب التأكد من إمكانية وصول خادم الإدارة وواجهة المستخدم إلى المنفذ اللازم على خادم SMTP. بالنسبة إلى بروتوكول SMTP الذي لا يستخدم بروتوكول أمان طبقة النقل (TLS)، يكون رقم المنفذ عادةً 25. بالنسبة إلى بروتوكول SMTP المفعَّل فيه بروتوكول أمان طبقة النقل (TLS)، غالبًا ما يكون مقداره 465، ولكن يمكنك الرجوع إلى موفّر بروتوكول نقل البريد البسيط (SMTP).

يبين الجدول أدناه المنافذ التي يجب فتحها في جدران الحماية، بواسطة مكوِّن Edge:

curl -v http://routerIP:15999/v1/servers/self/reachable

يعرض الجدول التالي المنافذ نفسها مدرَجة رقميًا مع مكوّنات المصدر والوجهة:

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

لمنع حدوث هذا الموقف، تنصح Apigee بأن يكون خادم Cassandra ومعالج الرسائل وأجهزة التوجيه في الشبكة الفرعية نفسها حتى لا يشارك جدار الحماية في نشر هذه المكونات.

في حال كان جدار الحماية بين جهاز التوجيه ومعالجات الرسائل، وتم ضبط مهلة عدم النشاط لفترة قصيرة، على سبيل المثال، ننصح بما يلي:

1. اضبط net.ipv4.tcp_keepalive_time = 1800 في إعدادات sysctl على نظام التشغيل Linux، حيث يجب أن يكون الرقم 1800 أقل من مهلة tcpئ لجدار الحماية. ويجب أن يؤدي هذا الإعداد إلى إبقاء الاتصال كما هو حتى لا يقطع الجدار الناري الاتصال.
2. في جميع معالِجات الرسائل، عدِّل /opt/apigee/customer/application/message-processor.properties لإضافة السمة التالية. إذا لم يكن الملف موجودًا، فأنشئه.

   conf_system_cassandra.maxconnecttimeinmillis=-1

3. أعِد تشغيل معالج الرسائل:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

4. على جميع أجهزة التوجيه، عدِّل /opt/apigee/customer/application/router.properties لإضافة السمة التالية. إذا لم يكن الملف موجودًا، فأنشئه.

   conf_system_cassandra.maxconnecttimeinmillis=-1

5. عليك إعادة تشغيل جهاز التوجيه:

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

في حال تثبيت الإعدادات الـ 12 المجمّعة للمضيفين باستخدام مركزَي بيانات، تأكّد من إمكانية اتصال العُقد في "مركزَي البيانات" عبر المنافذ الموضّحة أدناه:

متطلبات منفذ BaaS لواجهة برمجة التطبيقات

في حال اختيار تثبيت نظام BaaS لواجهة برمجة التطبيقات، يمكنك إضافة مكوّنَي BaaS Stack وواجهة برمجة التطبيقات BaaS المدخل إلى واجهة برمجة التطبيقات. تستخدم هذه المكوّنات المنافذ الموضحة في الشكل أدناه:

ملاحظات في هذا المخطّط البياني:

• لا ترسل بوابة BaaS الخاصة بواجهة برمجة التطبيقات طلبات مباشرةً إلى عقدة BaaS Stack. عندما يسجل مطوّر البرامج الدخول إلى البوابة، يتم تنزيل تطبيق البوابة إلى المتصفّح. يُجري تطبيق البوابة، الذي يعمل في المتصفح، طلبات إلى عُقد BaaS Stack.
• في عملية تثبيت إنتاج BaaS لواجهة برمجة التطبيقات، يتم استخدام أداة موازنة الحمل بين عقدة بوابة BaaS الخاصة بواجهة برمجة التطبيقات وعُقد BaaS Stack لواجهة برمجة التطبيقات. عند إعداد البوابة وعند إجراء طلبات بيانات من BaaS API، عليك تحديد عنوان IP أو اسم نظام أسماء النطاقات في جهاز موازنة الحمل، وليس في عُقد حزمة Stack.
• يجب أن تفتح جميع عُقد حزمة Stack المنفذ 2551 للوصول إليها من جميع عُقد Stack الأخرى (المُشار إليها بسهم التكرار الحلقي في الرسم البياني أعلاه للمنفذ 2551 على عُقد Stack). إذا كانت لديك عدة "مراكز بيانات"، يجب أن تتوفّر إمكانية الوصول إلى المنفذ من جميع عُقد حزمة Stack في جميع "مراكز البيانات".
• يجب إعداد جميع عُقد Baas Stack لإرسال الرسائل الإلكترونية من خلال خادم SMTP خارجي. بالنسبة إلى بروتوكول SMTP الذي لا يستخدم بروتوكول أمان طبقة النقل (TLS)، يكون رقم المنفذ عادةً 25. بالنسبة إلى بروتوكول SMTP الذي تم تفعيل بروتوكول أمان طبقة النقل (TLS)، غالبًا ما يكون فيه 465، ولكن راجِع موفّر بروتوكول نقل البريد البسيط (SMTP).
• يمكن تخصيص عُقد Cassandra لواجهة برمجة التطبيقات BaaS، أو يمكن مشاركتها مع Edge.

يعرض الجدول أدناه المنافذ التلقائية التي يجب فتحها في جدران الحماية حسب المكوِّن:

الترخيص

يتطلب كل تثبيت Edge ملف ترخيص فريد يمكنك الحصول عليه من Apigee. وعليك توفير المسار إلى ملف الترخيص عند تثبيت خادم الإدارة، على سبيل المثال /tmp/ترخيص.txt.

ينسخ أداة التثبيت ملف الترخيص إلى /opt/apigee/customer/conf/license.txt.

إذا كان ملف الترخيص صالحًا، يتحقّق خادم الإدارة من عدد انتهاء صلاحية عدد معالجات الرسائل (MP) المسموح به وانتهاء الصلاحية. إذا انتهت صلاحية أي من إعدادات الترخيص، يمكنك العثور على السجلات في الموقع التالي: /opt/apigee/var/log/edge-management-server/logs. في هذه الحالة، يمكنك التواصل مع فريق دعم Apigee Edge للحصول على تفاصيل نقل البيانات.

في حال لم يكن لديك ترخيص، يُرجى التواصل مع فريق مبيعات Apigee.