4.15.07.00 - Private Cloud के लिए Apigee Edge के रिलीज़ नोट

आपको Apigee Edge का दस्तावेज़ दिख रहा है.
Apigee X के दस्तावेज़ पर जाएं.
जानकारी

हमने मंगलवार, 8 सितंबर, 2015 को Apigee Edge for Private Cloud की एक अहम सुविधा रिलीज़ की थी.

Edge for Private Cloud की पिछली तिमाही की रिलीज़ (4.15.04.00) के बाद, ये रिलीज़ हुई हैं और इन्हें इस तिमाही की रिलीज़ में शामिल किया गया है:

Edge के किन वर्शन को 4.15.07.00 पर अपग्रेड किया जा सकता है

Edge के मौजूदा वर्शन के हिसाब से, इनमें से कोई एक काम किया जा सकता है:

  • सीधे 4.15.07.00 पर अपग्रेड करें
  • धीरे-धीरे अपग्रेड करें. इसका मतलब है कि आपको Edge के मौजूदा वर्शन से किसी दूसरे वर्शन पर अपग्रेड करना होगा. इसके बाद, 4.15.07.00 पर अपग्रेड करना होगा.

ज़्यादा जानकारी के लिए, Private Cloud के किन वर्शन को 4.15.07.00 पर अपग्रेड किया जा सकता है लेख पढ़ें.

वर्शन 4.15.01.x या इससे पहले के वर्शन से अपग्रेड करने से पहले

अपग्रेड करने से पहले, पक्का करें कि आपने हर Cassandra नोड पर Cassandra SSTable को अपग्रेड कर लिया हो:
  1. Cassandra SSTable का वर्शन देखें:
    1. डायरेक्ट्री को /<install-root>/apigee4/data/cassandra/data पर बदलें.
    2. find कमांड चलाएं,
      > find . -name *-ic-*
      अगर Cassandra 1 .2 SSTable का इस्तेमाल किया जा रहा है, तो नतीजों में.db फ़ाइलों का सेट दिखना चाहिए.
    3. खोज करने के इस निर्देश को चलाएं:
      > find . -name *-hf-*
      नतीजे खाली होने चाहिए. इसका मतलब है कि hf फ़ॉर्मैट में कोई .db फ़ाइल नहीं है. अगर आपको hf फ़ॉर्मैट में कोई फ़ाइल नहीं दिखती है, तो इसका मतलब है कि आपने सभी फ़ाइलें अपलोड कर दी हैं. अब 4.15.07.00 वर्शन पर अपग्रेड किया जा सकता है.

      hf फ़ॉर्मैट, Cassandra 1.0 SSTables के लिए है. अगर आपके पास hf फ़ॉर्मैट में कोई *.db फ़ाइल है, तो आपको इस प्रोसेस में बताए गए तरीके से SSTable को अपग्रेड करना होगा.
  2. अगर आपको hf फ़ॉर्मैट में कोई *.db फ़ाइल मिलती है, तो SSTable को अपग्रेड करें. इसके लिए, हर Cassandra नोड पर यह कमांड चलाएं. ऐसा तब तक करें, जब तक सभी Cassandra नोड अपग्रेड न हो जाएं:
    > /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradesstables -a
  3. पहले चरण को दोहराएं. इससे यह पता चलेगा कि Cassandra 1.2 वर्शन के लिए, सभी *.db फ़ाइलें ic फ़ॉर्मैट में हैं या नहीं.
  4. Edge इंस्टॉलेशन में मौजूद हर Cassandra नोड पर, पहले से तीसरे चरण तक की प्रक्रिया दोहराएं.
  5. Edge 4.15.07.00 पर अपग्रेड करें.
  6. 4.15.07.00 वर्शन पर अपग्रेड करने के बाद, *.db फ़ाइलों की जांच करें. इससे यह पक्का किया जा सकेगा कि सभी फ़ाइलें, C* 2.0 स्टाइल sstable में अपग्रेड हो गई हैं:
    > cd /<install-root>/apigee4/data/cassandra/data
    > find . -name *-jb-*

    अगर Cassandra 2 .0 का इस्तेमाल किया जा रहा है, तो इस कमांड से.db फ़ाइलों का सेट वापस मिलना चाहिए.

नई सुविधाएं और बेहतर टूल

इस रिलीज़ में जोड़ी गई नई सुविधाएं और किए गए सुधार यहां दिए गए हैं.

इंस्टॉल करना और अपग्रेड करना

चुनिंदा कॉम्पोनेंट को अपग्रेड और अनइंस्टॉल करना

apigee-upgrade.sh और apigee-uninstall.sh स्क्रिप्ट की मदद से, अब Edge के उन कॉम्पोनेंट को चुना जा सकता है जिन्हें अपग्रेड या अनइंस्टॉल करना है. इससे पहले, यह नोड पर मौजूद सभी कॉम्पोनेंट को अपग्रेड या अनइंस्टॉल कर देता था. (OPDK-1377, OPDK-1175)

अपग्रेड को रोलबैक करना

अगर अपग्रेड के दौरान apigee-upgrade.sh स्क्रिप्ट काम नहीं करती है, तो अब अपग्रेड को वापस लाने के लिए apigee-rollback.sh स्क्रिप्ट का इस्तेमाल किया जा सकता है. अपग्रेड से जुड़ी किसी भी समस्या को ठीक करने के बाद, अपग्रेड करने की प्रोसेस को फिर से शुरू किया जा सकता है. (OPDK-1275)

इंस्टॉलर स्क्रिप्ट के छोटे किए गए विकल्प

इंस्टॉल स्क्रिप्ट में अब विकल्पों का पूरा नाम नहीं लिखा जाता. जैसे, --help. अब इनमें सिर्फ़ एक अक्षर वाले विकल्प इस्तेमाल किए जाते हैं, जैसे कि -h. (OPDK-1356)

SmartDocs इंस्टॉल करना

setup-smartdocs.sh स्क्रिप्ट का इस्तेमाल करके SmartDocs इंस्टॉल करते समय, आपको संगठन, एनवायरमेंट, और वर्चुअल होस्ट डालने के लिए कहा जाता है. इससे यह पक्का होता है कि SmartDocs को सही जगह पर इंस्टॉल किया गया है. पहले, उन वैल्यू को स्क्रिप्ट में हार्ड-कोड किया जाता था. (OPDK-1310)

बिना किसी प्रॉम्प्ट के update-cass-pwd-in-config.sh स्क्रिप्ट चलाना

अगर आपने ENABLE_CASS_AUTH, CASS_USERNAME, और CASS_PASSWORD एनवायरमेंट वैरिएबल सेट किए हैं, तो update-cass-pwd-in-config.sh स्क्रिप्ट बिना किसी प्रॉम्प्ट के चल सकती है. (OPDK-1309)

Edge Platform

इस रिलीज़ में, Edge प्लैटफ़ॉर्म की ये नई सुविधाएं शामिल हैं.

OpenJDK 1.7, Edge Private Cloud के साथ काम करता है

Edge के इस वर्शन में Oracle JDK 1.7 और OpenJDK 7 काम करते हैं. साथ ही, JDK 1.6 के लिए काम नहीं करता. (OPDK-1187)

ओएस सपोर्ट

Apigee Edge for Private Cloud अब इन ऑपरेटिंग सिस्टम पर काम करता है: Red Hat Enterprise Linux 6.6 और 7.0 (64-bit), CentOS 6.5, 6.6, और 7.0 (64-bit), और Oracle Linux 6.5.

OPDK 15.07 में Cassandra 2.0.15 शामिल है

इस रिलीज़ में Cassandra 2.0.15 इंस्टॉल किया गया है. अगर आपको पिछली रिलीज़ के लिए अपग्रेड करना है, तो Cassandra का आपका वर्शन अपडेट हो जाएगा. (OPDK-1197)

OAuth टोकन हैशिंग के लिए SHA2 का इस्तेमाल किया जा सकता है

डेटाबेस की सुरक्षा में सेंध लगने की स्थिति में, OAuth टोकन को बेहतर तरीके से सुरक्षित रखने के लिए, Edge, OAuth टोकन को हैश करने के लिए SHA2 एल्गोरिदम का इस्तेमाल करता है. इसके अलावा, SHA1 का भी इस्तेमाल किया जाता है. संगठन-लेवल की नई प्रॉपर्टी की मदद से, नए टोकन के लिए हैशिंग की सुविधा चालू और कॉन्फ़िगर की जा सकती है. साथ ही, इस नई सुविधा से पहले मौजूद किसी भी टोकन पर लेगसी हैशिंग की सुविधा बनाए रखी जा सकती है. Edge for Private Cloud के पिछले वर्शन में, keymanagement.properties फ़ाइल में hash.oauth.tokens.enabled नाम की प्रॉपर्टी मौजूद थी. यह प्रॉपर्टी, आपके मैनेजमेंट सर्वर और मैसेज प्रोसेसर पर मौजूद होती थी. इसकी मदद से, OAuth टोकन को SHA1 एल्गोरिदम का इस्तेमाल करके अपने-आप हैश किया जा सकता था. यह प्रॉपर्टी अब काम नहीं करती है.

अगर आपने SHA1 हैशिंग को चालू करने के लिए, hash.oauth.tokens.enabled प्रॉपर्टी का इस्तेमाल किया था, तो इस रिलीज़ के लिए अपग्रेड स्क्रिप्ट, आपके लिए संगठन-लेवल की नई प्रॉपर्टी अपने-आप जनरेट करती है. अपग्रेड करने के बाद पुष्टि करने के लिए, सिस्टम एडमिन के तौर पर इस एपीआई के साथ GET करें: https://{host}:{port}/v1/o/{your_org}.

  • नई प्रॉपर्टी के साथ अपने संगठन में टोकन हैशिंग की सुविधा चालू करने के बारे में जानकारी के लिए, ऐक्सेस टोकन का अनुरोध करना विषय में "डेटाबेस में टोकन हैश करना" लेख पढ़ें.
  • मौजूदा टोकन को एक साथ हैश करने के बारे में जानकारी पाने के लिए, Edge for Private Cloud की ऑपरेशंस गाइड देखें. (APIRT-1389)

लॉग फ़ाइलों के लिए फ़्लैट डायरेक्ट्री स्ट्रक्चर

Edge को कॉन्फ़िगर किया जा सकता है, ताकि वह लॉग फ़ाइलों को फ़्लैट डायरेक्ट्री स्ट्रक्चर में सेव करे. इसके लिए, message-logging.properties फ़ाइल में नई enable.flat.directory.structure प्रॉपर्टी को सही पर सेट करें. ज़्यादा जानकारी के लिए, मैसेज लॉगिंग की नीति देखें. (APIRT-1394)

एनवायरमेंट कैश मेमोरी की परफ़ॉर्मेंस

इन-मेमोरी कैश को बेहतर तरीके से मैनेज करने और उसका इस्तेमाल करने के लिए, एनवायरमेंट कैश रिसॉर्स पर मौजूद "मेमोरी में ज़्यादा से ज़्यादा एलिमेंट" सेटिंग को बंद कर दिया गया है. सभी कैश मेमोरी संसाधनों (डिफ़ॉल्ट कैश मेमोरी भी शामिल है) में मौजूद कुल एलिमेंट की संख्या, कैश मेमोरी को असाइन की गई कुल मेमोरी पर निर्भर करती है. डिफ़ॉल्ट रूप से, किसी मैसेज प्रोसेसर पर इन-मेमोरी कैशिंग के लिए आवंटित की गई कुल मेमोरी, उपलब्ध कुल मेमोरी का 40% होती है. यह मैसेज प्रोसेसर cache.properties फ़ाइल में कैश प्रॉपर्टी की सेटिंग से तय होती है. मेमोरी में मौजूद कैश मेमोरी से एलिमेंट सिर्फ़ तब हटाए जाएंगे, जब कैश मेमोरी कम हो या एलिमेंट की समयसीमा खत्म हो गई हो.

कैश मेमोरी को मैनेज करने के लिए, "मैक्सिमम एलिमेंट इन मेमोरी" प्रॉपर्टी का इस्तेमाल करने के पुराने तरीके पर वापस जाने के लिए, cache.properties फ़ाइल में overrideMaxElementsInCacheResource=false प्रॉपर्टी सेट करें. (APIRT-1140)


एपीआई सेवाएं

इस रिलीज़ में, एपीआई सेवाओं की ये नई सुविधाएं शामिल हैं.

डिफ़ॉल्ट रूप से नए प्रॉक्सी एडिटर का इस्तेमाल करना

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, नया एपीआई प्रॉक्सी एडिटर डिफ़ॉल्ट रूप से चालू होता है. नए संपादक में कई प्रयोज्य सुधार शामिल हैं, जिनमें अवलोकन पृष्ठ पर सशर्त प्रवाह और समापन बिंदुओं के अधिक व्यापक दृश्य, डेवलप पृष्ठ पर सभी कॉन्फ़िगरेशन, सशर्त प्रवाह, समापन बिंदुओं और नीतियों को अधिक सहजता से जोड़ना, छोटे स्निपेट के बजाय अधिक पूर्ण XML दृश्य, फ़ाइल नामों और पाठ को क्रॉल करने वाली खोज, और बहुत कुछ शामिल हैं. (MGMT-2279)

OAuth v2.0 की जानकारी मिटाने से जुड़ी नई नीति

"OAuth v2.0 की जानकारी मिटाएं" नाम की नई नीति की मदद से, OAuth v2 के ऐक्सेस टोकन और ऑथराइज़ेशन कोड मिटाए जा सकते हैं. यह नीति, मैनेजमेंट एपीआई की पहले से उपलब्ध सुविधा की जगह लेती है. ज़्यादा जानकारी के लिए, OAuthV2 की जानकारी मिटाने की नीति देखें. (MGMT-2257)

OAuth v1.0 की जानकारी मिटाने से जुड़ी नई नीति

"OAuth v1.0 की जानकारी मिटाएं" नाम की नई नीति की मदद से, OAuth v1.0 के अनुरोध टोकन, ऐक्सेस टोकन, और पुष्टि करने वाले कोड मिटाए जा सकते हैं. यह नीति, मैनेजमेंट एपीआई के ज़रिए पहले दी जाने वाली सुविधा की जगह लेती है. ज़्यादा जानकारी के लिए, OAuth V1 की जानकारी मिटाने से जुड़ी नीति देखें. (APIRT-1351)

ऐक्सेस कंट्रोल की नीति

ऐक्सेस कंट्रोल की नीति को बेहतर बनाया गया है. इससे आईपी पतों का ज़्यादा बारीकी से आकलन किया जा सकेगा. ऐसा तब होगा, जब आईपी पते X-FORWARDED-FOR एचटीटीपी हेडर में शामिल हों. इससे आईपी पतों को अनुमति वाली सूची में शामिल करने और अनुमति न देने वाली सूची में शामिल करने में मदद मिलेगी.

हेडर पर एक से ज़्यादा आईपी पतों की जांच करने की सुविधा चालू होने पर (इस सुविधा को सेट करने के लिए, सहायता टीम से संपर्क करें: feature.enableMultipleXForwardCheckForACL), नीति में मौजूद नया <ValidateBasedOn> एलिमेंट, हेडर में मौजूद पहले आईपी, आखिरी आईपी या सभी आईपी की जांच करने की सुविधा देता है. ज़्यादा जानकारी के लिए, ऐक्सेस कंट्रोल की नीति देखें.

ऐक्सेस एंटिटी की नीति में नई इकाइयां

ऐक्सेस एंटिटी की नीति, इन नई इकाइयों का ऐक्सेस देती है: consumerkey-scopes, authorizationcode, requesttoken, और verifier. ज़्यादा जानकारी के लिए, ऐक्सेस एंटिटी की नीति देखें.

आंकड़े इकट्ठा करने की नीति: आंकड़ों के नाम को अपने-आप छोटे अक्षरों में बदलना

एपीआई प्रॉक्सी एडिटर (डेवलप पेज > टूल > कस्टम Analytics कलेक्शन) में कस्टम Analytics कलेक्शन बनाते समय, कलेक्टर वैरिएबल (आंकड़ा) "नाम" को छोटे अक्षरों में होना चाहिए. अगर आपने नाम को कैपिटल लेटर में डाला है, तो यह टूल, Statistics Collector नीति में मौजूद आंकड़े के नाम को अपने-आप छोटे अक्षरों में बदल देता है. (MGMT-740)

एपीआई प्रॉक्सी एडिटर में क्लासिक ट्रेस को हटाने की सुविधा

एपीआई प्रॉक्सी एडिटर में, ट्रेस करने की सुविधा का नया वर्शन बीटा वर्शन से सामान्य उपलब्धता में आ गया है. "ट्रेस के क्लासिक वर्शन को ऐक्सेस करें" लिंक से, "क्लासिक ट्रेस" को ऐक्सेस करने की सुविधा अब उपलब्ध नहीं है.

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के सहायता मेन्यू से Apigee कम्यूनिटी को ऐक्सेस करना

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के सहायता मेन्यू से, Apigee कम्यूनिटी को ऐक्सेस किया जा सकता है.

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में गड़बड़ी के मैसेज

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, गड़बड़ी के मैसेज को बेहतर बनाया गया है. इसके बारे में यहां बताया गया है:

  • यह मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) है. इसका इस्तेमाल, यूज़र इंटरफ़ेस (यूआई) पर गड़बड़ी के सभी मैसेज को ग्रुप करने और दिखाने के लिए किया जाता है. ये मैसेज, पूरे लॉगिन सेशन के दौरान दिखते हैं, जब तक कि इन्हें खारिज न कर दिया जाए. इस अपडेट के बाद, गड़बड़ी के मैसेज उस पेज से अपने-आप हट जाते हैं जिस पर वे दिखते हैं. ऐसा तब होता है, जब आप उस पेज से हट जाते हैं. (MGMT-2254)
  • मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) अब डुप्लीकेट गड़बड़ी के मैसेज नहीं छिपाता है. (MGMT-2242)

यूज़र इंटरफ़ेस (यूआई) की परफ़ॉर्मेंस और गड़बड़ी से जुड़े सुधार

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के अलग-अलग हिस्सों में सामान्य सुधार किए गए हैं. इनमें पेज डिसप्ले की परफ़ॉर्मेंस और गड़बड़ी के मैसेज को हटाना शामिल है.

मैनेजमेंट यूज़र इंटरफ़ेस (एडमिन > संगठन के उपयोगकर्ता) में मौजूद, संगठन के उपयोगकर्ता पेज पर अब भूमिका के नाम हाइपरलिंक किए गए हैं. इससे भूमिका के पेजों पर तुरंत जाया जा सकता है. (MGMT-1055)

मैसेज फ़्लो में नए टारगेट वैरिएबल

मैसेज फ़्लो में नए वैरिएबल जोड़े गए हैं. इनसे टारगेट एंडपॉइंट और टारगेट सर्वर के यूआरएल के बारे में ज़्यादा जानकारी मिलती है:

  • TargetEndpoint: request.url, target.basepath.with.query की जगह लेता है.
  • TargetServer: loadbalancing.targetserver को targetserver.name से बदलता है. साथ ही, target.basepath सिर्फ़ तब दिखता है, जब TargetEndpoint के HTTPTargetConnection <LoadBalancer> एलिमेंट में <Path> एलिमेंट का इस्तेमाल किया जाता है.

सर्वर नेम इंडिकेशन (एसएनआई) की सुविधा

Edge, सर्वर नेम इंडिकेशन साउथबाउंड (मैसेज प्रोसेसर से टारगेट एंडपॉइंट तक) के इस्तेमाल का समर्थन करता है. अगर आपको एसएनआई का इस्तेमाल करना है, तो Apigee Edge की सहायता टीम से संपर्क करें.

Java 1.7 ज़रूरी है.

एसएनआई, टीएलएस/एसएसएल का एक्सटेंशन है. इसकी मदद से, एक ही आईपी पते और पोर्ट से कई एचटीटीपीएस टारगेट दिखाए जा सकते हैं. इसके लिए, यह ज़रूरी नहीं है कि सभी टारगेट एक ही सर्टिफ़िकेट का इस्तेमाल करें.

इसके लिए, Edge के हिसाब से कोई कॉन्फ़िगरेशन करने की ज़रूरत नहीं है. अगर आपका एनवायरमेंट, साउथबाउंड एसएनआई के लिए कॉन्फ़िगर किया गया है (एज क्लाउड डिफ़ॉल्ट रूप से होता है), तो Edge इसे सपोर्ट करता है.

Edge, अनुरोध किए गए यूआरएल से होस्टनेम को अपने-आप निकाल लेता है और उसे एसएसएल हैंडशेक के अनुरोध में जोड़ देता है. उदाहरण के लिए, अगर टारगेट होस्ट https://example.com/request/path है, तो Edge, server_name एक्सटेंशन को इस तरह जोड़ता है:

एसएनआई के बारे में ज़्यादा जानकारी के लिए, http://en.wikipedia.org/wiki/Server_Name_Indication पर जाएं.

एसएसएल सर्टिफ़िकेट की जानकारी में "Signature Algorithm"

एसएसएल सर्टिफ़िकेट की जानकारी में, "Signature Algorithm" नाम का एक नया फ़ील्ड जोड़ा गया है. इसे मैनेजमेंट यूज़र इंटरफ़ेस (एडमिन > एसएसएल सर्टिफ़िकेट) और मैनेजमेंट एपीआई (किसी कीस्टोर या ट्रस्टस्टोर से सर्टिफ़िकेट की जानकारी पाएं) में देखा जा सकता है. इस फ़ील्ड में "sha1WithRSAEncryption" या "sha256WithRSAEncryption" दिखता है. यह इस बात पर निर्भर करता है कि सर्टिफ़िकेट जनरेट करने के लिए, किस तरह के हैशिंग एल्गोरिदम का इस्तेमाल किया गया है.

ऐसे एसएसएल सर्टिफ़िकेट दिखाए जा रहे हैं जिनकी समयसीमा खत्म होने वाली है

मैनेजमेंट यूज़र इंटरफ़ेस (एडमिन > एसएसएल सर्टिफ़िकेट) में मौजूद एसएसएल सर्टिफ़िकेट पेज पर यह जानकारी दिखती है कि एसएसएल सर्टिफ़िकेट कब खत्म हो रहे हैं. यह जानकारी 10, 15, 30 या 90 दिनों के हिसाब से दिखती है. यह इस बात पर निर्भर करती है कि आपने 'खत्म होने की नई तारीख' ड्रॉप-डाउन फ़ील्ड में कौनसी तारीख चुनी है.

खतरों से सुरक्षा की सुविधा के कॉन्फ़िगरेशन में गड़बड़ी

डिफ़ॉल्ट रूप से, अगर कोई मैसेज JSON या XML थ्रेट प्रोटेक्शन की नीति का पालन नहीं करता है, तो Edge, एचटीटीपी 500 इंटरनल सर्वर की गड़बड़ी वाला स्टेटस कोड और ExecutionFailed गड़बड़ी दिखाता है. संगठन-लेवल की नई प्रॉपर्टी की मदद से, गड़बड़ी की इस सेटिंग को बदला जा सकता है. org प्रॉपर्टी features.isPolicyHttpStatusEnabled को सही पर सेट करने पर, यह व्यवहार होता है:

  • अनुरोध: अगर किसी अनुरोध फ़्लो में थ्रेट प्रोटेक्शन की नीति जुड़ी है, तो अमान्य मैसेज के लिए 400 स्टेटस कोड दिखेगा. साथ ही, नीति से जुड़ी गड़बड़ी का मैसेज भी दिखेगा.
  • जवाब: किसी भी जवाब फ़्लो से थ्रेट प्रोटेक्शन की नीति जुड़ी होने पर, अमान्य मैसेज अब भी 500 स्टेटस कोड दिखाते हैं. साथ ही, नीति से जुड़ी गड़बड़ी के मैसेज में से कोई एक मैसेज दिखता है. सिर्फ़ ExecutionFailed नहीं दिखता.

क्लाउड ग्राहकों को संगठन की प्रॉपर्टी सेट करने के लिए, Apigee Edge की सहायता टीम से संपर्क करना होगा. यह सुविधा, Edge Private Cloud के ग्राहकों के लिए Private Cloud की अगली तिमाही की रिलीज़ में उपलब्ध होगी.

एंडपॉइंट, प्रॉक्सी, और अन्य इकाइयों के लिए अपडेट किए गए स्कीमा

नीति का उल्लंघन न करने वाली इकाइयों, जैसे कि TargetEndpoint, ProxyEndpoint, APIProxy वगैरह के लिए रेफ़रंस स्कीमा अपडेट कर दी गई हैं. https://github.com/apigee/api-platform-samples/tree/master/schemas पर जाएं. (APIRT-1249)


डेवलपर सेवाएं

इस रिलीज़ में, डेवलपर सेवाओं की ये नई सुविधाएं शामिल हैं.

SmartDocs की सामान्य उपलब्धता

SmartDocs, बीटा वर्शन से सामान्य उपलब्धता में आ रहा है. अपडेट और नई सुविधाओं में ये शामिल हैं:

  • Swagger 2.0 के लिए सहायता. इसमें फ़ाइल या यूआरएल से इंपोर्ट करने की सुविधा भी शामिल है. साथ ही, इसमें कस्टम नाम वाले सुरक्षा ऑब्जेक्ट के लिए सहायता भी शामिल है.
  • SmartDocs जनरेट करने वाले टेंप्लेट के विज़ुअल डिज़ाइन में सुधार किया गया है.
  • Drupal में Content > SmartDocs मेन्यू में जाकर, डेवलपर पोर्टल में इस्तेमाल करने और काम करने की क्षमता को बेहतर बनाया गया है.
  • पुष्टि करने के लिए इस्तेमाल किए जाने वाले "कस्टम टोकन" को अब "एपीआई पासकोड" कहा जाता है.
  • बदलाव के लेवल पर तय किए गए, पुष्टि करने से जुड़े "सुरक्षा" ऑब्जेक्ट.
  • टेम्प्लेट लेवल पर क्लाइंट की पुष्टि करने की सुविधा को कॉन्फ़िगर करना. नए वर्शन में, पहले से कॉन्फ़िगर किए गए SmartDocs के क्लाइंट क्रेडेंशियल अब रीसेट नहीं होते.

सुविधाओं के बारे में ज़्यादा जानकारी के लिए, यह ब्लॉग पोस्ट देखें.

SmartDocs के दस्तावेज़ के लिए, एपीआई के बारे में जानकारी देने के लिए SmartDocs का इस्तेमाल करना लेख पढ़ें.

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में दिखने वाला डेवलपर के ऐप्लिकेशन का नाम

Edge में डेवलपर ऐप्लिकेशन के दो नाम होते हैं. एक इंटरनल नाम होता है, जो बदलता नहीं है. दूसरा डिसप्ले नेम होता है, जिसे बदला जा सकता है. मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में डेवलपर ऐप्लिकेशन पेज (पब्लिश करें > डेवलपर ऐप्लिकेशन > ऐप्लिकेशन का नाम) पर, ऐप्लिकेशन का इंटरनल "नाम" और "डिसप्ले नेम" दिखाया जाता है. इससे समस्या हल करने और एपीआई मैनेज करने के लिए, ऐप्लिकेशन को उनके इंटरनल नाम से आसानी से पहचाना जा सकता है.


Analytics Services

इस रिलीज़ में, Analytics Services की ये नई सुविधाएं शामिल हैं.

डेटा के रखरखाव की अवधि

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

कस्टम रिपोर्ट का क्लासिक वर्शन, मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) से हटाया जा रहा है

कस्टम Analytics रिपोर्ट का क्लासिक वर्शन अब मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में उपलब्ध नहीं है.

डेवलपर से जुड़ाव बढ़ाने वाले विजेट की परफ़ॉर्मेंस

मुख्य आंकड़ों के डैशबोर्ड (डेवलपर के जुड़ाव वाला सेक्शन) पर मौजूद फ़नल विजेट को बेहतर बनाया गया है, ताकि आपको बेहतर परफ़ॉर्मेंस मिल सके.


कमाई करना

इस रिलीज़ में, कमाई करने की ये नई सुविधाएं शामिल हैं.

किराया प्लान के लिए ईमेल सूचनाएं

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

बार-बार लिए जाने वाले शुल्क और एग्रीगेशन के आधार की अवधियों को सिंक करना

किराया प्लान में, दो अलग-अलग समयावधि के लिए किराया तय किया गया था:

  • बार-बार लिए जाने वाले शुल्क की अवधि. इसे रेट प्लान के 'शुल्क' टैब में कॉन्फ़िगर किया जाता है. इससे यह तय होता है कि डेवलपर से बार-बार लिया जाने वाला शुल्क कब लिया जाएगा.
  • एग्रीगेशन की अवधि, वॉल्यूम बैंडेड या बंडल प्लान के लिए रेट कार्ड पर तय की जाती है. इससे यह तय होता है कि डेवलपर के लिए बंडल के इस्तेमाल को कब रीसेट किया गया था.

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

अगर बार-बार लिया जाने वाला कोई शुल्क नहीं है, तो बंडल को रेट कार्ड में तय किए गए एग्रीगेशन के आधार पर रीसेट किया जाता है. उदाहरण के लिए, अगर कोई डेवलपर महीने की 19 तारीख को रेट कार्ड का इस्तेमाल करना शुरू करता है और एग्रीगेशन हर महीने के हिसाब से होता है, तो बंडल के इस्तेमाल की सीमा, 19 तारीख के एक महीने बाद रीसेट हो जाएगी.

'एग्रीगेशन का आधार' सुविधा अब काम नहीं करती. इसे आने वाले समय में, कमाई करने की सुविधा से हटा दिया जाएगा. ज़्यादा जानकारी के लिए, रेट कार्ड प्लान की जानकारी देना लेख पढ़ें.

आय की खास जानकारी वाली रिपोर्ट में कस्टम एट्रिब्यूट

लेन-देन रिकॉर्ड करने की नीतियों की मदद से, लेन-देन से कस्टम एट्रिब्यूट का डेटा कैप्चर किया जा सकता है. अब इस डेटा को, रेवेन्यू की खास जानकारी वाली रिपोर्ट में शामिल किया जा सकता है. अपने संगठन में MINT.SUMMARY_CUSTOM_ATTRIBUTES प्रॉपर्टी जोड़कर, यह बताया जा सकता है कि रिपोर्ट में इस्तेमाल करने के लिए, डेटाबेस टेबल में कौनसे कस्टम एट्रिब्यूट जोड़े गए हैं.

Apigee Edge for Private Cloud के ग्राहक, यहां दिए गए एपीआई कॉल और सिस्टम एडमिन के क्रेडेंशियल का इस्तेमाल करके फ़्लैग सेट कर सकते हैं.

curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isMonetizationEnabled">true</Property>
        <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">[&quot;my_attribute_1&quot;,&quot;my_attribute_2&quot;]</Property>
        <Property name="features.topLevelDevelopersAreCompanies">false</Property>
    </Properties>
</Organization>"

ध्यान दें कि एपीआई कॉल में कस्टम एट्रिब्यूट की ऐरे को यूआरएल के हिसाब से कोड में बदला जाता है.


SmartDocs को अपग्रेड करने की प्रोसेस

अगर आपने बीटा वर्शन के दौरान SmartDocs का इस्तेमाल किया है, तो सामान्य तौर पर उपलब्ध वर्शन में नई सुविधाओं और क्षमताओं का इस्तेमाल करने के लिए, आपको डेवलपर पोर्टल में SmartDocs को अपग्रेड करना होगा.

आपके डेवलपर पोर्टल में पहले से पब्लिश किए गए SmartDocs पेज काम करते रहेंगे. हालांकि, मौजूदा या नए पेजों में कोई भी बदलाव करने या उन्हें पब्लिश करने से पहले, आपको अपडेट करने की प्रोसेस पूरी करनी होगी.

ध्यान रखें कि डेवलपर पोर्टल में SmartDocs को रेंडर और पब्लिश किया जा सकता है. हालांकि, SmartDocs को Apigee के Edge API Management Services में मौजूद एपीआई मॉडल से जनरेट किया जाता है. Edge में एपीआई मॉडल में किए गए सभी बदलाव, आपके सभी Pantheon एनवायरमेंट में एक जैसे होंगे. यह ठीक उसी तरह काम करता है जैसे डेवलपर, Pantheon एनवायरमेंट में काम करते हैं.

SmartDocs के बीटा वर्शन से सामान्य उपलब्धता वाले वर्शन पर अपग्रेड करने के लिए

  1. Pantheon पर, अपने dev या test एनवायरमेंट में 15.05.27 रिलीज़ को अपडेट करें और उसकी जांच करें.
  2. जिस एपीआई मॉडल का इस्तेमाल किया जा रहा है उसे बदलने के लिए, एक नया मॉडल बनाएं.
    • अगर आपने Swagger या WADL दस्तावेज़ इंपोर्ट किए हैं, तो उन्हें नए वर्शन में फिर से इंपोर्ट करें.
    • अगर SmartDocs मॉड्यूल के ज़रिए एपीआई मॉडल को मैनेज किया जा रहा है, तो उसे SmartDocs JSON के तौर पर एक्सपोर्ट करें. इसके बाद, फ़ाइल अटैच करके उसे अपने नए मॉडल में इंपोर्ट करें.
  3. अपने मॉडल के वर्शन की सुरक्षा प्रॉपर्टी सेट करें. कॉन्टेंट > SmartDocs > मॉडल पेज पर, सुरक्षा सेटिंग चुनें.
  4. मॉडल सेटिंग पेज (कॉन्टेंट > SmartDocs) में जाकर, पहले से कॉन्फ़िगर किए गए किसी भी पुष्टि करने वाले तरीके की जांच करें. इसके लिए, कार्रवाइयां कॉलम में मौजूद सेटिंग पर क्लिक करें.
  5. सीएसएस और JS ऐसेट के v6 का इस्तेमाल करने के लिए, किसी भी कस्टम टेंप्लेट को अपडेट करें. साथ ही, authSchemes और apiSchema जैसे किसी भी नए ऑब्जेक्ट के नाम को दिखाने के लिए बदलाव करें. SmartDocs टेंप्लेट अपडेट करने के बारे में जानकारी पाने के लिए, एपीआई के बारे में जानकारी देने के लिए SmartDocs का इस्तेमाल करना लेख पढ़ें.
  6. अपने मॉडल के बदले गए वर्शन को फिर से रेंडर करें और पब्लिश करें.
  7. नए दस्तावेज़ की पुष्टि करने के बाद, अपने प्रोडक्शन पोर्टल को 15.05.27 रिलीज़ पर अपडेट करें.

अगर आप Edge के एंटरप्राइज़ ग्राहक हैं और आपको अपग्रेड करने की प्रोसेस के बारे में कोई सवाल पूछना है या कोई समस्या है, तो कृपया marsh@apigee.com और cnovak@apigee.com पर ईमेल भेजें. अगर आप Edge के एंटरप्राइज़ ग्राहक नहीं हैं, तो कृपया Apigee Community का इस्तेमाल करें, ताकि आपको सबसे अच्छा जवाब मिल सके.


आने वाले समय में सुविधाओं में होने वाले बदलाव और सुधार

इस सेक्शन में, आने वाले समय में सुविधाओं में होने वाले बदलावों और सुधारों की झलक दिखाई गई है:

जवाब की कैश मेमोरी से जुड़ी नीति के व्यवहार में बदलाव

आने वाली रिलीज़ में, Response Cache नीति के <ExcludeErrorResponse> एलिमेंट का डिफ़ॉल्ट व्यवहार बदल जाएगा. हालांकि, यह रिलीज़ कब होगी, यह अभी तय नहीं किया गया है.

मौजूदा व्यवहार: रिस्पॉन्स कैश मेमोरी की नीति में मौजूद <ExcludeErrorResponse> एलिमेंट, डिफ़ॉल्ट रूप से 'गलत है' पर सेट होता है. इसका मतलब है कि डिफ़ॉल्ट रूप से, Response Cache नीति के तहत, किसी भी एचटीटीपी स्टेटस कोड (इसमें 3xx भी शामिल है) वाले जवाबों को कैश मेमोरी में सेव किया जाता है.

आने वाले समय में: Response Cache नीति में मौजूद <ExcludeErrorResponse> एलिमेंट की वैल्यू डिफ़ॉल्ट रूप से सही पर सेट होगी. इसका मतलब है कि डिफ़ॉल्ट रूप से, सिर्फ़ 200 से 205 तक के एचटीटीपी स्टेटस कोड वाले जवाबों को कैश मेमोरी में सेव किया जाएगा. इस डिफ़ॉल्ट सेटिंग को बदलने और सभी स्टेटस कोड के लिए जवाबों को कैश मेमोरी में सेव करने के लिए, आपको <ExcludeErrorResponse> एलिमेंट को साफ़ तौर पर true पर सेट करना होगा.

मौजूदा तरीका: Private Cloud 4.15.07.00 और इससे पुराने वर्शन के लिए, अगर आपको सिर्फ़ 200 से 205 स्टेटस कोड वाले जवाबों को कैश मेमोरी में सेव करना है, तो आपको <ExcludeErrorResponse> एलिमेंट को 'सही' के तौर पर सेट करना होगा.


गड़बड़ियां ठीक की गईं

इस रिलीज़ में इन बग को ठीक किया गया है.

समस्या आईडी ब्यौरा
OPDK-1521 पासवर्ड को एन्क्रिप्ट (सुरक्षित) करने से जुड़ी समस्या
OPDK-1201 यूज़र इंटरफ़ेस (यूआई) का डेटा वापस नहीं लाया जा सका
OPDK-1112 Apigee के एडमिन उपयोगकर्ता पर, LDAP की कस्टम पासवर्ड नीति लागू नहीं हो रही है
OPDK-1097 OPDK को अपग्रेड करने के दौरान कीस्पेस से जुड़ी समस्या
OPDK-1068 इंस्टॉल करने के दौरान एडमिन का पासवर्ड गलत होने पर उसे बदला जा सकता है
OPDK-1053 Zookeeper को रूट के तौर पर चलाया जा रहा है
OPDK-967 set-autostart.sh का इस्तेमाल करके OpenLDAP को अपने-आप शुरू होने के लिए सेट करने पर, all-status.sh इसे बंद के तौर पर रिपोर्ट करता है
OPDK-905 Smartdocs prod already registered in group axgroup001
OPDK-899 शामिल होने के दौरान हुई गड़बड़ी
OPDK-847 ऑनबोर्डिंग के दौरान बनाए गए उपयोगकर्ता को पासवर्ड रीसेट करने का ईमेल नहीं मिलता
OPDK-817 init.d स्क्रिप्ट में गड़बड़ी दिखती है
OPDK-815 ax-purge.sh स्क्रिप्ट को सैंपलिंग टेबल मिटाने की ज़रूरत होती है
MGMT-2246 मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, 'कस्टम रिपोर्ट पेज बनाएं' विकल्प सही तरीके से नहीं दिख रहा है
MGMT-2235 जिन एसएसएल सर्टिफ़िकेट की समयसीमा खत्म होने वाली है उनके लिए, समयसीमा खत्म होने का अनुमानित समय गलत तरीके से राउंड अप किया जा सकता है
जिन एसएसएल सर्टिफ़िकेट की समयसीमा खत्म होने वाली है उनके लिए, समयसीमा खत्म होने की तारीख का अनुमानित समय हमेशा दिनों में दिखाया जाता है. अगर सर्टिफ़िकेट की समयसीमा 90 दिनों या उससे कम में खत्म होने वाली है, तो इसे महीनों में राउंड अप नहीं किया जाता.
MGMT-2193 एपीआई में बदलाव करते समय लोड होने की प्रोग्रेस दिखाने वाला स्पिनर
MGMT-2173 Trace UI में, कानूनी तौर पर मान्य यूआरएल इस्तेमाल करने की अनुमति नहीं है
Trace UI की मदद से, अब ऐसे अनुरोध भेजे जा सकते हैं जिनमें क्वेरी पैरामीटर की ऐसी वैल्यू शामिल होती हैं जिनमें नेस्ट किए गए क्वेरी पैरामीटर होते हैं.
MGMT-2162 JavaScript कंपाइल करने से जुड़ी समस्या
MGMT-2124 यूज़र इंटरफ़ेस (यूआई) में अनुमतियां सेव करने पर, खरीदार की भूमिका की अनुमतियां रीसेट हो जाती हैं
MGMT-2114 MessageLogging नीति में अमान्य Syslog आईपी होने पर, डिप्लॉयमेंट के दौरान गड़बड़ी का सही मैसेज दिखना चाहिए
MGMT-2067 ट्रेस: अगर एपीआई प्रॉक्सी के वर्शन को दो एनवायरमेंट में डिप्लॉय किया गया है, तो वर्शन और एनवायरमेंट चुनने की सुविधा ठीक से काम नहीं करती
MGMT-2061 पासवर्ड भूल गए विकल्प से सिर्फ़ रजिस्टर किए गए उपयोगकर्ताओं को ईमेल भेजा जाना चाहिए
मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) के लॉगिन पेज पर मौजूद "पासवर्ड भूल गए?" लिंक से सिर्फ़ रजिस्टर किए गए Apigee उपयोगकर्ताओं को ईमेल भेजे जाते हैं.
MGMT-2048 उपयोगकर्ता की पसंद के मुताबिक भूमिका वाले उपयोगकर्ता के पास, सिर्फ़ एक एनवायरमेंट में डिप्लॉयमेंट की अनुमतियां होती हैं. हालांकि, वह अन्य एनवायरमेंट में भी डिप्लॉय कर सकता है
MGMT-2041 डिफ़ॉल्ट अटैचमेंट टेंप्लेट से FaultRules एलिमेंट हटा दिया गया है
FaultRules एलिमेंट का इस्तेमाल नीतियों या एपीआई प्रॉक्सी के चरणों में नहीं किया जाता है. इसलिए, अब एपीआई प्रॉक्सी बनाते समय या नीतियां जोड़ते समय, यह अपने-आप नहीं जुड़ता है.
MGMT-2034 WSDL फ़ेच करने में गड़बड़ी हुई: "WSDL फ़ेच करने में गड़बड़ी हुई: WSDL प्रोसेस करने में गड़बड़ी हुई."
MGMT-1986 डेवलपर को जोड़ते समय यूज़र इंटरफ़ेस से जुड़ी गड़बड़ी
MGMT-1983 OAuth 2.0 ऑथराइज़ेशन कोड पाने के लिए किए गए एपीआई कॉल का स्टेटस गलत है
MGMT-1962 मज़बूत पासवर्ड का इस्तेमाल करके, मैनेजमेंट यूज़र इंटरफ़ेस में लॉग इन करने से जुड़ी गड़बड़ी
अब कुछ खास वर्णों, जैसे कि प्रतिशत के निशान का इस्तेमाल करके यूज़र इंटरफ़ेस में लॉग इन करने पर गड़बड़ी नहीं होती.
MGMT-1947 मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में भूमिकाओं को समझने में मुश्किल होना
अगर किसी उपयोगकर्ता के पास लेन-देन रिकॉर्ड करने की नीति बनाने या उसमें बदलाव करने की अनुमति नहीं है, तो अब यूज़र इंटरफ़ेस (यूआई) में लेन-देन रिकॉर्ड करने की नीति बनाने और उसमें बदलाव करने वाले बटन बंद हो जाएंगे.
MGMT-1899 प्रॉडक्ट की सेटिंग सेव करने के बाद, संसाधन के पाथ मिटा दिए जाते हैं
एपीआई प्रॉडक्ट में बदलाव करते समय, प्रॉडक्ट के संसाधन के पाथ मिट सकते हैं. ऐसा तब होता है, जब उपयोगकर्ता 'सेव करें' बटन पर दो बार क्लिक करता है. इस समस्या को हल कर दिया गया है.
MGMT-1894 डेवलपर कॉलम के लिए, डेवलपर ऐप्लिकेशन पेज कभी लोड नहीं होता
MGMT-1882 WSDL से बनाई गई नई एपीआई प्रॉक्सी में सिर्फ़ आखिरी पैरामीटर की जानकारी दिखती है
MGMT-1878 अगर किसी एनवायरमेंट में कई वर्शन डिप्लॉय किए जाते हैं, तो Trace उनमें से सिर्फ़ एक को दिखाता है
MGMT-1872 कस्टम रिपोर्ट डाउनलोड नहीं की जा सकती
MGMT-1863 मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में Node.js लॉग नहीं दिख रहे हैं
MGMT-1843 एपीआई प्रॉक्सी नहीं खुल रही है
MGMT-1833 सिस्टम एडमिन के पास, OPDK के यूज़र इंटरफ़ेस (यूआई) में पासवर्ड बदलने का विकल्प नहीं होना चाहिए
MGMT-1825 क्रॉस-साइट स्क्रिप्टिंग (XSS) से जुड़ी गड़बड़ियां
MGMT-1824 .xml एक्सटेंशन वाली WSDL फ़ाइल इंपोर्ट करते समय, WSDL फ़ेच करने से जुड़ी गड़बड़ी
MGMT-1812 इंपोर्ट के दौरान TargetEndpoint की पुष्टि करने की सुविधा जोड़ी गई
ProxyEndpoint की तरह ही, API प्रॉक्सी इंपोर्ट के दौरान TargetEndpoint की पुष्टि की जाएगी. इससे यह पता चलेगा कि सही स्कीमा और शर्तों में इस्तेमाल किए गए एक्सप्रेशन का इस्तेमाल किया गया है या नहीं.
MGMT-1804 Node.js API, कुछ मामलों में अमान्य JSON भेज रहा है
अगर JSON डेटा में अमान्य वर्ण होते थे, तो Node.js लॉग स्क्रीन पर बिना फ़ॉर्मैट वाले लॉग दिखते थे. इस रिलीज़ में इस समस्या को ठीक कर दिया गया है. अब यूज़र इंटरफ़ेस (यूआई) में, node.js के लॉग सही फ़ॉर्मैट में दिखते हैं.
MGMT-1802 पासवर्ड रीसेट करने का यूआरएल #118
अगर मैनेजमेंट यूआई, एसएसएल टर्मिनेटिंग सर्वर के पीछे है, तो मैनेजमेंट यूआई अब पासवर्ड रीसेट करने का ईमेल सही तरीके से जनरेट करता है. इसमें http यूआरएल के बजाय https यूआरएल का लिंक होता है.
MGMT-1799 Trace में अनुरोध भेजने के दौरान यूज़र इंटरफ़ेस (यूआई) की सुरक्षा से जुड़ी कमज़ोरी
MGMT-1777 .acn टीएलडी वाले ईमेल पते से उपयोगकर्ता को नहीं जोड़ा जा सकता
MGMT-1735 ब्रैंडिंग "W को फ़ेच करते समय गड़बड़ी हुई"
हमने Edge OPDK में कस्टम ब्रैंडिंग की सुविधा तुरंत हटा दी है. हम जानते हैं कि इस सुविधा को बंद करने से, इसका इस्तेमाल करने वाले कुछ ग्राहकों को निराशा हो सकती है. हालांकि, यह ऐसी सुविधा नहीं है जिससे एपीआई मैनेजमेंट के मामले में Edge की क्षमताओं में सीधे तौर पर सुधार होता हो.
MGMT-1569 मौजूदा एपीआई प्रॉडक्ट से एपीआई प्रॉक्सी अटैच करने में समस्या
मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, एपीआई प्रॉडक्ट से एपीआई प्रॉक्सी अटैच करने की समस्या ठीक कर दी गई है. यह समस्या तब आती थी, जब एपीआई प्रॉक्सी में "/" पाथ के लिए कोई संसाधन होता था.
MGMT-1563 अगर Trace में कोई गड़बड़ी होती है, तो 'भेजें' बटन बंद रहता है
MGMT-1362 अगर ईमेल पते में '_' शामिल है, तो 'पासवर्ड भूल गए' ईमेल काम नहीं करता
OPDK में, अंडरस्कोर वाले ईमेल पतों के लिए पासवर्ड रीसेट करने की समस्या ठीक की गई.
MGMT-1345 एक से ज़्यादा नेमस्पेस वाले WSDL को इंपोर्ट करने पर, Build SOAP Step गलत तरीके से बनता है
MGMT-1193 प्रॉक्सी को नए वर्शन के तौर पर सेव करने पर, रूट के नियम में अचानक बदलाव हो जाता है
MGMT-1061 SmartDocs: Description of body type parameter in Swagger definition not shown in doc UI
MGMT-800 'default' नाम का संसाधन बनाने से यूज़र इंटरफ़ेस (यूआई) काम नहीं करता
MGMT-787 यूज़र इंटरफ़ेस (यूआई) से जुड़ी सूचना इस्तेमाल करने में समस्या
मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में, + एपीआई प्रॉक्सी पर क्लिक करने पर, जब नया एपीआई प्रॉक्सी डायलॉग दिखता है, तब डायलॉग को खारिज करने के लिए Esc दबाया जा सकता है.
MGMT-619 एपीआई प्रॉक्सी के यूज़र इंटरफ़ेस (यूआई) वाले पेज में पेज नंबरिंग की सुविधा चालू करना
MGMT-602 एपीआई प्रॉक्सी का डेवलप व्यू: जब एंडपॉइंट में PreFlow/PostFlow की वजह से गड़बड़ी होती है, तब Response Cache नीति जोड़ें
MGMT-460 नीति का नाम बदलने पर, गड़बड़ी होती है. साथ ही, डुप्लीकेट नीति बनती है जिसे हटाया नहीं जा सकता
DEVRT-1644 नाम के हिसाब से सूचनाएं ढूंढने की सुविधा की वजह से, गलत ईमेल भेजा जा रहा है
DEVRT-1583 मौजूदा प्लान के लिए, कमाई करने से जुड़े यूज़र इंटरफ़ेस (यूआई) में "आने वाले समय में लागू होने वाला" बैज दिखता है
DEVRT-1546 प्लान की सीमाएं काम नहीं कर रही हैं
DEVRT-1511 मौजूदा डेवलपर के लिए mint.resourceDoesNotExist गड़बड़ी
CORERT-639 TCPSysLogSocket must be async
CORERT-613 "unrecognized_name" की वजह से एसएसएल हैंडशेक नहीं हो सका
AXAPP-1728 Analytics में कमाई करने से जुड़े वैरिएबल को अनदेखा करना
AXAPP-1708 Analytics API, एक ही आंकड़े के लिए अलग-अलग संख्याएं दिखाता है. यह इस बात पर निर्भर करता है कि मैंने क्वेरी कैसे की है
AXAPP-1707 पॉडकास्ट के मुफ़्त वर्शन के आंकड़ों की परफ़ॉर्मेंस को बेहतर बनाना
AXAPP-1690 कस्टम रिपोर्ट पर"अमान्य एपीआई गड़बड़ी"
AXAPP-1533 Analytics के जियोमैप में, 'एपीआई कॉल अमान्य है' गड़बड़ी दिखती है
AXAPP-1493 कैश मेमोरी की परफ़ॉर्मेंस के आंकड़े गलत हैं
APIRT-1436 बिना हैश किए गए टोकन को हैश करने के लिए टूल/स्क्रिप्ट बनाना
APIRT-1425 JavaCallout नीति में, continueOnError ऐट्रिब्यूट को "true" पर सेट करने से कोई असर नहीं पड़ता
APIRT-1346 OAuth2.0 - hash.oauth.tokens.enabled की वैल्यू सही होने पर, ऐक्सेस टोकन के जवाब में हैश की गई वैल्यू मिलती है
APIRT-1206 503 और ज़्यादातर 504 के लिए, फ़ैक्ट टेबल में target_ip रिकॉर्ड नहीं किया जाता
APIRT-1170 संसाधन फ़ाइल मौजूद न होने की वजह से, MP एनवायरमेंट लोड नहीं कर सका
APIRT-1148 Node.js टारगेट के लिए, ResponseFlow में {message.version} वैरिएबल का GET, NPE दिखाता है
APIRT-1054 डिफ़ॉल्ट के अलावा किसी दूसरी डायरेक्ट्री में लॉग करने की कोशिश करते समय, मैसेज लॉगिंग की सुविधा काम नहीं करती
APIRT-387 MP पर OrganizationService को 'others' फ़्लेवर में चलाएं
APIRT-67 OAuth GenerateAccessToken नीति, oauthV2.failed वैरिएबल को सही तरीके से सेट नहीं करती है
APIRT-52 कस्टम रिपोर्ट: कई एपीआई के लिए रिस्पॉन्स स्टेटस कोड शून्य है

