نظرة عامة على تثبيت 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.52.00.sh إلى /tmp/bootstrap_4.52.00.sh.
   • ثبِّت أداة Edge apigee-service والتبعيات.
   • ثبِّت أداة Edge apigee-setup والتبعيات.

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

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 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.52.00.sh وشغِّله:

      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
      sudo bash /tmp/bootstrap_4.52.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. بعد أن يثبّت المستخدم الجذر حِزم 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 على العقدة وغيِّر ملكيته إلى "apigee:apigee" باستخدام الأمر chown.

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

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

التعامل مع تعذُّر التثبيت

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

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

التثبيت باستخدام الإنترنت أو بدونه

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

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

  تصل العُقد التي تتضمّن اتصالاً خارجيًا بالإنترنت إلى مستودع Apigee لتثبيت Edge RPMs والتبعيات.

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

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

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