अगर Edge 4.51.00 में अपडेट करते समय कोई गड़बड़ी होती है, तो वह कॉम्पोनेंट मौजूद है जिसकी वजह से गड़बड़ी हुई है. इसके बाद, फिर से अपडेट करने की कोशिश करें.
आपके पास Edge 4.51.00 को, फ़ीचर रिलीज़ के इन वर्शन पर रोल बैक करने का विकल्प है:
- वर्शन 4.50.00
- वर्शन 4.19.06
ऐसी दो स्थितियां हैं, जिनमें आपको रोलबैक करने की ज़रूरत पड़ सकती है:
- पिछली सुविधा रिलीज़ पर वापस जाएं. उदाहरण के लिए, 4.51.00 से 4.50.00.
- पिछले वर्शन में अपडेट करने के लिए, अपडेट वर्शन पर जाएं रिलीज़ करें. उदाहरण के लिए, 4.50.00.02 से 4.50.00.01 तक.
ज़्यादा जानकारी के लिए, Apigee Edge की रिलीज़ देखें प्रोसेस.
रोलबैक कौन कर सकता है
रोलबैक करने वाला उपयोगकर्ता, Edge को मूल रूप से अपडेट करने वाले उपयोगकर्ता जैसा होना चाहिए या रूट के रूप में चलाने वाला उपयोगकर्ता.
डिफ़ॉल्ट रूप से, Edge कॉम्पोनेंट उपयोगकर्ता "apigee" के तौर पर चलते हैं. कुछ मामलों में, हो सकता है कि आप Edge इस्तेमाल कर रहे हों कॉम्पोनेंट, अलग-अलग उपयोगकर्ताओं को ध्यान में रखकर बनाया गया है. उदाहरण के लिए, अगर राऊटर को खास पोर्ट ऐक्सेस करने हैं, जैसे कि तो आपको राऊटर को रूट के तौर पर या ऐसे उपयोगकर्ता के तौर पर चलाना होगा जिसके पास पोर्ट. इसके अलावा, किसी एक कॉम्पोनेंट को एक उपयोगकर्ता के तौर पर और दूसरे कॉम्पोनेंट को अन्य उपयोगकर्ता के तौर पर चलाया जा सकता है.
कॉमन कोड वाले कॉम्पोनेंट
नीचे दिए गए Edge कॉम्पोनेंट एक जैसे कोड शेयर करते हैं. इसलिए, किसी एक टूल को इन कॉम्पोनेंट को किसी नोड पर नहीं डालना होता है, तो आपको उस नोड पर मौजूद इन सभी कॉम्पोनेंट को रोल बैक करना होगा.
edge-management-server(मैनेजमेंट सर्वर)edge-message-processor(मैसेज प्रोसेसर)edge-router(राउटर)edge-postgres-server(पोस्टग्रेस सर्वर)edge-qpid-server(Qpid सर्वर)
उदाहरण के लिए, अगर आपके पास मैनेजमेंट सर्वर, राऊटर, और मैसेज प्रोसेसर इंस्टॉल है नोड, उनमें से किसी एक को रोल बैक करने के लिए, आपको तीनों को रोल बैक करना होगा.
पिछली सुविधा रिलीज़ पर रोल बैक करना
पिछली सुविधा रिलीज़ पर रोल बैक करने के लिए, होस्ट करने वाले हर नोड पर ये काम करें: कॉम्पोनेंट:
-
उस वर्शन के लिए
bootstrap.shफ़ाइल डाउनलोड करें जिस पर आपको रोल आउट करना है वापस:- 4.50.00 पर रोल बैक करने के लिए,
bootstrap_4.50.00.shडाउनलोड करें:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- 4.19.06 पर रोल बैक करने के लिए,
bootstrap_4.19.06.shडाउनलोड करें:curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- 4.50.00 पर रोल बैक करने के लिए,
- कॉम्पोनेंट को रोल बैक करने से रोकें:
- कॉमन कोड वाले किसी भी कॉम्पोनेंट को
नहीं, तो आपको उन सभी को रोकना होगा, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:
/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 - नोड पर किसी अन्य कॉम्पोनेंट को रोल बैक करने के लिए, सिर्फ़ उस कॉम्पोनेंट को रोकें:
/opt/apigee/apigee-service/bin/apigee-service component stop
- कॉमन कोड वाले किसी भी कॉम्पोनेंट को
नहीं, तो आपको उन सभी को रोकना होगा, जैसा कि नीचे दिए गए उदाहरण में बताया गया है:
- अगर कमाई करने की सुविधा को रोल बैक किया जा रहा है, तो इसे सभी मैनेजमेंट सर्वर और मैसेज से अनइंस्टॉल करें
प्रोसेसर नोड:
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
- नोड पर रोल बैक करने के लिए, कॉम्पोनेंट को अनइंस्टॉल करें:
- कॉमन कोड वाले किसी भी कॉम्पोनेंट को
नोड, आपको
edge-gatewayकॉम्पोनेंट को अनइंस्टॉल करके उन सभी को अनइंस्टॉल करना होगा जैसा कि नीचे दिए गए उदाहरण में बताया गया है:/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
- नोड पर किसी दूसरे कॉम्पोनेंट को रोल बैक करने के लिए, सिर्फ़ वह कॉम्पोनेंट अनइंस्टॉल करें.
नीचे दिए गए उदाहरण में बताया गया है:
/opt/apigee/apigee-service/bin/apigee-service component uninstall
जहां component कॉम्पोनेंट का नाम है.
- एज राऊटर को रोल बैक करने के लिए, आपको
/opt/nginx/conf.dफ़ाइल को अनइंस्टॉल करने के अलावाedge-gatewayकॉम्पोनेंट ग्रुप:cd /opt/nginx/conf.d
rm -rf *
- कॉमन कोड वाले किसी भी कॉम्पोनेंट को
नोड, आपको
apigee-setupके 4.51.00 वर्शन को अनइंस्टॉल करें:/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
apigee-serviceका 4.19.06 या 4.50.00 वर्शन इंस्टॉल करें उपयोगिता और इसकी डिपेंडेंसी. नीचे दिए गए उदाहरण में,apigee-service:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
जहां uName और pWord, आपको मिला उपयोगकर्ता नाम और पासवर्ड है Apigee से. pWord को छोड़ने पर, आपको इसे डालने के लिए कहा जाएगा.
अगर आपको गड़बड़ी का कोई मैसेज मिलता है, तो पक्का करें कि आपने
bootstrap.shफ़ाइल, 1.apigee-setupइंस्टॉल करें:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- कॉम्पोनेंट का पुराना वर्शन इंस्टॉल करें:
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
जहां component को इंस्टॉल करना है और configFile आपका .
- अगर Qpid को रोल बैक किया जा रहा है, तो iptables को फ़्लश करें:
sudo iptables -F
- यह प्रक्रिया उस हर नोड के लिए दोहराएं जो उस कॉम्पोनेंट को होस्ट करता है जिसे आपने रोल बैक किया है.
अपडेट के पिछले वर्शन पर रोल बैक करें
किसी रिलीज़ के खास वर्शन में कॉम्पोनेंट को रोल बैक करने के लिए, हर नोड पर ये काम करें जो कॉम्पोनेंट को होस्ट करता है:
- कॉम्पोनेंट का खास वर्शन डाउनलोड करें:
/opt/apigee/apigee-service/bin/apigee-service component_version install
जहां component_version कॉम्पोनेंट और उसे अपडेट करने के लिए, इंस्टॉल किया जाने वाला वर्शन है. इसके लिए उदाहरण:
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.05-0.0.3749 install
अगर Apigee के ऑनलाइन रेपो का इस्तेमाल किया जा रहा है, तो आपके पास उपलब्ध कॉम्पोनेंट पता करने का विकल्प होता है वर्शन अपडेट करने के लिए यहां दिए गए निर्देश का इस्तेमाल करें:
yum --showduplicates list comp
उदाहरण के लिए:
yum --showduplicates list edge-ui
- कॉम्पोनेंट को इंस्टॉल करने के लिए,
apigee-setupका इस्तेमाल करें:/opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
उदाहरण के लिए:
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
ध्यान दें कि वर्शन को इंस्टॉल करते समय, सिर्फ़ कॉम्पोनेंट का नाम डाला जाता है, वर्शन का नहीं.
- यह प्रक्रिया उस हर नोड के लिए दोहराएं जो उस कॉम्पोनेंट को होस्ट करता है जिसे आपने रोल बैक किया है.
Postgres 10.17 अपडेट को रोल बैक करें
अगर आपने वर्शन 4.19.06 या 4.50.00 से 4.51.00 में अपग्रेड किया है, तो आपको Edge कॉम्पोनेंट के साथ-साथ, Postgres अपडेट होता है.
मास्टर-स्टैंडबाय कॉन्फ़िगरेशन में Postgres अपडेट करते समय, Postgres अपडेट को रोलबैक करने के लिए:
- Postgres मास्टर बनने के लिए नए स्टैंडबाय नोड को प्रमोट करें. नया Postgres मास्टर और आपके पिछले Edge इंस्टॉलेशन के वर्शन के जैसा ही हो.
- पुराने स्टैंडबाय नोड को नए मास्टर के स्टैंडबाय नोड के तौर पर कॉन्फ़िगर करें. पुराना स्टैंडबाय नोड वर्शन, आपके पिछले Edge इंस्टॉलेशन के वर्शन के जैसा ही होगा.
- आंकड़ों और उपभोक्ता ग्रुप के साथ, नए मास्टर और स्टैंडबाय नोड को रजिस्टर करें.
रोल बैक करने के बाद, पुराने मास्टर नोड की ज़रूरत नहीं होगी. आप फिर पुराने मास्टर नोड को बंद कर दें.
- पक्का करें कि नया स्टैंडबाय Postgres नोड चल रहा है:
/opt/apigee/apigee-service/bin/apigee-all status
अगर Postgres नहीं चल रहा है, तो इसे शुरू करें:
/opt/apigee/apigee-service/bin/apigee-all start
- पक्का करें कि Postgres को पुराने मास्टर नोड और पुराने स्टैंडबाय नोड पर बंद कर दिया गया है:
/opt/apigee/apigee-service/bin/apigee-all status
अगर Postgres चल रहा है, तो उसे बंद कर दें:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- अगर इंस्टॉल किया गया है, तो पुराने स्टैंडबाय नोड पर Qpid शुरू करें:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- Postgres मास्टर के रूप में नए स्टैंडबाय नोड को प्रमोट करें:
- नए स्टैंडबाय नोड को नया मास्टर बनाने के लिए प्रोत्साहित करें:
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
अगर कहा जाए, तो 'apigee' के लिए Postgres पासवर्ड डालें उपयोगकर्ता, जो डिफ़ॉल्ट रूप से "पोस्टग्रेज़".
- उस कॉन्फ़िगरेशन फ़ाइल में बदलाव करें जिसका इस्तेमाल आपने Edge का मौजूदा वर्शन इंस्टॉल करने के लिए किया था
निम्न:
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- नया मास्टर कॉन्फ़िगर करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
- नए स्टैंडबाय नोड को नया मास्टर बनाने के लिए प्रोत्साहित करें:
- अगर आपने पहले ही पुराने स्टैंडबाय नोड को नए वर्शन में अपग्रेड कर लिया है, तो सबसे पहले आपको ऐसा करना होगा
पुराने स्टैंडबाय नोड पर, Apigee सॉफ़्टवेयर को डाउनग्रेड करें. अगर आपके पास अब भी पुराना वर्शन है
स्टैंडबाय नोड, आप इस चरण को छोड़कर चरण 6 से आगे बढ़ सकते हैं.
- पुराने स्टैंडबाय नोड पर Postgres बंद करें:
apigee-service apigee-postgresql stop apigee-service edge-postgres-server stop
- पुराने स्टैंडबाय नोड से Postgres अनइंस्टॉल करें:
apigee-service apigee-postgresql uninstall apigee-service edge-postgres-server uninstall
- पुराने स्टैंडबाय नोड से Postgres डेटा डायरेक्ट्री मिटाएं:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- पुराने वर्शन के बूटस्ट्रैप को डाउनलोड करें और चलाएं (Apigee वर्शन के लिए जिसे रोल आउट किया जा रहा है पर जाएं). इस्तेमाल करने के तरीके के आधार पर चरण अलग-अलग हो सकते हैं इंटरनेट आधारित या ऑफ़लाइन इंस्टॉलेशन. Apigee बूटस्ट्रैप के पुराने वर्शन का इस्तेमाल करने पर, Apigee के पुराने वर्शन के डेटा की मदद से, yum डेटा स्टोर करने की जगहें सेट अप कर सकते हैं.
- पुराने स्टैंडबाय नोड पर Postgres कॉम्पोनेंट सेट अप करें:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- जांच करें और पुष्टि करें कि पुराने स्टैंडबाय नोड पर पोस्टग्रेस कॉम्पोनेंट
पुराने वर्शन में रोल बैक कर दिया गया है:
apigee-service apigee-postgresql version apigee-service edge-postgres-server version
- पुराने स्टैंडबाय नोड पर Postgres बंद करें:
- पुराने स्टैंडबाय नोड को फिर से बनाएं:
- उस कॉन्फ़िगरेशन फ़ाइल में बदलाव करें जिसका इस्तेमाल आपने Edge का मौजूदा वर्शन इंस्टॉल करने के लिए किया था
निम्न:
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- पुराने स्टैंडबाय नोड पर डेटा डायरेक्ट्री हटाएं:
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- पुराने स्टैंडबाय नोड को नए मास्टर के स्टैंडबाय नोड के तौर पर फिर से कॉन्फ़िगर करें:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- पक्का करें कि Postgres पुराने स्टैंडबाय नोड पर चल रहा है:
/opt/apigee/apigee-service/bin/apigee-all status
अगर Postgres नहीं चल रहा है, तो इसे शुरू करें:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- उस कॉन्फ़िगरेशन फ़ाइल में बदलाव करें जिसका इस्तेमाल आपने Edge का मौजूदा वर्शन इंस्टॉल करने के लिए किया था
निम्न:
- पुष्टि करें कि नया स्टैंडबाय नोड
/opt/apigee/apigee-postgresql/conf/pg_hba.confफ़ाइल नए मास्टर पर रखें. - नीचे दिए गए निर्देश की मदद से, आंकड़ों और उपभोक्ताओं के ग्रुप की मौजूदा जानकारी देखें
पर जाकर देखें:
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
यह निर्देश,
nameफ़ील्ड में मौजूद Analytics ग्रुप का नाम दिखाता है औरconsumer-groupsमें दिए गएnameफ़ील्ड में उपभोक्ता ग्रुप का नाम. यह भी यह फ़ंक्शन, GA में पुराने Postgres मास्टर और स्टैंडबाय नोड के यूयूआईडी दिखाता हैpostgres-serverफ़ील्ड में औरdatastoresफ़ील्ड में. आपको यह देखना चाहिए इस रूप में होगा:{ "name" : "axgroup-001", "properties" : { }, "scopes" : [ "VALIDATE~test", "sgilson~prod" ], "uuids" : { "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ], "postgres-server" : [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ] }, "consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ], "datastores" : [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ], "properties" : { } } ], "data-processors" : { } } - पुराने मास्टर का यूयूआईडी पता पाने के लिए, यहां दिया गया
curlकमांड चलाएं पुराना मास्टर नोड:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
नोड का यूयूआईडी, आउटपुट के आखिर में इस फ़ॉर्मैट में दिखेगा:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- पुराने स्टैंडबाय नोड और नए आईपी पते पाने के लिए पिछला चरण दोहराएं मास्टर.
- उपभोक्ता ग्रुप से पुराने मास्टर और स्टैंडबाय नोड हटाएं:
curl -u sysAdminEmail:password -X DELETE \ "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v
जहां axgroup-001 और consumer-group-001 और उपभोक्ता समूहों के बारे में बताया गया है. masterUUID,standbyUUID उसी क्रम में हैं जिसमें वे ऊपर दिया गया है. आपने लोगों तक पहुंचाया मुफ़्त में उन्हें standbyUUID,masterUUID के तौर पर बताना पड़ सकता है.
consumer-groupsके लिएdatastoresप्रॉपर्टी अब यह होनी चाहिए खाली. - Analytics ग्रुप से पुराने मास्टर और स्टैंडबाय नोड हटाएं:
curl -u sysAdminEmail:password -X DELETE \ "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
uuidsसे कम कीpostgres-serverप्रॉपर्टी अब खाली हो जानी चाहिए. - आंकड़ों और उपभोक्ता ग्रुप के साथ, नए PG मास्टर और स्टैंडबाय नोड रजिस्टर करें:
curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v - आंकड़ों के ग्रुप की पुष्टि करें:
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
आपको Analytics ग्रुप में नए मास्टर और स्टैंडबाय नोड के यूयूआईडी दिखेंगे और उपभोक्ता ग्रुप में शामिल हैं.
- Edge मैनेजमेंट सर्वर को रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- सभी Qpid सर्वर रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
- सभी Postgres सर्वर को रीस्टार्ट करें:
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
- दोनों सर्वर पर निम्न स्क्रिप्ट जारी करके प्रतिकृति स्थिति सत्यापित करें. सिस्टम
एक सफल रेप्लिकेशन पक्का करने के लिए, दोनों सर्वर पर एक जैसे नतीजे दिखाने चाहिए:
नए मास्टर पर, चलाएं:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
पुष्टि करें कि यह मास्टर है. पुराने स्टैंडबाय नोड पर:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
पुष्टि करें कि यह स्टैंडबाय मोड में है.
- कई एपीआई अनुरोध करने के बाद पिछला चरण दोहराएं, ताकि यह पक्का किया जा सके कि नोड सिंक.
- इस प्रक्रिया का उपयोग करके पुराने पोस्टग्रेस मास्टर को बंद करें
Apigee Edge को अपडेट करना
4.16.01/4.16.05 से 4.17.09.
इसके अलावा, पुराने मास्टर से Qpid को अनइंस्टॉल किया जा सकता है और नए मास्टर नोड पर Qpid इंस्टॉल करें. Qpid को अनइंस्टॉल करने के बाद, आपके पास पुराना मास्टर नोड.
mTLS रोल बैक करें
mTLS अपडेट को रोल बैक करने के लिए, सभी होस्ट पर यह तरीका अपनाएं:
- Apigee को बंद करें:
apigee-all stop
- mTLS रोकें:
apigee-service apigee-mtls uninstall
- mTLS फिर से इंस्टॉल करें:
apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf