4.19.06 निजी क्लाउड के लिए Edge की जानकारी

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

इस सेक्शन में, Edge for Private Cloud के फ़ीचर रिलीज़ के वर्शन 4.19.06 के बारे में बताया गया है.

रिलीज़ के बारे में खास जानकारी

इस टेबल में, इस रिलीज़ में हुए बदलावों के बारे में खास जानकारी दी गई है:

नई सुविधाएं

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

○ एसएसओ के लिए एलडीएपी का इस्तेमाल किया जा सकता है
○ एचटीटीपी डिप्लॉयमेंट की सुविधा
○ प्लग करने लायक ऐनलिटिक्स
○ कैसेंड्रा रैक की सुविधा
○ IPv6 की सुविधा
○ New Edge Experience को आसानी से इंस्टॉल किया जा सकता है
○ INVALID_TSC लेन-देन (मुद्रीकरण) को बाहर रखें

इन नई सुविधाओं के बारे में ज़्यादा जानने के लिए, नई सुविधाएं देखें.

पुराने सिस्टम के साथ काम करने की सुविधा

Apigee Edge for Private Cloud के इस वर्शन में, पिछले वर्शन के साथ काम करने से जुड़ी ये समस्याएं हैं:

शामिल की गई रिलीज़

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

○ Edge:
   19.07.23 (यूज़र इंटरफ़ेस)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31
○ पोर्टल:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
बंद की जा रही सुविधाएं कोई नहीं
बंद की गई सेवाएं/सुविधाएं

4.19.06 वर्शन के रिलीज़ होने के बाद, इन्हें बंद कर दिया गया है:

  • 4.18.01: Apigee Edge for Private Cloud का वर्शन 4.18.01 अब काम नहीं करता.

ज़्यादा जानकारी के लिए, Apigee के बंद किए गए, हटाए गए, और सीपीएस से जुड़े बदलाव लेख पढ़ें.

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

इस रिलीज़ में, ये गड़बड़ियां ठीक की गई हैं:

○ UseStringDeduplication not set (140270474)
○ MP errors (111445518)
○ Cassandra failures with JMX (113342838)
○ 13-node upgrades (138931337)
○ Proxies with the same name (119802562)
○ Keystores not loading (118851790)
○ Analytics failed (110988191)
○ Backup failures (110785400)
○ HEAD requests to Node.js (79993247)
○ apigee-postgres backup/restore (70291825)
○ Resetting sysadmin password (65737520)

इनमें से हर समस्या को ठीक करने के बारे में ज़्यादा जानने के लिए, बग ठीक करना लेख पढ़ें.

आम समस्याएं

इस रिलीज़ में, इन समस्याओं के बारे में बताया गया है:

○ Mint, शुरू में लेन-देन को रेटिंग नहीं दे रहा है (141628497)
○ Mint रेटिंग सर्वर में मेमोरी लीक की समस्या (137865184)
○ apigee-sso इंस्टॉल करने के लिए मेटाडेटा फ़ाइल फ़ॉर्मैट (135616498)
○ apigee-monit Amazon Linux 1 पर मौजूद नहीं है (122370980)
○ Message Processor backup, फ़ाइलों के सही सेट का बैक अप नहीं ले रहा है (121095148)
○ एक से ज़्यादा डेटा सेंटर कॉन्फ़िगरेशन में DataAccessExceptions (76087166)
○ MessageLogging नीति, लॉग मैसेज में अतिरिक्त जानकारी शामिल करती है (68722102)

इन सामान्य समस्याओं और उन्हें हल करने के तरीकों के बारे में ज़्यादा जानने के लिए, सामान्य समस्याएं लेख पढ़ें.

अपग्रेड करने के तरीके

यहां दी गई टेबल में, इस रिलीज़ के लिए अपग्रेड करने के पाथ दिखाए गए हैं:

4.19.01 से सीधे तौर पर 4.19.01 से 4.19.06 पर अपग्रेड करें
4.18.05 से सीधे तौर पर 4.18.05 से 4.19.06 पर अपग्रेड करें
4.18.01 से सीधे तौर पर 4.18.01 से 4.19.06 पर अपग्रेड करें

नई सुविधाएं

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

इस रिलीज़ में, इस्तेमाल करने में आसानी, परफ़ॉर्मेंस, सुरक्षा, और स्थिरता से जुड़े कई सुधार भी शामिल हैं. इनके अलावा, यहां दिए गए सुधार भी शामिल हैं.

एचटीटीपी डिप्लॉयमेंट की सुविधा

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

इसलिए, Apigee का सुझाव है कि बड़े डिप्लॉयमेंट के लिए, डिप्लॉयमेंट के लिए आरपीसी के बजाय एचटीटीपी का इस्तेमाल करें. अब एचटीटीपी डिप्लॉयमेंट चालू किए जा सकते हैं.

ज़्यादा जानकारी के लिए, एचटीटीपी डिप्लॉयमेंट चालू करना लेख पढ़ें.

Cassandra रैक के लिए सहायता

Apigee अब Cassandra के ऑपरेशन को स्केल करने के लिए सामान्य दिशा-निर्देश देता है. इसके लिए, Apigee Edge for Private Cloud पर Cassandra को रैक अवेयर बनाया जाता है.

ज़्यादा जानकारी के लिए, Cassandra रैक की सुविधा देखें.

आंकड़ों को प्लग इन करने की सुविधा

डिफ़ॉल्ट रूप से, Message Processor से इकट्ठा किया गया Analytics डेटा, प्रोसेस करने के लिए Qpid और Postgres पर अपलोड किया जाता है. इसके बाद, Edge के यूज़र इंटरफ़ेस (यूआई) में Analytics का डेटा देखा जा सकता है.

इस सुविधा के रिलीज़ होने के बाद, मैसेज प्रोसेसर को कॉन्फ़िगर किया जा सकता है, ताकि वह डिस्क पर ऐनलिटिक्स डेटा लिख सके. इसके अलावा, दोनों विकल्पों का इस्तेमाल भी किया जा सकता है.

ज़्यादा जानकारी के लिए, फ़ाइल में Analytics डेटा लिखना लेख पढ़ें.

New Edge को आसानी से इंस्टॉल करने की सुविधा

नई स्क्रिप्ट की मदद से, New Edge को आसानी से इंस्टॉल किया जा सकता है.

ज़्यादा जानकारी के लिए, New Edge Experience इंस्टॉल करना लेख पढ़ें.

LDAP IDP की सुविधा

Edge यूज़र इंटरफ़ेस (यूआई) और Edge Management API कॉल के ज़रिए उपयोगकर्ताओं की पुष्टि करने की सुविधा में, अब एसएएमएल के साथ-साथ एलडीएपी का भी इस्तेमाल किया जा सकता है. एलडीएपी के साथ डायरेक्ट बाइंडिंग और इनडायरेक्ट बाइंडिंग, दोनों तरीकों से काम किया जा सकता है.

ज़्यादा जानकारी के लिए, बाहरी आईडीपी की पुष्टि करने की सुविधा के बारे में खास जानकारी देखें.

IPv6 की सुविधा

डिफ़ॉल्ट रूप से, Apigee Edge for Private Cloud को किए जाने वाले सभी रनटाइम एपीआई कॉल, IPv4 का इस्तेमाल करते हैं. नई प्रॉपर्टी की मदद से, राउटर में IPv6 का सपोर्ट जोड़ा जा सकता है.

ज़्यादा जानकारी के लिए, राउटर पर IPv6 का इस्तेमाल करना लेख पढ़ें.

INVALID_TSC लेन-देन (कमाई करने की सुविधा) को शामिल न करें

अब कमाई करने की सुविधा का इस्तेमाल करते समय, INVALID_TSC लेन-देन को Postgres डेटाबेस में शामिल होने से रोका जा सकता है.

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

YouTube पर कैप्शन जोड़ने के लिए इस्तेमाल किए जाने वाले सॉफ़्टवेयर

इस रिलीज़ में, इन सॉफ़्टवेयर में ये बदलाव किए गए हैं:

सहायता जोड़ी गई अब काम नहीं करतीं

इस रिलीज़ में, इन प्लैटफ़ॉर्म के लिए सहायता जोड़ी गई है:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

इस रिलीज़ के साथ, इन प्लैटफ़ॉर्म पर अब काम नहीं किया जा सकता:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

इस सुविधा के साथ काम करने वाले प्लैटफ़ॉर्म की पूरी सूची देखने के लिए, इस सुविधा के साथ काम करने वाले सॉफ़्टवेयर और उनके वर्शन पर जाएं.

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

इस सेक्शन में, Private Cloud में मौजूद उन गड़बड़ियों की सूची दी गई है जिन्हें इस रिलीज़ में ठीक किया गया है. इसके अलावा, इस रिलीज़ में Edge यूज़र इंटरफ़ेस (यूआई), Edge Management, और Portal की उन रिलीज़ में गड़बड़ियां ठीक की गई हैं जिनके बारे में शामिल की गई रिलीज़ में बताया गया है.

समस्या आईडी ब्यौरा
140270474

UseStringDeduplication not set

UseStringDeduplication को प्रोडक्शन एनवायरमेंट में edge-message-processor कॉम्पोनेंट के लिए सेट नहीं किया जा रहा था.
111445518

एमपी से जुड़ी गड़बड़ियां

मैसेज प्रोसेसर, हर पांच मिनट में गड़बड़ी का यह मैसेज लगातार लॉग करते हैं:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

JMX के साथ Cassandra में गड़बड़ियां

JMX auth चालू होने पर, Cassandra के ऑपरेशन काम नहीं कर रहे थे
138931337

13 नोड अपग्रेड

17.09, 18.01, और 18.05 वर्शन से 13 नोड वाले इंस्टॉलेशन को अपग्रेड नहीं किया जा सका.
119802562

एक ही नाम वाली प्रॉक्सी

अगर एक ही संगठन के दो उपयोगकर्ताओं ने एक ही नाम से प्रॉक्सी बनाई हैं, तो बाद में बनाई गई प्रॉक्सी, पहले बनाई गई प्रॉक्सी को बदल देगी. ऐसा सिर्फ़ तब हुआ, जब अलग-अलग उपयोगकर्ता दूसरी प्रॉक्सी नहीं देख सके.
118851790

कीस्टोर लोड नहीं हो रहे हैं

किसी संगठन/एनवायरमेंट के लिए 100 से ज़्यादा कीस्टोर होने पर, Edge UI में कीस्टोर और रेफ़रंस सेक्शन लोड नहीं हो रहा था. इसके बजाय, यूज़र इंटरफ़ेस (यूआई) में Internal Error (Error Fetching Keystores) गड़बड़ी का मैसेज दिखाया गया.
110988191

Analytics की प्रोसेस पूरी नहीं हुई

जब Analytics को Microgateway से ऐसा डेटा मिला जिसे आने वाले समय की तारीख पर सेट किया गया था, तब Analytics किसी एनवायरमेंट के लिए काम नहीं कर सका.
110785400

बैकअप नहीं लिया जा सका

ZooKeeper, Cassandra, और OpenLDAP, समय-समय पर अपने डेटा का सही तरीके से बैक अप नहीं ले पाए. इसकी वजह यह गड़बड़ी थी: File changed as we read it.
79993247

HEAD Node.js को किए गए अनुरोध

HEAD Node.js टारगेट के अनुरोधों में समस्या आ सकती है. इससे कनेक्शन पेंडिंग रह जाते हैं.
70291825

apigee-postgres बैकअप/रीस्टोर

apigee-postgres बैकअप/रीस्टोर करने पर, अब सभी कॉम्पोनेंट का डेटा बैक अप हो जाता है.
65737520

सिस्टम एडमिन का पासवर्ड रीसेट करना

मैनेजमेंट सर्वर के लिए सिस्टम एडमिन का पासवर्ड रीसेट नहीं किया जा सकेगा. इस सर्वर के पासवर्ड में खास वर्ण शामिल थे.

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

इस रिलीज़ में मौजूद समस्याओं की सूची यहां दी गई है:

समस्या आईडी ब्यौरा
141628497

Mint शुरू में लेन-देन को रेटिंग नहीं देता

किसी संगठन के लिए पहली बार कमाई करने की सुविधा चालू करने पर, Edge for the Private Cloud शुरू में लेन-देन को रेटिंग नहीं देता. यह नए और मौजूदा संगठनों पर लागू होता है.

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

समस्या हल करने का तरीका:

किसी भी मैसेज प्रोसेसर (एमपी) को फिर से शुरू करें. इसके लिए, यह तरीका अपनाएं:
apigee-service edge-message-processor restart

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

137865184

Mint रेटिंग सर्वर में मेमोरी लीक की समस्या

जब किसी नए Qpid इंस्टेंस को mxgroup में रजिस्टर किया जाता है, तो उपभोक्ता के बिना ही कतारें बन जाती हैं. इससे कतार की गहराई तब तक बढ़ती रहती है, जब तक कि वह सभी उपलब्ध संसाधनों का इस्तेमाल न कर ले.

समस्या हल करने का तरीका:

कोई नहीं.
135616498

apigee-sso इंस्टॉल करने के लिए मेटाडेटा फ़ाइल का फ़ॉर्मैट

apigee-sso इंस्टॉल करते समय, यूआरएल के बजाय metadata.xml फ़ाइल का इस्तेमाल करने पर, अगर metadata.xml फ़ाइल के आखिर में नई लाइन (सीआरएलएफ़) शामिल नहीं है, तो metadata.xml फ़ाइल को पूरी तरह से नहीं पढ़ा जाता.

समस्या हल करने का तरीका:

इस समस्या को हल करने के लिए, इनमें से कोई एक तरीका अपनाएं:

  • metadata.xml फ़ाइल के आखिर में CRLF जोड़ें

    या

  • मेटाडेटा के लिए, यूआरएल पर आधारित जगह की जानकारी का इस्तेमाल करना
122370980

apigee-monit Amazon Linux 1 पर काम नहीं करता

समस्या हल करने का तरीका:

कोई नहीं.
121095148

Message Processor का बैकअप, फ़ाइलों के सही सेट का बैकअप नहीं ले रहा है

समस्या हल करने का तरीका:

बैकअप को दूसरी बार चलाएं. इससे फ़ाइलों का सही सेट बैक अप हो जाएगा.

76087166

एक से ज़्यादा डेटा सेंटर कॉन्फ़िगरेशन में DataAccessException

एक से ज़्यादा डेटा सेंटर कॉन्फ़िगरेशन में, अगर कोई डेटास्टोर उपलब्ध नहीं होता है, तो आपको यह गड़बड़ी दिख सकती है:

DataAccessException: Error while accessing datastore;
Please retry later

इस वजह से, मैनेजमेंट सर्वर शुरू नहीं हो सकता, क्योंकि यह dc-1 और dc-2, दोनों में Cassandra नोड से कनेक्ट करने की कोशिश कर रहा है. अगर कोई Cassandra नोड बंद है, तो DataAccessExceptions दिखता है. इससे एपीआई ट्रैफ़िक में भी रुकावट आ सकती है. इसमें मैसेज प्रोसेसर, KVM को वापस पाने की कोशिश करते समय DataAccessExceptions की रिपोर्ट करते हैं.

ध्यान दें कि मैनेजमेंट सर्वर को सभी क्षेत्रों में डेटास्टोर कॉम्पोनेंट से कनेक्ट नहीं करना चाहिए.

Workaround

इस समस्या को हल करने के लिए, अनुपलब्ध डेटा सेंटर में इन Cassandra नोड टाइप को अनरजिस्टर करें. इसके बाद, Cassandra नोड फिर से उपलब्ध होने पर, उन्हें फिर से रजिस्टर करें:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

इन Cassandra नोड टाइप का रजिस्ट्रेशन रद्द करने और फिर से रजिस्टर करने के लिए:

  1. नीचे दी गई curl कमांड का इस्तेमाल करके, Cassandra नोड के यूयूआईडी पाएं:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    कहां:

    • ADMIN_EMAIL और ADMIN_PW, आपके Apigee खाते के क्रेडेंशियल हैं.
    • MS_IP और MS_PORT, मैनेजमेंट सर्वर का आईपी पता और पोर्ट नंबर है.
    • REGION उस डेटा सेंटर का नाम है जिसमें मैनेजमेंट सर्वर मौजूद है.
    • GATEWAY_POD पॉड का नाम है, जो डिफ़ॉल्ट रूप से "gateway" होता है. हालांकि, हो सकता है कि आपने इसका नाम बदलकर कुछ और कर दिया हो. इसलिए, अपने लागू करने के तरीके की जांच करें.
    • CASSANDRA_NODE_TYPE, kms-datastore, dc-datastore, और keyvaluemap-datastore में से कोई एक है.

    उदाहरण के लिए:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    जवाब में इस फ़ॉर्मैट का इस्तेमाल किया जाता है:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    उदाहरण के लिए:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    जवाब में uUID फ़ील्ड की वैल्यू नोट करें. इनका इस्तेमाल, नोड को अनरजिस्टर करने के लिए किया जाएगा.

  2. हर Cassandra नोड टाइप के लिए, पहले चरण को दोहराएं: kms-datastore, dc-datastore, और keyvaluemap-datastore. वापस किए गए यूयूआईडी नोट करना न भूलें.
  3. नीचे दी गई कमांड का इस्तेमाल करके, नोड को डीरजिस्टर करें:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    यहां UUID, पिछली कमांड के जवाब में मिला यूयूआईडी है.

  4. पहले और दूसरे चरण में इकट्ठा किए गए हर यूयूआईडी के लिए, तीसरा चरण दोहराएं.
  5. इस कमांड का इस्तेमाल करके, नोड को फिर से रजिस्टर करें:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

ध्यान दें कि ये कार्रवाइयां, Zookeeper से नोड को रजिस्टर और डीरजिस्टर करती हैं. इनका Cassandra क्लस्टर पर कोई असर नहीं पड़ता. इन कमांड के बारे में ज़्यादा जानने के लिए, डेटास्टोर रजिस्ट्रेशन अपडेट करना लेख पढ़ें.

68722102

MessageLogging नीति, जिसमें लॉग मैसेज में अतिरिक्त जानकारी शामिल होती है

MessageLogging नीति का FormatMessage एलिमेंट, लॉग किए गए मैसेज के फ़ॉर्मैट को कंट्रोल करता है. FormatMessage=false होने पर, लॉग किए गए मैसेज में Apigee से जनरेट की गई कोई भी जानकारी शामिल नहीं होनी चाहिए. हालांकि, FormatMessage=false सेट करने पर भी, लॉग मैसेज में यह जानकारी शामिल होती है:

  • प्राथमिकता का स्कोर
  • टाइमस्टैंप

समस्या हल करने का तरीका:

कोई नहीं.

अगला चरण

Edge for Private Cloud 4.19.06 का इस्तेमाल शुरू करने के लिए, इन लिंक का इस्तेमाल करें:

नए इंस्टॉलेशन:
नए इंस्टॉलेशन की खास जानकारी
मौजूदा इंस्टॉलेशन:
पाथ अपग्रेड करें