إعادة Apigee Edge 4.53.00 إلى الإصدار السابق

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

يمكنك الرجوع من الإصدار 4.53.00 من Edge إلى إصدار الإصدار الثانوي التالي:

  • الإصدار 4.52.02

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

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

  1. العودة إلى إصدار رئيسي أو ثانوي سابق على سبيل المثال، من 4.53.00 إلى 4.52.02.
  2. العودة إلى إصدار تصحيح سابق في الإصدار نفسه على سبيل المثال، من 4.53.00.01 إلى 4.53.00.00.

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

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

يجب إعادة إصدار المكوّنات إلى الإصدار السابق بالترتيب العكسي لترتيب ترقيتها، باستثناء خوادم الإدارة التي يجب إعادة إصدارها إلى الإصدار السابق بعد Cassandra.

سيبدو الترتيب العام النموذجي لعملية التراجع عن الإصدار 4.53.00 من "السحابة الإلكترونية الخاصة" كما يلي:

  1. إرجاع Postgres وQpid والمكوّنات الأخرى ذات الصلة بالإحصاءات إلى الإصدار السابق
  2. إعادة أجهزة التوجيه ومعالجات الرسائل إلى الحالة السابقة
  3. العودة إلى الإصدار السابق من Cassandra وZookeeper
  4. خادم إدارة التراجع

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

  1. التراجع عن جميع RMP واحدًا تلو الآخر
  2. إرجاع مجموعة Cassandra بأكملها إلى حالتها السابقة باستخدام النسخ الاحتياطية
  3. التراجع عن تغييرات عقد خادم Edge Management واحدة تلو الأخرى

مَن يمكنه إجراء عملية التراجع؟

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

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

المكوّنات التي تتضمّن رمزًا برمجيًا مشتركًا

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

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

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

العودة إلى الإصدار السابق من Cassandra

العودة إلى الإصدار السابق من Cassandra

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

سيناريوهات العودة إلى الحالة السابقة

يتوافق الإصدار 4.0.X من Cassandra، المتاح مع Edge for Private Cloud 4.53.00، مع المكوّنات الأخرى من Private Cloud 4.52.02.

يُرجى الرجوع إلى الجدول أدناه للاطّلاع على ملخّص لاستراتيجيات التراجع المختلفة التي يمكنك استخدامها:

السيناريو استراتيجية العودة إلى الإصدار السابق
مركز بيانات واحد، تمت ترقية بعض عُقد Cassandra استخدام النُسخ الاحتياطية
Single DC, all Cassandra nodes upgraded لا تعُد إلى الإصدار السابق من Cassandra. يمكن التراجع عن التغييرات التي تم إجراؤها على المكوّنات الأخرى.
مركز بيانات واحد، تمت ترقية جميع العُقد (Cassandra وغيرها) لا تعُد إلى الإصدار السابق من Cassandra. يمكن التراجع عن التغييرات التي تم إجراؤها على المكوّنات الأخرى.
وحدات تحكّم متعددة في مركز بيانات واحد، وتمت ترقية بعض العُقد في وحدة تحكّم واحدة إعادة الإنشاء من شهادة رقمية حالية
مراكز بيانات متعددة، تمت ترقية جميع عُقد Cassandra في بعض مراكز البيانات إعادة الإنشاء من شهادة رقمية حالية
عُقد متعددة في مركز البيانات (DC) وCassandra لآخر مركز بيانات تمت ترقيته حاوِل إكمال عملية الترقية. إذا لم يكن ذلك ممكنًا، يمكنك التراجع عن التغييرات في مركز بيانات واحد باستخدام نسخة احتياطية. إعادة إنشاء الشهادات الرقمية المتبقية من الشهادة الرقمية التي تم التراجع عنها
مراكز بيانات متعددة، تمت ترقية جميع عُقد Cassandra لا تعُد إلى الإصدار السابق من Cassandra. يمكن التراجع عن التغييرات التي تم إجراؤها على المكوّنات الأخرى.
تعدُّد مراكز البيانات، وترقية جميع العُقد (Cassandra وغيرها) لا تعُد إلى الإصدار السابق من Cassandra. يمكن التراجع عن التغييرات التي تم إجراؤها على المكوّنات الأخرى.

اعتبارات عامة

عند التفكير في التراجع عن التغييرات، يُرجى مراعاة ما يلي:

  • التراجع عن إصدار وقت التشغيل أو مكونات الإدارة: إذا كنت تريد التراجع عن إصدار مكونات مثل edge-management-server أو edge-message-processor أو أي مكون غير Cassandra إلى الإصدار 4.52.02 من Private Cloud، ننصحك بعدم التراجع عن إصدار Cassandra. يتوافق إصدار Cassandra الذي تم شحنه مع Private Cloud 4.53.00 مع جميع مكوّنات Edge for Private Cloud 4.52.02 غير Cassandra. يمكنك التراجع عن تغييرات المكوّنات غير التابعة لـ Cassandra باستخدام المنهجية الواردة هنا، مع إبقاء Cassandra على الإصدار 4.0.13.
  • الرجوع إلى الإصدار السابق بعد ترقية مجموعة Cassandra بالكامل إلى الإصدار 4.0.X: إذا تمت ترقية مجموعة Cassandra بالكامل إلى الإصدار 4.0.X كجزء من الترقية إلى الإصدار 4.53.00 من Private Cloud، يُنصح بمواصلة إعداد هذه المجموعة وعدم الرجوع إلى الإصدار السابق من Cassandra. تتوافق المكوّنات، مثل edge-management-server وedge-message-processor وedge-router وما إلى ذلك، من الإصدار 4.52.02 من Private Cloud مع الإصدار 4.0.X من Cassandra.
  • التراجع عن ترقية Cassandra: إذا واجهت مشاكل أثناء ترقية Cassandra، يمكنك التراجع عن الترقية. يمكن اتّباع استراتيجيات التراجع المدرَجة في هذه المقالة استنادًا إلى الحالة التي تكون فيها أثناء عملية الترقية.
  • العودة إلى الحالة السابقة باستخدام النُسخ الاحتياطية: لا تتوافق النُسخ الاحتياطية التي تم إنشاؤها من Cassandra 4.0.X مع النُسخ الاحتياطية من Cassandra 3.11.X. لإرجاع Cassandra باستخدام استعادة النسخة الاحتياطية، يجب أخذ نُسخ احتياطية من Cassandra 3.11.X قبل محاولة الترقية.

العودة إلى الإصدار السابق من Cassandra باستخدام إعادة الإنشاء

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

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

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

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

  1. اختَر مركز بيانات واحدًا (تمت ترقيته جزئيًا أو كليًا) تريد التراجع عنه. توجيه زيارات وقت التشغيل إلى مركز بيانات آخر يعمل
  2. حدِّد عقدة البداية في مركز البيانات وابدأ بإحدى عقد البداية.
  3. أوقِف عقدة Cassandra وألغِ تثبيتها ونظِّفها.
  4. ثبِّت الإصدار الأقدم من Cassandra على العُقدة واضبطه حسب الحاجة.
  5. أزِل الإعدادات الإضافية التي تمت إضافتها سابقًا.
  6. كرِّر الخطوات المذكورة أعلاه لجميع العُقد الأولية في مركز البيانات، واحدة تلو الأخرى.
  7. كرِّر الخطوات أعلاه لجميع عُقد Cassandra المتبقية في مركز البيانات، واحدة تلو الأخرى.
  8. إعادة إنشاء العُقد من مركز البيانات الوظيفي الحالي، واحدة تلو الأخرى
  9. أعِد تشغيل جميع مكونات edge-* في مركز البيانات المرتبطة بـ Cassandra.
  10. اختبِر حركة المرور وأعِد توجيهها إلى مركز البيانات هذا.
  11. كرِّر الخطوات لكل مركز بيانات، واحدًا تلو الآخر.

الخطوات التفصيلية

  1. اختَر مركز بيانات واحدًا تتم فيه ترقية بعض أو كل عُقد Cassandra. توجيه كل زيارات وكيل وقت التشغيل وزيارات الإدارة من مركز البيانات هذا أثناء التراجع عن تغييرات عقد Cassandra في مركز البيانات هذا تأكَّد من أنّ جميع عُقد Cassandra في حالة UN (نشطة/عادية) عند تنفيذ الأمر nodetool ring على العُقد. إذا كانت بعض العُقد متوقّفة، عليك تحديد المشكلة وحلّها وإعادة تشغيل هذه العُقد قبل المتابعة.

    اطّلِع على المثال الوارد في ما يلي:

    /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    يمكنك تنفيذ nodetool describecluster على العُقد لفهم الحالة الحالية للمجموعة بأكملها. على سبيل المثال، يعرض ما يلي مثيلاً لمجموعة من مركزَي بيانات حيث تعمل جميع عُقد DC-1 بالإصدار 4 من Cassandra، بينما تعمل جميع عُقد DC-2 بالإصدار 3 من Cassandra:

    # On nodes where Cassandra is upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. تحديد العُقد الأولية في مركز البيانات: يُرجى الرجوع إلى القسم كيفية تحديد العُقد الأولية في الملحق. نفِّذ الخطوات أدناه على إحدى عُقد البداية:
  3. إيقاف وإلغاء تثبيت البيانات وتنظيفها من عقدة Cassandra اختَر أول عقدة أساسية في الإصدار 4 من Cassandra في مركز البيانات هذا. توقّف عن ذلك. 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. ثبِّت برنامج Cassandra القديم على العُقدة واضبط بعض الإعدادات. نفِّذ ملف bootstrap الخاص بالإصدار 4.52.02 من Edge for Private Cloud. 
    5. # Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u uName:pWord

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
  5. أنشئ الملف /opt/apigee/customer/application/cassandra.properties أو عدِّله.
  6. أضِف المحتوى التالي إلى الملف. ipOfNode هو عنوان IP للعقدة التي تستخدمها Cassandra للتواصل مع عُقد Cassandra الأخرى: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  7. تأكَّد من أنّ مستخدم Apigee يملك الملف ويمكنه قراءته: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  8. ثبِّت Cassandra وأعِدّها على النحو التالي: 
    # Install cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Setup cassandra while passing standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
# Ensure Cassandra version is correct and service is running
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  9. تأكَّد من بدء تشغيل العُقدة. تحقَّق من الأمر التالي على هذه العُقدة والعُقد الأخرى في المجموعة. يجب أن تشير العقدة إلى أنّها في الحالة "UN" (نشطة/عادية): 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  10. أزِل الإعدادات الإضافية التي أضفتها سابقًا من الملف /opt/apigee/customer/application/cassandra.properties.
  11. كرِّر الخطوات من 3 إلى 10 على جميع عقد البذور في Cassandra في مركز البيانات، واحدة تلو الأخرى.
  12. كرِّر الخطوات من 3 إلى 10 على جميع عُقد Cassandra المتبقية في مركز البيانات، واحدة تلو الأخرى.
  13. أعِد إنشاء جميع العُقد في مركز البيانات من مركز بيانات يعمل بإصدار Cassandra الأقدم. نفِّذ هذه الخطوة على عقدة واحدة في كل مرة: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>

    قد يستغرق هذا الإجراء بعض الوقت. يمكنك تعديل streamingthroughput إذا لزم الأمر. اطّلِع على nodetool netstats لمعرفة حالة اكتمال العملية.

  14. (اختياري) نفِّذ أمر الإصلاح في عقدة Cassandra إذا لم تتم إعادة إنشاء البيانات. 
    /opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr
  15. أعِد تشغيل جميع مكوّنات edge-* في مركز البيانات، واحدًا تلو الآخر: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  16. التحقّق من صحة مركز البيانات هذا وإعادة توجيه الزيارات إليه إجراء بعض عمليات التحقّق من صحة بيانات الزيارات في وقت التشغيل وواجهات برمجة التطبيقات الإدارية في مركز البيانات هذا، وبدء إعادة توجيه الزيارات إلى الخادم الوكيل وواجهة برمجة التطبيقات الإدارية إليه
  17. كرِّر الخطوات أعلاه لكل مركز بيانات تريد التراجع عنه.

العودة إلى الإصدار السابق من Cassandra باستخدام نسخة احتياطية

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

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

الخطوات

  1. اختَر عقدة واحدة تريد التراجع عنها. إذا كنت بصدد إرجاع جميع العُقد في مركز بيانات باستخدام نُسخ احتياطية، ابدأ بعُقد البداية أولاً. راجِع القسم "كيفية تحديد العُقد الأولية" في الملحق.

  2. أوقِف عقدة Cassandra وألغِ تثبيتها ونظِّفها باتّباع الخطوات التالية:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. ثبِّت برنامج Cassandra القديم على العقدة واضبطه:

    • نفِّذ ملف bootstrap لإصدار Edge for Private Cloud 4.52.02:
      • # Download bootstrap for 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap for 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    • أنشئ الملف /opt/apigee/customer/application/cassandra.properties أو عدِّله:
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • تأكَّد من أنّ ملف المفتاح يملكه مستخدم Apigee ويمكن قراءته:
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • ثبِّت Cassandra وأعِدّها على النحو التالي:
      • # Install Cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

    تأكَّد من بدء تشغيل العُقدة. تحقَّق من الأمر التالي على هذه العُقدة والعُقد الأخرى في المجموعة. يجب أن تشير العُقد إلى أنّ هذه العقدة في الحالة "UN":

    /opt/apigee/apigee-cassandra/bin/nodetool status

  4. أوقِف خدمة Cassandra واستعِد النسخة الاحتياطية. يُرجى الرجوع إلى مستندات الاحتفاظ بنسخة احتياطية من البيانات واستعادتها للحصول على مزيد من التفاصيل:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. بعد استعادة النسخة الاحتياطية، أزِل الإعدادات الإضافية باتّباع الخطوات التالية:

    أزِل الإعداد الذي أضفته سابقًا من الملف /opt/apigee/customer/application/cassandra.properties.

  6. ابدأ خدمة Cassandra على العقدة:

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

  7. كرِّر الخطوات على كل عقدة Cassandra تريد التراجع عنها باستخدام النُسخ الاحتياطية، واحدة تلو الأخرى.

  8. بعد استعادة جميع عُقد Cassandra، أعِد تشغيل جميع مكوّنات edge-* واحدًا تلو الآخر:

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

تحسينات النسخ الاحتياطي (خيار متقدّم)

يمكنك تقليل (أو منع) فقدان البيانات أثناء استعادة النُسخ الاحتياطية إذا كانت لديك نُسخ طبق الأصل متاحة تحتوي على أحدث البيانات. إذا كانت النُسخ المتماثلة متاحة، شغِّل عملية إصلاح على العُقدة التي تم استعادتها بعد استعادة النسخة الاحتياطية.

الملحق

كيفية تحديد العُقد الأولية

على أي عقدة Cassandra في مركز بيانات، نفِّذ الأمر التالي:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

سيعرض الأمر عدة أسطر. ابحث عن السطر الأخير من الناتج. عناوين IP المُدرَجة في السطر الأخير هي عُقد البداية. في المثال أدناه، DC-1-IP1 وDC-1-IP2 وDC-2-IP1 وDC-2-IP2 هي عناوين IP لعقدة البداية:

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

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

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

  1. نزِّل ملف bootstrap.sh للنسخة التي تريد الرجوع إليها:

    • للتراجع إلى الإصدار 4.52.02، نزِّل bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
  2. أوقِف المكوّن المطلوب التراجع عنه:
    1. للتراجع عن أي من المكوّنات التي تتضمّن رمزًا برمجيًا مشتركًا على عقدة، يجب إيقافها كلها، كما هو موضّح في المثال التالي: 
      /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
    2. لإرجاع أي مكوّن آخر على العقدة، أوقِف هذا المكوّن فقط: 
      /opt/apigee/apigee-service/bin/apigee-service component stop
  3. إذا كنت بصدد التراجع عن تفعيل ميزة تحقيق الربح، عليك إلغاء تثبيتها من جميع عقد خادم الإدارة ومعالج الرسائل باتّباع الخطوات التالية: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. ألغِ تثبيت المكوّن للرجوع إلى الإصدار السابق على العُقدة:
    1. للتراجع عن أي من المكوّنات التي تتضمّن رمزًا برمجيًا مشتركًا على عقدة ، عليك إلغاء تثبيت جميع هذه المكوّنات من خلال إلغاء تثبيت مجموعة المكوّنات edge-gateway، كما يوضّح المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. للتراجع عن Nginx، اتّبِع الخطوات التالية: 
      ###Find the apigee-nginx RPM 
rpm -qa | grep -i "apigee-nginx"

###Remove the apigee-nginx RPM
dnf remove apigee-nginx-1.26.x
    3. للتراجع عن أي مكون آخر على العقدة، عليك إلغاء تثبيت هذا المكون فقط، كما يوضّح المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      حيث component هو اسم المكوّن.

    4. لإرجاع Edge Router إلى الإصدار السابق، عليك حذف محتوى الملف /opt/nginx/conf.d بالإضافة إلى إلغاء تثبيت مجموعة المكوّنات edge-gateway: 
      cd /opt/nginx/conf.d
rm -rf *
  5. ألغِ تثبيت الإصدار 4.53.00 من apigee-setup باتّباع الخطوات التالية: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. ثبِّت الإصدار 4.52.02 من الأداة المساعدة apigee-service وتبعياته. يوضّح المثال التالي كيفية تثبيت الإصدار 4.52.02 من apigee-service: 
    sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

    حيث يمثّل uName وpWord اسم المستخدم وكلمة المرور اللذين تلقّيتهما من Apigee. إذا حذفت pWord، سيُطلب منك إدخاله.

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

  7. تثبيت apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. ثبِّت الإصدار الأقدم من المكوّن: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    حيث component هو المكوّن المطلوب تثبيته وconfigFile هو ملف الإعداد الخاص بالإصدار الأقدم.

  9. إذا كنت بصدد إرجاع Qpid إلى الإصدار السابق، عليك محو iptables: 
    sudo iptables -F
  10. كرِّر هذه العملية لكل عقدة تستضيف المكوّن الذي تريد التراجع عنه.

العودة إلى إصدار تصحيح سابق

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

  1. نزِّل إصدار المكوّن المحدّد: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    يمثّل component_version المكوّن وإصدار التصحيح المطلوب تثبيتهما. على سبيل المثال:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.53.00-0.0.20254 install

    إذا كنت تستخدم مستودع Apigee على الإنترنت، يمكنك تحديد إصدارات المكوّنات المتاحة باستخدام الأمر التالي: 

    yum --showduplicates list comp

    على سبيل المثال:

    yum --showduplicates list edge-ui
  2. استخدِم apigee-setup لتثبيت المكوّن: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    على سبيل المثال:

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

    يُرجى العِلم أنّه عليك تحديد اسم المكوّن فقط عند تثبيته، وليس الإصدار.

  3. كرِّر هذه العملية لكل عقدة تستضيف المكوّن الذي تريد التراجع عنه.

العودة إلى الإصدار السابق من mTLS

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

  1. إيقاف Apigee: 
    apigee-all stop
  2. إيقاف mTLS: 
    apigee-service apigee-mtls uninstall
  3. أعِد تثبيت mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf