Apigee Edge 4.16.01 को 4.16.05 पर अपडेट करें

Edge for Private Cloud v. 4.16.05

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

Apigee Edge के वर्शन 4.16.01.x को सिर्फ़ 4.16.05 में अपडेट किया जा सकता है.

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

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

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

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

Java JDK वर्शन 8 पर अपग्रेड करना ज़रूरी है

Edge के इस वर्शन के लिए, आपको Edge के सभी प्रोसेसिंग नोड पर Java JDK वर्शन 8 इंस्टॉल करना होगा. Oracle JDK 8 या OpenJDK 8 को इंस्टॉल किया जा सकता है. अगर Java JDK 8 पहले से इंस्टॉल नहीं है, तो अपडेट स्क्रिप्ट इसे आपके लिए इंस्टॉल कर सकती है.

Java 8 के अपडेट के तहत, कुछ टीएलएस साइफ़र अब Oracle JDK 8 में उपलब्ध नहीं हैं. पूरी सूची के लिए, "डिफ़ॉल्ट रूप से बंद किए गए साइफ़र सुइट" सेक्शन http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html देखें.

चेतावनी: Edge की यह रिलीज़, JDK 7 के साथ काम नहीं करती. अगर फ़िलहाल JDK 7 का इस्तेमाल किया जा रहा है, तो आपको JDK 8 पर अपग्रेड करना होगा. अगर Edge 4.16.05 इंस्टॉलेशन को रोलबैक किया जाता है, तो आपके पास Java JDK 7 का इस्तेमाल करने के लिए, Edge को फिर से कॉन्फ़िगर करने का विकल्प होता है.

Zookeeper को डाउनग्रेड करना

Edge for Private Cloud 4.16.01 में Zookeeper आरपीएम का वर्शन apigee-zookeeper-3.4.5-1.0.905.noarch.rpm है. Edge के बाद के वर्शन में, Zookeeper वर्शन को वापस apigee-zookeeper-3.4.5-0.0.948 में बदल दिया गया था. इससे yum, Zookeeper को 4.16.01 से बाद के वर्शन में अपग्रेड नहीं कर पाता. इस समस्या को ठीक करने के लिए, Zookeeper को अपडेट करने से पहले yum downgrade apigee-zookeeper चलाएं.

इस निर्देश का इस्तेमाल करके, Zookeeper का वर्शन देखा जा सकता है:

> rpm -qa |grep apigee-zookeeper

अगर यह निर्देश Zookeeper का वर्शन दिखाता है:

apigee-zookeeper-3.4.5-1.0.905

इसके बाद, आपको डाउनग्रेड करना होगा.

अपडेट के लिए, डिस्क में बचा स्टोरेज

अपडेट करने से पहले, पक्का करें कि आपकी डिस्क में कम से कम 1 जीबी स्टोरेज खाली हो.

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

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

apigee-validate यूटिलिटी को अपडेट करना

आपने 4.16.01 में, मैसेज प्रोसेसर नोड पर apigee-validate यूटिलिटी को इंस्टॉल करके चलाया. 4.16.05 में, apigee-validate यूटिलिटी को मैनेजमेंट सर्वर नोड पर चलाने के लिए अपडेट किया गया है.

वर्शन 4.16.05 पर अपडेट करने पर, आपके पास apigee-validate यूटिलिटी को अपडेट करने के दो विकल्प होते हैं:

  1. Apigee का सुझाव - मैनेजमेंट सर्वर नोड पर, apigee-validate यूटिलिटी को इंस्टॉल करें और चलाएं.

    आपके पास मैसेज प्रोसेसर नोड से, apigee-validate यूटिलिटी को अनइंस्टॉल करने का विकल्प होता है. अगर इसे मैसेज प्रोसेसर नोड पर छोड़ दिया जाता है, तो आपको इसे 4.16.05 पर अपडेट करना होगा.
  2. इसके अलावा, मैसेज प्रोसेसर नोड पर apigee-validate यूटिलिटी को अपडेट करें और उसे वहां से चलाएं. हालांकि, Apigee का सुझाव है कि आप इसे मैनेजमेंट सर्वर से इंस्टॉल करें और चलाएं.

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

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

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

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

    > /<inst_root>/apigee/apigee-service/bin/apigee-all status

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

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

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

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

डिफ़ॉल्ट रूप से, 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.16.01 को इंस्टॉल करने के लिए किया था.

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

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

  1. अगर Cassandra पर रिपेयर ऑपरेशन करने के लिए कोई CRON जॉब कॉन्फ़िगर किया गया है, तो अपडेट पूरा होने तक उसे बंद कर दें.
  2. Edge RPM इंस्टॉल करने के लिए, रूट के तौर पर अपने नोड में लॉग इन करें
    ध्यान दें: RPM इंस्टॉल करने के लिए रूट ऐक्सेस की ज़रूरत होती है. हालांकि, Edge को कॉन्फ़िगर करने के लिए रूट ऐक्सेस की ज़रूरत नहीं होती.
  3. Edge apigee-setup यूटिलिटी इंस्टॉल करना लेख में बताए गए तरीके से, SELinux को बंद करें.
  4. Edge 4.16.05 bootstrap_4.16.05.sh फ़ाइल को /tmp/bootstrap_4.16.05.sh में डाउनलोड करें:
    > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  5. Edge 4.16.05 apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
    > sudo bash /tmp/bootstrap_4.16.05.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 खुद इंस्टॉल करना होगा.
  6. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें:
    1. अगर आपने Edge के 4.15.07.0x वर्शन को अपग्रेड करके 4.16.01 वर्शन इंस्टॉल किया है, तो आपको apigee-setup यूटिलिटी इंस्टॉल करनी होगी:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      यह निर्देश, <inst_dir>/apigee/apigee-setup/bin में update.sh यूटिलिटी इंस्टॉल करता है.

      अगर आपने apigee-setup यूटिलिटी पहले ही इंस्टॉल कर ली है, तो उसे अपडेट करें:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. अगर आपने 4.16.01 को सीधे इंस्टॉल किया है, यानी कि आपने 4.15.07.0x से अपग्रेड नहीं किया है, तो आपको apigee-setup यूटिलिटी को अपडेट करना होगा:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      apigee-service के इस अपडेट से, update.sh यूटिलिटी <inst_dir>/apigee/apigee-setup/bin में इंस्टॉल हो जाती है.
  7. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी इंस्टॉल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
    ध्यान दें: अगर आपने मैसेज प्रोसेसर नोड पर apigee-validate यूटिलिटी इंस्टॉल की है, तो उस नोड पर इस कमांड का इस्तेमाल करके इसे अपडेट किया जा सकता है:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    हालांकि, 4.16.05 के लिए, Apigee का सुझाव है कि आप मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी इंस्टॉल करें और चलाएं.
  8. apigee-validate यूटिलिटी को पास की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करें. Edge की पिछली रिलीज़ में, apigee-validate के इस्तेमाल की जाने वाली कॉन्फ़िगरेशन फ़ाइल के लिए, इन प्रॉपर्टी की ज़रूरत होती थी:
    APIGEE_ADMINPW=sysAdminPword
    MP_POD=gateway
    REGION=dc-1
    इस रिलीज़ में, कॉन्फ़िगरेशन फ़ाइल के लिए सिर्फ़ APIGEE_ADMINPW प्रॉपर्टी की ज़रूरत होती है. फ़ाइल से अन्य दो प्रॉपर्टी हटाई जा सकती हैं.
  9. नीचे दिए गए "मशीन अपडेट करने का क्रम" में बताए गए क्रम में, अपने नोड पर अपडेट यूटिलिटी चलाएं:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    कॉन्फ़िगरेशन फ़ाइल के लिए सिर्फ़ यह ज़रूरी है कि वह "apigee" उपयोगकर्ता के लिए ऐक्सेस या पढ़ने लायक हो. उदाहरण के लिए, फ़ाइल को नोड पर /tmp डायरेक्ट्री में डालें.
    जिस कॉम्पोनेंट को अपडेट करना है उसे बताने के लिए, “-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 = एपीआई BaaS स्टैक
    • p = API BaaS Portal
    • ebp = एक ही नोड पर ElasticSearch, API BaaS स्टैक, और API BaaS पोर्टल
  10. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर, अपडेट की जांच करें. इसके बारे में इंस्टॉल की जांच करें में बताया गया है.

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

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

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

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

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

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

  1. Edge apigee-setup यूटिलिटी इंस्टॉल करें में "लोकल Apigee रिपॉज़िटरी बनाएं" में बताए गए तरीके से, लोकल 4.16.05 रिपॉज़िटरी बनाएं.
    ध्यान दें: अगर आपके पास पहले से 4.16.01 रिपॉज़िटरी है, तो उसमें 4.16.05 रिपॉज़िटरी को जोड़ा जा सकता है.
  2. .tar फ़ाइल से apigee-service इंस्टॉल करने के लिए:
    1. लोकल रेपो वाले नोड पर, लोकल रेपो को /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz नाम की एक.tar फ़ाइल में पैकेज करने के लिए, इस निर्देश का इस्तेमाल करें:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. .tar फ़ाइल को उस नोड पर कॉपी करें जहां आपको Edge को अपडेट करना है. उदाहरण के लिए, इसे नए नोड पर /tmp डायरेक्ट्री में कॉपी करें.
    3. नए नोड पर, फ़ाइल को /tmp डायरेक्ट्री में untar करें:
      > tar -xzf apigee-4.16.05.tar.gz
      यह निर्देश, .tar फ़ाइल वाली डायरेक्ट्री में repos नाम की एक नई डायरेक्ट्री बनाता है. उदाहरण के लिए /tmp/repos.
    4. /tmp/repos से Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
      > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      ध्यान दें कि इस निर्देश में, आपने repos डायरेक्ट्री का पाथ शामिल किया है.
  3. Nginx वेबसर्वर का इस्तेमाल करके apigee-service इंस्टॉल करने के लिए:
    1. Nginx वेब सर्वर को कॉन्फ़िगर करें. इसके लिए, Edge apigee-setup यूटिलिटी इंस्टॉल करें में जाकर, "Nginx वेब सर्वर का इस्तेमाल करके, रिपॉज़िटरी से इंस्टॉल करें" में बताया गया तरीका अपनाएं.
    2. रिमोट नोड पर, Edge bootstrap_4.16.05.sh फ़ाइल को /tmp/bootstrap_4.16.05.sh पर डाउनलोड करें:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
      जहां uName:pWord, वह उपयोगकर्ता नाम और पासवर्ड है जिसे आपने रिपॉज़िटरी के लिए सेट किया है. साथ ही, remoteRepo, रिपॉज़िटरी नोड का आईपी पता या डीएनएस नाम है.
    3. रिमोट नोड पर, Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      जहां uName:pWord, रेपो का उपयोगकर्ता नाम और पासवर्ड है.
  4. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें:
    1. अगर आपने Edge के 4.15.07.0x वर्शन को अपग्रेड करके 4.16.01 वर्शन इंस्टॉल किया है, तो आपको apigee-setup यूटिलिटी इंस्टॉल करनी होगी:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      यह निर्देश, <inst_dir>/apigee/apigee-setup/bin में update.sh यूटिलिटी इंस्टॉल करता है.

      अगर आपने apigee-setup यूटिलिटी पहले ही इंस्टॉल कर ली है, तो उसे अपडेट करें:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. अगर आपने 4.16.01 को सीधे इंस्टॉल किया है, यानी कि आपने 4.15.07.0x से अपग्रेड नहीं किया है, तो आपको apigee-setup यूटिलिटी को अपडेट करना होगा:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      apigee-service के इस अपडेट से, <inst_dir>/apigee/apigee-setup/bin में update.sh यूटिलिटी इंस्टॉल हो जाती है.
  5. मैनेजमेंट सर्वर नोड पर apigee-validate यूटिलिटी इंस्टॉल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
    ध्यान दें: अगर आपने मैसेज प्रोसेसर नोड पर apigee-validate यूटिलिटी इंस्टॉल की है, तो उस नोड पर इस कमांड का इस्तेमाल करके इसे अपडेट किया जा सकता है:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    हालांकि, 4.16.05 के लिए, Apigee का सुझाव है कि आप मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को इंस्टॉल करें और चलाएं.
  6. apigee-validate यूटिलिटी को पास की गई कॉन्फ़िगरेशन फ़ाइल में बदलाव करें. Edge के पिछले वर्शन में, apigee-validate के इस्तेमाल की जाने वाली कॉन्फ़िगरेशन फ़ाइल के लिए, इन प्रॉपर्टी की ज़रूरत होती थी:
    APIGEE_ADMINPW=sysAdminPword
    MP_POD=gateway
    REGION=dc-1
    इस वर्शन में, कॉन्फ़िगरेशन फ़ाइल के लिए सिर्फ़ APIGEE_ADMINPW प्रॉपर्टी की ज़रूरत होती है. फ़ाइल से अन्य दो प्रॉपर्टी हटाई जा सकती हैं.
  7. नीचे दिए गए "मशीन अपडेट करने का क्रम" में बताए गए क्रम में, अपने नोड पर अपडेट यूटिलिटी चलाएं:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    कॉन्फ़िगरेशन फ़ाइल के लिए सिर्फ़ यह ज़रूरी है कि वह "apigee" उपयोगकर्ता के लिए ऐक्सेस या पढ़ने लायक हो. उदाहरण के लिए, फ़ाइल को नोड पर /tmp डायरेक्ट्री में डालें.
    जिस कॉम्पोनेंट को अपडेट करना है उसे बताने के लिए, “-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 = एपीआई BaaS स्टैक
    • p = API BaaS Portal
    • ebp = एक ही नोड पर ElasticSearch, API BaaS स्टैक, और API BaaS पोर्टल
  8. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर, अपडेट की जांच करें. इसके बारे में इंस्टॉल की जांच करें में बताया गया है.

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

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

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

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

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

  1. Zookeeper को डाउनग्रेड करें:
    > yum downgrade apigee-zookeeper
  2. मशीन 1 को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  3. /opt/nginx/conf.d में मौजूद सभी फ़ाइलें मिटाएं:
    > rm -f /opt/nginx/conf.d/*
  4. Edge राऊटर को रीस्टार्ट करें:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart

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

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

  1. मशीन 1 पर Zookeeper को डाउनग्रेड करें:
    > yum downgrade apigee-zookeeper
  2. मशीन 1 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 2 पर qpidd और postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. मशीन 2 और मशीन 1 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. नोड 1 पर:
    1. /opt/nginx/conf.d में मौजूद सभी फ़ाइलें मिटाएं:
      > rm -f /opt/nginx/conf.d/*
    2. Edge राऊटर को रीस्टार्ट करें:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  7. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. मशीन 1, 2, और 3 पर Zookeeper को डाउनग्रेड करें:
    > yum downgrade apigee-zookeeper
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 4 और 5 पर qpidd और postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. मशीन 4, 5, 1, 2, 3 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. नोड 2 और 3 पर:
    1. /opt/nginx/conf.d में मौजूद सभी फ़ाइलें मिटाएं:
      > rm -f /opt/nginx/conf.d/*
    2. Edge राऊटर को रीस्टार्ट करें:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  7. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. मशीन 1, 2, और 3 पर Zookeeper को डाउनग्रेड करें:
    > yum downgrade apigee-zookeeper
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 6 और 7 पर qpidd को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. मशीन 8 और 9 पर postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. मशीन 6, 7, 8, 9, 1, 4, और 5 पर Edge कॉम्पोनेंट को इस क्रम में अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. नोड 4 और 5 पर:
    1. /opt/nginx/conf.d में मौजूद सभी फ़ाइलें मिटाएं:
      > rm -f /opt/nginx/conf.d/*
    2. Edge राऊटर को रीस्टार्ट करें:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. मशीन 1, 2, और 3 पर Zookeeper को डाउनग्रेड करें:
    > yum downgrade apigee-zookeeper
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 12 और 13 पर qpidd को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. मशीन 8 और 9 पर postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. मशीन 4 और 5 पर एलडीएपी अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. मशीन 12, 13, 8, 9, 6, 7, 10, और 11 पर Edge के कॉम्पोनेंट को इसी क्रम में अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. नोड 10 और 11 पर:
    1. /opt/nginx/conf.d में मौजूद सभी फ़ाइलें मिटाएं:
      > rm -f /opt/nginx/conf.d/*
    2. Edge राऊटर को रीस्टार्ट करें:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. मशीन 6 और 7 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. Cassandra और ZooKeeper को अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 1, 2, और 3 पर Zookeeper को डाउनग्रेड करें:
      > yum downgrade apigee-zookeeper
    2. डेटा सेंटर 1 में मशीन 1, 2, और 3 पर:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. डेटा सेंटर 2 में मशीन 7, 8, और 9 पर Zookeeper को डाउनग्रेड करें:
      > yum downgrade apigee-zookeeper
    4. डेटा सेंटर 2 में मशीन 7, 8, और 9 पर
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. qpidd अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 4, 5
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. डेटा सेंटर 2 में मशीन 10, 11
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. postgresql को अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 6
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. डेटा सेंटर 2 में मशीन 12
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. 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
  5. Edge के कॉम्पोनेंट अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 4, 5, 6, 1, 2, 3
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. डेटा सेंटर 2 में मशीन 10, 11, 12, 7, 8, 9
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    3. नोड 2, 3, 8, और 9 पर:
      1. /opt/nginx/conf.d में मौजूद सभी फ़ाइलें मिटाएं:
        > rm -f /opt/nginx/conf.d/*
      2. Edge राऊटर को रीस्टार्ट करें:
        > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  6. यूज़र इंटरफ़ेस (यूआई) अपडेट करना:
    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

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

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

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

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

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

  1. मशीन 8, 9, और 10 पर Cassandra को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. मशीन 1, 2, और 3 पर ElasticSearch को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. मशीन 4, 5, और 6 पर एपीआई BaaS स्टैक को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. मशीन 7 पर API BaaS पोर्टल को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd
  4. postgresql
  5. LDAP
  6. Edge, जिसका मतलब है कि सभी नोड पर "-c edge" प्रोफ़ाइल को इस क्रम में इंस्टॉल किया जाता है: Qpid, Postgres, मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर.
  7. सभी राऊटर नोड पर:
    1. /opt/nginx/conf.d में मौजूद सभी फ़ाइलें मिटाएं:
      > rm -f /opt/nginx/conf.d/*
    2. Edge राऊटर को रीस्टार्ट करें:
      > /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
  8. यूज़र इंटरफ़ेस (यूआई)