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 के डेटा मॉडल में कुछ बदलाव करना ज़रूरी था, ताकि नए वर्शन में बेहतर परफ़ॉर्मेंस मिल सके. हालांकि, ये बदलाव बहुत कम हैं, लेकिन अपग्रेड की प्रोसेस शुरू होने पर, कुछ 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 की स्टैंडर्ड कॉन्फ़िगरेशन फ़ाइल.

  1. Cassandra को LeveledCompactionStrategy का इस्तेमाल करने के लिए बदलें.
  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. पक्का करें कि Edge के सभी कॉम्पोनेंट से Cassandra नोड तक, पोर्ट 9160 और 9042 को ऐक्सेस किया जा सकता हो. ऐसा तब करें, जब ये पहले से मौजूद न हों. ज़्यादा जानकारी के लिए, पोर्ट से जुड़ी ज़रूरी शर्तें देखें.

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

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

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

  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

नौवां चरण - [ज़रूरी नहीं] पहले एक्सपोर्ट किए गए स्मार्टडॉक इंपोर्ट करना

सभी मैनेजमेंट सर्वर अपग्रेड होने के बाद, पहले चरण में एक्सपोर्ट किए गए स्मार्ट डॉक्स मॉडल इंपोर्ट किए जा सकते हैं. आपके पास बाद में भी ऐसा करने का विकल्प है.

आपको ऐसा सिर्फ़ तब करना होगा, जब 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 के उस वर्शन को ध्यान में रखें जिससे आपको अपग्रेड करना है:

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 RPMs इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
  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 इंस्टॉलेशन को मैनेज करने का तरीका बताने के लिए, JAVA_FIX विकल्प का इस्तेमाल करें. JAVA_FIX के लिए ये वैल्यू इस्तेमाल की जा सकती हैं:

      • I: OpenJDK 1.8 (डिफ़ॉल्ट) इंस्टॉल करें.
      • C: Java इंस्टॉल किए बिना जारी रखें.
      • Q: Quit. इस विकल्प के लिए, आपको 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 का यूज़र इंटरफ़ेस (यूआई)
        • 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
    7. अगर आपने पहले से ऐसा नहीं किया है, तो Edge यूज़र इंटरफ़ेस (यूआई) के कॉम्पोनेंट को चलाने वाले सभी नोड पर उन्हें रीस्टार्ट करें:
      /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. /tmp/repos से Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. Nginx वेबसर्वर का इस्तेमाल करके apigee-service इंस्टॉल करने के लिए:
    1. Nginx वेब सर्वर को कॉन्फ़िगर करें. इसके लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करें में जाकर, "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 New Edge UI
      • 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 /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 यूज़र इंटरफ़ेस (यूआई) और नए Edge यूज़र इंटरफ़ेस (यूआई), एसएसओ नोड को अपडेट करना.
  • कमाई करने की सुविधा को अपडेट करने के लिए, कोई अलग चरण नहीं है. -c edge विकल्प की जानकारी देने पर, इसे अपडेट किया जाता है.

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

एक नोड वाले स्टैंडअलोन कॉन्फ़िगरेशन को 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

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

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

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 यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
    /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

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

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

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 पर LDAP अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. डीसी-1 में ट्रैफ़िक को ब्लॉक करें और पक्का करें कि सारा ट्रैफ़िक दूसरे डीसी-2 पर रीडायरेक्ट हो

  5. DC-1 में मशीन 1,2,3 पर Cassandra को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. डीसी-1 में मशीन 1 पर मैनेजमेंट सर्वर को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. डीसी-1 में मशीन 2,3 पर राऊटर और मैसेज प्रोसेसर को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. डीसी-1 में ट्रैफ़िक को अनब्लॉक करें और डीसी-1 की पुष्टि करें. इसके बाद, डीसी-2 में ट्रैफ़िक को ब्लॉक करके और ट्रैफ़िक को डीसी-1 पर फिर से रूट करके, डीसी-2 के साथ आगे बढ़ें
  9. डीसी-2 में मशीन 7,8,9 पर Cassandra को अपडेट करें:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. डीसी-2 में मशीन 7 पर मैनेजमेंट सर्वर को अपडेट करना:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. डीसी-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