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

নগদীকরণ পরিষেবাগুলি 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.
# If your password uses special characters, wrap it in single quotes.
# 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 নোডের বিজোড় সংখ্যক voters হিসাবে কনফিগার করা উচিত৷ ZooKeeper নোডের একটি সংখ্যা সমান হলে, কিছু নোড observers হিসাবে কনফিগার করা হবে। আপনি যখন সমান সংখ্যক ডেটা সেন্টারে এজ ইনস্টল করছেন, তখন কিছু ZooKeeper নোডকে observers হিসেবে কনফিগার করতে হবে যাতে ভোটার নোডের সংখ্যা বিজোড় হয়। ZooKeeper নেতা নির্বাচনের সময় একজন ভোটার নোড leader হিসেবে নির্বাচিত হবেন। নিশ্চিত করুন যে উপরের 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"
      }
    ]
  }
}

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

গুণাবলী বর্ণনা
MINT_TAX_MODEL

গৃহীত মানগুলি হল "অপ্রকাশিত", "অপ্রকাশিত", "হাইব্রিড" (ডিফল্ট শূন্য)

MINT_CURRENCY

ISO মুদ্রা কোড (ডিফল্ট শূন্য)

MINT_TAX_NEXUS

ট্যাক্স নেক্সাস (ডিফল্ট শূন্য)

MINT_DEFAULT_PROD_TAX_CATEGORY

ডিফল্ট পণ্য ট্যাক্স বিভাগ (ডিফল্ট শূন্য)

MINT_IS_GROUP_ORG

IS গ্রুপ সংগঠন (ডিফল্ট "মিথ্যা")

MINT_HAS_BROKER

ভেঙে গেছে (ডিফল্ট মিথ্যা)

MINT_TIMEZONE

টাইমজোন (ডিফল্ট শূন্য)

MINT_TAX_ENGINE_EXTERNAL_ID

ট্যাক্স ইঞ্জিন আইডি (ডিফল্ট শূন্য)

MINT_COUNTRY

সংস্থার দেশ (ডিফল্ট শূন্য)

MINT_REG_NO

সংস্থার নিবন্ধন নম্বর, ইউনাইটেড কিংডম ট্যাক্স আইডি থেকে আলাদা নম্বর দেয় (ডিফল্ট শূন্য)

MINT_BILLING_CYCLE_TYPE

"প্রমাণিত", "CALENDAR_MONTH" (ডিফল্ট হল "CALENDAR_MONTH")

MINT_SUPPORTED_BILLING_TYPE

"প্রিপেইড"/"পোস্টপেইড"/"উভয়" (ডিফল্ট হল "প্রিপেইড")

MINT_IS_SEPARATE_INV_FOR_FEES

একটি পৃথক ফি চালান তৈরি করা উচিত কিনা তা নির্দেশ করে (ডিফল্ট "মিথ্যা")

MINT_ISSUE_NETTING_STMT

নেট বিবৃতি জারি করা উচিত কিনা তা নির্দেশ করে (ডিফল্ট "মিথ্যা")

MINT_NETTING_STMT_PER_CURRENCY

প্রতি মুদ্রায় নেট বিবৃতি তৈরি করা উচিত কিনা তা নির্দেশ করে (ডিফল্ট "মিথ্যা")

MINT_HAS_SELF_BILLING

সংস্থার স্ব-বিলিং আছে কিনা তা নির্দেশ করে (ডিফল্ট "মিথ্যা")

MINT_SELF_BILLING_FOR_ALL_DEV

সংস্থার সমস্ত ডেভেলপারদের জন্য স্ব-বিলিং আছে কিনা তা নির্দেশ করে (ডিফল্ট "মিথ্যা")

MINT_HAS_SEPARATE_INV_FOR_PROD

প্রতিষ্ঠানের পণ্য প্রতি আলাদা চালান আছে কিনা তা নির্দেশ করে (ডিফল্ট "মিথ্যা")

MINT_HAS_BILLING_ADJUSTMENT

সংস্থাটি বিলিং সামঞ্জস্য সমর্থন করে কিনা তা নির্দেশ করে (ডিফল্ট "মিথ্যা")

features.isMonetizationEnabled

নগদীকরণ নির্দিষ্ট মেনু প্রদর্শন করতে ব্যবস্থাপনা UI দ্বারা ব্যবহৃত হয় (ডিফল্ট "মিথ্যা")

ui.config.isOperator

অপারেটর পদ সংস্থা হিসাবে প্রদানকারীকে প্রদর্শন করতে ব্যবস্থাপনা UI দ্বারা ব্যবহৃত হয় (ডিফল্ট "সত্য")

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

নগদীকরণ সীমা

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

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

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

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