भौगोलिक मैप और भौगोलिक मैप चालू करना

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

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

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

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

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

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

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

सभी Edge Qpid सर्वर पर MaxMind डेटाबेस इंस्टॉल करने के लिए, नीचे दी गई प्रक्रिया का इस्तेमाल करें:

1. Maxmind GeoIp2 का डेटाबेस हासिल करें.
   
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 क्वेरी करें:

       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 नोड पर दोहराएं.