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 कंपैक्शन की रणनीति LeveledCompactionStrategy
    हो अपने मौजूदा वर्शन के आधार पर, Cassandra कंपैक्शन की रणनीति में ज़रूरी बदलाव करें. यहां दिया गया तरीका अपनाएं और फिर अपग्रेड करने की मुख्य प्रक्रिया पर वापस जाएं:

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

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 पर अपग्रेड करना

Private Cloud 4.52.02 के लिए Apigee Edge में, Cassandra को 3.11.16 वर्शन पर अपग्रेड किया गया है. Cassandra, Apigee का एक अहम कॉम्पोनेंट है. इस अपग्रेड में, अलग-अलग रनटाइम और मैनेजमेंट कॉम्पोनेंट में ड्राइवर सॉफ़्टवेयर के अपडेट भी शामिल हैं. इन कॉम्पोनेंट का इस्तेमाल, Cassandra में क्वेरी करने और डेटा लिखने के लिए किया जाता है.

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

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

डेवलपर पोर्टल - एपीआई का दस्तावेज़ बनाना

Apigee Drupal डेवलपर पोर्टल में, एपीआई को दस्तावेज़ में शामिल करने के लिए कई सुविधाएं मिलती हैं. हमारा सुझाव है कि आप Drupal 7 पर आधारित डेवलपर पोर्टल का इस्तेमाल बंद कर दें. हालांकि, अगर आप अब भी इसका इस्तेमाल कर रहे हैं और SmartDocs की सुविधा का इस्तेमाल कर रहे हैं, तो SmartDocs API का इस्तेमाल करना दस्तावेज़ आपके लिए है. अगर डेवलपर पोर्टल के नए वर्शन का इस्तेमाल किया जा रहा है, तो इस अपग्रेड के दौरान आपके एपीआई दस्तावेज़ पर कोई असर नहीं पड़ेगा.

Apigee को 4.52.02 वर्शन पर अपग्रेड करने पर, Drupal 7 डेवलपर पोर्टल की SmartDocs सुविधा का इस्तेमाल करके बनाए गए किसी भी एपीआई मॉडल को नए वर्शन पर अपने-आप माइग्रेट नहीं किया जाएगा. आपको डेवलपर पोर्टल का इस्तेमाल करके, हर मॉडल को मैन्युअल तरीके से एक्सपोर्ट करना होगा. साथ ही, अपग्रेड पूरा होने के बाद उसे फिर से इंपोर्ट करना होगा.

यहां इस्तेमाल की गई शब्दावली

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

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

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

नीचे दिए गए हर चरण में, अपग्रेड की प्रोसेस के अलग-अलग चरणों के दौरान, रनटाइम और मैनेजमेंट की स्थिति के बारे में बताया गया है.

रणनीतियों को अपग्रेड करना

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

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

एक डेटा सेंटर

एक डेटा सेंटर सेटअप के लिए, अपग्रेड की प्रोसेस से रनटाइम ट्रैफ़िक और कुछ मैनेजमेंट एपीआई पर काफ़ी असर पड़ेगा. एक डेटा सेंटर सेटअप करने के लिए, ये विकल्प उपलब्ध हैं.

  • अपग्रेड के दौरान ट्रैफ़िक को मैनेज करने के लिए, अपने Edge for Private cloud क्लस्टर को किसी अस्थायी डेटा सेंटर में बड़ा करें. इसके लिए, मौजूदा डेटा सेंटर के साथ-साथ एक डेटा सेंटर जोड़ें. इसके बाद, अपग्रेड की प्रोसेस पूरी होने पर, किसी एक डेटा सेंटर को बंद कर दें.
  • अगर आपके पास किसी दूसरे डेटा सेंटर का विकल्प नहीं है, तो डाउनटाइम के लिए तैयार रहें. साथ ही, अपग्रेड को कम ट्रैफ़िक के दौरान शेड्यूल करें, ताकि मैनेजमेंट एपीआई और रनटाइम ट्रैफ़िक पर कम से कम असर पड़े.

हमारा सुझाव है कि रनटाइम ट्रैफ़िक और मैनेजमेंट एपीआई पर असर न पड़े, इसके लिए एक और डेटा सेंटर जोड़ें. अपग्रेड के दौरान, अपग्रेड किए जा रहे डेटा सेंटर पर इन चीज़ों का असर पड़ता है. हालांकि, इनके अलावा और भी चीज़ों पर असर पड़ सकता है:

  • रनटाइम एपीआई, OAuth टोकन रीफ़्रेश कर रहे हैं
  • इकाई को ऐक्सेस करने की नीति का इस्तेमाल करने वाले रनटाइम एपीआई
  • डेवलपर के ऐप्लिकेशन की सूची दिखाने वाले मैनेजमेंट एपीआई
  • प्रॉडक्ट की लिस्टिंग दिखाने वाले मैनेजमेंट एपीआई

ऊपर बताए गए असर के अलावा, कुछ खास मैनेजमेंट एपीआई भी सभी डेटा सेंटर पर काम नहीं करेंगे. ये एपीआई तब तक काम नहीं करेंगे, जब तक सभी डेटा सेंटर अपग्रेड नहीं हो जाते. ऐसे मैनेजमेंट एपीआई, अगले सेक्शन में दिए गए चरणों में दिए गए हैं.

रोलबैक - हाई लेवल

  • रोलबैक के दौरान होने वाला असर

    Cassandra 3.11.x से 2.1.x पर रोलबैक करने से, उस डेटा सेंटर (डीसी) में रनटाइम और मैनेजमेंट ट्रैफ़िक, दोनों पर असर पड़ता है जहां रोलबैक किया जा रहा है. इसके अलावा, कुछ मैनेजमेंट एपीआई को सभी डेटा सेंटर में रुकावटें आ सकती हैं. भले ही, फ़िलहाल किसी भी डीसी को रोल बैक किया जा रहा हो.

  • डीसीबी को डीसीबी रोलबैक के तरीके से फ़ॉलो करना

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

  • कुछ हिस्से को अपग्रेड किए गए क्लस्टर को वापस रोल करना

    अगर कम से कम एक डेटा सेंटर, Cassandra के पुराने वर्शन (2.1.22) पर पूरी तरह से काम कर रहा है, तो अपग्रेड किए गए अन्य डीसी को रोल-बैक किया जा सकता है. इसके लिए, पूरी तरह से काम करने वाले Cassandra 2.1.X डीसी से फिर से डेटा सेट अप करना होगा.

  • क्लस्टर-वाइड रोलबैक

    अगर पूरे Cassandra क्लस्टर को अपग्रेड कर दिया गया है और आपको रोलबैक करना है, तो बैकअप या VM स्नैपशॉट का इस्तेमाल करके ऐसा करें. यह तरीका जटिल है और इससे कुछ समय के लिए साइट बंद हो सकती है या डेटा मिट सकता है.

  • अपग्रेड करने से पहले ध्यान देने वाली बातें

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

एक ही डेटा सेंटर वाले क्लस्टर को रोलबैक करना

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 वर्शन के साथ चल रहा है.
  • एज कॉम्पोनेंट:
    • मैनेजमेंट-सर्वर, पुराने थ्रिफ़्ट प्रोटोकॉल के ज़रिए Cassandra से बातचीत कर रहा है.
    • रनटाइम सर्वर (मैसेज प्रोसेसर और राउटर), पुराने थ्रिफ़्ट प्रोटोकॉल के ज़रिए Cassandra से संपर्क करते हैं.
इस चरण में रनटाइम की स्थिति इस चरण में मैनेजमेंट की स्थिति
रनटाइम पूरी तरह से काम कर रहा हो मैनेजमेंट पूरी तरह से काम कर रहा हो

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

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

  1. Cassandra को LeveledCompactionStrategy का इस्तेमाल करने के लिए बदलना.
  2. Apigee का इस्तेमाल करके Cassandra का बैकअप लें.
  3. अगर हो सके, तो Cassandra नोड के VM के स्नैपशॉट लें.
  4. /opt/apigee/apigee-cassandra/cass_upgrade.conf पर मौजूद हर Cassandra नोड पर, 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. डेटा सेंटर में मौजूद सभी 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 पर आधारित डेवलपर पोर्टल का इस्तेमाल किया जा रहा हो और स्मार्ट दस्तावेज़ों की सुविधा का इस्तेमाल किया जा रहा हो.

इस चरण में रनटाइम की स्थिति इस चरण में मैनेजमेंट की स्थिति
रनटाइम पूरी तरह से काम कर रहा हो मैनेजमेंट पूरी तरह से काम कर रहा हो

दसवां चरण - इस्तेमाल नहीं की जा रही टेबल हटाना

Cassandra क्लस्टर से, इस्तेमाल न की गई पुरानी टेबल हटाने के लिए, यह कमांड चलाएं. जब तक यह प्रोसेस पूरी नहीं हो जाती, तब तक Cassandra की कुछ सुविधाओं का इस्तेमाल नहीं किया जा सकता. जैसे, पुष्टि करने का नया तरीका सेट अप करना. हालांकि, पुष्टि करने के पुराने तरीके काम करते रहेंगे. यह कमांड, क्लस्टर में सिर्फ़ एक नोड पर ही चलाया जा सकता है

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

ग्यारहवां चरण - 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 के यूज़र इंटरफ़ेस (यूआई) से जुड़ी बातों के बारे में बताया गया है. ज़्यादा जानकारी के लिए, निजी क्लाउड के लिए Edge का नया यूज़र इंटरफ़ेस (यूआई) देखें.

Edge का यूज़र इंटरफ़ेस (यूआई) इंस्टॉल करना

शुरुआती इंस्टॉलेशन पूरा करने के बाद, Apigee का सुझाव है कि आप Edge यूज़र इंटरफ़ेस इंस्टॉल करें. यह Apigee Edge for Private Cloud के डेवलपर और एडमिन के लिए बेहतर यूज़र इंटरफ़ेस है.

ध्यान दें कि Edge के यूज़र इंटरफ़ेस (यूआई) के लिए, आपको बुनियादी पुष्टि की सुविधा बंद करनी होगी और किसी 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 को बंद किए बिना ही उसे अपडेट किया जा सकता है.

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

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

  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 एसएसओ (अगर आपने एसएसओ इंस्टॉल किया है)
        • ue: Edge का नया यूज़र इंटरफ़ेस (यूआई)
        • ui: Edge के क्लासिक यूज़र इंटरफ़ेस (यूआई)
        • zk: Zookeeper
      • configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.50.00 या 4.51.00 इंस्टॉलेशन के दौरान, अपने Edge कॉम्पोनेंट तय करने के लिए किया था.

      component को "सभी" पर सेट करके, सभी कॉम्पोनेंट के लिए update.sh चलाया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपके पास Edge की ऑल-इन-वन (एआईओ) इंस्टॉलेशन प्रोफ़ाइल हो. उदाहरण के लिए:

      /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. /tmp/repos से Edge apigee-service की यूटिलिटी और डिपेंडेंसी इंस्टॉल करें: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/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 एसएसओ (अगर आपने एसएसओ इंस्टॉल किया है)
      • ue Edge का नया यूज़र इंटरफ़ेस (यूआई)
      • ui: Edge के क्लासिक यूज़र इंटरफ़ेस (यूआई)
      • zk: Zookeeper
    • configFile वही कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने 4.50.00 या 4.51.00 इंस्टॉलेशन के दौरान, अपने Edge कॉम्पोनेंट तय करने के लिए किया था.

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

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

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

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

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

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

  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
  3. पहली मशीन पर LDAP अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. पहली मशीन पर 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. दूसरी मशीन पर Qpid अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. पहली मशीन पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें: 
    /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 एसएसओ इंस्टॉल किया है) पहली मशीन पर Apigee एसएसओ अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

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

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

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

  1. मशीन 1, 2, और 3 पर 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
  3. पांचवीं मशीन पर Postgres को अपडेट करना: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. पहली मशीन पर 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. चौथी मशीन पर Qpid अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. पांचवीं मशीन पर 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 एसएसओ इंस्टॉल किया है) पहली मशीन पर Apigee एसएसओ अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  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

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

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

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

  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. पहली मशीन पर 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. छठी और सातवीं मशीन पर Qpid अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. पहली मशीन पर, नया यूज़र इंटरफ़ेस (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 एसएसओ इंस्टॉल किया है) पहली मशीन पर Apigee एसएसओ अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  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-नोड वाले क्लस्टर किए गए इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:

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

  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. चौथी और पांचवीं मशीन पर एलडीएपी अपडेट करें: 
    /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. छठी और सातवीं मशीन पर, नया यूज़र इंटरफ़ेस (ue) या क्लासिक यूज़र इंटरफ़ेस (ui) में से किसी एक को अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (अगर आपने apigee-adminapi इंस्टॉल किया है) छठी और सातवीं मशीन पर apigee-adminapi की सुविधा को अपडेट किया गया: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (अगर आपने Apigee एसएसओ इंस्टॉल किया है) छठी और सातवीं मशीन पर Apigee एसएसओ अपडेट करें: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट को रीस्टार्ट करें:
    • क्लासिक यूज़र इंटरफ़ेस (यूआई): अगर क्लासिक यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जा रहा है, तो छठी और सातवीं मशीन पर 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-नोड वाले क्लस्टर किए गए इंस्टॉलेशन के लिए, इन कॉम्पोनेंट को अपडेट करें:

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

  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. डीसी-1 में ट्रैफ़िक को ब्लॉक करें और पक्का करें कि सारा ट्रैफ़िक डीसी-2 पर रीराउंड हो गया हो

  5. Update Update Cassandra on machine 1,2,3 in DC-1: 
    /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. डीसी-1 में ट्रैफ़िक को अनब्लॉक करें और डीसी-1 की पुष्टि करें. इसके बाद, डीसी-2 में ट्रैफ़िक को ब्लॉक करके डीसी-2 पर जाएं और ट्रैफ़िक को डीसी-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. डीसी-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 एसएसओ इंस्टॉल किया है) दोनों डीसी में Apigee एसएसओ नोड अपडेट करें: 
    /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