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

الإصدار 4.18.05 من Edge for Private Cloud

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

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

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

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

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

  • لضبط SELinux على وضع السماح مؤقتًا، نفِّذ الأمر التالي:
    1. على نظام التشغيل Linux 6.x: 
      sudo echo 0 > /selinux/enforce

      لإعادة تفعيل SELinux بعد تثبيت Edge:

      sudo echo 1 > /selinux/enforce
    2. على نظام التشغيل Linux 7.x: 
      sudo setenforce 0

      لإعادة تفعيل SELinux بعد تثبيت Edge:

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

الشرط الأساسي: تفعيل مستودع EPEL

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

  • بالنسبة إلى RedHat/CentOS/Oracle 7.x: 
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
sudo rpm -ivh epel-release-latest-7.noarch.rpm
  • بالنسبة إلى RedHat/CentOS/Oracle 6.x: 
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm
sudo rpm -ivh epel-release-latest-6.noarch.rpm

الشرط الأساسي: التحقّق من إصدار مكتبة libdb4 على RedHat 7.4 وCentOS 7.4

في RedHat 7.4 وCentOS 7.4، تحقَّق من إصدار libdb4 RPM قبل التثبيت. يتطلب Edge الإصدار 4.8، وتتضمن بعض إصدارات RedHat 7.4 وCentOS 7.4 إصدارًا أحدث. إذا كان لديك إصدار أحدث، عليك إلغاء تثبيته، وبعد ذلك ستثبّت أداة تثبيت Edge الإصدار 4.8.

يمكنك استخدام الأمر التالي للتحقّق من الإصدار:

rpm -qa | grep libdb4

إذا رأيت أنّ إصدار libdb4 RPM أحدث من الإصدار 4.8، عليك إلغاء تثبيته.

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

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

  1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك اسم مستخدم وكلمة مرور حاليان لموقع Apigee FTP، يمكنك استخدام بيانات الاعتماد هذه.
  2. سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم Edge RPM
  3. ثبِّت yum-utils وyum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. أوقِف SELinux كما هو موضّح أعلاه.
  5. فعِّل مستودع EPEL كما هو موضّح أعلاه.
  6. تحقَّق من إصدار libdb4 كما هو موضَّح أعلاه.
  7. في حال التثبيت على Oracle 7.x، شغِّل الأمر التالي: 
    sudo yum-config-manager --enable ol7_optional_latest
  8. في حال التثبيت على AWS، نفِّذ الأوامر التالية yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. نزِّل ملف Edge bootstrap_4.18.05.sh على /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  10. ثبِّت أداة apigee-service في Edge والملفات التابعة لها: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

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

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

    • أولاً: تثبيت 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*'
  11. استخدِم apigee-service لتثبيت أداة apigee-setup:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. استخدِم apigee-setup لتثبيت مكوّنات Edge وضبطها على العقدة. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت مكوّنات Edge على عقدة.

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

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

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

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

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

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

  1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك اسم مستخدم وكلمة مرور حاليان لموقع Apigee FTP، يمكنك استخدام بيانات الاعتماد هذه.
  2. سجِّل الدخول إلى العقدة كمستخدم جذر لتثبيت حِزم RPM في Edge.
  3. أوقِف SELinux كما هو موضّح أعلاه.
  4. نزِّل ملف Edge bootstrap_4.18.05.sh على /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  5. ثبِّت أداة apigee-service في Edge والملفات التابعة لها: 
    sudo bash /tmp/bootstrap_4.18.05.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 فقط. تحتاج إلى مساحة قرص تبلغ 1.6 غيغابايت تقريبًا لإجراء عملية التنزيل:

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

    إذا أردت تنزيل المستودع بالكامل، بما في ذلك حِزم RPM القديمة، يمكنك حذف --only-new-rpms. تحتاج إلى مساحة قرص تبلغ 6 غيغابايت تقريبًا لإجراء عملية التنزيل الكاملة: 

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

    لديك الآن نسخة محلية من مستودع Apigee. يصف القسم التالي كيفية تثبيت أداة Edge apigee-setup من المستودع المحلي.

  8. (اختياري) إذا أردت تثبيت Edge من المستودع المحلي على العقدة نفسها التي تستضيف المستودع المحلي، عليك أولاً تنفيذ الأوامر التالية:
    1. شغِّل bootstrap_4.18.05.sh من المستودع المحلي لتثبيت الأداة المساعدة apigee-service: 
      sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.05.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:

  1. على العقدة التي تحتوي على المستودع المحلي، استخدِم الأمر التالي لإنشاء حزمة للمستودع المحلي في ملف ‎ .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. انسخ ملف ‎ .tar إلى العقدة التي تريد تثبيت Edge عليها. على سبيل المثال، انسخه إلى دليل /tmp على العقدة الجديدة.
  3. على العقدة الجديدة، أوقِف SELinux كما هو موضّح أعلاه.
  4. على العقدة الجديدة، فعِّل مستودع EPEL كما هو موضّح أعلاه.
  5. على العقدة الجديدة، تأكَّد من إيقاف أي مستودعات إنترنت خارجية. عند تشغيل الأمر التالي، من المفترض أن تظهر جميع المستودعات الخارجية على أنّها غير مفعَّلة، ولكن يجب تفعيل مستودع Apigee المحلي وأي من مستودعاتك الداخلية: 
    sudo yum repolist
  6. على العقدة الجديدة، ثبِّت yum-utils وyum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  7. على العقدة الجديدة، تحقَّق من إصدار libdb4 كما هو موضَّح أعلاه.
  8. في حال التثبيت على Oracle 7.x، شغِّل الأمر التالي: 
    sudo yum-config-manager --enable ol7_optional_latest
  9. في حال التثبيت على AWS، شغِّل الأمر yum-configure-manager التالي: 
    sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  10. على العقدة الجديدة، فُكّ ضغط الملف إلى الدليل ‎ /tmp: 
    tar -xzf apigee-4.18.05.tar.gz

    ينشئ هذا الأمر دليلاً جديدًا باسم repos في الدليل الذي يحتوي على ملف ‎ .tar. على سبيل المثال، /tmp/repos.

  11. ثبِّت أداة apigee-service في Edge والملفات التابعة لها من /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    لاحظ أنك تقوم بتضمين المسار إلى دليل المستودعات في هذا الأمر.

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

التثبيت من المستودع باستخدام خادم الويب 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. على العقدة الجديدة، ثبِّت yum-utils وyum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. على العقدة الجديدة، أوقِف SELinux كما هو موضّح أعلاه.
  6. على العقدة الجديدة، فعِّل مستودع EPEL كما هو موضّح أعلاه.
  7. على العقدة الجديدة، تحقَّق من إصدار libdb4 كما هو موضَّح أعلاه.
  8. على العقدة البعيدة، نزِّل ملف Edge bootstrap_4.18.05.sh إلى /tmp/bootstrap_4.18.05.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

    حيث uName:pWord هما اسم المستخدم وكلمة المرور اللذان حدّدتهما أعلاه للمستودع، وremoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات لعقدة المستودع.

  9. على العقدة البعيدة، ثبِّت أداة apigee-service في Edge والتبعيات: 
    sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

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

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

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

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

إضافة Edge 4.16.0x/4.17.0x أو تعديله في مستودع 4.18.05

إذا كان عليك الاحتفاظ بعمليات تثبيت Edge 4.16.0x أو 4.17.0x في مستودع 4.18.05، يمكنك الاحتفاظ بمستودع يحتوي على جميع الإصدارات. من هذا المستودع، يمكنك تثبيت أي إصدار من Edge.

لإضافة 4.16.0x/4.17.0x إلى مستودع 4.18.05:

  1. تأكَّد من تثبيت الإصدار 4.18.05 من أداة apigee-mirror المساعدة: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

    من المفترض أن تظهر لك نتيجة بالشكل التالي، حيث يمثّل xyz رقم الإصدار:

    apigee-mirror-4.18.05-0.0.xyz
  2. استخدِم الأداة المساعدة apigee-mirror لتنزيل Edge 4.16.0x/4.17.0x إلى المستودع. لاحظ كيف تسبق الأمر بالإصدار المطلوب: 
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

    استخدِم هذا الأمر نفسه لتحديث مستودعات 4.16.0x/4.17.0x لاحقًا من خلال تحديد أرقام الإصدارات المطلوبة.

  3. افحص دليل /opt/apigee/data/apigee-mirror/repos للاطّلاع على بنية الملف: 
    ls /opt/apigee/data/apigee-mirror/repos

    من المفترض أن تظهر لك الملفات والأدلة التالية:

    apigee
apigee-repo-1.0-6.x86_64.rpm
bootstrap_4.16.01.sh
bootstrap_4.16.05.sh
bootstrap_4.17.01.sh
bootstrap_4.17.05.sh
bootstrap_4.17.09.sh
bootstrap_4.18.05.sh
thirdparty

    لاحظ كيف يتوفّر لديك ملف تمهيد لجميع إصدارات Edge. يحتوي الدليل apigee أيضًا على أدلة منفصلة لكل إصدار من Edge.

  4. لتجميع المستودع في ملف ‎ .tar، استخدِم الأمر التالي:
    apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

    يجمع هذا الأمر جميع مستودعات 4.17.0x و4.16.0x في ملف ‎ .tar نفسه. لا يمكنك تجميع جزء فقط من المستودع.

لتثبيت Edge من المستودع المحلي أو ملف ‎ .tar، تأكَّد من تشغيل ملف الإعداد الصحيح باستخدام أحد الأوامر التالية. يثبّت هذا المثال الإصدار 4.17.01 من Edge:

  • في حال التثبيت من ملف ‎ .tar، شغِّل ملف bootstrap الصحيح من المستودع:
    sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

    لإكمال عملية التثبيت، اتّبِع الخطوات المتبقية من "التثبيت من ملف ‎ .tar" أعلاه.

  • في حال التثبيت باستخدام خادم الويب Nginx، نزِّل ملف الإعداد الصحيح من المستودع ثم شغِّله: 
    /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.sh
sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

    لإكمال عملية التثبيت، اتّبِع الخطوات المتبقية من "التثبيت من المستودع باستخدام خادم الويب Nginx" أعلاه.