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

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

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

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

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

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

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

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

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

   لمزيد من المعلومات، راجِع مقالة إعداد مؤسسة.

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

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

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

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

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

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

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

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

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.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

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

  لإنشاء مستودع 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" لإيقاف عملية التحقّق.