জিও এগ্রিগেশন ও জিও ম্যাপ চালু করা

জিও অ্যাগ্রিগেশন আপনাকে ভৌগোলিক অ্যাট্রিবিউট যেমন অঞ্চল, মহাদেশ, দেশ এবং শহরের উপর ভিত্তি করে API কলের জন্য অ্যানালিটিক্স ডেটা সংগ্রহ করতে দেয়। এই অ্যানালিটিক্স ডেটা থেকে, আপনি Edge UI-তে একটি GeoMap দেখতে পাবেন যা API অনুরোধের লোকেশন দেখায়:

থার্ড-পার্টি ডেটাবেস থেকে ভৌগোলিক ডেটা এক্সট্র্যাক্ট করে এবং Edge-এর সংগ্রহ করা অ্যানালিটিক্স ডেটাতে যোগ করে জিও অ্যাগ্রিগেশন কাজ করে। ভূগোল সংক্রান্ত তথ্যের মধ্যে থাকতে পারে শহর, দেশ, মহাদেশ, টাইম জোন এবং API প্রক্সিতে করা অনুরোধের অঞ্চল।

জিও এগ্রিগেশন ব্যবহার করতে, আপনাকে অবশ্যই Maxmind GeoIp2 ডেটাবেস কিনতে হবে যাতে এই ভৌগোলিক তথ্য থাকে। আরও তথ্যের জন্য https://www.maxmind.com/en/geoip2-databases দেখুন।

জিও অ্যাগ্রিগেশন চালু করা

সাধারণত জিও অ্যাগ্রিগেশন চালু করা থাকে না। জিও অ্যাগ্রিগেশন চালু করতে, আপনাকে অবশ্যই:

• সব Qpid সার্ভারে, MaxMind ডেটাবেস ইনস্টল করুন এবং এটি ব্যবহার করার জন্য Qpid সার্ভার কনফিগার করুন।
• Edge UI-তে জিও ম্যাপ ডিসপ্লে চালু করুন।

সব 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. ডেটাবেসে অনুমতি ৭৪৪ হিসেবে সেট করুন:

   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. একটি নমুনা API প্রক্সিতে একাধিক API প্রক্সি কল ট্রিগার করুন।
    2. মোটামুটি ৫ - ১০ মিনিট অপেক্ষা করুন যাতে এগ্রিগেশন সম্পূর্ণ হতে পারে।
    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 UI-তে জিও ম্যাপ চালু করা

Edge UI-তে Geo Maps চালু করতে, নিম্নলিখিত পদ্ধতি ব্যবহার করুন:

1. Geo Maps চালু করতে /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 UI রিস্টার্ট করুন:

   /opt/apigee/bin/apigee-service/bin/apigee-service edge-ui restart

4. Edge UI-তে, জিও অ্যাগ্রিগেশন ডেটা দেখাতে 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. ডেটাবেসে অনুমতি ৭৪৪ হিসেবে সেট করুন:

   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 নোডে এই প্রসেসটি রিপিট করুন।