نقل خوادم Apigee

الإصدار 4.18.05 من Edge for Private Cloud

تستخدم مكوّنات 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، وحدِّد الإعدادات التلقائية نفسها التي عثرت عليها أعلاه في الخطوة 3.

  5. أعِد تشغيل Cassandra:
    /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. أعِد تشغيل Cassandra على النظام المعدَّل. إذا كان النظام المعدَّل عقدة أولية، عليك أيضًا إعادة تشغيل كل نظام استخدم العقدة الأولية المعدَّلة.
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. نفِّذ الأمر nodetool ring على العقدة المعدَّلة للتأكّد من اكتمال الحلقة. يمكن العثور على الأداة المساعدة في /opt/apigee/apigee-cassandra/bin.
    nodetool -h localhost ring
  7. نفِّذ الأمر nodetool repair على العقدة المعدَّلة. يُرجى العِلم أنّ هذه العملية قد تستغرق بعض الوقت، لذا ننصح بشدة بعدم تنفيذها خلال ساعات الذروة لزيارات واجهة برمجة التطبيقات.
    nodetool -h localhost repair
  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

    يجب أن يظهر في سطر "الوضع" (Mode) في الناتج "leader".

  4. أعِد تشغيل ZooKeeper واحدًا تلو الآخر بدءًا من القائد وانتهاءً بالعقدة التي تم تغيير عنوان IP عليها. إذا تم تغيير عناوين IP لأكثر من عقدة zookeeper واحدة، قد يكون من الضروري إعادة تشغيل جميع العقد.
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  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 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 (وليس 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 -X PUT \
      http://$MSIP:8080/v1/servers/uuid -d InternalIP=ip

    حيث uuid هو المعرّف الفريد العالمي (UUID) للعقدة.

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

  • جهاز التوجيه:
    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