নগদীকরণ পরিষেবা ইনস্টল করা হচ্ছে

প্রাইভেট ক্লাউড v4.19.01 এর জন্য এজ

নগদীকরণ পরিষেবাগুলি Apigee Edge-এর একটি এক্সটেনশন, তাই এটি একটি স্বতন্ত্র প্রক্রিয়া হিসাবে চলে না। এটি অল-ইন-ওয়ান (AIO) কনফিগারেশন বাদে যেকোন বিদ্যমান Apigee Edge সেটআপের মধ্যে চলে। আপনি AIO কনফিগারেশনে নগদীকরণ পরিষেবাগুলি ইনস্টল করতে পারবেন না।

নগদীকরণ প্রয়োজনীয়তা

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

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

নিম্নলিখিত পদক্ষেপগুলি একটি বিদ্যমান Apigee Edge ইনস্টলেশনে কীভাবে নগদীকরণ পরিষেবা যোগ করতে হয় তা ব্যাখ্যা করে:

• apigee-setup ইউটিলিটি ব্যবহার করে Apigee ম্যানেজমেন্ট সার্ভার নোড আপডেট করতে মনিটাইজেশন পরিষেবাগুলি সক্ষম করুন, উদাহরণস্বরূপ, ক্যাটালগ পরিচালনা, সীমা এবং বিজ্ঞপ্তি কনফিগারেশন, বিলিং এবং রিপোর্টিং।

  আপনার যদি একাধিক ম্যানেজমেন্ট সার্ভার নোড থাকে, যেমন একটি 13-নোড ইনস্টলেশন, তাহলে মনিটাইজেশন ইনস্টল করার আগে আপনাকে অবশ্যই উভয় এজ ম্যানেজমেন্ট সার্ভার নোড ইনস্টল করতে হবে।

• apigee-setup ইউটিলিটি ব্যবহার করুন Apigee মেসেজ প্রসেসর আপডেট করতে মনিটাইজেশন পরিষেবার রানটাইম উপাদানগুলিকে সক্ষম করতে, উদাহরণস্বরূপ, লেনদেন রেকর্ডিং নীতি এবং সীমা প্রয়োগ। আপনার যদি একাধিক মেসেজ প্রসেসর থাকে, তাহলে সেগুলির সবগুলিতে মনিটাইজেশন ইনস্টল করুন৷
• আপনার এজ সংস্থাগুলির জন্য নগদীকরণ অনবোর্ডিং প্রক্রিয়াটি সম্পাদন করুন৷
• নগদীকরণ সমর্থন করতে Apigee বিকাশকারী পরিষেবা পোর্টাল (বা সহজভাবে, পোর্টাল ) কনফিগার করুন৷ আরও তথ্যের জন্য, বিকাশকারী পোর্টালে নগদীকরণ কনফিগার করুন দেখুন।

নগদীকরণের জন্য একটি নীরব কনফিগারেশন ফাইল তৈরি করা হচ্ছে

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

# 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>"

নোট :

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

  CASS_USERNAME
  CASS_PASSWORD

সমস্ত ম্যানেজমেন্ট সার্ভারের সাথে নগদীকরণ পরিষেবাগুলিকে একীভূত করুন

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

1. আপনি যদি একটি এজ টপোলজিতে মনিটাইজেশন ইনস্টল করেন যা একাধিক ম্যানেজমেন্ট সার্ভার নোড ব্যবহার করে, যেমন একটি 13-নোড ইনস্টলেশন, তাহলে নিশ্চিত করুন যে আপনি মনিটাইজেশন ইনস্টল করার আগে উভয় ম্যানেজমেন্ট সার্ভার নোড ইনস্টল করেছেন।
2. ম্যানেজমেন্ট সার্ভার নোডে, সেটআপ স্ক্রিপ্ট চালান:
   

   /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

   -p mo বিকল্পটি নগদীকরণ সংহত করার জন্য নির্দিষ্ট করে।

   কনফিগারেশন ফাইলটি "এপিজি" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।

3. আপনি যদি একাধিক ম্যানেজমেন্ট সার্ভার নোডে মনিটাইজেশন ইনস্টল করছেন, দ্বিতীয় ম্যানেজমেন্ট সার্ভার নোডে ধাপ 2 পুনরাবৃত্তি করুন।

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

সমস্ত বার্তা প্রসেসরের সাথে নগদীকরণ পরিষেবাগুলিকে একীভূত করুন৷

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

1. প্রথম বার্তা প্রসেসর নোডে, কমান্ড প্রম্পটে, সেটআপ স্ক্রিপ্টটি চালান:

   /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

   -p mo বিকল্পটি নগদীকরণ সংহত করার জন্য নির্দিষ্ট করে।

   কনফিগারেশন ফাইলটি "এপিজি" ব্যবহারকারীর দ্বারা অ্যাক্সেসযোগ্য বা পাঠযোগ্য হতে হবে।

2. সমস্ত মেসেজ প্রসেসর নোডে এই পদ্ধতিটি পুনরাবৃত্তি করুন।

সফল কনফিগারেশনে, বার্তা প্রসেসর নগদীকরণ পরিষেবাগুলির সাথে আপডেট করা হয়। এটি বার্তা প্রসেসরের সাথে নগদীকরণ পরিষেবা এবং এর সংশ্লিষ্ট উপাদানগুলির একীকরণ সম্পূর্ণ করে৷

নগদীকরণ অনবোর্ডিং

একটি নতুন সংস্থা তৈরি করতে এবং নগদীকরণ সক্ষম করতে:

1. আপনি যে কোনও নতুন সংস্থার মতো সংগঠন তৈরি করুন। আরও তথ্যের জন্য, অনবোর্ড একটি সংস্থা দেখুন।
2. একটি প্রতিষ্ঠানের জন্য নগদীকরণ সক্ষম করুন- এ বর্ণিত হিসাবে নগদীকরণ প্রভিশনিং API ব্যবহার করুন৷ এটি করার জন্য, আপনার সিস্টেম প্রশাসকের বিশেষাধিকার থাকতে হবে।

আপনি যখন পরবর্তী এজ UI-তে লগ ইন করবেন, তখন আপনি প্রতিষ্ঠানের জন্য শীর্ষ-স্তরের মেনুতে নগদীকরণ এন্ট্রি দেখতে পাবেন:

নগদীকরণ সমর্থন করার জন্য পোর্টালটি কনফিগার করতে, বিকাশকারী পোর্টালে নগদীকরণ কনফিগার করুন দেখুন।

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

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

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

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 SYS_ADMIN_EMAIL:SYS_ADMIN_PASSWORD \
  -v http://ms_IP:8080/v1/organizations/orgId -d 'org object with attributes' -X PUT

নগদীকরণ প্রতিষ্ঠানের সেটিংসের সাথে সাড়া দেয়। যেমন:

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

নিম্নলিখিত সারণীতে সংগঠন-স্তরের বৈশিষ্ট্যগুলি তালিকাভুক্ত করা হয়েছে যা একটি মিন্ট সংস্থা কনফিগার করার জন্য উপলব্ধ।

ব্যবস্থাপনা UI ব্যবহার করে ব্যবসা প্রতিষ্ঠানের সেটিংস কনফিগার করার জন্য, নগদীকরণ ব্যবহার শুরু করুন দেখুন।

নগদীকরণ সীমা

নগদীকরণ সীমা কার্যকর করতে, API প্রক্সিগুলিতে নগদীকরণ সীমা চেক নীতি সংযুক্ত করুন৷ বিশেষ করে, নীতিটি নিম্নলিখিত শর্তে ট্রিগার করা হয়:

• নগদীকরণ API অ্যাক্সেসকারী বিকাশকারী নিবন্ধিত নয় বা রেট প্ল্যানে সদস্যতা নেননি।
• ডেভেলপার সাবস্ক্রাইব করা রেট প্ল্যানের জন্য লেনদেনের পরিমাণ অতিক্রম করেছে।
• বিকাশকারীর প্রি-পেইড অ্যাকাউন্ট ব্যালেন্স বা পোস্ট-পেইড ক্রেডিট সীমা পৌঁছে গেছে।

মনিটাইজেশন লিমিট চেক পলিসি উপরে তালিকাভুক্ত পরিস্থিতিগুলির মতো পরিস্থিতিতে এপিআই কলগুলিকে ত্রুটি এবং ব্লক করে। নীতিটি রাইজ ফল্ট নীতিকে প্রসারিত করে, এবং আপনি ফিরে আসা বার্তাটি কাস্টমাইজ করতে পারেন। প্রযোজ্য শর্ত ব্যবসা ভেরিয়েবল থেকে উদ্ভূত হয়.

আরও তথ্যের জন্য, API প্রক্সিগুলিতে নগদীকরণের সীমা প্রয়োগ করুন দেখুন।