نقل خوادم Apigee

قد يؤدي نقل المكوّنات من جهاز إلى آخر إلى حدوث عدم تطابق في الإعدادات إذا لم تكن تحافظ على مزامنة عناوين IP في ملفات إعدادات المكوّنات.

يوضّح هذا القسم كيفية تشخيص عدم تطابق الإعدادات وإصلاحه.

عناوين IP مقابل أسماء المضيف

يجب عليك استخدام عناوين IP بدلاً من أسماء المضيفين في ملفات إعداد المكوّنات.

تسمح لك بعض ملفات إعداد المكونات باستخدام أسماء المضيفين بدلاً من من عناوين IP، فقد يؤدي استخدام أسماء المضيفين إلى تعقيد عملية استكشاف الأخطاء وإصلاحها. على سبيل المثال، أسماء المضيفين مصدرًا للمشكلات المتعلقة باتصال خادم نظام أسماء النطاقات وإخفاقات البحث المزامنة.

ونتيجةً لذلك، تنصح Apigee بشدة باستخدام عناوين IP لجميع مكوّنات الإعدادات. في بعض الحالات، كما هو الحال مع Cassandra، يجب استخدام عناوين IP ولا يمكن استخدامها أسماء المضيفين. تستخدم معظم الأمثلة في الوثائق عناوين IP لتهيئة المكوِّن.

بالنسبة إلى أسماء المضيف وعناوين IP، يجب مراعاة الآثار المترتبة على السيناريوهات التالية عند نقل خوادم Apigee:

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

تغيير عنوان IP لعقدة Cassandra

لتغيير عنوان IP لعقدة Cassandra، يمكنك اتّباع الخطوات التالية:

بالنسبة الإعدادات بعقدة Cassandra واحدة

1. عدِّل /opt/apigee/customer/application/cassandra.properties في النظام الذي يتم تعديله. إذا لم يكن الملف متوفّرًا، أنشئه.
2. غيِّر المَعلمات التالية:
   • ضبط conf_cassandra_seeds وconf_cassandra_listen_address لتحديد عنوان IP الجديد للنظام.
   • يجب تغيير "conf_cassandra_rpc_address" لاستخدام الميزة إما عنوان IP الجديد أو 0.0.0.0 (مما يتيح لـ Cassandra Thrift الاستماع على جميع الواجهات).
3. فَتْحْ /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties في أحد المحررين. ومن المفترض أن يظهر عنوان IP القديم والإعداد التلقائي في النموذج:

   192.168.56.101=dc-1:ra-1
   default=dc-1:ra-1

   احفظ تلك المعلومات.

4. تعديل /opt/apigee/customer/application/cassandra.properties لتغيير عنوان IP القديم المحدد لعنوان IP الجديد:

   conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

   تأكد من إدراج "\n" بعد عنوان IP، وحدد نفس الإعدادات الافتراضية التي وجدتها أعلاه في الخطوة 3.

5. أعِد تشغيل كاساندرا:

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

6. عليك أيضًا إصلاح ZooKeeper (انظر أدناه)، أو إعادة تشغيل كل منصة Apigee إذا لزم الأمر. بدءًا من خادم الإدارة.

بالنسبة الإعدادات ذات العُقد المتعددة لـ Cassandra (حلقة)

1. إذا كانت العقدة التي يتم تغييرها هي عقدة أساسية، تحرير /opt/apigee/customer/application/cassandra.properties على كل نظام في الحلقة، وتغيير معلَمة conf_cassandra_seeds لتضمينها. عنوان IP الجديد للنظام المعدّل. إذا لم يكن ملف cassandra.properties متوفّرًا، أنشئ الملف.
2. عدِّل /opt/apigee/customer/application/cassandra.properties في النظام الذي يتم تعديله، وغيِّر المَعلمات التالية:
   • اضبط conf_cassandra_listen_address لاستخدام عنوان IP الجديد.
   • اضبط conf_cassandra_rpc_address لاستخدام عنوان IP الجديد أو "0.0.0.0". (وهو ما يسمح لشركة Cassandra Thrift بالاستماع على جميع الواجهات).
3. فَتْحْ /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties في أحد المحررين. من المفترض أن ترى جميع عناوين IP لجهاز Cassandra والإعداد التلقائي في النموذج:

   192.168.56.101=dc-1:ra-1
   192.168.56.102=dc-1:ra-1
   192.168.56.103=dc-1:ra-1
   default=dc-1:ra-1

   احفظ تلك المعلومات.

4. تعديل /opt/apigee/customer/application/cassandra.properties لتغيير عنوان IP القديم المحدد لعنوان IP الجديد:

   conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n

   تأكد من إدراج "\n" كل عنوان IP، واستخدام الإعدادات الافتراضية نفسها التي تستخدمها كما هو موضح أعلاه في الخطوة 3.

5. أعِد تشغيل "كاساندرا" على النظام المعدّل. إذا كان النظام المعدَّل هو عقدة بذرة، يجب أيضًا إعادة تشغيل كل نظام استخدم عقدة البذرة المعدَّلة.

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

6. شغِّل الأمر nodetool ring على العقدة المعدَّلة للتأكّد من أنّ الحلقة مكتملة. يمكن العثور على الأداة على /opt/apigee/apigee-cassandra/bin

   nodetool [-u username -pw password] -h localhost ring

   ما عليك سوى إدخال اسم المستخدم وكلمة المرور إذا كنت: تم تفعيل مصادقة JMX على Cassandra.

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

   nodetool [-u username -pw password] -h localhost repair -pr

8. إذا لزم الأمر، عليك إصلاح ZooKeeper (انظر أدناه)، ثم إعادة تشغيل كل مكون من مكونات نظام Apigee. بدءًا بخادم الإدارة.

تحديث مخزن البيانات عمليات التسجيل

1. ابحث عن المعرفات الفريدة العامة (UUID) لتسجيلات مخزن البيانات التي تحدد عنوان IP القديم باستخدام الأوامر أدناه. يُرجى ملاحظة المَعلمتَين type وUUID:

   • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central&region=DC" | egrep -i '[type|internalip|uuid|region]'

   • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '[type|internalip|uuid|region]'

   • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '[type|internalip|uuid|region]'

     حيث DC هو اسم مركز البيانات. في عملية تثبيت واحدة لمركز بيانات، "dc-1" عادةً.

2. سجِّل عناوين IP الجديدة باستخدام أحد الأوامر أدناه. سيعتمد الأمر المطلوب على نوع العقدة التي تم تغييرها.
   • بالنسبة إلى type="application-datastore":

     curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \
       "Type=application-datastore&Type=audit-datastore&InternalIP=NEWIP&region=REGION&pod=central" \
       -H 'content-type: application/x-www-form-urlencoded' -X POST

   • بالنسبة إلى type="kms-datastore":

     curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \
       "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore \
       &InternalIP=NEWIP&region=REGION&pod=GATEWAY_POD" -H 'content-type: \
       application/x-www-form-urlencoded' -X POST

   • بالنسبة إلى type="reportcrud-datastore":

     curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers" -d \
       "Type=reportcrud-datastore&InternalIP=NEW_IP&region=REGION&pod=analytics" \
       -H 'content-type: application/x-www-form-urlencoded' -X POST 

3. حذف عمليات التسجيل القديمة لـ UUID للنظام الذي تم فيه تغيير عنوان IP لكل مشكلة من مشاكل المعرّف الفريد العالمي (UUID) التالية:

   curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE

تغيير عنوان IP لعقدة ZooKeeper

اتّبِع الخطوات التالية لتغيير عنوان IP لأحد عقد ZooKeeper:

تغيير عنوان IP وإعادة تشغيل مجموعة ZooKeeper (لإعدادات المجموعات المتعدّدة العقد فقط)

1. افتح /opt/apigee/apigee-zookeeper/conf/zoo.cfg في محرِّر. من المفترض أن ترى جميع عناوين IP لـ ZooKeeper والإعداد الافتراضي في النموذج:

   server.1=192.168.56.101:2888:3888
   server.2=192.168.56.102:2888:3888
   server.3=192.168.56.103:2888:3888

   احفظ تلك المعلومات.

2. في كل عقدة ZooKeeper، عدِّل الملف /opt/apigee/customer/application/zookeeper.properties لضبط خاصية conf_zoo_quorum على عناوين IP الصحيحة. إذا كان الملف غير موجود، قم بإنشائه.

   conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\n

   تأكد من إدراج "\n" كل عنوان IP وأن تكون الإدخالات بنفس الترتيب على كل عقدة.

3. ابحث عن قائد مجموعة ZooKeeper باستخدام الأمر التالي (استبدل node باستخدام عنوان IP لجهاز Zookeeper):

   echo srvr | nc node 2181

   ومن المفترض أن يتضمن سطر الوضع في الإخراج كلمة "leader".

4. إعادة تشغيل ZooKeeper واحد بعد الآخر بدءًا بالقائد وينتهي بالعقدة على الذي تم تغيير عنوان IP فيه. في حال تغيير أكثر من عقدة Zookeeper واحدة، قد يحدث ذلك اللازمة لإعادة تشغيل جميع العقد.

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart

5. استخدِم الأمر echo الموضّح أعلاه للتحقّق من كل عقدة ZooKeeper.

إبلاغ عُقد Apigee بالإعداد الذي تم تغييره

1. في كل عقدة Router، عدِّل الملف /opt/apigee/customer/application/router.properties على النحو التالي. إذا لم يكن الملف متوفّرًا، أنشئه.
   • غيِّر المعلَمة conf_zookeeper_connection.string لتضمين عنوان IP الجديد. الْعِنْوَانْ
   • غيِّر المعلَمة conf_zookeeper_zk1.host لتضمين عنوان IP الجديد. الْعِنْوَانْ
2. في كل عقدة معالج الرسائل، عدِّل الملف /opt/apigee/customer/application/message-processor.properties على النحو التالي. إذا لم يكن الملف متوفّرًا، أنشئه.
   • غيِّر مَعلمة conf_zookeeper_connection.string لتضمين المَعلمة الجديدة. عنوان IP
   • غيِّر المعلَمة conf_zookeeper_zk1.host لتضمين عنوان IP الجديد. الْعِنْوَانْ
3. في عقدة Management Server (خادم الإدارة)، عدِّل الملف /opt/apigee/customer/application/management-server.properties على النحو التالي. إذا لم يكن الملف متوفّرًا، أنشئه.
   • غيِّر مَعلمة conf_zookeeper_connection.string لتضمين المَعلمة الجديدة. عنوان IP
   • غيِّر المعلَمة conf_zookeeper_zk1.host لتضمين عنوان IP الجديد. الْعِنْوَانْ
4. أعِد تشغيل جميع مكونات نظام Apigee الأساسي من خلال تشغيل الأمر التالي في كل عقدة:

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

تغيير عنوان IP لخادم LDAP (OpenLDAP)

لتغيير عنوان IP لعقدة OpenLDAP، يمكنك إجراء ما يلي:

1. في عقدة "خادم الإدارة"، عدِّل ملف /opt/apigee/customer/application/management-server.properties . إذا لم يكن الملف متوفّرًا، أنشئه.
2. في ملف management-server.properties، اضبط قيمة مَعلمة conf_security_ldap.server.host إلى عنوان IP الجديد.
3. إعادة تشغيل خادم الإدارة:

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

تغيير عنوان IP لعقدة Apigee أخرى الأنواع

لتغيير عنوان IP لأي من أنواع العُقد التالية (جهاز التوجيه، معالج الرسائل، Postgres) Server (not postgresql) وQpid Server (وليس qpidd):

1. استخدِم الأمر curl التالي لتسجيل عنوان IP الجديد والداخلي والخارجي:

   curl -u ADMINEMAIL:PW -X PUT \
     http://MSIP:8080/v1/servers/uuid -d ExternalIP=ip
   curl -u ADMINEMAIL:PW -X PUT \
     http://$MSIP:8080/v1/servers/uuid -d InternalIP=ip

   تمثّل هذه السمة uuid المعرّف الفريد العالمي للعقدة.

للحصول على معلومات عن كيفية الحصول على المعرّف الفريد العالمي (UUID) للمكوّن، يُرجى الاطّلاع على الحصول على أرقام التعريف الفريدة العالمية (UUID).