تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

تحديث Apigee Edge 4.17.0x إلى 4.18.01

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

ما هي إصدارات Edge التي يمكنك تحديثها إلى الإصدار 4.18.01؟

يمكنك تحديث الإصدار 4.17.0x من Apigee Edge من خلال هذا الإجراء.

إذا كان لديك إصدار Edge سابق إلى الإصدار 4.16.01، فيجب عليك أولاً الانتقال إلى الإصدار 4.16.01.x ثم التحديث إلى الإصدار 4.18.01.

المستخدمون الذين يمكنهم إجراء التحديث

يجب أن يكون المستخدم الذي ينفِّذ التحديث هو نفسه المستخدم الذي ثبَّت Edge في الأصل أو يعمل المستخدم كجذر.

بعد تثبيت Edge RPM، يمكن لأي مستخدم ضبطه.

المكوّنات التي يجب تحديثها

يجب عليك تحديث جميع مكونات Edge. لا يدعم Edge الإعداد الذي يحتوي على مكونات من إصدارات متعددة.

الحفاظ على التوافق

عند ترقية Apigee Edge for Private Cloud إلى الإصدار 4.18.01، يجب التأكد من أنّ الناتج إلى الخصائص المتوافقة فقط في ملفات الإعداد الخاصة به.

الموقع	الموقع الجغرافي	الوصف
`conf_load_balancing_load.balancing. driver.nginx.server.retry`	`router.properties`	أزِل هذه السمة من ملف `router.properties`. لضبط خيارات إعادة المحاولة في الإصدار 4.18.01، استخدم واجهة برمجة التطبيقات خصائص إعداد المضيف.

النشر التلقائي للموقع الإعدادات

في حال إعداد أي مواقع من خلال تعديل ملفات .properties في .properties عندها يتم الاحتفاظ بالقيم من خلال التحديث.

إضافة SMTPmailFROM مَعلمة إعداد

أضاف الإصدار 4.17.05 من Edge مَعلمة جديدة مطلوبة إلى ملف الإعدادات المستخدَم عند التفعيل. خادم SMTP. في حال التحديث من الإصدار 4.17.01، يجب ضبط SMTPmailFROM في ملف الإعداد عند تفعيل خادم SMTP.

بالإضافة إلى ذلك، أضاف الإصدار 4.17.09 من واجهة برمجة التطبيقات BaaS إمكانية استخدام السمة SMTPmailFROM. عند تحديث واجهة برمجة التطبيقات BaaS من الإصدار 4.17.01 أو 4.17.05، يجب ضبط SMTPmailFROM في ملف الإعداد.

وتكون هذه المعلمة بالشكل التالي:

SMTPMAILFROM="My Company <myco@company.com>"

الترقية المطلوبة إلى الإصدار 9.6 من Postgres

يشتمل هذا الإصدار من Edge على ترقية إلى الإصدار 9.6 من Postgres. وفي إطار هذه الترقية، يتم نقل بيانات Postgres إلى الإصدار 9.6 من Postgres.

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

تعتمد طريقة إجراء تحديث Postgres على كيفية ضبط تخزين البيانات عُقد Postgres:

إذا كنت تستخدم تخزين البيانات المحلي مع عُقد Postgres، يجب: تثبيت عقدة الاستعداد الجديدة لـ Postgres طوال مدة الترقية. بعد اكتملت عملية الترقية، يمكنك إنهاء عقدة وضع الاستعداد الجديدة في Postgres.

يجب توفّر عقدة وضع الاستعداد الإضافية لـ Postgres إذا كنت بحاجة إلى الرجوع إلى الإصدار السابق من التحديث. لأي سبب من الأسباب. إذا كان يتعين عليك العودة إلى الإصدار السابق من التحديث، فإن عقدة وضع الاستعداد الجديدة في Postgres عقدة Postgres الرئيسية بعد العودة إلى الحالة السابقة. ومن ثم، عند تثبيت ملف عقدة وضع الاستعداد الجديدة لـ Postgres، يجب أن تكون على عقدة تتوافق مع جميع الأجهزة متطلبات خادم Postgres، كما هو موضح في Edge متطلبات التثبيت:

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

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

تثبيت Postgres جديد عقدة وضع الاستعداد

ينشئ هذا الإجراء خادم استعداد لـ Postgres على عقدة جديدة. تأكد من تثبيت رمز جديد خادم وضع الاستعداد لـ Postgres لإصدارك الحالي من Edge (4.17.0x)، وليس لإصدار الإصدار 4.18.01.

لإجراء عملية التثبيت، استخدِم ملف الإعداد نفسه الذي استخدمته لتثبيت الإصدار الحالي. من Edge.

لإنشاء عقدة وضع الاستعداد جديدة في Postgres:

في شريحة Postgres الرئيسية الحالية، عدِّل /opt/apigee/customer/application/postgresql.properties لضبط ما يلي الرمز المميز:
```
conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
trust\ \nhost replication apigee new_slave_ip/32 trust
```
حيث existing_slave_ip هو عنوان IP لمجموعة Postgres الحالية خادم وضع الاستعداد وnew_slave_ip هو عنوان IP لعقدة الاستعداد الجديدة.

إذا لم يكن الملف "postgresql.properties" متوفرًا، عليك إنشاؤه واستخدامه. chown لمنح مستخدم apigee إذن الوصول إليها، على النحو التالي في المثال التالي :
```
chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
```

أعِد تشغيل apigee-postgresql. على خبير Postgres:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

تحقَّق من إضافة عقدة وضع الاستعداد الجديدة من خلال عرض /opt/apigee/apigee-postgresql/conf/pg_hba.conf. ملف على الصفحة الرئيسية. من المفترض أن تظهر لك الأسطر التالية في هذا الملف:
```
host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
```
تثبيت خادم وضع الاستعداد الجديد لـ Postgres:
1. عدّل ملف الإعداد الذي استخدمته لتثبيت الإصدار الحالي من Edge لتحديد ما يلي:
```
# IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102 
```
2. عطّل SELinux كما هو موضح في تثبيت أداة Edge apigee-setup.
3. نزِّل ملف Bootstrap_4.17.0x.sh على Edge. (حيث يكون 4.17.0x هو 4.17.01، 4.17.05، أو 4.17.09) إلى /tmp/bootstrap_4.17.0x.sh :
```
curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
```
4. ثبِّت أداة Edge apigee-service والتبعيات:
```
sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
  apigeepassword=pWord
```
5. استخدم apigee-service لتثبيت الأداة apigee-setup:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
6. تثبيت Postgres:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
```
7. على خادم الاستعداد الجديد، نفِّذ الأمر التالي:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
  تأكَّد من أنّ الجهاز في وضع الاستعداد.

إيقاف وظيفة Postgres العقدة

بعد اكتمال التحديث، عليك إيقاف عقدة وضع الاستعداد الجديدة:

تأكد من تشغيل Postgres:
> /opt/apigee/apigee-service/bin/apigee-all status

إذا كانت أداة Postgres ليست قيد التشغيل، عليك تشغيلها:
> /opt/apigee/apigee-service/bin/apigee-all start
يمكنك الحصول على المعرّف الفريد العالمي (UUID) لعقدة وضع الاستعداد الجديدة من خلال تشغيل أمر cURL التالي على الجهاز الجديد عقدة وضع الاستعداد:
> ضفيرة -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

من المفترض أن يظهر لك المعرّف الفريد العالمي للعقدة في نهاية الإخراج على النحو التالي:
"النوع" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
أوقِف عقدة وضع الاستعداد الجديدة من خلال تنفيذ الأمر التالي على عقدة وضع الاستعداد الجديدة:
> /opt/apigee/apigee-service/bin/apigee-all stop
في عقدة Postgres الرئيسية، عدِّل /opt/apigee/customer/application/postgresql.properties لإزالة عقدة وضع الاستعداد الجديدة من conf_pg_hba_replication.connection:
conf_pg_hba_replication.connection=host نسخة طبق الأصل من واجهة برمجة التطبيقات existing_slave_ip/32 Trust
أعِد تشغيل apigee-postgresql في صفحة Postgres الرئيسية:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql rename
تحقَّق من إزالة عقدة وضع الاستعداد الجديدة من خلال عرض /opt/apigee/apigee-postgresql/conf/pg_hba.conf. ملف على الصفحة الرئيسية. من المفترض أن يظهر لك السطر التالي فقط في هذا الملف:
واجهة برمجة تطبيقات النسخ المتماثل للمضيف existing_slave_ip/32 Trust
احذف المعرّف الفريد العالمي لعقدة وضع الاستعداد من ZooKeeper من خلال إجراء إدارة Edge التالية طلب بيانات من واجهة برمجة التطبيقات على عقدة خادم الإدارة:
> ضفيرة -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

تعديل المتطلبات الأساسية

يجب استيفاء المتطلبات الأساسية التالية قبل ترقية Apigee Edge:

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

ويتيح لك ذلك الحصول على خطة احتياطية، في حال تعذّر عليك إجراء التحديث إلى إصدار جديد يعمل بشكل صحيح. لمزيد من المعلومات حول الاحتفاظ بنسخة احتياطية، راجِع القسم الاحتفاظ بنسخة احتياطية. و"الاستعادة":
التأكُّد من تشغيل Edge
تأكَّد من أنّ Edge يعمل أثناء عملية التحديث باستخدام الأمر:

> /opt/apigee/apigee-service/bin/apigee-all

جارٍ التعامل مع التحديث الذي تعذّر تنفيذه

في حال تعذُّر التحديث، يمكنك محاولة حلّ المشكلة، ثم تنفيذ update.sh. مرة أخرى. يمكنك إجراء عملية التحديث عدة مرات وسيواصل التحديث من حيث توقفت آخر مرة.

إذا تعذّر عليك إعادة التحديث إلى الإصدار السابق، يمكنك الاطّلاع على عملية العودة إلى الإصدار السابق 4.18.01 للتعرّف على مزيد من المعلومات.

معلومات تعديل التسجيل

يُدرج الحقل update.sh تلقائيًا تقوم الأداة بكتابة معلومات السجل إلى:

/opt/apigee/var/log/apigee-setup/update.log

إذا لم يتمكن المستخدم الذي يشغِّل الأداة update.sh من الوصول إلى هذا الدليل، يكتب السجل إلى الدليل /tmp كملف باسم update_username.log.

إذا لم يكن لدى المستخدم إمكانية الوصول إلى /tmp، ستتعذّر استخدام الأداة update.sh.

تعديل وقت الاستراحة

يتيح لك التحديث بدون توقف أو بدون انقطاع تحديث تثبيت Edge بدون جلب Edge.

لا يمكن تعديل وقت الاستراحة إلا باستخدام إعدادات مكونة من 5 عُقد وأكبر.

من المهم ترقية كل جهاز توجيه، واحدًا تلو الآخر، من خلال عملية الترقية موازِن. يمكنك بعد ذلك تحديث جهاز التوجيه وأي مكونات أخرى على الجهاز نفسه مثل جهاز التوجيه، ثم إضافة جهاز التوجيه مرة أخرى إلى جهاز موازنة الحمل.

حدِّث الأجهزة بالترتيب الصحيح لتثبيتها كما هو موضح أدناه في قسم "طلب تحديث الجهاز".
عندما يحين وقت تحديث "أجهزة التوجيه"، اختَر أي جهاز توجيه وتجنَّب الوصول إليه، كما هو موضح في تفعيل/إيقاف الخادم (معالج الرسائل أو جهاز التوجيه) قابلية الوصول:
حدِّث جهاز التوجيه المحدد وجميع مكونات Edge الأخرى على نفس جهاز جهاز التوجيه. تعرض جميع إعدادات Edge جهاز التوجيه ومعالج الرسائل على نفس العقدة.
اجعل جهاز التوجيه قابلاً للوصول إليه مرة أخرى.
كرر الخطوات من 2 إلى 4 لأجهزة التوجيه المتبقية.
تابع إجراء التحديث لأي أجهزة متبقية في عملية التثبيت.

عليك مراعاة ما يلي قبل التحديث أو بعده:

في العقدة المدمجة بين جهاز التوجيه ومعالج الرسائل:
- قبل التحديث، يُرجى تنفيذ الإجراءات التالية:
  1. اجعل جهاز التوجيه لا يمكن الوصول إليه.
  2. عدم إمكانية الوصول إلى معالج الرسائل.
- بعد التحديث، يمكنك تنفيذ ما يلي:
  1. إتاحة إمكانية الوصول إلى معالج الرسائل.
  2. سهِّل على جهاز التوجيه الوصول إليه.
على عقدة موجه واحدة:
- قبل إجراء التحديث، تأكَّد من أنّه لا يمكن الوصول إلى جهاز التوجيه.
- بعد إجراء التحديث، يمكنك تسهيل الوصول إلى جهاز التوجيه.
في عقدة واحدة لمعالجة الرسائل:
- قبل التحديث، تأكد من عدم إمكانية الوصول إلى معالج الرسائل.
- بعد التحديث، يمكنك الوصول إلى معالج الرسائل.

استخدام ملف إعداد صامت

يجب تمرير ملف إعداد صامت إلى الأمر update. ملف الإعداد الصامت يجب أن يكون هو نفسه الذي استخدمته لتثبيت Edge 4.17.0x.

إجراء التحديث إلى 4.18.01 على عقدة ذات اتصال إنترنت خارجي

استخدم الإجراء التالي لتحديث مكونات Edge على عقدة:

إذا كنت تستخدم حاليًا النسخ المماثل من وضع الاستعداد الرئيسي لـ Postgres مع التخزين المحلي، تثبيت عقدة وضع الاستعداد جديدة من Postgres كما هو موضح أعلاه في تثبيت عقدة Postgres جديدة عقدة وضع الاستعداد.

إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، خذ لقطة الشبكة لمخزن البيانات المستخدم بواسطة Postgres. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.
إيقاف أي مهام CRON تم ضبطها لتنفيذ عملية إصلاح على Cassandra، في حال توفّرها إلى ما بعد اكتمال التحديث.
سجِّل الدخول إلى العقدة كجذر لتثبيت Edge RPM.
ملاحظة: بينما يتطلب تثبيت RPM الوصول إلى الجذر، يمكنك تنفيذ Edge. التهيئة بدون الوصول إلى الجذر.
ثبِّت yum-utils ثم yum-plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
عطّل SELinux كما هو موضح في Install أداة Edge apigee-setup.
في حال التثبيت على الإصدار Oracle 7.x، شغِّل الأمر التالي:
> sudo yum-config-manager --enable ol7_optional_latest
في حال التثبيت على AWS، شغِّل أوامر yum-configure-manager التالية:
> تحديث لذيذ rh-amazon-rhui-client.noarch
> sudo yum-config-manager --تفعيل rhui-Region-rhel-server-extras rhui- وبذلك-rhel-server-OPTIONAL
نزِّل ملف bootstrap_4.18.01.sh من Edge 4.18.01 إلى /tmp/bootstrap_4.18.01.sh:
. > ضفيرة https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
تثبيت أداة apigee-service في Edge 4.18.01 التبعيات:
> 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 من أجل: تعديل apigee-setup شركة الطاقة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
تعديل apigee-validate على خادم الإدارة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
تعديل apigee-provision شركة الطاقة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision
شغِّل أداة التحديث على العُقد بالترتيب الموضح أدناه في "ترتيب الجهاز تحديث" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

إن المتطلب الوحيد في ملف التهيئة هو أن يكون ملف التهيئة قابلاً للوصول أو قابلة للقراءة بواسطة "apigee" المستخدم.

استخدِم الخيار "-c" لتحديد المكوِّن المطلوب تحديثه. قائمة الخيارات المحتملة تشمل المكونات ما يلي:
ldap = OpenLDAP
cs = كاساندرا
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
ui = Edge UI
all = تحديث جميع المكونات على الجهاز (يُستخدم فقط لملف تثبيت Edge aio أو لتثبيت واجهة برمجة التطبيقات BaaS asa الملف الشخصي)
e = ElasticSearch
b = واجهة برمجة التطبيقات BaaS Stack
p = بوابة BaaS لواجهة برمجة التطبيقات
ebp = ElasticSearch, API BaaS الحزمة وبوابة BaaS API الخاصة بواجهة برمجة التطبيقات على العقدة نفسها
اختبار التحديث من خلال تشغيل أداة apigee-validate في "الإدارة" الخادم، كما هو موضَّح في مقالة اختبار التثبيت.
في حال تثبيت عقدة وضع الاستعداد جديدة من Postgres، يجب فصل العقدة كما هو موضح أعلاه في إيقاف عقدة Postgres.

إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

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

إجراء التحديث إلى الإصدار 4.18.01 من إصدار محلي مستودع

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

بعد إنشاء مستودع محلي على Edge، لديك خياران لتحديث Edge من القائمة المستودع المحلي:

أنشئ ملف tar .للمستودع، وانسخ ملف .tar إلى عقدة، ثم حدِّث Edge من .tar
تثبيت خادم ويب على العقدة مع المستودع المحلي بحيث يمكن للعقد الأخرى الوصول إليه. توفّر Apigee خادم ويب Nginx لك لاستخدامها، أو يمكنك استخدام خادم ويب خادم الويب.

للتحديث من مستودع محلي 4.18.01:

إذا كنت تستخدم حاليًا تكرار وضع الاستعداد الرئيسي في Postgres، عليك تثبيت إصدار جديد من Postgres. عقدة وضع الاستعداد كما هو موضح أعلاه في تثبيت أداة Postgres جديدة عقدة وضع الاستعداد.

إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. بدلاً من ذلك، خذ لقطة الشبكة لمخزن البيانات المستخدم بواسطة Postgres. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.
أنشِئ مستودعًا محليًا للإصدار 4.18.01 كما هو موضَّح في قسم "إنشاء مستودع محلي في Apigee". في تثبيت أداة Edge apigee-setup
ملاحظة: إذا كان لديك مستودع 4.17.0x حالي، يمكنك إضافة مستودع 4.18.01 له على النحو الموضَّح في "تعديل مستودع Apigee محلي" في تثبيت أداة Edge apigee-setup.
لتثبيت خدمة apigee من ملف .tar:
1. في العقدة التي تضم المستودع المحلي، استخدم الأمر التالي لحزم المستودع المحلي في ملف .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. في العقدة الجديدة، عليك إلغاء تنزيل الملف في دليل /tmp:
  > tar -xzf apigee-4.18.01.tar.gz
  
  ينشئ هذا الأمر دليلاً جديدًا، باسم repos، في الدليل يحتوي على الملف .tar الملف. على سبيل المثال، /tmp/repos.
4. ثبّت أداة خدمة Edge apigee والتبعيات من /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  لاحظ أنك قمت بتضمين المسار إلى دليل repos في هذا الأمر.
لتثبيت خدمة apigee باستخدام خادم ويب Nginx:
1. قم بتهيئة خادم الويب Nginx كما هو موضح في "التثبيت من المستودع باستخدام Nginx webserver" في تثبيت Edge أداة إعداد apigee.
2. في العقدة البعيدة، نزِّل ملف 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 أو اسم نظام أسماء النطاقات عقدة repo.
3. في العقدة البعيدة، عليك تثبيت أداة خدمة واجهة برمجة التطبيقات Edge والتبعيات:
  > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  حيث تكون uName:pWord هي اسم المستخدم وكلمة المرور للمستودع.
استخدِم apigee-service من أجل: تحديث أداة إعداد واجهة برمجة التطبيقات:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
تعديل apigee-validate على خادم الإدارة.
> /opt/apigee/apigee-service/bin/apigee-service apigee-verifyate
تعديل apigee-provision شركة الطاقة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision
شغِّل أداة التحديث على العُقد بالترتيب الموضّح أدناه في قسم "ترتيب الجهاز". تَحْدِيثْ" أدناه:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

إن المتطلب الوحيد في ملف التهيئة هو أن يكون ملف التهيئة قابلاً للوصول أو قابلة للقراءة بواسطة "apigee" المستخدم.

استخدِم الخيار "-c" لتحديد المكوِّن المطلوب تحديثه. قائمة الخيارات المحتملة تشمل المكونات ما يلي:
ldap = OpenLDAP
cs = كاساندرا
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge =جميع مكونات Edge باستثناء واجهة مستخدم Edge: خادم الإدارة ومعالج الرسائل وجهاز التوجيه وخادم QPID وخادم Postgres
ui = Edge UI
all = تحديث جميع المكونات على الجهاز (يُستخدم فقط لملف تثبيت Edge aio أو لتثبيت واجهة برمجة التطبيقات BaaS asa الملف الشخصي)
e = ElasticSearch
b = واجهة برمجة التطبيقات BaaS Stack
p = بوابة BaaS لواجهة برمجة التطبيقات
ebp = ElasticSearch, API BaaS الحزمة وبوابة BaaS API الخاصة بواجهة برمجة التطبيقات على العقدة نفسها
اختبار التحديث من خلال تشغيل أداة apigee-validate في "الإدارة" الخادم، كما هو موضَّح في مقالة اختبار التثبيت.
في حال تثبيت عقدة وضع الاستعداد جديدة من Postgres، يجب فصل العقدة كما هو موضَّح أعلاه في قسم الإيقاف عقدة Postgres.

إذا كنت تستخدم وحدة تخزين الشبكة، لن تحتاج إلى تثبيت العقدة الجديدة. راجع الترقية المطلوبة إلى الإصدار 9.6 من Postgres للحصول على مزيد من المعلومات.

ترتيب تحديث الجهاز

يعد ترتيب تحديث الأجهزة أثناء تثبيت Edge أمرًا مهمًا. الأكثر اعتبارات مهمة للتحديث هي:

يجب تحديث جميع عُقد Cassandra وZoKeeper قبل تحديث أي العقد الأخرى.
بالنسبة لأي جهاز يحتوي على عدة مكونات Edge (خادم الإدارة ومعالج الرسائل جهاز التوجيه، خادم QPID ولكن ليس خادم Postgres)، استخدم "-c Edge" خيار تحديثها جميعًا في في نفس الوقت.
إذا حددت الخطوة أنه يجب تنفيذها على أجهزة متعددة، فنفذها في ترتيب الجهاز المحدد.
ولا تتوفّر خطوة منفصلة لتعديل ميزة "تحقيق الربح". يتم تحديثه عند تحديد "-c حافة .