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

Edge for Private Cloud‏ 4.16.05

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

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

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

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

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

ملاحظة:

• إذا لم يكن نظام الملفات الجذر كبيرًا بما يكفي للتثبيت، يُنصح بمحاولة وضع البيانات على قرص أكبر.
• إذا تم تثبيت إصدار قديم من Apigee Edge for Private Cloud على الجهاز، تأكَّد من حذف المجلد /tmp/java قبل إجراء عملية تثبيت جديدة.
• يحتاج المجلد المؤقت على مستوى النظام /tmp إلى أذونات تنفيذ من أجل بدء Cassandra.
• إذا تم إنشاء حساب المستخدم "apigee" قبل التثبيت، تأكَّد من أنّ ‎"/home/apigee" متوفّر كدليل رئيسي وأنّه مملوك لـ ‎"apigee:apigee".

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

تم اختبار تعليمات التثبيت هذه وملفات التثبيت المقدَّمة على أنظمة التشغيل والبرامج التابعة لجهات خارجية المدرَجة هنا: https://apigee.com/docs/api-services/reference/supported-software.

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

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

دليل التثبيت

تُسجِّل أداة التثبيت جميع الملفات تلقائيًا في الدليل /opt/apigee. لا يمكنك تغيير موقع هذا الدليل.

في التعليمات الواردة في هذا الدليل، تتم الإشارة إلى دليل التثبيت باسم /<inst_root>/apigee، حيث تكون /<inst_root> هي /opt تلقائيًا.

Java

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

https://apigee.com/docs/api-services/reference/supported-software

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

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

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

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

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

كاساندرا

يجب ربط جميع عقد Cassandra بحلقة.

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

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

• cluster_name
• initial_token
• أداة تقسيم
• البذور
• 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 /<inst_root>/apigee/customer/application/postgresql.properties
   
   إذا لم يكن الملف متوفّرًا، أنشئه.
2. اضبط السمات الواردة أعلاه.
3. احفظ التعديلات.
4. أعِد تشغيل قاعدة بيانات PostgreSQL:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-postgresql rename

jsvc

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

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

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

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

> yum info nss

لتحديث NSS:

> yum update nss

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

AWS AMI

إذا كنت بصدد تثبيت Edge على صورة Amazon Machine Image (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.

ملاحظة:

• يمكن العثور على الملف التنفيذي لأداة useradd في ‎/usr/sbin، وللأداة chkconfig في ‎/sbin.
• باستخدام إذن sudo، يمكنك الوصول إلى بيئة المستخدم المتصل، على سبيل المثال، يمكنك عادةً استخدام الأمر "sudo <command>" أو "sudo PATH=$PATH:/usr/sbin:/sbin <command>".
• تأكَّد من تثبيت أداة "التصحيح" قبل تثبيت حزمة الخدمة (التصحيح).

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.

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

غالبًا ما يتم استخدام المصطلح "افتراضي" بشكل زائد في مجال تكنولوجيا المعلومات، وينطبق ذلك أيضًا على عمليات نشر Apigee Edge for Private Cloud والخوادم الافتراضية. للتوضيح، هناك استخدامان أساسيان لمصطلح "افتراضي":

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

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

على سبيل المثال، قد يشغّل الخادم المادي "أ" جهازَي VM، باسمَي "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.

يعرِض جهاز التوجيه في "الجهاز الافتراضي 2" api.mycompany.com:80 (الاسم والمنفذ نفسهما المعروضان في "الجهاز الافتراضي 1").

قد يتضمّن نظام التشغيل الخاص بالمضيف المادي جدار حماية للشبكة. إذا كان الأمر كذلك، يجب ضبط جدار الحماية هذا للسماح بمرور زيارات بروتوكول 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

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

توضح الصورة التالية متطلبات المنافذ لكل مكون من مكونات 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)/طبقة المقابس الآمنة للاطّلاع علىمزيد من المعلومات.
• في حال ضبط عقدتَي 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.

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

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

1. اضبط net.ipv4.tcp_keepalive_time = 1800 في إعدادات sysctl على نظام التشغيل Linux، حيث من المفترض أن يكون القيمة 1800 أقل من مهلة tcp غير النشطة لجدار الحماية. ومن المفترض أن يبقي هذا الإعداد الاتصال في حالة ثابتة حتى لا يقطع جدار الحماية الاتصال.
2. في جميع معالجات الرسائل، عدِّل /<inst_root>/apigee/customer/application/message-processor.properties لإضافة السمة التالية. إذا لم يكن الملف متوفّرًا، أنشئه.
   conf_system_casssandra.maxconnecttimeinmillis=-1
3. أعِد تشغيل Message Processor:
   > /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
4. في جميع أجهزة التوجيه، عدِّل /<inst_root>/apigee/customer/application/router.properties لإضافة السمة التالية. إذا لم يكن الملف متوفّرًا، أنشِئه.
   conf_system_casssandra.maxconnecttimeinmillis=-1
5. إعادة تشغيل جهاز التوجيه:
   > ‎/opt/apigee/apigee-service/bin/apigee-service edge-router restart

في حال تثبيت الإعداد المجمّع الذي يتضمّن 12 مضيفًا مع مركزَي بيانات، تأكَّد من أنّه يمكن للوِحدَين في مركزَي البيانات التواصل عبر المنافذ الموضّحة أدناه:

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

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

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

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

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

الترخيص

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

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

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