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

Edge for Private Cloud الإصدار 4.18.01

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

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

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

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

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

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

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

إنشاء مستخدم Apigee

ينشئ إجراء التثبيت مستخدمًا لنظام Unix باسم "apigee". يملك المستخدم "apigee" أدلة Edge وملفاته، وكذلك عمليات 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 1.8 على كل جهاز قبل التثبيت. يتم إدراج حِزم تطوير Java المتوافقة في البرامج والإصدارات المتوافقة.

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

SELinux

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

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

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

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

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

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

ENABLE_DYNAMIC_HOSTIP=y

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

TCP Wrappers

يمكن أن تحظر TCP Wrappers الاتصال ببعض المنافذ، ويمكن أن تؤثّر في عملية تثبيت 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 Router وBaaS Portal برنامج توجيه Nginx وتتطلّب إذن الوصول للقراءة إلى /etc/rc.d/init.d/functions.

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

Cassandra

يجب ربط جميع عُقد Cassandra بحلقة. يخزّن Cassandra نُسخًا طبق الأصل من البيانات على عُقد متعددة لضمان الموثوقية وتجاوز الأخطاء. تحدّد استراتيجية النسخ المتماثل لكل مساحة مفاتيح Edge عقد Cassandra التي يتم وضع النسخ المتماثلة فيها. لمزيد من المعلومات، يُرجى الاطّلاع على لمحة عن عامل النسخ ومستوى الاتساق في 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 وMessage Processor:

• في عُقد Cassandra، اضبط حدود memlock وnofile وas (مساحة العنوان) المرنة والصارمة لمستخدم التثبيت (القيمة التلقائية هي "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

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

  apigee soft nofile 32768
  apigee hard nofile 65536

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

jsvc

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

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

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

للاطّلاع على الإصدار الحالي، اتّبِع الخطوات التالية:

yum info nss

لتعديل NSS، اتّبِع الخطوات التالية:

yum update nss

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

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

إذا كنت قد ثبّت NSCD (برنامج Name Service Cache Daemon) وفعّلته، ستجري "معالجات الرسائل" عمليتَي بحث في نظام أسماء النطاقات (DNS): إحداهما للإصدار الرابع من بروتوكول الإنترنت (IPv4) والأخرى للإصدار السادس من بروتوكول الإنترنت (IPv6). يجب إيقاف البحث عن نظام أسماء النطاقات (DNS) على IPv6 عند استخدام NSCD.

لإيقاف بحث نظام أسماء النطاقات على الإصدار السادس من بروتوكول الإنترنت (IPv6)، اتّبِع الخطوات التالية:

1. في كل عقدة Message Processor، عدِّل /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 على صورة جهاز Amazon (AMI) من AWS لنظام التشغيل 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. يُرجى العِلم أنّه عليك ضبط المنطقة الزمنية للخادم على التوقيت العالمي المتفق عليه.

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". لنفترض أنّ "الجهاز الظاهري 1" يعرض واجهة إيثرنت افتراضية، ويتم تسميتها "eth0" داخل الجهاز الظاهري، ويتم تعيين عنوان IP 111.111.111.111 لها من خلال آليات المحاكاة الافتراضية أو خادم بروتوكول الإعداد الديناميكي للمضيف (DHCP) على الشبكة. ولنفترض بعد ذلك أنّ "الجهاز الظاهري 2" يعرض واجهة إيثرنت افتراضية تحمل الاسم نفسه "eth0" ويتم تعيين عنوان IP 111.111.111.222 لها.

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

يعرض موجّه Apigee في الجهاز الظاهري 1 ثلاثة مضيفين ظاهريين على واجهة 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). بالإضافة إلى ذلك، قد يوفّر نظام تشغيل كل جهاز افتراضي جدار الحماية الخاص به على واجهة eth0، ويجب أن يسمح هذا الجدار أيضًا بمرور زيارات المنافذ 80 و443 للاتصال.

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

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

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

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

متطلبات منفذ Edge

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

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

ملاحظات حول هذا الرسم البياني:

• * يجب فتح المنفذ 8082 على "معالج الرسائل" فقط ليتمكّن "الموجّه" من الوصول إليه عند ضبط بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL) بين "الموجّه" و"معالج الرسائل". في حال عدم ضبط بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) بين جهاز التوجيه ومعالج الرسائل، يجب أن يظل الإعداد التلقائي، أي المنفذ 8082، مفتوحًا على معالج الرسائل لإدارة المكوّن، ولكن لا يتطلّب جهاز التوجيه الوصول إليه.
• المنافذ التي تبدأ بالحرف "M" هي منافذ تُستخدَم لإدارة المكوّن ويجب أن تكون مفتوحة على المكوّن ليتمكّن "خادم الإدارة" من الوصول إليها.
• تتطلّب المكوّنات التالية إذن الوصول إلى المنفذ 8080 على "خادم الإدارة": جهاز التوجيه و"معالج الرسائل" وواجهة المستخدم وPostgres وQpid.
• يجب أن يفتح "معالج الرسائل" المنفذ 4528 كمنفذ إدارة. إذا كان لديك عدة معالِجات رسائل، يجب أن يكون بإمكانها جميعًا الوصول إلى بعضها البعض عبر المنفذ 4528 (يشار إلى ذلك بالسهم الحلقي في الرسم البياني أعلاه للمنفذ 4528 على معالج الرسائل). إذا كان لديك مراكز بيانات متعددة، يجب أن يكون المنفذ متاحًا من جميع معالجات الرسائل في جميع مراكز البيانات.
• على الرغم من أنّ ذلك ليس مطلوبًا، يمكنك فتح المنفذ 4527 على جهاز التوجيه ليتمكّن أي معالج رسائل من الوصول إليه. بخلاف ذلك، قد تظهر لك رسائل خطأ في ملفات سجلّ "معالج الرسائل".
• يجب أن يفتح جهاز التوجيه المنفذ 4527 كمنفذ إدارة. إذا كان لديك أجهزة توجيه متعددة، يجب أن يكون بإمكانها جميعًا الوصول إلى بعضها البعض عبر المنفذ 4527 (يُشار إلى ذلك بالسهم الحلقي في الرسم التوضيحي أعلاه للمنفذ 4527 على جهاز التوجيه).
• تتطلّب واجهة مستخدم Edge الوصول إلى جهاز التوجيه على المنافذ التي تعرضها خوادم وكيل واجهة برمجة التطبيقات، وذلك لتفعيل الزر إرسال في أداة التتبُّع.
• يتطلّب خادم الإدارة إذن الوصول إلى منفذ JMX على عُقد Cassandra.
• يمكن ضبط إذن الوصول إلى منافذ JMX ليتطلّب اسم مستخدم وكلمة مرور. لمزيد من المعلومات، اطّلِع على مقالة كيفية المراقبة.
• يمكنك اختياريًا ضبط إذن الوصول إلى بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة (SSL) لبعض الاتصالات التي يمكنها استخدام منافذ مختلفة. يمكنك الاطّلاع على بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL) لمزيد من المعلومات.
• في حال إعداد عقدتَي 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 ومعالج الرسائل وأجهزة التوجيه في الشبكة الفرعية نفسها حتى لا يكون هناك جدار حماية متضمّن في عملية نشر هذه المكوّنات.

إذا كان هناك جدار حماية بين جهاز التوجيه ومعالجات الرسائل، وتم ضبط مهلة tcp غير نشطة، ننصحك بما يلي:

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 مضيفًا مع مركزَي بيانات، تأكَّد من أنّ العُقد في مركزَي البيانات يمكنها التواصل عبر المنافذ الموضّحة أدناه:

متطلبات منفذ API BaaS

إذا اخترت تثبيت API BaaS، عليك إضافة مكوّنات API BaaS Stack وAPI BaaS Portal. تستخدم هذه المكوّنات المنافذ الموضّحة في الشكل أدناه:

ملاحظات حول هذا الرسم البياني:

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

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

الترخيص

يتطلّب كل تثبيت لـ Edge ملف ترخيص فريدًا تحصل عليه من Apigee. يجب تقديم مسار ملف الترخيص عند تثبيت خادم الإدارة، مثل /tmp/license.txt.

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

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

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