Apigee Edge 4.52.02 या 4.53.00 को 4.53.01 पर अपडेट करना

Apigee, Edge for Private Cloud को सीधे तौर पर वर्शन 4.52.02 या 4.53.00 से वर्शन 4.53.01 पर अपग्रेड करने की सुविधा देता है. इस पेज पर, इस तरह के अपग्रेड करने का तरीका बताया गया है.

अपग्रेड करने के लिए उपलब्ध पाथ की खास जानकारी के लिए, Edge for Private Cloud के रिलीज़ वर्शन के लिए, अपग्रेड करने से जुड़ी कंपैटबिलिटी मैट्रिक्स देखें.

अपडेट कौन कर सकता है

अपडेट करने वाला व्यक्ति वही होना चाहिए जिसने Edge को मूल रूप से इंस्टॉल किया था या वह रूट के तौर पर काम कर रहा हो.

Edge RPM इंस्टॉल करने के बाद, कोई भी व्यक्ति उन्हें कॉन्फ़िगर कर सकता है.

आपको किन कॉम्पोनेंट को अपडेट करना होगा

आपको Edge के सभी कॉम्पोनेंट अपडेट करने होंगे. Edge, ऐसे सेटअप के साथ काम नहीं करता जिसमें कई वर्शन के कॉम्पोनेंट शामिल हों.

ज़रूरी शर्तें अपडेट करना

Edge for Private Cloud 4.53.01 में हुए बदलावों की समीक्षा करें

इस वर्शन में, सुरक्षा से जुड़ी कई समस्याओं को ठीक किया गया है. सुरक्षा से जुड़े ये सुधार ज़रूरी हैं. हालांकि, इनकी वजह से कुछ ऐसे बदलाव होते हैं जो पुराने वर्शन के साथ काम नहीं करते. इसका मतलब है कि अपग्रेड के दौरान या बाद में कोई रुकावट न आए, इसके लिए अपग्रेड करने के दौरान कुछ और चरणों को पूरा करना होगा. ज़्यादा जानकारी के लिए, प्राइवेट क्लाउड के पुराने वर्शन से 4.53.01 वर्शन पर अपग्रेड करते समय, यह विषय ध्यान से पढ़ें.

Apigee Edge को अपग्रेड करने से पहले, पक्का करें कि आपने यहां दी गई ज़रूरी शर्तें पूरी की हों:

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

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

  • पक्का करें कि Edge चल रहा हो
    पक्का करें कि अपडेट की प्रोसेस के दौरान Edge चल रहा हो. इसके लिए, यह निर्देश इस्तेमाल करें: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • Cassandra की ज़रूरी शर्तों की पुष्टि करना

    अगर आपने Edge for Private Cloud के पुराने वर्शन से 4.52.02 वर्शन पर अपग्रेड किया था और अब आपको 4.53.01 वर्शन पर अपग्रेड करना है, तो पक्का करें कि आपने Cassandra के लिए, अपग्रेड के बाद ज़रूरी चरण पूरे कर लिए हों. इन चरणों के बारे में, वर्शन 4.52.02 को अपग्रेड करने से जुड़े दस्तावेज़ में बताया गया है. साथ ही, Cassandra को अपग्रेड करने की ज़रूरी शर्तें में भी इनके बारे में बताया गया है. अगर आपको पक्का नहीं है कि पिछले अपग्रेड के दौरान ये चरण पूरे किए गए थे या नहीं, तो वर्शन 4.53.01 पर अपग्रेड करने से पहले, इन्हें फिर से पूरा करें.

  • Edge for Private Cloud 4.53.01 में आईडीपी कुंजियां और सर्टिफ़िकेट कॉन्फ़िगर करना

    Edge for Private Cloud 4.53.01 में, apigee-sso कॉम्पोनेंट में इस्तेमाल की जाने वाली आईडीपी कुंजियों और सर्टिफ़िकेट को अब कीस्टोर के ज़रिए कॉन्फ़िगर किया जाता है. आपको पहले इस्तेमाल की गई कुंजी और सर्टिफ़िकेट को कीस्टोर में एक्सपोर्ट करना होगा. एसएसओ कॉम्पोनेंट को अपडेट करने से पहले, Apigee SSO को पुराने वर्शन से अपडेट करने का तरीका सेक्शन में दिए गए निर्देशों को पढ़ें.

  • Python की ज़रूरी शर्तें
    अपग्रेड करने से पहले, पक्का करें कि सभी नोड पर Python 3 इंस्टॉल हो. इनमें Cassandra नोड भी शामिल हैं.

अपग्रेड करने के लिए, कौनसे खास चरण अपनाने चाहिए

Edge for Private Cloud 4.53.01 पर अपग्रेड करने के लिए, कुछ सॉफ़्टवेयर को अपग्रेड करने का तरीका अपनाएं. ज़रूरी चरण, आपके मौजूदा वर्शन पर निर्भर करते हैं. यहां दी गई टेबल में, ऐसे सॉफ़्टवेयर के बारे में बताया गया है जिनके लिए आपको कुछ और चरणों का पालन करना होगा. साथ ही, हर सॉफ़्टवेयर के लिए निर्देश भी दिए गए हैं. ज़रूरी टास्क पूरे करने के बाद, अपग्रेड की प्रोसेस जारी रखने के लिए, अपग्रेड करने की मुख्य प्रक्रिया पर वापस जाएं.

वर्तमान वर्शन ऐसे सॉफ़्टवेयर जिन्हें 4.53.01 वर्शन पर अपग्रेड करने के लिए, खास चरणों का पालन करना पड़ता है
4.52.02 LDAP, Cassandra, Zookeeper, Postgres
4.53.00 LDAP, Zookeeper, Postgres

अपने वर्शन के हिसाब से ज़रूरी चरणों को पूरा करने के बाद, अपग्रेड करने की मुख्य प्रोसेस पर वापस जाएं.

प्रॉपर्टी की सेटिंग अपने-आप लागू होने की सुविधा

अगर आपने /opt/apigee/customer/application में .properties फ़ाइलों में बदलाव करके कोई प्रॉपर्टी सेट की है, तो अपडेट करने के बाद भी ये वैल्यू बनी रहती हैं.

OpenLDAP 2.6 पर अपग्रेड करना ज़रूरी है

Apigee Edge for Private Cloud की LDAP सेवा को लेगसी OpenLDAP 2.4 से OpenLDAP 2.6 पर अपग्रेड करने का तरीका यहां दिया गया है. Apigee Edge for Private Cloud के 4.53.01 और इसके बाद के वर्शन को अपडेट करने के लिए, यह अपग्रेड करना ज़रूरी है. यह अपग्रेड, Apigee LDAP की सभी डिप्लॉयमेंट टोपोलॉजी पर लागू होता है: सिंगल-सर्वर, ऐक्टिव-पैसिव, और ऐक्टिव-ऐक्टिव (मल्टी-मास्टर).

ज़रूरी शर्तें और ध्यान रखने वाली बातें

  • ध्यान दें कि एलडीएपी अपग्रेड करने की प्रोसेस के दौरान, सभी इलाकों में मैनेजमेंट एपीआई और Apigee यूज़र इंटरफ़ेस (यूआई) पूरी तरह से उपलब्ध नहीं होगा. उपयोगकर्ताओं, भूमिकाओं, ऐप्लिकेशन, और संगठनों को मैनेज करने जैसे सभी एडमिन टास्क पूरे नहीं किए जा सकेंगे. इसलिए, इन्हें रोक देना चाहिए. इससे आपकी एपीआई प्रॉक्सी के ट्रैफ़िक को प्रोसेस करने पर कोई असर नहीं पड़ेगा. एलडीएपी अपग्रेड करने से पहले, कृपया सभी एज-मैनेजमेंट-सर्वर और एज-यूआई बंद कर दें.

  • बैकअप ज़रूरी है: आपके मौजूदा एलडीएपी डेटा का पूरा और पुष्टि किया गया बैकअप होना ज़रूरी है. सही बैकअप के बिना आगे बढ़ने पर, डेटा का ऐसा नुकसान होगा जिसे वापस नहीं लाया जा सकता. एलडीएपी सेवा के चालू रहने के दौरान ही बैकअप शुरू किया जाना चाहिए, ताकि एलडीएपी डेटा का एक जैसा स्नैपशॉट लिया जा सके. अपग्रेड करने के लिए, बैकअप लेना ज़रूरी है. बैकअप के बिना, न तो अपग्रेड किया जा सकेगा और न ही पहले जैसा किया जा सकेगा. ऐसा इसलिए, क्योंकि अपग्रेड करने के दौरान एलडीएपी डेटा मिट जाता है.

तैयारी और इंस्टॉलेशन (सभी LDAP सर्वर)

इस सेक्शन में दिए गए चरण (दूसरा चरण से पांचवां चरण तक) सभी एलडीएपी डिप्लॉयमेंट टोपोलॉजी के लिए एक जैसे हैं. ये कार्रवाइयां हर उस सर्वर पर की जानी चाहिए जहां apigee-openldap कॉम्पोनेंट इंस्टॉल है. भले ही, उसकी भूमिका कुछ भी हो.

  1. एलडीएपी को अपग्रेड करने से पहले, कृपया सभी edge-management-server और edge-ui को बंद कर दें. 
    apigee-service edge-management-server stop
apigee-service edge-ui stop

  2. मौजूदा एलडीएपी डेटा का बैक अप लेना

    कोई भी बदलाव करने से पहले, सभी LDAP सर्वर से मौजूदा LDAP डेटा का पूरा बैकअप लें. इससे सुरक्षित रीस्टोर पॉइंट बनता है.

    • बैकअप लेने का निर्देश दें. इस कार्रवाई से, /opt/apigee/backup/openldap डायरेक्ट्री में टाइमस्टैंप वाला बैकअप संग्रह बनता है. 
      apigee-service apigee-openldap backup
    • रिकॉर्ड की कुल संख्या पाएं: अपग्रेड के बाद पुष्टि करने के लिए, अपनी डायरेक्ट्री में मौजूद रिकॉर्ड की संख्या कैप्चर करें. रिकॉर्ड की संख्या, सभी एलडीएपी सर्वर में एक जैसी होनी चाहिए. यह एक सैनिटी चेक है. 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l

  3. एलडीएपी को बंद करना और डेटा डायरेक्ट्री को साफ़ करना

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

    • एलडीएपी सेवा बंद करें. 
      apigee-service apigee-openldap stop
    • एलडीएपी के पुराने डेटा और कॉन्फ़िगरेशन डायरेक्ट्री को हमेशा के लिए मिटाएं. 
      rm -rf /opt/apigee/data/apigee-openldap/*

  4. LDAP के नए वर्शन को इंस्टॉल और कॉन्फ़िगर करना

    सभी LDAP सर्वर पर, नए कॉम्पोनेंट वर्शन को डाउनलोड और इंस्टॉल करने के लिए, Apigee की स्टैंडर्ड स्क्रिप्ट का इस्तेमाल करें.

    • नया LDAP कॉम्पोनेंट इंस्टॉल करें: अपडेट स्क्रिप्ट, आपकी कॉन्फ़िगरेशन फ़ाइल को पढ़ती है और नया apigee-openldap पैकेज इंस्टॉल करती है. 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f /opt/silent.conf
    • एलडीएपी के नए वर्शन की पुष्टि करें:इंस्टॉल होने के बाद, प्रोफ़ाइल को फिर से लोड करें. पुष्टि करें कि एलडीएपी का नया वर्शन सही तरीके से इंस्टॉल किया गया है. 
      source ~/.bash_profile
ldapsearch -VV
Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.6.7

  5. डेटा वापस लाने से पहले, सभी सर्वर पर LDAP को बंद करें

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

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*

  6. LDAP डेटा वापस पाना

    इस रणनीति के तहत, पहले चालू सर्वर पर बैकअप को वापस लाया जाता है. इसके बाद, यह सर्वर डेटा के सोर्स के तौर पर काम करेगा. साथ ही, मल्टी-सर्वर सेटअप में अपने साथियों को डेटा रेप्लिकेट करेगा.

    1. डेटा वापस लाने के लिए, पहले चालू किए गए सर्वर की पहचान करना

      • सिंगल-सर्वर सेटअप के लिए: यह आपका एकमात्र LDAP सर्वर है. सीधे अगले चरण पर जाएं.
      • ऐक्टिव-पैसिव और ऐक्टिव-ऐक्टिव सेटअप के लिए: हर LDAP सर्वर पर, नीचे दिए गए डाइग्नोस्टिक कमांड को चलाएं: 
        grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif
Note:
-If this command returns output, the server is a passive server.
-If it returns no output, the server is the active server.

    2. बैकअप लिए गए डेटा को वापस लाना

      आगे बढ़ने से पहले, दोबारा जांच लें कि सभी एलडीएपी सर्वर पर पांचवां चरण पूरा हो गया हो.

      • ऊपर बताए गए पहले चालू सर्वर पर, बैकअप डायरेक्ट्री पर जाएं. 
        cd /opt/apigee/backup/openldap
      • restore कमांड चलाएं. हमारा सुझाव है कि आप दूसरे चरण में बैकअप का सटीक टाइमस्टैंप डालें, ताकि अनचाहे या पुराने वर्शन को वापस लाने से बचा जा सके. 
        # To restore a specific backup (recommended):
apigee-service apigee-openldap restore 2025.08.11,23.34.00

# To restore the latest available backup by default:
apigee-service apigee-openldap restore
      • डेटा वापस लाने की प्रोसेस पूरी होने के बाद, पहले चालू सर्वर पर एलडीएपी सेवा शुरू करें. 
        apigee-service apigee-openldap start

  7. बाकी बचे LDAP सर्वर शुरू करना

    अगर आपने एक से ज़्यादा सर्वर सेट अप किए हैं, तो हर एलडीएपी सर्वर पर सेवा शुरू करें: 

    apigee-service apigee-openldap start

  8. पुष्टि करना

    आखिरी चरण में, यह पुष्टि की जाती है कि अपग्रेड हो गया है और पूरे एलडीएपी क्लस्टर में डेटा एक जैसा है.

    • सभी LDAP सर्वर पर पुष्टि करने वाला कमांड चलाएं. सभी सर्वर पर रिकॉर्ड की संख्या एक जैसी होनी चाहिए. साथ ही, यह संख्या चरण 2 में कैप्चर की गई संख्या से मेल खानी चाहिए.
      • # Note: Replace 'YOUR_PASSWORD' with your LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \
-D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • जब आपको यह पक्का हो जाए कि डेटा सही और एक जैसा है, तब एलडीएपी अपग्रेड की प्रोसेस पूरी हो जाती है. अब अपने संगठन की अपग्रेड करने की स्टैंडर्ड प्रोसेस के मुताबिक, edge-management-server, edge-ui, और अन्य ज़रूरी कॉम्पोनेंट शुरू करें.

Cassandra 4.0.18 पर अपग्रेड करना ज़रूरी है

Apigee Edge for Private Cloud 4.53.01 में, Cassandra को वर्शन 4.0.18 पर अपग्रेड किया गया है.

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

  • Cassandra 3.11.X से Cassandra 4.0.X पर अपग्रेड करना आसान है. Edge for Private Cloud 4.53.00 के साथ रिलीज़ किया गया Cassandra 4.0.X, Private Cloud 4.52.02 के रनटाइम और मैनेजमेंट कॉम्पोनेंट के साथ काम करता है.
  • Cassandra 4.0.X से 3.11.X पर सीधे रोलबैक नहीं किया जा सकता. रेप्लिका या बैकअप का इस्तेमाल करके रोल बैक करना एक मुश्किल प्रोसेस है. इसमें डाउनटाइम और/या डेटा का नुकसान हो सकता है. समस्याओं को हल करने और Cassandra 4.0.X पर अपग्रेड करने का सुझाव दिया जाता है.
  • अपग्रेड करने से पहले, रोलबैक करने की प्रोसेस के बारे में जान लें. अपग्रेड के दौरान रोलबैक की बारीकियों को ध्यान में रखना ज़रूरी है, ताकि यह पक्का किया जा सके कि रोलबैक के सही पाथ उपलब्ध हैं.

एक डेटा सेंटर

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

अगर नया डेटा सेंटर जोड़ना मुमकिन नहीं है, लेकिन आपको रोलबैक करने की सुविधा चाहिए, तो Cassandra 3.11.X को वापस लाने के लिए बैकअप ज़रूरी होंगे. हालांकि, इस तरीके से डेटा खो सकता है और कुछ समय के लिए सिस्टम काम नहीं कर सकता.

एक से ज़्यादा डेटा सेंटर

Edge for Private Cloud 4.52.02 के साथ कई डेटा सेंटर इस्तेमाल करने से, Edge for Private Cloud 4.53.00 पर अपग्रेड करने के दौरान रोलबैक करने में ज़्यादा आसानी होती है.

  • रोलबैक करने के लिए, कम से कम एक डेटा सेंटर में Cassandra का पुराना वर्शन (3.11.X) होना ज़रूरी है.
  • अगर आपके पूरे Cassandra क्लस्टर को 4.0.X पर अपग्रेड कर दिया गया है, तो आपको Cassandra 3.11.X पर वापस नहीं जाना चाहिए. आपको Private Cloud 4.53.00 या 4.52.02 के अन्य कॉम्पोनेंट के साथ, Cassandra के नए वर्शन का इस्तेमाल जारी रखना होगा.
  1. एक बार में एक Cassandra डेटा सेंटर अपग्रेड करें: किसी एक डेटा सेंटर में, Cassandra नोड को अलग-अलग अपग्रेड करके शुरू करें. एक डेटा सेंटर में मौजूद सभी Cassandra नोड को अपग्रेड करने के बाद ही, अगले डेटा सेंटर पर जाएं.
  2. रोकें और पुष्टि करें: एक डेटा सेंटर को अपग्रेड करने के बाद, यह पक्का करने के लिए रोकें कि आपका Private Cloud क्लस्टर, खास तौर से अपग्रेड किया गया डेटा सेंटर, सही तरीके से काम कर रहा है.
  3. ध्यान दें: Cassandra के पिछले वर्शन पर सिर्फ़ तब रोल बैक किया जा सकता है, जब कम से कम एक डेटा सेंटर अब भी पुराने वर्शन पर चल रहा हो.
  4. समयसीमा: पुष्टि करने के लिए, कुछ समय (हमारा सुझाव है कि कुछ घंटे) के लिए सुविधा को रोका जा सकता है. हालांकि, आपको हमेशा के लिए मिक्स-वर्शन की स्थिति में नहीं रहना चाहिए. ऐसा इसलिए है, क्योंकि अलग-अलग वर्शन वाले नोड के साथ नॉन-यूनिफ़ॉर्म Cassandra क्लस्टर में ऑपरेशन से जुड़ी सीमाएं होती हैं.
  5. पूरी तरह से जांच करना: Apigee का सुझाव है कि अगले डेटा सेंटर को अपग्रेड करने से पहले, परफ़ॉर्मेंस और फ़ंक्शन की पूरी तरह से जांच कर लें. सभी डेटा सेंटर अपग्रेड हो जाने के बाद, पिछले वर्शन पर वापस नहीं जाया जा सकता.
दो चेकपॉइंट वाली प्रोसेस के तौर पर रोलबैक करना
  1. पहली चेकपॉइंट: शुरुआती स्थिति, जिसमें सभी कॉम्पोनेंट वर्शन 4.52.02 पर हैं. जब तक कम से कम एक Cassandra डेटा सेंटर पुराने वर्शन पर रहता है, तब तक पूरी तरह से रोलबैक किया जा सकता है.
  2. चेकपॉइंट 2: सभी डेटा सेंटर में मौजूद सभी Cassandra नोड अपडेट होने के बाद. आपके पास इस स्थिति पर वापस जाने का विकल्प होता है. हालांकि, चेकपॉइंट 1 पर वापस नहीं जाया जा सकता.
उदाहरण

दो डेटा सेंटर (डीसी) वाले क्लस्टर के बारे में सोचें:

  1. शुरुआती स्थिति: दोनों डीसी में Cassandra नोड, वर्शन 3.11.X पर हैं. अन्य सभी नोड, Private Cloud के Edge के वर्शन 4.52.02 पर हैं. मान लें कि हर डीसी में तीन Cassandra नोड हैं.
  2. DC-1 को अपग्रेड करें: DC-1 में मौजूद तीनों Cassandra नोड को एक-एक करके अपग्रेड करें.
  3. रोकें और पुष्टि करें: यह पक्का करने के लिए कि क्लस्टर, खास तौर पर DC-1, सही तरीके से काम कर रहा है, इसे रोकें. इसके लिए, परफ़ॉर्मेंस और फ़ंक्शन की जांच करें. DC-2 में मौजूद Cassandra नोड का इस्तेमाल करके, डेटा को शुरुआती स्थिति में वापस लाया जा सकता है. ध्यान रखें कि मिक्स्ड-वर्शन वाले Cassandra क्लस्टर की सीमाओं की वजह से, यह प्रोसेस कुछ समय के लिए ही रोकी जा सकती है.
  4. DC-2 को अपग्रेड करें: DC-2 में मौजूद बाकी तीन Cassandra नोड को अपग्रेड करें. यह रोलबैक का नया चेकपॉइंट बन जाता है.
  5. अन्य कॉम्पोनेंट अपग्रेड करें: सभी डेटा सेंटर में, मैनेजमेंट, रनटाइम, और Analytics नोड को हमेशा की तरह अपग्रेड करें. एक बार में एक नोड और एक डेटा सेंटर को अपग्रेड करें. अगर कोई समस्या आती है, तो चरण 4 पर वापस जाया जा सकता है.

Cassandra को अपग्रेड करने की ज़रूरी शर्तें

आपके पास Cassandra 3.11.16 के साथ Edge for Private Cloud 4.52.02 होना चाहिए. साथ ही, यह पक्का करें कि:
  1. पूरा क्लस्टर चालू है और Cassandra 3.11.16 के साथ पूरी तरह से काम कर रहा है.
  2. कंपैक्शन की रणनीति को LeveledCompactionStrategy पर सेट किया गया है. यह वर्शन 4.52.02 पर अपग्रेड करने के लिए ज़रूरी है.

  3. पुष्टि करें कि नीचे दिया गया हर चरण, Edge for Private Cloud 4.52.02 में Cassandra 3.11 के शुरुआती अपग्रेड के दौरान पूरा किया गया हो.

    • पिछले अपग्रेड के दौरान, हर Cassandra नोड पर post_upgrade कमांड को लागू किया गया था
    • पिछले अपग्रेड के दौरान, drop_old_tables कमांड को पूरे Cassandra क्लस्टर पर लागू किया गया था.

अगर आपको पक्का नहीं है कि Edge for Private Cloud 4.52.02 का इस्तेमाल करते समय, Cassandra 3.11 पर post_upgrade और drop_old_tables कमांड एक्ज़ीक्यूट की गई थीं, तो 4.53.01 पर अपग्रेड करने से पहले, उन्हें फिर से चलाया जा सकता है.

पहला चरण: अपग्रेड करने की तैयारी करना

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

  1. Apigee का इस्तेमाल करके Cassandra का बैकअप लें.
  2. अगर हो सके, तो Cassandra नोड के वीएम स्नैपशॉट लें.
  3. अगर पोर्ट 9042 पहले से कॉन्फ़िगर नहीं किया गया है, तो पक्का करें कि यह Edge for Private Cloud के सभी कॉम्पोनेंट से ऐक्सेस किया जा सकता हो. जैसे, मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राउटर, Qpid, और Postgres से Cassandra नोड तक. ज़्यादा जानकारी के लिए, पोर्ट से जुड़ी ज़रूरी शर्तें देखें.

दूसरा चरण: सभी Cassandra नोड अपग्रेड करना

हर डेटा सेंटर में, सभी Cassandra नोड को एक-एक करके अपडेट किया जाना चाहिए. साथ ही, एक बार में सिर्फ़ एक डेटा सेंटर को अपडेट किया जाना चाहिए. किसी डेटा सेंटर में मौजूद नोड को अपग्रेड करने के बीच कुछ मिनट इंतज़ार करें. इससे यह पक्का किया जा सकेगा कि अपडेट किया गया नोड पूरी तरह से शुरू हो गया है और क्लस्टर में शामिल हो गया है. इसके बाद ही, उसी डेटा सेंटर में मौजूद किसी दूसरे नोड को अपग्रेड करने की प्रोसेस शुरू करें.

किसी डेटा सेंटर में मौजूद सभी Cassandra नोड अपग्रेड करने के बाद, कुछ समय (30 मिनट से लेकर कुछ घंटे) तक इंतज़ार करें. इसके बाद, अगले डेटा सेंटर में मौजूद नोड को अपग्रेड करें. इस दौरान, अपडेट किए गए डेटा सेंटर की अच्छी तरह से समीक्षा करें. साथ ही, यह पक्का करें कि आपके Apigee क्लस्टर की परफ़ॉर्मेंस और काम करने से जुड़ी मेट्रिक में कोई बदलाव न हुआ हो. यह चरण इसलिए ज़रूरी है, ताकि यह पक्का किया जा सके कि जिस डेटा सेंटर में Cassandra को 4.0.X वर्शन पर अपग्रेड किया गया है वह स्टेबल रहे. वहीं, Apigee के बाकी कॉम्पोनेंट 4.52.02 वर्शन पर बने रहें.

  1. किसी Cassandra नोड को अपग्रेड करने के लिए, यह कमांड चलाएं: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. किसी नोड को अपडेट करने के बाद, आगे बढ़ने से पहले कुछ मान्यताओं को पूरा करने के लिए, नोड पर यह निर्देश चलाएं: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. ऊपर दिए गए कोड का आउटपुट कुछ इस तरह होगा: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.18 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. Cassandra नोड पर, यह post_upgrade कमांड चलाएं: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. Cassandra नोड पर इंडेक्स फिर से बनाने के लिए, यहां दिए गए nodetool कमांड चलाएं: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     अगर कमाई करने की सुविधा का इस्तेमाल किया जा रहा है, तो कमाई करने की सुविधा से जुड़े कीस्पेस के लिए, यहां दी गई रीबिल्ड इंडेक्स कमांड भी चलाएं: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

तीसरा चरण: सभी मैनेजमेंट नोड अपग्रेड करना

सभी क्षेत्रों में मौजूद सभी मैनेजमेंट नोड को एक-एक करके अपग्रेड करें:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

चौथा चरण: सभी रनटाइम नोड अपग्रेड करना

सभी क्षेत्रों में मौजूद सभी राऊटर और मैसेज प्रोसेसर नोड को एक-एक करके अपग्रेड करें:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

पांचवां चरण: Edge for Private Cloud 4.53.01 के बाकी सभी कॉम्पोनेंट अपग्रेड करना

सभी इलाकों में मौजूद, बाकी बचे हुए edge-qpid-server और edge-postgres-server नोड को एक-एक करके अपग्रेड करें.

Zookeeper 3.8.4 पर अपग्रेड करना ज़रूरी है

Edge for Private Cloud की इस रिलीज़ में, Zookeeper को 3.8.4 वर्शन पर अपग्रेड किया गया है. अपग्रेड के दौरान, Zookeeper का सारा डेटा Zookeeper 3.8.4 पर माइग्रेट कर दिया जाएगा.

Zookeeper को अपग्रेड करने से पहले, Zookeeper के रखरखाव से जुड़ी गाइड पढ़ें. ज़्यादातर Edge प्रोडक्शन सिस्टम, Zookeeper नोड के क्लस्टर का इस्तेमाल करते हैं. ये नोड, कई डेटा सेंटर में फैले होते हैं. इनमें से कुछ नोड को वोट देने वालों के तौर पर कॉन्फ़िगर किया जाता है. ये Zookeeper लीडर के चुनाव में हिस्सा लेते हैं. बाकी नोड को ऑब्ज़र्वर के तौर पर कॉन्फ़िगर किया जाता है. ज़्यादा जानकारी के लिए, लीडर, फ़ॉलोअर, वोट देने वाले, और ऑब्ज़र्वर के बारे में जानकारी लेख पढ़ें. वोटर नोड, एक लीडर चुनते हैं. इसके बाद, वोटर नोड खुद फ़ॉलोअर बन जाते हैं.

अपडेट की प्रोसेस के दौरान, लीडर नोड बंद होने पर, Zookeeper में कुछ समय के लिए देरी हो सकती है या डेटा नहीं लिखा जा सकता. इससे मैनेजमेंट से जुड़ी उन कार्रवाइयों पर असर पड़ सकता है जो Zookeeper में लिखती हैं. जैसे, प्रॉक्सी को डिप्लॉय करने की कार्रवाई और Apigee के इन्फ़्रास्ट्रक्चर में किए गए बदलाव. जैसे, मैसेज प्रोसेसर को जोड़ना या हटाना वगैरह. Zookeeper को अपग्रेड करते समय, Apigee के रनटाइम एपीआई पर कोई असर नहीं पड़ना चाहिए. हालांकि, ऐसा तब होगा, जब ये रनटाइम एपीआई, मैनेजमेंट एपीआई को कॉल न करें. इसके लिए, नीचे दी गई प्रक्रिया का पालन करें.

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

बैकअप लेना

अगर रोलबैक करने की ज़रूरत पड़ती है, तो इस्तेमाल करने के लिए Zookeeper के सभी नोड का बैकअप लें. ध्यान दें कि रोलबैक करने पर, Zookeeper को उस स्थिति में वापस लाया जाएगा जब बैकअप लिया गया था. ध्यान दें: बैकअप लेने के बाद से, Apigee में किए गए किसी भी डिप्लॉयमेंट या बुनियादी ढांचे में किए गए बदलावों की जानकारी Zookeeper में सेव होती है. इसलिए, डेटा को वापस लाने के दौरान यह जानकारी मिट जाएगी. 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

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

लीडर, फ़ॉलोअर, और ऑब्ज़र्वर की पहचान करना

ध्यान दें: यहां दी गई सैंपल कमांड, Zookeeper को डेटा भेजने के लिए nc यूटिलिटी का इस्तेमाल करती हैं. Zookeeper को डेटा भेजने के लिए, अन्य यूटिलिटी का इस्तेमाल भी किया जा सकता है.

  1. अगर यह ZooKeeper नोड पर इंस्टॉल नहीं है, तो nc इंस्टॉल करें: 
      sudo yum install nc
  2. नोड पर यह nc कमांड चलाएं. इसमें 2181, ZooKeeper पोर्ट है: 
      echo stat | nc localhost 2181

    आपको इस तरह का आउटपुट दिखेगा:

      Zookeeper version: 3.8.4-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

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

  3. हर ZooKeeper नोड पर, पहले और दूसरे चरण को दोहराएं.

ऑब्ज़र्वर और फ़ॉलोअर नोड पर Zookeeper को अपग्रेड करें

ऑब्ज़र्वर और फ़ॉलोअर नोड, दोनों पर Zookeeper को इस तरह अपग्रेड करें:

  1. Edge for Private Cloud 4.53.01 का बूटस्ट्रैप डाउनलोड करें और उसे चलाएं. इसके बारे में बाहरी इंटरनेट कनेक्शन वाले नोड पर 4.53.01 वर्शन पर अपडेट करना लेख में बताया गया है. यह प्रोसेस, इस बात पर निर्भर करती है कि नोड में इंटरनेट कनेक्शन है या नहीं. इसके अलावा, यह इस बात पर भी निर्भर करती है कि ऑफ़लाइन इंस्टॉलेशन किया जा रहा है या नहीं.
  2. Zookeeper कॉम्पोनेंट को अपग्रेड करें: 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
     ध्यान दें: अगर इन नोड पर अन्य कॉम्पोनेंट इंस्टॉल किए गए हैं (जैसे कि Cassandra), तो अब उन्हें भी अपग्रेड किया जा सकता है. जैसे, cs,zk प्रोफ़ाइल के साथ या अन्य कॉम्पोनेंट को बाद में अपग्रेड किया जा सकता है. Apigee का सुझाव है कि आप सबसे पहले सिर्फ़ Zookeeper को अपग्रेड करें. साथ ही, यह पक्का करें कि आपका क्लस्टर ठीक से काम कर रहा हो. इसके बाद ही, अन्य कॉम्पोनेंट अपग्रेड करें.
  3. Zookeeper के हर ऑब्ज़र्वर और फ़ॉलोअर नोड पर, ऊपर दिया गया तरीका दोहराएं.

लीडर को बंद करना

सभी ऑब्ज़र्वर और फ़ॉलोअर नोड अपग्रेड हो जाने के बाद, लीडर को बंद करें. लीडर के तौर पर पहचाने गए नोड पर, यहां दिया गया निर्देश चलाएं: 

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

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

पुष्टि करें कि नए लीडर को चुन लिया गया है

ऊपर दिए गए लीडर, फ़ॉलोअर, और ऑब्ज़र्वर की पहचान करना सेक्शन में दिए गए तरीके का इस्तेमाल करके, पुष्टि करें कि मौजूदा लीडर के बंद होने के बाद, फ़ॉलोअर में से किसी नए लीडर को चुना गया हो. ध्यान दें कि लीडर को मौजूदा लीडर से अलग डेटा सेंटर में चुना जा सकता है.

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

ऊपर दिए गए ऑब्ज़र्वर और फ़ॉलोअर नोड पर Zookeeper को अपग्रेड करना में बताया गया तरीका अपनाएं.

जब पुराने लीडर नोड को भी अपग्रेड कर दिया जाए, तब क्लस्टर की स्थिति की पुष्टि करें. साथ ही, यह पक्का करें कि कोई लीडर नोड मौजूद हो.

Edge-Router में Nginx 1.26 को अपग्रेड किया गया

Edge for Private Cloud के पिछले वर्शन से 4.53.01 पर अपग्रेड करने पर, Nginx सॉफ़्टवेयर अपने-आप नए वर्शन (1.26.x) पर अपग्रेड नहीं होता है. ऐसा इसलिए किया गया है, ताकि Apigee Edge 4.53.01 में Nginx 1.26 में हुए बदलावों की वजह से, रनटाइम पर कोई अनचाहा साइड इफ़ेक्ट न हो. पुष्टि हो जाने के बाद, Nginx को मैन्युअल तरीके से 1.20.x से 1.26.x पर अपग्रेड किया जा सकता है. मैन्युअल तरीके से अपग्रेड करने के लिए:

  1. पक्का करें कि एज-राउटर नोड में 4.53.01 वर्शन का नया सॉफ़्टवेयर हो

    /opt/apigee/apigee-service/bin/apigee-service edge-router version

  2. देखें कि Nginx का कौनसा वर्शन इस्तेमाल किया जा रहा है और उसकी पुष्टि करें

    /opt/nginx/sbin/nginx -V

    अगर Nginx का पुराना वर्शन इस्तेमाल किया जा रहा है, तो राउटर नोड पर Nginx को 1.26.X वर्शन पर अपग्रेड करने के लिए, यहां दिया गया तरीका अपनाएं.

  3. राऊटर नोड पर एज-राऊटर की प्रोसेस बंद करें

    /opt/apigee/apigee-service/bin/apigee-service edge-router stop

  4. राउटर नोड पर nginx सॉफ़्टवेयर को अपग्रेड करना

    dnf update apigee-nginx

  5. पुष्टि करें कि Nginx का वर्शन अपडेट हो गया है

    /opt/nginx/sbin/nginx -V

  6. नोड पर राऊटर प्रोसेस शुरू करें

    /opt/apigee/apigee-service/bin/apigee-service edge-router start

  7. हर राऊटर नोड पर, एक-एक करके इस प्रोसेस को दोहराएं

Postgres 17 पर अपग्रेड करना ज़रूरी है

Edge के इस वर्शन में, Postgres को 17वें वर्शन पर अपग्रेड किया गया है. इस अपग्रेड के तहत, सभी Postgres डेटा को Postgres 17 पर माइग्रेट किया जाता है.

ज़्यादातर Edge प्रोडक्शन सिस्टम, मास्टर-स्टैंडबाय रेप्लिकेशन के लिए कॉन्फ़िगर किए गए दो Postgres नोड का इस्तेमाल करते हैं. अपडेट की प्रोसेस के दौरान, Postgres नोड अपडेट के लिए बंद होते हैं. हालांकि, इस दौरान भी Qpid नोड में आंकड़ों का डेटा लिखा जाता है. Postgres नोड अपडेट होने और वापस ऑनलाइन होने के बाद, Analytics का डेटा Postgres नोड पर भेज दिया जाता है.

Postgres को अपडेट करने का तरीका इस बात पर निर्भर करता है कि आपने Postgres नोड के लिए डेटा स्टोरेज को कैसे कॉन्फ़िगर किया है:

  • अगर Postgres नोड के लिए लोकल डेटा स्टोरेज का इस्तेमाल किया जाता है, तो आपको अपग्रेड की अवधि के लिए, नया Postgres स्टैंडबाय नोड इंस्टॉल करना होगा. अपग्रेड पूरा होने के बाद, नए Postgres स्टैंडबाय नोड को बंद किया जा सकता है.

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

    Edge के 1-नोड और 2-नोड कॉन्फ़िगरेशन में, प्रोटोटाइपिंग और टेस्टिंग के लिए इस्तेमाल की जाने वाली टोपोलॉजी में, आपके पास सिर्फ़ एक Postgres नोड होता है. आपको नया Postgres नोड बनाने की ज़रूरत नहीं है. इन Postgres नोड को सीधे अपडेट किया जा सकता है.

  • अगर आपने Postgres नोड के लिए नेटवर्क स्टोरेज का इस्तेमाल किया है, तो आपको नया Postgres नोड इंस्टॉल करने की ज़रूरत नहीं है. Apigee भी यही सुझाव देता है. नीचे दी गई प्रक्रियाओं में, उन चरणों को छोड़ा जा सकता है जिनमें नए Postgres स्टैंडबाय नोड को इंस्टॉल करने और बाद में बंद करने के बारे में बताया गया है.

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

नया Postgres स्टैंडबाय नोड इंस्टॉल करना

इस प्रोसेस से, नए नोड पर Postgres का स्टैंडबाय सर्वर बनता है. पक्का करें कि आपने Edge के मौजूदा वर्शन (4.52.02 या 4.53.00) के लिए, Postgres का नया स्टैंडबाय सर्वर इंस्टॉल किया हो. 4.53.01 वर्शन के लिए नहीं.

इंस्टॉल करने के लिए, उसी कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करें जिसका इस्तेमाल आपने Edge के मौजूदा वर्शन को इंस्टॉल करने के लिए किया था.

नया Postgres स्टैंडबाय नोड बनाने के लिए:

  1. मौजूदा Postgres मास्टर पर, /opt/apigee/customer/application/postgresql.properties फ़ाइल में बदलाव करके, यह टोकन सेट करें. अगर वह फ़ाइल मौजूद नहीं है, तो उसे बनाएं: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    यहां existing_standby_ip, मौजूदा Postgres स्टैंडबाय सर्वर का आईपी पता है और new_standby_ip, नए स्टैंडबाय नोड का आईपी पता है.

  2. Postgres मास्टर पर apigee-postgresql को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. पुष्टि करें कि नया स्टैंडबाय नोड जोड़ा गया है. इसके लिए, मास्टर पर मौजूद /opt/apigee/apigee-postgresql/conf/pg_hba.conf फ़ाइल देखें. आपको उस फ़ाइल में ये लाइनें दिखनी चाहिए: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. नया Postgres स्टैंडबाय सर्वर इंस्टॉल करें:
    1. Edge के मौजूदा वर्शन को इंस्टॉल करने के लिए इस्तेमाल की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करें. इसके लिए, आपको यह जानकारी देनी होगी: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Edge apigee-setup यूटिलिटी इंस्टॉल करें में दिए गए तरीके से, SELinux बंद करें.

    3. अगर फ़िलहाल, Edge 4.52.02 का इस्तेमाल किया जा रहा है, तो:

      1. Edge की bootstrap_4.52.02.sh फ़ाइल को /tmp/bootstrap_4.52.02.sh में डाउनलोड करें: 
        curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.51.00.sh
      2. Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें: 
        sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      अगर फ़िलहाल, Edge 4.53.00 का इस्तेमाल किया जा रहा है, तो:

      1. Edge bootstrap_4.53.00.sh फ़ाइल को /tmp/bootstrap_4.53.00.sh पर डाउनलोड करें: 
        curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      2. Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें: 
        sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
    4. apigee-setup यूटिलिटी इंस्टॉल करने के लिए, apigee-service का इस्तेमाल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. Postgres इंस्टॉल करें: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. नए स्टैंडबाय नोड पर, यह कमांड चलाएं: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      पुष्टि करें कि यह स्टैंडबाय है.

Postgres को उसी जगह पर अपग्रेड करना

ध्यान दें: Postgres को अपग्रेड करने से पहले, आपको यह शुरुआती चरण पूरा करना होगा.

शुरुआती चरण

Postgres को इन-प्लेस अपग्रेड करने से पहले, मास्टर होस्ट और स्टैंडबाय, दोनों पर यह तरीका अपनाएं. इससे apigee-postgresql पर max_locks_per_transaction प्रॉपर्टी अपडेट हो जाएगी:

  1. अगर यह फ़ाइल मौजूद नहीं है, तो /opt/apigee/customer/application/postgresql.properties फ़ाइल बनाएं.
  2. इस फ़ाइल का मालिकाना हक apigee को ट्रांसफ़र करें: 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. फ़ाइल में यह प्रॉपर्टी जोड़ें: 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. apigee-postgresql को कॉन्फ़िगर करें: 
    apigee-service apigee-postgresql configure
  5. apigee-postgresql को रीस्टार्ट करें: 
    apigee-service apigee-postgresql restart

इन-प्लेस अपग्रेड करना

Postgres 17 पर इन-प्लेस अपग्रेड करने के लिए, यह तरीका अपनाएं:

  1. मास्टर होस्ट पर Postgres को अपग्रेड करना 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. मास्टर होस्ट पर सेटअप कमांड चलाएं: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. मास्टर होस्ट पर, कॉन्फ़िगर कमांड चलाएं: 
    apigee-service apigee-postgresql configure
  4. मास्टर होस्ट को रीस्टार्ट करें: 
    apigee-service apigee-postgresql restart
  5. इसे मास्टर के तौर पर कॉन्फ़िगर करें: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. पक्का करें कि मास्टर होस्ट ने सेशन शुरू कर दिया हो: 
    apigee-service apigee-postgresql wait_for_ready
  7. स्टैंडबाय मोड बंद करने के लिए: 
    apigee-service apigee-postgresql stop
  8. स्टैंडबाय डिवाइस को अपग्रेड करें.

    ध्यान दें: अगर इस चरण में कोई गड़बड़ी होती है या यह पूरा नहीं होता है, तो इसे अनदेखा किया जा सकता है. update.sh गलत कॉन्फ़िगरेशन के साथ स्टैंड-बाय सर्वर शुरू करने की कोशिश करेगा. अगर Postgres के इंस्टॉलेशन को 17वें वर्शन पर अपग्रेड कर दिया गया है, तो इस गड़बड़ी को अनदेखा किया जा सकता है.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. पक्का करें कि स्टैंडबाय मोड बंद हो: 
    apigee-service apigee-postgresql stop
  10. स्टैंडबाय के पुराने कॉन्फ़िगरेशन को हटाएं: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. स्टैंडबाय सर्वर पर रेप्लिकेशन सेट अप करें: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
  12. मास्टर होस्ट और स्टैंडबाय, दोनों पर मौजूद फ़ाइल /opt/apigee/customer/application/postgresql.properties से लाइन conf/postgresql.conf+max_locks_per_transaction=30000 हटाएं. यह लाइन शुरुआती चरण में जोड़ी गई थी.

यह तरीका पूरा करने के बाद, स्टैंडबाय मोड चालू हो जाएगा.

Postgres नोड को बंद करना

अपडेट पूरा होने के बाद, नए स्टैंडबाय नोड को बंद करें:

  1. पक्का करें कि Postgres चल रहा हो: 
    /opt/apigee/apigee-service/bin/apigee-all status

    अगर Postgres चालू नहीं है, तो इसे चालू करें: 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. नए स्टैंडबाय नोड पर, यहां दी गई curl कमांड चलाकर, नए स्टैंडबाय नोड का यूयूआईडी पाएं: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    आपको आउटपुट के आखिर में नोड का यूयूआईडी दिखेगा. यह इस फ़ॉर्मैट में होगा: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. नए स्टैंडबाय नोड पर यह कमांड चलाकर, नए स्टैंडबाय नोड को बंद करें: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Postgres के मास्टर नोड पर, /opt/apigee/customer/application/postgresql.properties में बदलाव करके, conf_pg_hba_replication.connection से नए स्टैंडबाय नोड को हटाएं: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. Postgres मास्टर पर apigee-postgresql को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. मास्टर पर मौजूद /opt/apigee/apigee-postgresql/conf/pg_hba.conf फ़ाइल देखकर पुष्टि करें कि नया स्टैंडबाय नोड हटा दिया गया है. आपको उस फ़ाइल में सिर्फ़ यह लाइन दिखनी चाहिए: 
    host replication apigee existing_standby_ip/32 trust
  7. स्टैंडबाय नोड के यूयूआईडी को ZooKeeper से मिटाएं. इसके लिए, मैनेजमेंट सर्वर नोड पर Edge मैनेजमेंट API का यह कॉल करें: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

Postgres को अपग्रेड करने के बाद के चरण

Postgres को अपग्रेड करने के बाद, Postgres के इंटरनल आंकड़े मिट जाते हैं. इन आंकड़ों से, Postgres क्वेरी प्लानर को क्वेरी चलाने के लिए सबसे सही इंडेक्स और पाथ का इस्तेमाल करने में मदद मिलती है.

क्वेरी के एक्ज़ीक्यूट होने और autovacuum daemon के चलने पर, Postgres समय के साथ धीरे-धीरे अपने आंकड़ों को फिर से बना सकता है. हालांकि, जब तक आंकड़ों को फिर से नहीं बनाया जाता, तब तक आपकी क्वेरी प्रोसेस होने में समय लग सकता है.

इस समस्या को ठीक करने के लिए, मास्टर Postgres नोड पर डेटाबेस की सभी टेबल में ANALYZE को लागू करें. इसके अलावा, एक साथ कुछ टेबल के लिए ANALYZE को लागू किया जा सकता है.

ANALYZE

Apigee SSO को पुराने वर्शन से अपडेट करने का तरीका

Edge for Private Cloud 4.53.01 में, apigee-sso कॉम्पोनेंट में इस्तेमाल की गई आईडीपी कुंजियों और सर्टिफ़िकेट को अब कीस्टोर के ज़रिए कॉन्फ़िगर किया जाता है. आपको पहले इस्तेमाल की गई कुंजी और सर्टिफ़िकेट को कीस्टोर में एक्सपोर्ट करना होगा. इसके बाद, इसे कॉन्फ़िगर करें. इसके बाद, एसएसओ को सामान्य तरीके से अपडेट करें.

  1. आईडीपी को कॉन्फ़िगर करने के लिए इस्तेमाल की गई मौजूदा कुंजी और सर्टिफ़िकेट की पहचान करें:

    1. एसएसओ इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में SSO_SAML_SERVICE_PROVIDER_CERTIFICATE की वैल्यू देखकर सर्टिफ़िकेट पाएं. इसके अलावा, conf_login_service_provider_certificate के लिए apigee-sso कॉम्पोनेंट से क्वेरी करके भी सर्टिफ़िकेट पाया जा सकता है.

      एसएसओ नोड पर, आईडीपी सर्टिफ़िकेट पाथ के लिए क्वेरी करने के लिए, यहां दिया गया निर्देश इस्तेमाल करें.apigee-sso आउटपुट में, आखिरी लाइन में मौजूद वैल्यू देखें. 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. एसएसओ इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में SSO_SAML_SERVICE_PROVIDER_KEY की वैल्यू देखकर या conf_login_service_provider_key के लिए apigee-sso कॉम्पोनेंट से क्वेरी करके, कुंजी वापस पाएं.

      आईडीपी के कुंजी पाथ के लिए apigee-sso से क्वेरी करने के लिए, एसएसओ नोड पर इस निर्देश का इस्तेमाल करें. आउटपुट में, आखिरी लाइन में मौजूद वैल्यू देखें.

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. कुंजी और सर्टिफ़िकेट को कीस्टोर में एक्सपोर्ट करें:
    1. कुंजी और सर्टिफ़िकेट को PKCS12 कीस्टोर में एक्सपोर्ट करें: 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      पैरामीटर:

      • certificate_path: पहले चरण में वापस लाई गई सर्टिफ़िकेट फ़ाइल का पाथ.
      • key_path: पहले चरण के 1.b में वापस लाई गई निजी पासकोड फ़ाइल का पाथ.
      • keystore_path: सर्टिफ़िकेट और निजी कुंजी वाले नए कीस्टोर का पाथ.
      • alias: कीस्टोर में मौजूद कुंजी और सर्टिफ़िकेट के जोड़े के लिए इस्तेमाल किया गया उपनाम.

      ज़्यादा जानकारी के लिए, OpenSSL का दस्तावेज़ देखें.

    2. (ज़रूरी नहीं) PKCS12 से JKS कीस्टोर में कुंजी और सर्टिफ़िकेट एक्सपोर्ट करें: 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      पैरामीटर:

      • PKCS12_keystore_path: यह चरण 2.a में बनाई गई PKCS12 कीस्टोर का पाथ है. इसमें सर्टिफ़िकेट और पासकोड होता है.
      • destination_keystore_path: नए JKS कीस्टोर का पाथ, जहां सर्टिफ़िकेट और कुंजी एक्सपोर्ट की जाएगी.
      • alias: JKS कीस्टोर में, कुंजी और सर्टिफ़िकेट के जोड़े के लिए इस्तेमाल किया गया उपनाम.

      3. ज़्यादा जानकारी के लिए, keytool दस्तावेज़ देखें.

  3. आउटपुट कीस्टोर फ़ाइल के मालिक को "apigee" उपयोगकर्ता में बदलें: 
    sudo chown apigee:apigee <keystore_file>
  4. Apigee SSO कॉन्फ़िगरेशन फ़ाइल में यहां दी गई प्रॉपर्टी जोड़ें. साथ ही, उन्हें कीस्टोर फ़ाइल पाथ, पासवर्ड, कीस्टोर टाइप, और एलियास से अपडेट करें: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. एसएसओ नोड पर Apigee SSO सॉफ़्टवेयर को हमेशा की तरह अपडेट करें. इसके लिए, यह निर्देश इस्तेमाल करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

Edge का नया यूज़र इंटरफ़ेस

इस सेक्शन में, Edge यूज़र इंटरफ़ेस (यूआई) से जुड़ी बातों के बारे में बताया गया है. ज़्यादा जानकारी के लिए, Private Cloud के लिए नया Edge यूज़र इंटरफ़ेस (यूआई) लेख पढ़ें.

Edge UI इंस्टॉल करना

शुरुआती इंस्टॉलेशन पूरा करने के बाद, Apigee का सुझाव है कि आप Edge UI इंस्टॉल करें. यह Apigee Edge for Private Cloud के डेवलपर और एडमिन के लिए बेहतर यूज़र इंटरफ़ेस है.

ध्यान दें कि Edge यूज़र इंटरफ़ेस (यूआई) के लिए, आपको सामान्य पुष्टि करने की सुविधा बंद करनी होगी. साथ ही, SAML या LDAP जैसे IDP का इस्तेमाल करना होगा.

ज़्यादा जानकारी के लिए, Edge के नए यूज़र इंटरफ़ेस (यूआई) को इंस्टॉल करना लेख पढ़ें.

Apigee mTLS की मदद से अपडेट करना

Apigee mTLS को अपडेट करने के लिए , यह तरीका अपनाएं: चरण:

अपडेट को पहले जैसा करना

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

अगर अपडेट को पिछले वर्शन पर रोल बैक करना ज़रूरी है, तो ज़्यादा जानकारी के लिए 4.53.01 वर्शन को रोल बैक करना लेख पढ़ें.

अपडेट की जानकारी लॉग करना

डिफ़ॉल्ट रूप से, update.sh यूटिलिटी, लॉग की जानकारी यहां लिखती है:

/opt/apigee/var/log/apigee-setup/update.log

अगर update.sh यूटिलिटी चलाने वाले व्यक्ति के पास उस डायरेक्ट्री का ऐक्सेस नहीं है, तो यह /tmp डायरेक्ट्री में लॉग को update_username.log नाम की फ़ाइल के तौर पर लिखता है.

अगर व्यक्ति के पास /tmp का ऐक्सेस नहीं है, तो update.sh यूटिलिटी काम नहीं करेगी.

बिना किसी रुकावट के अपडेट करना

ज़ीरो-डाउनटाइम अपडेट या रोलिंग अपडेट की मदद से, Edge को बंद किए बिना ही Edge के इंस्टॉलेशन को अपडेट किया जा सकता है.

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

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

  1. अपने इंस्टॉलेशन के लिए, मशीनों को सही क्रम में अपडेट करें. इसके बारे में मशीन अपडेट करने का क्रम में बताया गया है.
  2. जब राऊटर को अपडेट करने का समय हो, तो किसी एक राऊटर को चुनें और उसे ऐक्सेस न किया जा सके. इसके लिए, सर्वर (मैसेज प्रोसेसर/राऊटर) को ऐक्सेस करने की सुविधा चालू/बंद करना में दिए गए तरीके का इस्तेमाल करें.
  3. चुने गए राऊटर और राऊटर वाली मशीन पर मौजूद सभी अन्य Edge कॉम्पोनेंट को अपडेट करें. सभी Edge कॉन्फ़िगरेशन में, एक ही नोड पर राऊटर और मैसेज प्रोसेसर दिखता है.
  4. राऊटर को फिर से कनेक्ट करें.
  5. बाकी राऊटर के लिए, दूसरे से चौथे चरण तक की प्रक्रिया दोहराएं.
  6. अपने इंस्टॉलेशन में मौजूद बाकी मशीनों के लिए अपडेट जारी रखें.

अपडेट करने से पहले और बाद में, इन बातों का ध्यान रखें:

साइलेंट कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करना

आपको अपडेट कमांड में साइलेंट कॉन्फ़िगरेशन फ़ाइल पास करनी होगी. साइलेंट कॉन्फ़िगरेशन फ़ाइल वही होनी चाहिए जिसका इस्तेमाल आपने Edge for Private Cloud 4.52.02 या 4.53.00 को इंस्टॉल करने के लिए किया था.

बाहरी इंटरनेट कनेक्शन वाले नोड पर 4.53.01 वर्शन पर अपडेट करें

किसी नोड पर Edge कॉम्पोनेंट अपडेट करने के लिए, यह तरीका अपनाएं:

  1. अगर मौजूद है, तो अपडेट पूरा होने तक Cassandra पर मरम्मत की कार्रवाई करने के लिए कॉन्फ़िगर किए गए किसी भी cron जॉब को बंद करें.
  2. Edge RPM इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
  3. Edge apigee-setup यूटिलिटी इंस्टॉल करें में दिए गए तरीके से, SELinux को बंद करें.
  4. अगर आपको AWS पर इंस्टॉल करना है, तो यहां दी गई yum-configure-manager कमांड लागू करें: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  5. अगर फ़िलहाल आपके पास Edge 4.52.02 या 4.53.00 है, तो:

    1. Edge bootstrap_4.53.01.sh फ़ाइल को /tmp/bootstrap_4.53.01.sh में डाउनलोड करें: 
      curl https://software.apigee.com/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh
    2. Edge 4.53.01 apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करने के लिए, यह कमांड चलाएं: 
      sudo bash /tmp/bootstrap_4.53.01.sh apigeeuser=uName apigeepassword=pWord

      यहां uName:pWord, Apigee से मिला उपयोगकर्ता नाम और पासवर्ड है. अगर आपने pWord नहीं डाला है, तो आपको इसे डालने के लिए कहा जाएगा.

      डिफ़ॉल्ट रूप से, इंस्टॉलर यह जांच करता है कि आपके पास Java 1.8 इंस्टॉल है या नहीं. अगर ऐसा नहीं किया जाता है, तो इंस्टॉलर इसे आपके लिए इंस्टॉल कर देगा.

      JAVA_FIX विकल्प का इस्तेमाल करके, यह तय करें कि Java इंस्टॉलेशन को कैसे मैनेज करना है. JAVA_FIX की ये वैल्यू होती हैं:

      • I: OpenJDK 1.8 (डिफ़ॉल्ट) इंस्टॉल करें.
      • C: Java इंस्टॉल किए बिना जारी रखें.
      • Q: छोड़ें. इस विकल्प के लिए, आपको Java को खुद इंस्टॉल करना होगा.
    3. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें. इसका उदाहरण यहां दिया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें. इसका उदाहरण यहां दिया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. मैनेजमेंट सर्वर पर apigee-provision यूटिलिटी को अपडेट करें. इसका उदाहरण यहां दिया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. अपने नोड पर update यूटिलिटी चलाने के लिए, यह कमांड चलाएं: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      मशीन अपडेट करने का क्रम में बताए गए क्रम के हिसाब से अपडेट करें.

      कहां:

      • component, Edge का वह कॉम्पोनेंट है जिसे अपडेट करना है. इन वैल्यू का इस्तेमाल किया जा सकता है:
        • cs: Cassandra
        • edge: Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, QPID सर्वर, Postgres सर्वर
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (अगर आपने एसएसओ इंस्टॉल किया है)
        • ue: Edge का नया यूज़र इंटरफ़ेस (यूआई)
        • ui: क्लासिक Edge यूज़र इंटरफ़ेस
        • zk: चिड़ियाघर का कर्मचारी
      • configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.52.02 या 4.53.00 वर्शन इंस्टॉल करते समय, अपने Edge कॉम्पोनेंट तय करने के लिए किया था.

      component को "all" पर सेट करके, सभी कॉम्पोनेंट के लिए update.sh चलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge all-in-one (AIO) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. अगर आपने अब तक ऐसा नहीं किया है, तो Edge UI के कॉम्पोनेंट चलाने वाले सभी नोड पर, उन्हें रीस्टार्ट करें: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. इंस्टॉल की जांच करना में बताए गए तरीके से, मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर अपडेट की जांच करें.

अगर आपको बाद में अपडेट को पहले जैसा करना है, तो 4.53.01 को पहले जैसा करें में बताई गई प्रोसेस का इस्तेमाल करें.

लोकल रेपो से 4.53.01 पर अपडेट करें

अगर आपके Edge नोड फ़ायरवॉल के पीछे हैं या किसी अन्य वजह से उन्हें इंटरनेट पर Apigee रिपॉज़िटरी को ऐक्सेस करने की अनुमति नहीं है, तो Apigee रिपॉज़िटरी की लोकल रिपॉज़िटरी या मिरर से अपडेट किया जा सकता है.

Edge की लोकल रिपॉज़िटरी बनाने के बाद, आपके पास लोकल रिपॉज़िटरी से Edge को अपडेट करने के दो विकल्प होते हैं:

  • रिपो की .tar फ़ाइल बनाएं. इसके बाद, .tar फ़ाइल को किसी नोड पर कॉपी करें. इसके बाद, .tar फ़ाइल से Edge को अपडेट करें.
  • लोकल रेपो वाले नोड पर वेबसर्वर इंस्टॉल करें, ताकि अन्य नोड इसे ऐक्सेस कर सकें. Apigee, Nginx वेबसर्वर का इस्तेमाल करने की सुविधा देता है. इसके अलावा, आपके पास अपने वेबसर्वर का इस्तेमाल करने का विकल्प भी होता है.

लोकल 4.53.01 रेपो से अपडेट करने के लिए:

  1. Edge apigee-setup यूटिलिटी इंस्टॉल करें में "Apigee की लोकल रिपॉज़िटरी बनाएं" में बताए गए तरीके से, लोकल 4.53.01 रिपो बनाएं.
  2. .tar फ़ाइल से apigee-service इंस्टॉल करने के लिए:
    1. लोकल रिपॉज़िटरी वाले नोड पर, लोकल रिपॉज़िटरी को /opt/apigee/data/apigee-mirror/apigee-4.53.01.tar.gz नाम की एक .tar फ़ाइल में पैकेज करने के लिए, यह कमांड इस्तेमाल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. .tar फ़ाइल को उस नोड पर कॉपी करें जहां आपको Edge को अपडेट करना है. उदाहरण के लिए, इसे नए नोड पर मौजूद /tmp डायरेक्ट्री में कॉपी करें.
    3. नए नोड पर, फ़ाइल को /tmp डायरेक्ट्री में अनटार करें: 
      tar -xzf apigee-4.53.01.tar.gz

      इस कमांड से, .tar फ़ाइल वाली डायरेक्ट्री में repos नाम की एक नई डायरेक्ट्री बन जाती है. उदाहरण के लिए /tmp/repos.

    4. Edge apigee-service यूटिलिटी और डिपेंडेंसी को /tmp/repos से इंस्टॉल करें: 
      sudo bash /tmp/repos/bootstrap_4.53.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      ध्यान दें कि इस कमांड में, repos डायरेक्ट्री का पाथ शामिल किया गया है.

  3. Nginx वेबसर्वर का इस्तेमाल करके apigee-service इंस्टॉल करने के लिए:
    1. Nginx वेब सर्वर को कॉन्फ़िगर करें. इसके लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करना में जाकर, "Nginx वेबसर्वर का इस्तेमाल करके, रिपॉज़िटरी से इंस्टॉल करना" लेख पढ़ें.
    2. रिमोट नोड पर, Edge bootstrap_4.53.01.sh फ़ाइल को /tmp/bootstrap_4.53.01.sh में डाउनलोड करें: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.01.sh -o /tmp/bootstrap_4.53.01.sh

      यहां uName:pWord, रिपो के लिए पहले सेट किया गया उपयोगकर्ता नाम और पासवर्ड है. साथ ही, remoteRepo, रिपो नोड का आईपी पता या डीएनएस नाम है.

    3. रिमोट नोड पर, Edge apigee-setup यूटिलिटी और डिपेंडेंसी इंस्टॉल करें: 
      sudo bash /tmp/bootstrap_4.53.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      यहां uName:pWord, रिपो का उपयोगकर्ता नाम और पासवर्ड है.

  4. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें. इसका उदाहरण यहां दिया गया है: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें. इसका उदाहरण यहां दिया गया है: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. मैनेजमेंट सर्वर पर apigee-provision यूटिलिटी को अपडेट करें. इसका उदाहरण यहां दिया गया है: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. अपने नोड पर update यूटिलिटी को, मशीन अपडेट करने का क्रम में बताए गए क्रम के हिसाब से चलाएं: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    कहां:

    • component, Edge का वह कॉम्पोनेंट है जिसे अपडेट करना है. आम तौर पर, इन कॉम्पोनेंट को अपडेट किया जाता है:
      • cs: Cassandra
      • edge: Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, QPID सर्वर, Postgres सर्वर
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (अगर आपने एसएसओ इंस्टॉल किया है)
      • ue Edge का नया यूज़र इंटरफ़ेस (यूआई)
      • ui: क्लासिक Edge यूज़र इंटरफ़ेस
      • zk: चिड़ियाघर का कर्मचारी
    • configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.52.02 या 4.53.00 वर्शन इंस्टॉल करते समय, अपने Edge कॉम्पोनेंट तय करने के लिए किया था.

    component को "all" पर सेट करके, सभी कॉम्पोनेंट के लिए update.sh चलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge ऑल-इन-वन (एआईओ) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. अगर आपने अब तक ऐसा नहीं किया है, तो इसे चलाने वाले सभी नोड पर यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. इंस्टॉल की जांच करना में बताए गए तरीके से, मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर अपडेट की जांच करें.

अगर आपको बाद में अपडेट को पहले जैसा करना है, तो 4.53.01 को पहले जैसा करें में बताई गई प्रोसेस का इस्तेमाल करें.

मशीन अपडेट करने का क्रम

Edge इंस्टॉलेशन में मशीनों को अपडेट करने का क्रम अहम होता है:

  • किसी अन्य कॉम्पोनेंट को अपडेट करने से पहले, आपको सभी एलडीएपी नोड अपडेट करने होंगे. एलडीएपी को अपग्रेड करने के लिए, आपको खास चरणों का पालन करना होगा.
  • आपको सभी Cassandra और ZooKeeper नोड अपडेट करने होंगे. अगर आपको 4.52.02 से अपग्रेड करना है, तो cassandra को अपग्रेड करने के लिए, खास तरीके अपनाएं. 4.52.02 या 4.53.00 के लिए, आपको Zookeeper को अपग्रेड करने का खास तरीका अपनाना होगा.
  • सभी मैनेजमेंट सर्वर, राऊटर, और मैसेज प्रोसेसर को अपडेट करने के लिए, आपको उन्हें -c edge विकल्प का इस्तेमाल करके अपग्रेड करना होगा.
  • आपको Postgres को अपग्रेड करने के लिए, खास चरणों का पालन करके सभी Postgres नोड अपग्रेड करने होंगे.
  • आपको सभी डेटा सेंटर में, edge-qpid-server और edge-postgres-server कॉम्पोनेंट अपडेट करने होंगे.
  • आपको सभी Qpid नोड अपग्रेड करने होंगे.
  • आपको Edge UI नोड अपग्रेड करने होंगे. साथ ही, New Edge UI और एसएसओ नोड भी अपग्रेड करने होंगे. हालांकि, ऐसा तब करना होगा, जब ये नोड लागू हों.
  • कमाई करने की सुविधा को अपडेट करने के लिए, कोई अलग चरण नहीं है. -c एज विकल्प तय करने पर, इसे अपडेट किया जाता है.

एक नोड वाला स्टैंडअलोन अपग्रेड

एक नोड वाले स्टैंडअलोन कॉन्फ़िगरेशन को 4.53.01 पर अपग्रेड करने के लिए:

  1. सभी कॉम्पोनेंट अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (अगर आपने apigee-adminapi इंस्टॉल किया है) apigee-adminapi यूटिलिटी को अपडेट करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

दो नोड वाला स्टैंडअलोन अपग्रेड

दो नोड वाले स्टैंडअलोन इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. मशीन 1 पर LDAP अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. मशीन 1 पर Cassandra और ZooKeeper को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 1 पर Edge के कॉम्पोनेंट अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. मशीन 2 पर Postgres अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. मशीन 1 पर Edge के कॉम्पोनेंट अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. मशीन 2 पर Qpid को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (अगर आपने apigee-adminapi इंस्टॉल किया है) मशीन 1 पर apigee-adminapi यूटिलिटी को अपडेट किया गया: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (अगर आपने Apigee SSO इंस्टॉल किया है) मशीन 1 पर Apigee SSO को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ (SSO) इंस्टॉल करते समय बनाया था.

  10. मशीन 1 पर Edge यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

पांच नोड वाला अपग्रेड

पांच नोड वाले इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. मशीन 1 पर LDAP अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 1, 2, 3 पर Edge कॉम्पोनेंट अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. मशीन 4 पर Postgres को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. मशीन 5 पर Postgres को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. मशीन 4 और 5 पर Edge के कॉम्पोनेंट अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. मशीन 4 पर Qpid को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. मशीन 5 पर Qpid को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. Edge के यूज़र इंटरफ़ेस (यूआई) को अपडेट करें:
    • क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 1 पर ui कॉम्पोनेंट को अपडेट करें. उदाहरण के लिए: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • Edge का नया यूज़र इंटरफ़ेस (यूआई): अगर आपने Edge का नया यूज़र इंटरफ़ेस (यूआई) इंस्टॉल किया है, तो सही मशीन पर ue कॉम्पोनेंट को अपडेट करें. ऐसा हो सकता है कि यह मशीन 1 न हो: 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (अगर आपने apigee-adminapi इंस्टॉल किया है) मशीन 1 पर apigee-adminapi यूटिलिटी को अपडेट किया गया: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (अगर आपने Apigee SSO इंस्टॉल किया है) मशीन 1 पर Apigee SSO को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ (SSO) इंस्टॉल करते समय बनाया था.

  12. यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
    • क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 1 पर edge-ui कॉम्पोनेंट को रीस्टार्ट करें. जैसा कि इस उदाहरण में दिखाया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Edge का नया यूज़र इंटरफ़ेस (यूआई): अगर आपने Edge का नया यूज़र इंटरफ़ेस (यूआई) इंस्टॉल किया है, तो सही मशीन पर edge-management-ui कॉम्पोनेंट को रीस्टार्ट करें. ऐसा हो सकता है कि यह मशीन 1 न हो: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

नौ नोड वाले क्लस्टर को अपग्रेड करना

नौ नोड वाले क्लस्टर किए गए इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. मशीन 1 पर LDAP अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 1, 4, और 5 पर Edge कॉम्पोनेंट (मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर) को इस क्रम में अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. मशीन 8 पर Postgres को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. मशीन 9 पर Postgres को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. मशीन 6, 7, 8, और 9 पर Edge कॉम्पोनेंट को इस क्रम में अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. मशीन 6 और 7 पर Qpid अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. मशीन 1 पर, नए यूज़र इंटरफ़ेस (ue) या क्लासिक यूज़र इंटरफ़ेस (ui) को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (अगर आपने apigee-adminapi इंस्टॉल किया है) मशीन 1 पर apigee-adminapi यूटिलिटी को अपडेट करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (अगर आपने Apigee SSO इंस्टॉल किया है) मशीन 1 पर Apigee SSO को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ (SSO) इंस्टॉल करते समय बनाया था.

  11. यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
    • क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 1 पर edge-ui कॉम्पोनेंट को रीस्टार्ट करें. जैसा कि इस उदाहरण में दिखाया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Edge का नया यूज़र इंटरफ़ेस (यूआई): अगर आपने Edge का नया यूज़र इंटरफ़ेस (यूआई) इंस्टॉल किया है, तो सही मशीन पर edge-management-ui कॉम्पोनेंट को रीस्टार्ट करें. ऐसा हो सकता है कि यह मशीन 1 न हो: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

13 नोड वाले क्लस्टर को अपग्रेड करना

13 नोड वाले क्लस्टर किए गए इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. मशीन 4 और 5 पर एलडीएपी अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 6, 7, 10, और 11 पर Edge कॉम्पोनेंट को इस क्रम में अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. मशीन 8 पर Postgres को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. मशीन 9 पर Postgres को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. मशीन 12, 13, 8, और 9 पर Edge कॉम्पोनेंट को इस क्रम में अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. मशीन 12 और 13 पर Qpid को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. मशीन 6 और 7 पर, नए यूज़र इंटरफ़ेस (ue) या क्लासिक यूज़र इंटरफ़ेस (ui) को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (अगर आपने apigee-adminapi इंस्टॉल किया है) मशीन 6 और 7 पर apigee-adminapi यूटिलिटी अपडेट की गई: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (अगर आपने Apigee SSO इंस्टॉल किया है) मशीन 6 और 7 पर Apigee SSO को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ (SSO) इंस्टॉल करते समय बनाया था.

  11. यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
    • क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 6 और 7 पर edge-ui कॉम्पोनेंट को रीस्टार्ट करें. इसका तरीका यहां दिया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • Edge का नया यूज़र इंटरफ़ेस (यूआई): अगर आपने Edge का नया यूज़र इंटरफ़ेस (यूआई) इंस्टॉल किया है, तो मशीन 6 और 7 पर edge-management-ui कॉम्पोनेंट को रीस्टार्ट करें: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

12 नोड वाले क्लस्टर को अपग्रेड करना

12 नोड वाले क्लस्टर किए गए इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. LDAP अपडेट करें:
    1. डेटा सेंटर 1 में मौजूद मशीन 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. डेटा सेंटर 2 में मौजूद मशीन 7 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  2. Cassandra और ZooKeeper को अपडेट करें:
    1. डेटा सेंटर 1 में मौजूद मशीनें 1, 2, और 3: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. डेटा सेंटर 2 में मौजूद मशीनें 7, 8, और 9 पर: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Edge के कॉम्पोनेंट अपडेट करें:
    1. डेटा सेंटर 1 में मौजूद मशीन 1, 2, और 3 पर: 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. डेटा सेंटर 2 में मौजूद मशीनें 7, 8, और 9 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. Postgres को अपडेट करें:
    1. डेटा सेंटर 1 में मौजूद मशीन 6 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. डेटा सेंटर 2 में मौजूद मशीन 12 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. Edge के कॉम्पोनेंट अपडेट करें:
    1. डेटा सेंटर 1 में मौजूद मशीनें 4, 5, 6 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. डेटा सेंटर 2 में मौजूद मशीनें 10, 11, 12 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. qpidd को अपडेट करें:
    1. डेटा सेंटर 1 में मौजूद मशीनें 4, 5
      1. मशीन 4 पर qpidd अपडेट करें: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. मशीन 5 पर qpidd अपडेट करें: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. डेटा सेंटर 2 में मौजूद मशीनें 10, 11
      1. मशीन 10 पर qpidd अपडेट करें: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. मशीन 11 पर qpidd अपडेट करें: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. नए यूज़र इंटरफ़ेस (ue) या क्लासिक यूज़र इंटरफ़ेस (ui) को अपडेट करें:
    1. डेटा सेंटर 1 में मौजूद मशीन 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. डेटा सेंटर 2 में मौजूद मशीन 7: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (अगर आपने apigee-adminapi इंस्टॉल किया है) apigee-adminapi यूटिलिटी को अपडेट किया गया:
    1. डेटा सेंटर 1 में मौजूद मशीन 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. डेटा सेंटर 2 में मौजूद मशीन 7: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (अगर आपने Apigee SSO इंस्टॉल किया है) Apigee SSO को अपडेट करें:
    1. डेटा सेंटर 1 में मौजूद मशीन 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. डेटा सेंटर 2 में मौजूद मशीन 7: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ (SSO) इंस्टॉल करते समय बनाया था.

  10. मशीन 1 और 7 पर, नए Edge यूज़र इंटरफ़ेस (edge-management-ui) या क्लासिक Edge यूज़र इंटरफ़ेस (edge-ui) कॉम्पोनेंट को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

नॉन-स्टैंडर्ड कॉन्फ़िगरेशन के लिए

अगर आपके पास नॉन-स्टैंडर्ड कॉन्फ़िगरेशन है, तो Edge कॉम्पोनेंट को इस क्रम में अपडेट करें:

  1. LDAP
  2. कैसंड्रा
  3. चिड़ियाघर में जानवरों की देखभाल करने वाला
  4. मैनेजमेंट सर्वर
  5. मैसेज प्रोसेसर
  6. राऊटर
  7. Postgres
  8. Edge का मतलब है कि ऑर्डर में मौजूद सभी नोड पर "-c edge" प्रोफ़ाइल: Qpid सर्वर वाले नोड, Edge Postgres Server.
  9. qpidd
  10. Edge यूज़र इंटरफ़ेस (क्लासिक या नया)
  11. apigee-adminapi
  12. Apigee SSO

अपडेट पूरा होने के बाद, Edge UI कॉम्पोनेंट को उन सभी मशीनों पर रीस्टार्ट करना न भूलें जिन पर यह चल रहा है.