لتثبيت Edge على عقدة، عليك أولاً تثبيت الأداة المساعدة Edge apigee-setup. إذا كنت في بيئة لا تتوفّر فيها إمكانية اتصال العقد بالإنترنت الخارجي، عليك أيضًا تثبيت نسخة محلية من مستودع Apigee.
دليل التثبيت التلقائي: /opt/apigee
يُثبِّت Edge جميع الملفات في الدليل /opt/apigee
. ولا يمكنك تغيير هذا الدليل. ومع ذلك، يمكنك إنشاء رابط رمزي لربط /opt/apigee
بموقع آخر إذا أردت ذلك. اطّلِع على متطلبات التثبيت للحصول على مزيد من المعلومات.
الشرط المسبق: إيقاف SELinux
يجب إيقاف SELinux أو ضبطه على الوضع المرخّص قبل أن تتمكّن من تثبيت أداة apigee-setup
Edge
أو أيّ مكوّنات من Edge. بعد تثبيت Edge، يمكنك إعادة تفعيل SELinux إذا لزم الأمر.
- افتح "
/etc/sysconfig/selinux
" في محرِّر. - ضبط
SELINUX=disabled
أوSELINUX=permissive
- احفظ التعديلات.
- أعِد تشغيل العقدة.
- إذا لزم الأمر، أعِد تفعيل SELinux بعد تثبيت Edge من خلال تكرار هذا الإجراء لتحديد
SELINUX=enabled
.
الشرط الأساسي: تفعيل مستودع EPEL
يجب تفعيل حِزم إضافية لنظام التشغيل 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
- تفعيل الحزم الإضافية
لنظام التشغيل Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
- أوقِف Postgres وNginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- فعِّل حِزم إضافية لنظام التشغيل Enterprise Linux (EPEL):
sudo dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
- أوقِف Postgres وNginx:
sudo dnf module disable postgresql
sudo dnf module disable nginx
- احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك username:password حالي لموقع Apigee ftp، يمكنك استخدام بيانات الاعتماد التالية:
- سجِّل الدخول إلى عقدتك باستخدام حساب الجذر لتثبيت حِزم RPM الخاصة بتطبيق Edge.
- إيقاف SELinux.
- فعِّل مستودع EPEL.
- إذا كنت بصدد التثبيت على RHEL 9/Rocky 9/Oracle 9، اتّبِع الخطوات الواردة في المتطلبات الأساسية لنظام التشغيل RHEL 9/Rocky 9/Oracle 9.
- نزِّل ملف Edge
bootstrap_4.53.00.sh
إلى/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- ثبِّت أداة apigee-service وتبعياتها في Edge:
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذان تلقّيتَهما من Apigee. في حال حذف pWord، سيُطلب منك إدخاله.
يتحقّق برنامج التثبيت تلقائيًا من تثبيت Java 1.8. وإذا لم تفعل ذلك، سيثبِّته نيابةً عنك. استخدِم الخيار
JAVA_FIX
لتحديد كيفية التعامل مع تثبيت Java.JAVA_FIX
يمكن أن تأخذ القيمة التالية:- 1: تثبيت 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*'
- استخدم apigee-service لتثبيت الأداة المساعدة apigee-setup:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- استخدِم apigee-setup لتثبيت مكوّنات Edge وضبطها على العقدة. راجع تثبيت مكونات Edge على عقدة لمعرفة المزيد.
- إضافة إعدادات خادم وكيل HTTP في
/etc/yum.conf
- إضافة إعدادات خادم وكيل HTTP العام في
/etc/environment
- مستودع Apigee Edge: كما هو موضّح في إنشاء مستودع Apigee محلي.
- الحزم الإضافية لنظام التشغيل Enterprise Linux (أو EPEL): من المفترض أن يكون فريق العمليات قادرًا على إعداد هذه الحزم نيابةً عنك.
- احصل على اسم المستخدم وكلمة المرور من Apigee اللذَين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك اسم مستخدم وكلمة مرور حاليَين لموقع Apigee ftp الإلكتروني، يمكنك استخدام هذين الاسمَين وكلمة المرور.
- سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
- أوقِف SELinux كما هو موضّح أعلاه.
- نزِّل ملف
bootstrap_4.53.00.sh
في Edge إلى/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- ثبِّت أداة apigee-service وتبعياتها في Edge:
sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذان تلقّيتَهما من Apigee. في حال حذف pWord، سيُطلب منك إدخاله.
- ثبِّت الأداة
apigee-mirror
على العقدة:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror install
- استخدِم الأداة
apigee-mirror
لمزامنة مستودع Apigee مع الدليل/opt/apigee/data/apigee-mirror/repos/
.لتقليل حجم المستودع، أدرِج
--only-new-rpms
لتنزيل أحدث حِزم RPM فقط. -
(اختياري) إذا كنت تريد تثبيت Edge من المستودع المحلي على الشدَّة
نفسها التي تستضيف المستودع المحلي، عليك أولاً تنفيذ الأوامر التالية:
- يمكنك تشغيل
bootstrap_4.53.00.sh
من المستودع المحلي لتثبيت أداةapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/opt/apigee/data/apigee-mirror/repos
- استخدم
apigee-service
لتثبيت الأداةapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- استخدِم
apigee-setup
لتثبيت مكوّنات Edge وضبطها على العقدة. اطّلِع على مقالة تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.
- يمكنك تشغيل
- أنشئ ملف .tar من المستودع، وانسخ ملف .tar إلى عقدة، ثم ثبِّت Edge من ملف .tar.
- تثبيت خادم ويب على العقدة مع المستودع المحلي بحيث يمكن للعقد الأخرى الوصول إليه. توفّر Apigee خادم الويب Nginx لاستخدامك، أو يمكنك استخدام خادم الويب الخاص بك.
- على العقدة التي تتضمّن المستودع المحلي، استخدِم الأمر التالي لحزمة المستودع المحلي في
ملف tar .واحد باسم
/opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- انسخ ملف .tar إلى العقدة التي تريد تثبيت Edge عليها. على سبيل المثال، انسخها إلى الدليل
/tmp
في العقدة الجديدة. - في العقدة الجديدة، أوقِف SELinux كما هو موضّح أعلاه.
- في العقدة الجديدة، تأكَّد من إمكانية وصولك إلى مستودع خدمات Yum المحلي ومستودع EPEL.
- يُرجى التحقّق من أنّه تم إيقاف جميع مستودعات الإنترنت الخارجية (من المفترض أن يكون ذلك بسبب تثبيت الجهاز على جهاز غير متصل بالإنترنت):
sudo yum repolist
يجب إيقاف جميع المستودعات الخارجية، ولكن يجب تفعيل مستودع Apigee المحلي ومستودعاتك الداخلية.
- استخدم
apigee-service
لتثبيت الأداةapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- استخدِم
apigee-setup
لتثبيت مكونات Edge وإعدادها على العقدة. اطّلِع على مقالة تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات. - ثبِّت خادم الويب Nginx على عقدة المستودع:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror nginxconfig
- يتم ضبط Nginx تلقائيًا على استخدام المضيف المحلي كاسم للخادم ومنفذ 3939. ل
تغيير هذه القيم:
- افتح
/opt/apigee/customer/application/mirror.properties
في محرِّر. أنشئ الملف إذا لم يكن متوفّرًا. - اضبط القيم التالية حسب الضرورة:
conf_apigee_mirror_listen_port=3939 conf_apigee_mirror_server_name=localhost
- أعد تشغيل Nginx:
/opt/nginx/scripts/apigee-nginx restart
- افتح
- يتطلّب المستودع تلقائيًا اسم مستخدم:كلمة مرور
admin:admin
. لتغيير بيانات الاعتماد هذه، اضبط متغيّرات البيئة التالية:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- في العقدة الجديدة، تأكَّد من تفعيل مستودع EPEL على الجهاز.
- في العقدة الجديدة، تحقّق من إصدار
libdb4
كما هو موضّح أعلاه. - في العقدة البعيدة، ثبِّت أداة
apigee-service
وتبعياتها في Edge:sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
حيث يشير uName:pWord إلى اسم المستخدم وكلمة المرور في Repo.
- على العقدة البعيدة، استخدِم
apigee-service
لتثبيت الأداةapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- يمكنك استخدام
apigee-setup
لتثبيت مكونات Edge وضبطها على العقدة البعيدة. اطّلِع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات. - نزّل ملف Bootstrap_4.53.00.sh على Edge إلى
/tmp/bootstrap_4.53.00.sh
:curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- تشغيل ملف Edge
bootstrap_4.53.00.sh
:sudo bash/tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
حيث يكون uName:pWord هو اسم المستخدم وكلمة المرور اللذان تلقّيتَهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخاله.
- تعديل
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror update
- تنفيذ المزامنة:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync --only-new-rpms
- إذا أردت استخدام المستودع بأكمله:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror sync
المتطلبات الأساسية لنظام التشغيل RHEL 8/Rocky 8/Oracle 8
إذا كنت بصدد تثبيت Edge على خادم يعمل بنظام التشغيل Red Hat Enterprise Linux (RHEL) 8، عليك تنفيذ الخطوات التالية قبل إجراء عملية التثبيت:
المتطلّبات الأساسية لنظام التشغيل RHEL 9/Rocky 9/Oracle 9
إذا كنت بصدد تثبيت Edge على خادم يعمل بنظام التشغيل Red Hat Enterprise Linux (RHEL) 9 أو Rocky 9 أو Oracle 9، أكمِل الخطوات التالية قبل إجراء عملية التثبيت:
للتعرّف على تغييرات التثبيت المسبق لـ PostgreSQL وLDAP، يُرجى الاطّلاع على متطلبات التثبيت المسبق لقاعدة بيانات PostgreSQL والتغييرات على عمليات التثبيت المُسبَق للإصدار 2.4 من OpenLDAP، على التوالي.
تثبيت أداة إعداد واجهة برمجة التطبيقات Edge على 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. |
مشاكل الاتصال | اختبِر اتصالك بالشبكة من خلال تنفيذ الأمر nc -v software.apigee.com 443 من المفترض أن تظهر لك رسالة مشابهة لما يلي: Connection to software.apigee.com 443 port [tcp/https] succeeded! إذا لم يكن 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
بالنسبة إلى خادم وكيل HTTP للخروج، يجب استخدام أحد الخيارَين التاليَين: |
تثبيت Edge أداة apigee-setup على عقدة لا تتضمّن اتصالاً خارجيًا بالإنترنت
إذا كانت عقد Edge خلف جدار حماية أو محظورة بطريقة أخرى من الوصول إلى الإنترنت، عليك إنشاء عدة مستودعات أو نُسخ مطابقة تحتوي على الملفات التي تحتاج إليها أثناء التثبيت. يجب أن تكون هذه النُسخ المطابقة متاحة بعد ذلك لجميع العقد. بعد إنشاء العقد، يمكنها بعد ذلك الوصول إلى هذه النُسخ المطابقة المحلية لتثبيت Edge.
تتطلّب عملية تثبيت Apigee Edge للعقد التي لا تتوفّر فيها اتصالات بالإنترنت الوصول إلى المستودعات المحلية التالية:
إنشاء مستودع Apigee على الجهاز
لإنشاء مستودع Apigee الداخلي، ستحتاج إلى عقدة تتضمّن إمكانية الوصول إلى الإنترنت الخارجي لتتمكّن من تنزيل حِزم RPM ومستلزمات Edge. بعد إنشاء المستودع الداخلي، يمكنك نقله إلى عقدة أخرى أو إتاحة الوصول إلى عُقد Edge من أجل تثبيتها.
بعد إنشاء مستودع Apigee محلي، قد تحتاج لاحقًا إلى تعديله باستخدام أحدث ملفّات إصدار Edge. توضّح الأقسام التالية كيفية إنشاء مستودع Apigee محلي وكيفية تعديله.
لإنشاء مستودع Apigee محلي:
تثبيت apigee-setup على عقدة بعيدة من المستودع المحلي
يتوفّر لك خياران لتثبيت Edge من المستودع المحلي. يمكنك تنفيذ إجراء مما يلي:
التثبيت من ملف .tar
لتثبيت البرنامج من ملف .tar:
التثبيت من المستودع باستخدام خادم ويب Nginx
للتثبيت من المستودع باستخدام خادم ويب Nginx:
تعديل مستودع Apigee على الجهاز
لتحديث المستودع، يجب تنزيل أحدث ملف Bootstrap_4.53.00.sh ثم إجراء مزامنة جديدة.
لتعديل المستودع:
تنظيف مستودع Apigee محلي
يؤدي تنظيف المستودع المحلي إلى حذف /opt/apigee/data/apigee-mirror و /var/tmp/yum-apigee-*.
لتنظيف المستودع المحلي، استخدِم:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean