Apigee सर्वर को दूसरी जगह ले जाना

Edge for Private Cloud v. 4.17.01

Apigee के कॉम्पोनेंट, एक-दूसरे से कम्यूनिकेट करने के लिए आईपी पतों का इस्तेमाल करते हैं. कॉम्पोनेंट को एक मशीन से दूसरी मशीन में ले जाने पर, कॉन्फ़िगरेशन में अंतर हो सकता है. कॉन्फ़िगरेशन के मेल न खाने की समस्या को ठीक करने के लिए, यहां दिए गए निर्देशों का पालन करें.

Cassandra नोड का आईपी पता बदलना

Cassandra नोड का आईपी पता बदलने के लिए, यह तरीका अपनाएं:

एक Cassandra नोड वाले कॉन्फ़िगरेशन के लिए

  1. जिस सिस्टम में बदलाव किया जा रहा है उस पर /opt/apigee/customer/application/cassandra.properties में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
  2. इन पैरामीटर को बदलें:
    • सिस्टम का नया आईपी पता बताने के लिए, conf_cassandra_seeds और conf_cassandra_listen_address पैरामीटर सेट करें.
    • conf_cassandra_rpc_address को बदलकर, नए आईपी पते या 0.0.0.0 का इस्तेमाल करें. इससे Cassandra Thrift को सभी इंटरफ़ेस पर सुनने की अनुमति मिलती है.
  3. किसी एडिटर में /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties खोलें. आपको पुराना आईपी पता और डिफ़ॉल्ट सेटिंग इस फ़ॉर्मैट में दिखनी चाहिए:
    192.168.56.101=dc-1:ra-1
    default=dc-1:ra-1

    यह जानकारी सेव करें.
  4. /opt/apigee/customer/application/cassandra.properties में बदलाव करें, ताकि बताए गए पुराने आईपी पते को नए आईपी पते में बदला जा सके:
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    पक्का करें कि आपने आईपी पते के बाद “\n” डाला हो और वही डिफ़ॉल्ट सेटिंग डाली हों जो आपको तीसरे चरण में मिली थीं.
  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 पैरामीटर को बदलें. अगर cassandra.properties फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
  2. जिस सिस्टम में बदलाव किया जा रहा है उस पर /opt/apigee/customer/application/cassandra.properties में बदलाव करें. साथ ही, इन पैरामीटर को बदलें:
    • नए आईपी पते का इस्तेमाल करने के लिए, conf_cassandra_listen_address को सेट करें.
    • नए आईपी पते या 0.0.0.0 का इस्तेमाल करने के लिए, conf_cassandra_rpc_address को सेट करें. इससे Cassandra Thrift को सभी इंटरफ़ेस पर सुनने की अनुमति मिलती है.
  3. किसी एडिटर में /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties खोलें. आपको 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 में बदलाव करें, ताकि बताए गए पुराने आईपी पते को नए आईपी पते में बदला जा सके:
    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" डाला हो. साथ ही, तीसरे चरण में रिकॉर्ड की गई डिफ़ॉल्ट सेटिंग का इस्तेमाल करें.
  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. नीचे दिए गए निर्देशों का इस्तेमाल करके, पुराने आईपी पते की जानकारी देने वाले डेटास्टोर रजिस्ट्रेशन के यूयूआईडी ढूंढें. "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. यहां दिए गए किसी एक निर्देश का इस्तेमाल करके, नए आईपी पते रजिस्टर करें. ज़रूरी कमांड, बदले गए नोड के टाइप पर निर्भर करेगा.

    ध्यान दें: नीचे दिया गया REGION पैरामीटर, उस डेटासेंटर के बारे में बताता है जिसमें क्लस्टर मौजूद है. उदाहरण के लिए, ज़्यादा अपटाइम के लिए, आम तौर पर आपके पास dc-1 (डेटा सेंटर 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-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. उस सिस्टम के यूयूआईडी के लिए पुराने रजिस्ट्रेशन मिटाएं जिस पर आईपी पता बदला गया था. इनमें से हर यूयूआईडी के लिए, यह कमांड डालें:
    curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

ZooKeeper नोड का आईपी पता बदलना

ZooKeeper नोड का आईपी पता बदलने के लिए, यह तरीका अपनाएं:

आईपी पता बदलें और ZooKeeper एन्सेम्बल को रीस्टार्ट करें (सिर्फ़ मल्टी-नोड एन्सेम्बल कॉन्फ़िगरेशन के लिए)

  1. किसी एडिटर में /opt/apigee/apigee-zookeeper/conf/zoo.cfg खोलें. आपको 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 प्रॉपर्टी को सही आईपी पतों पर सेट किया जा सके. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
    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” डाला हो और हर नोड पर एंट्री एक ही क्रम में हों.
  3. नीचे दिए गए कमांड का इस्तेमाल करके, ZooKeeper एन्सेम्बल के लीडर को ढूंढें. इसके लिए, <node> को Zookeeper मशीन के आईपी पते से बदलें:
    echo srvr | nc <node> 2181

    आउटपुट में मोड लाइन में "लीडर" लिखा होना चाहिए.
  4. एक के बाद एक ZooKeeper को रीस्टार्ट करें. इसकी शुरुआत लीडर से करें और उस नोड पर खत्म करें जिस पर आईपी पता बदला गया था. अगर एक से ज़्यादा zookeeper नोड के आईपी पते बदले गए हैं, तो हो सकता है कि आपको सभी नोड रीस्टार्ट करने पड़ें.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. हर ZooKeeper नोड की पुष्टि करने के लिए, ऊपर बताए गए echo कमांड का इस्तेमाल करें.

बदले गए कॉन्फ़िगरेशन के बारे में Apigee नोड को जानकारी देना

  1. हर राऊटर नोड पर, /opt/apigee/customer/application/router.properties फ़ाइल में इस तरह बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
    • नए आईपी पते को शामिल करने के लिए, conf_zookeeper_connection.string पैरामीटर को बदलें
    • नया आईपी पता शामिल करने के लिए, conf_zookeeper_zk1.host पैरामीटर को बदलें
  2. हर मैसेज प्रोसेसर नोड पर, /opt/apigee/customer/application/message-processor.properties फ़ाइल में इस तरह बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
    • नया आईपी पता शामिल करने के लिए, conf_zookeeper_connection.string पैरामीटर बदलें
    • नया आईपी पता शामिल करने के लिए, conf_zookeeper_zk1.host पैरामीटर को बदलें
  3. मैनेजमेंट सर्वर नोड पर, /opt/apigee/customer/application/management-server.properties फ़ाइल में इस तरह बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
    • नया आईपी पता शामिल करने के लिए, conf_zookeeper_connection.string पैरामीटर बदलें
    • नया आईपी पता शामिल करने के लिए, conf_zookeeper_zk1.host पैरामीटर को बदलें
  4. हर नोड पर यह कमांड चलाकर, Apigee प्लैटफ़ॉर्म के सभी कॉम्पोनेंट को रीस्टार्ट करें:
    /opt/apigee/apigee-service/bin/apigee-all restart

किसी LDAP सर्वर का आईपी पता बदलना (OpenLDAP)

OpenLDAP नोड का आईपी पता बदलने के लिए, यह तरीका अपनाएं:

  1. मैनेजमेंट सर्वर नोड पर, /opt/apigee/customer/application/management-server.properties फ़ाइल में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
  2. management-server.properties फ़ाइल में, conf_security_ldap.server.host पैरामीटर को नए आईपी पते पर सेट करें.
  3. मैनेजमेंट सर्वर को रीस्टार्ट करें:
    > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

अन्य Apigee नोड टाइप का आईपी पता बदलना

इनमें से किसी भी नोड टाइप (राऊटर, मैसेज प्रोसेसर, Postgres सर्वर (postgresql नहीं), और Qpid सर्वर (qpidd नहीं)) का आईपी पता बदलने के लिए:

  1. नए इंटरनल और एक्सटर्नल आईपी पते को रजिस्टर करने के लिए, इस cURL कमांड का इस्तेमाल करें:
    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, नोड का यूयूआईडी है.

अगर आपको नोड का यूयूआईडी नहीं पता है, तो उसे देखने के लिए इस निर्देश का इस्तेमाल करें:

  • राऊटर: 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