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

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

इस सेक्शन में, कॉन्फ़िगरेशन के मेल न खाने का पता लगाने और उसे ठीक करने का तरीका बताया गया है.

आईपी पते बनाम होस्ट नाम

आपको अपनी कॉम्पोनेंट कॉन्फ़िगरेशन फ़ाइलों में होस्ट नामों के बजाय आईपी पतों का इस्तेमाल करना चाहिए.

जबकि कुछ कॉम्पोनेंट कॉन्फ़िगरेशन फ़ाइलें आपको इसके बजाय होस्ट नेम का इस्तेमाल करने की अनुमति देती हैं का इस्तेमाल करते हैं, तो होस्ट नामों का इस्तेमाल करने से समस्या का हल मुश्किल हो सकता है. उदाहरण के लिए, होस्ट के नाम की वजह से, डीएनएस सर्वर कनेक्टिविटी, लुकअप के काम नहीं करने, और सिंक करना.

यही वजह है कि Apigee, सभी कॉम्पोनेंट के लिए आईपी पतों का इस्तेमाल करने का सुझाव देता है कॉन्फ़िगरेशन. कुछ मामलों में, जैसे कि Cassandra के साथ, आपको IP पतों का उपयोग करना होगा और आप होस्ट के नाम. दस्तावेज़ में दिए गए ज़्यादातर उदाहरणों में, कॉम्पोनेंट कॉन्फ़िगरेशन के लिए आईपी पतों का इस्तेमाल किया जाता है.

होस्ट के नामों और आईपी पतों के लिए, इन स्थितियों में लागू होने वाले नतीजों पर ध्यान दें Apigee सर्वर को मूव करते समय:

स्थिति एक जगह से दूसरी जगह पर ले जाने वाले सर्वर पर असर
आईपी पते में बदलाव वे सभी फ़ाइलें अपडेट करें जिनमें ओरिजनल आईपी पते का रेफ़रंस दिया गया हो
आईपी पते में बदलाव के बिना होस्टनेम में बदलाव कोई असर नहीं पड़ा
आईपी पते में बदलाव के साथ होस्टनेम में बदलाव आईपी पते में बदलाव के समान

कैसंड्रा नोड का आईपी पता बदलना

किसी कैसंड्रा नोड का आईपी पता बदलने के लिए, नीचे दिया गया तरीका अपनाएं:

इसके लिए एकल कैसंड्रा नोड के साथ कॉन्फ़िगरेशन

  1. /opt/apigee/customer/application/cassandra.properties में बदलाव करें बदलाव किए जा रहे हैं. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
  2. इन पैरामीटर में बदलाव करें:
    • conf_cassandra_seeds और conf_cassandra_listen_address सेट करें पैरामीटर का इस्तेमाल करें.
    • इस्तेमाल करने के लिए conf_cassandra_rpc_address को बदलें या तो नया IP पता या 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 में बदलाव करें पुराने IP पते को नए IP पते में बदलने के लिए: 
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    पक्का करें कि आपने "\n" डाला हो डालें और वही डिफ़ॉल्ट सेटिंग दर्ज करें जो जो ऊपर चरण 3 में मिले हैं.

  5. कैसेंड्रा को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. अगर ज़रूरी हो, तो ZooKeeper (नीचे देखें) को भी ठीक करें. अगर ऐसा नहीं है, तो हर Apigee प्लैटफ़ॉर्म को रीस्टार्ट करें जो मैनेजमेंट सर्वर से शुरू होता है.

इसके लिए एक से ज़्यादा कैसंड्रा नोड (अंगूठी) वाले कॉन्फ़िगरेशन

  1. अगर बदला जा रहा नोड एक सीड नोड है, तो /opt/apigee/customer/application/cassandra.properties में बदलाव करें फ़ाइल डाउनलोड करें और conf_cassandra_seeds पैरामीटर को शामिल करके शामिल करने के लिए संशोधित सिस्टम का नया IP. अगर cassandra.property फ़ाइल मौजूद नहीं है, तो बनाएं इसे.
  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 खोलें एक एडिटर में. आपको फ़ॉर्म: 
    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" डाला हो डालें और उसी डिफ़ॉल्ट सेटिंग का उपयोग करें, जिसका उपयोग आप ऊपर चरण 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 की पुष्टि करने की सुविधा चालू है.

  7. nodetool repair को इस पर चलाएं संशोधित नोड. ध्यान दें कि इस प्रोसेस में कुछ समय लग सकता है. इसलिए, हमारा सुझाव है कि आप इस प्रोसेस को बेहतर बनाएं जब एपीआई ट्रैफ़िक की सबसे ज़्यादा व्यस्त अवधि के दौरान ऐसा न होता हो. 
    nodetool [-u username -pw password] -h localhost repair -pr
  8. अगर ज़रूरी हो, तो ZooKeeper (नीचे देखें) ठीक करें. इसके बाद, Apigee प्लैटफ़ॉर्म के हर कॉम्पोनेंट को रीस्टार्ट करें, पहली बार मौजूद होता है.

डेटास्टोर अपडेट करें रजिस्ट्रेशन

  1. पुराने आईपी पते का इस्तेमाल करके, डेटास्टोर रजिस्ट्रेशन के यूयूआईडी ढूंढने के लिए इनका इस्तेमाल करें: दिए गए निर्देशों का पालन करें. "टाइप" पर ध्यान दें और "यूयूआईडी" पैरामीटर: 
    • 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. नीचे दिए गए निर्देशों में से किसी एक का इस्तेमाल करके, नए आईपी पतों को रजिस्टर करें. इस निर्देश की मदद से, बदले गए नोड के प्रकार पर निर्भर करते हैं.
    • 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): 
    echo srvr | nc node 2181

    आउटपुट में, मोड लाइन में "leader" लिखा होना चाहिए.

  4. एक जिसका आईपी पता बदला गया था. अगर एक से ज़्यादा ज़ूकीपर नोड ने आईपी पते बदले हैं, तो यह सभी नोड को रीस्टार्ट करने के लिए ज़रूरी होगा. 
    /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 नोड का आईपी पता बदलना प्रकार

इनमें से किसी भी तरह के नोड (Router, मैसेज प्रोसेसर, 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, नोड का यूयूआईडी होता है.

कॉम्पोनेंट का यूयूआईडी पाने का तरीका जानने के लिए, यूयूआईडी पाना लेख पढ़ें.