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

يتناول هذا المستند إعادة تثبيت أحد مكونات 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:

   /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. أعِد تثبيت Management Server:

   /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. أزِل أدلة Router القديمة:

   /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. إيقاف واجهة مستخدم Edge الجديدة:

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

2. أزِل أدلة New Edge UI القديمة:

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

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

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

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

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

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

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

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

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

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

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