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

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

يجب أن تستوفي الحد الأدنى من متطلبات الأجهزة التالية لبنية أساسية متاحة بشكل كبير في بيئة إنتاج.

يقدم لك الفيديو التالي إرشادات عالية المستوى بشأن المقاسات لعملية التثبيت:

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

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

مكوِّن التثبيت ذاكرة الوصول العشوائي (RAM) وحدة معالجة مركزية (CPU) الحد الأدنى للقرص الثابت
كاساندرا 16 غيغابايت ثماني النواة مساحة تخزين محلية تبلغ 250 غيغابايت مع محرك أقراص ذي حالة صلبة (SSD) يدعم 2000 IOPS
معالِج الرسائل/جهاز التوجيه على الجهاز نفسه 16 غيغابايت ثماني النواة 100 غيغابايت
معالج الرسائل (مستقل) 16 غيغابايت ثماني النواة 100 غيغابايت
جهاز توجيه (مستقل) 16 غيغابايت ثماني النواة 100 غيغابايت
Analytics - Postgres/Qpid على الخادم نفسه 16 غيغابايت* ثماني النواة* مساحة تخزين على الشبكة تتراوح بين 500 غيغابايت و1 تيرابايت*****، ويُفضَّل أن تُستخدم مع الواجهة الخلفية لمحرك الأقراص ذي الحالة الصلبة (SSD) التي تتيح إجراء 1,000 عملية IOPS أو أكثر*
إحصاءات - خبير Postgres أو وضع الاستعداد (مستقل) 16 غيغابايت* ثماني النواة* مساحة تخزين على الشبكة تتراوح بين 500 غيغابايت و1 تيرابايت*****، ويُفضَّل أن تُستخدم مع الواجهة الخلفية لمحرك الأقراص ذي الحالة الصلبة (SSD) التي تتيح إجراء 1,000 عملية IOPS أو أكثر*
"إحصاءات Google" - Qpid مستقل 8 غيغابايت رباعي النواة مساحة تخزين محلية تتراوح بين 30 و50 غيغابايت باستخدام محرك أقراص ذي الحالة الصلبة

حجم قائمة انتظار Qpid التلقائي هو 1 غيغابايت، ويمكن زيادته إلى 2 غيغابايت. إذا كنت بحاجة إلى سعة أكبر، أضِف عُقد Qpid إضافية.
خادم OpenLDAP/واجهة المستخدم/الإدارة 8 غيغابايت رباعي النواة 60 غيغابايت
خادم إدارة المستخدم/واجهة المستخدم 4 غيغابايت ثنائي النواة 60 غيغابايت
OpenLDAP (مستقل) 4 غيغابايت ثنائي النواة 60 غيغابايت

* ضبط متطلبات نظام Postgres استنادًا إلى سرعة معالجة البيانات:

  • أقل من 250 وحدة TPS: يمكن استخدام وحدة تخزين رباعية النواة بسعة 8 غيغابايت مع مساحة تخزين الشبكة المُدارة*** التي تتيح استخدام 1, 000 عملية IOPS أو أكثر
  • أكثر من 250 وحدة TPS: مساحة تخزين الشبكة المُدارة ثماني النواة تبلغ 16 غيغابايت*** تتيح 1000 عملية IOPS أو أكثر
  • أكثر من 1, 000 TPS: مساحة تخزين شبكة مُدارة بسعة 16 غيغابايت، ثماني النواة *** تتوافق مع 2, 000 عملية IOPS أو أكثر
  • أكثر من 2000 وحدة TPS: مساحة تخزين شبكة مُدارة بسعة 32 غيغابايت، 16 نواة، *** تتوافق مع 2000 عملية IOPS أو أكثر
  • أكثر من 4, 000 وحدة TPS: مساحة تخزين شبكة مُدارة بسعة 64 غيغابايت، 32 نواة، *** تتوافق مع 4, 000 عملية IOPS أو أكثر

** تستند قيمة القرص الثابت في Postgres إلى الإحصاءات غير الجاهزة التي تم الحصول عليها من خلال Edge. وفي حال إضافة قيم مخصّصة إلى بيانات الإحصاءات، يجب زيادة هذه القيم وفقًا لذلك. استخدِم الصيغة التالية لتقدير مساحة التخزين المطلوبة:

bytes of storage needed =

  (# bytes of analytics data/request) *

  (requests/second) *

  (seconds/hour) *

  (hours of peak usage/day) *

  (days/month) *

  (months of data retention)

مثلاً:

(2K bytes) * (100 req/sec) * (3600 secs/hr) * (18 peak hours/day) * (30 days/month) * (3 months retention)

= 1,194,393,600,000 bytes or 1194.4 GB of storage needed

*** يُنصَح بتفعيل تخزين الشبكة لقاعدة بيانات Postgresql للأسباب التالية:

  • تتيح هذه الميزة زيادة حجم مساحة التخزين بشكل ديناميكي إذا لزم الأمر.
  • يمكن ضبط عمليات IOPS للشبكة فورًا في معظم الأنظمة الفرعية للبيئة/التخزين/الشبكة في الوقت الحالي.
  • يمكن تفعيل لقطات مستوى التخزين كجزء من حلول الاحتفاظ بنسخة احتياطية والاسترداد.

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

المكوِّن مع تحقيق الربح ذاكرة الوصول العشوائي (RAM) وحدة معالجة مركزية (CPU) قرص صلب
خادم الإدارة (مع خدمات تحقيق الربح) 8 غيغابايت رباعي النواة 60 غيغابايت
Analytics - Postgres/Qpid على الخادم نفسه 16 غيغابايت ثماني النواة من 500 غيغابايت إلى 1 تيرابايت من مساحة التخزين على الشبكة، ويُفضَّل أن تكون متوفرة على محرك الأقراص ذي الحالة الصلبة (SSD)، والتي تتيح استخدام 1000 IOPS أو أكثر، أو استخدِم القاعدة الواردة في الجدول أعلاه.
إحصاءات - Postgres رئيسي أو مستقل 16 غيغابايت ثماني النواة من 500 غيغابايت إلى 1 تيرابايت من مساحة التخزين على الشبكة، ويُفضَّل أن تكون متوفرة على محرك الأقراص ذي الحالة الصلبة (SSD)، والتي تتيح استخدام 1000 IOPS أو أكثر، أو استخدِم القاعدة الواردة في الجدول أعلاه.
"إحصاءات Google" - Qpid مستقل 8 غيغابايت رباعي النواة مساحة تخزين محلية تتراوح بين 40 و500 غيغابايت عند استخدام محرك أقراص ذي حالة صلبة أو محرك أقراص ثابتة سريع

بالنسبة إلى عمليات التثبيت التي تزيد عن 250 وحدة في الثانية، ننصح باستخدام محرك أقراص ثابتة مع مساحة تخزين محلية تتيح 1, 000 عملية IOPS.

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

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

Java

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

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

SELinux

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

إنشاء مستخدم "apigee"

يؤدي إجراء التثبيت إلى إنشاء مستخدم نظام Unix باسم "apigee". وهذه الأدلة وملفات Edge مملوكة من قِبل "apigee"، كما هي الحال مع عمليات Edge. وهذا يعني أنّ مكونات Edge تعمل كمستخدم "واجهة برمجة تطبيقات". إذا لزم الأمر، يمكنك تشغيل المكونات كمستخدم مختلف.

دليل التثبيت

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

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

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

لإنشاء الرابط الرمزي، نفذ هذه الخطوات قبل تنزيل ملف Bootstrap_4.52.02.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

إعداد الشبكة

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

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

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

إذا كان الخادم يتضمّن عدة بطاقات واجهة، سيعرض الأمر "اسم المضيف -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

على الإصدار 7.x من نظام التشغيل CentOS:

systemctl stop firewalld

الوصول إلى الدليل

يسرد الجدول التالي الأدلة في عُقد Edge التي لها متطلبات خاصة من عمليات Edge:

الخدمة الدليل الوصف
جهاز التوجيه /etc/rc.d/init.d/functions

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

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

يمكنك ضبط الأذونات على 744 للسماح بحق الوصول للقراءة إلى /etc/rc.d/init.d/functions.
حارس حديقة حيوان /dev/random تتطلّب مكتبة برامج Zookeeper إذنًا بقراءة أداة إنشاء الأرقام العشوائية /dev/random. إذا تم حظر /dev/random عند القراءة، قد يتعذّر بدء تشغيل خدمة Zookeeper.

كاساندرا

يجب توصيل جميع عُقد Cassandra بحلقة. تخزِّن "كاساندرا" النُسخ المتماثلة للبيانات على عدة عُقد لضمان الموثوقية وتقبُّل الأخطاء. تحدِّد استراتيجية النسخ المتماثل لكل مساحة مفاتيح في Edge عُقد 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، اضبط حدودًا للذاكرة النسائية والثابتة و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
apigee soft nproc 32768
apigee hard nproc 65536
  • في عُقد معالج الرسائل، اضبط الحد الأقصى لعدد أدوات وصف الملفات المفتوحة على 64 ألفًا في /etc/security/limits.d/90-apigee-edge-limits.conf كما هو موضّح أدناه: 
    apigee soft nofile 32768
apigee hard nofile 65536

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

  • إذا ظهر لك في أي وقت الخطأ التالي في جهاز التوجيه أو معالج الرسائل system.log، قد يتم ضبط حدود واصف الملف على قيمة منخفضة جدًا:

    "java.io.IOException: Too many open files"

    يمكنك التحقّق من الحدود القصوى لعدد المستخدمين عن طريق تنفيذ ما يلي:

    # su - apigee
$ ulimit -n
100000

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

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

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

للتحقق من الإصدار الحالي:

yum info nss

لتحديث NSS:

yum update nss

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

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

في حال تثبيت البرنامج الخفي لذاكرة التخزين المؤقت لخدمة الاسم وتفعيله، تُجري معالِجات الرسائل عمليتَي بحث لنظام أسماء النطاقات: أحدهما لبروتوكول 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.

awk

expr

libxlsx

دورة في الدقيقة

unzip

basename

grep

lua-socket

rpm2cpio

إضافة مستخدم

تحطيم

 hostname

ls

sed

wc

bc

id

net-tools

sudo

wget

curl

ليبايو

Perl (من Procps)

القطران

xerces-c
سايروس ساسل libdb4 pgrep (من Procps) tr لذيذ

التاريخ

 libdb-cxx

ps

uuid

أمر chkconfig
dirname أفعال ليبيب pwd uname  
echo ليبرادماكم python    

أمر ntpdate

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

الإصدار 2.4 من بروتوكول Openldap

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

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

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

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

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

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

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