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

Edge for Private Cloud v4.19.01

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

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

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

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

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

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

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

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

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

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

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

1. जिस सिस्टम में बदलाव किया जा रहा है उस पर /opt/apigee/customer/application/cassandra.properties में बदलाव करें. अगर फ़ाइल मौजूद नहीं है, तो उसे बनाएं.
2. इन पैरामीटर को बदलें:
   • सिस्टम का नया आईपी पता बताने के लिए, conf_cassandra_seeds और 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
   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. कैसंड्रा को रीस्टार्ट करें:

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

6. अगर ज़रूरी हो, तो ZoomKeeper को ठीक करें (नीचे देखें), या फिर मैनेजमेंट सर्वर से शुरू करते हुए, हर Apigee प्लैटफ़ॉर्म कॉम्पोनेंट को रीस्टार्ट करें.

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

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. बदले गए सिस्टम पर कैसेंड्रा को रीस्टार्ट करें. अगर बदला गया सिस्टम एक सीड नोड है, तो हर उस सिस्टम को रीस्टार्ट करें जिसने बदले गए सीड नोड का इस्तेमाल किया था.

   /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. अगर ज़रूरी हो, तो ZoomKeeper को ठीक करें (नीचे देखें). इसके बाद, मैनेजमेंट सर्वर से शुरू करते हुए, हर 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 नोड का आईपी पता बदलने के लिए यह तरीका अपनाएं:

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

1. /opt/apigee/apigee-zookeeper/conf/zoo.cfg को किसी एडिटर में खोलें. आपको सभी चिड़ियाघर के आईपी पते और डिफ़ॉल्ट सेटिंग इस फ़ॉर्म में दिखेंगी:

   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. हर ZKeeper नोड पर मौजूद /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. नीचे दिए गए निर्देश का इस्तेमाल करके, ज़ूकीपर ग्रुप के लीडर को खोजें (node को ज़ूकीपर मशीन के आईपी पते से बदलें):

   echo srvr | nc node 2181

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

4. लीडर से शुरू करते हुए और उस नोड पर खत्म होने वाले एक के बाद एक ज़ूकीपर रीस्टार्ट करें जिस पर आईपी पता बदला गया था. अगर एक से ज़्यादा ज़ूकीपर नोड के आईपी पते बदलते हैं, तो सभी नोड को रीस्टार्ट करना ज़रूरी हो सकता है.

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

5. हर ZKeeper नोड की पुष्टि करने के लिए, ऊपर बताए गए 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, Message प्रोसेसर, 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, नोड का यूयूआईडी है.

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