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

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

हमने मंगलवार, 31 मई, 2016 को Private Cloud के लिए Apigee Edge का नया वर्शन रिलीज़ किया है.

प्राइवेट क्लाउड फ़ीचर रिलीज़ (4.16.01) के पुराने वर्शन के बाद से, ये रिलीज़ हो चुकी हैं और इन्हें इस सुविधा रिलीज़ में शामिल किया गया है:

यह पता करने का तरीका जानने के लिए कि आपके Edge for Private Cloud के वर्शन में कोई खास क्लाउड रिलीज़ शामिल है या नहीं, रिलीज़ के नंबर बनाने के बारे में जानकारी देखें.

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

इस रिलीज़ में नई सुविधाएं और सुधार शामिल किए गए हैं. इन सुधारों के अलावा, इस रिलीज़ में उपयोगिता, परफ़ॉर्मेंस, सुरक्षा, और ऐप्लिकेशन को क्रैश या फ़्रीज़ होने से बचाने के लिए कई तरह के सुधार किए गए हैं.

ज़्यादा जानकारी और निर्देशों के लिए, Edge for Private Cloud दस्तावेज़ देखें.

इंस्टॉलेशन और ऑपरेशंस गाइड को ऑनलाइन ले जाया गया है

अब वर्शन 4.18.01 पर, Private Cloud के इंस्टॉल और ऑपरेशन के लिए एज गाइड को ऐक्सेस किया जा सकता है.

सॉफ़्टवेयर अपडेट

रिलीज़ में ये सॉफ़्टवेयर अपडेट शामिल हैं:

  • Java JDK 1.8 - Java की नई सुविधाओं का फ़ायदा लेने के लिए, यह रिलीज़ Java 1.8 के साथ काम करता है. आपके एनवायरमेंट में, Oracle JDK 1.8 या OpenJDK 8 होना ज़रूरी है.
    Java 8 को अपडेट करने के तहत, कुछ TLS साइफ़र, Oracle JDK 1.8 में उपलब्ध नहीं हैं. पूरी सूची के लिए, "डिफ़ॉल्ट बंद किए गए साइफ़र सुइट" http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html सेक्शन देखें.
  • Cassandra 2.1.13 - Cassandra 2.0.15 से अपडेट किया गया.

इंस्टॉल करना, अपग्रेड करना, रोलबैक करना

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

  • 4.16.01 से अपडेट करने की नई प्रोसेस - यह रिलीज़ आपके इंस्टॉलेशन को 4.16.01 से 4.16.05 तक अपडेट करने के लिए, apigee-migrate यूटिलिटी को update.sh यूटिलिटी से बदल देती है. Apigee Edge 4.16.01 को 4.16.05 से अपडेट करें देखें.
  • बूटस्ट्रैप
    • bootstrap.sh (4.16.01 वर्शन) अब 4.16.05 में bootstrap_4.16.05.sh है.
    • अब आपको bootstrap_4.16.05.sh डाउनलोड करने के लिए, uname:pword तय करने की ज़रूरत नहीं है.
  • रोलबैक - किसी अपडेट को 4.16.05 पर रोलबैक करने के लिए, आपको कॉम्पोनेंट के 4.16.05 वर्शन को अनइंस्टॉल करके, पिछले वर्शन को फिर से इंस्टॉल करना होता है. पिछली rollback.sh यूटिलिटी हटा दी गई है. 4.16.05 रोलबैक प्रोसेस देखें.
  • setup.sh और update.sh, लॉग फ़ाइल को /tmp पर लिख सकते हैं - डिफ़ॉल्ट रूप से, setup.sh और update.sh उपयोगिताएं, लॉग फ़ाइल की जानकारी /opt/apigee/var/log/apigee-setup में लिख सकती हैं. अगर यूटिलिटी चलाने वाले उपयोगकर्ता के पास उस डायरेक्ट्री का ऐक्सेस नहीं है, तो वह लॉग को /tmp डायरेक्ट्री में लिख देता है. अगर उपयोगकर्ता के पास /tmp का ऐक्सेस नहीं है, तो यह सुविधा काम नहीं करती.
  • API BaaS को अपडेट करने की प्रोसेस - 4.16.01 की रिलीज़ में, आपको इसे माइग्रेट करने के लिए API BaaS को फिर से इंस्टॉल करना पड़ा था. update.sh की नई सुविधा से, API BaaS को अपडेट किया जा सकता है. Apigee Edge 4.16.01 को 4.16.05 से अपडेट करें देखें.

एडमिनिस्ट्रेशन

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

  • इंस्टॉल करने की पुष्टि - आपके Edge प्राइवेट क्लाउड को इंस्टॉल करने की जांच करने के लिए इस्तेमाल की गई apigee-validate सुविधा को अब मैनेजमेंट सर्वर से चलाया जा सकता है. पहले, स्क्रिप्ट को मैसेज प्रोसेसर पर चलाना पड़ता था. इंस्टॉल की जांच करना देखें.
  • क्षेत्र का नाम - क्षेत्र का कोई भी नाम हो सकता है. पिछली रिलीज़ में, नाम "dc-#" रूप में था, जहां # एक पूर्णांक मान था.
  • गेटवे पॉड - गेटवे पॉड का कोई भी नाम हो सकता है. पिछली रिलीज़ में, पॉड को "गेटवे" नाम देना पड़ता था.
  • स्क्रिप्ट पर आधारित एडमिन - एक नई apigee-adminapi.sh कमांड लाइन सुविधा, आपको Edge मैनेजमेंट एपीआई को कॉल करके ऐसे ही Edge कॉन्फ़िगरेशन टास्क करने में मदद करती है जो आपने किए थे. apigee-adminapi.sh यूटिलिटी का इस्तेमाल करना देखें.
  • वर्चुअल होस्ट एसएसएल साइलेंट कॉन्फ़िगरेशन - कोई संगठन या एनवायरमेंट बनाते समय, अब आपके पास एसएसएल को वर्चुअल होस्ट पर कॉन्फ़िगर करने के लिए प्रॉपर्टी पास करने का विकल्प है. संगठन में शामिल होना देखें.

एपीआई सेवाएं

Edge API सेवाएं के लिए नई सुविधाएं नीचे दी गई हैं, जो इस प्रॉडक्ट के पिछले क्लाउड वर्शन में डिलीवर की गई थीं.

syslog मैसेज लॉग करने के लिए तय किया गया प्रीफ़िक्स (Cloud 16.03.30)

मैसेज लॉग करने की नीति के तहत, Syslog कॉन्फ़िगरेशन में एक नया <FormatMessage> एलिमेंट शामिल है. <FormatMessage>true</FormatMessage> को सेट करने पर, Syslog मैसेज वर्णों की तय संख्या से शुरू होते हैं. इसकी मदद से, Apigee में डाले गए डेटा को फ़िल्टर किया जा सकता है. ज़्यादा जानकारी के लिए, मैसेज लॉग करने की नीति देखें. (एपीआईआरटी-1398)

एपीआई प्रॉक्सी बेस पाथ में वाइल्डकार्ड (Cloud 16.03.09 यूज़र इंटरफ़ेस (यूआई))

मैनेजमेंट यूज़र इंटरफ़ेस (यूआई) की मदद से, एपीआई प्रॉक्सी बेस पाथ में एक या उससे ज़्यादा /*/ वाइल्डकार्ड इस्तेमाल किए जा सकते हैं. उदाहरण के लिए, /team/*/members के बेस पाथ की मदद से क्लाइंट, https://[host]/team/blue/members या https://[host]/team/green/members के साथ आपकी प्रॉक्सी को कॉल कर सकते हैं. इसके लिए, आपको नई टीमों की मदद करने के लिए, नया प्रॉक्सी बनाने की ज़रूरत नहीं होगी. ध्यान दें कि /**/ की अनुमति नहीं है. (एमजीएमटी-3154)

एपीआई प्रॉक्सी चेन (Cloud 16.03.02, Cloud 16.03.09 यूज़र इंटरफ़ेस (यूआई))

Edge लोकल एपीआई प्रॉक्सी चेन के साथ काम करता है, जो एक एपीआई प्रॉक्सी को आपके Edge संगठन में अतिरिक्त नेटवर्क ओवरहेड के बिना डिप्लॉय किए गए दूसरे एपीआई प्रॉक्सी को कॉल करने देता है. पहले, एपीआई प्रॉक्सी चेन के लिए किसी दूसरे एपीआई प्रॉक्सी पर एचटीटीपी कॉल करना पड़ता था, जो लोड बैलेंसर, राऊटर, और मैसेज प्रोसेसर की मदद से अनुरोध को फ़ॉरवर्ड करता था.

नए LocalTargetConnection एलिमेंट, एपीआई प्रॉक्सी के TargetEndpoint पर उपलब्ध होते हैं. इसकी मदद से, एपीआई प्रॉक्सी का नाम, एपीआई प्रॉक्सी में किसी खास प्रॉक्सीEndpoint का नाम या स्थानीय एपीआई प्रॉक्सी संसाधन का बेस पाथ (जैसे, /v1/myresource) तय किया जा सकता है. किसी TargetEndpoint को जोड़ते या अपडेट करते समय भी, प्रॉक्सी एडिटर यूज़र इंटरफ़ेस (यूआई) में आपको ये विकल्प मिलते हैं.

प्रॉक्सी चेन की सुविधा, सेवा कॉलआउट की नीतियों में भी उपलब्ध है.

ज़्यादा जानकारी के लिए, Chaining API प्रॉक्सी एक साथ देखें. LocalTargetConnection के नए एलिमेंट, एक्सएमएल स्कीमा में भी यहां शामिल किए गए हैं: https://github.com/apigee/api-platform-samples/blob/master/schemas/configuration/configuration_schemas.xsd. (एमजीएमटी-3049, एमजीएमटी-3050)

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

इस रिलीज़ में इन गड़बड़ियों को ठीक किया गया है. यह सूची मुख्य रूप से उन उपयोगकर्ताओं के लिए है जो यह देखते हैं कि उनके सहायता टिकट की समस्या ठीक हुई है या नहीं. इसे सभी उपयोगकर्ताओं को पूरी जानकारी देने के लिए नहीं बनाया गया है.

प्राइवेट क्लाउड 4.16.05 के लिए एज

समस्या आईडी ब्यौरा
PRC-770 16.01 इंस्टॉलर, axgroup में Postgres स्टैंडबाय सर्वर को रजिस्टर नहीं कर पाता
PRC-758 उपयोगकर्ता की भूमिका वाला उपयोगकर्ता, कस्टम रिपोर्ट में बदलाव कर सकता है
PRC-883 मास्टर-स्टैंडबाय कॉन्फ़िगरेशन के साथ Postgres सर्वर पर अपडेट काम नहीं कर रहा है

क्लाउड 16.03.30

समस्या आईडी ब्यौरा
SECENG-584 किसी सर्टिफ़िकेट की चेन के सर्टिफ़िकेट के बीच नई लाइन की पुष्टि करने की वजह से, प्रोडक्शन के कुछ सर्टिफ़िकेट में समस्याएं पैदा होती हैं
MGMT-3217 अगर KVMap का नाम "keys" से खत्म होता है, तो मैनेजमेंट एपीआई कॉल पूरे नहीं हो सकते
MGMT-3214 Java कॉलआउट के दौरान क्लास से जुड़े विवाद हो सकते हैं, जिसकी वजह से ग्राहक का Java कोड काम नहीं करेगा
MGMT-3185 किसी संगठन में संगठन एडमिन जोड़ते समय गड़बड़ी हुई
EDGEUI-127 नए प्रॉक्सी एडिटर का इस्तेमाल करके, ज़रूरत के मुताबिक अनुमतियां नहीं पाना
EDGEUI-119 यूज़र इंटरफ़ेस (यूआई) सेशन के टाइम आउट होने की समस्या
CORESERV-671 "कोई रिंग कॉन्फ़िगर नहीं की गई; cps सेवा शुरू नहीं की जा सकती" गड़बड़ियां दिख रही हैं
AXAPP-2345 नॉन cps ग्राहकों के लिए AX कस्टम रिपोर्ट की लिस्टिंग में आने वाली समस्या
AXAPP-2302 डेली Apigee Analytics की खास जानकारी में, डेवलपर के इस्तेमाल की संख्या शून्य दिखती है
APIRT-2750 किसी संगठन के लिए, ट्रैफ़िक में ज़्यादा गड़बड़ी होना
APIRT-2516 JavaScript कॉलआउट की रनटाइम की गड़बड़ियां, गलत लाइन नंबर दिखाती हैं
APIRT-2508 Vault कॉलबैक में, एक्सप्रेस लिसन को कॉल करते समय हुई गड़बड़ी से बाहर निकलें
APIRT-2336 Node.js के साथ Gzip की समस्या
APIRT-1975 message.content के लिए मास्क कॉन्फ़िगरेशन काम नहीं कर रहे

Cloud 16.03.16 यूज़र इंटरफ़ेस (यूआई)

समस्या आईडी ब्यौरा
MGMT-3142 गड़बड़ी विश्लेषण के डैशबोर्ड पर ग्राफ़ लोड नहीं हो रहे हैं (अपडेट किया गया समाधान)

Cloud 16.03.09 यूज़र इंटरफ़ेस (यूआई)

समस्या आईडी ब्यौरा
MGMT-3158 जब एपीआई के ज़रिए अलग-अलग प्रॉक्सी पर आरबीएसी को सेट किया जाता है, तब यूज़र इंटरफ़ेस (यूआई) में ज़रूरत के मुताबिक अनुमतियां नहीं हैं
MGMT-3142 गड़बड़ी विश्लेषण के डैशबोर्ड पर ग्राफ़ लोड नहीं हो रहे हैं
MGMT-3118 यूज़र इंटरफ़ेस (यूआई) में "clientAuthEnabled" पैरामीटर के लिए गलत एसएसएल वर्चुअल होस्ट कॉन्फ़िगरेशन दिख रहा है
DEVRT-2344 एक दिन की रिपोर्ट की परिभाषाएं, यूज़र इंटरफ़ेस (यूआई) में लेन-देन लोड नहीं करती

क्लाउड 16.03.02

समस्या आईडी ब्यौरा
MGMT-3083 Node.js लॉग के अपने-आप रीफ़्रेश होने की सुविधा, लॉग मैसेज के साथ बहुत ज़्यादा शब्दों में लिखी गई है
DEVRT-2275 कस्टम एट्रिब्यूट रेट प्लान, 10 एट्रिब्यूट की अनुमति के बजाय सिर्फ़ पांच एट्रिब्यूट दिखाते हैं
DEVRT-1275 दर योजना के ड्रॉप-डाउन मेन्यू में सभी डेवलपर नहीं दिखाए गए हैं
DEVRT-1074 क्रेडिट लागू होने पर, बिना बैलेंस वाला प्रीपेड डेवलपर, Nullpointer शिकायत करता है

क्लाउड 16.02.17

समस्या आईडी ब्यौरा
MGMT-3083 Node.js लॉग के अपने-आप रीफ़्रेश होने की सुविधा, लॉग मैसेज के साथ बहुत ज़्यादा शब्दों में लिखी गई है
MGMT-3077 यूज़र इंटरफ़ेस (यूआई), ऐसे WSDL से अमान्य प्रॉक्सी बंडल जनरेट करता है जो डिफ़ॉल्ट नेमस्पेस का इस्तेमाल करता है
MGMT-1642 डेवलपर ऐप्लिकेशन के लिए, कस्टम उपयोगकर्ता भूमिका में "पाएं" की अनुमति मौजूद नहीं है

आम तौर पर होने वाली समस्याएं

इस रिलीज़ में ये समस्याएं हैं जिनके बारे में हमें पता है.

समस्या आईडी ब्यौरा
APIRT-2978

Router, Ngnx या राऊटर को शुरू नहीं कर सका

अगर Edge राऊटर, Ngnx को शुरू नहीं कर पाता है या कोई भी चालू नहीं हो पाता है, जैसा कि /opt/apigee/var/log/edge-router/logs/system.log फ़ाइल में दिखाया गया है, तो /opt/nginx/conf.d डायरेक्ट्री में मौजूद सभी फ़ाइलें मिटा दें और राऊटर को रीस्टार्ट करें:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
APIRT-3364

