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

Edge for Private Cloud v. 4.17.09

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

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

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

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

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

• apigee-setup का इस्तेमाल करें कमाई करने की सेवाएं चालू करने के लिए, Apigee मैनेजमेंट सर्वर नोड को अपडेट करने की सुविधा उदाहरण, कैटलॉग मैनेजमेंट, सीमाएं और सूचनाओं का कॉन्फ़िगरेशन, बिलिंग और रिपोर्टिंग.
  अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
  अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है अगर आपके पास एक से ज़्यादा मैनेजमेंट सर्वर नोड हैं, जैसे कि 13-नोड इंस्टॉलेशन, तो आपको कमाई करने की सुविधा इंस्टॉल करने से पहले, एज मैनेजमेंट सर्वर नोड को इंस्टॉल करना होगा.
• apigee-setup का इस्तेमाल करें यह सुविधा, Apigee मैसेज प्रोसेसर को अपडेट करने की सुविधा देती है, ताकि इसके रनटाइम कॉम्पोनेंट को चालू किया जा सके कमाई करने से जुड़ी सेवाएं, जैसे कि लेन-देन रिकॉर्ड करने की नीति और सीमा लागू करने का तरीका. अगर आपको कई मैसेज प्रोसेसर हैं, तो उन सभी पर कमाई करने की सुविधा इंस्टॉल करें.
• अपने Edge संगठनों के लिए कमाई करने से जुड़ी प्रोसेस को पूरा करें.
• कमाई करने में मदद करने के लिए डेवलपर सेवाएं पोर्टल को कॉन्फ़िगर करें. ज़्यादा जानकारी के लिए, यह देखें http://apigee.com/docs/monetization/content/configure-monetization-developer-portal.

इसके लिए एक मौन कॉन्फ़िगरेशन फ़ाइल बनाई जा रही है कमाई करने से जुड़ी जानकारी वाली रिपोर्ट

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

ध्यान दें: आम तौर पर, इन प्रॉपर्टी को उसी कॉन्फ़िगरेशन फ़ाइल में जोड़ा जाता है जिससे का इस्तेमाल किया था, जैसा कि Install 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 की जानकारी नहीं दी गई है, तो उसे जोड़ें. कमाई करने के लिए ज़रूरी है कि एसएमटीपी सर्वर.
• किसी एक डेटा सेंटर इंस्टॉलेशन में, सभी 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. कमाई करने वाला ग्रुप बनाएं: 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 सक्षम-कमाई करने -f configFile
   
   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" ऐक्सेस कर सके या पढ़ सके उपयोगकर्ता.
   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है अगर आपके पास एक से ज़्यादा मैनेजमेंट सर्वर हैं, तो आपको इस स्क्रिप्ट को उनमें से किसी एक पर ही चलाना होगा.
   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
   अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है यह स्क्रिप्ट कैसंड्रा के संगठन, प्रॉडक्ट, डेवलपर, और ऐप्लिकेशन की कॉपी बनाती है डेटाबेस से Monetization PostgreSQL डेटाबेस को जोड़ा जाता है. कमाई करने की सुविधा इंस्टॉल होने के बाद इन सेवाओं में डेटा अपने-आप सिंक हो जाता है.
2. उन सभी संगठनों के लिए यह तरीका दोहराएं जहां आपको कमाई करने की सुविधा चालू करनी है.
3. अगर आप एक से ज़्यादा डेटा सेंटर एनवायरमेंट में हैं, तो मैनेजमेंट पेज पर इस प्रोसेस को दोहराएं दूसरे डेटा सेंटर में मौजूद सर्वर. पक्का करें कि कॉन्फ़िगरेशन फ़ाइल में, सिर्फ़ Qpid नोड शामिल हों डेटा सेंटर को कॉन्फ़िगर किया जा रहा है.

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

डेवलपर को कॉन्फ़िगर करना सेवाओं का पोर्टल

कमाई करने में मदद करने के लिए डेवलपर सेवाएं पोर्टल को कॉन्फ़िगर करने के लिए, 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-सर्वर रीस्टार्ट
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-सर्वर रीस्टार्ट

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

बिलिंग दस्तावेज़ इस खाते से दें: PDF फ़ाइलें

कमाई करने की सुविधा चालू होने पर, असली उपयोगकर्ताओं को बिलिंग के दस्तावेज़ एचटीएमएल फ़ॉर्मैट में दिखते हैं. बिलिंग उपलब्ध कराने के लिए साथ ही, कमाई करने की सुविधा को PDF फ़ाइल के तौर पर उपलब्ध बिलिंग सिस्टम के साथ इंटिग्रेट किया जा सकता है. इस्तेमाल की जा सकने वाली तीसरे पक्ष की PDF लाइब्रेरी जनरेट करना या उसका लाइसेंस देना.

संगठन को कॉन्फ़िगर करें सेटिंग

बैकएंड सेटिंग: यहां दी गई टेबल में संगठन लेवल के एट्रिब्यूट की सूची दी गई है जो किसी मिंट संगठन को कॉन्फ़िगर करने के लिए उपलब्ध हों. इन्हें जोड़ने/अपडेट करने के लिए, 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"
            }
        ]
    }
}

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके, कारोबारी संगठन की सेटिंग कॉन्फ़िगर करने के लिए, http://apigee.com/docs/monetization-services/content/get-started-using-monetization-services पर जाएं, और देखें.

ध्यान दें: अगर कमाई करने से जुड़ी सेवाओं की सीमाओं और सूचनाओं का इस्तेमाल किया जा रहा है सुविधाओं के लिए, कृपया अपने डेवलपर को यह निर्देश दें कि वे ऐक्सेस टोकन की पुष्टि से जुड़ी नीति.

सीमा नीति एक खास नीति है. इसे खास तौर पर किसी एपीआई कॉल को ब्लॉक करने के लिए बनाया गया है. ऐसा तब किया जाता है, जब पहुंच गया. यह नीति, कारोबार की सीमाओं की जांच करती है. अगर कारोबार की किसी भी सीमा से ज़्यादा कॉन्फ़िगर की गई वैल्यू. यह गड़बड़ी बढ़ाने से जुड़ी नीति का ही एक हिस्सा है, लेकिन इसमें शर्तों के हिसाब से बदलाव किए गए हैं बदल सकते हैं.

प्रॉक्सी डेवलपर के लिए प्रबंधन यूज़र इंटरफ़ेस (यूआई) में एक यूज़र इंटरफ़ेस (यूआई) टेम्प्लेट उपलब्ध है. प्रॉक्सी डेवलपर को यह करना चाहिए मैसेज फ़्लो में मिंट नीति अटैच करें. इस नीति के लागू होने पर गड़बड़ी की जानकारी दी जाएगी में गड़बड़ी हुई है. अगर ContinueOnError सही पर सेट है, तो गड़बड़ी "mint.limitsViolated", "mint.limitsViolated" जैसे फ़्लो वैरिएबल बढ़ाए नहीं जाएंगे और फ़्लो वैरिएबल नहीं बनाए जाएंगे और "mint.limitsPolicyError" वैरिएबल को सेट किया जाएगा जिसका इस्तेमाल ज़रूरत पड़ने पर और अपवाद मैनेज करने के लिए किया जा सकता है.