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

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

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

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

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

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

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

متطلبات معدل نقل البيانات لشبكة Cassandra

تستخدم Cassandra بروتوكول Gossip لتبادل المعلومات مع العُقد الأخرى حول بنية الشبكة. يؤدي استخدام Gossip، إلى جانب الطبيعة الموزّعة لـ Cassandra التي تتضمّن التواصل مع عُقد متعددة لعمليات القراءة والكتابة، إلى نقل كبير للبيانات عبر الشبكة.

تتطلّب Cassandra حدًا أدنى لمعدل نقل البيانات على الشبكة يبلغ 1 غيغابت في الثانية لكل عقدة. بالنسبة إلى عمليات التثبيت في بيئة الإنتاج، ننصح باستخدام نطاق ترددي أعلى.

يجب أن يكون الحد الأقصى لوقت الاستجابة أو النسبة المئوية الـ 99 لوقت الاستجابة في Cassandra أقل من 100 ملي ثانية.

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

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

المتطلبات الأساسية: تفعيل مستودع EPEL

قبل المتابعة في عملية التثبيت، تأكَّد من تفعيل مستودع EPEL (حِزم إضافية لنظام التشغيل Enterprise Linux). استخدِم الأوامر التالية استنادًا إلى إصدار نظام التشغيل:

• في Red Hat أو CentOS أو Oracle 8.X:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

  sudo rpm -ivh epel-release-latest-8.noarch.rpm

• في Red Hat أو CentOS أو Oracle 9.X:

  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

  sudo rpm -ivh epel-release-latest-9.noarch.rpm

جافا

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

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

SELinux

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

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

تنشئ عملية التثبيت مستخدمًا لنظام Unix باسم "apigee". يملك المستخدم "apigee" أدلة Edge وملفاته، كما يملك عمليات Edge. وهذا يعني أنّ مكوّنات Edge تعمل بصفتها المستخدم "apigee". إذا لزم الأمر، يمكنك تشغيل المكوّنات كمستخدم مختلف.

دليل التثبيت

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

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

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

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

لإنشاء الرابط الرمزي، اتّبِع الخطوات التالية قبل تنزيل الملف bootstrap_4.53.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

إعداد الشبكة

تنصح Apigee بالتحقّق من إعدادات الشبكة قبل التثبيت. يتوقّع برنامج التثبيت أن يكون لجميع الأجهزة عناوين 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

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

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

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

إعدادات اللغة في Rocky 9.X

إذا كنت تستخدم Rocky 9.X، تأكَّد من ضبط نظامك على LANG=en_US.utf8 في إعدادات اللغة على مستوى النظام. لضبط هذا الإعداد، شغِّل الأوامر التالية:

dnf -y -q install langpacks-en
localectl set-locale LANG=en_US.utf8
reboot

حدود النظام

تأكَّد من ضبط حدود النظام التالية على عُقد 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
  apigee soft nproc 32768
  apigee hard nproc 65536

• في عقد Message Processor، اضبط الحد الأقصى لعدد واصفات الملفات المفتوحة على 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 لتحديد المشاكل وحلّها بشكل أكبر.

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

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

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

yum info nss

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

yum update nss

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

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

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

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

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

   enable-cache hosts no

إيقاف بروتوكول IPv6 على نظام التشغيل RHEL 8 والإصدارات الأحدث

إذا كنت تثبّت Edge على الإصدار 8 من RHEL أو إصدارات أحدث على Google Cloud Platform، عليك إيقاف IPv6 على جميع عُقد Qpid.

للحصول على تعليمات حول إيقاف IPv6، يُرجى الرجوع إلى المستندات المقدَّمة من مورّد نظام التشغيل. على سبيل المثال، يمكنك العثور على معلومات ذات صلة في مستندات Red Hat Enterprise Linux.

المتطلبات الأساسية لنظام التشغيل Amazon Linux

قبل إجراء عملية تثبيت جديدة على Amazon Linux 2023.7/2023.8/2023.9 أو الترقية من الإصدار 4.52.02 إلى الإصدار 4.53.01 (على Amazon Linux 2023.7/2023.8/2023.9)، عدِّل الملف /etc/yum.repos.d/amazonlinux.repo. يجب أن يتضمّن القسم الذي يحتوي على [amazonlinux] ما يلي لضمان تنزيل الحِزم من apigee-thirdparty وليس من Amazon:exclude=postgresql17،luajit*.

الأدوات

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

مزامنة الوقت

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

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

يتم عادةً استخدام مصطلح 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 في الجهاز الظاهري 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 ملف ترخيص فريدًا تحصل عليه من Apigee. يجب تقديم مسار ملف الترخيص عند تثبيت خادم الإدارة، على سبيل المثال /tmp/license.txt.

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

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

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