मैसेज प्रोसेसर, IPv4 और IPv6 पर डीएनएस लुकअप का इस्तेमाल करता है

अगर आपने NSCD (नेम सर्विस कैश डीमन) को इंस्टॉल और चालू किया है, तो आपको दिखेगा कि मैसेज प्रोसेसर दो डीएनएस लुकअप बनाते हैं: एक IPv4 के लिए और दूसरा IPv6 के लिए.

IPv6 पर डीएनएस लुकअप को बंद करने के लिए:

  1. हर मैसेज प्रोसेसर नोड पर, /etc/nscd.conf में बदलाव करें.
  2. इस प्रॉपर्टी को सेट करें:

    enable-cache होस्ट no
PRC-1118

"apigee-service apigee-postgresql pg-data-Perge" कमांड चलाने में गड़बड़ी हुई

अगर "apigee-service apigee-postgresql pg-data-puge" कमांड चलाया जाता है और फ़ॉर्म में गड़बड़ी दिखती है:

गड़बड़ी: संबंध का स्वामी होना चाहिए

/opt/apigee/apigee-postgresql-4.16.05-0.0.894/lib/actions/pg-data-purge में बदलाव करें और नीचे दी गई प्रॉपर्टी को 'apigee' पर सेट करें:

POSTGRES_USER=apigee
DOC-1687 पैकेज डिपेंडेंसी से जुड़े विवाद की वजह से, सैटलाइट के सर्वर 6 में इस्तेमाल किया गया Katello एजेंट, Qpid डीमन चलाने वाले Apigee Edge होस्ट पर ठीक से इंस्टॉल नहीं होगा.

मैसेज असाइन करने, Java कॉलआउट, और गड़बड़ी बढ़ाएं नीतियों में JSON पेलोड

मैसेज असाइन करें, Java कॉलआउट, और गड़बड़ी बढ़ाएं नीतियों की मदद से, <Set><Payload> एलिमेंट का इस्तेमाल करके मैसेज का कॉन्टेंट जनरेट किया जा सकता है. उन मैसेज के हिस्से के तौर पर, आपके पास ऐसे वैरिएबल शामिल करने का विकल्प होता है जिनकी वैल्यू, रनटाइम के दौरान अपने-आप भर जाती है. उदाहरण के लिए, अगर आपको एचटीटीपी हेडर से तारीख को आउटपुट करना है, तो अपने मैसेज में {message.header.date} डाला जा सकता है.

अगर मैसेज का फ़ॉर्मैट JSON है, तो यह कुछ ऐसा दिखेगा:

{"The date is: " : "{message.header.date}"}

हालांकि, देखा जा सकता है कि यह एक गलत JSON है. इस समस्या को हल करने के लिए, आपके पास दो विकल्प हैं:

  • बैकस्लैश का इस्तेमाल करके, शुरुआती कर्ली ब्रेस को एस्केप करें: 
    \{"The date is: " : "{message.header.date}"}
  • पेलोड एलिमेंट के कॉन्फ़िगरेशन में, JSON पेलोड में वैरिएबल दिखाने के लिए, variablePrefix और variableSuffix एट्रिब्यूट का इस्तेमाल करें. उदाहरण के लिए:
    <Payload contentType="application/json" variablePrefix="#" variableSuffix="%">{"The date is: " : "#message.header.date%"}</Payload>

प्राइवेट क्लाउड फ़ीचर रिलीज़ के अगले EDGE में, बिना समस्या वाले JSON मैसेज में वैरिएबल के लिए कर्ली ब्रैकेट इस्तेमाल किए जा सकेंगे. (एपीआईआरटी-1160)

Ngnx या राऊटर चालू नहीं हो सका

अगर Edge राऊटर, Ngnx को शुरू नहीं कर पाता या कोई भी चालू नहीं हो पाता, जैसा कि /opt/apigee/var/log/edge-router/logs/system.log फ़ाइल में दिखाया गया है, तो /opt/nginx/conf.d डायरेक्ट्री से सभी फ़ाइलें मिटा दें और राऊटर को रीस्टार्ट करें:

> rm -f /opt/nginx/conf.d/*
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
पीछे जाएं
4.16.05.01
आगे बढ़ें
4.16.01.08