Apigee Edge 4.52.02 को रोल बैक करें

अगर Edge 4.52.02 में अपडेट के दौरान कोई गड़बड़ी होती है, तो वह कॉम्पोनेंट मौजूद है जिसकी वजह से गड़बड़ी हुई है. इसके बाद, फिर से अपडेट करने की कोशिश करें.

आप Edge 4.52.02 को, नीचे दिए गए मुख्य रिलीज़ वर्शन में रोल बैक कर सकते हैं:

  • वर्शन 4.52.01
  • वर्शन 4.52.00
  • वर्शन 4.51.00

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

वर्शन पर रोलबैक करें सॉफ़्टवेयर के लिए विशेष विचार
4.52.01 कास्सांद्रा
4.52.00 कैसंड्रा, ज़ूकीपर, Qpid
4.51.00 कैसंड्रा, ज़ूकीपर, क्यूपीआईडी, पोस्टग्रेस

ऐसी दो स्थितियां हैं, जिनमें आपको रोलबैक करने की ज़रूरत पड़ सकती है:

  1. किसी पिछली बड़ी या छोटी रिलीज़ पर रोल बैक करें. उदाहरण के लिए, 4.52.02 से 4.52.00.
  2. पिछले पैच रिलीज़ पर इसे रोल बैक करें रिलीज़ के लिए है. उदाहरण के लिए, 4.52.00.02 से 4.52.00.01 तक.

ज़्यादा जानकारी के लिए, Apigee Edge की रिलीज़ देखें प्रोसेस.

रोलबैक का क्रम

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

Private Cloud 4.52.02 के लिए, रोल बैक का सामान्य क्रम नीचे दिया गया है:

  1. रोलबैक Postgres, Qpid, और आंकड़े से जुड़े अन्य कॉम्पोनेंट
  2. रोलबैक राऊटर और मैसेज प्रोसेसर
  3. रोलबैक कैसंड्रा, ज़ूकीपर
  4. रोलबैक मैनेजमेंट सर्वर

उदाहरण के लिए, मान लें कि आपने पूरे Cassandra क्लस्टर, अपने सभी मैनेजमेंट सर्वर, और कुछ RMP को वर्शन 4.52.01 से वर्शन 4.52.02 में अपग्रेड कर लिया है और आप रोलबैक करना चाहते हैं. इस स्थिति में, आपको:

  1. सभी आरएमपी को एक-एक करके रोलबैक करें
  2. बैकअप का उपयोग करके पूरे Cassandra क्लस्टर को रोलबैक करें
  3. रोलबैक एज मैनेजमेंट सर्वर नोड एक-एक करके

रोलबैक कौन कर सकता है

रोलबैक करने वाला उपयोगकर्ता, Edge को मूल रूप से अपडेट करने वाले उपयोगकर्ता जैसा होना चाहिए या रूट के रूप में चलाने वाला उपयोगकर्ता.

डिफ़ॉल्ट रूप से, Edge कॉम्पोनेंट उपयोगकर्ता "apigee" के तौर पर चलते हैं. कुछ मामलों में, हो सकता है कि आप Edge इस्तेमाल कर रहे हों कॉम्पोनेंट, अलग-अलग उपयोगकर्ताओं को ध्यान में रखकर बनाया गया है. उदाहरण के लिए, अगर राऊटर को खास पोर्ट ऐक्सेस करने हैं, जैसे कि तो आपको राऊटर को रूट के तौर पर या ऐसे उपयोगकर्ता के तौर पर चलाना होगा जिसके पास पोर्ट. इसके अलावा, किसी एक कॉम्पोनेंट को एक उपयोगकर्ता के तौर पर और दूसरे कॉम्पोनेंट को अन्य उपयोगकर्ता के तौर पर चलाया जा सकता है.

कॉमन कोड वाले कॉम्पोनेंट

नीचे दिए गए Edge कॉम्पोनेंट एक जैसे कोड शेयर करते हैं. इसलिए, किसी एक टूल को इन कॉम्पोनेंट को किसी नोड पर नहीं डालना होता है, तो आपको उस नोड पर मौजूद इन सभी कॉम्पोनेंट को रोल बैक करना होगा.

  • edge-management-server (मैनेजमेंट सर्वर)
  • edge-message-processor (मैसेज प्रोसेसर)
  • edge-router (राउटर)
  • edge-postgres-server (पोस्टग्रेस सर्वर)
  • edge-qpid-server (Qpid सर्वर)

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

कैसंड्रा का रोलबैक

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

रोल बैक करने के तरीके

वाइप आउट करें और नोड को फिर से बनाने के लिए क्लस्टर में मौजूदा नोड का इस्तेमाल करें

अगर आपके पास क्लस्टर में कम से कम एक पूरी तरह से चालू डेटा सेंटर है, तो यह प्रक्रिया अपनाई जा सकती है. हालांकि, यह अभी भी कैसंड्रा के पुराने वर्शन (कैसेंड्रा 2.1.22) में है. अगर आपने पूरे Cassandra क्लस्टर को अपग्रेड कर लिया है और रोलबैक करना चाहते हैं, तो आपको वाइप आउट करें और बैकअप या VM स्नैपशॉट को वापस लाएं में दिए गए निर्देशों का पालन करना होगा.

रोल बैक करने का तरीका

  1. उस नोड से शुरू करें जिसे आपको रोल बैक करना है:
    • नोड पर कैसंड्रा को रोकें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • नोड से Cassandra सॉफ़्टवेयर अनइंस्टॉल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • नोड से डेटा डायरेक्ट्री हटाएं: 
      rm -rf /opt/apigee/data/apigee-cassandra
    • प्राइवेट क्लाउड के लिए Edge के पुराने वर्शन के बूटस्ट्रैप को डाउनलोड करें और चलाएं, जिस पर आपको रोल बैक करना है.

    उदाहरण: 4.52.01 पर रोलबैक करने के लिए,

    • 4.52.01 का बूटस्ट्रैप डाउनलोड करें: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • 4.52.01 का बूटस्ट्रैप चलाएं: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • नोड पर कैसंड्रा सेटअप करें: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • फ़ंक्शनल डेटा सेंटर का नाम देकर, नोड पर रीबिल्ड करें: 
      /opt/apigee/apigee-cassandra/bin/nodetool rebuild -h <node-IP> <functional-dc>
    • ऊपर दिए गए हर उस नोड पर दोहराएं जिसे आपको एक-एक करके, रोल बैक करना है.
  2. सभी नोड रोल बैक करके फिर से बनाए जाने के बाद:
    • किसी भी मैनेजमेंट-सर्वर नोड का सेटअप चलाएं. पक्का करें कि मैनेजमेंट सर्वर रोल बैक किए गए वर्शन से हो. अगर ऐसा नहीं है, तो मैनेजमेंट सर्वर को भी रोलबैक करें.
    • मैनेजमेंट सर्वर को बंद करें: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
    • अगर कमाई करने की सुविधा का इस्तेमाल किया जा रहा है, तो कमाई करने की सुविधा को भी अनइंस्टॉल करें: 
      /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
    • मैनेजमेंट सर्वर को अनइंस्टॉल करें: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    • पुराने वर्शन का बूटस्ट्रैप डाउनलोड करें और उसे एक्ज़ीक्यूट करें. उदाहरण के लिए, 4.52.01 वर्शन के बूटस्ट्रैप को डाउनलोड और एक्ज़ीक्यूट करने के लिए यह तरीका अपनाएं: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord
    • एक मैनेजमेंट-सर्वर नोड का सेटअप चलाएं: 
      /opt/apigee/apigee-setup/bin/setup.sh -p mt -f configFile

पुनः बनाने के बाद ऑप्टिमाइज़ेशन

ऊपर दिए गए चरणों में, नोड का पूरा डेटा रीबिल्ड के दौरान रिमोट डेटा सेंटर से स्ट्रीम किया जाता है. स्थानीय डेटा सेंटर पर सभी प्रतिकृतियों के स्ट्रीम हो जाने के बाद, रिपेयर का इस्तेमाल करके इस प्रोसेस को ऑप्टिमाइज़ किया जा सकता है. इससे क्रॉस-डीसी स्ट्रीमिंग से बचा जा सकता है और किसी रिमोट DC के सभी नोड को फिर से बनाने की तुलना में यह ज़्यादा तेज़ होना चाहिए.

उदाहरण: मान लीजिए कि आपके लोकल डेटा सेंटर में छह कैसंड्रा नोड हैं. डिफ़ॉल्ट रूप से, Apigee का रेप्लिकेशन फ़ैक्टर तीन होता है. इसलिए, हर नोड में 50% डेटा होता है. इस मामले में, ऊपर दिया गया तरीका अपनाकर, नोड #1 और #4 को फिर से बनाया जा सकता है. नोड #2, #3, #5, और #6 के लिए, बैकअप को पहले जैसा करने और रिपेयर कराने के लिए नीचे दिया गया तरीका अपनाएं.

  1. स्थानीय डेटा सेंटर में रेप्लिका को फिर से बनाने के लिए, दिए गए छठे चरण तक की प्रोसेस का पालन करें.
  2. बचे हुए नोड के लिए, एक-एक करके हर बचे हुए नोड पर नीचे दिया गया तरीका अपनाएं.
    • इस नोड पर कैप्चर किए गए बैकअप को पुनर्स्थापित करें (ध्यान दें: इस बैकअप में पुराना डेटा हो सकता है, क्योंकि आपके द्वारा Cassandra अपग्रेड शुरू करने से पहले यह बैकअप लिया गया था): 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • अगर आपके पास नोड का वीएम स्नैपशॉट है, तो आप कैसंड्रा बैकअप को वापस लाने के बजाय स्नैपशॉट को वापस ला सकते हैं.
    • बैकअप को रीस्टोर करने के बाद, नोड पर कैसंड्रा सेवा शुरू करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • नोड पर रिपेयर चलाएं, ताकि किसी मौजूदा डेटा सेंटर से नया डेटा स्ट्रीम किया जा सके: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -dc <local-dc-name>
    • जिस नोड को आप ठीक करना चाहते हैं, उस पर तीन से छह चरण दोहराएं.

मिटाएं और बैकअप/वीएम स्नैपशॉट वापस लाएं

अगर आपने पूरे Cassandra क्लस्टर को अपग्रेड कर लिया है और रोलबैक करना चाहते हैं, तो केवल यह प्रक्रिया उपलब्ध है.

इसके अलावा, Apigee बैकअप, नोड के हिसाब से होते हैं. एक नोड से दूसरे में लिए गए बैकअप को पुनर्स्थापित नहीं किया जा सकता है. कैसंड्रा बैकअप में नोड मेटाडेटा की जानकारी (जैसे कि आईपी पता, रिंग की स्थिति वगैरह) शामिल होती है.

  1. क्लस्टर में 1 कैसंड्रा नोड से शुरू करें:
    • नोड पर कैसंड्रा सेवा रोकें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • नोड से Cassandra सॉफ़्टवेयर अनइंस्टॉल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
    • नोड से डेटा डायरेक्ट्री हटाएं: 
      rm -rf /opt/apigee/data/apigee-cassandra
    • प्राइवेट क्लाउड के लिए Edge के पुराने वर्शन का बूटस्ट्रैप डाउनलोड करें और चलाएं जिस पर आपको रोल बैक करना है.

    उदाहरण: 4.52.01 पर रोलबैक करने के लिए

    • 4.52.01 का बूटस्ट्रैप डाउनलोड करें: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh -u ‘uName:pWord’
    • 4.52.01 का बूटस्ट्रैप चलाएं: 
      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

    • नोड पर कैसंड्रा सेटअप करें: 
      /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
    • बैकअप से वापस लाएं में दी गई प्रक्रिया का इस्तेमाल करके, नोड पर बैकअप को पहले जैसा करें.
    • नोड पर कैसंड्रा को रोकें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
    • डेटा डायरेक्ट्री मिटाएं: 
      rm -rf /opt/apigee/data/apigee-cassandra/data
    • बैक अप वापस लाएं: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backup_file
    • नोड पर कैसंड्रा सेवा शुरू करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start
    • प्रत्येक कैसंड्रा नोड पर एक बार में एक चरण दोहराएं.
    • सभी नोड को एक-एक करके रिपेयर कराने के लिए: 
      /opt/apigee/apigee-cassandra/bin/nodetool -h <node-IP> repair -pr

ज़ूकीपर 3.8.3 के अपडेट को रोलबैक करें

अगर आपको 4.52.00 या 4.51.00 वर्शन पर रोल बैक करना है, तो आपको Zookeeper को रोल बैक करने से पहले, कुछ खास चरण देखने होंगे. इन चरणों की जानकारी रोलबैक में दी गई है.

अगर आपको वर्शन 4.52.01 पर रोल बैक करना है, तो Zookeeper को उसी तरह रोल बैक करें जिस तरह किसी भी सॉफ़्टवेयर को रोल बैक किया जाता है. इनके बारे में, नीचे दिए गए किसी पिछली बड़ी या माइनर रिलीज़ पर रोल बैक करें सेक्शन में बताया गया है.

Qpid रोलबैक

अगर आपको 4.52.00 या 4.51.00 वर्शन पर रोल बैक करना है, तो Qpid रोल बैक करने से पहले आपको कुछ खास चरण अपनाने होंगे. इन चरणों की जानकारी रोलबैक में दी गई है.

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

Postgres 10.17 अपडेट को रोलबैक करें

अगर आपको वर्शन 4.51.00 पर रोल बैक करना है, तो आपको Postgres को रोल बैक करने से पहले कुछ खास चरण देखने होंगे. इन चरणों की जानकारी रोलबैक में दी गई है.

अगर आपको वर्शन 4.52.01 या 4.52.00 पर रोल बैक करना है, तो किसी भी सॉफ़्टवेयर को रोल बैक करने की तरह ही Postgres को रोल बैक करें, जैसा कि नीचे किसी पिछली बड़ी या माइनर रिलीज़ पर रोल बैक करें सेक्शन में बताया गया है.

किसी पिछली बड़ी या छोटी रिलीज़ पर रोल बैक करना

किसी पिछली बड़ी या माइनर रिलीज़ पर रोल बैक करने के लिए, हर उस नोड पर नीचे दिया गया तरीका अपनाएं जो कॉम्पोनेंट:

  1. उस वर्शन के लिए bootstrap.sh फ़ाइल डाउनलोड करें जिस पर आपको रोल आउट करना है वापस:

    • 4.51.00 पर रोल बैक करने के लिए, bootstrap_4.51.00.sh डाउनलोड करें: 
      curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  2. कॉम्पोनेंट को रोल बैक करने से रोकें:
    1. कॉमन कोड वाले किसी भी कॉम्पोनेंट को नहीं, तो आपको उन सभी को रोकना होगा, जैसा कि नीचे दिए गए उदाहरण में बताया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
 /opt/apigee/apigee-service/bin/apigee-service edge-router stop
 /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
 /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
 /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. नोड पर किसी अन्य कॉम्पोनेंट को रोल बैक करने के लिए, सिर्फ़ उस कॉम्पोनेंट को रोकें: 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. अगर कमाई करने की सुविधा को रोल बैक किया जा रहा है, तो इसे सभी मैनेजमेंट सर्वर और मैसेज से अनइंस्टॉल करें प्रोसेसर नोड: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. नोड पर रोल बैक करने के लिए, कॉम्पोनेंट को अनइंस्टॉल करें:
    1. कॉमन कोड वाले किसी भी कॉम्पोनेंट को नोड, आपको edge-gateway कॉम्पोनेंट को अनइंस्टॉल करके उन सभी को अनइंस्टॉल करना होगा जैसा कि नीचे दिए गए उदाहरण में बताया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. नोड पर किसी दूसरे कॉम्पोनेंट को रोल बैक करने के लिए, सिर्फ़ वह कॉम्पोनेंट अनइंस्टॉल करें. नीचे दिए गए उदाहरण में बताया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      जहां component कॉम्पोनेंट का नाम है.

    3. एज राऊटर को रोल बैक करने के लिए, आपको /opt/nginx/conf.d फ़ाइल को अनइंस्टॉल करने के अलावा edge-gateway कॉम्पोनेंट ग्रुप: 
      cd /opt/nginx/conf.d
 rm -rf *
  5. apigee-setup के 4.52.02 वर्शन को अनइंस्टॉल करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service का 4.51.00 वर्शन इंस्टॉल करें उपयोगिता और इसकी डिपेंडेंसी. नीचे दिए गए उदाहरण में, apigee-service: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

    जहां uName और pWord, आपको मिला उपयोगकर्ता नाम और पासवर्ड है Apigee से. pWord को छोड़ने पर, आपको इसे डालने के लिए कहा जाएगा.

    अगर आपको गड़बड़ी का कोई मैसेज मिलता है, तो पक्का करें कि आपने bootstrap.sh फ़ाइल, 1.

  7. apigee-setup इंस्टॉल करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. कॉम्पोनेंट का पुराना वर्शन इंस्टॉल करें: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    जहां component को इंस्टॉल करना है और configFile आपका .

  9. अगर Qpid को रोल बैक किया जा रहा है, तो iptables को फ़्लश करें: 
    sudo iptables -F
  10. यह प्रक्रिया उस हर नोड के लिए दोहराएं जो उस कॉम्पोनेंट को होस्ट करता है जिसे आपने रोल बैक किया है.

पिछली पैच रिलीज़ पर रोल बैक करें

किसी कॉम्पोनेंट को किसी खास पैच रिलीज़ में रोल बैक करने के लिए, हर नोड पर ये काम करें जो कॉम्पोनेंट को होस्ट करता है:

  1. कॉम्पोनेंट का खास वर्शन डाउनलोड करें: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    जहां component_version, इंस्टॉल करने के लिए कॉम्पोनेंट और पैच रिलीज़ है. इसके लिए उदाहरण:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install

    अगर Apigee के ऑनलाइन रेपो का इस्तेमाल किया जा रहा है, तो आपके पास उपलब्ध कॉम्पोनेंट पता करने का विकल्प होता है वर्शन अपडेट करने के लिए यहां दिए गए निर्देश का इस्तेमाल करें: 

    yum --showduplicates list comp

    उदाहरण के लिए:

    yum --showduplicates list edge-ui
  2. कॉम्पोनेंट को इंस्टॉल करने के लिए, apigee-setup का इस्तेमाल करें: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    उदाहरण के लिए:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

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

  3. यह प्रक्रिया उस हर नोड के लिए दोहराएं जो उस कॉम्पोनेंट को होस्ट करता है जिसे आपने रोल बैक किया है.

mTLS रोल बैक करें

mTLS अपडेट को रोल बैक करने के लिए, सभी होस्ट पर यह तरीका अपनाएं:

  1. Apigee को बंद करें: 
    apigee-all stop
  2. mTLS रोकें: 
    apigee-service apigee-mtls uninstall
  3. mTLS फिर से इंस्टॉल करें: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf