Apigee, Edge for Private Cloud को सीधे तौर पर 4.51.00, 4.52.00 या 4.52.01 वर्शन से 4.52.02 वर्शन पर अपग्रेड करने की सुविधा देता है. इस पेज पर, इस तरह के अपग्रेड करने का तरीका बताया गया है.
अपडेट कौन कर सकता है
अपडेट करने वाला व्यक्ति वही होना चाहिए जिसने Edge को इंस्टॉल किया था या वह व्यक्ति जो रूट के तौर पर काम कर रहा है.
Edge RPM इंस्टॉल करने के बाद, कोई भी व्यक्ति उन्हें कॉन्फ़िगर कर सकता है.
आपको कौनसे कॉम्पोनेंट अपडेट करने होंगे
आपको Edge के सभी कॉम्पोनेंट अपडेट करने होंगे. Edge में ऐसा सेटअप काम नहीं करता जिसमें कई वर्शन के कॉम्पोनेंट शामिल हों.
अपडेट करने के लिए ज़रूरी शर्तें
Apigee Edge को अपग्रेड करने से पहले, इन ज़रूरी शर्तों को पूरा करें:
- सभी नोड का बैकअप लें
हमारा सुझाव है कि अपडेट करने से पहले, सुरक्षा के लिहाज़ से सभी नोड का पूरा बैकअप लें. बैकअप लेने के लिए, Edge के मौजूदा वर्शन के लिए बताई गई प्रोसेस का इस्तेमाल करें.इससे आपको एक बैकअप प्लान मिलता है. अगर नया वर्शन ठीक से काम नहीं करता है, तो आपके पास पुराने वर्शन पर वापस जाने का विकल्प होता है. बैकअप लेने के बारे में ज़्यादा जानने के लिए, बैकअप और रीस्टोर लेख पढ़ें.
- पक्का करें कि Edge चालू हो
इस निर्देश का इस्तेमाल करके, पक्का करें कि अपडेट की प्रोसेस के दौरान Edge चालू हो:/opt/apigee/apigee-service/bin/apigee-all status
- पक्का करें कि Cassandra Compaction Strategy
LeveledCompactionStrategyहो
अपने मौजूदा वर्शन के हिसाब से, Cassandra Compaction Strategy में ज़रूरी बदलाव करें. यहां दिया गया तरीका अपनाएं. इसके बाद, अपग्रेड करने की मुख्य प्रोसेस पर वापस जाएं:- अगर आपको 4.51.00 वर्शन से अपग्रेड करना है, तो Cassandra Compaction Strategy document for v4.51.00 देखें.
- अगर आपको 4.52.00 वर्शन से अपग्रेड करना है, तो v4.52.00 के लिए Cassandra Compaction Strategy दस्तावेज़ देखें.
- अगर आपको 4.52.01 वर्शन से अपग्रेड करना है, तो v4.52.01 के लिए Cassandra Compaction Strategy दस्तावेज़ देखें.
अपग्रेड करने के लिए किन खास बातों का ध्यान रखना चाहिए
Edge for Private Cloud 4.52.02 पर अपग्रेड करने के लिए, कुछ सॉफ़्टवेयर को अपग्रेड करने के लिए बताए गए तरीके अपनाएं. ज़रूरी कदम, आपके मौजूदा वर्शन पर निर्भर करते हैं. यहां दी गई टेबल में, उन सॉफ़्टवेयर की जानकारी दी गई है जिनके लिए अतिरिक्त चरणों की ज़रूरत होती है. साथ ही, हर सॉफ़्टवेयर के लिए दिए गए निर्देशों का पालन करें. ज़रूरी टास्क पूरे करने के बाद, अपग्रेड की प्रोसेस जारी रखने के लिए, अपग्रेड की मुख्य प्रोसेस पर वापस जाएं.
| वर्तमान वर्शन | ऐसा सॉफ़्टवेयर जिसे 4.52.02 पर अपग्रेड करने के लिए, खास चरणों को पूरा करना ज़रूरी है |
|---|---|
| 4.52.01 | Cassandra |
| 4.52.00 | Zookeeper, Cassandra, Qpid |
| 4.51.00 | Zookeeper, Postgres, Cassandra, Qpid |
अपने वर्शन के हिसाब से ज़रूरी चरण पूरे करने के बाद, अपग्रेड की मुख्य प्रोसेस पर वापस जाएं.
प्रॉपर्टी की सेटिंग अपने-आप लागू होने की सुविधा
अगर आपने /opt/apigee/customer/application में .properties फ़ाइलों में बदलाव करके कोई प्रॉपर्टी सेट की है, तो अपडेट के बाद भी वे वैल्यू बनी रहेंगी.
Zookeeper 3.8.3 पर अपग्रेड करना
Edge for Private Cloud 4.52.02 में, Zookeeper का अपग्रेड शामिल नहीं है. हालांकि, अगर 4.52.01 से पुराने वर्शन से अपग्रेड किया जा रहा है, तो आपको Zookeeper को अपग्रेड करने के लिए यहां दिया गया तरीका अपनाना होगा.
- अगर Edge for Private Cloud के 4.51.00 या 4.52.00 वर्शन से अपग्रेड किया जा रहा है, तो Zookeeper को अपग्रेड करने के लिए, Zookeeper 3.8.3 पर अपग्रेड करना ज़रूरी है में दिया गया तरीका अपनाएं.
- अगर Edge for Private Cloud के 4.52.01 वर्शन से अपग्रेड किया जा रहा है, तो हो सकता है कि आप पहले से ही Zookeeper के 3.8.3 वर्शन का इस्तेमाल कर रहे हों. ऐसे में, आपको Zookeeper को अपग्रेड करने के लिए कोई खास तरीका अपनाने की ज़रूरत नहीं है.
Postgres 14 पर अपग्रेड करना
- अगर Edge for Private Cloud 4.51.00 से 4.52.02 पर अपग्रेड किया जा रहा है, तो आपको Postgres को अपग्रेड करने का तरीका अपनाना होगा. भले ही, Edge for Private Cloud 4.52.02 में Postgres अपग्रेड शामिल न हो. Edge for Private Cloud 4.51.00 से 4.52.02 पर अपग्रेड करने के लिए, Postgres को अपग्रेड करने के अतिरिक्त चरणों को पूरा करना ज़रूरी है. कृपया Postgres 14 पर अपग्रेड करना ज़रूरी है सेक्शन देखें.
- अगर Edge for Private Cloud को 4.52.00 या 4.52.01 से 4.52.02 पर अपग्रेड किया जा रहा है, तो Postgres को अपग्रेड करने के लिए कोई और तरीका अपनाने की ज़रूरत नहीं है.
Cassandra 3.11.16 पर अपग्रेड करना
Apigee Edge for Private Cloud 4.52.02 में, Cassandra को 3.11.16 वर्शन पर अपग्रेड किया गया है. Cassandra, Apigee का एक अहम कॉम्पोनेंट है. इस अपग्रेड में, Cassandra को क्वेरी करने और उसमें डेटा लिखने के लिए इस्तेमाल किए जाने वाले अलग-अलग रनटाइम और मैनेजमेंट कॉम्पोनेंट में, ड्राइवर सॉफ़्टवेयर के अपडेट भी शामिल हैं.
यह एक बड़ा अपग्रेड है. इसलिए, Cassandra में Apigee के डेटा मॉडल में कुछ बदलाव करना ज़रूरी था, ताकि नए वर्शन में बेहतर परफ़ॉर्मेंस मिल सके. हालांकि, ये बदलाव बहुत कम हैं, लेकिन अपग्रेड की प्रोसेस शुरू होने पर, कुछ Management API में रुकावट आती है. आम तौर पर, जिन Management API में रुकावट आती है उनकी सूची यहां दी गई है.
इसके अलावा, अपग्रेड की प्रोसेस की वजह से, अपग्रेड किए जा रहे डेटा सेंटर में रनटाइम प्रॉक्सी फ़्लो और मैनेजमेंट एपीआई के बड़े सेट में रुकावट आती है. यह ज़रूरी है कि आप अपने रनटाइम और मैनेजमेंट ट्रैफ़िक को अपग्रेड किए जा रहे डेटा सेंटर से अलग रखें, ताकि इस तरह की रुकावट को कम किया जा सके. ज़्यादा जानकारी के लिए, यहां दिए गए एक डेटा सेंटर और एक से ज़्यादा डेटा सेंटर वाले सेक्शन पढ़ें.
डेवलपर पोर्टल - एपीआई का दस्तावेज़ बनाना
Apigee Drupal डेवलपर पोर्टल, आपके एपीआई को दस्तावेज़ में शामिल करने के लिए कई सुविधाएं देता है. हमारा सुझाव है कि आप Drupal 7 पर आधारित डेवलपर पोर्टल का इस्तेमाल बंद कर दें. हालांकि, अगर अब भी इसका इस्तेमाल किया जा रहा है और इसकी SmartDocs सुविधा का इस्तेमाल किया जा रहा है, तो SmartDocs एपीआई का इस्तेमाल करना दस्तावेज़ आप पर लागू होता है. अगर डेवलपर पोर्टल के नए वर्शन का इस्तेमाल किया जा रहा है, तो इस अपग्रेड के दौरान आपके एपीआई दस्तावेज़ पर कोई असर नहीं पड़ेगा.
Apigee को 4.52.02 वर्शन पर अपग्रेड करने पर, Drupal 7 डेवलपर पोर्टल की SmartDocs सुविधा का इस्तेमाल करके बनाए गए एपीआई मॉडल, नए वर्शन पर अपने-आप माइग्रेट नहीं होंगे. आपको डेवलपर पोर्टल का इस्तेमाल करके, हर मॉडल को मैन्युअल तरीके से एक्सपोर्ट करना होगा. साथ ही, अपग्रेड पूरा होने के बाद, उसे फिर से इंपोर्ट करना होगा.
यहां इस्तेमाल की गई शब्दावली
रनटाइम: रनटाइम में, आपके रनटाइम प्रॉक्सी ट्रैफ़िक को मैनेज करना शामिल है. इसमें आपके राऊटर और मैसेज प्रोसेसर की ओर से की जाने वाली सभी कार्रवाइयां शामिल हैं. इनकी मदद से, मौजूदा प्रॉक्सी के लिए रनटाइम एपीआई अनुरोध को असरदार तरीके से प्रोसेस किया जाता है. हालांकि, इसमें नई प्रॉक्सी या प्रॉक्सी के नए वर्शन को डिप्लॉय करना शामिल नहीं है.
मैनेजमेंट: मैनेजमेंट में, आपके Apigee Edge सिस्टम का एडमिनिस्ट्रेशन शामिल है. इसमें डिप्लॉयमेंट, ऐप्लिकेशन में बदलाव, प्रॉडक्ट, टारगेट सर्वर, कीस्टोर वगैरह शामिल हैं. हालांकि, इनके अलावा और भी चीज़ें शामिल हो सकती हैं. सभी Management API (और उनके क्लाइंट, जैसे कि Apigee यूज़र इंटरफ़ेस (यूआई) और डेवलपर पोर्टल) इस दायरे में शामिल हैं.
इस अपग्रेड के दौरान, उस इलाके या डेटा सेंटर (डीसी) में रनटाइम और मैनेजमेंट ट्रैफ़िक पर असर पड़ता है जहां अपडेट लागू किया जा रहा है. डेटा सेंटर को अपडेट किए जाने के बावजूद, सभी डेटा सेंटर में कुछ मैनेजमेंट एपीआई पर असर पड़ता है. हर चरण के बाद, इस असर को नोट किया जाता है.
नीचे दिए गए हर चरण में, अपग्रेड की प्रोसेस के अलग-अलग चरणों के दौरान रनटाइम और मैनेजमेंट की स्थिति के बारे में बताया गया है.
रणनीतियों को अपग्रेड करना
एक से ज़्यादा डेटा सेंटर
अपग्रेड की प्रोसेस एक बार में एक डेटा सेंटर के लिए की जानी चाहिए, ताकि ट्रैफ़िक बना रहे और डाउनटाइम से बचा जा सके. किसी डीसी को अपग्रेड करने से पहले, ट्रैफ़िक को अन्य चालू डीसी पर रीडायरेक्ट किया जाना चाहिए.
सिंगल डेटा सेंटर
एक डेटा सेंटर सेटअप के लिए, अपग्रेड की प्रोसेस से रनटाइम ट्रैफ़िक और कुछ मैनेजमेंट एपीआई पर काफ़ी असर पड़ेगा. एक डेटा सेंटर सेटअप के लिए, ये विकल्प उपलब्ध हैं.
- Edge for Private Cloud क्लस्टर को कुछ समय के लिए किसी डेटा सेंटर में बढ़ाएं. इसके लिए, अपग्रेड के दौरान ट्रैफ़िक को मैनेज करने के लिए, मौजूदा डेटा सेंटर के साथ-साथ एक डेटा सेंटर जोड़ें. इसके बाद, अपग्रेड की प्रोसेस पूरी होने पर, किसी एक डेटा सेंटर को बंद करें.
- अगर आपके पास किसी अन्य डेटा सेंटर में अपग्रेड करने का विकल्प नहीं है, तो डाउनटाइम के लिए तैयार रहें. साथ ही, अपग्रेड को कम ट्रैफ़िक वाले समय के लिए शेड्यूल करें, ताकि मैनेजमेंट एपीआई और रनटाइम ट्रैफ़िक पर कम से कम असर पड़े.
हमारा सुझाव है कि आप एक और डेटा सेंटर जोड़ें, ताकि रनटाइम ट्रैफ़िक और Management API पर कोई असर न पड़े. अपग्रेड के दौरान, डेटा सेंटर पर होने वाले असर में ये चीज़ें शामिल हैं. हालांकि, इनके अलावा और भी चीज़ें शामिल हो सकती हैं:
- OAuth टोकन रीफ़्रेश करने वाले रनटाइम एपीआई
- ऐक्सेस एंटिटी की नीति का इस्तेमाल करने वाले रनटाइम एपीआई
- डेवलपर ऐप्लिकेशन की सूची बनाने वाले Management API
- प्रॉडक्ट की लिस्टिंग करने वाले Management API
ऊपर बताए गए असर के अलावा, कुछ खास मैनेजमेंट एपीआई भी सभी डेटा सेंटर पर तब तक काम नहीं करेंगे, जब तक सभी डेटा सेंटर अपग्रेड नहीं हो जाते. इस तरह के मैनेजमेंट एपीआई, आगे के सेक्शन में दिए गए चरणों में बताए गए हैं.
रोलबैक - हाई लेवल
- रोलबैक के दौरान होने वाला असर
Cassandra 3.11.x से 2.1.x पर रोल बैक करने से, डेटा सेंटर (डीसी) में रनटाइम और मैनेजमेंट ट्रैफ़िक, दोनों पर असर पड़ता है. ऐसा उस डेटा सेंटर में होता है जहां रोलबैक किया जा रहा है. इसके अलावा, कुछ मैनेजमेंट एपीआई में सभी डेटा सेंटर में रुकावटें आ सकती हैं. भले ही, फ़िलहाल किसी भी डीसी को रोल बैक किया जा रहा हो.
- डीसी बाय डीसी रोलबैक अप्रोच का पालन करना
सेवा में रुकावट और डाउनटाइम से बचने के लिए, रोलबैक की प्रोसेस को एक बार में एक ही डेटा सेंटर पर लागू किया जाना चाहिए. किसी डेटा सेंटर में रोलबैक शुरू करने से पहले, पक्का करें कि ऐप्लिकेशन ट्रैफ़िक को पूरी तरह से काम कर रहे किसी दूसरे डेटा सेंटर पर रीडायरेक्ट किया गया हो.
- आंशिक रूप से अपग्रेड किए गए क्लस्टर को रोल बैक करना
अगर Cassandra (2.1.22) के पुराने वर्शन पर कम से कम एक डेटा सेंटर पूरी तरह से काम कर रहा है, तो अपग्रेड किए गए अन्य डीसी को वापस रोल बैक किया जा सकता है. इसके लिए, पूरी तरह से काम करने वाले Cassandra 2.1.X डीसी से फिर से डेटा बनाना होगा.
- क्लस्टर-वाइड रोलबैक
अगर पूरे Cassandra क्लस्टर को अपग्रेड कर दिया गया है और उसे रोलबैक करना है, तो इसके लिए बैकअप या वीएम स्नैपशॉट का इस्तेमाल करना होगा. यह तरीका मुश्किल है. इससे कुछ समय के लिए डाउनटाइम या डेटा का नुकसान हो सकता है.
- अपग्रेड करने से पहले ध्यान रखने वाली बातें
अपग्रेड करने से पहले, यह ज़रूरी है कि आपको रोलबैक करने की प्रोसेस के बारे में पता हो. अपग्रेड करते समय, रोलबैक की बारीकियों पर ध्यान देना ज़रूरी है, ताकि यह पक्का किया जा सके कि रोलबैक के सही पाथ उपलब्ध हों.
एक डेटा सेंटर वाले रोलबैक क्लस्टर
Cassandra को 2.1.x से 3.11.x वर्शन में अपग्रेड करने से, रनटाइम ट्रैफ़िक और कुछ मैनेजमेंट एपीआई पर काफ़ी असर पड़ सकता है. ये असर, रोलबैक के दौरान भी लागू होते हैं. इनकी वजह से, डाउनटाइम या डेटा का नुकसान हो सकता है.
हमारा सुझाव है कि प्रोडक्शन वर्कलोड के लिए, अपग्रेड करने से पहले एक नया डेटा सेंटर तैयार करें. इससे, डेटा को नुकसान पहुंचाए बिना या एपीआई ट्रैफ़िक में रुकावट डाले बिना, सुरक्षित तरीके से रोलबैक किया जा सकता है. अपग्रेड पूरा होने के बाद, अतिरिक्त डेटा सेंटर को बंद किया जा सकता है.
अगर नया डेटा सेंटर जोड़ना मुमकिन नहीं है, लेकिन रोलबैक की सुविधा अब भी ज़रूरी है, तो पक्का करें कि अपग्रेड करने से पहले भरोसेमंद बैकअप लिए गए हों. Cassandra 2.1.x को बैकअप से वापस लाया जा सकता है. हालांकि, इस तरीके से सेवा डाउनटाइम और डेटा के नुकसान की संभावना हो सकती है.
कई डेटा सेंटर वाले क्लस्टर को रोलबैक करना
एक से ज़्यादा डेटा सेंटर को रोल बैक करने के लिए, डेटा सेंटर-दर-डेटा सेंटर (डीसी-दर-डीसी) तरीका अपनाया जाता है. इस तरीके में, जिस डेटा सेंटर को रोल बैक किया जा रहा है उसके ट्रैफ़िक को अन्य डेटा सेंटर पर रीडायरेक्ट किया जाता है. इससे Cassandra, मैनेजमेंट सर्वर, और रनटाइम नोड के लिए, रोलबैक की प्रोसेस को कंट्रोल और अलग किया जाता है, ताकि ट्रैफ़िक में कोई रुकावट न आए.
ज़्यादा जानकारी के लिए, Cassandra 3.11.16 अपडेट को रोलबैक करना सेक्शन देखें.
सबसे पहले: शुरुआती स्थिति
- Zookeeper, Postgres, और LDAP कॉम्पोनेंट को पहले ही 4.52.02 वर्शन पर अपग्रेड कर दिया गया है. प्राइवेट क्लाउड क्लस्टर के लिए आपका Edge, स्टेबल है और काम कर रहा है. अगर रोलबैक करना ज़रूरी है, तो क्लस्टर को इस स्थिति में रोलबैक कर दिया जाएगा.
- Apigee में Cassandra का वर्शन 2.1.22 चल रहा है.
- Edge के कॉम्पोनेंट:
- मैनेजमेंट-सर्वर, पुराने थ्रिफ़्ट प्रोटोकॉल के ज़रिए Cassandra से कम्यूनिकेट कर रहा है.
- रनटाइम सर्वर (मैसेज प्रोसेसर और राऊटर), Cassandra के साथ पुराने थ्रिफ़्ट प्रोटोकॉल के ज़रिए कम्यूनिकेट कर रहे हैं.
| इस चरण में रनटाइम की स्थिति | इस चरण में मैनेजमेंट की स्थिति |
|---|---|
| रनटाइम पूरी तरह से काम कर रहा है | मैनेजमेंट पूरी तरह से काम कर रहा है |
पहला चरण: अपग्रेड करने की तैयारी करना
यहां दिया गया तरीका, उन स्टैंडर्ड फ़ाइलों के अलावा है जिन्हें आम तौर पर बनाया जाता है. जैसे, कॉम्पोनेंट अपग्रेड चालू करने के लिए, Apigee की स्टैंडर्ड कॉन्फ़िगरेशन फ़ाइल.
- Cassandra को LeveledCompactionStrategy का इस्तेमाल करने के लिए बदलें.
- Apigee का इस्तेमाल करके, Cassandra का बैकअप लें.
- Cassandra नोड के वीएम स्नैपशॉट लें (अगर मुमकिन हो).
-
हर Cassandra नोड पर
/opt/apigee/apigee-cassandra/cass_upgrade.confमें, Cassandra को अपग्रेड करने के लिए कॉन्फ़िगरेशन फ़ाइल बनाएं. इसमें यह कॉन्टेंट शामिल करें: अगर# IP Address of node HOSTIP=10.0.0.1 # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication. CASS_USERNAME=<cassuser> # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication. CASS_PASSWORD=<casspass> # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped. CASS_PORT=9160 # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped. CASS_CQL_PORT=9042 # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped. # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly. CASS_TMP_DIR=/tmp/cass_upgrade_scripts/opt/apigee/apigee-cassandra/cass_upgrade.confपर फ़ाइल नहीं बनाई जा सकती, तो हर Cassandra नोड पर एक ही कॉन्टेंट वाली/opt/silent.confफ़ाइल बनाएं. - अगर Apigee Drupal 7 डेवलपर पोर्टल की SmartDocs सुविधा का इस्तेमाल किया जाता है, तो डेवलपर पोर्टल के यूज़र इंटरफ़ेस (यूआई) से JSON फ़ॉर्मैट में डाउनलोड करके, अपने हर मॉडल को एक्सपोर्ट करें. मैनेजमेंट सर्वर अपडेट होने के बाद, इन मॉडल को Apigee में फिर से इंपोर्ट करना होगा.
- पक्का करें कि Edge के सभी कॉम्पोनेंट से Cassandra नोड तक, पोर्ट 9160 और 9042 को ऐक्सेस किया जा सकता हो. ऐसा तब करें, जब ये पहले से मौजूद न हों. ज़्यादा जानकारी के लिए, पोर्ट से जुड़ी ज़रूरी शर्तें देखें.
दूसरा चरण: ट्रैफ़िक को पहले डेटा सेंटर से रीडायरेक्ट करना
- पहले डेटा सेंटर से आने वाले रनटाइम और मैनेजमेंट ट्रैफ़िक को ब्लॉक करें.
- सभी रनटाइम ट्रैफ़िक और Management API को, काम कर रहे अन्य डेटा सेंटर पर रीडायरेक्ट करें.
- पुष्टि करें कि रनटाइम और मैनेजमेंट ट्रैफ़िक को अन्य डीसी सही तरीके से मैनेज कर रहे हैं.
तीसरा चरण: पहले डेटा सेंटर में मौजूद सभी Cassandra नोड को अपग्रेड करना
-
डेटा सेंटर में मौजूद सभी 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 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
- अपग्रेड पूरा होने के बाद, हर Cassandra नोड पर एक-एक करके यह
post_upgradeकमांड चलाएं:/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
| इस चरण में रनटाइम की स्थिति | इस चरण में मैनेजमेंट की स्थिति |
|---|---|
|
|
चौथा चरण: पहले डेटा सेंटर में मौजूद सभी मैनेजमेंट नोड अपग्रेड करना
डेटा सेंटर में मौजूद सभी मैनेजमेंट नोड को अपग्रेड करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
| इस चरण में रनटाइम की स्थिति | इस चरण में मैनेजमेंट की स्थिति |
|---|---|
|
|
पांचवां चरण: पहले डेटा सेंटर में मौजूद सभी रनटाइम नोड को अपग्रेड करना
डेटा सेंटर में मौजूद सभी राऊटर और मैसेज प्रोसेसर नोड को एक-एक करके अपग्रेड करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
| इस चरण में रनटाइम की स्थिति | इस चरण में मैनेजमेंट की स्थिति |
|---|---|
|
|
छठा चरण: ट्रैफ़िक को वापस पहले डेटा सेंटर पर रीडायरेक्ट करना
- पहले डेटा सेंटर को Cassandra, रनटाइम कॉम्पोनेंट, और मैनेजमेंट-सर्वर के साथ अपग्रेड करने के बाद, पहले डेटा सेंटर पर रनटाइम और मैनेजमेंट ट्रैफ़िक को फिर से चालू करें.
- पक्का करें कि सभी डीसी में रनटाइम और मैनेजमेंट ट्रैफ़िक सही तरीके से काम कर रहा हो.
सातवां चरण: अन्य डेटा सेंटर अपग्रेड करना
बाकी डेटा सेंटर पर, पहले चरण से लेकर छठे चरण तक की प्रोसेस को एक-एक करके दोहराएं. इसके लिए, इन डेटा सेंटर से ट्रैफ़िक को रीडायरेक्ट करें, Apigee सॉफ़्टवेयर को अपडेट करें, और इन डेटा सेंटर पर ट्रैफ़िक को फिर से चालू करें.
आठवां चरण: सभी मैनेजमेंट नोड में अपग्रेड करने का चरण फिर से चलाएं
सभी डेटा सेंटर के मैनेजमेंट नोड में, अपग्रेड करने के लिए यह कमांड फिर से चलाएं:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
नौवां चरण - [ज़रूरी नहीं] पहले एक्सपोर्ट किए गए स्मार्टडॉक इंपोर्ट करना
सभी मैनेजमेंट सर्वर अपग्रेड होने के बाद, पहले चरण में एक्सपोर्ट किए गए स्मार्ट डॉक्स मॉडल इंपोर्ट किए जा सकते हैं. आपके पास बाद में भी ऐसा करने का विकल्प है.
आपको ऐसा सिर्फ़ तब करना होगा, जब Drupal 7 पर आधारित डेवलपर पोर्टल का इस्तेमाल किया जा रहा हो और SmartDocs की सुविधा का इस्तेमाल किया जा रहा हो.
| इस चरण में रनटाइम की स्थिति | इस चरण में मैनेजमेंट की स्थिति |
|---|---|
| रनटाइम पूरी तरह से काम कर रहा है | मैनेजमेंट पूरी तरह से काम कर रहा है |
10वां चरण - इस्तेमाल नहीं की जा रही टेबल हटाएं
Cassandra क्लस्टर से पुरानी और इस्तेमाल न की गई टेबल हटाने के लिए, यह कमांड चलाएं. जब तक यह स्क्रिप्ट नहीं चलाई जाती, तब तक Cassandra की कुछ सुविधाओं का इस्तेमाल नहीं किया जा सकता. जैसे, पुष्टि करने का नया तरीका सेट अप करना. हालांकि, पुष्टि करने के पुराने तरीके काम करते रहेंगे. इस निर्देश को क्लस्टर में सिर्फ़ एक नोड पर चलाया जा सकता है
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile
11वां चरण - Private Cloud 4.52.02 के लिए, Edge के बाकी सभी कॉम्पोनेंट और अन्य कॉम्पोनेंट अपग्रेड करना
सभी इलाकों में मौजूद, बाकी बचे सभी edge-qpid-server और edge-postgres-server नोड को एक-एक करके अपग्रेड करें.
इस चरण में, अगर आपको Edge for Private Cloud 4.52.01 से पहले के वर्शन से अपग्रेड करना है, तो Qpid और Postgres को अपग्रेड करने के लिए, यहां दिए गए अतिरिक्त चरणों को पूरा करें. साथ ही, बाकी कॉम्पोनेंट को अपग्रेड करने के लिए, इन चरणों को पूरा करें.
Qpid J-Broker पर अपग्रेड करना
Edge for Private Cloud 4.52.02 में Qpid को अपग्रेड करने की सुविधा शामिल नहीं है. हालांकि, अगर 4.52.01 से पुराने वर्शन से अपग्रेड किया जा रहा है, तो आपको QPID को अपग्रेड करने के लिए यह तरीका अपनाना होगा.
- अगर Edge for Private Cloud को 4.51.00 या 4.52.00 से 4.52.02 पर अपग्रेड किया जा रहा है, तो Qpid को अपग्रेड करने के लिए अतिरिक्त चरणों का पालन करना ज़रूरी है. अगर आपको 4.51.00 या 4.52.00 वर्शन से 4.52.02 पर अपग्रेड करना है, तो कृपया Qpid को अपग्रेड करें सेक्शन देखें.
- अगर Edge for Private Cloud 4.52.01 से 4.52.02 पर अपग्रेड किया जा रहा है, तो आपको Qpid Broker के नए वर्शन का इस्तेमाल करना चाहिए. इसके लिए, Qpid को अपग्रेड करने के लिए कोई और तरीका अपनाने की ज़रूरत नहीं है.
Edge का नया यूज़र इंटरफ़ेस (यूआई)
इस सेक्शन में, Edge के यूज़र इंटरफ़ेस (यूआई) से जुड़ी ज़रूरी बातों के बारे में बताया गया है. ज़्यादा जानकारी के लिए, Private Cloud के लिए नया Edge यूज़र इंटरफ़ेस (यूआई) देखें.
Edge यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करना
शुरुआती इंस्टॉलेशन पूरा करने के बाद, Apigee आपको Edge यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करने का सुझाव देता है. यह Apigee Edge for Private Cloud के डेवलपर और एडमिन के लिए बेहतर यूज़र इंटरफ़ेस है.
ध्यान दें कि Edge यूज़र इंटरफ़ेस (यूआई) के लिए, आपको पुष्टि करने की सामान्य स्कीम को बंद करना होगा. साथ ही, एसएएमएल या एलडीएपी जैसे IDP का इस्तेमाल करना होगा.
ज़्यादा जानकारी के लिए, Edge का नया यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करना लेख पढ़ें.
Edge के यूज़र इंटरफ़ेस (यूआई) को अपडेट करना
Edge यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को अपडेट करने के लिए, Edge for Private Cloud के उस वर्शन को ध्यान में रखें जिससे आपको अपग्रेड करना है:
- 4.51.00 से 4.52.00 तक (नया Edge यूज़र इंटरफ़ेस (यूआई) पहले से इंस्टॉल होने पर):
edge-management-uiकॉम्पोनेंट के लिए, इस सेक्शन में दिए गए अपग्रेड करने के निर्देश इस्तेमाल करें.
Apigee mTLS की मदद से अपडेट करना
Apigee mTLS को अपडेट करने के लिए, यह तरीका अपनाएं:
किसी अपडेट को पहले जैसा करना
अगर अपडेट नहीं हो पाता है, तो समस्या को ठीक करने की कोशिश करें. इसके बाद, update.sh को फिर से चलाएं. अपडेट को कई बार चलाया जा सकता है. यह अपडेट को वहीं से जारी रखता है जहां इसे पिछली बार छोड़ा गया था.
अगर अपडेट पूरा न होने की वजह से आपको पिछले वर्शन पर रोल बैक करना पड़े, तो ज़्यादा जानकारी के लिए 4.52.00 पर रोल बैक करें लेख पढ़ें.
अपडेट की जानकारी लॉग करना
डिफ़ॉल्ट रूप से, update.sh यूटिलिटी, लॉग की जानकारी को यहां सेव करती है:
/opt/apigee/var/log/apigee-setup/update.log
अगर update.sh यूटिलिटी चलाने वाले व्यक्ति के पास उस डायरेक्ट्री का ऐक्सेस नहीं है, तो यह लॉग को /tmp डायरेक्ट्री में update_username.log नाम की फ़ाइल के तौर पर सेव करता है.
अगर आपके पास /tmp का ऐक्सेस नहीं है, तो update.sh यूटिलिटी काम नहीं करेगी.
बिना किसी रुकावट के अपडेट करना
ज़ीरो-डाउनटाइम अपडेट या रोलिंग अपडेट की मदद से, Edge को बंद किए बिना ही Edge इंस्टॉलेशन को अपडेट किया जा सकता है.
ज़ीरो-डाउनटाइम अपडेट सिर्फ़ पांच या उससे ज़्यादा नोड वाले कॉन्फ़िगरेशन के साथ ही किया जा सकता है.
बिना किसी डाउनटाइम के अपग्रेड करने के लिए, लोड बैलेंसर से हर राऊटर को एक-एक करके हटाएं. इसके बाद, राऊटर और उसी मशीन पर मौजूद अन्य कॉम्पोनेंट को अपडेट करें. साथ ही, राऊटर को लोड बैलेंसर में वापस जोड़ें.
- मशीनों को अपने इंस्टॉलेशन के लिए सही क्रम में अपडेट करें, जैसा कि मशीन अपडेट करने का क्रम में बताया गया है.
- जब राऊटर अपडेट करने का समय हो, तो किसी एक राऊटर को चुनें और उसे ऐक्सेस न किया जा सकने वाला बनाएं. इसके बारे में सर्वर (मैसेज प्रोसेसर/राऊटर) को ऐक्सेस करने की सुविधा चालू/बंद करना में बताया गया है.
- चुने गए राऊटर और Edge के अन्य सभी कॉम्पोनेंट को उसी मशीन पर अपडेट करें जिस पर राऊटर है. Edge के सभी कॉन्फ़िगरेशन, एक ही नोड पर राऊटर और मैसेज प्रोसेसर दिखाते हैं.
- राऊटर को फिर से कनेक्ट करें.
- बाकी बचे राउटर के लिए, दूसरे से चौथे चरण तक की प्रक्रिया दोहराएं.
- इंस्टॉलेशन में बची हुई मशीनों के लिए अपडेट जारी रखें.
अपडेट करने से पहले और बाद में, इन बातों का ध्यान रखें:
- राऊटर और मैसेज प्रोसेसर के कंबाइंड नोड पर:
- अपडेट करने से पहले – ये काम करें:
- राऊटर को अनरीचेबल बनाएं.
- मैसेज प्रोसेसर को अनरीचेबल बनाएं.
- अपडेट करने के बाद – ये काम करें:
- मैसेज प्रोसेसर को ऐक्सेस किया जा सके.
- राऊटर को ऐसी जगह पर रखें जहां से वह आसानी से कनेक्ट हो सके.
- अपडेट करने से पहले – ये काम करें:
- एक राऊटर नोड पर:
- अपडेट करने से पहले, राऊटर को अनरीचेबल बनाएं.
- अपडेट करने के बाद, राऊटर को कनेक्ट करें.
- सिंगल मैसेज प्रोसेसर नोड पर:
- अपडेट करने से पहले, मैसेज प्रोसेसर को ऐक्सेस न किया जा सकने वाला बनाएं.
- अपडेट करने के बाद, मैसेज प्रोसेसर को ऐक्सेस करने लायक बनाएं.
साइलेंट कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करना
आपको अपडेट कमांड के लिए, एक साइलेंट कॉन्फ़िगरेशन फ़ाइल पास करनी होगी. साइलेंट कॉन्फ़िगरेशन फ़ाइल वही होनी चाहिए जिसका इस्तेमाल आपने Edge 4.50.00 या 4.51.00 को इंस्टॉल करने के लिए किया था.
बाहरी इंटरनेट कनेक्शन वाले नोड पर, 4.52.02 पर अपडेट करना
किसी नोड पर Edge कॉम्पोनेंट अपडेट करने के लिए, यह तरीका अपनाएं:
- अगर Cassandra पर रिपेयर ऑपरेशन करने के लिए कॉन्फ़िगर किया गया कोई
cronजॉब मौजूद है, तो अपडेट पूरा होने तक उसे बंद कर दें. - Edge RPMs इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
yum-utilsऔरyum-plugin-prioritiesइंस्टॉल करें:sudo yum install yum-utils
sudo yum install yum-plugin-priorities- Edge apigee-setup यूटिलिटी इंस्टॉल करना लेख में बताए गए तरीके से, SELinux को बंद करें.
- अगर Oracle 7.x पर इंस्टॉल किया जा रहा है, तो यह कमांड चलाएं:
sudo yum-config-manager --enable ol7_optional_latest
- अगर 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 अगर फ़िलहाल Edge 4.51.00 का इस्तेमाल किया जा रहा है, तो:
- 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.52.02.sh
- यहां दिया गया कमांड चलाकर, Edge 4.52.02
apigee-serviceयूटिलिटी और डिपेंडेंसी इंस्टॉल करें:sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
जहां uName:pWord, Apigee से मिला उपयोगकर्ता नाम और पासवर्ड है. अगर आपने pWord को शामिल नहीं किया है, तो आपको इसे डालने के लिए कहा जाएगा.
डिफ़ॉल्ट रूप से, इंस्टॉलर यह जांच करता है कि आपके पास Java 1.8 इंस्टॉल है या नहीं. अगर आपने ऐसा नहीं किया, तो इंस्टॉलर इसे आपके लिए इंस्टॉल कर देगा.
Java इंस्टॉलेशन को मैनेज करने का तरीका बताने के लिए,
JAVA_FIXविकल्प का इस्तेमाल करें.JAVA_FIXके लिए ये वैल्यू इस्तेमाल की जा सकती हैं:I: OpenJDK 1.8 (डिफ़ॉल्ट) इंस्टॉल करें.C: Java इंस्टॉल किए बिना जारी रखें.Q: Quit. इस विकल्प के लिए, आपको Java खुद इंस्टॉल करना होगा.
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 का वह कॉम्पोनेंट है जिसे अपडेट करना है. इनमें ये शामिल हैं:
cs: Cassandraedge: Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, Qpid सर्वर, Postgres सर्वरldap: OpenLDAPps: postgresqlqpid: qpiddsso: Apigee SSO (अगर आपने एसएसओ इंस्टॉल किया है)ue: Edge का नया यूज़र इंटरफ़ेस (यूआई)ui: Classic Edge का यूज़र इंटरफ़ेस (यूआई)zk: ज़ूकीपर
- configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.50.00 या 4.51.00 इंस्टॉलेशन के दौरान, Edge के कॉम्पोनेंट तय करने के लिए किया था.
component को "all" पर सेट करके, सभी कॉम्पोनेंट के लिए
update.shको चलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge ऑल-इन-वन (एआईओ) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component, Edge का वह कॉम्पोनेंट है जिसे अपडेट करना है. इनमें ये शामिल हैं:
- अगर आपने पहले से ऐसा नहीं किया है, तो Edge यूज़र इंटरफ़ेस (यूआई) के कॉम्पोनेंट को चलाने वाले सभी नोड पर उन्हें रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- मैनेजमेंट सर्वर पर
apigee-validateयूटिलिटी चलाकर, अपडेट की जांच करें. इसके बारे में इंस्टॉल की जांच करें में बताया गया है.
- Edge
अगर आपको बाद में अपडेट को रोल बैक करना है, तो 4.52.02 को रोल बैक करें में बताई गई प्रोसेस का इस्तेमाल करें.
लोकल रिपॉज़िटरी से 4.52.02 पर अपडेट करना
अगर आपके Edge नोड फ़ायरवॉल के पीछे हैं या उन्हें इंटरनेट पर Apigee रिपॉज़िटरी को ऐक्सेस करने की अनुमति नहीं है, तो अपडेट को किसी लोकल रिपॉज़िटरी या Apigee रिपॉज़िटरी के मिरर से किया जा सकता है.#heading
लोकल Edge रिपॉज़िटरी बनाने के बाद, आपके पास लोकल रिपॉज़िटरी से Edge को अपडेट करने के दो विकल्प होते हैं:
- रिपॉज़िटरी की .tar फ़ाइल बनाएं, .tar फ़ाइल को किसी नोड में कॉपी करें, और फिर .tar फ़ाइल से Edge को अपडेट करें.
- लोकल रिपॉज़िटरी वाले नोड पर वेबसर्वर इंस्टॉल करें, ताकि अन्य नोड उसे ऐक्सेस कर सकें. Apigee, आपको इस्तेमाल करने के लिए Nginx वेबसर्वर उपलब्ध कराता है. इसके अलावा, आपके पास अपने वेबसर्वर का इस्तेमाल करने का विकल्प भी होता है.
लोकल 4.52.02 रिपॉज़िटरी से अपडेट करने के लिए:
- Edge apigee-setup सुविधा इंस्टॉल करें में "लोकल Apigee रिपॉज़िटरी बनाएं" में बताए गए तरीके से, लोकल 4.52.02 रिपॉज़िटरी बनाएं.
- .tar फ़ाइल से apigee-service इंस्टॉल करने के लिए:
- लोकल डेटाबेस वाले नोड पर, लोकल डेटाबेस को
/opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gzनाम वाली एक .tar फ़ाइल में पैकेज करने के लिए, इस कमांड का इस्तेमाल करें:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- .tar फ़ाइल को उस नोड पर कॉपी करें जहां आपको Edge को अपडेट करना है. उदाहरण के लिए, इसे नए नोड पर
/tmpडायरेक्ट्री में कॉपी करें. - नए नोड पर, फ़ाइल को
/tmpडायरेक्ट्री में अनटार करें:tar -xzf apigee-4.52.02.tar.gz
यह कमांड, .tar फ़ाइल वाली डायरेक्ट्री में
reposनाम की एक नई डायरेक्ट्री बनाता है. उदाहरण के लिए,/tmp/repos. /tmp/reposसे Edgeapigee-serviceयूटिलिटी और डिपेंडेंसी इंस्टॉल करें:sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
ध्यान दें कि इस निर्देश में, रिपॉज़िटरी डायरेक्ट्री का पाथ शामिल किया जाता है.
- लोकल डेटाबेस वाले नोड पर, लोकल डेटाबेस को
- Nginx वेबसर्वर का इस्तेमाल करके apigee-service इंस्टॉल करने के लिए:
- Nginx वेब सर्वर को कॉन्फ़िगर करें. इसके लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करें में जाकर, "Nginx वेब सर्वर का इस्तेमाल करके, रिपॉज़िटरी से इंस्टॉल करें" में बताया गया तरीका अपनाएं.
- रिमोट नोड पर, Edge
bootstrap_4.52.02.shफ़ाइल को/tmp/bootstrap_4.52.02.shमें डाउनलोड करें:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
यहां uName:pWord वह उपयोगकर्ता नाम और पासवर्ड है जो आपने पहले रिपॉज़िटरी के लिए सेट किया था. साथ ही, remoteRepo रिपॉज़िटरी नोड का आईपी पता या डीएनएस नाम है.
- रिमोट नोड पर, Edge
apigee-setupयूटिलिटी और डिपेंडेंसी इंस्टॉल करें:sudo bash /tmp/bootstrap_4.52.02.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 का वह कॉम्पोनेंट है जिसे अपडेट करना है. आम तौर पर, इन कॉम्पोनेंट को अपडेट किया जाता है:
cs: Cassandraedge: Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, Qpid सर्वर, Postgres सर्वरldap: OpenLDAPps: postgresqlqpid: qpiddsso: Apigee SSO (अगर आपने एसएसओ इंस्टॉल किया है)ueNew Edge UIui: Classic Edge का यूज़र इंटरफ़ेस (यूआई)zk: ज़ूकीपर
- configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.50.00 या 4.51.00 इंस्टॉलेशन के दौरान, अपने Edge कॉम्पोनेंट तय करने के लिए किया था.
component को "all" पर सेट करके, सभी कॉम्पोनेंट के लिए
update.shको चलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge ऑल-इन-वन (एआईओ) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component, Edge का वह कॉम्पोनेंट है जिसे अपडेट करना है. आम तौर पर, इन कॉम्पोनेंट को अपडेट किया जाता है:
- अगर आपने अब तक ऐसा नहीं किया है, तो यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को चलाने वाले सभी नोड पर उन्हें रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- मैनेजमेंट सर्वर पर
apigee-validateयूटिलिटी चलाकर, अपडेट की जांच करें. इसके बारे में इंस्टॉल की जांच करें में बताया गया है.
अगर आपको बाद में अपडेट को रोल बैक करना है, तो 4.52.02 को रोल बैक करें में बताई गई प्रोसेस का इस्तेमाल करें.
मशीन अपडेट करने का क्रम - 4.51.00 (या) 4.52.00 (या) 4.52.01 से अपग्रेड करें
Edge इंस्टॉलेशन में मशीनों को अपडेट करने का क्रम अहम होता है:
- अन्य सभी कॉम्पोनेंट को अपग्रेड करने से पहले, आपको सभी डेटा सेंटर में मौजूद ZooKeeper के सभी नोड को अपडेट करना होगा. अगर Edge Private Cloud 4.51.00 (या) 4.52.00 से अपग्रेड किया जा रहा है, तो आपको zookeeper को अपग्रेड करने के लिए, कुछ और चरणों को भी पूरा करना होगा.
- आपको सभी डेटा सेंटर में Postgresql को अपडेट करना होगा. अगर Edge Private Cloud 4.51.00 से अपग्रेड किया जा रहा है, तो आपको postgres को अपग्रेड करने के लिए, कुछ और चरणों को भी पूरा करना होगा.
- आपको सभी डेटा सेंटर में एलडीएपी नोड अपडेट करने होंगे.
- आपको सभी Cassandra, मैनेजमेंट सर्वर, मैसेज प्रोसेसर, और राऊटर नोड को अपडेट करना होगा. इसके लिए, एक बार में एक डेटा सेंटर को अपडेट करें. ऐसा तब तक करें, जब तक सभी डेटा सेंटर अपग्रेड न हो जाएं.
- आपको सभी डेटा सेंटर में
edge-qpid-serverऔरedge-postgres-serverकॉम्पोनेंट अपडेट करने होंगे. - आपको सभी डेटा सेंटर में Qpid नोड अपग्रेड करने होंगे. अगर Edge Private Cloud 4.51.00 (या) 4.52.00 से अपग्रेड किया जा रहा है, तो आपको Qpid को अपग्रेड करने के लिए, कुछ और चरणों को भी पूरा करना होगा.
- सभी डेटा सेंटर में Edge यूज़र इंटरफ़ेस (यूआई) और नए Edge यूज़र इंटरफ़ेस (यूआई), एसएसओ नोड को अपडेट करना.
- कमाई करने की सुविधा को अपडेट करने के लिए, कोई अलग चरण नहीं है. -c edge विकल्प की जानकारी देने पर, इसे अपडेट किया जाता है.
1-नोड वाला स्टैंडअलोन अपग्रेड
एक नोड वाले स्टैंडअलोन कॉन्फ़िगरेशन को 4.52.02 पर अपग्रेड करने के लिए:- सभी कॉम्पोनेंट अपडेट करना:
/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
2-नोड वाला स्टैंडअलोन अपग्रेड
दो नोड वाले स्टैंडअलोन इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:
Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.
- मशीन 1 पर Zookeeper को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
- मशीन 2 पर Postgres को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- मशीन 1 पर LDAP को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- मशीन 1 पर Cassandra को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- मशीन 1 और 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
- मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (अगर आपने
apigee-adminapiइंस्टॉल किया है) मशीन 1 परapigee-adminapiयूटिलिटी को अपडेट किया गया:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (अगर आपने Apigee SSO इंस्टॉल किया है) मशीन 1 पर Apigee SSO को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ इंस्टॉल करते समय बनाया था.
- मशीन 1 पर Edge यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
पांच नोड वाला अपग्रेड
पांच नोड वाले इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:
Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.
- मशीन 1, 2, और 3 पर ZooKeeper को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
- मशीन 4 पर Postgres को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- मशीन 5 पर Postgres को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- मशीन 1 पर LDAP को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- मशीन 1, 2, और 3 पर Cassandra को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- मशीन 1, 2, 3, 4, 5 पर Edge के कॉम्पोनेंट अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- मशीन 4 पर Qpid को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- मशीन 5 पर Qpid को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 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
- क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 1 पर
- (अगर आपने
apigee-adminapiइंस्टॉल किया है) मशीन 1 परapigee-adminapiयूटिलिटी को अपडेट किया गया:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (अगर आपने Apigee SSO इंस्टॉल किया है) मशीन 1 पर Apigee SSO को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ इंस्टॉल करते समय बनाया था.
- यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
- क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 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
- क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 1 पर
9-नोड वाले क्लस्टर को अपग्रेड करना
नौ नोड वाले क्लस्टर इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:
Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.
- मशीन 1, 2, और 3 पर ZooKeeper को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c zk -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 पर LDAP को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- मशीन 1, 2, और 3 पर Cassandra को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- मशीन 1, 4, 5, 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
- मशीन 1 पर, नए यूज़र इंटरफ़ेस (
ue) या क्लासिक यूज़र इंटरफ़ेस (ui) को अपडेट करें:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (अगर आपने
apigee-adminapiइंस्टॉल किया है) मशीन 1 परapigee-adminapiयूटिलिटी को अपडेट करें:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (अगर आपने Apigee SSO इंस्टॉल किया है) मशीन 1 पर Apigee SSO को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ इंस्टॉल करते समय बनाया था.
- यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
- क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 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
- क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 1 पर
13-नोड वाले क्लस्टर को अपग्रेड करना
13-नोड वाले क्लस्टर इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:
Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.
- मशीन 1, 2, और 3 पर ZooKeeper को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c zk -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
- मशीन 4 और 5 पर LDAP को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- मशीन 1, 2, और 3 पर Cassandra को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- मशीन 6, 7, 10, 11, 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
- मशीन 6 और 7 पर, नए यूज़र इंटरफ़ेस (
ue) या क्लासिक यूज़र इंटरफ़ेस (ui) को अपडेट करें:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (अगर आपने
apigee-adminapiइंस्टॉल किया है) मशीन 6 और 7 परapigee-adminapiयूटिलिटी को अपडेट किया गया:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (अगर आपने Apigee SSO इंस्टॉल किया है) मशीन 6 और 7 पर Apigee SSO को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
यहां sso_config_file वह कॉन्फ़िगरेशन फ़ाइल है जिसे आपने एसएसओ इंस्टॉल करते समय बनाया था.
- यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
- क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 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
- क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो मशीन 6 और 7 पर
12-नोड वाले क्लस्टर को अपग्रेड करना
12-नोड वाले क्लस्टर इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:
Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.
दोनों डीसी में मशीन 1,2,3,7,8,9 पर ZooKeeper को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
- दोनों डीसी में मशीन 6,12 पर Postgres को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- दोनों डीसी में मशीन 1,7 पर LDAP अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
डीसी-1 में ट्रैफ़िक को ब्लॉक करें और पक्का करें कि सारा ट्रैफ़िक दूसरे डीसी-2 पर रीडायरेक्ट हो
- DC-1 में मशीन 1,2,3 पर Cassandra को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- डीसी-1 में मशीन 1 पर मैनेजमेंट सर्वर को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- डीसी-1 में मशीन 2,3 पर राऊटर और मैसेज प्रोसेसर को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- डीसी-1 में ट्रैफ़िक को अनब्लॉक करें और डीसी-1 की पुष्टि करें. इसके बाद, डीसी-2 में ट्रैफ़िक को ब्लॉक करके और ट्रैफ़िक को डीसी-1 पर फिर से रूट करके, डीसी-2 के साथ आगे बढ़ें
- डीसी-2 में मशीन 7,8,9 पर Cassandra को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- डीसी-2 में मशीन 7 पर मैनेजमेंट सर्वर को अपडेट करना:
/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
- DC-2 में ट्रैफ़िक को अनब्लॉक करें. अब दोनों डीसी ट्रैफ़िक को मैनेज करेंगे
- मशीन 1 और 7 पर, सभी डीसी में मौजूद सभी मैनेजमेंट-सर्वर में अपडेट कमांड को फिर से चलाएं:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- दोनों डीसी में मशीन 4,5,6,10,11,12 पर edge-qpid-server और edge-postgres-server को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- दोनों डीसी में मशीन 4,5,10,11 पर Qpid को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- दोनों डीसी में, नए यूज़र इंटरफ़ेस (ue) या क्लासिक यूज़र इंटरफ़ेस (ui) को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (अगर आपने apigee-adminapi इंस्टॉल किया है) दोनों डीसी में apigee-adminapi को अपडेट करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (अगर आपने Apigee SSO इंस्टॉल किया है) दोनों डीसी में Apigee SSO नोड अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
- दोनों डीसी में, नए Edge यूज़र इंटरफ़ेस (edge-management-ui) या क्लासिक Edge यूज़र इंटरफ़ेस (edge-ui) कॉम्पोनेंट को रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart