Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

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

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

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

चेतावनी: Edge for Private Cloud 4.54.00 में Cassandra वर्शन को अपग्रेड किया गया है. इसलिए, हमारा सुझाव है कि इस अपग्रेड को एक बार में एक डेटा सेंटर पर करें. इस दस्तावेज़ में बताए गए अपग्रेड के चरण और दावे (जैसे, रनटाइम प्रॉक्सी ट्रैफ़िक पर कोई असर नहीं पड़ेगा), इस अनुमान पर आधारित हैं कि अपग्रेड के चरणों का पालन दस्तावेज़ में बताए गए तरीके से किया गया है.

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

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

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

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

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

पहले से पढ़ने के लिए मटीरियल

Edge for Private Cloud 4.54.00 में किए गए बदलावों के बारे में अहम जानकारी पाने के लिए, यहां दिए गए विषयों को पढ़ें:

4.54.00 में किए गए बदलाव: टीएलएस और Java कॉलआउट में किए गए बदलावों की समीक्षा करें. अपग्रेड करने से पहले, आपको इन बदलावों के लिए तैयारी करनी होगी. ज़्यादा जानकारी के लिए, 4.54.00 में हुए बदलाव देखें.
Dual-Java रनटाइम आर्किटेक्चर (Java 17 और Java 21): Edge for Private Cloud के 4.54.00 वर्शन से, Java 8 का इस्तेमाल नहीं किया जा सकेगा. इसके कॉम्पोनेंट, Java 17 या Java 21 पर काम करेंगे. ज़्यादा जानकारी के लिए, 4.54.00 में हुए बदलाव देखें.
बूटस्ट्रैप के दौरान Java अपने-आप इंस्टॉल नहीं होता: Edge for Private Cloud 4.54.00, Java के इंस्टॉलेशन का पता लगा सकता है. साथ ही, यह पुष्टि कर सकता है कि आपके पास Java 17 और 21, दोनों इंस्टॉल हैं.
4.54.00 में Edge का नया यूज़र इंटरफ़ेस (यूआई): डिफ़ॉल्ट मैनेजमेंट इंटरफ़ेस के तौर पर, Edge के नए यूज़र इंटरफ़ेस (यूआई) पर स्विच करने के बारे में जानें. साथ ही, क्लासिक यूज़र इंटरफ़ेस (edge-ui) को हटाने के बारे में जानें. ज़्यादा जानकारी के लिए, Edge का नया यूज़र इंटरफ़ेस (यूआई) देखें.
Apigee SSO 4.54.00 में: पुष्टि करने के लिए, अपडेट किए गए एसएसओ आर्किटेक्चर और कॉन्फ़िगरेशन में हुए बदलावों के बारे में जानें. ज़्यादा जानकारी के लिए, Apigee SSO देखें.
4.54.00 में Nginx 1.30: Edge Router पर Nginx 1.30.x के अपने-आप अपग्रेड होने की सुविधा की समीक्षा करें. साथ ही, रनटाइम पर पड़ने वाले संभावित असर और उसे कम करने के तरीके देखें. ज़्यादा जानकारी के लिए, Nginx 1.30 में हुए बदलाव देखें.

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

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

प्रॉडक्ट की जानकारी और नई सुविधाओं के बारे में जानें

अपग्रेड की प्रोसेस शुरू करने से पहले, Edge for Private Cloud के वर्शन 4.54.00 के रिलीज़ नोट में दी गई सभी नई सुविधाओं, व्यवहार में हुए बदलावों, और बंद की गई सुविधाओं को ध्यान से देखें और समझें.
अपग्रेड के दौरान, Java बाइनरी का अपने-आप पता चलना और साथ-साथ काम करना: स्टैंडर्ड पैकेज मैनेजर (जैसे कि yum) या स्टैंडर्ड लोकेशन (जैसे कि /usr/lib/jvm या update-alternatives) का इस्तेमाल करके Java इंस्टॉल करें. आपको सिस्टम PATH पर दोनों वर्शन को एक साथ कॉन्फ़िगर करने की ज़रूरत नहीं है. अपग्रेड करने से पहले, Java 8 को अनइंस्टॉल न करें. Java 17 और Java 21 के साथ-साथ Java 8 को भी इंस्टॉल रखें, ताकि Edge for Private Cloud 4.53.xx की मौजूदा सेवाएं बिना किसी रुकावट के चलती रहें. ऐसा तब तक करें, जब तक कि उन्हें अपडेट न कर दिया जाए.
सभी नोड का बैकअप लेना

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

पक्का करें कि Edge for Private Cloud 4.53.00 या 4.53.01 के लिए, साइलेंट कॉन्फ़िगरेशन फ़ाइलों की बैकअप कॉपी सेव की गई हों. इससे ज़रूरत पड़ने पर, रोलबैक किया जा सकता है.
पक्का करें कि Edge चल रहा हो

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

अगर आपने पहले Edge for Private Cloud के किसी पुराने वर्शन से 4.53.00 (या) 4.53.01 वर्शन पर अपग्रेड किया था और अब 4.54.00 वर्शन पर अपग्रेड करना है, तो पक्का करें कि आपने Cassandra के लिए, अपग्रेड करने के बाद ज़रूरी चरण पूरे कर लिए हों. यह तरीका, 4.53.00 (या) 4.53.01 वर्शन के अपग्रेड दस्तावेज़ में बताया गया है. साथ ही, Cassandra को अपग्रेड करने के लिए ज़रूरी शर्तें में भी बताया गया है. अगर आपको पक्के तौर पर नहीं पता कि पिछले अपग्रेड के दौरान ये चरण पूरे किए गए थे या नहीं, तो वर्शन 4.54.00 पर अपग्रेड करने से पहले इन्हें फिर से पूरा करें.
apigee-monit को बंद करें: अगर नोड पर apigee-monit चल रहा है, तो अपग्रेड करने से पहले इसे /opt/apigee/apigee-service/bin/apigee-service apigee-monit stop कमांड का इस्तेमाल करके बंद करें. इससे, कॉम्पोनेंट अपग्रेड होने के दौरान, apigee-monit उन्हें अपने-आप रीस्टार्ट नहीं करता. अपग्रेड पूरा होने के बाद, apigee-service apigee-monit start कमांड का इस्तेमाल करके, इसे फिर से चालू करें.

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

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

राऊटर और मैसेज प्रोसेसर को अपग्रेड करना

ध्यान दें: Edge for Private Cloud के पुराने वर्शन से 4.54.00 पर अपग्रेड करने से, Nginx सॉफ़्टवेयर अपने-आप 1.30.x वर्शन पर अपडेट हो जाता है. इस अपडेट की वजह से, रनटाइम एपीआई ट्रैफ़िक में रुकावटें आ सकती हैं. इस रुकावट के बारे में ज़्यादा जानने और इसे कम करने के लिए सुझाए गए तरीकों को समझने के लिए, कृपया Apigee Edge 4.54.00 में Nginx 1.30.x में हुए बदलाव देखें.

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

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

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

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

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

OpenLDAP 2.6.10 पर अपग्रेड करना

Edge for Private Cloud 4.54.00 में OpenLDAP 2.6.10 का इस्तेमाल किया गया है. यह अपग्रेड, Apigee OpenLDAP डिप्लॉयमेंट की सभी टोपोलॉजी पर लागू होता है: सिंगल-सर्वर, ऐक्टिव-पैसिव, और ऐक्टिव-ऐक्टिव (मल्टी-मास्टर).

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

LDAP को 4.53.00 से 4.54.00 पर अपग्रेड करने का तरीका

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

ध्यान दें कि OpenLDAP 2.4 से 2.6.10 पर माइग्रेट करने की प्रोसेस के दौरान (4.53.00 से अपग्रेड करते समय), मैनेजमेंट एपीआई और Apigee यूज़र इंटरफ़ेस (यूआई) सभी इलाकों में उपलब्ध नहीं होंगे. एडमिन से जुड़े सभी टास्क पूरे नहीं हो पाएंगे. जैसे, उपयोगकर्ताओं, भूमिकाओं, ऐप्लिकेशन, और संगठनों को मैनेज करना. इसलिए, इन्हें रोक देना चाहिए. आपके एपीआई प्रॉक्सी ट्रैफ़िक की प्रोसेसिंग पर कोई असर नहीं पड़ेगा. एलडीएपी माइग्रेशन की प्रोसेस शुरू करने से पहले, edge-management-server और edge-ui के सभी इंस्टेंस बंद कर दें.
4.53.00 से अपग्रेड करते समय बैकअप लेना ज़रूरी है: Edge for Private Cloud 4.53.00 (OpenLDAP 2.4.46) से अपग्रेड करते समय, आपके मौजूदा एलडीएपी डेटा का पूरा और पुष्टि किया गया बैकअप लेना ज़रूरी है. सही बैकअप के बिना आगे बढ़ने पर, डेटा हमेशा के लिए मिट जाता है. एलडीएपी सेवा के चालू रहने के दौरान बैकअप शुरू करें, ताकि एलडीएपी डेटा का एक जैसा स्नैपशॉट कैप्चर किया जा सके. बैकअप के बिना, 2.4 से 2.6.10 पर माइग्रेट नहीं किया जा सकता या वापस नहीं लाया जा सकता. ऐसा इसलिए, क्योंकि 4.53.00 पर माइग्रेट करने के चरणों में, लेगसी एलडीएपी डेटा डायरेक्ट्री मिट जाती हैं.

मैनेजमेंट सर्वर और यूज़र इंटरफ़ेस बंद करें: वर्शन 4.53.00 से एलडीएपी माइग्रेशन की प्रोसेस शुरू करने से पहले, सभी एज-मैनेजमेंट-सर्वर और एज-यूज़र इंटरफ़ेस इंस्टेंस बंद करें.
```
apigee-service edge-management-server stop
apigee-service edge-ui stop
```
मौजूदा एलडीएपी डेटा का बैकअप लें: वर्शन 4.53.00 (OpenLDAP 2.4.46) से अपग्रेड करते समय कोई भी बदलाव करने से पहले, सभी एलडीएपी सर्वर से मौजूदा एलडीएपी डेटा का पूरा बैकअप लें. इससे सुरक्षित रीस्टोर पॉइंट बनता है. (वर्शन 4.53.01 से 4.54.00 पर अपग्रेड करते समय, बैकअप लेने, रोकने, और क्लीनअप करने की इस प्रोसेस की ज़रूरत नहीं होती.)
- बैकअप कमांड चलाएं. इस कार्रवाई से, /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
```
एलडीएपी को बंद करें और डेटा डायरेक्ट्री को साफ़ करें: यह चरण सभी एलडीएपी सर्वर पर सिर्फ़ तब करें, जब आपको वर्शन 4.53.00 (OpenLDAP 2.4.46) से अपग्रेड करना हो. अगर 4.53.01 (OpenLDAP 2.6.7) वर्शन से अपग्रेड किया जा रहा है, तो LDAP को बंद न करें या /opt/apigee/data/apigee-openldap/* को न मिटाएं. 4.53.00 वर्शन पर अपग्रेड करने के लिए, यह चरण ज़रूरी है. ऐसा इसलिए, क्योंकि मेजर वर्शन में बदलाव हुआ है और डेटाबेस के स्ट्रक्चर में अंतर है. सभी एलडीएपी सर्वर बंद होने पर, Management API और यूज़र इंटरफ़ेस में रुकावट आने लगती है.
- एलडीएपी सेवा को बंद करें.
```
apigee-service apigee-openldap stop
```
- एलडीएपी के पुराने डेटा और कॉन्फ़िगरेशन डायरेक्ट्री को हमेशा के लिए मिटाएं.
```
rm -rf /opt/apigee/data/apigee-openldap/*
```
LDAP का नया वर्शन इंस्टॉल और कॉन्फ़िगर करना सभी LDAP सर्वर पर, कॉम्पोनेंट का नया वर्शन डाउनलोड और इंस्टॉल करने के लिए, स्टैंडर्ड Apigee स्क्रिप्ट का इस्तेमाल करें.
- नया एलडीएपी कॉम्पोनेंट इंस्टॉल करना: अपडेट स्क्रिप्ट, आपकी कॉन्फ़िगरेशन फ़ाइल को पढ़ती है और नया apigee-openldap पैकेज इंस्टॉल करती है.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
- एलडीएपी के नए वर्शन की पुष्टि करना: इंस्टॉलेशन पूरा होने के बाद, प्रोफ़ाइल को फिर से लोड करें और पुष्टि करें कि एलडीएपी का नया वर्शन (2.6.10) इंस्टॉल हो गया है:
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
  ऊपर दिए गए कमांड के आउटपुट से, LDAP के वर्शन 2.6.10 की पुष्टि होनी चाहिए, जैसा कि यहां दिखाया गया है:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```
डेटा वापस लाने से पहले, सभी सर्वर पर LDAP को बंद करें: पांचवां, छठा, और सातवां चरण सिर्फ़ तब पूरा करें, जब 4.53.00 (OpenLDAP 2.4.46) वर्शन से अपग्रेड किया जा रहा हो (अगर आपने चौथे चरण में 4.53.01 वर्शन से अपग्रेड किया है, तो आपका मौजूदा LDAP डेटा सुरक्षित रहेगा और आपका अपग्रेड पूरा हो जाएगा). 4.53.00 से अपना बैकअप वापस लाने से पहले, पक्का करें कि हाल ही में इंस्टॉल की गई LDAP सेवा सभी सर्वर पर बंद हो. हर LDAP सर्वर पर, ये कमांड चलाएं:
```
apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/ldap/*
```
एलडीएपी डेटा को वापस लाना: इस रणनीति के तहत, पहले चालू सर्वर पर बैकअप को वापस लाया जाता है. इसके बाद, यह सर्वर सोर्स ऑफ़ ट्रुथ के तौर पर काम करेगा. साथ ही, एक से ज़्यादा सर्वर वाले सेटअप में, अपने साथियों को डेटा की कॉपी भेजेगा.
1. डेटा वापस पाने के लिए, पहले चालू सर्वर की पहचान करें:
  - सिंगल-सर्वर सेटअप के लिए: यह आपका एकमात्र LDAP सर्वर है. सीधे अगले चरण पर जाएं.
  - ऐक्टिव-पैसिव और ऐक्टिव-ऐक्टिव सेटअप के लिए: हर एलडीएपी सर्वर पर, यह डाइग्नोस्टिक कमांड चलाएं:
```
grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*.ldif
```
    ध्यान दें:
    - अगर ऊपर दिया गया निर्देश आउटपुट दिखाता है, तो सर्वर एक पैसिव सर्वर है.
    - अगर इससे कोई आउटपुट नहीं मिलता है, तो इसका मतलब है कि सर्वर चालू है.
2. बैकअप डेटा को वापस लाना: आगे बढ़ने से पहले, दोबारा जांच लें कि सभी LDAP सर्वर पर पांचवां चरण पूरा हो गया हो.
  - ऊपर बताए गए पहले ऐक्टिव सर्वर पर, बैकअप डायरेक्ट्री पर जाएं.
```
cd /opt/apigee/backup/openldap
```
  - रीस्टोर करने का निर्देश चलाएं. दूसरे चरण में दिए गए बैकअप के टाइमस्टैंप की सटीक जानकारी दें, ताकि किसी अनचाहे या पुराने वर्शन को वापस लाने से बचा जा सके.
```
# 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
```
बाकी बचे एलडीएपी सर्वर चालू करें: अगर आपके पास एक से ज़्यादा सर्वर सेटअप हैं, तो हर एलडीएपी सर्वर पर सेवा चालू करें:
```
apigee-service apigee-openldap start
```
ध्यान दें: आपको इन पीयर सर्वर पर डेटा को मैन्युअल तरीके से वापस लाने की ज़रूरत नहीं है. शुरू होने पर, वे पहले सर्वर से कनेक्ट हो जाएंगे. इस सर्वर में अब वापस लाया गया डेटा मौजूद है. साथ ही, वे रेप्लिकेशन की मदद से पूरी डायरेक्ट्री को अपने-आप सिंक कर देंगे.
आखिरी पुष्टि आखिरी चरण में, यह पुष्टि की जाती है कि अपग्रेड हो गया है और पूरे एलडीएपी क्लस्टर में डेटा एक जैसा है.
- सभी एलडीएपी सर्वर पर पुष्टि करने वाला निर्देश चलाएं. सभी सर्वर पर रिकॉर्ड की संख्या एक जैसी होनी चाहिए. साथ ही, यह संख्या उस संख्या से मेल खानी चाहिए जिसे आपने दूसरे चरण में कैप्चर किया था:
```
# 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
```
- डेटा के सही और एक जैसा होने की पुष्टि करने के बाद, LDAP अपग्रेड की प्रोसेस पूरी हो जाएगी. अब अपने संगठन के स्टैंडर्ड अपग्रेड करने के तरीके के मुताबिक, एज-मैनेजमेंट-सर्वर, एज-यूआई, और अन्य डिपेंडेंट कॉम्पोनेंट शुरू किए जा सकते हैं.

एलडीएपी को 4.53.01 से 4.54.00 पर अपग्रेड करने का तरीका

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

नया एलडीएपी कॉम्पोनेंट इंस्टॉल करना: अपडेट स्क्रिप्ट, आपकी कॉन्फ़िगरेशन फ़ाइल को पढ़ती है और नया apigee-openldap पैकेज इंस्टॉल करती है.
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
एलडीएपी के नए वर्शन की पुष्टि करना: इंस्टॉलेशन पूरा होने के बाद, प्रोफ़ाइल को फिर से लोड करें और पुष्टि करें कि एलडीएपी का नया वर्शन (2.6.10) इंस्टॉल हो गया है:
```
echo 'export PATH=/opt/symas/bin:$PATH' >> ~/.bash_profile
source ~/.bash_profile
ldapsearch -VV
```
ऊपर दिए गए कमांड के आउटपुट से, LDAP के वर्शन 2.6.10 की पुष्टि होनी चाहिए, जैसा कि यहां दिखाया गया है:
```
Expected output:
ldapsearch: @(#) OpenLDAP: ldapsearch 2.6.10
```

नए Edge यूज़र इंटरफ़ेस (यूआई) और Apigee SSO (अगर इंस्टॉल किया गया है) पर अपग्रेड करें

ध्यान दें: Edge for Private Cloud के 4.54.00 से पहले के वर्शन में, क्लासिक यूज़र इंटरफ़ेस (edge-ui) और नए Edge यूज़र इंटरफ़ेस (edge-management-ui) को एक ही नोड पर इंस्टॉल नहीं किया जा सकता था. इसलिए, एडमिन को हर यूज़र इंटरफ़ेस के लिए एक अलग नोड उपलब्ध कराना पड़ता था. वर्शन 4.54.00 में क्लासिक यूज़र इंटरफ़ेस को हटा दिया गया है. इसलिए, अब उस अलग नोड की ज़रूरत नहीं है.

Apigee Edge for Private Cloud 4.54.00 में, क्लासिक यूज़र इंटरफ़ेस (edge-ui) को हटा दिया गया है और इसकी जगह नया Edge यूज़र इंटरफ़ेस (edge-management-ui) जोड़ दिया गया है. अगर आपके सेटअप में Apigee Single Sign-On (SSO) इंस्टॉल और इस्तेमाल किया जाता है, तो यहां दिए गए दो विकल्पों में से किसी एक का पालन करें:

पहला विकल्प: यूज़र इंटरफ़ेस (यूआई) को अपग्रेड करना (Apigee एसएसओ के बिना)

यह सेक्शन सिर्फ़ तब लागू होता है, जब Apigee SSO (apigee-sso) को Edge for Private Cloud के मौजूदा वर्शन 4.53.00 या 4.53.01 में कॉन्फ़िगर / इंस्टॉल नहीं किया गया हो

Edge for Private Cloud के वर्शन 4.54.00 में अपग्रेड करने की प्रोसेस के तहत, क्लासिक यूज़र इंटरफ़ेस (edge-ui) को हटा दिया गया है. अपग्रेड करने के लिए नीचे दिया गया कमांड चलाने पर, यूज़र इंटरफ़ेस (यूआई) नोड, क्लासिक यूज़र इंटरफ़ेस (यूआई) (edge-ui) से नए Edge यूज़र इंटरफ़ेस (यूआई) (edge-management-ui) पर स्विच हो जाता है.

पहला चरण: कॉन्फ़िगरेशन फ़ाइलों का बैक अप लेना

शुरू करने से पहले, सभी यूज़र इंटरफ़ेस (यूआई) नोड पर मौजूद साइलेंट कॉन्फ़िगरेशन फ़ाइल (configFile) और /opt/apigee/customer/application/ डायरेक्ट्री का बैकअप लें.

दूसरा चरण: बेसिक ऑथेंटिकेशन के लिए, साइलेंट कॉन्फ़िगरेशन फ़ाइल को अपडेट करना

साइलेंट कॉन्फ़िगरेशन फ़ाइल (उदाहरण के लिए, /opt/silent.conf) में बदलाव करें और बुनियादी पुष्टि के लिए, New Edge UI की ये प्रॉपर्टी जोड़ें:

# Authentication mode for New Edge UI (Basic Authentication - No Apigee SSO)
AUTH_MODE=basic

# Access configuration for the New Edge UI
MANAGEMENT_UI_PORT=3001
MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_SCHEME=http

तीसरा चरण: यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को अपग्रेड करना

क्लासिक यूज़र इंटरफ़ेस (edge-ui) से नए Edge यूज़र इंटरफ़ेस (edge-management-ui) पर अपग्रेड करने के लिए, कॉम्पोनेंट -c ue के साथ update.sh स्क्रिप्ट चलाएं:

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

चौथा चरण: Edge के नए यूज़र इंटरफ़ेस (यूआई) के अपग्रेड की पुष्टि करना

सभी यूआई नोड पर अपग्रेड की प्रोसेस पूरी होने के बाद, कृपया पुष्टि करें कि 4.54.00 वर्शन वाला New Edge UI पूरी तरह से काम कर रहा है और इसे ऐक्सेस किया जा सकता है:

देखें कि edge-management-ui सेवा चालू है या नहीं:
```
apigee-service edge-management-ui status
```
कोई ब्राउज़र खोलें और यहां जाएं:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
पुष्टि होने के बाद, दूसरा विकल्प: यूज़र इंटरफ़ेस (यूआई) को अपग्रेड करना (Apigee एसएसओ के साथ) को छोड़ें और सीधे Qpid पर अपग्रेड करना ज़रूरी है पर जाएं.

दूसरा विकल्प: यूज़र इंटरफ़ेस (यूआई) को अपग्रेड करना (Apigee एसएसओ के साथ)

इस सेक्शन का इस्तेमाल तब करें, जब Apigee SSO (apigee-sso) को Edge for Private Cloud 4.53.00 या 4.53.01 एनवायरमेंट में कॉन्फ़िगर / इंस्टॉल किया गया हो.

Apigee Edge for Private Cloud 4.54.00 में:

Apigee SSO सेवा, लेगसी apigee-sso कॉम्पोनेंट से Apigee SSO पर ट्रांज़िशन करती है. इसे apigee-openldap के तहत मैनेज किया जाता है. अगर Edge for Private Cloud के वर्शन 4.53.00 या 4.53.01 में एसएसओ चालू है, तो Apigee Edge for Private Cloud के वर्शन 4.54.00 पर अपग्रेड करते समय, यह अपग्रेड करना ज़रूरी है.
एसएसओ के साथ 4.53.x क्लासिक यूज़र इंटरफ़ेस (edge-ui) और एसएसओ के साथ 4.53.x नया Edge यूज़र इंटरफ़ेस (edge-management-ui), दोनों को Apigee एसएसओ के साथ 4.54.00 नया Edge यूज़र इंटरफ़ेस (edge-management-ui) पर अपग्रेड किया जाता है.

Apigee SSO के नए डिज़ाइन और Management API के साथ यूटिलिटी और ऑटोमेशन फ़्लो पर इसके असर के बारे में जानने के लिए, ये लेख पढ़ें:
Apigee के नए एसएसओ स्ट्रक्चर के बारे में जानकारी
एसएसओ का इस्तेमाल करके, अपने-आप होने वाले टास्क की सुविधा

यूज़र इंटरफ़ेस (यूआई) और Apigee एसएसओ, दोनों को अपग्रेड करने के लिए, यहां दिया गया तरीका अपनाएं. इससे, आपको कॉन्फ़िगरेशन के चरणों को दोहराना नहीं पड़ेगा:

पहला चरण: कॉन्फ़िगरेशन फ़ाइलों का बैक अप लेना

आगे बढ़ने से पहले, सभी यूज़र इंटरफ़ेस (यूआई) और एसएसओ नोड पर, अपनी मौजूदा साइलेंट configFile और /opt/apigee/customer/application/ डायरेक्ट्री का बैक अप लें.

दूसरा चरण: इस्तेमाल नहीं किए जा रहे यूआई/एसएसओ वैरिएबल हटाएं और साइलेंट कॉन्फ़िगरेशन फ़ाइल (`configFile`) अपडेट करें

New Edge यूज़र इंटरफ़ेस (यूआई) को अपग्रेड करने और Apigee एसएसओ मॉड्यूल को कॉन्फ़िगर करने से पहले, अपनी साइलेंट कॉन्फ़िगरेशन फ़ाइल (configFile) को अपडेट करें. इसके लिए, अपने मौजूदा 4.53.x यूज़र इंटरफ़ेस (यूआई) सेटअप के आधार पर, यह तरीका अपनाएं:

configFile से, बंद किए गए 4.53.x यूज़र इंटरफ़ेस (यूआई) और एसएसओ वैरिएबल हटाएं या उन्हें टिप्पणी के तौर पर मार्क करें:
1. अगर क्लासिक यूज़र इंटरफ़ेस (edge-ui) से apigee-sso पर अपग्रेड किया जा रहा है, तो: क्लासिक यूज़र इंटरफ़ेस और एसएसओ से जुड़ी प्रॉपर्टी हटाएं या उन्हें टिप्पणी के तौर पर मार्क करें:
```
EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
```
2. अगर apigee-sso के साथ New Edge यूज़र इंटरफ़ेस (edge-management-ui) से अपग्रेड किया जा रहा है, तो: अब काम न करने वाले 4.53.x Classic यूज़र इंटरफ़ेस, Shoehorn, और एसएसओ से जुड़ी प्रॉपर्टी हटाएं या उन्हें टिप्पणी के तौर पर मार्क करें:
```
EDGEUI_SSO_ENABLED=y
EDGEUI_SSO_CLIENT_NAME=edgeui
EDGEUI_SSO_CLIENT_SECRET=edgeuisecret
EDGEUI_PUBLIC_URIS=
EDGEUI_SSO_CLIENT_OVERWRITE=y
EDGEUI_SSO_REGISTERD_PUBLIC_URIS=$EDGEUI_PUBLIC_URIS
EDGEUI_ENABLE_UNIFIED_UI=n
SHOEHORN_SCHEME=$MANAGEMENT_UI_SCHEME
SHOEHORN_IP=$MANAGEMENT_UI_IP
SHOEHORN_PORT=9000
CLASSIC_UI_SCHEME=http
CLASSIC_UI_PORT=9000
MANAGEMENT_UI_PUBLIC_URIS=http://Public_IP:3001
MANAGEMENT_UI_SSO_REGISTERD_PUBLIC_URIS=$MANAGEMENT_UI_PUBLIC_URIS
ROUTES_CLASSICUI=""
ROUTES_SHOEHORN=""
```
New Edge यूज़र इंटरफ़ेस (यूआई) के लिए मशीन यूज़र बनाने के लिए, apigee-openldap नोड पर इस कमांड का इस्तेमाल करें. साथ ही, पक्का करें कि अगले चरण में साइलेंट कॉन्फ़िगरेशन फ़ाइल (configFile) में प्रॉपर्टी तय करते समय, बिलकुल वही क्रेडेंशियल इस्तेमाल किए जाएं. ज़्यादा जानकारी के लिए, यूज़र इंटरफ़ेस के लिए मशीन यूज़र बनाना लेख पढ़ें.
```
/opt/apigee/apigee-openldap/bin/apigee-machineuser.sh add -u ui-machine-user@apigee.com -p Secret123
```

configFile में , Apigee SSO 4.54.00 और New Edge UI की ज़रूरी प्रॉपर्टी जोड़ें या अपडेट करें:

# ==========================================
# SSO Enablement
# ==========================================
ENABLE_SSO=y

# ==========================================
# SSO Hostname/IP and Port config for Apigee SSO
# ==========================================
SSO_PUBLIC_URL_SCHEME=http
SSO_PUBLIC_URL_HOSTNAME=YOUR_SSO_NODE_IP_OR_HOSTNAME #Replace YOUR_SSO_NODE_IP_OR_HOSTNAME with the IP address or hostname of the SSO node.
SSO_PUBLIC_URL_PORT=9099

# ==========================================
# Static Client UI credentials
# ==========================================
MANAGEMENT_UI_SSO_CLIENT_ID=YOUR_SSO_CLIENT_ID #Example : MANAGEMENT_UI_SSO_CLIENT_ID=unifiedui
MANAGEMENT_UI_SSO_CLIENT_SECRET=YOUR_SSO_CLIENT_SECRET #Example : MANAGEMENT_UI_SSO_CLIENT_SECRET=secret123

# ==========================================
# Management UI & SSO redirect URLs
# ==========================================
MANAGEMENT_UI_SCHEME=http
MANAGEMENT_UI_IP=MANAGEMENT_UI_NODE_IP #Replace MANAGEMENT_UI_NODE_IP with the IP address or hostname of the UI node.
MANAGEMENT_UI_PORT=3001

# ==========================================
# Management Server parameters (Required for SSO registration)
# ==========================================
MSIP=MS_IP_OR_HOSTNAME #Replace MS_IP_OR_HOSTNAME with the IP address or hostname of the Management Server node.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=your_password

# ==========================================
# Machine user for UI
# ==========================================
UI_MACHINE_USER=ui-machine-user@apigee.com
UI_MACHINE_PWD=Secret123

# ==========================================
# Postgres connection parameters
# ==========================================
# Postgres username and password as set when you installed Edge.
PG_HOST=PG_IP_OR_HOSTNAME
PG_USER=apigee
PG_PWD=YOUR_PG_PASSWORD

# ==========================================
# Other UI Parameters
# ==========================================
AUTH_MODE=sso

# Y to use Internal/Local LDAP for authentication, N to use external IDP
SSO_LOCAL_LDAP=y

MANAGEMENT_UI_APP_ENV=OPDK
MANAGEMENT_UI_SSO_ENABLED=y
MANAGEMENT_UI_SSO_CSRF_SECRET=YOUR_CSRF_SECRET
MANAGEMENT_UI_SSO_CSRF_EXPIRATION_HOURS=24
MANAGEMENT_UI_SSO_STRICT_TRANSPORT_SECURITY_AGE_HOURS=24
MANAGEMENT_UI_SSO_PUBLIC_KEY_CACHE_HOURS=0.5

ध्यान दें : ऊपर दिए गए कॉन्फ़िगरेशन, Apigee के स्टैंडर्ड एसएसओ को सेट अप करते हैं. इसमें डिफ़ॉल्ट http प्रोटोकॉल के बजाय, apigee-openldap को एलडीएपी आइडेंटिटी प्रोवाइडर (आईडीपी) के तौर पर इस्तेमाल किया जाता है. बाहरी एलडीएपी प्रोवाइडर को इंटिग्रेट करने, एसएएमएल को कॉन्फ़िगर करने या एचटीटीपीएस को चालू करने के लिए, कृपया आगे बढ़ने से पहले ज़रूरी अतिरिक्त कॉन्फ़िगरेशन के बारे में यहां दिए गए दस्तावेज़ देखें:

तीसरा चरण: New Edge यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को अपग्रेड करना

ध्यान दें:

मल्टी-नोड टोपोलॉजी वाले नए Edge यूज़र इंटरफ़ेस (Edge for Private Cloud v4.53.01 से पहले, Classic यूज़र इंटरफ़ेस और नए Edge यूज़र इंटरफ़ेस के लिए अलग-अलग नोड बनाए रखना ज़रूरी था) के बारे में जानकारी: उदाहरण के लिए, 4.53.01 के मल्टी-नोड सेटअप में, नोड 1, edge-ui (ui.properties के ज़रिए कॉन्फ़िगर किया गया) और नोड 2, edge-management-ui के साथ-साथ Shoehorn UI edge-ui (management-ui.properties के ज़रिए कॉन्फ़िगर किया गया) को ऑपरेट करता है:

कस्टम कॉन्फ़िगरेशन कॉपी करें (सीडब्ल्यूसी) : /opt/apigee/customer/application/management-ui.properties फ़ाइल को नोड 2 से नोड 1 में उसी पाथ पर ट्रांसफ़र करें. पक्का करें कि लेगसी apigee-sso के सभी सीडब्ल्यूसी ओवरराइड हटा दिए गए हों. साथ ही, यह भी पक्का करें कि फ़ाइल का मालिकाना हक apigee:apigee के पास हो.

अगर फ़िलहाल New Edge UI का इस्तेमाल किया जा रहा है, तो edge-management-ui (New Edge UI) और edge-ui (Shoehorn UI), दोनों कॉम्पोनेंट को बंद और अनइंस्टॉल करें :
```
#Remove 4.53.xx New Edge UI from installation node 
apigee-service edge-management-ui stop
apigee-service edge-management-ui uninstall

#Remove Shoehorn UI from the node with 4.53.xx New Edge UI
apigee-service edge-ui stop
apigee-service edge-ui uninstall
```
New Edge UI (edge-management-ui) कॉम्पोनेंट को इंस्टॉल और अपग्रेड करने के लिए, अपने Classic UI (edge-ui) नोड पर update.sh स्क्रिप्ट चलाएं:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```

चौथा चरण: `apigee-sso` को बंद करना

उन सभी नोड पर लेगसी apigee-sso सेवा को बंद करें जहां यह इंस्टॉल है:

apigee-service apigee-sso stop

पांचवां चरण: Postgres नोड में Apigee SSO के लिए `apigee_dex` डेटाबेस बनाना

Postgres के प्राइमरी नोड पर, इस कमांड का इस्तेमाल करके Postgresql में लॉग इन करें:
```
psql -h $(hostname -i) -U apigee
```
Apigee SSO डेटाबेस बनाने के लिए, psql प्रॉम्प्ट पर यह कमांड चलाएं:
```
create database apigee_dex;
```

छठा चरण: OpenLDAP नोड पर Apigee SSO सेट अप करना

apigee-openldap नोड पर यह कमांड चलाएं, जहां Apigee एसएसओ इंस्टॉल किया जाएगा:

/opt/apigee/apigee-service/bin/apigee-service apigee-openldap setup-sso -f configFile

सातवां चरण: Apigee SSO के लिए मैनेजमेंट यूआई को कॉन्फ़िगर करना और यूआई को रीस्टार्ट करना

ऐसे हर नोड पर ये कमांड चलाएं जिस पर Edge for Private Cloud 4.54.00 edge-management-ui इंस्टॉल किया गया है:

/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-sso -f configFile

आठवां चरण: नए Edge यूज़र इंटरफ़ेस (यूआई) और Apigee एसएसओ के अपग्रेड की पुष्टि करना

ऊपर दिया गया तरीका अपनाने के बाद, पुष्टि करें कि 4.54.00 New Edge यूज़र इंटरफ़ेस (यूआई) और Apigee SSO चालू हैं और उन्हें ऐक्सेस किया जा सकता है:

देखें कि edge-management-ui सेवा चालू है या नहीं:
```
apigee-service edge-management-ui status
```
कोई ब्राउज़र खोलें और यहां जाएं:
```
http://MANAGEMENT_UI_NODE_IP:3001
```
कॉन्फ़िगर किए गए SSO क्रेडेंशियल का इस्तेमाल करके साइन इन करें.

नौवां चरण: लेगसी `apigee-sso` को अनइंस्टॉल करना

जिन नोड पर लेगसी apigee-sso इंस्टॉल किया गया था उन सभी पर, apigee-sso कॉम्पोनेंट को अनइंस्टॉल करें:

apigee-service apigee-sso uninstall

Qpid 10.0.1 पर अपग्रेड करें

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

Qpid पर इन-प्लेस, ज़ीरो डाउनटाइम अपग्रेड करने के लिए:

शुरू करने के लिए, कोई एक Qpid नोड चुनें.
नोड पर Qpid ब्रोकर को बंद करें:
```
apigee-service apigee-qpidd stop
```
फ़ायरवॉल लागू करके, सभी मैसेज प्रोसेसर से ब्रोकर पोर्ट 5672 पर आने वाले ट्रैफ़िक को ब्लॉक करें. इस फ़ायरवॉल को Qpid नोड इंस्टेंस या किसी अन्य बाहरी फ़ायरवॉल/नेटवर्क कॉम्पोनेंट के लेवल पर लागू किया जा सकता है.

हमारा सुझाव है कि आप मैसेज प्रोसेसर के सभी आईपी पतों के लिए, यही तरीका अपनाएं. उदाहरण के लिए, अगर आपको IPTables का इस्तेमाल करके, मैसेज प्रोसेसर के आईपी पतों से Qpid नोड पर पोर्ट 5672 पर आने वाले अनुरोधों को ड्रॉप करना है, तो इस तरह के निर्देश का इस्तेमाल किया जा सकता है:
```
iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
```
अगर कोई मौजूदा मैसेज है, तो उसे हटाने के लिए Qpid ब्रोकर को फिर से चालू करें:
```
apigee-service apigee-qpidd start
```
देखें कि मौजूदा कतारें खाली हैं या नहीं:
```
/opt/apigee/apigee-qpidd/bin/qpid-stat -q
```
अगर मैसेज, डेड लेटर सूची (डीएलक्यू) (ax-q-axgroup-001-consumer-group-001-dl) में अटक गए हैं, तो डेड लेटर सूची में अटके हुए आंकड़ों के डेटा से जुड़ी समस्या को हल करने के लिए दिया गया तरीका अपनाकर, सूची को खाली करें.
पुराने नोड पर सूची खाली होने की पुष्टि करने के बाद, apigee-qpidd को बंद करें:
```
apigee-service apigee-qpidd stop
```
नोड पर Qpid को अपग्रेड करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
edge-qpid-server को रीस्टार्ट करें:
```
apigee-service edge-qpid-server restart
```
तीसरे चरण में लागू किया गया फ़ायरवॉल नियम हटाएं.

जिन मैसेज प्रोसेसर आईपी पतों पर फ़ायरवॉल लागू किया गया था उन सभी के लिए, हटाने का यही तरीका अपनाएं. फ़ायरवॉल हटाने के बाद, मैसेज प्रोसेसर के आईपी पतों से पोर्ट 5672 पर Qpid नोड को भेजे जाने वाले अनुरोध स्वीकार किए जाएंगे. अगर आपने फ़ायरवॉल जोड़ने के लिए iptables का इस्तेमाल किया है, तो फ़ायरवॉल हटाने और मौजूदा सेटिंग की सूची देखने के लिए, इस तरह के कमांड इस्तेमाल किए जा सकते हैं:
```
iptables -F
iptables -L
```
वेब मॉनिटरिंग का इस्तेमाल करके यह पुष्टि करें कि Qpid कतारों को मैसेज मिल रहे हैं:
```
http://QPID_NODE_IP:8090
```
हर Qpid नोड के लिए, पहले से नौवें चरण तक की प्रक्रिया दोहराएं.

Postgres 18.6 पर अपग्रेड करें

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

ध्यान दें:

पक्का करें कि yum को हटाने पर, साफ़ करने की ज़रूरी शर्तों के लिए नहीं सेट किया गया हो. ऐसा न करने पर, Postgres को अपग्रेड नहीं किया जा सकेगा.
अगर apigee-monit इंस्टॉल और चालू है, तो Postgres सर्वर को अपग्रेड करने से पहले आपको apigee-monit को बंद करना होगा. इससे यह पक्का किया जा सकेगा कि अपग्रेड के दौरान, Postgres डेटाबेस को रीस्टार्ट करने की कोशिश न की जाए.

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

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

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

मौजूदा 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, नए स्टैंडबाय नोड का आईपी पता है.
Postgres प्राइमरी नोड पर apigee-postgresql को रीस्टार्ट करें:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
```
प्राइमरी नोड पर /opt/apigee/apigee-postgresql/conf/pg_hba.conf फ़ाइल देखकर पुष्टि करें कि नया स्टैंडबाय नोड जोड़ा गया है. आपको उस फ़ाइल में ये लाइनें दिखनी चाहिए:
```
host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
```
नया Postgres स्टैंडबाय सर्वर इंस्टॉल करें:
1. Edge के मौजूदा वर्शन को इंस्टॉल करने के लिए इस्तेमाल की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करके, यह जानकारी दें:
```
# IP address of the current primary(master):
PG_MASTER=PG_MASTER_NODE_IP
# IP address of the new standby node
PG_STANDBY=PG_STANDBY_NODE_IP
```
2. Edge apigee-setup यूटिलिटी इंस्टॉल करें में बताए गए तरीके से, SELinux को बंद करें.
3. Edge के मौजूदा वर्शन के आधार पर, बूटस्ट्रैप स्क्रिप्ट डाउनलोड करें और उसे चलाएं:
  - अगर फ़िलहाल Edge 4.53.00 का इस्तेमाल किया जा रहा है, तो:
    
    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
```
    Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
```
bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord
```
  - अगर फ़िलहाल Edge 4.53.01 का इस्तेमाल किया जा रहा है, तो:
    
    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
```
    Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
```
bash /tmp/bootstrap_4.53.01.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 को अपग्रेड करने से पहले, प्राइमरी होस्ट और स्टैंडबाय, दोनों पर यह तरीका अपनाएं. इससे apigee-postgresql पर max_locks_per_transaction प्रॉपर्टी अपडेट हो जाएगी:

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

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

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

प्राइमरी होस्ट पर Postgres को अपग्रेड करना
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
प्राइमरी होस्ट पर सेटअप कमांड चलाएं:
```
apigee-service apigee-postgresql setup -f configFile
```
प्राइमरी होस्ट पर कॉन्फ़िगर कमांड चलाएं:
```
apigee-service apigee-postgresql configure
```
मुख्य होस्ट को रीस्टार्ट करें:
```
apigee-service apigee-postgresql restart
```
इसे मुख्य खाते के तौर पर कॉन्फ़िगर करें:
```
apigee-service apigee-postgresql setup-replication-on-master -f configFile
```
पक्का करें कि प्राइमरी होस्ट ने मीटिंग शुरू कर दी हो:
```
apigee-service apigee-postgresql wait_for_ready
```
स्टैंडबाय मोड बंद करना:
```
apigee-service apigee-postgresql stop
```
स्टैंडबाय मोड को अपग्रेड करें.

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

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

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

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

पक्का करें कि Postgres चल रहा हो:
```
/opt/apigee/apigee-service/bin/apigee-all status
```
अगर Postgres नहीं चल रहा है, तो इसे शुरू करें:
```
/opt/apigee/apigee-service/bin/apigee-all start
```
नए स्टैंडबाय नोड पर यह curl कमांड चलाकर, नए स्टैंडबाय नोड का यूयूआईडी पाएं:
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
आपको आउटपुट के आखिर में नोड का यूयूआईडी दिखेगा. यह इस फ़ॉर्म में होगा:
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
नए स्टैंडबाय नोड पर यह कमांड चलाकर, नए स्टैंडबाय नोड को बंद करें:
```
/opt/apigee/apigee-service/bin/apigee-all stop
```
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
```
Postgres प्राइमरी पर apigee-postgresql को रीस्टार्ट करें:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
```
प्राइमरी नोड पर /opt/apigee/apigee-postgresql/conf/pg_hba.conf फ़ाइल देखकर पुष्टि करें कि नया स्टैंडबाय नोड हटा दिया गया है. आपको उस फ़ाइल में सिर्फ़ यह लाइन दिखनी चाहिए:
```
host replication apigee existing_standby_ip/32 trust
```
स्टैंडबाय नोड के यूयूआईडी को ZooKeeper से मिटाएं. इसके लिए, मैनेजमेंट सर्वर नोड पर Edge Management API का यह कॉल करें:
```
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
```

Postgres के लिए अपग्रेड के बाद के चरण

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

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

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

ZooKeeper 3.8.5 पर अपग्रेड करना

Edge for Private Cloud की इस रिलीज़ में, ZooKeeper 3.8.5 का अपग्रेड शामिल है. इस अपग्रेड के तहत, ZooKeeper का सारा डेटा ZooKeeper 3.8.5 पर माइग्रेट कर दिया जाएगा.

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

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

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

बैकअप लेना

अगर रोलबैक करने की ज़रूरत पड़ती है, तो इस्तेमाल करने के लिए ZooKeeper के सभी नोड का बैकअप लें. ध्यान दें कि रोलबैक करने पर, ZooKeeper को उस स्थिति में वापस लाया जाएगा जब बैकअप लिया गया था.

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

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

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

अगर यह ZooKeeper नोड पर इंस्टॉल नहीं है, तो nc इंस्टॉल करें:
```
yum install nc
```
नोड पर यह nc कमांड चलाएं, जहां 2181, ZooKeeper पोर्ट है:
```
echo stat | nc localhost 2181
```
आपको इस तरह का आउटपुट दिखेगा:
```
Zookeeper version: 3.8.5-19f1842d4b6ee1f82cc8b05284959b26c6ae507d, built on 2025-09-03 21:35 UTC
Clients:
 /[0:0:0:0:0:0:0:1]:40696[0](queued=0,recved=1,sent=0)

Latency min/avg/max: 3/4.3333/6
Received: 4
Sent: 3
Connections: 1
Outstanding: 0
Zxid: 0x500000005
Mode: follower
```
नोड के आउटपुट की Mode लाइन में, आपको नोड कॉन्फ़िगरेशन के आधार पर ऑब्ज़र्वर, लीडर या फ़ॉलोअर (यानी कि ऐसा वोटर जो लीडर नहीं है) दिखना चाहिए.

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

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

हर ऑब्ज़र्वर और फ़ॉलोअर नोड पर ZooKeeper को अपग्रेड करने के लिए, यह तरीका अपनाएं:

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

लीडर को शटडाउन करना

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

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

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

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

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

लीडर को अपग्रेड करें

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

पुराने लीडर नोड को भी अपग्रेड करने के बाद, क्लस्टर की परफ़ॉर्मेंस की जांच करें. साथ ही, पक्का करें कि कोई लीडर नोड मौजूद हो.

Cassandra 5.0.8 पर अपग्रेड करना

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

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

Cassandra 4.0.X से Cassandra 5.0.X पर अपग्रेड करने की प्रोसेस रोलिंग होती है.
Cassandra 5.0.X से 4.0.X पर सीधे रोलबैक नहीं किया जा सकता. रेप्लिका या बैकअप का इस्तेमाल करके रोल बैक करना एक जटिल प्रक्रिया है. इसमें डाउनटाइम और/या डेटा लॉस हो सकता है. समस्याओं को हल करना और Cassandra 5.0.X पर अपग्रेड करना, रोल बैक करने से बेहतर है.
अपग्रेड करने से पहले, रोलबैक की प्रोसेस के बारे में जानना ज़रूरी है. अपग्रेड के दौरान रोलबैक की बारीकियों को ध्यान में रखना ज़रूरी है, ताकि रोलबैक के सही तरीके उपलब्ध हों.

सिंगल डेटा सेंटर

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

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

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

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

रोलबैक के लिए, कम से कम एक डेटा सेंटर में Cassandra का पुराना वर्शन (4.0.X) चलना ज़रूरी है.

अपग्रेड करने का सुझाया गया तरीका

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

रोलबैक चेकपॉइंट की प्रोसेस

सिंगल रोलबैक चेकपॉइंट: जब सभी कॉम्पोनेंट को 4.54.00 पर अपग्रेड कर दिया जाता है, तब Cassandra रोलबैक सिर्फ़ तब किया जा सकता है, जब कम से कम एक Cassandra डेटा सेंटर पुराने वर्शन पर काम कर रहा हो. Cassandra के आखिरी डेटा सेंटर को अपग्रेड करने के बाद, Edge for Private Cloud 4.54.00 पर अपग्रेड करने की प्रोसेस पूरी हो जाती है. इसके बाद, पहले वाले वर्शन पर वापस नहीं जाया जा सकता.

उदाहरण

दो डेटा सेंटर (डीसी) क्लस्टर का उदाहरण देखें:

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

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

आपको Edge for Private Cloud 4.53.00 (या) 4.53.01 के साथ Cassandra 4.0.X चलाना चाहिए. साथ ही, यह पक्का करना चाहिए कि:

सर्वर पर Java 17 को डिफ़ॉल्ट Java वर्शन के तौर पर सेट करें: Cassandra 5.0.X, Java 8 के साथ काम नहीं करता. Java 8 के साथ Cassandra 5.0.X या इसकी nodetool सुविधा का इस्तेमाल नहीं किया जा सकता. पक्का करें कि हर Cassandra नोड पर Java 17 इंस्टॉल हो. साथ ही, Cassandra को अपग्रेड करने के चरण पूरे करने से पहले, Java 17 को डिफ़ॉल्ट Java वर्शन के तौर पर सेट करें. इससे nodetool कमांड, Java 17 के साथ काम करेंगी:
```
alternatives --set java JAVA_17_PATH/bin/java
```
पुष्टि करें कि डिफ़ॉल्ट रूप से चालू Java वर्शन, Java 17 है:
```
java -version
```
पूरा क्लस्टर चालू है और Cassandra 4.0.X के साथ पूरी तरह से काम कर रहा है.
कंपैक्शन की रणनीति को LeveledCompactionStrategy पर सेट किया गया है. यह 4.53.00 (या) 4.53.01 वर्शन पर अपग्रेड करने के लिए ज़रूरी है.
पुष्टि करें कि Edge for Private Cloud के 4.53.00 (या) 4.53.01 वर्शन में, Cassandra 4.0.X के शुरुआती अपग्रेड के तौर पर, यहां दिया गया हर चरण पूरा किया गया हो.
- पिछले अपग्रेड के दौरान, हर Cassandra नोड पर post_upgrade कमांड को चलाया गया था
- पिछले अपग्रेड के दौरान, drop_old_tables कमांड को पूरे Cassandra क्लस्टर पर चलाया गया था.

अगर आपको पक्के तौर पर नहीं पता कि Edge for Private Cloud 4.53.00 (या) 4.53.01 का इस्तेमाल करते समय, Cassandra 4.0.X पर post_upgrade और drop_old_tables कमांड चलाए गए थे या नहीं, तो 4.54.00 पर अपग्रेड करने से पहले, उन्हें फिर से चलाया जा सकता है.

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

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

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

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

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

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

किसी Cassandra नोड को अपग्रेड करने के लिए, यह कमांड चलाएं:
```
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
```
किसी नोड को अपडेट करने के बाद, आगे बढ़ने से पहले कुछ मान्यताओं को पूरा करने के लिए, नोड पर यह निर्देश चलाएं:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
```

ऊपर दिए गए कोड का आउटपुट कुछ इस तरह होगा:

Cassandra version is verified - [cqlsh 6.2.0 | Cassandra 5.0.8 | CQL spec 3.4.7 | Native protocol v5]
Metadata is verified

Cassandra नोड पर, post_upgrade कमांड चलाएं:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

Cassandra नोड पर, यहां दिया गया cleanup_old_index कमांड चलाएं:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra cleanup_old_index
```
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 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 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 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 cache cache_entries cache_entries_cache_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 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

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

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

किसी अपडेट को रोल बैक करना

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

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

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

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

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

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

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

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

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

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

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

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

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

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

राउटर और मैसेज प्रोसेसर, दोनों के नोड पर:
- अपडेट करने से पहले – ये काम करें:
  1. राऊटर को अनरीचेबल बनाएं.
  2. मैसेज प्रोसेसर को ऐक्सेस न किया जा सके.
- अपडेट करने के बाद – ये काम करें:
  1. मैसेज प्रोसेसर को ऐक्सेस करने लायक बनाना.
  2. राउटर को ऐक्सेस किया जा सके.
एक राउटर नोड पर:
- अपडेट करने से पहले, राऊटर को अनरीचेबल बनाएं.
- अपडेट करने के बाद, राऊटर को कनेक्ट करें.
सिंगल मैसेज प्रोसेसर नोड पर:
- अपडेट करने से पहले, मैसेज प्रोसेसर को ऐक्सेस न किया जा सके.
- अपडेट करने के बाद, मैसेज प्रोसेसर को ऐक्सेस करने लायक बनाएं.

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

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

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

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

अगर Cassandra पर रिपेयर ऑपरेशन करने के लिए, कोई cron जॉब कॉन्फ़िगर किया गया है, तो अपडेट पूरा होने तक उसे बंद कर दें.
Edge RPM इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.

ध्यान दें: आरपीएम इंस्टॉलेशन के लिए रूट ऐक्सेस की ज़रूरत होती है. हालांकि, रूट ऐक्सेस के बिना भी Edge को कॉन्फ़िगर किया जा सकता है.
Edge apigee-setup सुविधा इंस्टॉल करें में बताए गए तरीके से, SELinux को बंद करें .
अगर आपको AWS पर इंस्टॉल करना है , तो yum-configure-manager की ये कमांड चलाएं:
```
yum update rh-amazon-rhui-client.noarch
yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
```
अगर फ़िलहाल, Edge for Private Cloud 4.53.00 (या) 4.53.01 का इस्तेमाल किया जा रहा है, तो:
1. Edge bootstrap_4.54.00.sh फ़ाइल को /tmp/bootstrap_4.54.00.sh में डाउनलोड करें :
```
curl https://software.apigee.com/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
2. Edge 4.54.00 apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करने के लिए, यह कमांड दें:
```
bash /tmp/bootstrap_4.54.00.sh apigeeuser=uName apigeepassword=pWord
```
  जहां uName:pWord, Apigee से मिला उपयोगकर्ता नाम और पासवर्ड है. अगर आपने pWord नहीं डाला है, तो आपसे इसे डालने के लिए कहा जाएगा.
  
  डिफ़ॉल्ट रूप से, इंस्टॉलर यह जांच करता है कि आपके पास Java 17 और 21 इंस्टॉल है या नहीं.
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 का वह कॉम्पोनेंट है जिसे अपडेट करना है. इन वैल्यू का इस्तेमाल किया जा सकता है:
    - edge : New Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, QPID सर्वर, Postgres सर्वर
    - ldap : OpenLDAP
    - ue : Edge का नया यूज़र इंटरफ़ेस (यूआई)
    - qpid : Apigee Qpid
    - ps : Apigee Postgresql
    - zk : ZooKeeper
    - cs : Cassandra
  - configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.53.00 (या) 4.53.01 वर्शन इंस्टॉल करते समय, अपने Edge कॉम्पोनेंट तय करने के लिए किया था.
  ध्यान दें: कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता पढ़ सके. मालिक बदलने के लिए, इस निर्देश का इस्तेमाल करें:
```
chown apigee:apigee configFile
```
  component को "all" पर सेट करके, सभी कॉम्पोनेंट के लिए update.sh चलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge की ऑल-इन-वन (एआईओ) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
7. अगर आपने पहले से ऐसा नहीं किया है, तो New Edge यूज़र इंटरफ़ेस (यूआई) के कॉम्पोनेंट को चलाने वाले सभी नोड पर, उन्हें रीस्टार्ट करें:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
8. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर, अपडेट की जांच करें. इसके बारे में इंस्टॉल की जांच करें में बताया गया है.

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

स्थानीय रिपॉज़िटरी से 4.54.00 पर अपडेट करना

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

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

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

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

Edge apigee-setup सुविधा इंस्टॉल करें में जाकर, "लोकल Apigee रिपॉज़िटरी बनाएं" में बताए गए तरीके से, लोकल 4.54.00 रिपॉज़िटरी बनाएं.

ध्यान दें: अगर आपके पास पहले से कोई रिपॉज़िटरी है, तो उसमें 4.54.00 रिपॉज़िटरी को जोड़ा जा सकता है. इसके लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करें में जाकर, "लोकल Apigee रिपॉज़िटरी को अपडेट करें" में बताया गया तरीका अपनाएं.
इनमें से किसी एक तरीके का इस्तेमाल करके, टारगेट नोड पर apigee-service इंस्टॉल करें:
- पहला विकल्प: .tar फ़ाइल से apigee-service इंस्टॉल करना
  1. लोकल रेपो वाले नोड पर, लोकल रेपो को /opt/apigee/data/apigee-mirror/apigee-4.54.00.tar.gz नाम की एक .tar फ़ाइल में पैकेज करने के लिए, इस कमांड का इस्तेमाल करें:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
```
  2. .tar फ़ाइल को उस नोड पर कॉपी करें जहां आपको Edge को अपडेट करना है. उदाहरण के लिए, इसे नए नोड पर /tmp डायरेक्ट्री में कॉपी करें.
  3. नए नोड पर, फ़ाइल को /tmp डायरेक्ट्री में अनटार करें:
```
tar -xzf apigee-4.54.00.tar.gz
```
    यह कमांड, .tar फ़ाइल वाली डायरेक्ट्री में repos नाम की एक नई डायरेक्ट्री बनाता है. उदाहरण के लिए, /tmp/repos.
  4. /tmp/repos से Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
```
bash /tmp/repos/bootstrap_4.54.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
```
    ध्यान दें कि इस निर्देश में, रिपॉज़िटरी डायरेक्ट्री का पाथ शामिल किया जाता है.
- दूसरा विकल्प: Nginx वेब सर्वर का इस्तेमाल करके, apigee-service इंस्टॉल करना
  1. Nginx वेब सर्वर को कॉन्फ़िगर करें. इसके लिए, Edge apigee-setup सुविधा इंस्टॉल करें में जाकर, "Nginx वेब सर्वर का इस्तेमाल करके, रेपो से इंस्टॉल करें" में बताया गया तरीका अपनाएं.
  2. रिमोट नोड पर, Edge bootstrap_4.54.00.sh फ़ाइल को /tmp/bootstrap_4.54.00.sh में डाउनलोड करें:
```
/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.54.00.sh -o /tmp/bootstrap_4.54.00.sh
```
    जहां uName:pWord वह उपयोगकर्ता नाम और पासवर्ड है जिसे आपने पहले रिपॉज़िटरी के लिए सेट किया था. साथ ही, remoteRepo रिपॉज़िटरी नोड का आईपी पता या डीएनएस नाम है.
  3. रिमोट नोड पर, Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
```
bash /tmp/bootstrap_4.54.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
```
    जहां uName:pWord, रेपो का उपयोगकर्ता नाम और पासवर्ड हैं.
apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें. इसके बारे में यहां दिए गए उदाहरण में बताया गया है:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
```
मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें, जैसा कि इस उदाहरण में दिखाया गया है:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
```
मैनेजमेंट सर्वर पर apigee-provision यूटिलिटी को अपडेट करें, जैसा कि इस उदाहरण में दिखाया गया है:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
```
मशीन अपडेट करने का क्रम में बताए गए क्रम में, अपने नोड पर update यूटिलिटी चलाएं:
```
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
```
कहां:
- component, Edge का वह कॉम्पोनेंट है जिसे अपडेट करना है. इन वैल्यू का इस्तेमाल किया जा सकता है:
  - edge : New Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, QPID सर्वर, Postgres सर्वर
  - ldap : OpenLDAP
  - ue : Edge का नया यूज़र इंटरफ़ेस (यूआई)
  - qpid : Apigee Qpid
  - ps : Apigee Postgresql
  - zk : ZooKeeper
  - cs : Cassandra
- configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.53.00 (या) 4.53.01 वर्शन इंस्टॉल करते समय, अपने Edge कॉम्पोनेंट तय करने के लिए किया था.
  
  ध्यान दें: कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता पढ़ सके. मालिक बदलने के लिए, इस निर्देश का इस्तेमाल करें:
```
chown apigee:apigee configFile
```
component को "all" पर सेट करके, सभी कॉम्पोनेंट के लिए update.sh चलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge की ऑल-इन-वन (एआईओ) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:
```
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
```
अगर आपने पहले से ऐसा नहीं किया है, तो यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को चलाने वाले सभी नोड पर उन्हें रीस्टार्ट करें:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart
```
मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर, अपडेट की जांच करें. इसके बारे में इंस्टॉल करने की जांच करें में बताया गया है.

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

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

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

-c edge विकल्प का इस्तेमाल करके, सभी डेटा सेंटर में मौजूद सभी राऊटर और मैसेज प्रोसेसर नोड को अपग्रेड करें.
-c edge विकल्प का इस्तेमाल करके, सभी डेटा सेंटर में मौजूद सभी मैनेजमेंट सर्वर नोड अपग्रेड करें.
सभी डेटा सेंटर में मौजूद सभी LDAP नोड को अपग्रेड करें. अगर Edge for Private Cloud 4.53.00 से अपग्रेड किया जा रहा है, तो आपको एलडीएपी अपग्रेड करने के लिए खास तरीके अपनाने होंगे
सभी डेटा सेंटर में यूज़र इंटरफ़ेस (यूआई) और Apigee एसएसओ (अगर इंस्टॉल किया गया है) को अपग्रेड करें:
1. अगर apigee-sso इंस्टॉल नहीं है: New Edge UI पर अपग्रेड करने के लिए, पहला विकल्प: Apigee SSO के बिना यूज़र इंटरफ़ेस (यूआई) को अपग्रेड करना में दिए गए निर्देशों का पालन करें.
2. अगर apigee-sso इंस्टॉल है: New Edge यूज़र इंटरफ़ेस (यूआई) और Apigee SSO पर अपग्रेड करने के लिए, दूसरा विकल्प: यूज़र इंटरफ़ेस (यूआई) को अपग्रेड करना (Apigee SSO के साथ) में दिया गया तरीका अपनाएं.
Qpid के खास चरणों का पालन करके, सभी डेटा सेंटर में मौजूद सभी Qpid और edge-qpid-server कॉम्पोनेंट को अपग्रेड करें.
Postgres के खास चरणों का पालन करके, सभी डेटा सेंटर में मौजूद सभी Postgresql और edge-postgres-server कॉम्पोनेंट को अपग्रेड करें
Zookeeper को अपग्रेड करने के खास तरीके अपनाकर, सभी डेटा सेंटर में मौजूद Zookeeper के सभी कॉम्पोनेंट अपग्रेड करें.
Cassandra को अपग्रेड करने के खास तरीके अपनाकर, सभी डेटा सेंटर में मौजूद Cassandra के सभी कॉम्पोनेंट अपग्रेड करें.
कमाई करने की सुविधा को अपडेट करने के लिए, कोई अलग चरण नहीं है. -c edge विकल्प चुनने पर, इसे अपडेट किया जाता है.

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

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

Edge for Private Cloud 4.53.00 से अपग्रेड करते समय, सभी कॉम्पोनेंट को अपग्रेड करने से पहले, एलडीएपी को अपग्रेड करना ज़रूरी है. इसके लिए, 4.53.00 से 4.54.00 पर अपग्रेड करने का तरीका अपनाएं.

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

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

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

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

मशीन 1 पर Edge कॉम्पोनेंट अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
मशीन 1 पर LDAP को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
मशीन 1 पर New Edge UI को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
ध्यान दें: अगर apigee-sso इंस्टॉल है, तो कृपया इसे Apigee SSO के साथ कॉन्फ़िगर करने के निर्देशों के लिए, दूसरा विकल्प: यूज़र इंटरफ़ेस (Apigee SSO के साथ) अपग्रेड करें देखें.
मशीन 2 पर Edge कॉम्पोनेंट अपडेट करना:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
मशीन 2 पर Qpid को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
मशीन 2 पर Postgres को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
मशीन 1 पर Cassandra और ZooKeeper को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
(अगर आपने apigee-adminapi इंस्टॉल किया है) मशीन 1 पर apigee-adminapi यूटिलिटी को अपडेट करें:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

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

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

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

मशीन 2, 3, और 1 पर Edge के कॉम्पोनेंट अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
मशीन 1 पर LDAP को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
```
मशीन 1 में New Edge UI को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
```
ध्यान दें: अगर apigee-sso इंस्टॉल है, तो कृपया इसे Apigee SSO के साथ कॉन्फ़िगर करने के निर्देशों के लिए, दूसरा विकल्प: यूज़र इंटरफ़ेस (Apigee SSO के साथ) अपग्रेड करें देखें.
मशीन 4, 5 पर Edge के कॉम्पोनेंट अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
```
मशीन 4 और 5 पर Qpid को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
```
मशीन 4 और 5 पर Postgres को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
```
मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
```
/opt/apigee/apigee-setup/bin/update.sh -c zk,cs -f configFile
```
(अगर आपने apigee-adminapi इंस्टॉल किया है) मशीन 1 पर apigee-adminapi यूटिलिटी को अपडेट करें:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
```

9-नोड क्लस्टर अपग्रेड

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

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

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

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

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

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

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

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

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

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

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

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

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

राऊटर
मैसेज प्रोसेसर
मैनेजमेंट सर्वर
LDAP
यूज़र इंटरफ़ेस (क्लासिक यूज़र इंटरफ़ेस या नया यूज़र इंटरफ़ेस)
एसएसओ (अगर लागू हो)
Qpid और edge-qpid-server
Postgres और edge-postgres-server
ZooKeeper
कैसंड्रा
apigee-adminapi

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

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

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

पहले से पढ़ने के लिए मटीरियल

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

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

राऊटर और मैसेज प्रोसेसर को अपग्रेड करना

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

OpenLDAP 2.6.10 पर अपग्रेड करना

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

LDAP को 4.53.00 से 4.54.00 पर अपग्रेड करने का तरीका

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

एलडीएपी को 4.53.01 से 4.54.00 पर अपग्रेड करने का तरीका

नए Edge यूज़र इंटरफ़ेस (यूआई) और Apigee SSO (अगर इंस्टॉल किया गया है) पर अपग्रेड करें

पहला विकल्प: यूज़र इंटरफ़ेस (यूआई) को अपग्रेड करना (Apigee एसएसओ के बिना)

पहला चरण: कॉन्फ़िगरेशन फ़ाइलों का बैक अप लेना

दूसरा चरण: बेसिक ऑथेंटिकेशन के लिए, साइलेंट कॉन्फ़िगरेशन फ़ाइल को अपडेट करना

तीसरा चरण: यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को अपग्रेड करना

चौथा चरण: Edge के नए यूज़र इंटरफ़ेस (यूआई) के अपग्रेड की पुष्टि करना

दूसरा विकल्प: यूज़र इंटरफ़ेस (यूआई) को अपग्रेड करना (Apigee एसएसओ के साथ)

पहला चरण: कॉन्फ़िगरेशन फ़ाइलों का बैक अप लेना

दूसरा चरण: इस्तेमाल नहीं किए जा रहे यूआई/एसएसओ वैरिएबल हटाएं और साइलेंट कॉन्फ़िगरेशन फ़ाइल (configFile) अपडेट करें

तीसरा चरण: New Edge यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को अपग्रेड करना

चौथा चरण: apigee-sso को बंद करना

पांचवां चरण: Postgres नोड में Apigee SSO के लिए apigee_dex डेटाबेस बनाना

छठा चरण: OpenLDAP नोड पर Apigee SSO सेट अप करना

सातवां चरण: Apigee SSO के लिए मैनेजमेंट यूआई को कॉन्फ़िगर करना और यूआई को रीस्टार्ट करना

आठवां चरण: नए Edge यूज़र इंटरफ़ेस (यूआई) और Apigee एसएसओ के अपग्रेड की पुष्टि करना

नौवां चरण: लेगसी apigee-sso को अनइंस्टॉल करना

Qpid 10.0.1 पर अपग्रेड करें

Postgres 18.6 पर अपग्रेड करें

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

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

शुरुआती चरण

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

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

Postgres के लिए अपग्रेड के बाद के चरण

ZooKeeper 3.8.5 पर अपग्रेड करना

बैकअप लेना

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

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

लीडर को शटडाउन करना

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

लीडर को अपग्रेड करें

Cassandra 5.0.8 पर अपग्रेड करना

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

सिंगल डेटा सेंटर

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

अपग्रेड करने का सुझाया गया तरीका

रोलबैक चेकपॉइंट की प्रोसेस

उदाहरण

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

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

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

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

किसी अपडेट को रोल बैक करना

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

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

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

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

स्थानीय रिपॉज़िटरी से 4.54.00 पर अपडेट करना

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

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

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

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

9-नोड क्लस्टर अपग्रेड

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

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

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

दूसरा चरण: इस्तेमाल नहीं किए जा रहे यूआई/एसएसओ वैरिएबल हटाएं और साइलेंट कॉन्फ़िगरेशन फ़ाइल (`configFile`) अपडेट करें

चौथा चरण: `apigee-sso` को बंद करना

पांचवां चरण: Postgres नोड में Apigee SSO के लिए `apigee_dex` डेटाबेस बनाना

नौवां चरण: लेगसी `apigee-sso` को अनइंस्टॉल करना