تثبيت أداة إعداد واجهة برمجة التطبيقات Edge

لتثبيت Edge على عُقدة، عليك أولاً تثبيت أداة `apigee-setup` في Edge. إذا كنت في بيئة لا تتضمّن فيها العُقد اتصالاً خارجيًا بالإنترنت، عليك أيضًا تثبيت نسخة محلية من مستودع Apigee.

دليل التثبيت التلقائي: /opt/apigee

تثبِّت Edge جميع الملفات في الدليل /opt/apigee. لا يمكنك تغيير هذا الدليل. ومع ذلك، يمكنك إنشاء رابط رمزي لربط /opt/apigee بـ موقع آخر إذا أردت ذلك. لمزيد من المعلومات، يُرجى الاطّلاع على متطلبات التثبيت.

المتطلبات الأساسية: إيقاف SELinux

عليك إيقاف SELinux أو ضبطه على الوضع المتساهل قبل أن تتمكّن من تثبيت Edge apigee-setup utility أو أي مكوّنات من مكوّنات Edge. بعد تثبيت Edge، يمكنك إعادة تفعيل SELinux إذا لزم الأمر.

المتطلبات الأساسية: تفعيل مستودع EPEL

عليك تفعيل مستودع Extra Packages for Enterprise Linux (أو EPEL) لتثبيت Edge أو تعديله أو إنشاء مستودع محلي. بالنسبة إلى Red Hat Enterprise Linux (RHEL) 9.x أو Rocky Linux 9.x أو Oracle Linux 9.x، شغِّل الأوامر التالية:

wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
sudo rpm -ivh epel-release-latest-9.noarch.rpm

المتطلبات الأساسية لنظام التشغيل RHEL 9 أو Rocky 9 أو Oracle 9

إذا كنت تثبِّت Edge على خادم يعمل بنظام التشغيل Red Hat Enterprise Linux (RHEL) 9 أو Rocky 9 أو Oracle 9، عليك إكمال الخطوات التالية قبل إجراء عملية التثبيت:

1. تفعيل Extra Packages for Enterprise Linux (EPEL):

   sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm

2. إيقاف Postgres وNginx:

   sudo dnf module disable postgresql
   sudo dnf module disable nginx

بالنسبة إلى التغييرات التي يتم إجراؤها قبل التثبيت في PostgreSQL وLDAP، يُرجى الاطّلاع على متطلبات ما قبل التثبيت لقاعدة بيانات PostgreSQL و التغييرات التي يتم إجراؤها قبل التثبيت في SymasLDAP 2.6.10، على التوالي.

تثبيت أداة `apigee-setup` في Edge على عُقدة متصلة بالإنترنت خارجيًا

لتثبيت Edge على عُقدة متصلة بالإنترنت خارجيًا:

1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك username:password حالي لموقع Apigee الإلكتروني عبر بروتوكول نقل الملفات (FTP)، يمكنك استخدام بيانات الاعتماد هذه.
2. سجِّل الدخول إلى العُقدة بصفتك مستخدمًا أساسيًا لتثبيت حِزم RPM في Edge
   
3. أوقِف SELinux.
4. فعِّل مستودع EPEL.
5. إذا كنت تثبِّت على نظام التشغيل RHEL 9 أو Rocky 9 أو Oracle 9، اتّبِع الخطوات الواردة في المتطلبات الأساسية لنظام التشغيل RHEL 9 أو Rocky 9 أو Oracle 9.
6. نزِّل ملف Edge ‏bootstrap_4.54.00.sh إلى /tmp/bootstrap_4.54.00.sh:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

7. ثبِّت أداة `apigee-service` في Edge والتبعيات:

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان تلقّيتهما من Apigee. إذا لم تُدخِل pWord، سيُطلب منك إدخالها.

   يتطلّب Apigee Edge for Private Cloud 4.54.00 دعمًا مزدوجًا للغة Java مع تثبيت كل من Java 17 وJava 21 على العُقدة. عليك تثبيت كل من Java 17 و Java 21 قبل تشغيل النص البرمجي للتهيئة. لا يتحقّق برنامج التثبيت إلا من تثبيت كلا إصدارَي JDK، ولا يثبِّت Java تلقائيًا.

   يؤدي تثبيت أداة `apigee-service` إلى إنشاء الملف /etc/yum.repos.d/apigee.repo الذي يحدِّد مستودع Apigee. لعرض ملف التعريف، استخدِم الأمر:

   cat /etc/yum.repos.d/apigee.repo

   لعرض محتوى المستودع، استخدِم الأمر:

   sudo yum -v repolist 'apigee*'

