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 مؤقتًا على الوضع "السماح"، نفِّذ الأمر التالي:
- على نظام التشغيل Linux 6.x:
sudo echo 0 > /selinux/enforce
لإعادة تفعيل SELinux بعد تثبيت Edge:
sudo echo 1 > /selinux/enforce
- على نظام التشغيل Linux 7.x:
sudo setenforce 0
لإعادة تفعيل SELinux بعد تثبيت Edge:
sudo setenforce 1
- على نظام التشغيل Linux 6.x:
- لإيقاف SELinux بشكل دائم أو ضبطه على الوضع "تساهل":
- افتح
/etc/sysconfig/selinux
في محرِّر. - ضبط
SELINUX=disabled
أوSELINUX=permissive
- احفظ التعديلات.
- أعِد تشغيل العقدة.
- إذا لزم الأمر، يمكنك إعادة تفعيل 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 على عقدة متصلة بالإنترنت خارجيًا:
- احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك username:password حالية لموقع بروتوكول النقل الآمن للملفات (SFTP) الخاص بـ Apigee، يمكنك استخدام بيانات الاعتماد هذه.
- سجِّل الدخول إلى العقدة كجذر لتثبيت RPM RPM
- تثبيت
yum-utils
وyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- أوقف SELinux كما هو موضّح أعلاه.
- فعِّل إعادة تشغيل EPEL كما هو موضّح أعلاه.
- تحقَّق من إصدار
libdb4
كما هو موضّح أعلاه. - في حال التثبيت على Oracle 7.x، شغِّل الأمر التالي:
sudo yum-config-manager --enable ol7_optional_latest
- في حال التثبيت على 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
- نزِّل ملف 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
- ثبِّت الأداة المساعدة والملحقات التابعة لخدمة 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*'
- استخدم apigee-service لتثبيت الأداة المساعدة لإعداد apigee:
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- يمكنك استخدام إعداد apigee لتثبيت مكوّنات Edge على العقدة وضبطها. يمكنك الاطّلاع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.
تثبيت الأداة المساعدة لإعداد apigee على عقدة بدون اتصال بالإنترنت خارجي
إذا كانت عُقد Edge خلف جدار ناري، أو كانت محظورة بطريقة أخرى عن الوصول إلى الإنترنت، عليك إنشاء عدة مستودعات أو مرايا تحتوي على ملفات ستحتاج إليها أثناء التثبيت. بعد ذلك، يجب أن تكون جميع المرايا متاحة للوصول إلى جميع العُقد. بعد إنشاء العُقد، يمكنها الوصول إلى هذه المرايا المحلية لتثبيت Edge.
إنّ عملية تثبيت Apigee Edge للعُقَد التي لا تحتوي على اتصالات بالإنترنت تتطلب الوصول إلى المفروشات المحلية التالية:
- Apigee Edge repo: كما هو موضّح في إنشاء مستودع Apigee محلي.
- Yup repo (لبرامج الخدمات مثل
yum-utils
وyum-plugin-priorities
): يجب أن يكون بإمكان فريق العمليات إعداد هذه الميزة لك. - حزمة إضافية لإصدار Linux Enterprise (أو EPEL): يجب أن يكون بإمكان فريق العمليات إعداد هذه الميزة لك.
إنشاء مستودع محلي من Apigee
لإنشاء مستودع Apigee الداخلي، ستحتاج إلى عقدة مزوَّدة بإذن وصول خارجي إلى الإنترنت لتتمكن من تنزيل العائد لكل ألف ظهور والاعتماديات على Edge. بعد إنشاء الملخّص الداخلي، يمكنك نقله إلى عقدة أخرى أو إتاحة إمكانية الوصول إلى هذه العُقدة لتثبيت Edge.
بعد إنشاء مستودع Apigee محلي، قد تحتاج إلى تعديله لاحقًا بأحدث ملفات إصدار Edge. توضّح الأقسام التالية كيفية إنشاء مستودع Apigee محلي وكيفية تعديله.
لإنشاء طلب محلي على Apigee:
- احصل على اسم المستخدم وكلمة المرور من Apigee اللذين تستخدمهما للوصول إلى مستودع Apigee. إذا كان لديك اسم مستخدم حالي:password لموقع ftp Apigee، يمكنك استخدام بيانات الاعتماد هذه.
- سجّل الدخول إلى العقدة كجذر لتثبيت RPM RPM.
- أوقف SELinux كما هو موضّح أعلاه.
- نزِّل ملف 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
- ثبِّت الأداة المساعدة والملحقات ذات الصلة بخدمة Edge apigee:
sudo bash /tmp/bootstrap_4.19.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
لتنزيل أحدث الأرباح لكل ألف مشاهدة فقط. تحتاج إلى مساحة تبلغ 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 المحلي. -
(اختياري) إذا كنت تريد تثبيت Edge من طلب الشراء المحلي على العُقدة نفسها التي تستضيف الطلب المحلي، عليك أولاً تنفيذ الأوامر التالية:
- تشغيل
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
- استخدم
apigee-service
لتثبيت أداةapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- يمكنك استخدام
apigee-setup
لتثبيت مكوّنات Edge على العقدة وضبطها. يمكنك الاطّلاع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.
- تشغيل
تثبيت إعداد apigee في عقدة بعيدة من طلب الشراء المحلي
لديك خياران لتثبيت تطبيق Edge من ميزة "إعادة الشراء المحلية". يمكنك تنفيذ إجراء مما يلي:
- أنشئ ملفًا بالامتداد .tar من هذا التقرير، وانسخ ملف .tar إلى عقدة، ثم ثبِّت Edge من ملف .tar.
- تثبيت خادم ويب على العقدة باستخدام ميزة Repo المحلية حتى تتمكن العُقد الأخرى من الوصول إليه. يوفر Apigee خادم الويب Nginx لك لاستخدامه، أو يمكنك استخدام خادم الويب.
التثبيت من ملف .tar
للتثبيت من ملف .tar:
- في العقدة التي تضمّ طلب محلي، استخدِم الأمر التالي لتجميع الطلب المحلي في
ملف واحد بتنسيق .tar باسم
/opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- انسخ ملف .tar إلى العقدة التي تريد تثبيت Edge فيها. على سبيل المثال، انسخه إلى الدليل
/tmp
في العقدة الجديدة. - في العقدة الجديدة، أوقِف SELinux كما هو موضح أعلاه.
- في العُقدة الجديدة، تأكّد من إمكانية الوصول إلى مستودع Remup المحلي وYel.
- يُرجى التحقّق جيدًا من أنّ كل الأجهزة المستخدَمة لتوفير الاتصال بالإنترنت الخارجي غير مفعَّلة (يجوز أن يكون ذلك بسبب تثبيت جهازك على جهاز غير متّصل بالإنترنت):
sudo yum repolist
يجب إيقاف جميع عمليات إعادة البيع الخارجية، ولكن يجب تفعيل إعادة الطلب في Apigee المحلية وعمليات إعادة البيع الداخلية.
- في العقدة الجديدة، ثبِّت
yum-utils
وyum-plugin-priorities
من التسجيل المحلي:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
يجب أن يُعِدّ فريق العمليات أو أي مجموعة أخرى داخل مؤسستك طلبًا محليًا لكي تتمكّن من تثبيت أدوات Yum.
- في العقدة الجديدة، تحقق من إصدار
libdb4
كما هو موضّح أعلاه. - في حال التثبيت على Oracle 7.x، شغِّل الأمر التالي:
sudo yum-config-manager --enable ol7_optional_latest
- في حال التثبيت على AWS، شغِّل الأمر
yum-configure-manager
التالي:sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
- في العقدة الجديدة، أزِل الملف إلى الدليل /tmp:
tar -xzf apigee-4.19.01.tar.gz
سيؤدي هذا الأمر الذي أدخلته إلى إنشاء دليل جديد باسم repos في الدليل الذي يحتوي على الملف .tar. مثال:
/tmp/repos.
- ثبِّت أداة خدمات واجهة برمجة التطبيقات Edge apigee من
/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
يُرجى العِلم أنّ الأمر يتضمّن المسار إلى دليل إعادة البيع في هذا الأمر.
- استخدم
apigee-service
لتثبيت أداةapigee-setup
:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- يمكنك استخدام
apigee-setup
لتثبيت مكوّنات Edge على العقدة وضبطها. يمكنك الاطّلاع على تثبيت مكوّنات Edge على عقدة للحصول على مزيد من المعلومات.
التثبيت من الاسترجاع باستخدام خادم الويب Nginx
للتثبيت من المنصات باستخدام خادم الويب Nginx:
- تثبيت خادم الويب 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
- افتح
- يتطلب أمر الإعادة تلقائيًا إدخال username:password:
admin:admin
. لتغيير بيانات الاعتماد هذه، عليك ضبط متغيّرات البيئة التالية:MIRROR_USERNAME=uName MIRROR_PASSWORD=pWord
- في العقدة الجديدة، ثبِّت
yum-utils
وyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- في العقدة الجديدة، أوقِف SELinux كما هو موضح أعلاه.
- في العقدة الجديدة، تأكد من تفعيل إعادة تفعيل EPEL المحلية.
- في العقدة الجديدة، تحقق من إصدار
libdb4
كما هو موضّح أعلاه. - في العقدة البعيدة، نزِّل ملف 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 أو اسم نظام أسماء النطاقات لعقدة الإعادة.
- في العقدة البعيدة، ثبِّت أداة Edge
apigee-service
والملحقات التابعة لها:sudo bash /tmp/bootstrap_4.19.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 على عقدة للحصول على مزيد من المعلومات.
تعديل مستودع محلي في Apigee
ولتحديث الطلب، يجب تنزيل أحدث ملف bootstrap_4.19.01.sh، ثم إجراء مزامنة جديدة.
لتعديل طلب الشراء:
- نزِّل ملف 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
- شغِّل ملف Edge
bootstrap_4.19.01.sh
:sudo bash/tmp/bootstrap_4.19.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
إزالة تكرار مرة أخرى في 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:
- تأكّد من تثبيت الإصدار 4.19.01 من أداة
apigee-mirror
:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror version
من المفترض أن تظهر لك نتيجة في النموذج أدناه، حيث يمثّل xyz رقم الإصدار:
apigee-mirror-4.19.01-0.0.xyz
- استخدِم الأداة
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 إعادة البيع لاحقًا من خلال تحديد أرقام الإصدارات المطلوبة.
- افحص الدليل
/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. - لإضافة الملف إلى ملف .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 على الويب" أعلاه.