درحال نصب سرویس‌های درآمدزایی

«سرویس‌های درآمدزایی» افزونه‌ای برای Apigee Edge است، بنابراین به‌عنوان فرایندی مستقل اجرا نمی‌شود. این ویژگی در هر تنظیم Apigee Edge موجودی اجرا می‌شود، به‌جز پیکربندی «همه در یک» (AIO). نمی‌توانید «سرویس‌های درآمدزایی» را در پیکربندی AIO نصب کنید.

شرایط درآمدزایی

• اگر «درآمدزایی» را در توپولوژی Edge نصب می‌کنید که از چند گره «سرور مدیریت» استفاده می‌کند، مثلاً نصب ۱۳ گره، باید هر دو گره «سرور مدیریت Edge» را قبل‌از نصب «درآمدزایی» نصب کنید.
• برای نصب «درآمدزایی» در Edge که نصب Edge دارای چندین گره Postgres است، گره‌های Postgres باید در حالت «اصلی/آماده به‌کار» پیکربندی شوند. اگر چند گره اصلی Postgres داشته باشید، نمی‌توانید «درآمدزایی» را در Edge نصب کنید. برای اطلاعات بیشتر، راه‌اندازی تکرار Master-Standby برای Postgres را ببینید.
• درآمدزایی با پیکربندی All-In-One (AIO) دردسترس نیست.

نمای کلی نصب

مراحل زیر نحوه افزودن «خدمات درآمدزایی» به نصب موجود Apigee Edge را نشان می‌دهد:

• از ابزار کمکی apigee-setup برای به‌روزرسانی گره «سرور مدیریت Apigee» استفاده کنید تا «سرویس‌های درآمدزایی» را فعال کنید، برای مثال، مدیریت کاتالوگ، محدودیت‌ها و پیکربندی اعلان‌ها، صورت‌حساب، و گزارش‌دهی.

  اگر چندین گره «سرور مدیریت» دارید، مثلاً نصب ۱۳ گره، باید هر دو گره «سرور مدیریت Edge» را قبل‌از نصب «درآمدزایی» نصب کنید.

• از ابزار apigee-setup برای به‌روزرسانی «پردازشگر پیام Apigee» استفاده کنید تا مؤلفه‌های زمان اجرای «سرویس‌های درآمدزایی» (برای مثال، خط‌مشی ثبت تراکنش و اجرای محدودیت) فعال شود. اگر چند «پردازشگر پیام» دارید، «درآمدزایی» را در همه آن‌ها نصب کنید.
• فرایند آماده‌سازی «درآمدزایی» را برای سازمان‌های Edge خود انجام دهید.
• پیکربندی کردن درگاه «خدمات توسعه‌دهنده Apigee» (یا به‌سادگی، درگاه) برای پشتیبانی از درآمدزایی. برای اطلاعات بیشتر، پیکربندی درآمدزایی در درگاه توسعه‌دهندگان را ببینید.

درحال ایجاد فایل پیکربندی بی‌صدا برای «درآمدزایی»

در زیر نمونه‌ای از فایل پیکربندی بی‌صدا برای نصب «درآمدزایی» نشان داده شده است. این فایل را درصورت لزوم برای پیکربندی‌تان ویرایش کنید. برای افزودن این فایل، از گزینه -f در setup.sh استفاده کنید.

# Edge configuration properties
# Specify IP address or DNS name of node.
IP1=192.168.1.1  # Management Server, SymasLDAP, New Edge 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>"

نکته‌ها:

• اگر فایل پیکربندی Edge شما اطلاعات SMTP را مشخص نکرده است، آن را اضافه کنید. درآمدزایی به سرور SMTP نیاز دارد.
• در نصب مرکز داده تکی، همه گره‌های ZooKeeper به‌طور پیش‌فرض به‌عنوان رهبر پیکربندی می‌شوند. وقتی Edge را در چندین مرکز داده نصب می‌کنید، برخی‌از گره‌های ZooKeeper به‌عنوان ناظر پیکربندی می‌شوند. مطمئن شوید که ویژگی ZK_HOSTS در بالا گره رهبر را در نصب مرکز داده چندگانه مشخص می‌کند.
• اگر اصالت‌سنجی Cassandra را فعال کنید، می‌توانید نام کاربری و گذرواژه Cassandra را بااستفاده از ویژگی‌های زیر ارسال کنید:

  CASS_USERNAME
  CASS_PASSWORD

ادغام کردن «خدمات درآمدزایی» با همه «سرورهای مدیریت»

از روش زیر برای ادغام درآمدزایی در گره‌های «سرور مدیریت» استفاده کنید.

1. اگر «درآمدزایی» را در توپولوژی Edge نصب می‌کنید که از چند گره «سرور مدیریت» استفاده می‌کند، مثلاً نصب ۱۳ گره، مطمئن شوید که هر دو گره «سرور مدیریت» را قبل‌از نصب «درآمدزایی» نصب کرده‌اید.
2. در گره «سرور مدیریت»، دستورگان راه‌اندازی را اجرا کنید:
   

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

   گزینه -p mo مشخص می‌کند که «درآمدزایی» ادغام شود.

   فایل پیکربندی باید برای کاربر «apigee» قابل‌دسترسی یا خواندن باشد.

3. اگر «درآمدزایی» را روی چندین گره «سرور مدیریت» نصب می‌کنید، مرحله ۲ را روی گره دوم «سرور مدیریت» تکرار کنید.

درصورت پیکربندی موفق، طرح‌واره RDBMS برای «سرویس‌های درآمدزایی» در پایگاه داده PostgreSQL ایجاد می‌شود. با این کار، ادغام «سرویس‌های درآمدزایی» و مؤلفه‌های مرتبط با آن با Postgres Server تکمیل می‌شود.

ادغام کردن «سرویس‌های درآمدزایی» با همه «پردازشگرهای پیام»

از روش زیر برای ادغام درآمدزایی در همه گره‌های «پردازشگر پیام» استفاده کنید.

1. در اولین گره «پردازشگر پیام»، در خط فرمان، دستورگان راه‌اندازی را اجرا کنید:

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

   گزینه -p mo مشخص می‌کند که «درآمدزایی» ادغام شود.

   کاربر «apigee» باید به فایل پیکربندی دسترسی داشته باشد یا بتواند آن را بخواند.

2. این فرایند را در همه گره‌های «پردازشگر پیام» تکرار کنید.

در پیکربندی موفق، «پردازشگر پیام» با «خدمات درآمدزایی» به‌روز می‌شود. این کار ادغام «سرویس‌های درآمدزایی» و عناصر مرتبط آن با «پردازشگرهای پیام» را تکمیل می‌کند.

آماده‌سازی برای درآمدزایی

برای ایجاد سازمان جدید و فعال کردن درآمدزایی:

1. سازمان را مانند هر سازمان جدید دیگری ایجاد کنید. برای اطلاعات بیشتر، به به‌کارگیری سازمان مراجعه کنید.
2. از API آماده‌سازی درآمدزایی همان‌گونه که در فعال کردن درآمدزایی برای یک سازمان توضیح داده شده است استفاده کنید. برای انجام این کار، باید امتیازهای سرپرست سیستم را داشته باشید.

وقتی دفعه بعد به سیستم New Edge UI وارد می‌شوید، ورودی «درآمدزایی» را در منو سطح بالا برای سازمان می‌بینید:

برای پیکربندی درگاه جهت پشتیبانی از درآمدزایی، به پیکربندی درآمدزایی در درگاه توسعه‌دهندگان مراجعه کنید.

افزودن گره «سرور مدیریت» به نصب «درآمدزایی»

اگر «سرور مدیریت» را به نصب Edge موجود اضافه می‌کنید، باید مطمئن شوید که سرویس‌های «درآمدزایی» را به «سرور مدیریت» جدید اضافه می‌کنید و همه «سرورهای مدیریت» را پیکربندی می‌کنید تا بتوانند ارتباط برقرار کنند.

برای افزودن «سرور مدیریت»:

1. Management Server جدید را نصب کنید.
2. بااستفاده از فرمان زیر، «درآمدزایی» را در «سرور مدیریت» جدید نصب کنید:

   /opt/apigee/apigee-setup/bin/setup.sh -p mo -f /opt/silent.conf

پیکربندی اضافی

اسناد صورت‌حساب را به‌صورت فایل PDF ارائه دهید

«درآمدزایی» اسناد صورت‌حساب را به کاربران نهایی در قالب HTML نمایش می‌دهد. برای ارائه اسناد صورت‌حساب به‌صورت فایل PDF، می‌توانید «آماده‌سازی برای درآمدزایی» را با سیستم صورت‌حسابی که تولید PDF را ارائه می‌دهد ادغام کنید یا برای کتابخانه PDF طرف سوم پشتیبانی‌شده پروانه بگیرید.

پیکربندی تنظیمات سازمان

برای افزودن/به‌روزرسانی مشخصه‌های سازمان، می‌توانید از درخواست 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"
      }
    ]
  }
}

جدول زیر مشخصه‌های سطح سازمان را که برای پیکربندی سازمان ضرب دردسترس است فهرست می‌کند.

برای پیکربندی تنظیمات سازمان کسب‌وکار بااستفاده از New Edge UI، به شروع به استفاده از درآمدزایی مراجعه کنید.

محدودیت‌های درآمدزایی

برای اعمال محدودیت‌های درآمدزایی، خط‌مشی «بررسی محدودیت‌های درآمدزایی» را به پراکسی‌های API پیوست کنید. به‌طور خاص، این خط‌مشی تحت شرایط زیر فعال می‌شود:

• توسعه‌دهنده‌ای که به میانای برنامه‌سازی کاربردی درآمدزاشده دسترسی دارد ثبت‌نام نکرده است یا در طرح نرخ مشترک نشده است.
• توسعه‌دهنده از حجم تراکنش برای طرح نرخ اشتراک فراتر رفته است.
• موجودی حساب پیش‌پرداخت‌شده یا حد اعتبار پس‌پرداخت‌شده توسعه‌دهنده به پایان رسیده است.

خط‌مشی «بررسی محدودیت‌های درآمدزایی» در شرایطی مانند موارد ذکرشده در بالا، خطا ایجاد می‌کند و فراخوانی‌های میانای برنامه‌سازی کاربردی را مسدود می‌کند. این خط‌مشی خط‌مشی «ایجاد خطا» را گسترش می‌دهد و می‌توانید پیام برگردانده‌شده را سفارشی‌سازی کنید. شرایط قابل‌اعمال از متغیرهای کسب‌وکار مشتق می‌شوند.

برای اطلاعات بیشتر، به اعمال محدودیت‌های درآمدزایی در پراکسی‌های میانای برنامه‌سازی کاربردی مراجعه کنید.