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

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

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

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

الشرط المسبق: إيقاف SELinux

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

  • لإيقاف SELinux نهائيًا أو ضبطها على الوضع المتساهِل:
    1. افتح "/etc/sysconfig/selinux" في محرِّر.
    2. ضبط SELINUX=disabled أو SELINUX=permissive
    3. احفظ التعديلات.
    4. أعِد تشغيل العقدة.
    5. إذا لزم الأمر، أعِد تفعيل SELinux بعد تثبيت Edge من خلال تكرار هذا الإجراء لتحديد SELINUX=enabled.
  • الشرط الأساسي: تفعيل مستودع EPEL

    يجب تفعيل حِزم إضافية لنظام التشغيل Linux في المؤسسة (أو EPEL) لتثبيت Edge أو تحديثه أو لإنشاء مستودع محلي. يعتمد الأمر الذي تستخدمه على إصدار RedHat/CentOS:

    • لأجهزة Red Hat/CentOS/Oracle 8.x:
      wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      sudo rpm -ivh epel-release-latest-8.noarch.rpm
    • لأجهزة Red Hat/CentOS/Oracle 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 8/Rocky 8/Oracle 8

      إذا كنت بصدد تثبيت Edge على خادم يعمل بنظام التشغيل Red Hat Enterprise Linux (RHEL) 8، عليك تنفيذ الخطوات التالية قبل إجراء عملية التثبيت:

      1. تفعيل الحزم الإضافية لنظام التشغيل Enterprise Linux (EPEL):
        sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
      2. أوقِف Postgres وNginx:
        sudo dnf module disable postgresql
        sudo dnf module disable nginx

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

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

      1. فعِّل حِزم إضافية لنظام التشغيل 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 والتغييرات على عمليات التثبيت المُسبَق للإصدار 2.4 من OpenLDAP، على التوالي.

      تثبيت أداة إعداد واجهة برمجة التطبيقات Edge على 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.53.00.sh إلى /tmp/bootstrap_4.53.00.sh:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      7. ثبِّت أداة apigee-service وتبعياتها في Edge:
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

        يتحقّق برنامج التثبيت تلقائيًا من تثبيت Java 1.8. وإذا لم تفعل ذلك، سيثبِّته نيابةً عنك. استخدِم الخيار JAVA_FIX لتحديد كيفية التعامل مع تثبيت Java. JAVA_FIX يمكن أن تأخذ القيمة التالية:

        • 1: تثبيت OpenJDK 1.8 (الإعداد التلقائي)
        • ج: المتابعة بدون تثبيت Java
        • س: إنهاء. وبالنسبة إلى هذا الخيار، عليك تثبيت 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

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

      نوع الخطأ الحلّ المحتمل
      تحتوي كلمة المرور على أحرف غير صالحة لا تستخدِم رموزًا خاصة في كلمة مرور Apigee.
      مشاكل الاتصال

      اختبِر اتصالك بالشبكة من خلال تنفيذ الأمر ncat التالي:

      nc -v software.apigee.com 443

      من المفترض أن تظهر لك رسالة مشابهة لما يلي:

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

      إذا لم يكن nc مثبّتًا، يمكنك تنفيذ الأمر telnet التالي:

      telnet software.apigee.com 443

      إذا نجحت الأوامر، يمكنك استخدام CTRL+C لإيقاف الاتصال المفتوح.

      في حال إخفاق أيٍ من الأمرين، يعني ذلك أن لديك اتصالاً محدودًا بالشبكة أو معدومًا. يُرجى الرجوع إلى مشرف الشبكة.

      بيانات الاعتماد غير صحيحة

      تأكَّد من صحة اسم المستخدم وكلمة المرور.

      على سبيل المثال، تحقَّق من ظهور رسالة خطأ عند محاولة استخدام الأمر التالي مع اسم المستخدم وكلمة المرور في Apigee:

      curl -i -u username:password https://software.apigee.com/apigee-repo.rpm
      مشاكل الخادم الوكيل تستخدم الإعدادات المحلية خادم وكيل HTTP للخروج ولم يتم توسيع نطاق الإعدادات نفسها إلى مدير حِزم yum. التحقّق من متغيّرات البيئة:
      echo $http_proxy
      echo $https_proxy

      بالنسبة إلى خادم وكيل HTTP للخروج، يجب استخدام أحد الخيارَين التاليَين:

      • إضافة إعدادات خادم وكيل HTTP في /etc/yum.conf
      • إضافة إعدادات خادم وكيل HTTP العام في /etc/environment

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

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

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

      إنشاء مستودع Apigee على الجهاز

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

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

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

      1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك اسم مستخدم وكلمة مرور حاليَين لموقع Apigee ftp الإلكتروني، يمكنك استخدام هذين الاسمَين وكلمة المرور.
      2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
      3. أوقِف SELinux كما هو موضّح أعلاه.
      4. نزِّل ملف bootstrap_4.53.00.sh في Edge إلى /tmp/bootstrap_4.53.00.sh:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      5. ثبِّت أداة apigee-service وتبعياتها في Edge:
        sudo bash /tmp/bootstrap_4.53.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.53.00.sh من المستودع المحلي لتثبيت أداة apigee-service:
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.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.53.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 تلقائيًا على استخدام المضيف المحلي كاسم للخادم ومنفذ 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.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

        حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور في Repo.

      7. على العقدة البعيدة، استخدِم apigee-service لتثبيت الأداة apigee-setup:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      8. يمكنك استخدام apigee-setup لتثبيت مكونات Edge وضبطها على العقدة البعيدة. اطّلِع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.

      تعديل مستودع Apigee على الجهاز

      لتحديث المستودع، يجب تنزيل أحدث ملف Bootstrap_4.53.00.sh ثم إجراء مزامنة جديدة.

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

      1. نزّل ملف Bootstrap_4.53.00.sh على Edge إلى /tmp/bootstrap_4.53.00.sh:
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. تشغيل ملف Edge bootstrap_4.53.00.sh:
        sudo bash/tmp/bootstrap_4.53.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