8. استخدِم `apigee-service` لتثبيت أداة `apigee-setup`:
   

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

9. استخدِم `apigee-setup` لتثبيت مكوّنات Edge وضبطها على العُقدة. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت مكوّنات Edge على عُقدة.

تحديد المشاكل وحلّها

عند محاولة التثبيت على عُقدة متصلة بالإنترنت خارجيًا، قد تواجه خطأ واحدًا أو أكثر من الأخطاء التالية:

Cannot open: https://username@software.apigee.com/apigee-repo-4.53.00.rpm

bootstrap.sh: Error: Repo configuration failed

error: package package_name is not installed

يسرد الجدول التالي بعض الحلول المحتملة لهذه الأخطاء:

nc -v software.apigee.com 443

Connection to software.apigee.com 443 port [tcp/https] succeeded!

telnet software.apigee.com 443

curl -i -u username:password https://software.apigee.com/apigee-repo.rpm

echo $http_proxy
echo $https_proxy

تثبيت أداة `apigee-setup` في Edge على عُقدة غير متصلة بالإنترنت خارجيًا

إذا كانت عُقد Edge خلف جدار حماية أو محظورة بطريقة أخرى من الوصول إلى الإنترنت، عليك إنشاء عدة مستودعات أو مواقع طبق الأصل تحتوي على الملفات التي ستحتاج إليها أثناء التثبيت. يجب أن تكون مواقع طبق الأصل هذه متاحة لجميع العُقد. بعد إنشائها، يمكن للعُقد الوصول إلى مواقع طبق الأصل المحلية هذه لتثبيت Edge.

تتطلّب عملية تثبيت Apigee Edge للعُقد غير المتصلة بالإنترنت الوصول إلى المستودعات المحلية التالية:

• مستودع Apigee Edge: كما هو موضّح في إنشاء مستودع Apigee محلي.
• مستودع Extra Packages for Enterprise Linux (أو EPEL): يجب أن يكون فريق العمليات قادرًا على إعداد هذا المستودع لك.

إنشاء مستودع Apigee محلي

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

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

لإنشاء مستودع Apigee محلي:

1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك اسم مستخدم:كلمة مرور حاليان لموقع Apigee الإلكتروني عبر بروتوكول نقل الملفات (FTP)، يمكنك استخدام بيانات الاعتماد هذه.
2. سجِّل الدخول إلى العُقدة بصفتك مستخدمًا أساسيًا لتثبيت حِزم RPM في Edge.
   
3. أوقِف SELinux كما هو موضّح أعلاه.
4. نزِّل ملف Edge ‏bootstrap_4.54.00.sh إلى /tmp/bootstrap_4.54.00.sh:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

5. ثبِّت أداة `apigee-service` في Edge والتبعيات:
   

   sudo bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان تلقّيتهما من Apigee. إذا لم تُدخِل pWord، سيُطلب منك إدخالها.

6. ثبِّت أداة apigee-mirror على العُقدة:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

7. استخدِم أداة apigee-mirror لمزامنة مستودع Apigee مع الدليل /opt/apigee/data/apigee-mirror/repos/.

   لتقليل حجم المستودع، استخدِم العلامة --only-new-rpms لتنزيل أحدث حِزم RPM فقط.

8. (اختياري) إذا أردت تثبيت Edge من المستودع المحلي على العُقدة نفسها التي تستضيف المستودع المحلي، عليك أولاً تشغيل الأوامر التالية:
   1. شغِّل bootstrap_4.54.00.sh من المستودع المحلي لتثبيت الـ apigee-service أداة:

      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos

   2. استخدِم apigee-service لتثبيت أداة apigee-setup:

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

   3. استخدِم apigee-setup لتثبيت مكوّنات Edge وضبطها على العُقدة. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت مكوّنات Edge على عُقدة.

تثبيت `apigee-setup` على عُقدة بعيدة من المستودع المحلي

يتوفّر لديك خياران لتثبيت Edge من المستودع المحلي. يمكنك تنفيذ إجراء مما يلي:

• إنشاء ملف ‎.tar للمستودع، ونسخ ملف ‎.tar إلى عُقدة، ثم تثبيت Edge من ملف ‎.tar
• تثبيت خادم ويب على العُقدة التي تتضمّن المستودع المحلي ليتمكّن من الوصول إليه من عُقد أخرى توفِّر لك Apigee خادم الويب Nginx لاستخدامه، أو يمكنك استخدام خادم الويب الخاص بك.

التثبيت من ملف ‎ .tar

للتثبيت من ملف ‎ .tar:

1. على العُقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لتجميع المستودع المحلي في ملف ‎ .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. انسخ ملف ‎ .tar إلى العُقدة التي تريد تثبيت Edge عليها. على سبيل المثال، انسخه إلى الدليل /tmp على العُقدة الجديدة.
3. على العُقدة الجديدة، أوقِف SELinux كما هو موضّح أعلاه.
4. على العُقدة الجديدة، تأكَّد من إمكانية الوصول إلى مستودع أداة Yum المحلية ومستودع EPEL.
5. تأكَّد مرة أخرى من أنّ جميع مستودعات الإنترنت الخارجية غير مفعّلة (يجب أن يكون هذا هو الحال لأنّك تثبِّت على جهاز لا يمكنه إمكانية الوصول إلى الإنترنت):

   sudo yum repolist

   يجب إيقاف جميع المستودعات الخارجية، ولكن يجب تفعيل مستودع Apigee المحلي والمستودعات الداخلية يجب تفعيلها.

6. استخدِم apigee-service لتثبيت أداة apigee-setup:

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

7. استخدِم apigee-setup لتثبيت مكوّنات Edge وضبطها على العُقدة. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت مكوّنات Edge على عُقدة.

التثبيت من المستودع باستخدام خادم الويب Nginx

للتثبيت من المستودع باستخدام خادم الويب Nginx:

1. ثبِّت خادم الويب Nginx على عُقدة المستودع:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig

2. يتم ضبط Nginx تلقائيًا لاستخدام localhost كاسم للخادم والمنفذ 3939. لتغيير هذه القيم:
   1. افتح الملف /opt/apigee/customer/application/mirror.properties في أحد المحرّرات. أنشِئ الملف إذا لم يكن موجودًا.
   2. اضبط القيم التالية حسب الحاجة:

      conf_apigee_mirror_listen_port=3939
      conf_apigee_mirror_server_name=localhost

   3. أعِد تشغيل Nginx:

      /opt/nginx/scripts/apigee-nginx restart

3. يتطلّب المستودع تلقائيًا اسم مستخدم:كلمة مرور admin:admin. لتغيير بيانات الاعتماد هذه، اضبط متغيّرات البيئة التالية:

   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord

4. على العُقدة الجديدة، تأكَّد من تفعيل مستودع EPEL محليًا.
5. على العُقدة الجديدة، تحقَّق من إصدار libdb4 كما هو موضّح أعلاه.
6. على العُقدة البعيدة، ثبِّت أداة apigee-service في Edge والتبعيات:

   sudo bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

   حيث uName:pWord هما اسم المستخدم وكلمة المرور في المستودع.

7. على العُقدة البعيدة، استخدِم apigee-service لتثبيت أداة apigee-setup:

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

8. استخدِم apigee-setup لتثبيت مكوّنات Edge وضبطها على العُقدة البعيدة. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت مكوّنات Edge على عُقدة.

تعديل مستودع Apigee محلي

لتعديل المستودع، عليك تنزيل أحدث ملف bootstrap_4.54.00.sh ثم إجراء مزامنة جديدة.

لتعديل المستودع:

1. نزِّل ملف bootstrap_4.54.00.sh في Edge إلى /tmp/bootstrap_4.54.00.sh:

   curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh

2. شغِّل ملف bootstrap_4.54.00.sh في Edge:

   sudo bash/tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord

   حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان تلقّيتهما من Apigee. إذا لم تُدخِل pWord، سيُطلب منك إدخالها.

3. عدِّل apigee-mirror:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror update

4. أجرِ المزامنة:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

5. إذا أردت تنزيل المستودع بالكامل:

   /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync

تنظيف مستودع Apigee محلي

يؤدي تنظيف المستودع المحلي إلى حذف ` /opt/apigee/data/apigee-mirror` و` /var/tmp/yum-apigee-*`.

لتنظيف المستودع المحلي، استخدِم:

/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean