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

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

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

  • الإصدار 4.52.02

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

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

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

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

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

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

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

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

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

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

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

يجب أن يكون المستخدم الذي يُجري عملية التراجع هو نفسه المستخدم الذي أجرى تحديث 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 مخطّط البيانات المخزّنة على تلك العقدة. نتيجةً لذلك، لا يمكن إجراء عملية التراجع المباشرة في مكانها.

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

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

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

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

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

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

  • الرجوع إلى إصدار سابق من مكوّنات وقت التشغيل أو الإدارة: إذا كنت تريد الرجوع إلى إصدار سابق من مكوّنات مثل edge-management-server أو edge-message-processor أو أي مكوّن غير Cassandra إلى الإصدار 4.52.02 من Private Cloud، ننصحك بعدم الرجوع إلى إصدار سابق من Cassandra. إنّ إصدار Cassandra المُرسَل مع Private Cloud 4.53.00 متوافق مع جميع المكوّنات غير التابعة لخدمة Cassandra في Edge for Private Cloud 4.52.02. يمكنك التراجع عن المكونات غير التابعة لـ 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، ننصحك بالتراجع عن الترقية. يمكن اتّباع استراتيجيات التراجع المدرَجة في هذه المقالة استنادًا إلى الحالة التي تكون فيها أثناء عملية الترقية.
  • الرجوع إلى الحالة السابقة باستخدام النُسخ الاحتياطية: لا تتوافق النُسخ الاحتياطية التي تم أخذها من 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 (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 (Up/Normal) عند تنفيذ الأمر 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، وألغِ تثبيته، ونظِّف البيانات من عقدته. اختَر أول عقدة بذرة على إصدار Cassandra 4 في مركز البيانات هذا. يُرجى التوقف عن ذلك. 
    # 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 الخاص بإصدار Edge for Private Cloud 4.52.02 
    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

ضبط إعدادات Cassandra

  1. أنشئ الملف /opt/apigee/customer/application/cassandra.properties أو عدِّله.
  2. أضِف المحتوى التالي إلى الملف. ipOfNode هو عنوان IP للعقدة التي تستخدمها Cassandra للتواصل مع عقد Cassandra الأخرى: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  3. تأكَّد من أنّ ملف apigee مملوك ومقروء من قِبل المستخدم: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  4. تثبيت Cassandra وإعداده:
    • تثبيت الإصدار 3.11.X من Cassandra: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
    • يمكنك إعداد Cassandra من خلال تمرير ملف الضبط العادي: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
    • تأكَّد من تثبيت Cassandra 3.11.X وتشغيل الخدمة: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  5. تأكَّد من بدء تشغيل العقدة. تحقّق من الأمر التالي على هذه العقدة والعقد الأخرى في المجموعة. من المفترض أن تُبلغ العقدة عن أنّها في الحالة "UN" (متصل/عادي): 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  6. أزِل الإعدادات الإضافية التي تمت إضافتها سابقًا من الملف /opt/apigee/customer/application/cassandra.properties.
  7. كرِّر الخطوات من 3 إلى 6 على جميع العقد الأساسية لنظام Cassandra في مركز البيانات، واحدة تلو الأخرى.
  8. كرِّر الخطوات من 3 إلى 6 على جميع عقد Cassandra المتبقية في مركز البيانات، واحدة تلو الأخرى.
  9. إعادة إنشاء جميع العقد في مركز البيانات من مركز بيانات يعمل بالإصدار الأقدم من Cassandra نفِّذ هذه الخطوة عقدة واحدة في كل مرة: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>
    قد تستغرق هذه العملية بعض الوقت. يمكنك تعديل streamingthroughput إذا لزم الأمر. يمكنك التحقّق من الحالة باستخدام: 
    /opt/apigee/apigee-cassandra/bin/nodetool netstats
  10. أعِد تشغيل جميع مكوّنات 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
  11. التحقّق من صحة البيانات وإعادة توجيه الزيارات إلى مركز البيانات هذا يمكنك إجراء بعض عمليات التحقّق من عدد الزيارات في وقت التشغيل وواجهات برمجة التطبيقات الخاصة بالإدارة في مركز البيانات هذا، وبدء إعادة توجيه عدد الزيارات إلى واجهتَي برمجة التطبيقات Proxy وManagement API.
  12. كرِّر الخطوات أعلاه لكل مركز بيانات تريد التراجع عنه.

التراجع عن التغييرات في 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

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

    /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. لإلغاء تثبيت أيّ من المكوّنات التي تتضمّن رمزًا شائعًا في node، يجب إلغاء تثبيتها كلها من خلال إلغاء تثبيت مجموعة المكوّنات edge-gateway، كما هو موضّح في المثال التالي: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway 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 *
  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