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

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

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

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

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

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

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

• لضبط 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 قبل تثبيته. الحافة تتطلب الإصدار 4.8 وبعض إصدارات RedHat 7.4 وCentOS 7.4 مع الإصدار الأحدث. إذا كان لديك إصدار أحدث، فألغِ تثبيته وستتولى أداة تثبيت Edge ثم تثبيت الإصدار 4.8.

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

> rpm -qa | grep libdb4

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

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

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

1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك كلمة مرور username:password لموقع Apigee ftp، يمكنك استخدام تلك بيانات الاعتماد.
2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPMs.
   ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
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 --تفعيل ol7_optional_latest
8. في حال التثبيت على AWS، شغِّل أوامر yum-configure-manager التالية:
   > تحديث لذيذ rh-amazon-rhui-client.noarch
   > sudo yum-config-manager --enable rhui-Region-rhel-server-extras rhui-REGION-rhel-server-optional
9. نزِّل ملف bootstrap_4.18.01.sh في Edge إلى /tmp/bootstrap_4.18.01.sh:
   . > ضفيرة https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
10. ثبِّت الأداة والتبعيات في خدمة Edge apigee:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
    
    حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذين تلقيتهما منهما Apigee. إذا لم تستخدم pWord، سيُطلب منك إدخاله.
    
    بشكل تلقائي، تتحقّق أداة التثبيت من أنّك مثبّت Java 1.8. إذا لم تقم بذلك، بتثبيتها من أجلك. استخدِم الخيار JAVA_FIX لتحديد كيفية التعامل. تثبيت Java. JAVA_FIX على القيم التالية:
    
    I = تثبيت OpenJDK 1.8 (تلقائي)
    C = المتابعة بدون تثبيت Java
    Q = إنهاء. لتنفيذ هذا الخيار، يجب تثبيت Java بنفسك.
    
    يؤدي تثبيت الأداة المساعدة apigee-service إلى إنشاء الملف /etc/yum.repos.d/apigee.repo التي تعرِّف مستودع Apigee. للاطّلاع على ملف التعريف، استخدِم الأمر:
    > قطة /etc/yum.repos.d/apigee.repo
    
    لعرض محتوى 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 على عقدة بدون اتصال خارجي بالإنترنت

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

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

ملاحظة: لا تستضيف Apigee جميع الموارد التابعة لجهات خارجية في المتاحة للجميع المستودعات. يجب تنزيل هذه التبعيات وتثبيتها من قائمة يمكن للجميع الوصول إليها المستودعات.

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

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

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

1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك كلمة مرور username:password لموقع Apigee ftp، يمكنك استخدام تلك بيانات الاعتماد.
2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
   ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
3. عطِّل SELinux كما هو موضح أعلاه.
4. نزِّل ملف bootstrap_4.18.01.sh في Edge إلى /tmp/bootstrap_4.18.01.sh:
   . > ضفيرة https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
5. ثبِّت الأداة والتبعيات في خدمة Edge apigee:
   > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
   
   حيث تمثّل uName:pWord اسم المستخدم وكلمة المرور اللذين تلقّيتهما من خلالهما Apigee. إذا لم تستخدم pWord، سيُطلب منك إدخاله.
6. تثبيت apigee-mirror أداة على العقدة:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror install
   
   ملاحظة: في حال تحديث مستودع حالي إلى 4.18.01، ما عليك سوى تحديثه. apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
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
   
   إذا كنت تريد تنزيل المستودع بأكمله، بما في ذلك الأرباح القديمة لكل ألف مشاهدة، احذف --only-new-rpms. أنت بحاجة إلى 6 أجهزة تقريبًا غيغابايت من مساحة القرص للتنزيل الكامل:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror Sync
   
   لديك الآن نسخة محلية من مستودع Apigee. يصف القسم التالي كيفية تثبيت أداة apigee-setup من Edge من المستودع المحلي.
8. (اختياري) إذا كنت تريد تثبيت Edge من المستودع المحلي على العقدة التي تستضيف المستودع المحلي، فأنت بحاجة أولاً إلى تشغيل الأوامر التالية:
   1. شغِّل bootstrap_4.18.01.sh من الجهاز. Repo لتثبيت أداة apigee-service:
      > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.18.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:

1. في العقدة التي تضم الموارد المحلية، استخدم الأمر التالي لوضع حزمة repo المحلية في ملف .tar واحد باسم /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. انسخ ملف .tar إلى العقدة التي تريد تثبيت Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp على الإصدار الجديد العقدة.
3. في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
4. على العقدة الجديدة، فعِّل Repo كما هو موضَّح أعلاه.
5. في العقدة الجديدة، تأكَّد من إيقاف أي مستودعات إنترنت خارجية. عند تشغيل الأمر التالي، يُفترض أن تظهر جميع المستودعات الخارجية على أنها معطلة، ولكن يجب تفعيل مستودع Apigee المحلي وأي من المستودعات الداخلية:
   > sudo موقع yum repolist
6. في العقدة الجديدة، ثبِّت yum-utils وyum-plugin-priorities:
   > sudo yum تثبيت 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 --تفعيل rhui-Region-rhel-server-extras rhui- وبذلك-rhel-server-OPTIONAL
10. في العقدة الجديدة، عليك إلغاء تنزيل الملف في دليل /tmp:
    > tar -xzf apigee-4.18.01.tar.gz
    
    يؤدي هذا الأمر إلى إنشاء دليل جديد، يسمى repos، في الدليل الذي يحتوي على ملف .tar. على سبيل المثال: /tmp/repos.
11. ثبِّت أداة خدمة Edge apigee والتبعيات من /tmp/repos:
    > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
    
    لاحظ أنك قمت بتضمين المسار إلى دليل repos في هذا الأمر.
12. استخدِم apigee-service من أجل: تثبيت apigee-setup شركة الطاقة:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
13. استخدام apigee-setup للتثبيت وإعداد مكونات Edge على العقدة. راجع تثبيت مكونات Edge على عقدة لمعرفة المزيد.

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

1. ثبِّت خادم ويب Nginx على عقدة repo:
   > 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 إعادة تشغيل
3. بشكل تلقائي، يتطلب المستودع (repo) اسم المستخدِم:كلمة المرور لـ admin:admin. لتغيير بيانات الاعتماد هذه، إعداد متغيّرات البيئة التالية:
   MIRROR_USERNAME=uName
   MIRROR_PASSWORD=pWord
4. في العقدة الجديدة، ثبِّت yum-utils وyum-plugin-priorities:
   > sudo yum تثبيت yum-utils
   > sudo yum install yum-plugin-priorities
5. في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
6. على العقدة الجديدة، فعِّل Repo كما هو موضَّح أعلاه.
7. في العقدة الجديدة، تحقق من إصدار libdb4 كما هو موضح أعلاه.
8. في العقدة البعيدة، نزِّل ملف Edge Bootstrap_4.18.01.sh على /tmp/bootstrap_4.18.01.sh:
   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
   
   حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور اللذين حددتهما أعلاه في والمستودع remoteRepo هو عنوان IP أو اسم نظام أسماء النطاقات للمستودع. العقدة.
9. في العقدة البعيدة، عليك تثبيت أداة خدمة واجهة برمجة التطبيقات Edge والتبعيات:
   > sudo bash /tmp/bootstrap_4.18.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.18.01.sh، ثم إجراء عملية إنشاء sysnc:

1. نزِّل ملف Bootstrap_4.18.01.sh على Edge إلى /tmp/bootstrap_4.18.01.sh:
   > ضفيرة https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
2. شغِّل ملف bootstrap_4.18.01.sh على Edge:
   . > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord
   
   حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذين المستلَمة من Apigee. إذا لم تستخدم pWord، سيُطلب منك وإدخاله.
3. تعديل apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror
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.01

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

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

1. يُرجى التأكّد من تثبيت الإصدار 4.18.01 من الأداة apigee-mirror:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-Mirror Edition
   
   من المفترض أن تظهر لك نتيجة في النموذج أدناه، حيث يكون xyz هو الإصدار الرقم:
   apigee-mirror-4.18.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--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.shbootstrap_4.17.09.sh bootstrap_4.18.01.sh.
   
   لاحظ كيف لديك ملف تمهيد لجميع إصدارات Edge. يحتوي الدليل apigee أيضًا على علامات منفصلة لكل إصدار من Edge.
4. لوضع حزمة repo في ملف .tar، استخدِم الأمر التالي:
   > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service حزمة apigee-mirror
   
   يقوم هذا الأمر بحزم جميع المستودعات 4.17.0x و4.16.0x في نفس ملف .tar. لا يمكنك حزمة جزء فقط من المستودع.