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 का v4.51.00 के लिए दस्तावेज़ देखें.
- अगर आपको वर्शन 4.52.00 से अपग्रेड करना है, तो Cassandra Compaction Strategy document for v4.52.00 देखें.
- अगर आपको वर्शन 4.52.01 से अपग्रेड करना है, तो Cassandra Compaction Strategy का वर्शन 4.52.01 वाला दस्तावेज़ देखें.
अपग्रेड करने के लिए, कौनसे खास तरीके अपनाए जा सकते हैं
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 के डेटा मॉडल में कुछ बदलाव करना ज़रूरी था. हालांकि, ये बदलाव बहुत कम हैं. फिर भी, अपग्रेड की प्रोसेस शुरू होने पर, कुछ मैनेजमेंट एपीआई काम नहीं करते. आम तौर पर, जिन मैनेजमेंट एपीआई पर असर पड़ता है उनकी सूची यहां दी गई है.
इसके अलावा, अपग्रेड की प्रोसेस की वजह से, अपग्रेड किए जा रहे डेटा सेंटर में रनटाइम प्रॉक्सी फ़्लो और मैनेजमेंट एपीआई के बड़े सेट में रुकावट आती है. यह ज़रूरी है कि अपग्रेड किए जा रहे डेटा सेंटर से, रनटाइम और मैनेजमेंट ट्रैफ़िक को अलग किया जाए, ताकि इस तरह की रुकावट को कम किया जा सके. ज़्यादा जानकारी के लिए, नीचे दिए गए एक डेटा सेंटर और एक से ज़्यादा डेटा सेंटर के सेक्शन पढ़ें.
Developer Portal - Documenting APIs
Apigee Drupal डेवलपर पोर्टल, आपके एपीआई के दस्तावेज़ बनाने के लिए कई सुविधाएं देता है. हमारा सुझाव है कि Drupal 7 पर आधारित डेवलपर पोर्टल का इस्तेमाल बंद कर दें. हालांकि, अगर अब भी इसका इस्तेमाल किया जा रहा है और इसकी SmartDocs सुविधा का इस्तेमाल किया जा रहा है, तो SmartDocs API का इस्तेमाल करना दस्तावेज़ आपके लिए है. अगर डेवलपर पोर्टल के नए वर्शन का इस्तेमाल किया जा रहा है, तो इस अपग्रेड के दौरान आपके एपीआई के दस्तावेज़ों पर कोई असर नहीं पड़ेगा.
Apigee को 4.52.02 वर्शन पर अपग्रेड करने पर, Drupal 7 डेवलपर पोर्टल की SmartDocs सुविधा का इस्तेमाल करके बनाए गए सभी एपीआई मॉडल, नए वर्शन में अपने-आप माइग्रेट नहीं होंगे. आपको डेवलपर पोर्टल का इस्तेमाल करके, हर मॉडल को मैन्युअल तरीके से एक्सपोर्ट करना होगा. साथ ही, अपग्रेड पूरा होने के बाद, उसे फिर से इंपोर्ट करना होगा.
यहां इस्तेमाल की गई शब्दावली
रनटाइम: रनटाइम में, आपके रनटाइम प्रॉक्सी ट्रैफ़िक को मैनेज करना शामिल होता है. इसमें आपके राऊटर और मैसेज प्रोसेसर की ओर से की जाने वाली सभी कार्रवाइयां शामिल होती हैं. इनकी मदद से, मौजूदा प्रॉक्सी के लिए रनटाइम एपीआई अनुरोध को असरदार तरीके से प्रोसेस किया जाता है. हालांकि, इसमें नई प्रॉक्सी या प्रॉक्सी के नए वर्शन को डिप्लॉय करना शामिल नहीं है.
मैनेजमेंट: मैनेजमेंट में, आपके Apigee Edge सिस्टम का एडमिनिस्ट्रेशन शामिल है. इसमें डिप्लॉयमेंट, ऐप्लिकेशन, प्रॉडक्ट, टारगेट सर्वर, कीस्टोर वगैरह में बदलाव करना शामिल है. हालांकि, इसमें और भी चीज़ें शामिल हो सकती हैं. इस स्कोप में सभी मैनेजमेंट एपीआई (और उनके क्लाइंट, जैसे कि Apigee UI और डेवलपर पोर्टल) शामिल हैं.
इस अपग्रेड के दौरान, उस क्षेत्र या डेटा सेंटर (डीसी) में रनटाइम और मैनेजमेंट ट्रैफ़िक पर असर पड़ता है जहां अपडेट किया जा रहा है. डेटा सेंटर को अपडेट किया जा रहा है या नहीं, इससे कोई फ़र्क़ नहीं पड़ता. सभी डेटा सेंटर में कुछ मैनेजमेंट एपीआई पर इसका असर पड़ता है. हर चरण के बाद, इस असर को नोट किया जाता है.
अपग्रेड करने की प्रोसेस के अलग-अलग चरणों में, रनटाइम और मैनेजमेंट की स्थिति के बारे में यहां बताया गया है.
अपग्रेड करने की रणनीतियां
एक से ज़्यादा डेटा सेंटर
अपग्रेड की प्रोसेस, एक बार में एक डेटा सेंटर के लिए की जानी चाहिए. इससे यह पक्का किया जा सकेगा कि ट्रैफ़िक में कोई रुकावट न आए और डाउनटाइम से बचा जा सके. किसी डीसी को अपग्रेड करने से पहले, ट्रैफ़िक को चालू हालत में मौजूद अन्य डीसी पर रीडायरेक्ट किया जाना चाहिए.
सिंगल डेटा सेंटर
एक डेटा सेंटर सेटअप के लिए, अपग्रेड करने की प्रोसेस के दौरान रनटाइम ट्रैफ़िक और कुछ मैनेजमेंट एपीआई पर काफ़ी असर पड़ेगा. एक डेटा सेंटर सेटअप करने के लिए, ये विकल्प उपलब्ध हैं.
- अपग्रेड के दौरान ट्रैफ़िक को मैनेज करने के लिए, मौजूदा डेटा सेंटर के साथ एक और डेटा सेंटर जोड़कर, अपने Edge for Private cloud क्लस्टर को कुछ समय के लिए बढ़ाएं. इसके बाद, अपग्रेड की प्रोसेस पूरी होने पर, किसी एक डेटा सेंटर को बंद कर दें.
- अगर आपको किसी दूसरे डेटा सेंटर पर स्विच करने में समस्या आ रही है, तो डाउनटाइम के लिए तैयार रहें. साथ ही, कम ट्रैफ़िक वाले समय में अपग्रेड शेड्यूल करें, ताकि मैनेजमेंट एपीआई और रनटाइम ट्रैफ़िक पर कम से कम असर पड़े.
हमारा सुझाव है कि आप एक और डेटा सेंटर का इस्तेमाल करें, ताकि रनटाइम ट्रैफ़िक और मैनेजमेंट एपीआई पर कोई असर न पड़े. अपग्रेड के दौरान, अपग्रेड किए जा रहे डेटा सेंटर पर इन चीज़ों का असर पड़ता है. हालांकि, इनके अलावा और भी चीज़ों पर असर पड़ सकता है:
- OAuth टोकन को रीफ़्रेश करने वाले रनटाइम एपीआई
- ऐक्सेस एंटिटी की नीति का इस्तेमाल करने वाले रनटाइम एपीआई
- डेवलपर ऐप्लिकेशन की सूची बनाने वाले मैनेजमेंट एपीआई
- 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, Management Server, और Runtime nodes के लिए, रोल बैक की प्रोसेस को कंट्रोल किया जा सके और उसे अलग रखा जा सके, ताकि ट्रैफ़िक में रुकावट न आए.
ज़्यादा जानकारी के लिए, Cassandra 3.11.16 के अपडेट को वापस लाना सेक्शन देखें.
सबसे पहले: शुरुआती स्थिति
- Zookeeper, Postgres, और LDAP कॉम्पोनेंट को पहले ही 4.52.02 वर्शन पर अपग्रेड कर दिया गया है. आपका Edge for a private cloud क्लस्टर स्टेबल है और काम कर रहा है. अगर रोलबैक करना ज़रूरी है, तो क्लस्टर को इस स्थिति में रोल बैक कर दिया जाएगा.
- Apigee में Cassandra, वर्शन 2.1.22 के साथ काम कर रहा है.
- एज कॉम्पोनेंट:
- मैनेजमेंट-सर्वर, पुराने थ्रिफ्ट प्रोटोकॉल के ज़रिए Cassandra से कम्यूनिकेट कर रहा है.
- रंटाइम सर्वर (मैसेज प्रोसेसर और राउटर), थ्रिफ्ट के पुराने प्रोटोकॉल के ज़रिए Cassandra से कम्यूनिकेट करते हैं.
| इस चरण में रनटाइम की स्थिति | इस चरण में मैनेजमेंट की स्थिति |
|---|---|
| रनटाइम पूरी तरह से काम कर रहा है | मैनेजमेंट पूरी तरह से काम कर रहा है |
पहला चरण: अपग्रेड करने की तैयारी करना
नीचे दिया गया तरीका, उन स्टैंडर्ड फ़ाइलों के अलावा है जिन्हें आम तौर पर बनाया जाता है. जैसे, कॉम्पोनेंट अपग्रेड करने के लिए Apigee की स्टैंडर्ड कॉन्फ़िगरेशन फ़ाइल.
- LeveledCompactionStrategy का इस्तेमाल करने के लिए, Cassandra को बदलें.
- 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 में वापस इंपोर्ट करना होगा.
- अगर पोर्ट 9160 और 9042 पहले से मौजूद नहीं हैं, तो पक्का करें कि ये सभी Edge कॉम्पोनेंट से Cassandra नोड तक ऐक्सेस किए जा सकते हों. ज़्यादा जानकारी के लिए, पोर्ट से जुड़ी ज़रूरी शर्तें देखें.
दूसरा चरण: पहले डेटा सेंटर से ट्रैफ़िक को रीडायरेक्ट करना
- पहले डेटा सेंटर से आने वाले रनटाइम और मैनेजमेंट ट्रैफ़िक को ब्लॉक करें.
- सभी रनटाइम ट्रैफ़िक और मैनेजमेंट एपीआई को अन्य फ़ंक्शनल डेटा सेंटर पर रीडायरेक्ट करें.
- पुष्टि करें कि रनटाइम और मैनेजमेंट ट्रैफ़िक को अन्य डीसी मैनेज कर रहे हैं.
तीसरा चरण: पहले डेटा सेंटर में मौजूद सभी Cassandra नोड अपग्रेड करें
-
डेटा सेंटर 1 में मौजूद सभी 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
नौवां चरण - [ज़रूरी नहीं] पहले एक्सपोर्ट किए गए smartdocs इंपोर्ट करें
सभी मैनेजमेंट सर्वर अपग्रेड हो जाने के बाद, पहले चरण में एक्सपोर्ट किए गए स्मार्ट दस्तावेज़ मॉडल इंपोर्ट किए जा सकते हैं. आपके पास इसे बाद में भी करने का विकल्प है.
अगर डेवलपर पोर्टल Drupal 7 पर आधारित है और स्मार्टडॉक सुविधा का इस्तेमाल किया जा रहा है, तो आपको यह तरीका अपनाना होगा.
| इस चरण में रनटाइम की स्थिति | इस चरण में मैनेजमेंट की स्थिति |
|---|---|
| रनटाइम पूरी तरह से काम कर रहा है | मैनेजमेंट पूरी तरह से काम कर रहा है |
दसवां चरण - इस्तेमाल नहीं की गई टेबल हटाना
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 के नए वर्शन का इस्तेमाल करना चाहिए. साथ ही, Qpidupgrade के लिए कोई अतिरिक्त चरण ज़रूरी नहीं है.
Edge का नया यूज़र इंटरफ़ेस
इस सेक्शन में, Edge यूज़र इंटरफ़ेस (यूआई) से जुड़ी बातों के बारे में बताया गया है. ज़्यादा जानकारी के लिए, Private Cloud के लिए नया Edge यूज़र इंटरफ़ेस (यूआई) लेख पढ़ें.
Edge UI इंस्टॉल करना
शुरुआती इंस्टॉलेशन पूरा करने के बाद, Apigee का सुझाव है कि आप Edge UI इंस्टॉल करें. यह Apigee Edge for Private Cloud के डेवलपर और एडमिन के लिए बेहतर यूज़र इंटरफ़ेस है.
ध्यान दें कि Edge यूज़र इंटरफ़ेस (यूआई) के लिए, आपको सामान्य पुष्टि करने की सुविधा बंद करनी होगी. साथ ही, SAML या LDAP जैसे IDP का इस्तेमाल करना होगा.
ज़्यादा जानकारी के लिए, Edge के नए यूज़र इंटरफ़ेस (यूआई) को इंस्टॉल करना लेख पढ़ें.
Edge के यूज़र इंटरफ़ेस (यूआई) को अपडेट करना
Edge के यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को अपडेट करने के लिए, Private Cloud के उस Edge वर्शन का इस्तेमाल करें जिसे आपको अपग्रेड करना है:
- 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 RPM इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
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_FIXविकल्प का इस्तेमाल करके, यह तय करें कि Java को कैसे इंस्टॉल करना है.JAVA_FIXकी ये वैल्यू होती हैं:I: OpenJDK 1.8 (डिफ़ॉल्ट) इंस्टॉल करें.C: Java इंस्टॉल किए बिना जारी रखें.Q: बंद करें. इस विकल्प के लिए, आपको 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 UIzk: चिड़ियाघर का कर्मचारी
- configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.50.00 या 4.51.00 वर्शन इंस्टॉल करते समय, Edge कॉम्पोनेंट तय करने के लिए किया था.
component को "all" पर सेट करके, सभी कॉम्पोनेंट के लिए
update.shचलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge all-in-one (AIO) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component, Edge का वह कॉम्पोनेंट है जिसे अपडेट करना है. इन वैल्यू का इस्तेमाल किया जा सकता है:
- अगर आपने पहले से ऐसा नहीं किया है, तो Edge UI के कॉम्पोनेंट चलाने वाले सभी नोड पर, उन्हें रीस्टार्ट करें:
/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. - Edge
apigee-serviceयूटिलिटी और डिपेंडेंसी को/tmp/reposसे इंस्टॉल करें:sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
ध्यान दें कि इस कमांड में, repos डायरेक्ट्री का पाथ शामिल किया गया है.
- लोकल रेपो वाले नोड पर, लोकल रेपो को
- Nginx वेबसर्वर का इस्तेमाल करके apigee-service इंस्टॉल करने के लिए:
- Edge apigee-setup यूटिलिटी इंस्टॉल करना में "Nginx वेबसर्वर का इस्तेमाल करके, रिपॉज़िटरी से इंस्टॉल करना" में दिए गए तरीके से, 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 (अगर आपने एसएसओ इंस्टॉल किया है)ueEdge का नया यूज़र इंटरफ़ेस (यूआई)ui: Classic Edge UIzk: चिड़ियाघर का कर्मचारी
- configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.50.00 या 4.51.00 वर्शन इंस्टॉल करते समय, अपने Edge कॉम्पोनेंट तय करने के लिए किया था.
component को "all" पर सेट करके, सभी कॉम्पोनेंट के लिए
update.shचलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge all-in-one (AIO) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:/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 UI, New Edge UI, और एसएसओ नोड अपडेट किए गए हैं.
- कमाई करने की सुविधा को अपडेट करने के लिए, कोई अलग चरण नहीं है. -c एज विकल्प तय करने पर, इसे अपडेट किया जाता है.
एक नोड वाला स्टैंडअलोन अपग्रेड
एक नोड वाले स्टैंडअलोन कॉन्फ़िगरेशन को 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
दो नोड वाला स्टैंडअलोन अपग्रेड
दो नोड वाले स्टैंडअलोन इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:
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 UI कॉम्पोनेंट को रीस्टार्ट करें:
/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 पर
नौ नोड वाले क्लस्टर को अपग्रेड करना
नौ नोड वाले क्लस्टर किए गए इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:
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 पर एलडीएपी अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
DC-1 में ट्रैफ़िक को ब्लॉक करें और पक्का करें कि सारा ट्रैफ़िक, दूसरे DC-2 पर रीडायरेक्ट हो गया हो
- DC-1 में मौजूद मशीन 1,2,3 पर Cassandra को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- DC-1 में मौजूद मशीन 1 पर मैनेजमेंट सर्वर को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- DC-1 में मौजूद मशीन 2 और 3 पर राऊटर और मैसेज प्रोसेसर को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- DC-1 में ट्रैफ़िक को अनब्लॉक करें और DC-1 की पुष्टि करें. इसके बाद, DC-2 में ट्रैफ़िक को ब्लॉक करके DC-2 की पुष्टि करें और ट्रैफ़िक को DC-1 पर रीडायरेक्ट करें
- DC-2 में मौजूद मशीन 7,8,9 पर Cassandra को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
- DC-2 में मौजूद मशीन 7 पर मैनेजमेंट सर्वर को अपडेट करें:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- DC-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