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

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

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

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

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

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

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

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

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

Java

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

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

SELinux

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

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

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

دليل التثبيت

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

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

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

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

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

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

   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 تركيب "كاساندرا". وفي هذه العُقد، تحقَّق من /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 التي لها متطلبات خاصة من عمليات الحافة:

كاساندرا

يجب توصيل جميع عُقد 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، عيّن حدودًا ثابتة وصعبة لفتح القفل، ومساحة العنوان (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

  لمزيد من المعلومات، يُرجى مراجعة إعدادات الإنتاج المقترَحة في وثائق Apache Cassandra.

• في عُقد معالج الرسائل، اضبط الحد الأقصى لعدد أدوات وصف الملفات المفتوحة على 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) هي مجموعة من المكتبات التي تدعم تطوير تطبيقات العميل والخادم المزودين بالأمان. يجب التأكّد من تثبيت NSS. أو الإصدار 3.19 أو إصدار أحدث.

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

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 منصة 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 (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

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

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

يتطلب التثبيت داخل المؤسسة الإصدار OpenLDAP 2.4. إذا كان الخادم متصلاً بالإنترنت، عندئذٍ يتم تنزيل النص البرمجي لتثبيت Edge وتثبيته على 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. في حال عدم الإفصاح عن Basepath في عملية النشر، لن يعرف الموجه واجهة برمجة التطبيقات التي يجب إرسال الطلبات الواردة بها إليه.

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

الترخيص

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

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

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

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