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 कॉम्पोनेंट को अलग-अलग उपयोगकर्ताओं के तौर पर चला रहे हों. उदाहरण के लिए, अगर राऊटर को खास पोर्ट ऐक्सेस करने हैं, जैसे कि 1000 से कम के पोर्ट, तो आपको राऊटर को रूट की तरह या उन पोर्ट के ऐक्सेस वाले उपयोगकर्ता के तौर पर चलाना होगा. इसके अलावा, किसी एक कॉम्पोनेंट को एक उपयोगकर्ता के तौर पर और दूसरे कॉम्पोनेंट को अन्य उपयोगकर्ता के तौर पर चलाया जा सकता है.

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

नीचे दिए गए 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. एज राऊटर को रोल बैक करने के लिए, आपको edge-gateway कॉम्पोनेंट ग्रुप को अनइंस्टॉल करने के साथ-साथ, /opt/nginx/conf.d फ़ाइल का कॉन्टेंट भी मिटाना होगा: 
      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 का 4.51.00 वर्शन इंस्टॉल किया गया है: 
    sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

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

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

  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