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

العودة إلى الإصدار 4.52.02 من Apigee Edge

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

يمكنك الرجوع إلى الإصدار 4.52.02 من Edge إلى أي من إصدارات الإصدارات الرئيسية التالية:

الإصدار 4.52.01
الإصدار 4.52.00
الإصدار 4.51.00

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

الرجوع إلى الإصدار	اعتبارات خاصة للبرامج
4.52.01	Cassandra
4.52.00	Zookeeper وCassandra وQpid
4.51.00	Zookeeper وPostgres وCassandra وQpid

هناك حالتان قد تحتاج فيهما إلى إجراء عملية التراجع:

الرجوع إلى إصدار رئيسي أو ثانوي سابق على سبيل المثال، من 4.52.02 إلى 4.52.00
الرجوع إلى إصدار سابق من التصحيح في الإصدار نفسه على سبيل المثال، من الإصدار 4.52.00.02 إلى الإصدار 4.52.00.01.

لمزيد من المعلومات، يُرجى الاطّلاع على عملية إصدار Apigee Edge.

ترتيب التراجع

يجب أن يتّبع التراجع عن الترقية للمكونات الترتيب العكسي لترقيتها، باستثناء أنّه يجب التراجع عن ترقية "خوادم الإدارة" بعد ترقية Cassandra. يجب التراجع عن جميع عمليات Cassandra ومكونات Runtime وخادم الإدارة باستخدام نهج مركز بيانات إلى مركز بيانات (DC-by-DC)، مع إعادة توجيه الزيارات مؤقتًا إلى مراكز البيانات الوظيفية.

سيظهر الترتيب العام المعتاد لعمليات التراجع في Private Cloud 4.52.02 على النحو التالي:

مركز بيانات واحد

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

إلغاء التغييرات التي تم إجراؤها على Qpid والمكونات الأخرى ذات الصلة بالإحصاءات
إعادة توجيه أجهزة التوجيه ومعالجات الرسائل
Rollback Cassandra
خادم إدارة التراجع
التراجع عن Postgres وZookeeper

مراكز بيانات متعدّدة

في عملية إعداد مراكز بيانات متعددة، يجب أن تتّبع عمليات التراجع نهجًا مركز بيانات حسب مركز البيانات (DC-by-DC) من خلال إعادة توجيه الزيارات مؤقتًا إلى مراكز البيانات الوظيفية. يضمن ذلك استمرارية الزيارات، ويتجنّب وقت الاستراحة، ويُمكّن من عملية إعادة التراجع الخاضعة للرقابة في Cassandra وManagement Server وRuntime nodes.

يمكنك التراجع عن Qpid والمكونات الأخرى ذات الصلة بالتحليلات في جميع مراكز البيانات.
حظر الزيارات في مركز البيانات الأول وإعادة توجيهها إلى مراكز البيانات الأخرى
يمكنك الرجوع إلى أجهزة التوجيه ومعالجات الرسائل في مركز البيانات الأول.
أرجِع التغييرات في Cassandra في مركز البيانات الأول.
خادم إدارة التراجع في مركز البيانات الأول
أزِل حظر الزيارات في مركز البيانات الأول واتّبِع الخطوة 2 إلى الخطوة 6 إلى أن يتمّ التراجع عن التغييرات في مركز البيانات الأخير في ما يتعلّق بوحدات Runtime وCassandra وخادم الإدارة.
يمكنك التراجع عن التغييرات في Postgres وZookeeper وLDAP على جميع مراكز البيانات.

لنوضّح ذلك، لنفترض أنّك أجريت ترقية لكوكبة Cassandra بأكملها وجميع الخوادم الإدارية وبعض معالجات الرسائل أثناء التشغيل (RMP) من الإصدار 4.52.01 إلى الإصدار 4.52.02 وتحتاج إلى إجراء عملية التراجع. في هذه الحالة، يجب تنفيذ عملية التراجع على النحو التالي:

حظر الزيارات إلى مركز البيانات الأول (مركز البيانات) وإعادة توجيه الزيارات إلى مراكز البيانات النشطة الأخرى لضمان استمرارية الخدمة
إعادة توجيه أجهزة التوجيه ومعالجات الرسائل في مركز البيانات الأول
أرجِع Cassandra في مركز البيانات الأول من خلال الاستعادة من نسخة احتياطية أو لقطة لعملية تشغيل جهاز افتراضي.
أرجِع التغييرات التي أجريتها على "خادم الإدارة" في أول مركز بيانات.
أزِل حظر الزيارات إلى مركز البيانات الأول.
كرِّر الخطوات من 1 إلى 5 لكل مركز بيانات متبقٍّ إلى أن يتم التراجع عن جميع عمليات الربط في Runtime وCassandra وManagement Servers.

المستخدمون الذين يمكنهم التراجع

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

يتم تشغيل مكوّنات Edge تلقائيًا باسم المستخدم "apigee". في بعض الحالات، قد تكون بصدد تشغيل مكوّنات Edge بصفتك مستخدمين مختلفين. على سبيل المثال، إذا كان على جهاز التوجيه الوصول إلى منافذ مميّزة، مثل المنافذ التي تقلّ عن 1000، عليك تشغيل جهاز التوجيه بصفتك مشرفًا أو مستخدمًا لديه إذن الوصول إلى تلك المنافذ. أو يمكنك تشغيل مكوّن واحد كمستخدم واحد، ومكوّن آخر كمستخدم آخر.

المكوّنات التي تتضمّن رمزًا شائعًا

تشترك مكوّنات Edge التالية في رمز برمجي شائع. لذلك، لإلغاء أيٍّ من هذه المكوّنات على عقدة، عليك إلغاء جميع هذه المكوّنات على تلك العقدة.

edge-management-server (خادم الإدارة)
edge-message-processor (معالج الرسائل)
edge-router (جهاز توجيه)
edge-postgres-server (Postgres Server)
edge-qpid-server (خادم Qpid)

على سبيل المثال، إذا كان لديك "خادم الإدارة" و"الراوتر" و"معالج الرسائل" مثبّتَين على العقدة، عليك الرجوع إلى الإصدار السابق من كلّ من هذه المكونات الثلاثة لتراجع عن أيّ تغيير في أحدها.

التراجع عن التغييرات في Cassandra

عند إجراء ترقية كبيرة لخدمة Cassandra على عقدة Cassandra معيّنة، تعدّل Cassandra مخطّط البيانات المخزّنة على العقدة، ما يجعل التراجع المباشر غير ممكن. هناك طريقتان للتراجع. ستستخدم إحدى هذه المنهجيات استنادًا إلى حالة الترقية التي يتم التراجع عنها.

منهجيات التراجع

سيناريوهات التراجع

يتضمّن الإصدار 4.52.02 من Edge for Private Cloud ترقية في Cassandra وبرنامج التشغيل الذي يستخدمه معالِج الرسائل وخادم الإدارة للاتصال بخدمة Cassandra. نتيجةً لذلك، ترتبط عمليات الترقية والتراجع لهذه المكوّنات الثلاثة ارتباطًا وثيقًا. يسرد الجدول التالي أمثلة عامة على سيناريوهات التراجع لهذه المكوّنات الثلاثة المحدّدة. يجب أن يتم بعد ذلك التراجع عن التغييرات في المكوّنات الأخرى وفقًا للقسم ترتيب التراجع.

يوضّح هذا القسم سيناريوهات مختلفة لعمليات التراجع إلى جانب المنهجية المقترَحة التي يجب اتّباعها استنادًا إلى الأساليب الموضّحة أعلاه.

السيناريو	استراتيجية التراجع
مركز بيانات واحد، تم ترقية بعض عقد Cassandra	استعادة النسخة الاحتياطية
مركز بيانات واحد، تم ترقية جميع عقد Cassandra	استعادة النسخة الاحتياطية
مركز بيانات واحد، تم ترقية جميع العقد (Cassandra وخادم الإدارة وعقد Runtime)	التراجع عن "العقد في وقت التشغيل" استعادة النسخة الاحتياطية من Cassandra التراجع عن الإدارة
مراكز بيانات متعدّدة، تم ترقية بعض/كلّ عقد Cassandra في مركز البيانات الأول	إعادة الإنشاء من مركز البيانات الحالي
تم ترقية مراكز بيانات متعددة وجميع عقد Cassandra وخادم الإدارة وعقد Runtime في مركز البيانات الأول.	التراجع عن "العقد في وقت التشغيل" استعادة إعادة إنشاء Cassandra التراجع عن الإدارة يجب تنفيذ ذلك في مركز بيانات واحد في كل مرة.
مراكز بيانات متعدّدة، بعض/كلّ عقد Cassandra في مركز البيانات الأخير تمت ترقيتها	التراجع عن آخر مركز بيانات باستخدام النسخة الاحتياطية يمكنك التراجع عن التغييرات في مراكز البيانات المتبقية باستخدام الاحتفاظ بنسخة احتياطية أو إعادة الإنشاء، مركز بيانات واحد في كل مرة.
تم ترقية مراكز بيانات متعددة وجميع عقد Cassandra وخادم الإدارة وعقد Runtime في جميع مراكز البيانات.	التراجع عن "العقد في وقت التشغيل" استعادة النسخة الاحتياطية من Cassandra التراجع عن الإدارة يجب تنفيذ ذلك في مركز بيانات واحد في كل مرة.

بشكل عام، يجب مراعاة ما يلي أثناء التراجع عن Cassandra:

التراجع عن عناصر التشغيل أو الإدارة
إذا كنت بحاجة إلى الرجوع إلى إصدار سابق من Edge Private Cloud في أي مركز بيانات (DC) من خلال إعادة المكونات، مثل Edge Management Server أو Edge Message Processor، تأكَّد من إعادة Cassandra أيضًا في مركز البيانات هذا في الوقت نفسه. هذا الإجراء ضروري لمنع حدوث أخطاء في إدارة الزيارات ووقت التشغيل.
التراجع باستخدام النُسخ الاحتياطية
إنّ النُسخ الاحتياطية التي تم إنشاؤها من Cassandra 3.11.x غير متوافقة مع النُسخ الاحتياطية التي تم إنشاؤها من Cassandra 2.1.x. لتفعيل ميزة "الرجوع إلى الإصدار السابق" باستخدام ميزة "استعادة النسخة الاحتياطية"، تأكَّد من الاحتفاظ بنسخ احتياطية من Cassandra 2.1.x قبل إجراء الترقية.
عزل مركز البيانات للرجوع إلى إصدار سابق
لتجنُّب وقت الاستراحة، تأكَّد من إعادة توجيه الزيارات إلى مراكز بيانات تعمل بكامل طاقتها ومن حظرها من مركز البيانات الذي يتمّ التراجع فيه.

التراجع عن التغييرات في Cassandra باستخدام إعادة الإنشاء

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

إذا كنت تشغّل مجموعة Edge for Private Cloud 4.51.00 / 4.52.00 / 4.52.01 على مراكز بيانات متعددة
إذا كنت بصدد ترقية Cassandra من الإصدار 2.1.X إلى الإصدار 3.11.X وواجهت مشاكل أثناء الترقية
لديك مركز بيانات واحد على الأقل يعمل بكامل طاقته في المجموعة لا يزال يستخدم الإصدار الأقدم من Cassandra (Cassandra 2.1.X)

الخطوات العامة

اختَر مركز بيانات واحدًا (تمّت ترقيته جزئيًا أو كليًا) تريد التراجع عنه. إعادة توجيه جميع زيارات التطبيق من مركز البيانات هذا إلى مركز بيانات آخر يعمل بكامل طاقته
في حال ترقية "الراوتر" و"معالج الرسائل"، يمكنك التراجع عن جميع عقد "الراوتر" و"معالج الرسائل" في مركز البيانات، واحدة تلو الأخرى.
أوقِف Cassandra على عقدة واحدة وألغِ تثبيته ونظِّف جميع البيانات المرتبطة به.
ثبِّت الإصدار السابق من أداة Bootstrap وإعدادات Cassandra الإصدار 2.1.x على العقدة التي تمّت تنظيفها.
إعادة إنشاء العقدة من مركز البيانات الوظيفي الحالي الذي لا يزال يستخدم Cassandra 2.1.x
نفِّذ الخطوات من 3 إلى 5 على كل عقدة متبقية من عقد Cassandra في مركز البيانات، عقدة واحدة في كل مرة.
أعِد تشغيل عملية إعداد "الخادم الإداري" في مركز البيانات.
إجراء اختبارات للتحقّق من صحة عملية التراجع بعد التحقق من ذلك، عليك إعادة توجيه عدد الزيارات إلى التطبيق إلى مركز البيانات الذي تم استعادته.
كرِّر الخطوات أعلاه لمراكز البيانات الأخرى التي تتطلّب التراجع، مركزًا واحدًا تلو الآخر.

إليك الخطوات التفصيلية لمحو العقد الحالية في المجموعة واستخدامها لإعادة إنشاء العقدة:

ابدأ بالعقدة التي تريد التراجع عنها.

تأكَّد من إعادة توجيه الزيارات إلى مراكز بيانات تعمل بكامل طاقتها قبل المتابعة إلى الخطوات التالية.
في حال ترقية "جهاز التوجيه" و"معالج الرسائل"، يمكنك الرجوع إلى جميع عقد "جهاز التوجيه" و"معالج الرسائل" إلى الإصدار السابق في مركز البيانات، واحدة تلو الأخرى.

أوقِف Cassandra على العقدة:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

يمكنك إلغاء تثبيت برنامج Cassandra من العقدة باتّباع الخطوات التالية:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
```
أزِل دليل البيانات من العقدة:
```
rm -rf /opt/apigee/data/apigee-cassandra
```
نزِّل وشغِّل أداة Bootstrap للإصدار الأقدم من Edge for Private Cloud الذي تريد الرجوع إليه:

مثال: للرجوع إلى الإصدار 4.52.01

تنزيل حزمة bootstrap من الإصدار 4.52.01:

curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’

تنفيذ عملية التحميل المُسبَق للإصدار 4.52.01:
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```
ثبِّت برنامج Cassandra على العقدة:
```
apigee-service apigee-cassandra install
```

أضِف السمة أدناه في ملف /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh.

JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>"

مثال:

JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=10.0.0.1"

إعداد Cassandra على العقدة:
```
/opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
```
ملاحظة: في حال تعذّر إعداد Cassandra، عدِّل ملف /opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh وأزِل السطر الذي يحتوي على: JVM_OPTS="$JVM_OPTS -Dcassandra.replace_address=<cass_ip-address>" بعد إجراء هذا التغيير، أعِد تشغيل النص البرمجي setup.sh أعلاه لإعادة محاولة الإعداد.
بعد تشغيل Cassandra، أزِل CWC أعلاه من الملف التالي:/opt/apigee/apigee-cassandra/source/conf/cassandra-env.sh.
إعادة تشغيل عقدة Cassandra
```
apigee-service apigee-cassandra restart
```
نفِّذ عملية إعادة الإنشاء على العقدة من خلال تقديم اسم مركز البيانات الوظيفي:
```
/opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
```
مثال:
```
/opt/apigee/apigee-cassandra/bin/nodetool rebuild -h 10.0.0.1 dc-2
```
كرِّر الخطوات أعلاه على كل عقدة تريد التراجع عنها في مركز البيانات، واحدة تلو الأخرى.

بعد التراجع عن جميع عقد Cassandra في مركز البيانات وإعادة إنشائها

شغِّل إعداد أي من عقد الخادم الإداري في مركز البيانات الذي يتم التراجع عنه. تأكَّد من أنّ خادم الإدارة من الإصدار الذي تمّ الرجوع إليه. وإذا لم يكن الأمر كذلك، عليك التراجع عن التغييرات في خادم الإدارة أيضًا.

الرجوع بخادم الإدارة إلى إصدار أقدم

أوقِف خادم الإدارة:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop

إذا كنت تستخدم ميزة تحقيق الربح، عليك إلغاء تثبيتها أيضًا:
```
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
```

ألغِ تثبيت edge-gateway وapigee-cassandra-client:

/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall

نزِّل ونفِّذ عملية الإعداد المبدئي للإصدار الأقدم. على سبيل المثال، نفِّذ الخطوات التالية لتنزيل وتنفيذ أداة bootstrap للإصدار 4.52.01.
```
curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
```
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```

إعداد خادم الإدارة

شغِّل عملية إعداد عقدة خادم إدارة واحدة:
```
/opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile
```
بعد إكمال الخطوات أعلاه، عليك إعادة توجيه الزيارات إلى مركز البيانات الذي تمّ التراجع عنه.

التحسين بعد إعادة الإنشاء

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

مثال: لنفترض أنّ لديك ستة عقد من Cassandra في مركز البيانات المحلي. يكون عامل التكرار في Apigee هو ثلاثة تلقائيًا، لذا تحتوي كل عقدة على% 50 من البيانات. في هذه الحالة، يمكنك إعادة إنشاء العقدتَين 1 و4 باتّباع الإجراء أعلاه. بالنسبة إلى العقد رقم 2 و3 و5 و6، اتّبِع الخطوات التالية لاستعادة النسخة الاحتياطية وإجراء عملية إصلاح.

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

استعدّ النسخة الاحتياطية التي تم الاحتفاظ بها على هذه العقدة (يُرجى العِلم أنّ هذه النسخة الاحتياطية قد تحتوي على بيانات قديمة لأنّه تم الاحتفاظ بها قبل بدء ترقية Cassandra):
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
```
إذا كانت لديك لقطة لعملية تشغيل افتراضية للعقدة، يمكنك استعادة اللقطة بدلاً من استعادة النسخة الاحتياطية من Cassandra.
بعد استعادة النسخة الاحتياطية، ابدأ خدمة Cassandra على العقدة:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
```
نفِّذ عملية إصلاح على العقدة لكي تتمكّن من بث أحدث البيانات من مركز بيانات حالي:
```
/opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
```
مثال:
```
/opt/apigee/apigee-cassandra/bin/nodetool -h 10.0.0.1 repair -dc dc-1
```
كرِّر جميع الخطوات المذكورة أعلاه ضمن الخطوة 2 على كل عقدة تريد إصلاحها.

التراجع عن التغييرات في Cassandra باستخدام نسخة احتياطية / لقطة لعملية تشغيل الجهاز الظاهري

هذه العملية هي العملية الوحيدة المتاحة إذا كنت قد أجريت ترقية لكوكبة Cassandra بأكملها وأردت التراجع. بالإضافة إلى ذلك، تكون النُسخ الاحتياطية من Apigee خاصة بالعقدة. لا يمكن استعادة نسخة احتياطية تم أخذها من عقدة إلى أخرى. تتضمّن نُسخ Cassandra الاحتياطية معلومات البيانات الوصفية للعقد (مثل عنوان IP وموقع الحلقة وما إلى ذلك).

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

أنت بصدد ترقية Cassandra من الإصدار 2.1.X إلى الإصدار 3.11.X في مركز البيانات الأخير، وواجهت مشاكل أثناء الترقية.
تتوفر لديك نُسخ احتياطية للعقدة قبل الترقية التي يتم التراجع عنها. تم إنشاء النسخة الاحتياطية قبل محاولة الترقية من الإصدار 2.1.X إلى الإصدار 3.11.X.

الخطوات العامة

اختَر مركز بيانات (تم ترقيته جزئيًا أو كليًا) للرجوع إلى إصدار سابق. إعادة توجيه جميع الزيارات في وقت التشغيل من مركز البيانات هذا إلى مركز بيانات آخر يعمل بكامل طاقته
في حال ترقية جهاز التوجيه ومعالج الرسائل، يمكنك التراجع عن جميع عقد جهاز التوجيه ومعالج الرسائل في مركز البيانات، واحدة تلو الأخرى.
أوقِف Cassandra على عقدة واحدة وألغِ تثبيته ونظِّف جميع البيانات المرتبطة به.
ثبِّت الإصدار السابق من أداة Bootstrap وإعدادات Cassandra الإصدار 2.1.x على العقدة التي تمّت تنظيفها.
أوقِف عقدة Cassandra ونظِّف جميع البيانات المرتبطة بها.
استعادة عقدة Cassandra من النسخة الاحتياطية التي تم أخذها قبل الترقية
كرِّر الخطوات من 3 إلى 6 لكل عقدة من عقد Cassandra المتبقية في مركز البيانات، عقدة واحدة في كل مرة.
أعِد تشغيل عملية إعداد "الخادم الإداري" في مركز البيانات.
عليك إجراء اختبار للتحقّق من صحة عملية التراجع. بعد التحقّق من ذلك، عليك إعادة توجيه عدد الزيارات في وقت التشغيل إلى مركز البيانات الذي تم استعادته.
كرِّر الخطوات أعلاه لمراكز البيانات الأخرى التي تتطلّب التراجع، مركزًا واحدًا تلو الآخر.
(اختياري) نفِّذ الأمر repair على جميع عقد Cassandra في جميع مراكز البيانات في حال حدوث عدم اتساق في البيانات بينها.

خطوات تفصيلية للتراجع عن التغييرات في Cassandra باستخدام النُسخ الاحتياطية/لقطة VM

ابدأ باستخدام عقدة واحدة من cassandra في المجموعة.

تأكَّد من إعادة توجيه الزيارات إلى مراكز بيانات تعمل بكامل طاقتها قبل المتابعة إلى الخطوات التالية.
في حال ترقية جهاز التوجيه ومعالج الرسائل، يمكنك الرجوع إلى الإصدار السابق من جميع عقد جهاز التوجيه ومعالج الرسائل في مركز البيانات، واحدة تلو الأخرى.

أوقِف Cassandra على العقدة:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

يمكنك إلغاء تثبيت برنامج Cassandra من العقدة باتّباع الخطوات التالية:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
```
أزِل دليل البيانات من العقدة:
```
rm -rf /opt/apigee/data/apigee-cassandra
```
نزِّل وشغِّل أداة Bootstrap للإصدار الأقدم من Edge for Private Cloud الذي تريد الرجوع إليه:

مثال: للرجوع إلى الإصدار 4.52.01

تنزيل حزمة bootstrap من الإصدار 4.52.01:

curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’

تنفيذ عملية التحميل المُسبَق للإصدار 4.52.01:
```
sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
```

إعداد Cassandra على العقدة:

/opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile

أوقِف Cassandra على العقدة:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

حذف دليل البيانات على العقدة:
```
rm -rf /opt/apigee/data/apigee-cassandra/data
```

استعادة النسخة الاحتياطية:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file

بدء خدمة Cassandra على العقدة

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

كرِّر الخطوات على كل عقدة من عقد Cassandra واحدة تلو الأخرى.
شغِّل إعداد أي من عقد الخادم الإداري في مركز البيانات الذي يتم التراجع عنه. تأكَّد من أنّ خادم الإدارة من الإصدار الذي تمّ التراجع عنه. وإذا لم يكن الأمر كذلك، عليك التراجع عن التغييرات في خادم الإدارة أيضًا.
بعد إكمال الخطوات أعلاه، عليك إعادة توجيه الزيارات إلى مركز البيانات الذي تمّ التراجع عنه.
(اختياري) نفِّذ الأمر repair على جميع عقد Cassandra في جميع مراكز البيانات في حال حدوث عدم اتساق في البيانات بينها.
```
/opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr
```

التراجع عن تحديث Zookeeper 3.8.3

إذا كنت تريد الرجوع إلى الإصدارَين 4.52.00 أو 4.51.00، عليك الرجوع إلى بعض الخطوات الخاصة قبل الرجوع إلى Zookeeper. يتم إدراج هذه الخطوات في التراجع.

إذا كنت تريد الرجوع إلى الإصدار 4.52.01، يمكنك الرجوع إلى Zookeeper كما يمكنك الرجوع إلى أي برنامج، كما هو موضّح في قسم الرجوع إلى إصدار رئيسي أو ثانوي سابق أدناه.

إعادة تحميل Qpid

إذا كنت تريد الرجوع إلى الإصدارَين 4.52.00 أو 4.51.00، عليك الرجوع إلى بعض الخطوات الخاصة قبل الرجوع إلى Qpid. يتم إدراج هذه الخطوات في التراجع.

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

التراجع عن تحديث Postgres 10.17

إذا كنت تريد الرجوع إلى الإصدار 4.51.00، عليك الرجوع إلى بعض الخطوات الخاصة قبل الرجوع إلى Postgres. يتم إدراج هذه الخطوات في التراجع.

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

الرجوع إلى إصدار رئيسي أو ثانوي سابق

للرجوع إلى إصدار رئيسي أو ثانوي سابق، عليك إجراء ما يلي في كل عقدة تستضيف المكوّن:

نزِّل ملف bootstrap.sh للإصدار الذي تريد الرجوع إليه:
- للرجوع إلى الإصدار 4.51.00، يُرجى تنزيل bootstrap_4.51.00.sh.

أوقِف المكوّن للرجوع إلى الإصدار السابق:

لإلغاء أي من المكوّنات التي تتضمّن رمزًا شائعًا في العقدة، عليك إيقافها جميعًا، كما يوضّح المثال التالي:

/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

لإلغاء أي مكوّن آخر في العقدة، أوقِف هذا المكوّن فقط:
```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

في حال كنت بصدد التراجع عن ميزة "تحقيق الربح"، عليك إلغاء تثبيتها من جميع عقد "خادم الإدارة" و"معالج الرسائل":
```
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
```
ألغِ تثبيت المكوّن للرجوع إلى الإصدار السابق في العقدة:
1. لإلغاء تثبيت أيّ من المكوّنات التي تتضمّن رمزًا شائعًا في node، عليك إلغاء تثبيتها كلها من خلال إلغاء تثبيت مجموعة المكوّنات edge-gateway وapigee-cassandra-client، كما هو موضّح في المثال التالي:
```
/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
```
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client uninstall
```
2. للتراجع عن أي مكوّن آخر في العقدة، ألغِ تثبيت هذا المكوّن فقط، كما هو موضّح في المثال التالي:
```
/opt/apigee/apigee-service/bin/apigee-service component uninstall
```
  حيث يكون component هو اسم المكوّن.
3. لإلغاء التغييرات التي أجريتها على Edge Router، عليك حذف محتوى ملف /opt/nginx/conf.d بالإضافة إلى إلغاء تثبيت مجموعة المكوّنات edge-gateway:
```
cd /opt/nginx/conf.d
rm -rf *
```
يُرجى إلغاء تثبيت الإصدار 4.52.02 من apigee-setup باتّباع الخطوات التالية:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
```
ثبِّت الإصدار 4.51.00 من الأداة apigee-service والبرامج التي تعتمد عليها. في المثال التالي، يتم تثبيت الإصدار 4.51.00 من apigee-service:
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
حيث يكون uName وpWord هما اسم المستخدم وكلمة المرور اللذان تلقّيتَهما من Apigee. في حال حذف pWord، سيُطلب منك إدخاله.

إذا ظهرت لك رسالة خطأ، تأكَّد من أنّك نزّلت ملف bootstrap.sh في الخطوة 1.

تثبيت apigee-setup:

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

ثبِّت الإصدار الأقدم من المكوِّن:
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
حيث يكون component هو المكوّن المطلوب تثبيته وconfigFile هوملف الإعداد للإصدار الأقدم.
في حال كنت بصدد التراجع عن Qpid، يمكنك تفريغ iptables:
```
sudo iptables -F
```
كرِّر هذه العملية لكل عقدة تستضيف المكوّن الذي يتم التراجع عنه.

الرجوع إلى إصدار سابق من التصحيح

للرجوع بأحد المكوّنات إلى إصدار تصحيح معيّن، عليك تنفيذ ما يلي على كل عقدة تستضيف المكوّن:

تنزيل إصدار المكوّن المحدّد:
```
/opt/apigee/apigee-service/bin/apigee-service component_version install
```
حيث يمثّل component_version إصدار المكوّن والرقعة المطلوب تثبيتهما. على سبيل المثال:
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install
```
إذا كنت تستخدِم مستودع Apigee على الإنترنت، يمكنك تحديد إصدارات المكوّن المتاحة باستخدام الأمر التالي:
```
yum --showduplicates list component
```
على سبيل المثال:
```
yum --showduplicates list edge-ui
```
استخدِم apigee-setup لتثبيت المكوّن:
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
على سبيل المثال:
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
```
تجدر الإشارة إلى أنّك تحدّد اسم المكوّن فقط عند تثبيته، وليس الإصدار.
كرِّر هذه العملية لكل عقدة تستضيف المكوّن الذي يتم التراجع عنه.

التراجع عن mTLS

لإلغاء تحديث mTLS، اتّبِع الخطوات التالية على جميع المضيفين:

أوقِف Apigee:
```
apigee-all stop
```
إيقاف mTLS:
```
apigee-service apigee-mtls uninstall
```

إعادة تثبيت mTLS:

apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf