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

يتناول هذا المستند إعادة تثبيت أحد مكونات 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. أعِد تشغيل جميع المكوّنات.

أباتشي كاساندرا

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

1. أوقِف "كاساندرا":

   /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 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. ابدأ تشغيل المجموعة العنقودية "كاساندرا".
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:

   /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 Server و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

OpenLDAP

1. إيقاف OpenLDAP:

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

2. إعادة تثبيت OpenLDAP:

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

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

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

4. استعادة OpenLDAP:

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

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

   يمكنك اختياريًا حذف ملف النسخة الاحتياطية من خلال الأمر restore وسيتولى Edge تنفيذ الإجراء التالي: تستخدم أحدث ملف نسخة احتياطية في دليل النسخ الاحتياطي للمكون.

5. أعد تشغيل OpenLDAP:

   /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. بدء المجموعة العنقودية "كاساندرا"
   3. التأكد من أن OpenLDAP قيد التشغيل
   4. بدء qpid
   5. التأكّد من أنّ قاعدة بيانات PostgreSQL جاهزة وقيد التشغيل
   6. بدء خادم الإدارة
   7. بدء أجهزة التوجيه ومعالجات الرسائل
   8. بدء خادم Qpid
   9. بدء خادم Postgres
   10. بدء واجهة مستخدم Apigee