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

Edge for Private Cloud v. 4.17.01

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

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

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