कमाई करने से जुड़ी सेवाएं इंस्टॉल करना

कमाई करने से जुड़ी सेवाएं, Apigee Edge का एक्सटेंशन है. इसलिए, यह अलग से काम नहीं करती प्रोसेस. यह सुविधा, ऑल-इन-वन (एआईओ) को छोड़कर, किसी भी मौजूदा Apigee Edge के सेटअप में काम करती है कॉन्फ़िगरेशन. किसी एआईओ कॉन्फ़िगरेशन पर, कमाई करने से जुड़ी सेवाएं इंस्टॉल नहीं की जा सकतीं.

कमाई करने के लिए ज़रूरी शर्तें

  • अगर कमाई करने की सुविधा को एज टोपोलॉजी के लिए इंस्टॉल किया जा रहा है, जो एक से ज़्यादा मैनेजमेंट सर्वर का इस्तेमाल करता है नोड, जैसे कि 13-नोड इंस्टॉलेशन के लिए, आपको Edge मैनेजमेंट सर्वर के दोनों नोड इंस्टॉल करने होंगे कमाई करने की सुविधा इंस्टॉल करने से पहले.
  • Edge पर कमाई करने की सुविधा इंस्टॉल करने के लिए, जहां Edge इंस्टॉलेशन में कई पोस्टग्रे नोड हैं, Postgres नोड को मास्टर/स्टैंडबाय मोड में कॉन्फ़िगर किया जाना चाहिए. कमाई करने की सुविधा को इंस्टॉल नहीं किया जा सकता अगर आपके पास एक से ज़्यादा Postgres मास्टर नोड हैं, तो Edge पर खोलें. ज़्यादा जानकारी के लिए, यह देखें इसके लिए मास्टर-स्टैंडबाय रेप्लिकेशन सेट अप करें पोस्टग्रेस.
  • ऑल-इन-वन (AIO) कॉन्फ़िगरेशन के साथ कमाई करने की सुविधा उपलब्ध नहीं है.

इंस्टॉल करने के बारे में खास जानकारी

किसी मौजूदा Apigee Edge पर कमाई करने से जुड़ी सेवाएं जोड़ने का तरीका यहां बताया गया है इंस्टॉलेशन:

  • Apigee मैनेजमेंट सर्वर नोड को अपडेट करने के लिए, apigee-setup सुविधा का इस्तेमाल करें कमाई करने से जुड़ी सेवाओं को चालू करना. उदाहरण के लिए, कैटलॉग मैनेजमेंट, सीमाएं, और सूचनाएं कॉन्फ़िगरेशन, बिलिंग, और रिपोर्टिंग.

    अगर आपके पास एक से ज़्यादा मैनेजमेंट सर्वर नोड हैं, जैसे कि 13-नोड इंस्टॉलेशन, तो आपको कमाई करने की सुविधा इंस्टॉल करने से पहले, एज मैनेजमेंट सर्वर नोड को इंस्टॉल करना होगा.

  • apigee-setup का इस्तेमाल करना यह सुविधा, Apigee मैसेज प्रोसेसर को अपडेट करने की सुविधा देती है, ताकि इसके रनटाइम कॉम्पोनेंट को चालू किया जा सके कमाई करने से जुड़ी सेवाएं, जैसे कि लेन-देन रिकॉर्ड करने की नीति और सीमा लागू करने का तरीका. अगर आपको कई मैसेज प्रोसेसर हैं, तो उन सभी पर कमाई करने की सुविधा इंस्टॉल करें.
  • अपने Edge संगठनों के लिए कमाई करने से जुड़ी प्रोसेस को पूरा करें.
  • कमाई करने के लिए, Apigee Developer Services पोर्टल (या पोर्टल) को कॉन्फ़िगर करें. ज़्यादा जानकारी के लिए, यह देखें डेवलपर पोर्टल में कमाई करने की सुविधा कॉन्फ़िगर करना.

कमाई करने के लिए, बिना आवाज़ वाली कॉन्फ़िगरेशन फ़ाइल बनाना

कमाई करने के लिए इंस्टॉलेशन के लिए, साइलेंट कॉन्फ़िगरेशन फ़ाइल का उदाहरण नीचे दिया गया है. इसमें बदलाव करें फ़ाइल का उपयोग करें. इस फ़ाइल को शामिल करने के लिए, -f विकल्प का इस्तेमाल करके setup.sh को शामिल करें.

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

ध्यान दें:

  • अगर आपकी Edge कॉन्फ़िगरेशन फ़ाइल में SMTP की जानकारी नहीं दी गई है, तो उसे जोड़ें. कमाई करने के लिए ज़रूरी है कि एसएमटीपी सर्वर.
  • किसी एक डेटा सेंटर इंस्टॉलेशन में, सभी ZooKeeper नोड डिफ़ॉल्ट रूप से इस तरह कॉन्फ़िगर होते हैं: लीडर. एक से ज़्यादा डेटा सेंटर में Edge इंस्टॉल करने पर, कुछ ZooKeeper नोड उसे ऑब्ज़र्वर के तौर पर कॉन्फ़िगर किया जाना चाहिए. पक्का करें कि ऊपर दी गई ZK_HostS प्रॉपर्टी, कई डेटा सेंटर इंस्टॉल करना.
  • अगर आप Cassandra की पुष्टि करने की सुविधा चालू करते हैं, तो आप Cassandra का उपयोगकर्ता नाम और पासवर्ड पास कर सकते हैं इसके लिए, नीचे दी गई प्रॉपर्टी का इस्तेमाल करें: 
    CASS_USERNAME
CASS_PASSWORD
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

कमाई करने से जुड़ी सेवाओं को मैनेजमेंट सर्वर के साथ इंटिग्रेट करें

मैनेजमेंट सर्वर नोड पर कमाई करने की सुविधा इंटिग्रेट करने के लिए, नीचे दी गई प्रोसेस का इस्तेमाल करें.

  1. अगर कमाई करने की सुविधा को एज टोपोलॉजी के लिए इंस्टॉल किया जा रहा है, जो एक से ज़्यादा मैनेजमेंट सर्वर का इस्तेमाल करता है नोड, जैसे कि 13-नोड इंस्टॉलेशन. इसके बाद पक्का करें कि आपने दोनों मैनेजमेंट सर्वर इंस्टॉल किए हैं तय करें.
  2. मैनेजमेंट सर्वर नोड पर, सेटअप स्क्रिप्ट चलाएं:
    /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile

    -p mo विकल्प का इस्तेमाल करके, कमाई करने की सुविधा को शामिल किया जाता है.

    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" ऐक्सेस कर सके या पढ़ सके उपयोगकर्ता.

  3. अगर एक से ज़्यादा मैनेजमेंट सर्वर नोड पर कमाई करने की सुविधा इंस्टॉल की जा रही है, तो दूसरे चरण को दूसरा मैनेजमेंट सर्वर नोड.

कॉन्फ़िगरेशन पूरा होने पर, कमाई करने से जुड़ी सेवाओं के लिए आरडीबीएमएस स्कीमा, PostgreSQL डेटाबेस. यह कमाई करने से जुड़ी सेवाओं और उनसे जुड़ी सेवाओं को इंटिग्रेट करने की प्रोसेस पूरी करता है Postgres सर्वर वाले कॉम्पोनेंट.

कमाई करने से जुड़ी सेवाओं को सभी मैसेज प्रोसेसर के साथ इंटिग्रेट करें

सभी मैसेज प्रोसेसर पर कमाई करने की सुविधा इंटिग्रेट करने के लिए, नीचे दी गई प्रक्रिया का इस्तेमाल करें नोड.

  1. पहले मैसेज प्रोसेसर नोड पर, कमांड प्रॉम्प्ट पर, सेटअप स्क्रिप्ट चलाएं: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mo -f configFile
    अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

    -p mo विकल्प का इस्तेमाल करके, कमाई करने की सुविधा को शामिल किया जाता है.

    कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" ऐक्सेस कर सके या पढ़ सके उपयोगकर्ता.

  2. यह प्रोसेस सभी मैसेज प्रोसेसर नोड पर दोहराएं.

कॉन्फ़िगरेशन पूरा होने पर, मैसेज प्रोसेसर को कमाई करने से जुड़ी सेवाओं के साथ अपडेट कर दिया जाता है. यह यह, कमाई करने से जुड़ी सेवाओं और इससे जुड़े कॉम्पोनेंट को मैसेज के साथ इंटिग्रेट करने की प्रोसेस पूरी करता है प्रोसेसर.

कमाई करने के लिए शामिल होना

नया संगठन बनाने और कमाई करने की सुविधा चालू करने के लिए:

  1. एक जैसा संगठन बनाएं. ज़्यादा जानकारी के लिए, यह देखें किसी संगठन को जोड़ना.
  2. इसमें बताए गए तरीके से, मॉनेटाइज़ेशन प्रॉविज़निंग एपीआई का इस्तेमाल करें चालू करें किसी संगठन के लिए कमाई करने की सुविधा. ऐसा करने के लिए, आपके पास सिस्टम एडमिन होना ज़रूरी है खास अधिकारों को ऐक्सेस करना होगा.

Edge के यूज़र इंटरफ़ेस (यूआई) में अगली बार लॉग इन करने पर, आपको सबसे ऊपर के मेन्यू में कमाई करने की एंट्री दिखेगी संगठन:

कमाई करने में मदद करने के लिए पोर्टल को कॉन्फ़िगर करने के लिए, कमाई करने की सुविधा को कॉन्फ़िगर करें डेवलपर पोर्टल पर जाकर देखें.

कमाई करने के लिए इंस्टॉलेशन में मैनेजमेंट सर्वर नोड जोड़ना

अगर किसी मौजूदा 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

अतिरिक्त कॉन्फ़िगरेशन

बिलिंग के दस्तावेज़ों को 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"
      }
    ]
  }
}

नीचे दी गई टेबल में संगठन-लेवल के उन एट्रिब्यूट की सूची दी गई है जो कॉन्फ़िगर करने के लिए उपलब्ध हैं मिंट संगठन.

विशेषताएं ब्यौरा
MINT_TAX_MODEL

स्वीकार की जाने वाली वैल्यू "DISCLOSED", "UNDISCLOSED", "HYBRID" हैं (डिफ़ॉल्ट वैल्यू शून्य पर सेट होती है)
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

"PROरेटेड", "CALENDAR_MONTH" (डिफ़ॉल्ट "CALENDAR_MONTH" है)
MINT_SUPPORTED_BILLING_TYPE

&quot;PREPAID&quot;/&quot;POSTPAID&quot;/&quot;BOTH&quot; (डिफ़ॉल्ट रूप से यह "PREPAYMENT" पर सेट होता है)
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.config.isOperator

सेवा देने वाले को ऑपरेटर वर्सेज़ संगठन के रूप में दिखाने के लिए मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) इसका इस्तेमाल करता है (डिफ़ॉल्ट यह है "सही")

प्रबंधन यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके कारोबारी संगठन की सेटिंग कॉन्फ़िगर करने के लिए, देखें कमाई करने की सुविधा का इस्तेमाल शुरू करें.

कमाई करने की सीमाएं

कमाई करने की सीमाएं लागू करने के लिए, एपीआई प्रॉक्सी में कमाई करने की सीमाओं की जांच करने की नीति अटैच करें. खास तौर पर, नीति इन शर्तों के तहत ट्रिगर होती है:

  • कमाई करने वाले एपीआई को ऐक्सेस करने वाले डेवलपर ने रजिस्टर नहीं किया है या उसने दर की सदस्यता नहीं ली है प्लान.
  • कीमत वाले प्लान के लिए, डेवलपर ने लेन-देन की तय सीमा पार कर ली है.
  • डेवलपर के प्रीपेड खाते में बाकी बैलेंस या पोस्ट-पेड क्रेडिट की सीमा पूरी हो गई है.

कमाई करने की सीमाओं की जांच करने की नीति के तहत, गड़बड़ियों को बढ़ावा दिया जाता है और एपीआई कॉल को ब्लॉक किया जाता है, जैसे कि वे ऊपर बताए गए हैं. इस नीति में, नीति के उल्लंघन से जुड़ी समस्या ठीक करने के बारे में ज़्यादा जानकारी दी गई है. साथ ही, इस मैसेज को पसंद के मुताबिक बनाया जा सकता है वापस किया गया. लागू होने वाली शर्तें, कारोबार के वैरिएबल से तय की जाती हैं.

ज़्यादा जानकारी के लिए, नीति उल्लंघन ठीक करने का तरीका (एनफ़ोर्समेंट) लागू करें एपीआई प्रॉक्सी पर कमाई करने की सीमाएं.