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

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

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

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

شرط أساسي: إيقاف SELinux

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

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

    يجب تفعيل حزمة Extra Packages for Enterprise 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. فعِّل Extra Packages for 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. فعِّل حزمة 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.7 على التوالي.

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

      لتثبيت Edge على عقدة متصلة بالإنترنت خارجيًا، اتّبِع الخطوات التالية:

      1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك username:password لموقع Apigee ftp، يمكنك استخدام بيانات الاعتماد هذه.
      2. سجِّل الدخول إلى العقدة بصفتك مستخدمًا رئيسيًا لتثبيت حِزم Edge RPM
      3. أوقِف SELinux.
      4. فعِّل مستودع EPEL.
      5. إذا كنت تثبّت البرنامج على RHEL 9 أو Rocky 9 أو Oracle 9، اتّبِع الخطوات الواردة في المتطلبات الأساسية لنظام التشغيل RHEL 9 أو Rocky 9 أو Oracle 9.
      6. نزِّل ملف Edge bootstrap_4.53.01.sh إلى /tmp/bootstrap_4.53.01.sh:
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      7. ثبِّت أداة Edge apigee-service والملفات التابعة لها:
        sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

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

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

        • I: تثبيت 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. نزِّل ملف Edge bootstrap_4.53.01.sh إلى /tmp/bootstrap_4.53.01.sh:
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      5. ثبِّت أداة Edge apigee-service والمكونات التابعة لها:
        sudo bash /tmp/bootstrap_4.53.01.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.01.sh من المستودع المحلي لتثبيت الأداة المساعدة apigee-service:
          sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.01.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.01.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. على العُقدة البعيدة، ثبِّت أداة Edge apigee-service والتبعيات:
        sudo bash /tmp/bootstrap_4.53.01.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.53.01.sh ثم إجراء مزامنة جديدة.

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

      1. نزِّل ملف Edge bootstrap_4.53.01.sh إلى /tmp/bootstrap_4.53.01.sh:
        curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
      2. نفِّذ ملف Edge bootstrap_4.53.01.sh:
        sudo bash/tmp/bootstrap_4.53.01.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