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

Edge for Private Cloud वर्शन 4.16.09

जियो एग्रीगेशन की मदद से, क्षेत्र, महाद्वीप, देश, और शहर जैसी भौगोलिक विशेषताओं के आधार पर एपीआई कॉल के लिए, आंकड़ों का डेटा इकट्ठा किया जा सकता है. इस आंकड़े के डेटा से, आपको 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 का डेटाबेस हासिल करें.
   ध्यान दें: जियो एग्रीगेशन, तीसरे पक्ष के डेटाबेस में मौजूद भौगोलिक डेटा को Edge से इकट्ठा किए गए आंकड़ों के डेटा में जोड़कर काम करता है. जियो एग्रीगेशन का इस्तेमाल करने के लिए, आपको 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.mmd2, स्टोर की गई जगह की जानकारी में बदलाव करने पर,
   दूसरे डेटाबेस में सेव की गई जगह की जानकारी को
   mmdb बनाएं.
   
   ध्यान दें कि इस डेटाबेस फ़ाइल में एक वर्शन नंबर होता है. अगर आपको बाद में अपडेट की गई डेटाबेस फ़ाइल मिलती है, तो हो सकता है कि उसका वर्शन नंबर अलग हो. विकल्प के तौर पर, डेटाबेस फ़ाइल के लिए एक सिमलिंक बनाएं और qpid-server.properties में सिमलिंक का इस्तेमाल करें.
   
   उदाहरण के लिए, "GeoIP2-City-current.mmdb" के लिए "GeoIP2-City_20160127.mmdb" में सिमलिंक बनाएं. अगर आपको बाद में किसी दूसरे फ़ाइल नाम वाला नया डेटाबेस मिलता है, तो आपको Qpid सर्वर को फिर से कॉन्फ़िगर और रीस्टार्ट करने के बजाय, सिर्फ़ सिमलिंक को अपडेट करना होगा.
7. qpid-server.property फ़ाइल का मालिकाना हक 'apigee' उपयोगकर्ता को दें:
   > chown apigee:apigee /opt/apigee/customer/application/qpid-server.properties
8. Qpid सर्वर को रीस्टार्ट करें:
   > /opt/apigee/bin/apigee-service/bin/apigee-service Edge-qpid-server रीस्टार्ट
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_timezone, ax_geo_आखिरी
       
       अगर 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.property
3. Edge यूज़र इंटरफ़ेस (यूआई) को रीस्टार्ट करें:
   > /opt/apigee/bin/apigee-service/bin/apigee-service Edge-ui हाेगा
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 रीस्टार्ट
7. यह प्रोसेस हर Qpid नोड पर दोहराएं.