Apigee Edge 4.53.00 को रोल बैक करना

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

Edge 4.53.00 को इस माइनर रिलीज़ वर्शन पर रोल बैक किया जा सकता है:

• वर्शन 4.52.02

किसी वर्शन को वापस लाने का मतलब है कि आपने जिन कॉम्पोनेंट को अपग्रेड किया है उन्हें वापस लाना. इसके अलावा, Cassandra को वर्शन 4.52.02 पर वापस लाते समय, आपको कुछ बातों का खास तौर पर ध्यान रखना चाहिए.

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

1. पिछली मुख्य या छोटी रिलीज़ पर वापस जाएं. उदाहरण के लिए, 4.53.00 से 4.52.02 तक.
2. उसी रिलीज़ में, पिछली पैच रिलीज़ पर रोल बैक करें. उदाहरण के लिए, 4.53.00.01 से 4.53.00.00 तक.

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

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

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

Private Cloud 4.53.00 के लिए, रोलबैक का सामान्य क्रम कुछ ऐसा होगा:

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

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

1. एक-एक करके सभी आरएमपी को वापस लाना
2. बैकअप का इस्तेमाल करके, पूरे Cassandra क्लस्टर को वापस लाना
3. Edge Management Server के नोड को एक-एक करके वापस लाना

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

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

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

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

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

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

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

Cassandra को रोलबैक करना

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

रोलबैक की स्थितियां

Cassandra 4.0.X, Edge for Private Cloud 4.53.00 के साथ उपलब्ध है. यह Private Cloud 4.52.02 के अन्य कॉम्पोनेंट के साथ काम करता है.

रोलबैक करने की अलग-अलग रणनीतियों के बारे में खास जानकारी पाने के लिए, कृपया यहां दी गई टेबल देखें:

सामान्य मान्यताएं

रोलबैक करने के बारे में सोचते समय, इन बातों का ध्यान रखें:

• रनटाइम या मैनेजमेंट कॉम्पोनेंट को वापस पहले जैसा करना: अगर आपको edge-management-server, edge-message-processor या किसी भी नॉन-कैसेंड्रा कॉम्पोनेंट को Private Cloud के वर्शन 4.52.02 पर वापस लाना है, तो हमारा सुझाव है कि आप कैसेंड्रा को वापस पहले जैसा न करें. Private Cloud 4.53.00 के साथ शिप किया गया Cassandra, Edge for Private Cloud 4.52.02 के सभी नॉन-Cassandra कॉम्पोनेंट के साथ काम करता है. यहां दी गई प्रोसेस का इस्तेमाल करके, नॉन-कैसेंड्रा कंपोनेंट को वापस पहले वाले वर्शन पर ले जाया जा सकता है. हालांकि, कैसेंड्रा 4.0.13 वर्शन पर ही रहेगा.
• पूरे Cassandra क्लस्टर को 4.0.X पर अपग्रेड करने के बाद रोलबैक करना: अगर Private Cloud के वर्शन 4.53.00 पर अपग्रेड करने के दौरान, आपका पूरा Cassandra क्लस्टर 4.0.X वर्शन पर अपग्रेड हो जाता है, तो हमारा सुझाव है कि आप इस क्लस्टर सेटअप का इस्तेमाल जारी रखें और Cassandra को रोलबैक न करें. Private Cloud 4.52.02 वर्शन के कॉम्पोनेंट, जैसे कि edge-management-server, edge-message-processor, edge-router वगैरह, Cassandra 4.0.X वर्शन के साथ काम करते हैं.
• Cassandra को अपग्रेड करने के दौरान, Cassandra को पहले जैसा करना: अगर आपको Cassandra को अपग्रेड करने के दौरान समस्याएं आती हैं, तो हो सकता है कि आपको इसे पहले जैसा करना पड़े. इस लेख में दी गई रोलबैक की रणनीतियों का पालन, अपग्रेड की प्रोसेस के दौरान अपनी स्थिति के आधार पर किया जा सकता है.
• बैकअप का इस्तेमाल करके रोलबैक करना: Cassandra 4.0.X से लिए गए बैकअप, Cassandra 3.11.X के बैकअप के साथ काम नहीं करते. बैकअप को वापस लाकर Cassandra को पहले जैसा करने के लिए, आपको अपग्रेड करने से पहले Cassandra 3.11.X के बैकअप लेने होंगे.

रीबिल्ड का इस्तेमाल करके Cassandra को वापस लाना

ज़रूरी शर्तें

• आपके पास कई डेटा सेंटर में Edge for Private Cloud 4.52.02 क्लस्टर है.
• Cassandra को 3.11.X से 4.0.X पर अपग्रेड किया जा रहा है और अपग्रेड के दौरान समस्याएं आ रही हैं.
• आपके पास क्लस्टर में कम से कम एक ऐसा डेटा सेंटर है जो पूरी तरह से काम कर रहा है और अब भी Cassandra के पुराने वर्शन (Cassandra 3.11.X) पर चल रहा है.

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

हाई-लेवल के चरण

1. वह डेटा सेंटर चुनें जिसे आपको वापस पहले जैसा करना है. यह डेटा सेंटर, आंशिक या पूरी तरह से अपग्रेड किया गया हो. रनटाइम ट्रैफ़िक को किसी दूसरे डेटा सेंटर पर डाइवर्ट करें.
2. डेटा सेंटर में सीड नोड की पहचान करें और किसी एक सीड नोड से शुरू करें.
3. Cassandra नोड को बंद करें, अनइंस्टॉल करें, और साफ़ करें.
4. नोड पर Cassandra का पुराना वर्शन इंस्टॉल करें और उसे अपनी ज़रूरत के हिसाब से कॉन्फ़िगर करें.
5. पहले जोड़े गए अतिरिक्त कॉन्फ़िगरेशन हटाएं.
6. डेटा सेंटर में मौजूद सभी सीड नोड के लिए, ऊपर दिया गया तरीका एक-एक करके दोहराएं.
7. डेटा सेंटर में मौजूद बाकी सभी Cassandra नोड के लिए, ऊपर दिया गया तरीका एक-एक करके दोहराएं.
8. मौजूदा फ़ंक्शनल डेटा सेंटर से नोड को एक-एक करके फिर से बनाएं.
9. डेटा सेंटर में Cassandra से कनेक्ट किए गए सभी edge-* कॉम्पोनेंट रीस्टार्ट करें.
10. इस डेटा सेंटर पर वापस ट्रैफ़िक भेजने की जांच करें.
11. हर डेटा सेंटर के लिए, एक-एक करके यह तरीका दोहराएं.

ज़्यादा जानकारी

1. वह डेटा सेंटर चुनें जहां सभी या कुछ Cassandra नोड अपग्रेड किए गए हैं. इस डेटा सेंटर में Cassandra नोड को वापस रोल बैक करने के दौरान, इस डेटा सेंटर से सभी रनटाइम प्रॉक्सी ट्रैफ़िक और मैनेजमेंट ट्रैफ़िक को डाइवर्ट करें. पक्का करें कि नोड पर nodetool ring कमांड चलाने पर, सभी Cassandra नोड UN (अप/नॉर्मल) स्थिति में हों. अगर कुछ नोड काम नहीं कर रहे हैं, तो समस्या को हल करें और आगे बढ़ने से पहले उन नोड को वापस चालू करें.

   नीचे दिया गया उदाहरण देखें:

   /opt/apigee/apigee-cassandra/bin/nodetool status
   Datacenter: dc-1
   ================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
   UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
   UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
   UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
   Datacenter: dc-2
   ================
   Status=Up/Down
   |/ State=Normal/Leaving/Joining/Moving
   --  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
   UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
   UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
   UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

   पूरे क्लस्टर की मौजूदा स्थिति जानने के लिए, नोड पर nodetool describecluster चलाया जा सकता है. उदाहरण के लिए, यहां दो डेटा सेंटर वाले क्लस्टर का एक इंस्टेंस दिखाया गया है. इसमें DC-1 के सभी नोड, Cassandra के वर्शन 4 पर हैं. वहीं, DC-2 के सभी नोड, Cassandra के वर्शन 3 पर हैं:

   # On nodes where Cassandra is upgraded
   /opt/apigee/apigee-cassandra/bin/nodetool describecluster
   Cluster Information:
       Name: Apigee
       Snitch: org.apache.cassandra.locator.PropertyFileSnitch
       DynamicEndPointSnitch: enabled
       Partitioner: org.apache.cassandra.dht.RandomPartitioner
       Schema versions:
           2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
           129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
   
   Stats for all nodes:
       Live: 6
       Joining: 0
       Moving: 0
       Leaving: 0
       Unreachable: 0
   
   Data Centers:
       dc-1 #Nodes: 3 #Down: 0
       dc-2 #Nodes: 3 #Down: 0
   
   Database versions:
       4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
       3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]
   
   Keyspaces:
       system_schema -> Replication class: LocalStrategy {}
       system -> Replication class: LocalStrategy {}
       auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
       system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
       system_traces -> Replication class: SimpleStrategy {replication_factor=2}
       system_auth -> Replication class: SimpleStrategy {replication_factor=1}
   
   # On nodes where Cassandra is not upgraded
   /opt/apigee/apigee-cassandra/bin/nodetool describecluster
   Cluster Information:
       Name: Apigee
       Snitch: org.apache.cassandra.locator.PropertyFileSnitch
       DynamicEndPointSnitch: enabled
       Partitioner: org.apache.cassandra.dht.RandomPartitioner
       Schema versions:
           2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
           129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
           

2. डेटा सेंटर में सीड नोड की पहचान करें: अपेंडिक्स में, सीड नोड की पहचान कैसे करें सेक्शन देखें. नीचे दिया गया तरीका, किसी एक सीड नोड पर अपनाएं:
3. Cassandra के नोड से डेटा को रोकना, अनइंस्टॉल करना, और साफ़ करना. इस डेटा सेंटर में Cassandra के वर्शन 4 पर पहला सीड नोड चुनें. इसे बंद करो.

   # Stop Cassandra service on the node
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
   
   # Uninstall Cassandra software
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
   
   # Wipe out Cassandra data
   rm -rf /opt/apigee/data/apigee-cassandra
           

4. नोड पर Cassandra का पुराना सॉफ़्टवेयर इंस्टॉल करें और कुछ कॉन्फ़िगरेशन सेट करें. Edge for Private Cloud 4.52.02 की बूटस्ट्रैप फ़ाइल को एक्ज़ीक्यूट करें.

# Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u uName:pWord

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    

5. फ़ाइल /opt/apigee/customer/application/cassandra.properties बनाएं या उसमें बदलाव करें.
6. फ़ाइल में यह कॉन्टेंट जोड़ें. ipOfNode उस नोड का आईपी पता है जिसका इस्तेमाल Cassandra, अन्य Cassandra नोड से कम्यूनिकेट करने के लिए करता है:

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true

7. पक्का करें कि फ़ाइल का मालिकाना हक apigee उपयोगकर्ता के पास हो और वह उसे पढ़ सकता हो:

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

8. Cassandra को इंस्टॉल और सेट अप करें:

   # Install cassandra version 3.11.X
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
   
   # Setup cassandra while passing standard configuration file
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
   # Ensure Cassandra version is correct and service is running
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

9. पुष्टि करें कि नोड शुरू हो गया है. इस नोड और क्लस्टर के अन्य नोड पर, यहां दिया गया कमांड देखें. नोड को यह रिपोर्ट करना चाहिए कि वह "UN" (अप/सामान्य) स्थिति में है:

   /opt/apigee/apigee-cassandra/bin/nodetool status

10. फ़ाइल /opt/apigee/customer/application/cassandra.properties से, पहले जोड़े गए अतिरिक्त कॉन्फ़िगरेशन हटाएं.
11. डेटा सेंटर में मौजूद सभी Cassandra सीड नोड पर, एक-एक करके तीसरे से लेकर दसवें चरण तक की प्रोसेस दोहराएं.
12. डेटा सेंटर में मौजूद बाकी सभी Cassandra नोड पर, एक-एक करके तीसरे से लेकर दसवें चरण तक की प्रोसेस दोहराएं.
13. डेटा सेंटर के सभी नोड को, Cassandra के पुराने वर्शन का इस्तेमाल करने वाले डेटा सेंटर से फिर से बनाएं. इस चरण को एक बार में एक नोड के लिए पूरा करें:

    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>

    इस प्रोसेस में कुछ समय लग सकता है. ज़रूरत पड़ने पर, streamingthroughput में बदलाव किया जा सकता है. कार्रवाई पूरी होने का स्टेटस देखने के लिए, nodetool netstats देखें.

14. (ज़रूरी नहीं) अगर डेटा फिर से नहीं बनाया जा रहा है, तो Cassandra नोड में रिपेयर कमांड चलाएं.

    /opt/apigee/apigee-cassandra/bin/nodetool -h node-IP repair -pr

15. डेटा सेंटर में मौजूद सभी edge-* कॉम्पोनेंट को एक-एक करके रीस्टार्ट करें:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
    /opt/apigee/apigee-service/bin/apigee-service edge-router restart
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

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

बैकअप का इस्तेमाल करके Cassandra को वापस लाना

ज़रूरी शर्तें

1. Cassandra को 3.11.X से 4.0.X पर अपग्रेड किया जा रहा है और अपग्रेड के दौरान समस्याएं आ रही हैं.
2. आपके पास उस नोड के बैकअप हों जिसे रोल बैक किया जा रहा है. बैकअप, 3.11.X से 4.0.X पर अपग्रेड करने से पहले लिया गया था.

चरण

1. वह नोड चुनें जिसे आपको वापस लाना है. अगर आपको बैकअप का इस्तेमाल करके, डेटा सेंटर के सभी नोड को पहले जैसा करना है, तो सबसे पहले सीड नोड को पहले जैसा करें. अपेंडिक्स में, "सीड नोड की पहचान कैसे करें" सेक्शन देखें.

2. Cassandra नोड को बंद करें, अनइंस्टॉल करें, और साफ़ करें:

   # Stop Cassandra service on the node
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
   
   # Uninstall Cassandra software
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall
   
   # Wipe Cassandra data
   rm -rf /opt/apigee/data/apigee-cassandra

3. नोड पर Cassandra का पुराना सॉफ़्टवेयर इंस्टॉल करें और उसे कॉन्फ़िगर करें:

   • Edge for Private Cloud 4.52.02 के लिए, बूटस्ट्रैप फ़ाइल को एक्ज़ीक्यूट करें:

   # Download bootstrap for 4.52.02
   curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’
   
   # Execute bootstrap for 4.52.02
   sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

   • फ़ाइल बनाएं या उसमें बदलाव करें /opt/apigee/customer/application/cassandra.properties:

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true

   • पक्का करें कि फ़ाइल का मालिकाना हक apigee उपयोगकर्ता के पास हो और उसे पढ़ा जा सकता हो:

   chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

   • Cassandra को इंस्टॉल और सेट अप करें:

   # Install Cassandra version 3.11.X
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
   
   # Set up Cassandra with the standard configuration file
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
   
   # Verify Cassandra version and check service status
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

   पुष्टि करें कि नोड शुरू हो गया है. इस नोड और क्लस्टर के अन्य नोड पर, यहां दिया गया कमांड देखें. नोड को यह रिपोर्ट करना चाहिए कि यह नोड "UN" स्थिति में है:

   /opt/apigee/apigee-cassandra/bin/nodetool status

4. Cassandra सेवा को बंद करें और बैकअप को वापस लाएं. ज़्यादा जानकारी के लिए, बैकअप और रीस्टोर करने से जुड़ा दस्तावेज़ देखें:

   # Stop Cassandra service on the node
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop
   
   # Wipe the data directory in preparation for restore
   rm -rf /opt/apigee/data/apigee-cassandra/data
   
   # Restore the backup taken before the upgrade attempt
   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile
           

5. बैकअप वापस लाने के बाद, अतिरिक्त कॉन्फ़िगरेशन हटाएं:

   फ़ाइल /opt/apigee/customer/application/cassandra.properties से, पहले जोड़ा गया कॉन्फ़िगरेशन हटाएं.

6. नोड पर Cassandra सेवा शुरू करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

7. बैकअप का इस्तेमाल करके, आपको जिस Cassandra नोड को पहले जैसा करना है उसके लिए यह तरीका दोहराएं. एक बार में सिर्फ़ एक नोड को पहले जैसा किया जा सकता है.

8. सभी Cassandra नोड वापस लाने के बाद, एक-एक करके सभी edge-* कॉम्पोनेंट फिर से शुरू करें:

   /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
   /opt/apigee/apigee-service/bin/apigee-service edge-router restart
   /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
           

बैकअप ऑप्टिमाइज़ेशन (ऐडवांस विकल्प)

अगर आपके पास ऐसे रेप्लिका उपलब्ध हैं जिनमें नया डेटा मौजूद है, तो बैकअप वापस लाते समय डेटा के नुकसान को कम किया जा सकता है. ऐसा भी हो सकता है कि डेटा का नुकसान न हो. अगर रेप्लिका उपलब्ध हैं, तो बैकअप को वापस लाने के बाद, उस नोड को ठीक करें जिसे वापस लाया गया था.

अन्य जानकारी

सीड नोड की पहचान कैसे करें

डेटा सेंटर में मौजूद किसी भी Cassandra नोड पर, यह कमांड चलाएं:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

इस कमांड से कई लाइनें आउटपुट होंगी. आउटपुट की आखिरी लाइन देखें. आखिरी लाइन में दिए गए आईपी पते, सीड नोड होते हैं. यहां दिए गए उदाहरण में, DC-1-IP1, DC-1-IP2, DC-2-IP1, और DC-2-IP2 सीड नोड के आईपी पते हैं:

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

पिछली मुख्य या सामान्य रिलीज़ पर वापस जाना

पिछली मुख्य या माइनर रिलीज़ पर वापस जाने के लिए, कॉम्पोनेंट को होस्ट करने वाले हर नोड पर यह तरीका अपनाएं:

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

   • 4.52.02 वर्शन पर वापस जाने के लिए, bootstrap_4.52.02.sh डाउनलोड करें:

     curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.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. Nginx को पहले जैसा करने के लिए, यहां दिया गया तरीका अपनाएं:

      ###Find the apigee-nginx RPM 
      rpm -qa | grep -i "apigee-nginx"
      
      ###Remove the apigee-nginx RPM
      dnf remove apigee-nginx-1.26.x
      

   3. नोड पर मौजूद किसी अन्य कॉम्पोनेंट को पहले जैसा करने के लिए, सिर्फ़ उस कॉम्पोनेंट को अनइंस्टॉल करें. यहां दिए गए उदाहरण में ऐसा करने का तरीका बताया गया है:

      /opt/apigee/apigee-service/bin/apigee-service component uninstall

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

   4. Edge Router को पहले वाले वर्शन पर वापस लाने के लिए, आपको /opt/nginx/conf.d फ़ाइल का कॉन्टेंट मिटाना होगा. साथ ही, edge-gateway कॉम्पोनेंट ग्रुप को अनइंस्टॉल करना होगा:

      cd /opt/nginx/conf.d
      rm -rf *

5. apigee-setup का 4.53.00 वर्शन अनइंस्टॉल करें:

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

6. apigee-service यूटिलिटी और उसकी डिपेंडेंसी का 4.52.02 वर्शन इंस्टॉल करें. यहां दिए गए उदाहरण में, apigee-service का 4.52.02 वर्शन इंस्टॉल करने का तरीका बताया गया है:

   sudo bash /tmp/bootstrap_4.52.02.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.53.00-0.0.20254 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. यह प्रोसेस हर उस नोड के लिए दोहराएं जो उस कॉम्पोनेंट को होस्ट करता है जिसे आपको वापस लाना है.

एमटीएलएस को रोल बैक करना

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

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