نقل خوادم Apigee

Edge for Private Cloud - الإصدار 4.17.01

تستخدم مكونات Apigee عناوين 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 نفسه الذي تعثر عليه.
  5. أعِد تشغيل Cassandra:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra إعادة تشغيل
  6. إذا لزم الأمر، عليك أيضًا إصلاح ZooKeeper (انظر أدناه)، أو إعادة تشغيل كل مكوِّن من مكونات النظام الأساسي Apigee بدءًا من Management Server.

بالنسبة إلى الإعدادات التي تتضمّن عُقد 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:ra-dc
    default=1:ra-1:ra-dc1

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

  5. أعِد تشغيل Cassandra على النظام المعدّل. إذا كان النظام المعدّل عقدة أساسية، يجب أيضًا إعادة تشغيل كل نظام استخدم العقدة الأساسية المعدَّلة.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra إعادة تشغيل
  6. نفِّذ الأمر nodetool ring على العقدة المُعدَّلة للتأكُّد من اكتمال الحلقة. ويمكن العثور على الأداة على الرابط opt/apigee/apigee-cassandra/bin.
    >Nodetool -h localhost ring
  7. شغِّل إصلاح العُقد على العقدة المُعدَّلة. يُرجى العِلم أنّ هذه العملية قد تستغرق بعض الوقت، لذا ننصح بشدة بعدم تنفيذها خلال ساعات الذروة لواجهة برمجة التطبيقات.
    > dottool -h إصلاح المضيف المحلي
  8. إذا لزم الأمر، أصلح ZooKeeper (انظر أدناه)، ثم أعِد تشغيل كل مكون من مكونات النظام الأساسي Apigee بدءًا من Management Server.

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

  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 الجديدة باستخدام أحد الأوامر أدناه. وسيعتمد الأمر المطلوب على نوع العقدة التي تم تغييرها.

    ملاحظة: تشير معلَمة Region التالية إلى مركز البيانات الذي تتوفّر فيه المجموعة. على سبيل المثال، إذا كان مدى التوفّر مرتفعًا، سيكون لديك بشكل عام مجموعة في dc-1 (Dater Center 1) ومجموعة في dc-2 (مركز البيانات 2). ويتمّ تحديد هذه المَعلمة في وقت التثبيت. القيمة التلقائية هي dc-1.
    • بالنسبة إلى 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-form-formXurl
    • لهذا السبب
    • بالنسبة إلى type="reportcrud-datastore":
      curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers" -d "Type=reportcrud-datastore&internalIP=${NEW_IP}&region=${ISSUE}&pod=analytics" -H 'content-type: application/x-www-form-form/x-www-form-form-
  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:526.10:
    386.10.
  2. في كل عقدة ZooKeeper، عدِّل الملف /opt/apigee/customer/application/zookeeper.properties لضبط الخاصية conf_zoo_quorum على عناوين IP الصحيحة. إذا لم يكن الملف موجودًا، فأنشئه.
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888nserver.2=192.168.56.102:2888:3888nserver.3=192.168.56.104:2888:3888n
  3. ابحث عن قائد مجموعة ZooKeeper باستخدام الأمر التالي (استبدِل <node> بعنوان IP لجهاز Zookeeper):
    echo srvr | nc <node> 2181

    يجب أن يكون سطر الوضع في الإخراج "leader".
  4. أعِد تشغيل تطبيق ZooKeeper واحدًا تلو الآخر مع البدء بالقائد وينتهي بالعقدة التي تم تغيير عنوان IP من خلالها. في حال تغيير عناوين IP في أكثر من عقدة Zookeeper واحدة، قد يكون من الضروري إعادة تشغيل جميع العُقد.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper إعادة تشغيل
  5. استخدِم الأمر echo الموضّح أعلاه للتحقّق من صحة كل عقدة ZooKeeper.

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

  1. في كل عقدة من عُقد جهاز التوجيه، عدِّل الملف /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. في عقدة خادم الإدارة، عدِّل الملف /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 redirect

تغيير عنوان 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 إعادة تشغيل

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

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

  1. استخدِم أمر cURL التالي لتسجيل عنوان IP الجديد والداخلي والخارجي:
    curl -u $ADMINEMAIL:$PW -X PUT http://$MSIP:8080/v1/servers/<uuid> -d ExternalIP=<ip>
    curl -u $ADMINEMAIL:$PW/server -X PUT:

إذا كنت لا تعرف المعرّف الفريد العالمي للعقدة، يمكنك استخدام الأمر التالي لعرضه:

  • جهاز التوجيه: curl http://<router_IP>:8081/v1/servers/self
  • معالج الرسائل: curl http://<mp_IP>:8082/v1/servers/self
  • Qpid: curl http://<qp_IP>:8083/v1/servers/self
  • Postgres: curl http://<pg_IP>:8084/v1/servers/self