ज्ञात समस्याएं

इस रिलीज़ में ये समस्याएं हैं.

समस्या आईडी ब्यौरा
OPDK-1586

अगर IPV6 की सुविधा चालू नहीं है, तो API BaaS पोर्टल शुरू नहीं हो पाता
API BaaS पोर्टल को चालू करने के लिए, /<install-dir>/apigee4/conf/nginx/conf.d/loadbalancer.conf में मौजूद IPV6 लाइन को टिप्पणी के तौर पर मार्क करें या IPV6 की सुविधा चालू करें:

# listen [::]:8080;

OPDK-1785

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

इस समस्या को हल करने के लिए, Monetization इंस्टॉल करने से पहले, apigee-env.sh फ़ाइल में कमाई करने की सुविधा का सही वर्शन सेट करें. Edge 4.15.07 पर अपग्रेड करने के बाद, कमाई करने की सुविधा वाला वर्शन 4.15.07 पाने के लिए, यह कमांड चलाएं:
> source /{install-dir}/apigee4/bin/apigee-env.sh

> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`
डिफ़ॉल्ट रूप से, install-dir /opt होता है.
ऊपर दी गई VER की वैल्यू को apigee-env.sh में सेट करना होगा:
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh
अगर आपने ऊपर दिए गए चरणों को पूरा किए बिना Monetization को इंस्टॉल करने की कोशिश की है, तो इंस्टॉल नहीं हो पाएगा. साथ ही, शेयर डायरेक्ट्री में कोई डेड सिमलंक मौजूद हो सकता है. आपको उस सिमलंक को हटाना होगा:
> rm /install-dir/apigee4/share/monetization
सिमलिंक हटाने के बाद, कमाई करने की सुविधा का वर्शन सेट करने के लिए, ऊपर दिया गया तरीका अपनाएं. इसके बाद, कमाई करने की सुविधा को फिर से इंस्टॉल करने की कोशिश करें.
OPDK-1857 bin/qpid-stat.sh और bin/qpid-config.sh में Python 2.6 वर्शन को हार्ड कोड किया गया है

CentOS और RedHat 7.0 पर, bin/qpid-stat.sh और bin/qpid-config.sh में मौजूद कई स्क्रिप्ट, Python के वर्शन 2.6 का इस्तेमाल करने के लिए हार्ड कोड की गई हैं.

इस समस्या को हल करने के लिए, apigee4/bin डायरेक्ट्री में मौजूद qpid-stat.sh और qpid-config.sh में, PYTHONPATH को एक्सपोर्ट करने वाली लाइन को बदलें.

export PYTHONPATH="${QPID_DIR}/lib/python2.6/site-packages"

अपने सिस्टम पर Python का वर्शन पता करने के लिए, /opt/apigee4/share/apache-qpid/lib डायरेक्ट्री में Python का वर्शन देखें. इस डायरेक्ट्री का नाम python2.7 है.

इसके बाद, आपको qpid-stat.sh और qpid-config.sh में PYTHONPATH सेटिंग को सही पाथ के साथ अपडेट करना होगा. उदाहरण के लिए:

export PYTHONPATH="${QPID_DIR}/lib/python2.7/site-packages"

DEVRT-1574 एक से ज़्यादा ऐक्टिव रेट प्लान वाले डेवलपर के लिए, बैलेंस और इस्तेमाल में अंतर होना
अगर कमाई करने के लिए, डेवलपर एक से ज़्यादा ऐसे रेट प्लान इस्तेमाल कर रहा है जिनमें एपीआई कॉल के हिसाब से शुल्क लगता है, तो कभी-कभी बैलेंस और इस्तेमाल में अंतर हो सकता है.
APIBAAS-1647 सिस्टम एडमिन के तौर पर लॉगिन करने के बाद, BaaS यूज़र इंटरफ़ेस (यूआई) पर 'भूमिकाएं पाने में गड़बड़ी हुई' मैसेज दिखता है
यह गड़बड़ी का मैसेज, सिस्टम एडमिन को सिस्टम में पहली बार लॉगिन करने पर दिखता है. ऐसा तब होता है, जब सिस्टम को 4.15.01 से 4.15.07 पर अपग्रेड किया गया हो. इस मैसेज को अनदेखा किया जा सकता है.
DEVRT-1834 कमाई करने की सुविधा को 4.15.07 पर अपग्रेड करना
apigee-upgrade.sh स्क्रिप्ट, आखिर में यह मैसेज दिखाती है. इसमें आपको दूसरी स्क्रिप्ट को लागू करने के लिए कहा जाता है:
**************************************
In order to complete the monetization upgrade please run:
sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/
365-create-notification-condition.sh
**************************************

इस मैसेज को अनदेखा किया जा सकता है. इस स्क्रिप्ट की ज़रूरत नहीं है और इसे लागू नहीं किया जा सकता.

DEVRT-1951 Monetization fresh installation missing notification configurations
Apigee Edge for Private Cloud के वर्शन 4.15.07.00 के नए इंस्टॉलेशन पर, कमाई करने से जुड़ी सूचनाओं के लिए ये कॉन्फ़िगरेशन मौजूद नहीं हैं. ये सूचनाएं, मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) में एडमिन > सूचनाएं पेज पर मौजूद सूचनाओं के टाइप से मेल खाती हैं.
mint.scheduler.${ORG_ID}.adhocnotify@@@management
mint.scheduler.${ORG_ID}.expiringrateplannotify@@@management
mint.scheduler.${ORG_ID}.newpkgnotify@@@management
mint.scheduler.${ORG_ID}.newproductnotify@@@management
mint.scheduler.${ORG_ID}.newrateplannotify@@@management
mint.scheduler.${ORG_ID}.tncacceptancenotify@@@management
इस समस्या को हल करने के लिए, यह तरीका अपनाएं. आपको अपने Cassandra इंस्टेंस के आईपी पते की ज़रूरत होगी. इसे ढूंढने के लिए, <installation-root>/apigee4/conf/cassandra/cassandra.yaml या <installation-root>/apigee4/conf/cassandra/cassandra-topology.properties में देखें.
  1. ये कमांड चलाएं. {ORG_ID} वैरिएबल को वैसे ही रहने दें, लेकिन <org_name>, <installation-root>, और <cassandra_ip_address> को बदलें.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/ui/mint-org-specific-ui-schedulers.txt > /tmp/mint-org-specific-ui-schedulers.txt
    
    <installation-root>/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-ui-schedulers.txt
  2. मैनेजमेंट सर्वर को रीस्टार्ट करें.
DEVRT-1952 कमाई करने की सुविधा को 4.14.07.00 से अपग्रेड करने पर, सूचना कॉन्फ़िगरेशन मौजूद नहीं है
Apigee Edge for Private Cloud को वर्शन 4.14.07.00 से 4.15.07.00 पर अपग्रेड करने पर, कमाई करने से जुड़ी सूचनाओं के लिए ये कॉन्फ़िगरेशन मौजूद नहीं हैं. इस वजह से, कमाई करने से जुड़ी रिपोर्ट सही तरीके से काम नहीं करती हैं.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
इस समस्या को हल करने के लिए, यह तरीका अपनाएं. आपको अपने Cassandra इंस्टेंस के आईपी पते की ज़रूरत होगी. इसे ढूंढने के लिए, <installation-root>/apigee4/conf/cassandra/cassandra.yaml या <installation-root>/apigee4/conf/cassandra/cassandra-topology.properties में देखें.
  1. ये कमांड चलाएं. {ORG_ID} वैरिएबल को वैसे ही रहने दें, लेकिन <org_name>, <installation-root>, और <cassandra_ip_address> को बदलें.
    sed -e "s/\${ORG_ID}/<org_name>/g" <installation-root>/apigee4/share/monetization/schema/cassandra/org/system/mint-org-specific-system-schedulers.txt > /tmp/mint-org-specific-system-schedulers.txt
    
    <installation-root>/apigee4/share/apache-cassandra/bin/cassandra-cli -h <cassandra_ip_address> -f /tmp/mint-org-specific-system-schedulers.txt
  2. मैनेजमेंट सर्वर को रीस्टार्ट करें.
OPDK-1878 एक से ज़्यादा डेटा सेंटर में इंस्टॉल करते समय, पॉड का नाम सेट नहीं किया जा सकता
Edge को इंस्टॉल करने से जुड़ी गाइड में बताया गया है कि एक से ज़्यादा डेटा सेंटर में इंस्टॉल करते समय, साइलेंट इंस्टॉल फ़ाइलों में पॉड के नाम "gateway-1" और "gateway-2" के तौर पर सेट करें. हालांकि, पॉड का नाम बदलने से, राउटर और मैसेज प्रोसेसर सही तरीके से रजिस्टर नहीं हो पाते और उन्हें ऐक्सेस नहीं किया जा सकता. इस समस्या की वजह से, setup-org.sh स्क्रिप्ट, उपलब्ध मैसेज प्रोसेसर का पता नहीं लगा पाती.

इस समस्या को हल करने के लिए, दोनों डेटा सेंटर के लिए साइलेंट इंस्टॉल फ़ाइल में, MP_POD प्रॉपर्टी का इस्तेमाल करके पॉड का नाम "gateway" सेट करें.
OPDK-1886

नोड, 192.168.x.y जैसे लोकल आईपी पतों को ऐक्सेस नहीं कर सकता
लोकल आईपी पते को ऐक्सेस करने की कोशिश करते समय, आपको "connect EINVAL" गड़बड़ी का मैसेज दिखता है.
इस समस्या को हल करने के लिए, Message Processor नोड पर मौजूद /<install_dir>/apigee4/conf/apigee/message-processor/nodejs.properties फ़ाइल में बदलाव करें. इसके लिए, इस लाइन को टिप्पणी के तौर पर मार्क करें:

connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32

इसके बाद, Message Processor नोड को रीस्टार्ट करें:

<install_dir>/apigge4/bin/apigee-service message-processor restart 
OPDK-1958 अपग्रेड करते समय, सभी नोड को मैनेजमेंट सर्वर पर पोर्ट 8080 को ऐक्सेस करने की ज़रूरत होगी
रनटाइम के दौरान, इन कॉम्पोनेंट को मैनेजमेंट सर्वर पर पोर्ट 8080 को ऐक्सेस करने की ज़रूरत होती है: राउटर, मैसेज प्रोसेसर, यूज़र इंटरफ़ेस (यूआई), Postgres, और Qpid. हालांकि, अपग्रेड करते समय सभी नोड को मैनेजमेंट सर्वर पर पोर्ट 8080 का ऐक्सेस चाहिए होगा. इसमें Cassandra और Zookeeper नोड भी शामिल हैं.
OPDK-1962 अपग्रेड करने के बाद, Edge API के लिए SSL को फिर से कॉन्फ़िगर करना ज़रूरी है
अगर आपने Edge API को SSL का इस्तेमाल करने के लिए कॉन्फ़िगर किया है, तो 4.15.07.00 वर्शन पर अपग्रेड करने से पहले, आपको अपग्रेड करने के बाद SSL को फिर से कॉन्फ़िगर करना होगा. Edge API के लिए SSL कॉन्फ़िगर करने का तरीका जानने के लिए, Edge की ऑपरेशंस गाइड देखें.