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

Edge for Private Cloud، الإصدار 4.17.09

لتثبيت 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 مع الإصدار الأحدث.

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

> rpm -qa | grep libdb

إذا رأيت أنّ إصدار libdb4 العائد لكل ألف ظهور أحدث من الإصدار 4.8، استخدِم التالي لاستبدال RPM:

> rpm -Uvh --oldpackage libdb4-cxx-4.8.30-13.el7.x86_64.rpm libdb4-4.8.30-13.el7.x86_64.rpm

إذا كان عليك تنزيل هذه الأرباح لكل ألف مشاهدة (RPM)، يمكنك الحصول عليها من:

• http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-cxx-4.8.30-13.el7.x86_64.rpm
• http://dl.fedoraproject.org/pub/epel/7/x86_64/Packages/l/libdb4-4.8.30-13.el7.x86_64.rpm

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

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

1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك كلمة مرور username:password لموقع Apigee ftp، يمكنك استخدام تلك بيانات الاعتماد.
2. سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPMs.
3. تثبيت yum-utils وyum-plugin-priorities:

   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities

4. عطِّل SELinux كما هو موضح أعلاه.
5. تفعيل مستودع EPEL كما هو موضح أعلاه.
6. في حال التثبيت باستخدام AWS، شغِّل أمر yum-configure-manager التالي:

   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

7. تنزيل ملف Edge bootstrap_4.17.09.sh إلى /tmp/bootstrap_4.17.09.sh:

   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

8. ثبّت الأداة المساعدة والتبعيات لخدمة Edge apigee:

   > sudo bash /tmp/bootstrap_4.17.09.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. لعرض ملف التعريف، استخدِم الأمر:

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

   لعرض محتوى Repo، استخدِم الأمر:

   > sudo yum -v repolist 'apigee*'

9. استخدم apigee-service لتثبيت الأداة apigee-setup:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

10. استخدِم apigee-setup لتثبيت مكونات Edge وإعدادها على العقدة. عرض ثبِّت مكونات Edge على عقدة للحصول على المزيد من المعلومات.

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

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

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

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

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

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

1. احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك كلمة مرور username:password لموقع 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. في حال التثبيت باستخدام AWS، يُرجى تشغيل ما يلي: الأمر yum-configure-manager:
   

   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

7. تنزيل ملف Edge bootstrap_4.17.09.sh إلى /tmp/bootstrap_4.17.09.sh:

   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

8. تثبيت أداة Edge apigee-service والتبعيات:

   > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

9. ثبِّت الأداة المساعدة apigee-mirror على العقدة:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror install

10. استخدِم أداة 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. يصف القسم التالي كيفية تثبيت أداة Edge apigee-setup من المستودع المحلي.

11. (اختياري) إذا كنت تريد تثبيت Edge من المستودع المحلي على العقدة التي تستضيف المستودع المحلي، فأنت بحاجة أولاً إلى تشغيل الأوامر التالية:
    1. شغِّل bootstrap_4.17.09.sh من المستودع المحلي لتثبيت أداة apigee-service:

       > sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.17.09.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.17.09.tar.gz:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

2. انسخ ملف .tar إلى العقدة التي تريد تثبيت Edge فيها. على سبيل المثال، انسخه إلى دليل /tmp على العقدة الجديدة.
3. تثبيت yum-utils وyum-plugin-priorities:

   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities

4. في العقدة الجديدة، عطِّل SELinux كما هو موضح أعلاه.
5. تفعيل مستودع EPEL كما هو موضح أعلاه.
6. في العقدة الجديدة، عليك إلغاء تنزيل الملف في دليل /tmp:
   

   > tar -xzf apigee-4.17.09.tar.gz

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

7. ثبّت أداة خدمة Edge apigee والتبعيات من /tmp/repos:

   > sudo bash /tmp/repos/bootstrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

8. استخدام apigee-service من أجل تَثْبِيتْ apigee-setup فائدة:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

9. استخدام 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 restart

3. بشكل تلقائي، يتطلّب المستودع الإعلاني (repo) اسم المستخدم:كلمة المرور 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. في العقدة البعيدة، نزّل ملف Edge Bootstrap_4.17.09.sh على /tmp/bootstrap_4.17.09.sh:

   > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

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

8. في العقدة البعيدة، ثبِّت أداة Edge apigee-service والتبعيات:

   > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName
     apigeepassword=pWord apigeeprotocol=http://

   حيث يمثّل uName:pWord اسم المستخدم وكلمة المرور الخاصَين بالمستودع.

9. في العقدة البعيدة، استخدِم apigee-service لتثبيت الأداة apigee-setup:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

10. يمكنك استخدام apigee-setup لتثبيت مكونات Edge وإعدادها على العقدة البعيدة. عرض ثبِّت مكونات Edge على عقدة للحصول على المزيد من المعلومات.

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

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

1. تنزيل ملف Bootstrap_4.17.09.sh على Edge إلى /tmp/bootstrap_4.17.09.sh:

   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh

2. شغّل ملف Edge bootstrap_4.17.09.sh:

   > sudo bash /tmp/bootstrap_4.17.09.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.17.09

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

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

1. تأكد من تثبيت الإصدار 4.17.09 من الأداة المساعدة apigee-mirror:

   > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror version

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

   apigee-mirror-4.17.09-0.0.xyz

2. استخدام apigee-mirror لتنزيل Edge 4.16.0x/4.17.01/4.17/05 إلى المستودع. لاحظ كيف تضع بادئة مع الإصدار المطلوب:

   > apigeereleasever=4.17.01 /opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms

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

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
   thirdparty

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

4. لوضع حزمة repo في ملف .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" أعلاه.