لتثبيت Edge على عقدة، عليك أولاً تثبيت أداة Edge apigee-setup. إذا كنت في بيئة لا تتوفّر فيها عقدك على اتصال خارجي بالإنترنت، عليك أيضًا تثبيت نسخة محلية من مستودع Apigee.
دليل التثبيت التلقائي: /opt/apigee
تثبِّت Edge جميع الملفات في الدليل /opt/apigee
. ولا يمكنك تغيير هذا الدليل. ومع ذلك، يمكنك إنشاء رابط رمزي لربط /opt/apigee
بموقع آخر إذا أردت ذلك. لمزيد من المعلومات، يمكنك الاطّلاع على متطلبات التثبيت.
شرط أساسي: إيقاف SELinux
يجب إيقاف SELinux أو ضبطه على وضع التساهل قبل أن تتمكّن من تثبيت أداة Edge
apigee-setup
أو أي من مكونات Edge. إذا لزم الأمر، يمكنك إعادة تفعيل SELinux بعد تثبيت Edge.
- افتح
/etc/sysconfig/selinux
في محرّر. - ضبط
SELINUX=disabled
أوSELINUX=permissive
- احفظ التعديلات.
- أعِد تشغيل العقدة.
- إذا لزم الأمر، أعِد تفعيل SELinux بعد تثبيت Edge من خلال تكرار هذا الإجراء لضبط
SELINUX=enabled
.
المتطلبات الأساسية: تفعيل مستودع EPEL
يجب تفعيل حزمة Extra Packages for Enterprise 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
- فعِّل Extra Packages for
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
- فعِّل حزمة Extra Packages for 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، يمكنك استخدام بيانات الاعتماد هذه.
- سجِّل الدخول إلى العقدة بصفتك مستخدمًا رئيسيًا لتثبيت حِزم Edge RPM
- أوقِف SELinux.
- فعِّل مستودع EPEL.
- إذا كنت تثبّت البرنامج على RHEL 9 أو Rocky 9 أو Oracle 9، اتّبِع الخطوات الواردة في المتطلبات الأساسية لنظام التشغيل RHEL 9 أو Rocky 9 أو Oracle 9.
- نزِّل ملف Edge
bootstrap_4.53.01.sh
إلى/tmp/bootstrap_4.53.01.sh
:curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
- ثبِّت أداة Edge apigee-service والملفات التابعة لها:
sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord
حيث يمثّل uName:pWord اسم المستخدم وكلمة المرور اللذين تلقّيتهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخاله.
يتحقّق المثبِّت تلقائيًا من تثبيت الإصدار 1.8 من Java. وإذا لم يكن مثبّتًا، سيتم تثبيته تلقائيًا. استخدِم الخيار
JAVA_FIX
لتحديد كيفية التعامل مع عملية تثبيت Java. تتضمّن السمةJAVA_FIX
القيم التالية:- I: تثبيت 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 محلي
- Extra Packages for Enterprise Linux (أو EPEL): يجب أن يتمكّن فريق العمليات لديك من إعداد ذلك لك.
- احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك اسم مستخدم وكلمة مرور حاليان لموقع Apigee ftp، يمكنك استخدام بيانات الاعتماد هذه.
- سجِّل الدخول إلى العقدة بصفتك مستخدمًا رئيسيًا لتثبيت حِزم Edge RPM.
- أوقِف SELinux كما هو موضّح أعلاه.
- نزِّل ملف Edge
bootstrap_4.53.01.sh
إلى/tmp/bootstrap_4.53.01.sh
:curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
- ثبِّت أداة Edge apigee-service والمكونات التابعة لها:
sudo bash /tmp/bootstrap_4.53.01.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.01.sh
من المستودع المحلي لتثبيت الأداة المساعدةapigee-service
:sudo bash /opt/apigee/data/apigee-mirror/repos/bootstrap_4.53.01.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.01.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 لاستخدام localhost كاسم الخادم والمنفذ 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
كما هو موضّح أعلاه. - على العُقدة البعيدة، ثبِّت أداة Edge
apigee-service
والتبعيات:sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
حيث يمثّل uName:pWord اسم مستخدم المستودع وكلمة المرور.
- على العُقدة البعيدة، استخدِم
apigee-service
لتثبيت الأداة المساعدةapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- استخدِم
apigee-setup
لتثبيت مكوّنات Edge وإعدادها على العقدة البعيدة. لمزيد من المعلومات، اطّلِع على تثبيت مكوّنات Edge على عُقدة. - نزِّل ملف Edge bootstrap_4.53.01.sh إلى
/tmp/bootstrap_4.53.01.sh
:curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
- نفِّذ ملف Edge
bootstrap_4.53.01.sh
:sudo bash/tmp/bootstrap_4.53.01.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 والتغييرات التي يجب إجراؤها قبل تثبيت SymasLDAP 2.6.7 على التوالي.
تثبيت أداة Edge apigee-setup على عقدة متصلة بالإنترنت الخارجي
لتثبيت 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.01.sh ثم إجراء مزامنة جديدة.
لتعديل المستودع:
تنظيف مستودع Apigee محلي
يؤدي تنظيف المستودع المحلي إلى حذف /opt/apigee/data/apigee-mirror و /var/tmp/yum-apigee-*.
لتنظيف المستودع المحلي، استخدِم الأمر التالي:
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror clean