Apigee Edge 4.51.00 या 4.52.00 या 4.52.01 को 4.52.02 पर अपडेट करें

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 में ज़रूरी बदलाव करें. यहां दिया गया तरीका अपनाएं. इसके बाद, अपग्रेड करने की मुख्य प्रक्रिया पर वापस जाएं:

अपग्रेड करने के लिए, कौनसे खास तरीके अपनाए जा सकते हैं

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 की स्टैंडर्ड कॉन्फ़िगरेशन फ़ाइल.

  1. LeveledCompactionStrategy का इस्तेमाल करने के लिए, Cassandra को बदलें.
  2. Apigee का इस्तेमाल करके Cassandra का बैकअप लें.
  3. अगर हो सके, तो Cassandra नोड के वीएम स्नैपशॉट लें.
  4. हर 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 फ़ाइल बनाएं.
  5. अगर Apigee Drupal 7 डेवलपर पोर्टल की SmartDocs सुविधा का इस्तेमाल किया जाता है, तो डेवलपर पोर्टल के यूज़र इंटरफ़ेस (यूआई) से JSON फ़ॉर्मैट में डाउनलोड करके, अपने हर मॉडल का एक्सपोर्ट लें. मैनेजमेंट सर्वर अपडेट होने के बाद, इन मॉडल को Apigee में वापस इंपोर्ट करना होगा.
  6. अगर पोर्ट 9160 और 9042 पहले से मौजूद नहीं हैं, तो पक्का करें कि ये सभी Edge कॉम्पोनेंट से Cassandra नोड तक ऐक्सेस किए जा सकते हों. ज़्यादा जानकारी के लिए, पोर्ट से जुड़ी ज़रूरी शर्तें देखें.

दूसरा चरण: पहले डेटा सेंटर से ट्रैफ़िक को रीडायरेक्ट करना

  1. पहले डेटा सेंटर से आने वाले रनटाइम और मैनेजमेंट ट्रैफ़िक को ब्लॉक करें.
  2. सभी रनटाइम ट्रैफ़िक और मैनेजमेंट एपीआई को अन्य फ़ंक्शनल डेटा सेंटर पर रीडायरेक्ट करें.
  3. पुष्टि करें कि रनटाइम और मैनेजमेंट ट्रैफ़िक को अन्य डीसी मैनेज कर रहे हैं.

तीसरा चरण: पहले डेटा सेंटर में मौजूद सभी Cassandra नोड अपग्रेड करें

  1. डेटा सेंटर 1 में मौजूद सभी Cassandra नोड को एक-एक करके अपग्रेड करें. हर नोड पर एक-एक करके ये कमांड चलाएं:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. किसी नोड को अपडेट करने के बाद, आगे बढ़ने से पहले कुछ मान्यताओं को पूरा करने के लिए, नोड पर यह निर्देश चलाएं:
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
    इससे इस तरह का आउटपुट मिलेगा:
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. अपग्रेड पूरा होने के बाद, हर 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 वर्शन का इस्तेमाल करें जिसे आपको अपग्रेड करना है:

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 के इंस्टॉलेशन को अपडेट किया जा सकता है.

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

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

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

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

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

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

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

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

  1. अगर मौजूद है, तो अपडेट पूरा होने तक Cassandra पर मरम्मत की कार्रवाई करने के लिए कॉन्फ़िगर किए गए किसी भी cron जॉब को बंद करें.
  2. Edge RPM इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
  3. yum-utils और yum-plugin-priorities इंस्टॉल करें:
    sudo yum install yum-utils
    sudo yum install yum-plugin-priorities
  4. Edge apigee-setup यूटिलिटी इंस्टॉल करें में दिए गए तरीके से, SELinux को बंद करें.
  5. अगर Oracle 7.x पर इंस्टॉल किया जा रहा है, तो यह कमांड चलाएं:
    sudo yum-config-manager --enable ol7_optional_latest
  6. अगर आपको 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
  7. अगर फ़िलहाल, Edge 4.51.00 का इस्तेमाल किया जा रहा है, तो:

    1. Edge bootstrap_4.52.02.sh फ़ाइल को यहां डाउनलोड करें: /tmp/bootstrap_4.52.02.sh:
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. 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 को खुद इंस्टॉल करना होगा.
    3. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें. जैसा कि इस उदाहरण में दिखाया गया है:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें. इसका उदाहरण यहां दिया गया है:
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. मैनेजमेंट सर्वर पर apigee-provision यूटिलिटी को अपडेट करें. इसका उदाहरण यहां दिया गया है:
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. अपने नोड पर update यूटिलिटी चलाने के लिए, यह कमांड चलाएं:
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

      कहां:

      • component, Edge का वह कॉम्पोनेंट है जिसे अपडेट करना है. इन वैल्यू का इस्तेमाल किया जा सकता है:
        • cs: Cassandra
        • edge: Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, Qpid सर्वर, Postgres सर्वर
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO (अगर आपने एसएसओ इंस्टॉल किया है)
        • ue: Edge का नया यूज़र इंटरफ़ेस (यूआई)
        • ui: Classic Edge UI
        • zk: चिड़ियाघर का कर्मचारी
      • 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
    7. अगर आपने पहले से ऐसा नहीं किया है, तो Edge UI के कॉम्पोनेंट चलाने वाले सभी नोड पर, उन्हें रीस्टार्ट करें:
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. इंस्टॉल की जांच करना में बताए गए तरीके से, मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर अपडेट की जांच करें.

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

लोकल रेपो से 4.52.02 वर्शन पर अपडेट करें

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

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

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

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

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

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

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

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

  3. Nginx वेबसर्वर का इस्तेमाल करके apigee-service इंस्टॉल करने के लिए:
    1. Edge apigee-setup यूटिलिटी इंस्टॉल करना में "Nginx वेबसर्वर का इस्तेमाल करके, रिपॉज़िटरी से इंस्टॉल करना" में दिए गए तरीके से, Nginx वेब सर्वर को कॉन्फ़िगर करें.
    2. रिमोट नोड पर, 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, रिपो नोड का आईपी पता या डीएनएस नाम है.

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

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

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

    कहां:

    • component, Edge का वह कॉम्पोनेंट है जिसे अपडेट करना है. आम तौर पर, इन कॉम्पोनेंट को अपडेट किया जाता है:
      • cs: Cassandra
      • edge: Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, Qpid सर्वर, Postgres सर्वर
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (अगर आपने एसएसओ इंस्टॉल किया है)
      • ue Edge का नया यूज़र इंटरफ़ेस (यूआई)
      • ui: Classic Edge UI
      • zk: चिड़ियाघर का कर्मचारी
    • 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
  8. अगर आपने अब तक ऐसा नहीं किया है, तो इसे चलाने वाले सभी नोड पर यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. इंस्टॉल की जांच करना में बताए गए तरीके से, मैनेजमेंट सर्वर पर 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 पर अपग्रेड करने के लिए:
  1. सभी कॉम्पोनेंट अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (अगर आपने apigee-adminapi इंस्टॉल किया है) apigee-adminapi यूटिलिटी को अपडेट किया गया:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

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

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

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

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

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

  10. मशीन 1 पर Edge UI कॉम्पोनेंट को रीस्टार्ट करें:
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. दोनों डीसी में, मशीन 1,2,3,7,8,9 पर ZooKeeper को अपडेट करें:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. दोनों डीसी में मौजूद मशीन 6 और 12 पर Postgres अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. दोनों डीसी में,मशीन 1 और 7 पर एलडीएपी अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. DC-1 में ट्रैफ़िक को ब्लॉक करें और पक्का करें कि सारा ट्रैफ़िक, दूसरे DC-2 पर रीडायरेक्ट हो गया हो

  5. DC-1 में मौजूद मशीन 1,2,3 पर Cassandra को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. DC-1 में मौजूद मशीन 1 पर मैनेजमेंट सर्वर को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. DC-1 में मौजूद मशीन 2 और 3 पर राऊटर और मैसेज प्रोसेसर को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. DC-1 में ट्रैफ़िक को अनब्लॉक करें और DC-1 की पुष्टि करें. इसके बाद, DC-2 में ट्रैफ़िक को ब्लॉक करके DC-2 की पुष्टि करें और ट्रैफ़िक को DC-1 पर रीडायरेक्ट करें
  9. DC-2 में मौजूद मशीन 7,8,9 पर Cassandra को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. DC-2 में मौजूद मशीन 7 पर मैनेजमेंट सर्वर को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. DC-2 में मौजूद मशीन 8 और 9 पर राऊटर और मैसेज प्रोसेसर को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. DC-2 में ट्रैफ़िक को अनब्लॉक करें. अब दोनों डीसी, ट्रैफ़िक को मैनेज करेंगे
  13. मशीन 1 और 7 पर, सभी डीसी में मौजूद मैनेजमेंट-सर्वर पर अपडेट करने का निर्देश फिर से चलाएं:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. दोनों डीसी में मशीन 4,5,6,10,11,12 पर edge-qpid-server और edge-postgres-server को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. दोनों डीसी में मशीन 4,5,10,11 पर Qpid को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. दोनों डीसी में, नए यूज़र इंटरफ़ेस (ue) या क्लासिक यूज़र इंटरफ़ेस (ui) को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (अगर आपने apigee-adminapi इंस्टॉल किया है) दोनों डीसी में apigee-adminapi को अपडेट करें:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (अगर आपने Apigee SSO इंस्टॉल किया है) दोनों डीसी में Apigee SSO नोड अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. दोनों डीसी में, नए Edge यूज़र इंटरफ़ेस (edge-management-ui) या क्लासिक Edge यूज़र इंटरफ़ेस (edge-ui) कॉम्पोनेंट को रीस्टार्ट करें:
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart