نظرة عامة على تثبيت Edge

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

عملية التثبيت

تثبيت Edge على عقدة هو عملية متعددة الخطوات:

1. أوقِف SELinux على العقدة أو اضبطه على الوضع المرخّص. اطّلِع على تثبيت أداة إعداد apigee في Edge للحصول على المزيد من المعلومات.
2. حدِّد ما إذا كنت تريد تفعيل مصادقة Cassandra.
3. حدد ما إذا كنت تريد إعداد النسخ المتماثل الرئيسي في وضع الاستعداد لـ Postgres.
4. اختَر إعدادات Edge من قائمة التصاميم المقترَحة. على سبيل المثال، يمكنك تثبيت Edge على عقدة واحدة للاختبار، أو على 13 عقدة للإنتاج. اطّلِع على التصاميم الهندسية للتثبيت للحصول على مزيد من المعلومات.
5. على كل عقدة في البنية المحدّدة، ثبِّت أداة Edge apigee-setup:
   • نزِّل ملف Edge bootstrap_4.50.00.sh إلى /tmp/bootstrap_4.50.00.sh.
   • ثبِّت أداة apigee-service في Edge والتبعيات.
   • ثبِّت أداة apigee-setup في Edge والتبعيات.

     راجِع تثبيت أداة Edge apigee-setup للحصول على مزيد من المعلومات.

6. استخدِم الأداة apigee-setup لتثبيت مكوّن Edge واحد أو أكثر على كل عقدة استنادًا إلى البنية المحدّدة.

   اطلِع على تثبيت مكونات Edge على عقدة.

7. في عقدة "خادم الإدارة"، استخدِم الأداة apigee-setup لتثبيت apigee-provision، وهي الأداتان اللتان تستخدمهما لإنشاء مؤسسات Edge وإدارتها.

   اطّلِع على إعداد مؤسسة لمعرفة المزيد.

8. أعِد تشغيل مكوِّن واجهة المستخدم الكلاسيكية على كل عقدة بعد اكتمال التثبيت، كما يبيِّن المثال التالي:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. (موصى به) بعد إكمال عملية التثبيت الأولية، تقترح Apigee تثبيت واجهة مستخدم Edge الجديدة (التي يكون اسم مكوِّنها edge-management-ui)، وهي واجهة مستخدم محسَّنة لمطوّري ومشرفي Apigee Edge for Private Cloud.

   لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت واجهة مستخدِم Edge الجديدة.

بعد اكتمال التثبيت، اطّلِع على هذه القائمة التي تتضمّن الإجراءات الشائعة بعد التثبيت.

مَن يمكنه إجراء عملية التثبيت

يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من العائدات لكل ألف ظهور والتبعيات. ل تثبيت حِزم RPM في Edge وإلغاء تثبيتها وتحديثها، يجب أن يُنفِّذ المستخدم الجذر أو مستخدم لديه إذن وصول sudo كامل الأوامر. بالنسبة إلى الوصول الكامل إلى sudo، يعني ذلك أنّ لدى المستخدم إذن الوصول إلى sudo لتنفيذ العمليات نفسها التي ينفّذها المستخدم الجذر.

يجب أن يكون أي مستخدم يريد تنفيذ الأوامر أو النصوص البرمجية التالية إما مستخدمًا لديه إذن الوصول الكامل إلى sudo أو مستخدمًا لديه إذن الوصول إلى الجذر:

• أداة apigee-service:
  • أوامر apigee-service: install, uninstall, update.
  • أوامر apigee-all: install, uninstall, update.
• setup.sh النصي لتثبيت مكونات Edge (ما لم تكن قد استخدمت "apigee-service install" من قبل لتثبيت قيم RPM المطلوبة. بعد ذلك، يمكنك استخدام إذن الوصول الكامل أو إذن sudo إذا لم يكن ذلك مطلوبًا.)
• النص البرمجي update.sh لتحديث مكونات Edge

بالإضافة إلى ذلك، تنشئ أداة تثبيت Edge مستخدمًا جديدًا على نظامك، باسم "apigee". تستدعي العديد من أوامر Edge أداة sudo لتنفيذها بصفتها مستخدم "apigee".

يجب أن يكون أي مستخدم يريد تنفيذ جميع الأوامر الأخرى غير تلك المعروضة أعلاه مستخدمًا لديه إذن وصول sudo كامل إلى مستخدم "apigee". وتشمل هذه الأوامر ما يلي:

• أوامر أداة apigee-service، بما في ذلك:
  • أوامر apigee-service مثل start, stop, restart, configure.
  • أوامر apigee-all، مثل start, stop, restart, configure

إنشاء مستخدم لديه إذن وصول sudo كامل إلى مستخدم "apigee"

لمنح مستخدم إذن وصول sudo كاملاً إلى مستخدم apigee، استخدِم الأمر visudo لتعديل ملف sudoers من أجل إضافة ما يلي:

installUser        ALL=(apigee)      NOPASSWD: ALL

حيث يكون installUser هو اسم مستخدم متصفّح Edge.

ضبط الأذونات على ملفات الضبط

يجب أن يكون بإمكان مستخدم "apigee" الوصول إلى أي ملفات أو موارد تستخدمها أوامر Edge. ويتضمّن ذلك ملف ترخيص Edge وأي ملفات إعداد.

عند إنشاء ملفّ إعدادات، يمكنك تغيير مالك الملفّ إلى apigee:apigee لضمان إمكانية وصول أوامر Edge إليه:

1. أنشئ الملف في محرِّر باسم أي مستخدم.
2. chown مالك الملف إلى "apigee:apigee" أو، إذا غيّرت المستخدم الذي يشغّل خدمة Edge من المستخدم "apigee"، يمكنك منح إذن الوصول إلى الملف للمستخدم الذي يشغّل خدمة Edge.

فصل مهام تثبيت Edge بين المستخدم الجذر وغير الجذر

على الرغم من أنّه من الأسهل تنفيذ عملية تثبيت Edge بالكامل باستخدام إذن الوصول إلى الجذر أو من خلال مستخدم لديه إذن وصول sudo كامل، إلا أنّ ذلك ليس ممكنًا في بعض الأحيان. بدلاً من ذلك، يمكنك تقسيم عملية إلى مهام يؤديها المستخدم الجذر ومهام يؤديها مستخدم لديه إذن وصول sudo كامل إلى مستخدم "apigee".

1. المهام التي ينفّذها المستخدم الجذر:
   1. نزِّل ملف bootstrap_4.50.00.sh وشغِّله:

      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
      sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

      تؤدي هذه الخطوة إلى تثبيت الأداة apigee-service وإنشاء مستخدم "apigee" .

   2. اضبط حساب مستخدم للحصول على إذن وصول sudo كامل إلى حساب المستخدم "apigee" كما هو موضّح في مقالة إنشاء حساب مستخدم لديه إذن وصول sudo كامل إلى حساب المستخدم "apigee".
   3. تثبيت الأداة apigee-setup:

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. استخدِم الأداة apigee-setup لتثبيت حِزم RPM لنظام التشغيل Edge على العقدة:

      /opt/apigee/apigee-service/bin/apigee-service compName install

      تعتمد حِزم RPM لنظام التشغيل Edge التي يتم تثبيتها على العقدة على البنية الأساسية. تشمل قائمة المكوّنات المتاحة ما يلي: apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. بعد أن يُثبِّت المستخدم الجذر حِزم RPM الخاصة بـ Edge على العقدة، يُكمل المستخدم الذي لديه إذن وصول sudo كامل إلى المستخدم "apigee" عملية الضبط:
   1. استخدِم الأداة setup.sh لإكمال عملية ضبط مكونات Edge على العقدة. يعتمد شكل الأمر على المكوّنات التي ثبّتها على العقدة. للحصول على قائمة كاملة، يُرجى الاطّلاع على مقالة تثبيت مكونات Edge على عقدة.

      على سبيل المثال، لإكمال تثبيت ZooKeeper وCassandra، استخدم الأمر التالي:

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      حيث يكون configFile هو ملف إعدادات Edge.

      أو لإجراء عملية تثبيت شاملة، استخدِم الأمر التالي:

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

موقع ملفات إعداد التثبيت

يجب تمرير ملف إعدادات إلى الأداة apigee-setup التي تحتوي على معلومات عن تثبيت Edge. الشرط الوحيد لعمليات التثبيت الصامت هو أن يكون ملف الإعداد متاحًا للوصول إليه أو قراءته بواسطة مستخدم "apigee". على سبيل المثال، ضع الملف في الدليل /usr/local/var أو /usr/local/share على العقدة chown إلى "apigee:apigee".

ستكون جميع المعلومات الواردة في ملف الإعداد مطلوبة باستثناء كلمة مرور مشرف نظام Edge. في حال حذف كلمة المرور، ستطالبك أداة apigee-setup بإدخالها في سطر الأوامر.

اطّلِع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.

التعامل مع إخفاق عملية التثبيت

في حال تعذُّر تثبيت مكوّن Edge، يمكنك محاولة حل المشكلة، ثم تشغيل أداة التثبيت مرة أخرى. تم تصميم أداة التثبيت بحيث يتم تشغيلها بشكل متكرر في الحالات التي ترصد فيها تعذُّرًا، أو إذا أردت لاحقًا تغيير مكوّن أو تعديله بعد التثبيت.

بعد التثبيت أو الترقية، احرص على إعادة تشغيل مكوّن واجهة مستخدم Edge على كل عقدة يتم تشغيله عليها.

التثبيت على الإنترنت أو بدونه

لتثبيت Edge على عقدة، يجب أن تكون العقدة قادرة على الوصول إلى مستودع Apigee:

• العُقد المزوّدة باتصال إنترنت خارجي

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

• العقد التي لا تتوفّر فيها إمكانية الاتصال بالإنترنت الخارجي

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

  لإنشاء مستودع Apigee داخلي، يجب توفُّر عقدة ذات وصول خارجي إلى الإنترنت لتتمكّن من تنزيل العناصر الاعتمادية والعائدات لكل ألف مشاهدة (RPM) في Edge. بعد إنشاء ال repo الداخلي، يمكنك نقله إلى عقدة أخرى أو السماح بوصول عقد Edge إلى هذه العقدة للتثبيت.

استخدام مستودع Edge على الجهاز للحفاظ على إصدار Edge

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

حلّ مشاكل تبعيات تثبيت حِزم RPM

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

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

أوامر Yum الشائعة

تعتمد أدوات تثبيت Edge لنظام التشغيل Linux على أداة Yum لتثبيت المكوّنات وتحديثها. قد تحتاج إلى استخدام عدة أوامر Yum لإدارة عملية تثبيت على عقدة.

• محو جميع ذاكرات التخزين المؤقت في Yum:

  sudo yum clean all

• لتعديل مكوّن Edge:

  sudo yum update componentName

  على سبيل المثال:

  sudo yum update apigee-setup
  sudo yum update edge-management-server

هيكل نظام الملفات

يُثبِّت Edge جميع الملفات في الدليل /opt/apigee.

في هذا الدليل وفي دليل عمليات Edge، تتم الإشارة إلى دليل التثبيت الجذر على النحو التالي:

/opt/apigee

تستخدم عملية التثبيت بنية نظام الملفات التالية لنشر Apigee Edge for Private Cloud.

ملفات السجلّ

يتم كتابة ملف السجلّ الخاص بـ apigee-setup ونص setup.sh إلى /tmp/setup-root.log.

يتم تضمين ملفات السجلّ لكل مكوّن في الدليل /opt/apigee/var/log. ولكل مكوّن دليل فرعي خاص به. على سبيل المثال، تكون سجلات "خادم الإدارة" في الدليل:

/opt/apigee/var/log/edge-management-server

تعرِض الجداول التالية مواقع ملفات السجلّ:

المكوّن	الموقع الجغرافي
خادم الإدارة	/opt/apigee/var/log/edge-management-server
جهاز التوجيه	/opt/apigee/var/log/edge-router يتم تنفيذ Edge Router باستخدام Nginx. للحصول على سجلّات إضافية، يُرجى الاطّلاع على: /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs
معالج الرسائل	/opt/apigee/var/log/edge-message-processor
خادم Qpid في Apigee	/opt/apigee/var/log/edge-qpid-server
خادم Apigee Postgres	/opt/apigee/var/log/edge-postgres-server
واجهة المستخدم الكلاسيكية (وليس واجهة مستخدم Edge الجديدة التي يكون اسم المكوّن فيها هو edge-management-ui)	/opt/apigee/var/log/edge-ui
ZooKeeper	/opt/apigee/var/log/apigee-zookeeper
OpenLDAP	/opt/apigee/var/log/apigee-openldap
كاساندرا	/opt/apigee/var/log/apigee-cassandra/system.log
Qpidd	/opt/apigee/var/log/apigee-qpidd
قاعدة بيانات PostgreSQL	/opt/apigee/var/log/apigee-postgresql
apigee-monit	/opt/apigee/var/log/apigee-monit

البيانات

المكوّن	الموقع الجغرافي
خادم الإدارة	/opt/apigee/data/edge-management-server
جهاز التوجيه	/opt/apigee/data/edge-router
معالج الرسائل	/opt/apigee/data/edge-message-processor
وكيل Qpid في Apigee	/opt/apigee/data/edge-qpid-server
وكيل Apigee Postgres	/opt/apigee/data/edge-postgres-server
ZooKeeper	/opt/apigee/data/apigee-zookeeper
OpenLDAP	/opt/apigee/data/apigee-openldap
كاساندرا	/opt/apigee/data/apigee-cassandra/data
Qpidd	/opt/apigee/data/apigee-qpid/data
قاعدة بيانات PostgreSQL	/opt/apigee/data/apigee-postgres/pgdata
apigee-monit	/opt/apigee/data/apigee-monit

تفعيل فحص النظام عند التثبيت

يتيح ملف إعدادات تثبيت Edge السمة التالية:

ENABLE_SYSTEM_CHECK=y

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