মনিটাইজেশন পরিষেবা ইনস্টল করা

Edge for Private Cloud v. 4.17.09

মনিটাইজেশন পরিষেবা হল Apigee Edge-এর একটি এক্সটেনশন, তাই এটি স্বতন্ত্র প্রসেস হিসেবে রান করে না। এটি আগে থেকে থাকা যেকোনও Apigee Edge সেট-আপের মধ্যে চলে।

মনিটাইজেশন সংক্রান্ত প্রয়োজনীয়তা

• আপনি যদি একাধিক ম্যানেজমেন্ট সার্ভার নোড ব্যবহার করে এমন একটি এজ টপোলজিতে মনিটাইজেশন ইনস্টল করেন, যেমন একটি 13-নোড ইনস্টলেশন, তাহলে মনিটাইজেশন ইনস্টল করার আগে আপনাকে অবশ্যই উভয় এজ ম্যানেজমেন্ট সার্ভার নোড ইনস্টল করতে হবে।
• Edge-এ মনিটাইজেশন ইনস্টল করতে, যেখানে Edge ইনস্টলেশনে একাধিক Postgres নোড রয়েছে, Postgres নোডগুলি অবশ্যই মাস্টার/স্ট্যান্ডবাই মোডে কনফিগার করা উচিত। একাধিক Postgres মাস্টার নোড থাকলে, আপনি Edge-এ মনিটাইজেশন ইনস্টল করতে পারবেন না। আরও জানতে, Postgres-এর জন্য মাস্টার-স্ট্যান্ডবাই রেপ্লিকেশন সেট-আপ করুন দেখুন।

ইনস্টলেশন ওভারভিউ

নিম্নলিখিত ধাপগুলি থেকে বোঝা যায় যে আগে থেকে ইনস্টল করা Apigee Edge-এ কীভাবে মনিটাইজেশন পরিষেবা যোগ করতে হয়:

• apigee-setup ইউটিলিটি ব্যবহার করে Apigee ম্যানেজমেন্ট সার্ভার নোড আপডেট করুন যাতে মনিটাইজেশন পরিষেবা চালু করা যায়, যেমন ক্যাটালগ ম্যানেজমেন্ট, সীমা ও বিজ্ঞপ্তি কনফিগারেশন, বিলিং ও রিপোর্টিং।
  
  আপনার একাধিক ম্যানেজমেন্ট সার্ভার নোড থাকলে, যেমন ১৩-নোড ইনস্টলেশন, তাহলে আপনাকে Monetization ইনস্টল করার আগে দুটি Edge ম্যানেজমেন্ট সার্ভার নোড ইনস্টল করতে হবে।
• apigee-setup ইউটিলিটি ব্যবহার করে Apigee মেসেজ প্রসেসর আপডেট করুন যাতে মনিটাইজেশন পরিষেবার রানটাইম কম্পোনেন্ট চালু করা যায়, যেমন, ট্রানজ্যাকশন রেকর্ডিং নীতি ও সীমা এনফোর্সমেন্ট। আপনার একাধিক মেসেজ প্রসেসর থাকলে, সবকটিতে মনিটাইজেশন ইনস্টল করুন।
• আপনার Edge সংস্থার জন্য মনিটাইজেশন অনবোর্ডিং প্রসেস সম্পূর্ণ করুন।
• মনিটাইজেশন সাপোর্ট করার জন্য ডেভেলপার পরিষেবা পোর্টাল কনফিগার করুন। আরও তথ্যের জন্য, http://apigee.com/docs/monetization/content/configure-monetization-developer-portal দেখুন।

মনিটাইজেশনের জন্য একটি সাইলেন্ট কনফিগারেশন ফাইল তৈরি করা হচ্ছে

নিচে Monetization ইনস্টলেশনের জন্য একটি উদাহরণ সাইলেন্ট কনফিগারেশন ফাইল দেখানো হয়েছে। আপনার কনফিগারেশনের জন্য প্রয়োজন অনুযায়ী এই ফাইল এডিট করুন। এই ফাইল অন্তর্ভুক্ত করতে setup.sh-এ -f বিকল্প ব্যবহার করুন।

মনে রাখবেন: সাধারণত, আপনি এই প্রপার্টিগুলি একই কনফিগারেশন ফাইলে যোগ করেন যা আপনি Edge ইনস্টল করতে ব্যবহার করেছিলেন, যেমন একটি নোডে Edge কম্পোনেন্ট ইনস্টল করুন-এ দেখানো হয়েছে।

# Edge configuration properties
# Specify IP address or DNS name of node.
IP1=192.168.1.1  # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra
IP2=192.168.1.2  # ZooKeeper, Cassandra
IP3=192.168.1.3  # ZooKeeper, Cassandra
IP4=192.168.1.4  # Router, Message Processor
IP5=192.168.1.5  # Router, Message Processor
IP6=192.168.1.6  # Qpid
IP7=192.168.1.7  # Qpid
IP8=192.168.1.8  # Postgres
IP9=192.168.1.9  # Postgres

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Edge sys admin credentials
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.

# Specify the Management Server port.
APIGEE_PORT_HTTP_MS=8080

#
# Monetization configuration properties.
#
# Postgres credentials from Edge installation.
PG_USER=apigee    # Default from Edge installation
PG_PWD=postgres    # Default from Edge installation

# Specify Postgres server.
MO_PG_HOST="$IP8"    # Only specify one Postgres node.

# Create a Postgres user for Monetization.
# Default username is "postgre". 
# If you specify a different user, that user must already exist.
MO_PG_USER=postgre    
MO_PG_PASSWD=moUserPWord

# Specify one ZooKeeper host.
# Ensure this is a ZooKeeper leader node in a multi-datacenter environment.
ZK_HOSTS="$IP2"

# Specify Cassandra information.
# Ensure CASS_HOSTS is set to the same value as when you installed Edge.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"

# Default is "Apigee", unless it was changed during Edge install.  
CASS_CLUSTERNAME=Apigee

# Cassandra uname/pword required only if you enabled Cassandra authentication. 
# CASS_USERNAME= 
# CASS_PASSWORD= 

# Specify the region. 
# Default is dc-1 unless you are in a multi-datacenter environment. 
REGION=dc-1 

# If your Edge config file did not specify SMTP information, add it. 
# Monetization requires an SMTP server. 
SMTPHOST=smtp.gmail.com 
SMTPPORT=465 
SMTPUSER=your@email.com 
SMTPPASSWORD=yourEmailPassword 
SMTPSSL=y
SMTPMAILFROM="My Company <myco@company.com>"

• আপনার Edge কনফিগারেশন ফাইলে SMTP তথ্য উল্লেখ করা না থাকলে, তা যোগ করুন। মনিটাইজেশনের জন্য একটি SMTP সার্ভার প্রয়োজন।
• একটি ডেটা সেন্টার ইনস্টলেশনে, সব ZooKeeper নোড ডিফল্ট হিসেবে লিডার হিসেবে কনফিগার করা হয়। একাধিক ডেটা সেন্টার জুড়ে Edge ইনস্টল করার সময়, কিছু ZooKeeper নোড পর্যবেক্ষক হিসেবে কনফিগার করা হবে। নিশ্চিত করুন যে উপরের ZK_HOSTS প্রপার্টি একাধিক ডেটা সেন্টার ইনস্টলেশনে একটি লিডার নোড নির্দিষ্ট করে।
• আপনি Cassandra যাচাইকরণ চালু করলে, নিম্নলিখিত প্রপার্টি ব্যবহার করে Cassandra ইউজারনেম ও পাসওয়ার্ড পাঠাতে পারবেন:
  CASS_USERNAME
  CASS_PASSWORD

সব ম্যানেজমেন্ট সার্ভারের সাথে মনিটাইজেশন পরিষেবা ইন্টিগ্রেট করুন

ম্যানেজমেন্ট সার্ভার নোডে মনিটাইজেশন ইন্টিগ্রেট করতে নিম্নলিখিত পদ্ধতি ব্যবহার করুন।

1. আপনি যদি একাধিক ম্যানেজমেন্ট সার্ভার নোড ব্যবহার করে এমন একটি এজ টপোলজিতে মনিটাইজেশন ইনস্টল করেন, যেমন একটি ১৩-নোড ইনস্টলেশন, তাহলে নিশ্চিত করুন যে আপনি মনিটাইজেশন ইনস্টল করার আগে উভয় ম্যানেজমেন্ট সার্ভার নোড ইনস্টল করেছেন।
2. ম্যানেজমেন্ট সার্ভার নোডে, সেটআপ স্ক্রিপ্ট রান করুন:
   > /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile
   
   “-p mo” বিকল্পটি মনিটাইজেশন ইন্টিগ্রেট করার জন্য নির্দিষ্ট করে।
   
   "apigee" ব্যবহারকারীর কাছে কনফিগারেশন ফাইল অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।
3. আপনি একাধিক ম্যানেজমেন্ট সার্ভার নোডে Monetization ইনস্টল করলে, দ্বিতীয় ম্যানেজমেন্ট সার্ভার নোডে ২ নম্বর ধাপটি আবার করুন।

কনফিগারেশন সম্পূর্ণ হলে, PostgreSQL ডেটাবেসে মনিটাইজেশন পরিষেবার জন্য RDBMS স্কিমা তৈরি করা হয়। এর মাধ্যমে Postgres সার্ভারের সাথে মনিটাইজেশন পরিষেবা এবং এর সাথে সম্পর্কিত কম্পোনেন্টের ইন্টিগ্রেশন সম্পূর্ণ হয়।

সব মেসেজ প্রসেসরের সাথে মনিটাইজেশন পরিষেবা ইন্টিগ্রেট করুন

সব মেসেজ প্রসেসর নোডে মনিটাইজেশন ইন্টিগ্রেট করতে নিম্নলিখিত পদ্ধতি ব্যবহার করুন।

1. প্রথম মেসেজ প্রসেসর নোডে, কমান্ড প্রম্পটে, সেট-আপ স্ক্রিপ্ট রান করুন:
   > /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile
   
   “-p mo” বিকল্পটি মনিটাইজেশন ইন্টিগ্রেট করার জন্য নির্দিষ্ট করে।
   
   "apigee" ব্যবহারকারীর কাছে কনফিগারেশন ফাইল অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।
2. সব মেসেজ প্রসেসর নোডে এই পদ্ধতি রিপিট করুন।

কনফিগারেশন সফল হলে, মনিটাইজেশন পরিষেবার সাথে মেসেজ প্রসেসর আপডেট করা হয়। এর ফলে মেসেজ প্রসেসরের সাথে মনিটাইজেশন পরিষেবা এবং এর সাথে সম্পর্কিত কম্পোনেন্টের ইন্টিগ্রেশন সম্পূর্ণ হয়।

মনিটাইজেশন অনবোর্ডিং

মনিটাইজেশন চালু থাকা নতুন প্রতিষ্ঠান তৈরি করতে, প্রথমে আপনি যেকোনও নতুন প্রতিষ্ঠানের মতো প্রতিষ্ঠান তৈরি করুন। আরও তথ্যের জন্য, কোনও সংস্থাকে অনবোর্ড করা দেখুন।

কোনও সংস্থার জন্য মনিটাইজেশন চালু করতে অতিরিক্ত অনবোর্ডিং

কোনও সংস্থার মনিটাইজেশন অনবোর্ডিং সম্পূর্ণ করতে, আপনাকে:

1. মনিটাইজেশন গ্রুপ তৈরি করুন: mxgroup।
2. গ্রুপে Qpid যোগ করুন।
3. সংস্থার জন্য মনিটাইজেশন চালু করুন।
4. সংস্থার জন্য বিজ্ঞপ্তি সেটিংস চালু করুন।
5. যেসব সংস্থার জন্য মনিটাইজেশন চালু করতে চান, সেগুলির জন্য এই প্রসেসটি রিপিট করুন।

এইসব টাস্ক সম্পূর্ণ করতে enable-monetization কমান্ড ব্যবহার করুন। এই স্ক্রিপ্ট একটি কনফিগারেশন ফাইল নেয় যাতে নিম্নলিখিত প্রপার্টি থাকে:

MSIP=IPorDNSofManagementServer
APIGEE_PORT_HTTP_MS=8080    # Default is 8080.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=yourPassword    # If omitted, you are prompted for it.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1"
# Space-separated list IP/DNS names of all Qpid nodes in the data center being configured.
QPID_HOST="$IP6 $IP7"    
QPID_PORT=8083     # Default is 8083.
REGION=dc-1
ORG_NAME=myorg    # The Edge org where you want to enable monetization. 
MX_GROUP=mxgroup    # Default Monetization group.

মনে রাখবেন:

• CASS_HOSTS এবং REGION-এর ভ্যালু মনিটাইজেশন ইনস্টল করার সময় ব্যবহার করা ভ্যালুর সমান সেট করুন।
• আপনি একাধিক ডেটা সেন্টার কনফিগারেশনে মনিটাইজেশন চালু করলে:
  • আপনাকে প্রতিটি ডেটা সেন্টারে ম্যানেজমেন্ট সার্ভারে অনবোর্ডিং প্রসেস রিপিট করতে হবে।
  • কনফিগারেশন ফাইলে শুধুমাত্র কনফিগার করা ডেটা সেন্টারে Qpid নোডের তালিকা থাকা উচিত।

স্ক্রিপ্ট রান করতে:

1. স্ক্রিপ্টটি চালু করুন:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision enable-monetization -f configFile
   
   কনফিগারেশন ফাইলটি অবশ্যই "apigee" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।
   
   আপনার একাধিক ম্যানেজমেন্ট সার্ভার থাকলে, আপনাকে শুধুমাত্র একটিতে এই স্ক্রিপ্ট চালাতে হবে।
   
   এই স্ক্রিপ্ট Cassandra ডেটাবেস থেকে Monetization PostgreSQL ডেটাবেসে প্রতিষ্ঠান, প্রোডাক্ট, ডেভেলপার ও অ্যাপ্লিকেশন রেপ্লিকেট করে। মনিটাইজেশন পরিষেবা ইনস্টল করার পরে ডেটা অটোমেটিক সিঙ্ক হয়ে যায়।
2. আপনি যেসব প্রতিষ্ঠানের জন্য মনিটাইজেশন চালু করতে চান, সেগুলির প্রতিটির জন্য এই পদ্ধতি অনুসরণ করুন।
3. আপনি একাধিক ডেটা সেন্টার এনভায়রনমেন্টে থাকলে, অন্য ডেটা সেন্টারের ম্যানেজমেন্ট সার্ভারে এই প্রসেসটি রিপিট করুন। নিশ্চিত করুন যে কনফিগারেশন ফাইলটি শুধুমাত্র ডেটা সেন্টারে Qpid নোডের তালিকা করে কনফিগার করা হচ্ছে।

আপনি পরের বার Edge UI-তে লগ-ইন করলে, সংস্থার জন্য টপ-লেভেল মেনুতে মনিটাইজেশন এন্ট্রি দেখতে পাবেন:

ডেভেলপার পরিষেবা পোর্টাল কনফিগার করুন

মনিটাইজেশন সাপোর্ট করার জন্য ডেভেলপার পরিষেবা পোর্টাল কনফিগার করতে, http://apigee.com/docs/monetization/content/configure-monetization-developer-portal দেখুন।

মনিটাইজেশন ইনস্টলেশনে ম্যানেজমেন্ট সার্ভার নোড যোগ করা

আপনি যদি আগে থেকে ইনস্টল করা Edge-এ ম্যানেজমেন্ট সার্ভার যোগ করেন, তাহলে আপনাকে অবশ্যই নিশ্চিত করতে হবে যে আপনি নতুন ম্যানেজমেন্ট সার্ভারে মনিটাইজেশন পরিষেবা যোগ করেছেন এবং সমস্ত ম্যানেজমেন্ট সার্ভার কনফিগার করেছেন যাতে তারা যোগাযোগ করতে পারে।

ম্যানেজমেন্ট সার্ভার যোগ করতে:

1. নতুন ম্যানেজমেন্ট সার্ভার ইনস্টল করুন।
2. নতুন ম্যানেজমেন্ট সার্ভারে মনিটাইজেশন ইনস্টল করুন।
3. আসল ম্যানেজমেন্ট সার্ভারে, নিম্নলিখিত কমান্ডটি কল করুন:
   > /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
4. আসল ম্যানেজমেন্ট সার্ভার রিস্টার্ট করুন:
   > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
5. নতুন ম্যানেজমেন্ট সার্ভারে, নিম্নলিখিতটি কল করুন:
   > /opt/apigee/apigee-service/bin/apigee-service edge-mint-management-server mint-configure-mgmt-cluster
6. নতুন ম্যানেজমেন্ট সার্ভার রিস্টার্ট করুন:
   > /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

অতিরিক্ত কনফিগারেশন

পিডিএফ ফাইল হিসেবে বিলিং ডকুমেন্ট জমা দিন

'মনিটাইজেশন' ব্যবহারকারীদের HTML ফর্ম্যাটে বিলিং ডকুমেন্ট দেখায়। পিডিএফ ফাইল হিসেবে বিলিং ডকুমেন্ট প্রদান করতে, আপনি মনিটাইজেশনকে এমন একটি বিলিং সিস্টেমের সাথে ইন্টিগ্রেট করতে পারেন যা পিডিএফ তৈরি করে বা কোনও মানানসই থার্ড-পার্টি পিডিএফ লাইব্রেরির লাইসেন্স দেয়।

সংস্থার সেটিংস কনফিগার করুন

ব্যাকএন্ড সেটিংস: নিম্নলিখিত সারণীতে সংস্থার লেভেল অ্যাট্রিবিউট তালিকাভুক্ত করা আছে যা মিন্ট সংস্থা কনফিগার করার জন্য উপলভ্য। নিচে দেখানো অ্যাট্রিবিউট যোগ/আপডেট করতে আপনি PUT কল ব্যবহার করতে পারেন:

> curl -u ${ADMIN_EMAIL}:${ADMINPW} -v http://<management-ip>:8080/v1/organizations/{orgId} -d '{org object with attributes}' -X PUT

যেমন, উপরের CURL কমান্ডের আউটপুট এইরকম দেখতে হবে:

{
...
    "displayName": "Orgnization name",
    "name": "org4",
    "properties": {
        "property": [
...
            {
                "name": "MINT_CURRENCY",
                "value": "USD"
            },
            {
                "name": "MINT_COUNTRY",
                "value": "US"
            },
            {
                "name": "MINT_TIMEZONE",
                "value": "GMT"
            }
        ]
    }
}

ম্যানেজমেন্ট UI ব্যবহার করে ব্যবসায়িক প্রতিষ্ঠানের সেটিংস কনফিগার করার জন্য, http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services দেখুন।

মনে রাখবেন: আপনি মনিটাইজেশন পরিষেবার সীমা ও বিজ্ঞপ্তি ফিচার ব্যবহার করলে, আপনার ডেভেলপারকে অ্যাক্সেস টোকেন যাচাইকরণ নীতির পরে প্রক্সি ফ্লোতে সীমা নীতি অ্যাটাচ করার নির্দেশ দিন।

সীমা নীতি হল একটি সুস্পষ্ট নীতি যা নির্দিষ্ট সীমায় পৌঁছে গেলে API কল ব্লক করার জন্য ডিজাইন করা হয়েছে। এই নীতি ব্যবসার সীমা চেক করে এবং কনফিগার করা ভ্যালুর থেকে সীমা বেশি হলে ত্রুটি দেখায়। এটি হল ত্রুটি সংক্রান্ত নীতি প্রয়োগ করার এক্সটেনশন, তবে শর্তগুলি ব্যবসার ভেরিয়েবল থেকে নেওয়া হয়েছে।

প্রক্সি ডেভেলপারদের জন্য ম্যানেজমেন্ট UI-তে একটি UI টেমপ্লেট উপলভ্য। প্রক্সি ডেভেলপারকে মেসেজ ফ্লোতে মিন্ট নীতি অ্যাটাচ করতে হবে। এই নীতি কার্যকর করার পরে, নীতি অনুযায়ী ত্রুটি সংক্রান্ত উত্তর সহ ত্রুটি দেখানো হবে। ContinueOnError-এর ভ্যালু true হিসেবে সেট করা থাকলে, কোনও ত্রুটি দেখানো হবে না এবং "mint.limitsViolated", "mint.isDeveloperSuspended" ও "mint.limitsPolicyError" ভেরিয়েবল সেট করা হবে যা প্রয়োজন হলে পরবর্তী ব্যতিক্রম ম্যানেজ করার জন্য ব্যবহার করা যেতে পারে।