Apigee Edge 4.17.0x को 4.18.01 पर अपडेट करें

Edge for Private Cloud v4.18.01

Edge के किन वर्शन को 4.18.01 पर अपडेट किया जा सकता है

इस तरीके का इस्तेमाल करके, Apigee Edge के वर्शन 4.17.0x को अपडेट किया जा सकता है.

अगर आपके पास Edge का 4.16.01 से पहले का वर्शन है, तो आपको पहले 4.16.01.x वर्शन पर माइग्रेट करना होगा. इसके बाद, 4.18.01 वर्शन पर अपडेट करना होगा.

अपडेट कौन कर सकता है

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

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

आपको कौनसे कॉम्पोनेंट अपडेट करने होंगे

आपको Edge के सभी कॉम्पोनेंट अपडेट करने होंगे. Edge, ऐसे सेटअप के साथ काम नहीं करता जिसमें कई वर्शन के कॉम्पोनेंट शामिल हों.

साथ काम करने की क्षमता बनाए रखना

Apigee Edge for Private Cloud को 4.18.01 पर अपग्रेड करते समय, आपको यह पक्का करना होगा कि लागू किए गए नए वर्शन की कॉन्फ़िगरेशन फ़ाइलों में, सिर्फ़ काम करने वाली प्रॉपर्टी का रेफ़रंस दिया गया हो.

प्रॉपर्टी जगह ब्यौरा
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties इस प्रॉपर्टी को अपनी router.properties फ़ाइल से हटाएं. 4.18.01 में फिर से कोशिश करने के विकल्प सेट करने के लिए, वर्चुअल होस्ट कॉन्फ़िगरेशन प्रॉपर्टी का इस्तेमाल करें.

प्रॉपर्टी की सेटिंग अपने-आप लागू होने की सुविधा

अगर आपने /opt/apigee/customer/application में .properties फ़ाइलों में बदलाव करके कोई प्रॉपर्टी सेट की है, तो अपडेट करने पर ये वैल्यू सेव रहती हैं.

SMTPMAILFROM कॉन्फ़िगरेशन पैरामीटर जोड़ना ज़रूरी है

Edge 4.17.05 ने कॉन्फ़िगरेशन फ़ाइल में एक नया ज़रूरी पैरामीटर जोड़ा है. इसका इस्तेमाल, एसएमटीपी सर्वर को चालू करने के लिए किया जाता है. अगर 4.17.01 से अपडेट किया जा रहा है, तो एसएमटीपी सर्वर चालू करते समय, कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करना ज़रूरी है.

एपीआई BaaS के वर्शन 4.17.09 में, SMTPMAILFROM प्रॉपर्टी के लिए भी सहायता जोड़ी गई है. एपीआई BaaS को 4.17.01 या 4.17.05 से अपडेट करते समय, आपको कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करना होगा.

इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:

SMTPMAILFROM="My Company <myco@company.com>"

Postgres 9.6 पर अपग्रेड करना ज़रूरी है

Edge की इस रिलीज़ में, Postgres 9.6 का अपग्रेड शामिल है. इस अपग्रेड के तहत, Postgres के सभी डेटा को Postgres 9.6 पर माइग्रेट कर दिया गया है.

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

Postgres को अपडेट करने का तरीका इस बात पर निर्भर करता है कि आपने Postgres नोड के लिए डेटा स्टोरेज को कैसे कॉन्फ़िगर किया है:

  • अगर Postgres नोड के लिए स्थानीय डेटा स्टोरेज का इस्तेमाल किया जाता है, तो आपको अपग्रेड के दौरान एक नया Postgres स्टैंडबाय नोड इंस्टॉल करना होगा. अपग्रेड पूरा होने के बाद, नए Postgres स्टैंडबाय नोड को बंद किया जा सकता है.

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

    Edge के 1-नोड और 2-नोड इंस्टॉलेशन में, प्रोटोटाइप और टेस्टिंग के लिए इस्तेमाल की जाने वाली टोपोलॉजी में, आपके पास सिर्फ़ एक Postgres नोड होता है. इन Postgres नोड को सीधे अपडेट किया जा सकता है. इसके लिए, आपको नया Postgres नोड बनाने की ज़रूरत नहीं है.
  • अगर Postgres नोड के लिए नेटवर्क स्टोरेज का इस्तेमाल किया जाता है, तो आपको नया Postgres नोड इंस्टॉल करने की ज़रूरत नहीं है. Apigee भी यही सुझाव देता है. नीचे दी गई प्रोसेस में, उन चरणों को छोड़ा जा सकता है जिनमें नए Postgres स्टैंडबाय नोड को इंस्टॉल करने और बाद में उसे बंद करने के बारे में बताया गया है.

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

नया Postgres स्टैंडबाय नोड इंस्टॉल करना

इस प्रोसेस से, नए नोड पर Postgres स्टैंडबाय सर्वर बनता है. पक्का करें कि आपने Edge (4.17.0x) के मौजूदा वर्शन के लिए, नया Postgres स्टैंडबाय सर्वर इंस्टॉल किया हो, न कि 4.18.01 वर्शन के लिए.

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

नया Postgres स्टैंडबाय नोड बनाने के लिए:

  1. मौजूदा Postgres मास्टर पर, /opt/apigee/customer/application/postgresql.properties फ़ाइल में बदलाव करके यह टोकन सेट करें: 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
trust\ \nhost replication apigee new_slave_ip/32 trust

    जहां existing_slave_ip, मौजूदा Postgres स्टैंडबाय सर्वर का आईपी पता है और new_slave_ip, नए स्टैंडबाय नोड का आईपी पता है.

    अगर postgresql.properties फ़ाइल मौजूद नहीं है, तो उसे बनाएं और chown का इस्तेमाल करके, apigee उपयोगकर्ता को उसका ऐक्सेस दें. इसके लिए, यहां दिया गया उदाहरण देखें:

    chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  2. Postgres मास्टर पर apigee-postgresql को रीस्टार्ट करें: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. पुष्टि करें कि नया स्टैंडबाय नोड जोड़ा गया है. इसके लिए, मास्टर पर /opt/apigee/apigee-postgresql/conf/pg_hba.conf फ़ाइल देखें. आपको उस फ़ाइल में ये लाइनें दिखेंगी: 
    host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
  4. नया Postgres स्टैंडबाय सर्वर इंस्टॉल करें:
    1. Edge के मौजूदा वर्शन को इंस्टॉल करने के लिए इस्तेमाल की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करें, ताकि इनके बारे में बताया जा सके: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. Edge apigee-setup यूटिलिटी इंस्टॉल करें में बताए गए तरीके से, SELinux को बंद करें.
    3. Edge बूटस्ट्रैप_4.17.0x.sh फ़ाइल (जहां 4.17.0x, 4.17.01, 4.17.05, या 4.17.09 है) को /tmp/bootstrap_4.17.0x.sh में डाउनलोड करें: 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें: 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
  apigeepassword=pWord
    5. apigee-setup यूटिलिटी इंस्टॉल करने के लिए, apigee-service का इस्तेमाल करें: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Postgres इंस्टॉल करना: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. नए स्टैंडबाय सर्वर पर, यह कमांड चलाएं: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

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

Postgres नोड को बंद करना

अपडेट पूरा होने के बाद, नए स्टैंडबाय नोड को बंद करें:

  1. पक्का करें कि Postgres चल रहा हो:
    > /opt/apigee/apigee-service/bin/apigee-all status

    अगर Postgres नहीं चल रहा है, तो इसे चालू करें:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. नए स्टैंडबाय नोड पर यह cURL कमांड चलाकर, नए स्टैंडबाय नोड का यूयूआईडी पाएं:
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    आपको आउटपुट के आखिर में, नोड का यूयूआईडी इस फ़ॉर्मैट में दिखेगा:
    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. नए स्टैंडबाय नोड पर यह कमांड चलाकर, नए स्टैंडबाय नोड को बंद करें:
    > /opt/apigee/apigee-service/bin/apigee-all stop
  4. Postgres मास्टर नोड पर, /opt/apigee/customer/application/postgresql.properties में बदलाव करें, ताकि नए स्टैंडबाय नोड को conf_pg_hba_replication.connection से हटाया जा सके:
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
  5. Postgres मास्टर पर apigee-postgresql को रीस्टार्ट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. मास्टर पर /opt/apigee/apigee-postgresql/conf/pg_hba.conf फ़ाइल देखकर पुष्टि करें कि नया स्टैंडबाय नोड हटा दिया गया है. आपको उस फ़ाइल में सिर्फ़ यह लाइन दिखनी चाहिए:
    host replication apigee existing_slave_ip/32 trust
  7. मैनेजमेंट सर्वर नोड पर, Edge मैनेजमेंट एपीआई को कॉल करके, ZooKeeper से स्टैंडबाय नोड का यूयूआईडी मिटाएं:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

ज़रूरी शर्तें अपडेट करना

Apigee Edge को अपग्रेड करने से पहले, इन ज़रूरी शर्तों को पूरा करें:

  • सभी नोड का बैकअप लें
    हमारा सुझाव है कि अपडेट करने से पहले, सुरक्षा के लिहाज़ से सभी नोड का पूरा बैकअप ले लें. बैकअप लेने के लिए, Edge के मौजूदा वर्शन के लिए बताई गई प्रोसेस का इस्तेमाल करें.

    इससे आपको बैकअप प्लान बनाने में मदद मिलती है. ऐसा तब होता है, जब नए वर्शन पर अपडेट करने के बाद, ऐप्लिकेशन ठीक से काम न करे. बैकअप के बारे में ज़्यादा जानने के लिए, बैकअप और रीस्टोर देखें.
  • पक्का करें कि Edge चल रहा हो
    इस कमांड का इस्तेमाल करके पक्का करें कि अपडेट की प्रोसेस के दौरान, Edge चालू हो और काम कर रहा हो:

    > /opt/apigee/apigee-service/bin/apigee-all status

अपडेट न हो पाने की समस्या को ठीक करना

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

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

अपडेट की जानकारी लॉग करना

डिफ़ॉल्ट रूप से, update.sh यूटिलिटी, लॉग की जानकारी को यहां सेव करती है:

/opt/apigee/var/log/apigee-setup/update.log

अगर update.sh यूटिलिटी को चलाने वाले उपयोगकर्ता के पास उस डायरेक्ट्री का ऐक्सेस नहीं है, तो यह लॉग को /tmp डायरेक्ट्री में update_username.log नाम की फ़ाइल के तौर पर सेव करता है.

अगर उपयोगकर्ता के पास /tmp का ऐक्सेस नहीं है, तो update.sh यूटिलिटी काम नहीं करती.

बिना किसी रुकावट के अपडेट करने की सुविधा

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

ज़ीरो-डाउनटाइम अपडेट सिर्फ़ पांच या उससे ज़्यादा नोड वाले कॉन्फ़िगरेशन के साथ ही किया जा सकता है.

बिना किसी डाउनटाइम के अपग्रेड करने के लिए, लोड बैलेंसर से हर राऊटर को एक-एक करके हटाएं. इसके बाद, राऊटर और उसी मशीन पर मौजूद अन्य कॉम्पोनेंट को अपडेट करें. इसके बाद, राऊटर को लोड बैलेंसर में वापस जोड़ें.

  1. इंस्टॉलेशन के लिए, मशीनों को सही क्रम में अपडेट करें. इसके बारे में यहां "मशीन अपडेट करने का क्रम" में बताया गया है.
  2. जब राऊटर अपडेट करने का समय हो, तो किसी एक राऊटर को चुनें और उसे ऐक्सेस न किया जा सकने वाला बनाएं. इसके बारे में सर्वर (मैसेज प्रोसेसर/राऊटर) को ऐक्सेस करने की सुविधा चालू/बंद करना में बताया गया है.
  3. चुने गए राऊटर और उसी मशीन पर मौजूद Edge के अन्य सभी कॉम्पोनेंट को अपडेट करें. सभी Edge कॉन्फ़िगरेशन, एक ही नोड पर राऊटर और मैसेज प्रोसेसर दिखाते हैं.
  4. राऊटर को फिर से कनेक्ट करें.
  5. बाकी बचे राउटर के लिए, दूसरे से चौथे चरण तक की प्रक्रिया दोहराएं.
  6. इंस्टॉलेशन में बची हुई मशीनों के लिए अपडेट जारी रखें.

अपडेट करने से पहले/बाद में इन बातों का ध्यान रखें:

  • राऊटर और मैसेज प्रोसेसर के कंबाइंड नोड पर:
    • अपडेट करने से पहले – ये काम करें:
      1. राऊटर को ऐसी जगह पर रखें जहां से वह कनेक्ट न हो पाए.
      2. मैसेज प्रोसेसर को अनरीचेबल बनाएं.
    • अपडेट करने के बाद, ये काम करें:
      1. मैसेज प्रोसेसर को ऐक्सेस करने लायक बनाएं.
      2. राऊटर को ऐसी जगह पर रखें जहां से वह आसानी से कनेक्ट हो सके.
  • एक राऊटर नोड पर:
    • अपडेट करने से पहले, राऊटर को अनरीचेबल बनाएं.
    • अपडेट करने के बाद, पक्का करें कि राऊटर से कनेक्ट किया जा सके.
  • एक मैसेज प्रोसेसर नोड पर:
    • अपडेट करने से पहले, मैसेज प्रोसेसर को ऐक्सेस न किया जा सके.
    • अपडेट करने के बाद, मैसेज प्रोसेसर को ऐक्सेस करने लायक बनाएं.

साइलेंट कॉन्फ़िगरेशन फ़ाइल का इस्तेमाल करना

आपको अपडेट कमांड के लिए, साइलेंट कॉन्फ़िगरेशन फ़ाइल पास करनी होगी. साइलेंट कॉन्फ़िगरेशन फ़ाइल वही होनी चाहिए जिसका इस्तेमाल आपने Edge 4.17.0x को इंस्टॉल करने के लिए किया था.

बाहरी इंटरनेट कनेक्शन वाले नोड पर, 4.18.01 पर अपडेट करने की प्रोसेस

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

  1. अगर फ़िलहाल लोकल स्टोरेज के साथ Postgres मास्टर-स्टैंडबाय रेप्लिकेशन का इस्तेमाल किया जा रहा है, तो ऊपर बताए गए तरीके से नया Postgres स्टैंडबाय नोड इंस्टॉल करें. इसके लिए, नया Postgres स्टैंडबाय नोड इंस्टॉल करना लेख पढ़ें.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. इसके बजाय, Postgres के इस्तेमाल किए गए डेटा स्टोर का नेटवर्क स्नैपशॉट लें. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.
  2. अगर Cassandra पर रिपेयर ऑपरेशन करने के लिए कोई CRON जॉब कॉन्फ़िगर किया गया है, तो अपडेट पूरा होने तक उसे बंद कर दें.
  3. Edge RPM इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
    ध्यान दें: आरपीएम इंस्टॉल करने के लिए रूट ऐक्सेस की ज़रूरत होती है. हालांकि, रूट ऐक्सेस के बिना भी Edge को कॉन्फ़िगर किया जा सकता है.
  4. yum-utils और yum-plugin-priorities इंस्टॉल करें:
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. Edge apigee-setup यूटिलिटी इंस्टॉल करना लेख में बताए गए तरीके से, SELinux को बंद करें.
  6. अगर Oracle 7.x पर इंस्टॉल किया जा रहा है, तो यह कमांड चलाएं:
    > sudo yum-config-manager --enable ol7_optional_latest
  7. अगर AWS पर इंस्टॉल किया जा रहा है, तो ये yum-configure-manager कमांड चलाएं:
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. Edge 4.18.01 bootstrap_4.18.01.sh फ़ाइल को /tmp/bootstrap_4.18.01.sh में डाउनलोड करें:
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  9. Edge 4.18.01 apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
    > sudo bash /tmp/bootstrap_4.18.01.sh apigeeuser=uName apigeepassword=pWord

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

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

    I = OpenJDK 1.8 इंस्टॉल करें (डिफ़ॉल्ट)
    C = Java इंस्टॉल किए बिना जारी रखें
    Q = बंद करें. इस विकल्प के लिए, आपको Java खुद इंस्टॉल करना होगा.
  10. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. apigee-provision यूटिलिटी को अपडेट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. नीचे दिए गए "मशीन अपडेट करने का क्रम" में बताए गए क्रम में, अपने नोड पर अपडेट यूटिलिटी चलाएं:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    कॉन्फ़िगरेशन फ़ाइल के लिए सिर्फ़ यह ज़रूरी है कि "apigee" उपयोगकर्ता, कॉन्फ़िगरेशन फ़ाइल को ऐक्सेस या पढ़ सके.

    जिस कॉम्पोनेंट को अपडेट करना है उसे बताने के लिए, “-c” विकल्प का इस्तेमाल करें. संभावित कॉम्पोनेंट की सूची में ये शामिल हैं:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, QPID सर्वर, Postgres सर्वर
    ui = Edge यूज़र इंटरफ़ेस (यूआई)
    all = मशीन पर मौजूद सभी कॉम्पोनेंट अपडेट करें (सिर्फ़ Edge aio इंस्टॉलेशन प्रोफ़ाइल या API BaaS asa इंस्टॉलेशन प्रोफ़ाइल के लिए इस्तेमाल करें)
    e = ElasticSearch
    b = API BaaS स्टैक
    p = API BaaS पोर्टल
    ebp = एक ही नोड पर ElasticSearch, API BaaS स्टैक, और API BaaS पोर्टल
  14. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर, अपडेट की जांच करें. इसके बारे में इंस्टॉल की जांच करें में बताया गया है.
  15. अगर आपने नया Postgres स्टैंडबाय नोड इंस्टॉल किया है, तो Postgres नोड को बंद करना में बताए गए तरीके से नोड को बंद करें.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.

अपडेट को बाद में रोलबैक करने के लिए, 4.18.01 रोलबैक प्रोसेस में बताई गई प्रोसेस का इस्तेमाल करें.

लोकल रिपॉज़िटरी से 4.18.01 पर अपडेट करने की प्रोसेस

अगर आपके Edge नोड फ़ायरवॉल के पीछे हैं या किसी अन्य तरीके से इंटरनेट पर Apigee रिपॉज़िटरी को ऐक्सेस करने पर पाबंदी है, तो Apigee रिपॉज़िटरी के लोकल रिपॉज़िटरी या मिरर से अपडेट किया जा सकता है.

लोकल Edge रिपॉज़िटरी बनाने के बाद, आपके पास लोकल रिपॉज़िटरी से Edge को अपडेट करने के दो विकल्प होते हैं:

  • रेपो की .tar फ़ाइल बनाएं, .tar फ़ाइल को किसी नोड में कॉपी करें, और फिर .tar फ़ाइल से Edge को अपडेट करें.
  • लोकल रिपॉज़िटरी वाले नोड पर वेबसर्वर इंस्टॉल करें, ताकि अन्य नोड उसे ऐक्सेस कर सकें. Apigee, आपको इस्तेमाल करने के लिए Nginx वेबसर्वर उपलब्ध कराता है. इसके अलावा, आपके पास अपने वेबसर्वर का इस्तेमाल करने का विकल्प भी होता है.

लोकल 4.18.01 रिपॉज़िटरी से अपडेट करने के लिए:

  1. अगर फ़िलहाल Postgres मास्टर-स्टैंडबाय रेप्लिकेशन का इस्तेमाल किया जा रहा है, तो ऊपर बताए गए तरीके से नया Postgres स्टैंडबाय नोड इंस्टॉल करें. इसके लिए, नया Postgres स्टैंडबाय नोड इंस्टॉल करना लेख पढ़ें.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. इसके बजाय, Postgres के इस्तेमाल किए गए डेटा स्टोर का नेटवर्क स्नैपशॉट लें. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.
  2. Edge apigee-setup सुविधा इंस्टॉल करें में जाकर, "लोकल Apigee रिपॉज़िटरी बनाएं" में बताए गए तरीके से लोकल 4.18.01 रिपॉज़िटरी बनाएं.
    ध्यान दें: अगर आपके पास पहले से 4.17.0x रिपॉज़िटरी है, तो उसमें 4.18.01 रिपॉज़िटरी को जोड़ा जा सकता है. इसके लिए, Edge apigee-setup सुविधा इंस्टॉल करें में जाकर, "लोकल Apigee रिपॉज़िटरी अपडेट करें" में बताया गया तरीका अपनाएं.
  3. .tar फ़ाइल से apigee-service इंस्टॉल करने के लिए:
    1. लोकल रेपो वाले नोड पर, लोकल रेपो को /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz नाम की एक.tar फ़ाइल में पैकेज करने के लिए, इस निर्देश का इस्तेमाल करें:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. .tar फ़ाइल को उस नोड पर कॉपी करें जहां आपको Edge को अपडेट करना है. उदाहरण के लिए, इसे नए नोड पर /tmp डायरेक्ट्री में कॉपी करें.
    3. नए नोड पर, फ़ाइल को /tmp डायरेक्ट्री में अनटार करें:
      > tar -xzf apigee-4.18.01.tar.gz

      यह निर्देश, .tar फ़ाइल वाली डायरेक्ट्री में repos नाम की एक नई डायरेक्ट्री बनाता है. उदाहरण के लिए, /tmp/repos.
    4. /tmp/repos से Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
      > sudo bash /tmp/repos/bootstrap_4.18.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      ध्यान दें कि इस निर्देश में, आपने repos डायरेक्ट्री का पाथ शामिल किया है.
  4. Nginx वेबसर्वर का इस्तेमाल करके apigee-service इंस्टॉल करने के लिए:
    1. Nginx वेब सर्वर को कॉन्फ़िगर करें. इसके लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करें में जाकर, "Nginx वेब सर्वर का इस्तेमाल करके, रिपॉज़िटरी से इंस्टॉल करें" में बताया गया तरीका अपनाएं.
    2. रिमोट नोड पर, Edge bootstrap_4.18.01.sh फ़ाइल को /tmp/bootstrap_4.18.01.sh में डाउनलोड करें:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

      जहां uName:pWord, वह उपयोगकर्ता नाम और पासवर्ड है जिसे आपने डेटाबेस के लिए ऊपर सेट किया है. साथ ही, remoteRepo, डेटाबेस नोड का आईपी पता या डीएनएस नाम है.
    3. रिमोट नोड पर, Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
      > sudo bash /tmp/bootstrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      जहां uName:pWord, रेपो का उपयोगकर्ता नाम और पासवर्ड है.
  5. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. apigee-provision यूटिलिटी को अपडेट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. अपने नोड पर अपडेट यूटिलिटी को नीचे दिए गए "मशीन अपडेट का क्रम" में बताए गए क्रम में चलाएं:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    कॉन्फ़िगरेशन फ़ाइल के लिए सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.

    जिस कॉम्पोनेंट को अपडेट करना है उसे बताने के लिए, “-c” विकल्प का इस्तेमाल करें. संभावित कॉम्पोनेंट की सूची में ये शामिल हैं:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Edge यूज़र इंटरफ़ेस (यूआई) को छोड़कर, Edge के सभी कॉम्पोनेंट: मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, QPID सर्वर, Postgres सर्वर
    ui = Edge यूज़र इंटरफ़ेस (यूआई)
    all = मशीन पर मौजूद सभी कॉम्पोनेंट अपडेट करें (सिर्फ़ Edge aio इंस्टॉलेशन प्रोफ़ाइल या API BaaS asa इंस्टॉलेशन प्रोफ़ाइल के लिए इस्तेमाल करें)
    e = ElasticSearch
    b = API BaaS स्टैक
    p = API BaaS पोर्टल
    ebp = एक ही नोड पर ElasticSearch, API BaaS स्टैक, और API BaaS पोर्टल
  9. अपडेट की जांच करने के लिए, मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाएं. इसके बारे में इंस्टॉल की जांच करें में बताया गया है.
  10. अगर आपने नया Postgres स्टैंडबाय नोड इंस्टॉल किया है, तो उसे बंद कर दें. इसके लिए, Postgres नोड को बंद करना सेक्शन में बताया गया तरीका अपनाएं.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.

अपडेट को बाद में रोलबैक करने के लिए, 4.18.01 रोलबैक प्रोसेस में बताई गई प्रोसेस का इस्तेमाल करें.

मशीन अपडेट का क्रम

Edge इंस्टॉलेशन में मशीनों को अपडेट करने का क्रम अहम होता है. अपडेट करते समय, इन बातों का ध्यान रखना सबसे ज़रूरी है:

  • किसी भी अन्य नोड को अपडेट करने से पहले, आपको Cassandra और ZooKeeper के सभी नोड अपडेट करने होंगे.
  • अगर किसी मशीन में Edge के कई कॉम्पोनेंट (मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, QPID सर्वर, लेकिन Postgres सर्वर नहीं) हैं, तो उन सभी को एक साथ अपडेट करने के लिए, "-c edge" विकल्प का इस्तेमाल करें.
  • अगर किसी चरण में यह बताया गया है कि उसे कई मशीनों पर पूरा किया जाना चाहिए, तो उसे बताई गई मशीनों के क्रम में पूरा करें.
  • कमाई करने की सुविधा को अपडेट करने के लिए, कोई अलग चरण नहीं है. "-c edge" विकल्प चुनने पर, यह अपडेट हो जाता है.

एक होस्ट वाले स्टैंडअलोन इंस्टॉलेशन के लिए

  1. अगर 4.17.01 से अपडेट किया जा रहा है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. ऐसा तब करें, जब आपने Edge पर एसएमटीपी चालू किया हो. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. Qpid को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Postgres सर्वर, Qpid सर्वर, और PostgreSQL को बंद करें:
    > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  6. postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Postgres डेटाबेस को अपडेट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. Edge के बाकी कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Edge यूज़र इंटरफ़ेस (यूआई) को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

दो होस्ट वाले स्टैंडअलोन इंस्टॉलेशन के लिए

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. अगर 4.17.01 से अपडेट किया जा रहा है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. ऐसा तब करें, जब आपने Edge पर एसएमटीपी चालू किया हो. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. मशीन 1 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 2 पर Qpid को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. मशीन 1 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. मशीन 2 पर postgresql को अपडेट करें:
    1. Postgres सर्वर, Qpid सर्वर, और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    2. postgresql को अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Postgres डेटाबेस को अपडेट करें:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. मशीन 2 पर Edge कॉम्पोनेंट अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

पांच होस्ट वाले क्लस्टर इंस्टॉलेशन के लिए

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. अगर 4.17.01 से अपडेट किया जा रहा है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. ऐसा तब करें, जब आपने Edge पर एसएमटीपी चालू किया हो. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. पक्का करें कि आपने ऊपर बताए गए तरीके से, नया Postgres स्टैंडबाय नोड इंस्टॉल किया हो. इसके बारे में, नया Postgres स्टैंडबाय नोड इंस्टॉल करना में बताया गया है.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. इसके बजाय, Postgres के इस्तेमाल किए गए डेटा स्टोर का नेटवर्क स्नैपशॉट लें. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.
  3. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. मशीन 4 और 5 पर Qpid को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. मशीन 1, 2, 3 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ??मशीन 4 और 5 को अपडेट करें:
    1. मशीन 4 पर Postgres सर्वर और Qpid सर्वर को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. मशीन 5 पर Postgres सर्वर, Qpid सर्वर, और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. अगर इंस्टॉल किया गया है, तो रोलबैक के लिए जोड़े गए नए स्टैंडबाय नोड पर Postgres सर्वर और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. मशीन 4 पर postgresql को अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. मशीन 4 (सिर्फ़ Postgres मास्टर) पर Postgres डेटाबेस को अपडेट करें:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. मशीन 5 पर postgresql को अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. मशीन 4 और 5 पर Postgres सर्वर और Qpid सर्वर चालू करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. मशीन 5 पर नीचे दिए गए कमांड चलाकर, Postgres को स्टैंडबाय नोड के तौर पर कॉन्फ़िगर करें:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    9. दोनों सर्वर पर ये स्क्रिप्ट चलाकर, रेप्लिकेशन की स्थिति की पुष्टि करें. सफल रेप्लिकेशन के लिए, सिस्टम को दोनों सर्वर पर एक जैसे नतीजे दिखाने चाहिए:

      मास्टर नोड वाली मशीन 4 पर, यह कमांड चलाएं:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      मशीन 5 पर, स्टैंडबाय नोड:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      पुष्टि करें कि यह स्टैंडबाय है.
  9. मशीन 4, 5 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. पक्का करें कि आपने Postgres नोड को बंद करना में ऊपर बताई गई प्रोसेस का इस्तेमाल करके, नए स्टैंडबाय नोड को बंद कर दिया हो.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.

नौ होस्ट वाले क्लस्टर किए गए इंस्टॉलेशन के लिए

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. अगर 4.17.01 से अपडेट किया जा रहा है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. ऐसा तब करें, जब आपने Edge पर एसएमटीपी चालू किया हो. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. पक्का करें कि आपने ऊपर बताए गए तरीके से, नया Postgres स्टैंडबाय नोड इंस्टॉल किया हो. इसके बारे में, नया Postgres स्टैंडबाय नोड इंस्टॉल करना में बताया गया है.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. इसके बजाय, Postgres के इस्तेमाल किए गए डेटा स्टोर का नेटवर्क स्नैपशॉट लें. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.
  3. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. मशीन 6 और 7 पर Qpid को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. मशीन 6, 7, 1, 4, और 5 पर Edge के कॉम्पोनेंट को इस क्रम में अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
  8. मशीन 8 और 9 को अपडेट करें:
    1. मशीन 8 पर Postgres सर्वर को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. मशीन 9 पर Postgres सर्वर और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. मशीन 6 और 7 पर Qpid सर्वर को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. अगर इंस्टॉल किया गया है, तो रोलबैक के लिए जोड़े गए नए स्टैंडबाय नोड पर Postgres सर्वर और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. मशीन 8 पर postgresql को अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. मशीन 8 पर Postgres डेटाबेस को अपडेट करें (सिर्फ़ Postgres मास्टर):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. मशीन 9 पर postgresql को अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. मशीन 8 और 9 पर Postgres सर्वर चालू करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. मशीन 6 और 7 पर Qpid सर्वर चालू करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. मशीन 9 पर नीचे दिए गए निर्देश चलाकर, Postgres को स्टैंडबाय नोड के तौर पर कॉन्फ़िगर करें:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    11. दोनों सर्वर पर ये स्क्रिप्ट चलाकर, रेप्लिकेशन की स्थिति की पुष्टि करें. सफल रेप्लिकेशन पक्का करने के लिए, सिस्टम को दोनों सर्वर पर एक जैसे नतीजे दिखाने चाहिए:
      मास्टर नोड वाली मशीन 8 पर, यह कमांड चलाएं:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      मशीन 9 पर, स्टैंडबाय नोड:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      पुष्टि करें कि यह स्टैंडबाय है.
  9. मशीन 8 और 9 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. पक्का करें कि आपने Postgres नोड को बंद करना में ऊपर बताई गई प्रोसेस का इस्तेमाल करके, नए स्टैंडबाय नोड को बंद कर दिया हो.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.

13 होस्ट वाले क्लस्टर किए गए इंस्टॉलेशन के लिए

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. अगर 4.17.01 से अपडेट किया जा रहा है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. ऐसा तब करें, जब आपने Edge पर एसएमटीपी चालू किया हो. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. पक्का करें कि आपने ऊपर बताए गए तरीके से, नया Postgres स्टैंडबाय नोड इंस्टॉल किया हो. इसके बारे में, नया Postgres स्टैंडबाय नोड इंस्टॉल करना में बताया गया है.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. इसके बजाय, Postgres के इस्तेमाल किए गए डेटा स्टोर का नेटवर्क स्नैपशॉट लें. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.
  3. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. मशीन 12 और 13 पर Qpid को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. मशीन 4 और 5 पर एलडीएपी अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. मशीन 12, 13, 6, 7, 10, और 11 पर Edge कॉम्पोनेंट को इस क्रम में अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. मशीन 6 और 7 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile??
  8. मशीन 8 और 9 को अपडेट करें:
    1. मशीन 8 पर Postgres सर्वर को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. मशीन 9 पर Postgres सर्वर और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. मशीन 12 और 13 पर Qpid सर्वर को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. अगर इंस्टॉल किया गया है, तो रोलबैक के लिए जोड़े गए नए स्टैंडबाय नोड पर Postgres सर्वर और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. मशीन 8 पर postgresql को अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. मशीन 8 पर Postgres डेटाबेस को अपडेट करें (सिर्फ़ Postgres मास्टर):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. मशीन 9 पर postgresql को अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. मशीन 8 और 9 पर Postgres सर्वर चालू करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. मशीन 12 और 13 पर Qpid सर्वर चालू करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. मशीन 9 पर नीचे दिए गए निर्देश चलाकर, Postgres को स्टैंडबाय नोड के तौर पर कॉन्फ़िगर करें:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    11. दोनों सर्वर पर ये स्क्रिप्ट चलाकर, रेप्लिकेशन की स्थिति की पुष्टि करें. सफल रेप्लिकेशन पक्का करने के लिए, सिस्टम को दोनों सर्वर पर एक जैसे नतीजे दिखाने चाहिए:
      मास्टर नोड वाली मशीन 8 पर, यह कमांड चलाएं:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      मशीन 9 पर, स्टैंडबाय नोड:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      पुष्टि करें कि यह स्टैंडबाय है.
  9. मशीन 8 और 9 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile??
  10. पक्का करें कि आपने Postgres नोड को बंद करना में ऊपर बताई गई प्रोसेस का इस्तेमाल करके, नए स्टैंडबाय नोड को बंद कर दिया हो.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.

12 होस्ट वाले क्लस्टर किए गए इंस्टॉलेशन के लिए

Edge टोपोलॉजी और नोड नंबर की सूची के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

  1. अगर 4.17.01 से अपडेट किया जा रहा है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. ऐसा तब करें, जब आपने Edge पर एसएमटीपी चालू किया हो. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. पक्का करें कि आपने ऊपर बताए गए तरीके से, नया Postgres स्टैंडबाय नोड इंस्टॉल किया हो. इसके बारे में, नया Postgres स्टैंडबाय नोड इंस्टॉल करना में बताया गया है.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. इसके बजाय, Postgres के इस्तेमाल किए गए डेटा स्टोर का नेटवर्क स्नैपशॉट लें. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.
  3. Cassandra और ZooKeeper को अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 1, 2, और 3 पर:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. डेटा सेंटर 2 में मशीन 7, 8, और 9 पर
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. qpidd अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 4 और 5
      1. मशीन 4 पर qpidd को अपडेट करें:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. पांचवीं मशीन पर पहला चरण दोहराएं.
    2. डेटा सेंटर 2 में मशीन 10, 11
      1. मशीन 10 पर qpidd को अपडेट करें:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. मशीन 11 पर पहला चरण दोहराएं.
  5. LDAP अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. डेटा सेंटर 2 में मशीन 7
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. Edge के कॉम्पोनेंट अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 4, 5, 1, 2, 3
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. डेटा सेंटर 2 में मशीन 10, 11, 7, 8, 9
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. यूज़र इंटरफ़ेस (यूआई) अपडेट करना:
    1. डेटा सेंटर 1 में मशीन 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. डेटा सेंटर 2 में मशीन 7:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ?डेटा सेंटर 1 में मशीन 6 और डेटा सेंटर 2 में मशीन 12 को अपडेट करें:
    1. मशीन 6 पर Postgres सर्वर को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. मशीन 12 पर Postgres सर्वर और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. मशीन 4, 5, 10, और 11 पर Qpid सर्वर को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. अगर इंस्टॉल किया गया है, तो रोलबैक के लिए जोड़े गए नए स्टैंडबाय नोड पर Postgres सर्वर और postgresql को बंद करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. मशीन 6 पर postgresql को अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. मशीन 6 पर Postgres डेटाबेस को अपडेट करें (सिर्फ़ Postgres मास्टर):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. मशीन 12 पर postgresql अपडेट करें:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. मशीन 6 और 12 पर Postgres सर्वर चालू करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. मशीन 4, 5, 10, और 11 पर Qpid सर्वर चालू करें:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. मशीन 12 पर ये कमांड चलाकर, Postgres को स्टैंडबाय नोड के तौर पर कॉन्फ़िगर करें:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f       configFile
    11. दोनों सर्वर पर ये स्क्रिप्ट चलाकर, रेप्लिकेशन की स्थिति की पुष्टि करें. सफल रेप्लिकेशन के लिए, सिस्टम को दोनों सर्वर पर एक जैसे नतीजे दिखाने चाहिए:
      मास्टर नोड वाली मशीन 6 पर, यह कमांड चलाएं:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

      मशीन 12 पर, स्टैंडबाय नोड:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      पुष्टि करें कि यह स्टैंडबाय है.
  9. मशीन 6 और 12 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. पक्का करें कि आपने Postgres नोड को बंद करना में ऊपर बताई गई प्रोसेस का इस्तेमाल करके, नए स्टैंडबाय नोड को बंद कर दिया हो.

    अगर नेटवर्क स्टोरेज का इस्तेमाल किया जा रहा है, तो आपको नया नोड इंस्टॉल करने की ज़रूरत नहीं है. ज़्यादा जानकारी के लिए, Postgres 9.6 पर अपग्रेड करना ज़रूरी है देखें.

सात होस्ट वाले एपीआई BaaS इंस्टॉलेशन के लिए

  1. अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. मशीन 5, 6, और 7 पर Cassandra को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  3. मशीन 1, 2, और 3 पर ElasticSearch और API BaaS स्टैक को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  4. मशीन 4 पर API BaaS पोर्टल को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

10-होस्ट वाले API BaaS इंस्टॉलेशन के लिए

  1. अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. मशीन 8, 9, और 10 पर Cassandra को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  3. मशीन 1, 2, और 3 पर ElasticSearch को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  4. मशीन 4, 5, और 6 पर एपीआई BaaS स्टैक को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  5. मशीन 7 पर API BaaS पोर्टल को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

दो डेटा सेंटर वाले API Baas इंस्टॉलेशन के लिए

इस प्रोसेस के लिए, आपको दोनों डेटा सेंटर में Cassandra नोड अपडेट करने होंगे. अगर Cassandra के उन नोड को Edge के साथ शेयर किया जा रहा है, तो आम तौर पर Edge को अपडेट करने के दौरान उन नोड को अपडेट किया जाता है.

  1. अपनी कॉन्फ़िगरेशन फ़ाइलों में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. दोनों डेटा सेंटर के लिए, Cassandra कीस्पेस को सही रेप्लिकेशन फ़ैक्टर के साथ अपडेट करें. आपको किसी भी डेटा सेंटर में मौजूद किसी भी Cassandra सर्वर पर, यह चरण सिर्फ़ एक बार चलाना होगा:

    ध्यान दें: नीचे दिए गए सभी निर्देश, रेप्लिकेशन फ़ैक्टर को "3" पर सेट करते हैं. इससे पता चलता है कि क्लस्टर में तीन Cassandra नोड हैं. इंस्टॉल करने के लिए, ज़रूरत के मुताबिक इस वैल्यू में बदलाव करें.
    1. Cassandra cqlsh यूटिलिटी शुरू करें:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Cassandra कीस्पेस के लिए रेप्लिकेशन लेवल सेट करने के लिए, "cqlsh>" प्रॉम्प्ट पर ये CQL कमांड चलाएं:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. कीस्पेस देखने के लिए, इस कमांड का इस्तेमाल करें:
        cqlsh> select * from system.schema_keyspaces;
      7. cqlsh से बाहर निकलें:
        cqlsh> exit
  3. (सिर्फ़ तब, जब आपने Edge को अपडेट करते समय Cassandra को अपडेट न किया हो) डेटा सेंटर 1 में Cassandra नोड को अपडेट करें. इसके लिए, एक बार में एक मशीन को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (सिर्फ़ तब, जब आपने Edge को अपडेट करते समय Cassandra को अपडेट न किया हो) डेटा सेंटर 2 में Cassandra नोड को अपडेट करें. इसके लिए, एक बार में एक मशीन को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. डेटा सेंटर 1 में मौजूद मशीनों पर, ElasticSearch को अपडेट करें. एक बार में एक ही मशीन पर अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. डेटा सेंटर 2 में मौजूद मशीनों पर, ElasticSearch को एक-एक करके अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. डेटा सेंटर 1 में मौजूद मशीनों पर, एपीआई BaaS स्टैक को एक-एक करके अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. डेटा सेंटर 2 में मौजूद मशीनों पर, एपीआई BaaS स्टैक को अपडेट करें. इसके लिए, एक बार में एक मशीन को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. डेटा सेंटर 1 में मौजूद मशीनों पर, एपीआई BaaS पोर्टल को एक-एक करके अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. डेटा सेंटर 2 में मौजूद मशीनों पर, एपीआई BaaS पोर्टल को एक-एक करके अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. BaaS कीस्पेस वैल्यू अपडेट करें. इन कीस्पेस को इंस्टॉल करते समय, रेप्लिकेशन के लिए सेट करना ज़रूरी है. हालांकि, रन टाइम के दौरान ऐसा करना ज़रूरी नहीं है. रेप्लिकेशन हटाने से, Cassandra की मेमोरी भी बचती है.

    आपको यह चरण, किसी भी डेटा सेंटर में मौजूद किसी भी Cassandra सर्वर पर सिर्फ़ एक बार चलाना होगा:
    1. Cassandra cqlsh यूटिलिटी शुरू करें:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. Cassandra कीस्पेस के लिए, रेप्लिकेशन लेवल सेट करने के लिए, ये CQL कमांड चलाएं:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. इस निर्देश का इस्तेमाल करके कीस्पेस देखें:
        cqlsh> select * from system.schema_keyspaces;
      4. cqlsh से बाहर निकलें:
        cqlsh> exit

नॉन-स्टैंडर्ड इंस्टॉलेशन के लिए

अगर आपने Edge को स्टैंडर्ड तरीके से इंस्टॉल नहीं किया है, तो Edge के कॉम्पोनेंट को इस क्रम में अपडेट करें:

  1. ZooKeeper
  2. Cassandra
  3. qpidd, ps
  4. LDAP
  5. Edge, जिसका मतलब है कि सभी नोड पर "-c edge" प्रोफ़ाइल को इस क्रम में अपडेट करें: Qpid सर्वर, Postgres सर्वर, मैनेजमेंट सर्वर, मैसेज प्रोसेसर, और राऊटर वाले नोड.
    ध्यान दें: अगर नोड में Qpid सर्वर और Postgres सर्वर, दोनों इंस्टॉल हैं, तो "-c edge" प्रोफ़ाइल वाला चरण चलाएं.
  6. Edge का यूज़र इंटरफ़ेस (यूआई)
Apigee Edge 4.17.01/4.17.05 को 4.17.09 पर अपडेट करना