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

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

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

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

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

     لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.

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

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

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

   لمزيد من المعلومات، يُرجى الاطّلاع على إعداد مؤسسة.

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

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

9. اضبط المصادقة والإعدادات الاختيارية لواجهة مستخدم New Edge (التي تحمل أسماء المكوّنات edge-management-ui وedge-management-ui-static).

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

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

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

يتم تثبيت ملفات توزيع Apigee Edge كمجموعة من حِزم RPM والتبعيات. لتثبيت حزم Edge RPM وإلغاء تثبيتها وتحديثها، يجب تشغيل الأوامر من خلال المستخدم الجذر أو من خلال مستخدم لديه إذن وصول كامل إلى 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". Many Edge commands invoke sudo to run as the "apigee" user.

يجب أن يكون أي مستخدم يريد تنفيذ جميع الأوامر الأخرى غير تلك الموضّحة أعلاه مستخدمًا لديه إذن وصول كامل إلى 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.54.00.sh وشغِّله:

      curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
      sudo bash /tmp/bootstrap_4.54.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 لتثبيت حِزم Edge RPM على العُقدة:

      /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-management-ui, edge-management-ui-static, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server.

2. بعد أن يثبّت مستخدم الجذر حِزم Edge RPM على العُقدة، يكمل المستخدم الذي لديه إذن وصول كامل إلى 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 لتثبيت Edge RPMs والتبعيات.

• العُقد التي لا تتصل بالإنترنت الخارجي

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

  لإنشاء مستودع Apigee الداخلي، يجب توفير عقدة يمكنها الوصول إلى الإنترنت خارجيًا لتتمكّن من تنزيل حِزم RPM والتبعيات الخاصة بـ Edge. بعد إنشاء المستودع الداخلي، يمكنك نقله إلى عقدة أخرى أو إتاحة هذه العقدة لعقد 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

يسرد الجدول التالي مكان ملفات السجلّ:

البيانات

تفعيل ميزة "التحقّق من النظام عند التثبيت"

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

ENABLE_SYSTEM_CHECK=y

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