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

জিও অ্যাগ্রিগেশন আপনাকে অঞ্চল, মহাদেশ, দেশ এবং শহরের মতো ভৌগোলিক বৈশিষ্ট্যের উপর ভিত্তি করে API কলের জন্য অ্যানালিটিক্স ডেটা সংগ্রহ করতে দেয়। এই অ্যানালিটিক্স ডেটা থেকে, আপনি New 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/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-তে Geo Maps চালু করা

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

1. Geo Maps চালু করতে /opt/apigee/customer/application/management-ui.properties-এ নিম্নলিখিত টোকেন সেট করুন। সেই ফাইলটি না থাকলে, এটি তৈরি করুন:

   conf_uebe_disableGeoMap=false

2. management-ui.properties ফাইলের মালিকানা apigee ব্যবহারকারীর কাছে পরিবর্তন করুন:

   chown apigee:apigee /opt/apigee/customer/application/management-ui.properties

3. নতুন Edge UI রিস্টার্ট করুন:

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

4. জিও অ্যাগ্রিগেশন ডেটা দেখাতে, New Edge UI-তে বিশ্লেষণ করুন > এন্ড ইউজার > জিওম্যাপ বিকল্প বেছে নিন।

MaxMind GeoIp2 ডেটাবেস আপডেট করা

MaxMind নির্দিষ্ট সময় অন্তর Maxmind GeoIp2 ডেটাবেস আপডেট করে। আপনি যদি কোনও আপডেট করা ডেটাবেস পান, তাহলে Edge-এ এটি ইনস্টল করতে নিম্নলিখিত পদ্ধতি ব্যবহার করুন:

1. আপডেট করা Maxmind GeoIp2 ডেটাবেস পান।
2. /opt/apigee/maxmind-এ Maxmind GeoIp2 ডেটাবেস ডাউনলোড করুন।
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/apigee-service/bin/apigee-service edge-qpid-server restart

7. প্রতিটি Qpid নোডে এই প্রসেসটি রিপিট করুন।