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

Edge for Private Cloud v4.19.01

لتثبيت Edge على عقدة، عليك أولاً تثبيت أداة إعداد Edge apigee. إذا كنت في بيئة لا تتوفّر فيها اتصال بالإنترنت خارجي من العُقد، عليك أيضًا تثبيت نسخة محلية من طلب الشراء في 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 على الإصدارين 7.4 من RedHat وCOSOS 7.4.

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

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

rpm -qa | grep libdb4

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

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

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

  1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك username:password حالية لموقع بروتوكول النقل الآمن للملفات (SFTP) الخاص بـ Apigee، يمكنك استخدام بيانات الاعتماد هذه.
  2. سجِّل الدخول إلى العقدة كجذر لتثبيت RPM 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.19.01.sh إلى /tmp/bootstrap_4.19.01.sh: 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  10. ثبِّت الأداة المساعدة والملحقات التابعة لخدمة Edge apigee: 
    sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

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

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

    • I: تثبيت OpenJDK 1.8 (تلقائي)
    • ج: المتابعة بدون تثبيت Java
    • س: إنهاء بالنسبة إلى هذا الخيار، يجب تثبيت Java بنفسك.

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

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

    للاطّلاع على محتوى السجلّ، يمكنك استخدام الأمر التالي:

    sudo yum -v repolist 'apigee*'
  11. استخدم apigee-service لتثبيت الأداة المساعدة لإعداد apigee:
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  12. يمكنك استخدام إعداد apigee لتثبيت مكوّنات Edge على العقدة وضبطها. يمكنك الاطّلاع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.

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

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

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

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

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

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

لإنشاء طلب محلي على Apigee:

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

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

    إذا كنت تريد تنزيل التقرير كاملاً، بما في ذلك العائد لكل ألف ظهور قديم، احذف --only-new-rpms. يجب أن تتوفّر مساحة تخزين تبلغ 6 غيغابايت تقريبًا للتنزيل الكامل: 

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

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

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

لديك خياران لتثبيت تطبيق Edge من ميزة "إعادة الشراء المحلية". يمكنك تنفيذ إجراء مما يلي:

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

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

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

  1. في العقدة التي تضمّ طلب محلي، استخدِم الأمر التالي لتجميع الطلب المحلي في ملف واحد بتنسيق .tar باسم /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
  2. انسخ ملف .tar إلى العقدة التي تريد تثبيت Edge فيها. على سبيل المثال، انسخه إلى الدليل /tmp في العقدة الجديدة.
  3. في العقدة الجديدة، أوقِف SELinux كما هو موضح أعلاه.
  4. في العُقدة الجديدة، تأكّد من إمكانية الوصول إلى مستودع Remup المحلي وYel.
  5. يُرجى التحقّق جيدًا من أنّ كل الأجهزة المستخدَمة لتوفير الاتصال بالإنترنت الخارجي غير مفعَّلة (يجوز أن يكون ذلك بسبب تثبيت جهازك على جهاز غير متّصل بالإنترنت): 
    sudo yum repolist

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

  6. في العقدة الجديدة، ثبِّت yum-utils وyum-plugin-priorities من التسجيل المحلي: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities

    يجب أن يُعِدّ فريق العمليات أو أي مجموعة أخرى داخل مؤسستك طلبًا محليًا لكي تتمكّن من تثبيت أدوات Yum.

  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.19.01.tar.gz

    سيؤدي هذا الأمر الذي أدخلته إلى إنشاء دليل جديد باسم repos في الدليل الذي يحتوي على الملف .tar. مثال: /tmp/repos.

  11. ثبِّت أداة خدمات واجهة برمجة التطبيقات Edge apigee من /tmp/repos: 
    sudo bash /tmp/repos/bootstrap_4.19.01.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

للتثبيت من المنصات باستخدام خادم الويب 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. يتطلب أمر الإعادة تلقائيًا إدخال username:password: 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.19.01.sh إلى /tmp/bootstrap_4.19.01.sh: 
    curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

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

  9. في العقدة البعيدة، ثبِّت أداة Edge apigee-service والملحقات التابعة لها: 
    sudo bash /tmp/bootstrap_4.19.01.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.19.01.sh، ثم إجراء مزامنة جديدة.

لتعديل طلب الشراء:

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

إضافة أو تحديث Edge 4.16.0x/4.17.0x في إعادة إرسال 4.19.01

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

لإضافة 4.16.0x/4.17.0x إلى مرة 4.19.01:

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

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

    apigee-mirror-4.19.01-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.01.sh
bootstrap_4.18.05.sh
bootstrap_4.19.01.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 من ملف repo أو ملف .tar المحلي، ما عليك سوى التأكّد من تشغيل ملف التشغيل الصحيح. باستخدام أحد الأوامر التالية. يؤدي هذا المثال إلى تثبيت Edge 4.17.01:

  • في حال التثبيت من ملف .tar، شغِّل ملف تشغيل النظام الصحيح من الجهاز المُجدَّد:
    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 على الويب" أعلاه.