भौगोलिक एग्रीगेशन और भौगोलिक Maps को चालू करना

Edge for Private Cloud v4.18.01

जियो एग्रीगेशन की मदद से, एपीआई कॉल के लिए आंकड़ों का डेटा इकट्ठा किया जा सकता है. यह डेटा, भौगोलिक एट्रिब्यूट के आधार पर इकट्ठा किया जाता है. जैसे, इलाका, महाद्वीप, देश, और शहर. इस आंकड़े से जुड़े डेटा से, Edge के यूज़र इंटरफ़ेस (यूआई) में जियोमैप देखा जा सकता है. इसमें एपीआई अनुरोधों की जगह की जानकारी दिखती है:

भौगोलिक एग्रीगेशन, तीसरे पक्ष के डेटाबेस से भौगोलिक डेटा निकालकर काम करते हैं. साथ ही, इसे Edge से इकट्ठा किए गए Analytics डेटा में जोड़ते हैं. भौगोलिक जानकारी में, एपीआई प्रॉक्सी को किए गए अनुरोध के शहर, देश, महाद्वीप, टाइम ज़ोन, और इलाके की जानकारी शामिल हो सकती है.

जगह के हिसाब से एग्रीगेशन का इस्तेमाल करने के लिए, आपको Maxmind GeoIp2 डेटाबेस खरीदना होगा. इसमें यह भौगोलिक जानकारी शामिल होती है. ज़्यादा जानकारी के लिए, https://www.maxmind.com/en/geoip2-databases पर जाएं.

जियो एग्रीगेशन की सुविधा चालू करना

डिफ़ॉल्ट रूप से, भौगोलिक एग्रीगेशन चालू नहीं होते. जगह के हिसाब से एग्रीगेशन की सुविधा चालू करने के लिए, आपको ये काम करने होंगे:

• सभी Qpid सर्वर पर, MaxMind डेटाबेस इंस्टॉल करें और Qpid सर्वर को इसे इस्तेमाल करने के लिए कॉन्फ़िगर करें.
• Edge यूज़र इंटरफ़ेस (यूआई) में, भौगोलिक मैप दिखाने की सुविधा चालू करें.

सभी Edge Qpid सर्वर पर MaxMind डेटाबेस इंस्टॉल करें

सभी Edge Qpid सर्वर पर MaxMind डेटाबेस इंस्टॉल करने के लिए, यह तरीका अपनाएं:

1. Maxmind GeoIp2 डेटाबेस को डाउनलोड करें.
   ध्यान दें: भौगोलिक एग्रीगेशन, Edge से इकट्ठा किए गए Analytics डेटा में, तीसरे पक्ष के डेटाबेस से भौगोलिक डेटा जोड़कर काम करते हैं. जियो एग्रीगेशन का इस्तेमाल करने के लिए, आपको Maxmind GeoIp2 डेटाबेस खरीदना होगा. इसमें यह जानकारी शामिल होती है. ज़्यादा जानकारी के लिए, https://www.maxmind.com/en/geoip2-databases पर जाएं.
2. Qpid सर्वर नोड पर यह फ़ोल्डर बनाएं:
   /opt/apigee/maxmind
3. Maxmind GeoIp2 डेटाबेस को /opt/apigee/maxmind पर डाउनलोड करें.
4. डेटाबेस फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता को दें:
   > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
5. डेटाबेस पर अनुमतियों को 744 पर सेट करें:
   > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
6. /opt/apigee/customer/application/qpid-server.properties में ये टोकन सेट करें. अगर वह फ़ाइल मौजूद नहीं है, तो उसे बनाएं:
   conf_ingestboot-service_vdim.geo.ingest.enabled=true
   conf_ingestboot-service_vdim.geo.maxmind.db.path=/opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
   
   अगर आपने Maxmind GeoIp2 डेटाबेस को किसी दूसरी जगह पर सेव किया है, तो पाथ प्रॉपर्टी में ज़रूरी बदलाव करें.
   
   ध्यान दें कि इस डेटाबेस फ़ाइल में वर्शन नंबर शामिल है. अगर आपको बाद में अपडेट की गई डेटाबेस फ़ाइल मिलती है, तो हो सकता है कि उसका वर्शन नंबर अलग हो. इसके अलावा, डेटाबेस फ़ाइल के लिए एक सिमलिंक बनाएं और qpid-server.properties में सिमलिंक का इस्तेमाल करें.
   
   उदाहरण के लिए, "GeoIP2-City-current.mmdb" के लिए "GeoIP2-City_20160127.mmdb" पर एक सिमलिंक बनाएं. अगर आपको बाद में किसी दूसरे फ़ाइल नाम वाला नया डेटाबेस मिलता है, तो आपको Qpid सर्वर को फिर से कॉन्फ़िगर और रीस्टार्ट करने के बजाय, सिर्फ़ सिमलिंक को अपडेट करना होगा.
7. qpid-server.properties फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता को दें:
   > chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
8. Qpid सर्वर को रीस्टार्ट करें:
   > /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
9. हर Qpid नोड पर यह प्रोसेस दोहराएं.
10. यह पुष्टि करने के लिए कि जियो एग्रीगेशन काम कर रहा है:
    1. किसी सैंपल एपीआई प्रॉक्सी पर कई एपीआई प्रॉक्सी कॉल ट्रिगर करें.
    2. एग्रीगेशन पूरा होने में करीब 5 से 10 मिनट लगते हैं.
    3. कोई कंसोल खोलें और Edge Postgres सर्वर से कनेक्ट करें:
       > psql -h /opt/apigee/var/run/apigee-postgresql/ -U apigee -d apigee
    4. भौगोलिक एट्रिब्यूट वाली लाइनें दिखाने के लिए, analytics.agg_geo टेबल पर SELECT क्वेरी चलाएं:
       apigee=# select * from analytics.agg_geo;
       
       आपको क्वेरी के नतीजों में ये कॉलम दिखने चाहिए. इन्हें Maxmind GeoIp2 डेटाबेस से निकाला गया है: ax_geo_city, ax_geo_country, ax_geo_continent, ax_geo_timezone, ax_geo_region.
       
       अगर agg_geo टेबल में डेटा नहीं भरा जा रहा है, तो /opt/apigee/var/log/edge-qpid-server/logs/ पर जाकर Qpid सर्वर लॉग देखें, ताकि किसी भी संभावित अपवाद का पता लगाया जा सके.

Edge यूज़र इंटरफ़ेस (यूआई) में भौगोलिक मैप की सुविधा चालू करना

Edge के यूज़र इंटरफ़ेस (यूआई) में भौगोलिक मैप चालू करने के लिए, यह तरीका अपनाएं:

1. भौगोलिक मैप चालू करने के लिए, /opt/apigee/customer/application/ui.properties में यह टोकन सेट करें. अगर वह फ़ाइल मौजूद नहीं है, तो उसे बनाएं:
   conf_apigee_apigee.feature.disablegeomap=false
2. ui.properties फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता को दें:
   > chown apigee:apigee /opt/apigee/customer/application/ui.properties
3. Edge यूज़र इंटरफ़ेस (यूआई) को रीस्टार्ट करें:
   > /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart
4. Edge यूज़र इंटरफ़ेस (यूआई) में, Analytics > GeoMap को चुनें. इससे, जगह के हिसाब से कुल डेटा दिखेगा.

MaxMind GeoIp2 डेटाबेस को अपडेट करना

MaxMind, Maxmind GeoIp2 डेटाबेस को समय-समय पर अपडेट करता है. अगर आपको अपडेट किया गया डेटाबेस मिलता है, तो उसे Edge पर इंस्टॉल करने के लिए यह तरीका अपनाएं:

1. Maxmind GeoIp2 का अपडेट किया गया डेटाबेस डाउनलोड करें.
2. Maxmind GeoIp2 डेटाबेस को /opt/apigee/maxmind पर डाउनलोड करें.
3. डेटाबेस फ़ाइल का नाम देखें. अगर यह पुरानी फ़ाइल जैसी ही है, जैसा कि ?/opt/apigee/customer/application/qpid-server.properties में बताया गया है, तो अगले चरण पर जाएं. हालांकि, अगर फ़ाइल का नाम अलग है, तो आपको qpid-server.properties फ़ाइल में बदलाव करना होगा, ताकि नई डेटाबेस फ़ाइल का नाम बताया जा सके. इसके बाद, Qpid सर्वर को रीस्टार्ट करें, जैसा कि ऊपर बताया गया है.
   
   इसके बजाय, फ़ाइल का सिमलिंक बनाया जा सकता है. उदाहरण के लिए, "GeoIP2-City-current.mmdb" के लिए "GeoIP2-City_20160127.mmdb" पर एक सिमलिंक बनाएं. अगर आपको बाद में किसी दूसरे फ़ाइल नाम के साथ नया डेटाबेस मिलता है, तो आपको Qpid सर्वर को फिर से कॉन्फ़िगर करने के बजाय, सिर्फ़ सिमलिंक को अपडेट करना होगा.
4. डेटाबेस फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता को दें:
   > chown apigee:apigee /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
5. डेटाबेस पर अनुमतियों को 744 पर सेट करें:
   > chmod 744 /opt/apigee/maxmind/GeoIP2-City_20160127.mmdb
6. Qpid सर्वर को रीस्टार्ट करें:
   > /opt/apigee/bin/apigee-service/bin/apigee-service edge-qpid-server restart
7. हर Qpid नोड पर यह प्रोसेस दोहराएं.