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 सर्वर नोड को एक-एक करके रोलबैक करना

रोलबैक करने की अनुमति किसे है

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

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

एक जैसे कोड वाले कॉम्पोनेंट

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

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

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

Cassandra का रोलबैक

Cassandra का रोलबैक

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

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

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

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

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

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

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

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

Cassandra कॉन्फ़िगरेशन सेट करना

  1. फ़ाइल /opt/apigee/customer/application/cassandra.properties बनाएं या उसमें बदलाव करें.
  2. फ़ाइल में यह कॉन्टेंट जोड़ें. ipOfNode उस नोड का आईपी पता है जिसका इस्तेमाल Cassandra, दूसरे Cassandra नोड के साथ कम्यूनिकेट करने के लिए करता है: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  3. पक्का करें कि फ़ाइल का मालिकाना हक apigee उपयोगकर्ता के पास हो और वह फ़ाइल को पढ़ सके: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  4. Cassandra इंस्टॉल और सेट अप करना:
    • Cassandra का 3.11.X वर्शन इंस्टॉल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
    • स्टैंडर्ड कॉन्फ़िगरेशन फ़ाइल पास करके, Cassandra सेट अप करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
    • पक्का करें कि Cassandra 3.11.X इंस्टॉल हो और सेवा चल रही हो: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  5. पुष्टि करें कि नोड शुरू हो गया है. इस नोड और क्लस्टर के अन्य नोड पर, नीचे दिया गया कमांड देखें. नोड को यह रिपोर्ट करनी चाहिए कि वह "UN" (चालू/सामान्य) स्थिति में है: 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  6. /opt/apigee/customer/application/cassandra.properties फ़ाइल से, पहले जोड़े गए अतिरिक्त कॉन्फ़िगरेशन हटाएं.
  7. डेटा सेंटर में मौजूद सभी Cassandra सीड नोड पर, तीसरे से छठे चरण को एक-एक करके दोहराएं.
  8. डेटा सेंटर में बचे सभी Cassandra नोड पर, तीसरे से छठे चरण को एक-एक करके दोहराएं.
  9. Cassandra के पुराने वर्शन पर चल रहे डेटा सेंटर से, डेटा सेंटर के सभी नोड फिर से बनाएं. इस चरण को एक बार में एक नोड के लिए पूरा करें: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>
    इस प्रोसेस में कुछ समय लग सकता है. ज़रूरत पड़ने पर, streamingthroughput में बदलाव किया जा सकता है. इसकी स्थिति देखने के लिए: 
    /opt/apigee/apigee-cassandra/bin/nodetool netstats
  10. डेटा सेंटर में मौजूद सभी 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
  11. इस डेटा सेंटर की पुष्टि करें और ट्रैफ़िक को वापस इस पर भेजें. इस डेटा सेंटर में, रनटाइम ट्रैफ़िक और मैनेजमेंट एपीआई के लिए कुछ पुष्टि करें. साथ ही, प्रॉक्सी और मैनेजमेंट एपीआई ट्रैफ़िक को वापस उस पर भेजना शुरू करें.
  12. आपको जिस डेटा सेंटर को रोल बैक करना है उसके लिए ऊपर दिया गया तरीका दोहराएं.

बैकअप का इस्तेमाल करके 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. नोड पर मौजूद किसी दूसरे कॉम्पोनेंट को रोल बैक करने के लिए, सिर्फ़ उस कॉम्पोनेंट को अनइंस्टॉल करें, जैसा कि यहां दिए गए उदाहरण में दिखाया गया है: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

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

    3. Edge Router को रोल बैक करने के लिए, आपको edge-gateway कॉम्पोनेंट ग्रुप को अनइंस्टॉल करने के साथ-साथ, /opt/nginx/conf.d फ़ाइल का कॉन्टेंट भी मिटाना होगा: 
      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. यह तरीका हर उस नोड के लिए दोहराएं जो उस कॉम्पोनेंट को होस्ट करता है जिसे आपको रोल बैक करना है.

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