إعادة تثبيت المكونات واستعادتها

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

Apache ZooKeeper

استعادة عقدة مستقلة واحدة

1. أوقِف ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

2. إزالة أدلة ZooKeeper القديمة:

   /opt/apigee/data/apigee-zookeeper
   /opt/apigee/etc/apigee-zookeeper.d

3. أعِد تثبيت ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

4. استعادة ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. أعِد تشغيل جميع المكوّنات:

   /opt/apigee/apigee-service/bin/apigee-all restart

استعادة إحدى عُقد المجموعة

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

1. أعِد تثبيت ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install

2. نفِّذ عملية الإعداد على عقدة ZooKeeper باستخدام ملف الإعداد نفسه الذي تم استخدامه عند تثبيت العقدة الأصلية:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f configFile

3. ابدأ ZooKeeper:

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper start

استعادة مجموعة كاملة

1. أوقِف المجموعة الكاملة.
2. استعادة جميع عُقد ZooKeeper من ملف النسخة الاحتياطية كما هو موضّح أعلاه لعقدة واحدة
3. ابدأ تشغيل مجموعة ZooKeeper.
4. أعِد تشغيل جميع المكوّنات.

Apache Cassandra

استعادة عقدة مستقلة واحدة

1. إيقاف Cassandra:

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

2. إزالة دليل Cassandra القديم:

   /opt/apigee/data/apigee-cassandra

3. أعِد تثبيت Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra install

4. استعادة Cassandra:

   /apigee/apigee-service/bin/apigee-service apigee-cassandra restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. أعِد تشغيل جميع المكوّنات:
   

   /apigee/apigee-service/bin/apigee-all restart

استعادة إحدى عُقد المجموعة

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

إذا لم يعُد بالإمكان الوصول إلى العُقدة التي تعذّر تشغيلها، يجب إتلافها وعزل شبكتها لضمان عدم إمكانية إعادة الانضمام إلى مجموعة Cassandra بدون قصد. بعد ذلك، أنشئ عقدة جديدة بعنوان IP نفسه الخاص بالعقدة الأصلية ونفِّذ خطوات إعداد Apigee المعتادة عليها.

إذا كان لا يزال بإمكانك الوصول إلى العُقدة وأردت إعادة استخدامها، اتّبِع الخطوات التالية:

1. أوقِف عملية Cassandra على العُقدة:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
2. ألغِ تثبيت برنامج Cassandra من العقدة:
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
3. امحُ دليل البيانات من العقدة:
   rm -rf /opt/apigee/data/apigee-cassandra

بعد إكمال الخطوات أعلاه، يجب أن يكون لديك عقدة لها عنوان IP نفسه الخاص بالعقدة التي تعذّر تشغيلها، ويجب أن تكون العقدة جاهزة لتثبيت برامج Apigee. اتّبِع الخطوات التالية:

1. تحديد عُقد البداية في مركز البيانات
   1. على أي عقدة Cassandra تشغيلية في مركز البيانات نفسه الذي يتم استعادة العقدة منه، نفِّذ الأمر التالي:

      apigee-service apigee-cassandra configure -search conf_cassandra_seeds

   2. ستظهر نتيجة مشابهة لما يلي:

      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, "10.1.0.1,10.1.0.2", in /opt/apigee/token/application/cassandra.properties
      apigee-configutil: apigee-cassandra: # OK

   3. يُرجى الرجوع إلى السطر الأخير في الناتج. عناوين IP المفصولة بفواصل والمدرَجة هي العُقد الأولية التي تستخدمها العُقد في مركز البيانات هذا.
2. على العقدة الجديدة التي تتم استعادتها، أنشئ الملف التالي أو عدِّله:
   

   vi /opt/apigee/customer/application/cassandra.properties
   

3. Add the following line:
   

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=<ip-address-of-dead-node>

4. إذا كانت هذه العقدة إحدى عُقد البداية (يظهر عنوان IP الخاص بالعقدة في قائمة عُقد البداية من الخطوة 1)، أضِف سطرًا آخر في الملف:
   

   conf_cassandra_seeds="<comma-separated-seed-list-except-this-node’s-ip>"

   1. على سبيل المثال، في الحالة أعلاه، تحتوي قائمة العناوين الأولية على عنوانَي IP هما 10.1.0.1 و10.1.0.2. إذا كانت العقدة التي تتم استعادتها هي 10.1.0.1، أضِف سطرًا على النحو التالي:
      

      conf_cassandra_seeds="10.1.0.2"

5. احفظ الملف وتأكَّد من أنّ مستخدم Apigee يمتلكه ويمكنه قراءته:
   

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

6. ثبِّت برنامج Cassandra باتّباع الخطوات التالية:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

7. شغِّل إعداد Cassandra:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f <configFile>

8. سيحاول الإعداد داخليًا بدء خدمة Cassandra. قد تستغرق هذه العملية وقتًا طويلاً استنادًا إلى مقدار البيانات المطلوب بثّها من العُقد الأخرى ومعدّل نقل البيانات على الشبكة وما إلى ذلك.
9. [خيار متقدّم] يمكنك تسريع عملية بث البيانات من خلال تنفيذ أوامر nodetool التالية على العقدة:
   

   nodetool setstreamthroughput <value>
   nodetool setcompactionthroughput <value>

10. بعد إعادة تشغيل عقدة Cassandra، استخدِم الأوامر العادية مثل ما يلي للتأكّد من أنّ العقدة انضمّت إلى الحلقة بنجاح:
    

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

11. بعد التأكّد من أنّ العقدة تعمل بشكل صحيح، عدِّل الملف /opt/apigee/customer/application/cassandra.properties مرة أخرى وأزِل الأسطر التي أضفتها سابقًا في الخطوتين 3 و4 من هذا الإجراء.
12. أعِد تشغيل خدمة Cassandra على العقدة:
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

استعادة مجموعة كاملة

1. أوقِف المجموعة الكاملة.
2. استعادة جميع عُقد Cassandra من ملف النسخة الاحتياطية
3. ابدأ تشغيل مجموعة Cassandra.
4. أعِد تشغيل جميع المكوّنات.

قاعدة بيانات PostgreSQL

‫PosgreSQL يعمل بشكل مستقل أو كخادم رئيسي

1. أوقِف خادم الإدارة وخادم Qpid وخادم Postgres على جميع العُقد:

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

2. أعِد تثبيت قاعدة بيانات PostgreSQL:

   /apigee/apigee-service/bin/apigee-service apigee-postgresql install 

3. ابدأ PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

4. استعادة قاعدة بيانات PostgreSQL من ملف النسخة الاحتياطية:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restore 2019.03.17,14.40.41

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

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. ابدأ تشغيل خادم الإدارة وخادم Qpid وخادم Postgres على جميع العُقد:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

تشغيل PosgreSQL في وضع الاستعداد

1. أعِد تثبيت قاعدة بيانات PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql install

2. أعِد ضبط قاعدة بيانات PostgreSQL باستخدام ملف الإعداد نفسه الذي استخدمته لتثبيتها:
   

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup -f configFile

3. ابدأ PostgreSQL:

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start 

خادم Postgres

1. أوقِف خادم Postgres على جميع العُقد الرئيسية والاحتياطية:

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

2. إزالة أدلة خادم Postgres القديمة:

   /opt/apigee/data/edge-postgres-server /opt/apigee/etc/edge-postgres-server.d

3. أعِد تثبيت خادم Postgres:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server install

4. استعادة خادم Postgres من ملف النسخة الاحتياطية:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgre-server restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. ابدأ تشغيل خادم Postgres على جميع العُقد الرئيسية والاحتياطية:

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

خادم Qpid وQpidd

1. أوقِف Qpidd وQpid Server وPostgres Server على جميع العُقد:
   

   /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 apigee-qpidd stop

2. أزِل أدلة Qpid Server وQpidd القديمة:

   /opt/apigee/data/edge-qpid-server
   /opt/apigee/etc/edge-qpid-server.d
   /opt/apigee/data/apigee-qpidd
   /opt/apigee/etc/apigee-qpidd.d 

3. أعِد تثبيت Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd install 

4. استعادة Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. ابدأ Qpidd:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd start 

6. أعِد تثبيت Qpid Server:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server install

7. استعادة خادم Qpid:

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

8. أعِد تشغيل خوادم Qpid وQpidd وPostgres على جميع العُقد:

   /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

SymasLDAP

1. أوقِف SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap stop

2. أعِد تثبيت SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap install

3. إزالة أدلة SymasLDAP القديمة:

   /opt/apigee/data/apigee-openldap /opt/apigee/etc/apigee-openldap.d

4. استعادة SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. أعِد تشغيل SymasLDAP:

   /opt/apigee/apigee-service/bin/apigee-service apigee-openldap start

6. أعِد تشغيل جميع خوادم الإدارة:

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

خادم الإدارة

1. إيقاف خادم الإدارة:

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

2. إزالة أدلة "خادم الإدارة" القديمة:

   /opt/apigee/data/edge-management-server /opt/apigee/etc/edge-management-server.d

3. أعِد تثبيت خادم الإدارة باتّباع الخطوات التالية:

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

4. استعادة "خادم الإدارة" من ملف النسخة الاحتياطية:

   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. أعِد تشغيل خادم الإدارة:

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

معالج الرسائل

1. إيقاف معالج الرسائل:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop

2. إزالة أدلة "معالج الرسائل" القديمة:

   /opt/apigee/data/edge-message-processor
   /opt/apigee/etc/edge-message-processor.d

3. أعِد تثبيت "معالج الرسائل" باتّباع الخطوات التالية:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor install

4. استعادة "معالج الرسائل" من ملف النسخة الاحتياطية:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. أعِد تشغيل "معالج الرسائل" باتّباع الخطوات التالية:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor start

جهاز التوجيه

1. إيقاف جهاز التوجيه:

   /opt/apigee/apigee-service/bin/apigee-service edge-router stop

2. إزالة أدلة جهاز التوجيه القديمة:

   /opt/apigee/data/edge-router
   /opt/apigee/etc/edge-router.d

3. إعادة تثبيت جهاز التوجيه:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router install

4. استعادة بيانات جهاز التوجيه من ملف النسخة الاحتياطية:

   /opt/apigee/apigee-service/bin/apigee-service edge-router restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. إعادة تشغيل جهاز التوجيه:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-router start

واجهة مستخدم Edge

1. إيقاف واجهة المستخدم:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui stop

2. إزالة أدلة واجهة المستخدم القديمة:

   /opt/apigee/data/edge-ui
   /opt/apigee/etc/edge-ui.d

3. إعادة تثبيت واجهة المستخدم:
   

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

4. استعادة واجهة المستخدم من ملف النسخة الاحتياطية:

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restore 2019.03.17,14.40.41

   يُرجى العِلم أنّه عند استعادة أحد المكوّنات، لا تحدّد مسار الدليل إلى ملف النسخة الاحتياطية، ولا تحدّد البادئة "backup-" أو اللاحقة ".tar.gz". عليك تحديد جزء التاريخ/الوقت من اسم ملف النسخ الاحتياطي فقط.

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية في الأمر restore، وسيستخدم Edge أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطية للمكوّن.

5. إعادة تشغيل واجهة المستخدم:
   

   /opt/apigee/apigee-service/bin/apigee-service edge-ui start

استرداد الموقع الإلكتروني بالكامل

1. أوقِف جميع عُقد المكوّنات. يُرجى العِلم أنّ ترتيب إيقاف الأنظمة الفرعية مهم: عليك أولاً إيقاف جميع عُقد Edge، ثم إيقاف جميع عُقد مخزن البيانات.
2. استعادة جميع المكوّنات كما هو موضّح أعلاه
3. الآن، ابدأ تشغيل جميع المكوّنات بالترتيب التالي. يُرجى العِلم أنّ ترتيب بدء تشغيل الأنظمة الفرعية مهم:
   1. بدء مجموعة ZooKeeper
   2. بدء مجموعة Cassandra
   3. تأكَّد من أنّ SymasLDAP يعمل بشكلٍ سليم
   4. Start qpid
   5. التأكّد من أنّ قاعدة بيانات PostgreSQL تعمل بشكل سليم
   6. بدء خادم الإدارة
   7. بدء تشغيل أجهزة التوجيه ومعالجات الرسائل
   8. بدء خادم Qpid
   9. بدء خادم Postgres
   10. بدء واجهة مستخدم Apigee