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

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

Edge 4.53.01 को इनमें से किसी भी मुख्य रिलीज़ वर्शन पर रोल बैक किया जा सकता है:

  • वर्शन 4.53.00
  • वर्शन 4.52.02

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

इस वर्शन पर वापस जाएं सॉफ़्टवेयर के लिए खास बातें
4.53.00 Zookeeper, Postgres, LDAP
4.52.02 Zookeeper, Cassandra, Postgres, LDAP

यहां एक ऐसा उदाहरण दिया गया है जिसमें आपको रोलबैक करने की ज़रूरत पड़ सकती है:

पिछली मुख्य या छोटी रिलीज़ पर वापस जाएं. उदाहरण के लिए, 4.53.01 से 4.53.00.

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

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

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

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

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

  • एक-एक करके सभी आरएमपी को वापस लाना
  • बैकअप का इस्तेमाल करके, पूरे Cassandra क्लस्टर को वापस लाना
  • 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.01 के साथ उपलब्ध है. यह Private Cloud 4.52.02 के अन्य कॉम्पोनेंट के साथ काम करता है.

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

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

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

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

  • रनटाइम या मैनेजमेंट कॉम्पोनेंट को वापस पहले जैसा करना: अगर आपको 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 की बूटस्ट्रैप फ़ाइल को एक्ज़ीक्यूट करें. 
    5. # 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 को इंस्टॉल और सेट अप करें:
    9. # 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

Zookeeper 3.8.4 के अपडेट को वापस लाना

रोलबैक

अगर रोलबैक करना ज़रूरी हो, तो:

  1. सबसे पहले, ऑब्ज़र्वर और फ़ॉलोअर पर रोलबैक करने के चरण पूरे करें.
  2. जिस वर्शन पर वापस जाना है उसका बूटस्ट्रैप डाउनलोड करें और उसे लागू करें. यह वर्शन 4.52.02 या 4.53.00 होना चाहिए. नोड में बाहरी इंटरनेट कनेक्शन है या ऑफ़लाइन इंस्टॉलेशन किया जा रहा है, इस आधार पर प्रोसेस अलग-अलग हो सकती है.
  3. अगर नोड पर Zookeeper चल रहा है, तो उसे बंद करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. मौजूदा zookeeper को अनइंस्टॉल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. Zookeeper को सामान्य तरीके से इंस्टॉल करें: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. सभी फ़ॉलोअर और ऑब्ज़र्वर नोड को वापस लाने के बाद, लीडर नोड को वापस लाएं. इसके लिए, लीडर नोड पर चरण 2 से 5 तक दिए गए निर्देशों का पालन करें.
  7. सभी नोड को वापस लाने के बाद, क्लस्टर की स्थिति की पुष्टि करें. साथ ही, यह पक्का करें कि क्लस्टर में एक लीडर नोड मौजूद हो.

बैक अप वापस लाएं

बैकअप से वापस लाएं लेख पढ़ें. ध्यान दें कि Edge for Private Cloud के पुराने वर्शन, जैसे कि 4.52.02 या 4.53.00 से लिए गए Zookeeper के बैकअप, Edge for Private Cloud 4.53.01 में Zookeeper के वर्शन के साथ काम करने चाहिए

Postgres 17 के अपडेट को पहले जैसा करें

अगर आपने 4.52.02 या 4.53.00 वर्शन से 4.53.01 वर्शन पर अपग्रेड किया है, तो आपको Edge कॉम्पोनेंट के साथ-साथ Postgres अपडेट को भी वापस लाना होगा.

मास्टर-स्टैंडबाय कॉन्फ़िगरेशन में Postgres को अपडेट करते समय, Postgres के अपडेट को वापस लाने के लिए:

  • नए स्टैंडबाय नोड को Postgres मास्टर के तौर पर प्रमोट करें. नया Postgres मास्टर, आपके पिछले Edge इंस्टॉलेशन के वर्शन के जैसा ही होगा.
  • पुराने स्टैंडबाय नोड को नए मास्टर का स्टैंडबाय नोड बनाने के लिए कॉन्फ़िगर करें. पुराना स्टैंडबाय नोड, आपके पिछले Edge इंस्टॉलेशन के वर्शन के जैसा ही होगा.
  • नए मास्टर और स्टैंडबाय नोड को, Analytics और उपभोक्ता ग्रुप के साथ रजिस्टर करें.

रोलबैक पूरा होने के बाद, पुराने मास्टर नोड की ज़रूरत नहीं होगी. इसके बाद, पुराने मास्टर नोड को बंद किया जा सकता है.

शुरू करने से पहले

Postgres 17 को 14 पर वापस लाने से पहले, नए स्टैंडबाय होस्ट और पुराने स्टैंडबाय, दोनों पर यह तरीका अपनाएं. इससे apigee-postgresql पर max_locks_per_transaction प्रॉपर्टी को अपडेट किया जा सकेगा:

  1. अगर यह फ़ाइल मौजूद नहीं है, तो /opt/apigee/customer/application/postgresql.properties फ़ाइल बनाएं
  2. इस फ़ाइल का मालिकाना हक apigee को दें: 
    sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  3. फ़ाइल में यह प्रॉपर्टी जोड़ें: 
    conf/postgresql.conf+max_locks_per_transaction=30000
  4. apigee-postgresql को कॉन्फ़िगर करें: 
    apigee-service apigee-postgresql configure
  5. apigee-postgresql को रीस्टार्ट करें: 
    apigee-service apigee-postgresql restart
  1. पक्का करें कि नया स्टैंडबाय Postgres नोड चल रहा हो: 
    /opt/apigee/apigee-service/bin/apigee-all status

    अगर Postgres चालू नहीं है, तो इसे चालू करें:

    /opt/apigee/apigee-service/bin/apigee-all start
  2. पक्का करें कि पुराने मास्टर नोड और पुराने स्टैंडबाय नोड पर 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
  3. अगर Qpid इंस्टॉल है, तो पुराने स्टैंडबाय नोड पर Qpid शुरू करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. नए स्टैंडबाय नोड को Postgres मास्टर के तौर पर प्रमोट करें:
    1. नए स्टैंडबाय नोड को नया मास्टर नोड बनाएं: 
      apigee-service apigee-postgresql promote-standby-to-master old_master_IP

      अगर कहा जाए, तो 'apigee' उपयोगकर्ता के लिए Postgres का पासवर्ड डालें. यह डिफ़ॉल्ट रूप से "postgres" होता है.

    2. Edge के मौजूदा वर्शन को इंस्टॉल करने के लिए इस्तेमाल की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करें. इसके लिए, आपको यह जानकारी देनी होगी: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    3. नए मास्टर को कॉन्फ़िगर करें:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. अगर आपने पहले ही पुराने स्टैंडबाय नोड को नए वर्शन में अपग्रेड कर दिया है, तो आपको पहले पुराने स्टैंडबाय नोड पर Apigee सॉफ़्टवेयर को डाउनग्रेड करना होगा. अगर आपके पास अब भी पुराने स्टैंडबाय नोड पर पुराना वर्शन है, तो इस चरण को छोड़कर छठे चरण पर जाएं.
    1. पुराने स्टैंडबाय नोड पर Postgres को बंद करें: 
      apigee-service apigee-postgresql stop
apigee-service edge-postgres-server stop
    2. पुराने स्टैंडबाय नोड से Postgres अनइंस्टॉल करें: 
      apigee-service apigee-postgresql uninstall
apigee-service edge-postgres-server uninstall
    3. पुराने स्टैंडबाय नोड से Postgres डेटा डायरेक्ट्री मिटाएं: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    4. स्टैंडबाय नोड पर, पुराने वर्शन का बूटस्ट्रैप डाउनलोड करें और उसे चलाएं. यह बूटस्ट्रैप, Apigee के उस वर्शन के लिए होना चाहिए जिस पर आपको वापस जाना है. इंटरनेट पर आधारित या ऑफ़लाइन इंस्टॉलेशन का इस्तेमाल करने के आधार पर, सटीक चरण अलग-अलग हो सकते हैं. Apigee के पुराने वर्शन के बूटस्ट्रैप को चलाने से, yum रिपॉज़िटरी में Apigee के पुराने वर्शन का डेटा सेट अप हो जाएगा.
    5. पुराने स्टैंडबाय नोड पर Postgres कॉम्पोनेंट सेट अप करें: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. जांच करें और पुष्टि करें कि पुराने स्टैंडबाय नोड पर Postgres कॉम्पोनेंट को पुराने वर्शन पर वापस ले जाया गया है: 
      apigee-service apigee-postgresql version
apigee-service edge-postgres-server version
  6. पुराने स्टैंडबाय नोड को फिर से बनाएं:
    1. Edge के मौजूदा वर्शन को इंस्टॉल करने के लिए इस्तेमाल की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करें. इसके लिए, आपको यह जानकारी देनी होगी: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    2. स्टैंडबाय नोड पर मौजूद डेटा डायरेक्ट्री हटाएं: 
      cd /opt/apigee/data/apigee-postgresql/pgdata
rm -rf *
    3. पुराने स्टैंडबाय नोड को नए मास्टर के स्टैंडबाय नोड के तौर पर फिर से कॉन्फ़िगर करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. पक्का करें कि Postgres, पुराने स्टैंडबाय नोड पर चल रहा हो: 
      /opt/apigee/apigee-service/bin/apigee-all status

      अगर Postgres चालू नहीं है, तो इसे चालू करें:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  7. पुष्टि करें कि नया स्टैंडबाय नोड जोड़ा गया है. इसके लिए, नए मास्टर पर मौजूद /opt/apigee/apigee-postgresql/conf/pg_hba.conf फ़ाइल देखें.
  8. मैनेजमेंट सर्वर पर यह कमांड चलाकर, मौजूदा आंकड़ों और उपभोक्ता ग्रुप की जानकारी देखें: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    इस कमांड से, name फ़ील्ड में Analytics ग्रुप का नाम और name फ़ील्ड में उपभोक्ता ग्रुप का नाम दिखता है. ये दोनों फ़ील्ड, consumer-groups के नीचे होते हैं. यह postgres-server फ़ील्ड और datastores फ़ील्ड में, Postgres के पुराने मास्टर और स्टैंडबाय नोड के यूयूआईडी भी दिखाता है. आपको इस फ़ॉर्म में आउटपुट दिखेगा: 

    {
  "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" : {
  }
}
  9. पुराने मास्टर नोड पर, यहां दी गई curl कमांड चलाकर, पुराने मास्टर का यूयूआईडी पता पाएं: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    आपको आउटपुट के आखिर में नोड का यूयूआईडी दिखेगा. यह इस फ़ॉर्मैट में होगा:

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  10. स्टैंडबाय नोड और नए मास्टर के आईपी पते पाने के लिए, पिछला चरण दोहराएं.
  11. उपयोगकर्ता ग्रुप से पुराने मास्टर और स्टैंडबाय नोड हटाएं: 
    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, Analytics और उपभोक्ता ग्रुप के डिफ़ॉल्ट नाम हैं. masterUUID,standbyUUID उसी क्रम में हैं जिस क्रम में वे ऊपर दिख रहे थे. ऐसा तब हुआ, जब आपने ऊपर मौजूदा आंकड़ों और उपभोक्ता ग्रुप की जानकारी देखी. आपको उन्हें standbyUUID,masterUUID के तौर पर सेट करना पड़ सकता है.

    अब consumer-groups के लिए datastores प्रॉपर्टी खाली होनी चाहिए.

  12. ऐनलिटिक्स ग्रुप से पुराने मास्टर और स्टैंडबाय नोड हटाएं: 
    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 प्रॉपर्टी अब खाली होनी चाहिए.

  13. ऐनलिटिक्स और उपभोक्ता ग्रुप के साथ नए पीजी मास्टर और स्टैंडबाय नोड रजिस्टर करें:
    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
  14. Analytics ग्रुप की पुष्टि करें: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    आपको नए मास्टर और स्टैंडबाय नोड के यूयूआईडी, आंकड़ों के ग्रुप और उपभोक्ता ग्रुप में दिखेंगे.

  15. Edge Management Server को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  16. सभी Qpid सर्वर रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  17. सभी Postgres सर्वर रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  18. दोनों सर्वर पर यहां दी गई स्क्रिप्ट चलाकर, रेप्लिकेशन की स्थिति की पुष्टि करें. सिस्टम को दोनों सर्वर पर एक जैसे नतीजे दिखाने चाहिए, ताकि रेप्लिकेशन सही तरीके से हो सके:

    नए मास्टर पर, यह कमांड चलाएं:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

    पुष्टि करें कि यह मास्टर है. स्टैंडबाय नोड पर: 

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    पुष्टि करें कि यह स्टैंडबाय है.

  19. कई एपीआई अनुरोध करने के बाद, पिछले चरण को दोहराएं. इससे यह पक्का किया जा सकेगा कि नोड सिंक हो गए हैं.
  20. Postgres नोड को बंद करना में दी गई प्रक्रिया का इस्तेमाल करके, पुराने Postgres मास्टर को बंद करें.

    इसके अलावा, पुराने मास्टर नोड से Qpid को अनइंस्टॉल किया जा सकता है और नए मास्टर नोड पर Qpid को इंस्टॉल किया जा सकता है. Qpid को अनइंस्टॉल करने के बाद, पुराने मास्टर नोड को बंद किया जा सकता है.

LDAP 2.6 अपडेट को पहले जैसा करना

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

इसका मुख्य मकसद, पूरे एलडीएपी क्लस्टर को किसी ऐसे बैकअप से वापस लाना है जो सही तरीके से काम कर रहा हो. यह तरीका सभी स्थितियों में एक जैसा होता है. जैसे, सिंगल सर्वर, ऐक्टिव-ऐक्टिव, और ऐक्टिव-पैसिव.

ज़रूरी शर्तें और ध्यान रखने वाली बातें

  • बैकअप काम नहीं करता: LDAP के पुराने 2.4 वर्शन का बैकअप इस्तेमाल करें. यह वर्शन, Edge for Private Cloud 4.52.02 या 4.53.00 के साथ काम करता है. यह बैकअप, अपग्रेड करने से पहले लिया गया होना चाहिए. अपग्रेड के बाद लिए गए बैकअप, पुराने वर्शन के साथ काम नहीं करते. इसलिए, उनका इस्तेमाल नहीं किया जा सकता.
  • Management API के काम न करने की अवधि: एलडीएपी को वापस लाने के दौरान, मैनेजमेंट एपीआई उपलब्ध नहीं होंगे. इससे एडमिन के कामों पर असर पड़ सकता है. एलडीएपी रोलबैक की प्रोसेस शुरू करने से पहले, कृपया सभी एज-मैनेजमेंट-सर्वर और एज-यूआई बंद कर दें.
  • डेटा खोने का जोखिम: मान्य और काम करने वाले बैकअप के बिना आगे बढ़ने पर, डेटा हमेशा के लिए खो सकता है.
  • मान्य बैकअप: अपग्रेड से पहले, LDAP का मान्य बैकअप लेना ज़रूरी है.

रोलबैक करने की प्रोसेस

  1. एलडीएपी अपग्रेड करने से पहले, कृपया सभी एज-मैनेजमेंट-सर्वर और एज-यूआई बंद कर दें. 
    apigee-service edge-management-server stop
apigee-service edge-ui stop
  2. LDAP बंद करने से पहले, मौजूदा LDAP डेटा का बैक अप लेना

    सभी LDAP सर्वर से, रेफ़रंस के लिए कुल रिकॉर्ड की संख्या पाएं. (रिकॉर्ड की संख्या, सभी LDAP सर्वर में एक जैसी होनी चाहिए)

          # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password. 
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \ -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
  3. LDAP 2.6 को बंद करना और अनइंस्टॉल करना

    apigee-openldap सेवा बंद करें और इसके कॉन्फ़िगरेशन और डेटा डायरेक्ट्री मिटाएं. यह कार्रवाई सभी LDAP सर्वर पर की जानी चाहिए. क्लस्टर में एक बार में एक नोड पर कार्रवाई की जानी चाहिए, ताकि यह पक्का किया जा सके कि सभी नोड एक जैसे हैं.

    apigee-service apigee-openldap stop
apigee-service apigee-openldap uninstall
rm -rf /opt/apigee/data/apigee-openldap/*
  4. LDAP 2.4 का पुराना वर्शन इंस्टॉल करें
    • एलडीएपी का पुराना वर्शन इंस्टॉल करना: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f /opt/silent.conf
    • एलडीएपी वर्शन की पुष्टि करें: 
      source ~/.bash_profile
ldapsearch -VV

#Expected output:
ldapsearch: @(#) $OpenLDAP: ldapsearch 2.4.46
    • ऊपर दिए गए चरणों को हर एलडीएपी नोड पर एक-एक करके दोहराएं
  5. बचा हुआ डेटा मिटाना

    सभी LDAP सर्वर पर, एक-एक करके, नई इंस्टॉल की गई सेवा को बंद करें. साथ ही, बैकअप से डेटा वापस लाने की तैयारी करने के लिए, उसके डेटा डायरेक्ट्री को मिटाएं.

    apigee-service apigee-openldap stop
rm -rf /opt/apigee/data/apigee-openldap/*
  6. LDAP डेटा वापस पाना

    सिंगल-सर्वर सेटअप के लिए, सीधे चरण 5b पर जाएं. एक से ज़्यादा सर्वर सेट अप करने के लिए, पांचवें चरण पर जाएं.

    1. चालू LDAP सर्वर की पहचान करना

      एलडीएपी डेटा वापस लाने से पहले, इस कमांड को चलाकर चालू सर्वर (प्रोवाइडर) की पहचान करें.

      grep -i '^olcSyncrepl:' /opt/apigee/data/apigee-openldap/slapd.d/cn=config/olcDatabase*\ldif

* **Note**:
* If this command returns output, the server is a passive server. 
* If it returns no output, the server is the active server.
    2. एलडीएपी डेटा वापस लाएं. (डेटा वापस लाने से पहले, पक्का करें कि सभी सर्वर पर चौथा चरण पूरा हो गया हो.)
      • एकल और चालू एलडीएपी सर्वर (पांचवें चरण में तय किया गया) पर, बैकअप को वापस लाएं. 
        cd /opt/apigee/backup/openldap

# To restore a specific backup, provide the timestamp as shown below:
apigee-service apigee-openldap restore 2025.07.28,13.59.00
# Note: If no timestamp is provided, the latest available backup will be restored by default.
apigee-service apigee-openldap restore

# It is recommended to specify the backup explicitly to avoid restoring an unintended version.
      • apigee-openldap सेवा शुरू करें. 
        apigee-service apigee-openldap start
  7. बाकी बचे LDAP सर्वर शुरू करना

    अगर आपने एक से ज़्यादा सर्वर सेट अप किए हैं, तो हर एलडीएपी सर्वर पर सेवा शुरू करें:

    apigee-service apigee-openldap start
  8. पुष्टि करना
    • आखिरी चरण में, यह पुष्टि की जाती है कि रोलबैक हो गया है और पूरे एलडीएपी क्लस्टर में डेटा एक जैसा है.
    • सभी LDAP सर्वर पर पुष्टि करने वाला कमांड चलाएं. सभी सर्वर पर रिकॉर्ड की संख्या एक जैसी होनी चाहिए. साथ ही, यह संख्या पहले चरण में कैप्चर की गई संख्या से मेल खानी चाहिए. 
      # Note: Replace 'YOUR_PASSWORD' with your current LDAP manager password.
ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" \ -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w 'YOUR_PASSWORD' | wc -l
    • डेटा सही और एक जैसा होने की पुष्टि करने के बाद, एलडीएपी रोलबैक की प्रोसेस पूरी हो जाती है. अब अपने संगठन की अपग्रेड करने की स्टैंडर्ड प्रोसेस के मुताबिक, edge-management-server, edge-ui, और अन्य ज़रूरी कॉम्पोनेंट शुरू करें.

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

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

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

    • 4.52.02 वर्शन पर वापस जाने के लिए, 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 और apigee-cassandra-client कॉम्पोनेंट ग्रुप को अनइंस्टॉल करें. इसका उदाहरण यहां दिया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
       
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra-client 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.01 वर्शन अनइंस्टॉल करें: 
    /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. 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