Apigee Edge 4.16.09 को 4.17.05 में अपडेट करें

Edge for Private Cloud v. 4.17.05

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

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

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

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

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

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

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

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

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

इस रिलीज़ में, Qpid 1.35 के लिए एक ज़रूरी अपडेट शामिल है. Qpid नोड को अपडेट करने के लिए, आपको ये काम करने होंगे:

  • Qpid नोड पर पोर्ट 5672 को ब्लॉक करके, कुछ समय के लिए राऊटर और मैसेज प्रोसेसर को Qpid नोड पर डेटा लिखने से रोकें. Qpid नोड पर इस पोर्ट को ब्लॉक करने के लिए, इस निर्देश का इस्तेमाल किया जा सकता है:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  • Qpid सूची में मौजूद सभी मैसेज के प्रोसेस होने का इंतज़ार करें. इससे यह पक्का किया जा सकेगा कि अपडेट से पहले, Qpid नोड ने सभी मैसेज प्रोसेस कर लिए हैं. यह पक्का करने के लिए कि Qpid मैसेज सूची खाली है, इस निर्देश का इस्तेमाल करें:
    > qpid-stat -q
  • Qpid नोड को अपडेट करें.
  • राऊटर और मैसेज प्रोसेसर से ऐक्सेस की अनुमति देने के लिए, Qpid नोड पर पोर्ट 5672 को अनब्लॉक करें. इस पोर्ट को अनब्लॉक करने के लिए, इस निर्देश का इस्तेमाल किया जा सकता है:
    > sudo iptables -F

    ध्यान दें कि अगर अन्य नियमों के लिए iptables का इस्तेमाल किया जा रहा है, तो किसी खास बदलाव को पहले जैसा करने के लिए, -D विकल्प का इस्तेमाल किया जा सकता है:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

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

EPEL रेपो को चालू करने के लिए ज़रूरी है

Edge को इंस्टॉल या अपडेट करने के लिए, आपको Extra Packages for Enterprise Linux (या EPEL) को चालू करना होगा. इस्तेमाल किया जाने वाला कमांड, RedHat/CentOS के आपके वर्शन पर निर्भर करता है:

  • RedHat/CentOS 7.x के लिए:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • RedHat/CentOS 6.x के लिए:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

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

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

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

अगर बाहरी पुष्टि करने की सुविधा का इस्तेमाल करके अपडेट किया जा रहा है, तो यह ज़रूरी है

किसी बाहरी डायरेक्ट्री सेवा को, Apigee Edge Private Cloud के मौजूदा इंस्टॉलेशन में इंटिग्रेट किया जा सकता है. यह सुविधा, LDAP के साथ काम करने वाली किसी भी डायरेक्ट्री सेवा के साथ काम करती है. जैसे, Active Directory, OpenLDAP वगैरह. बाहरी एलडीएपी सलूशन की मदद से, सिस्टम एडमिन, उपयोगकर्ता के क्रेडेंशियल को डायरेक्ट्री मैनेजमेंट की एक ऐसी सेवा से मैनेज कर सकते हैं जो Apigee Edge जैसे सिस्टम से बाहर होती है.

ज़्यादा जानकारी के लिए, इंस्टॉलेशन टोपोलॉजी देखें.

जब बाहरी पुष्टि करने की सुविधा चालू होती है, तो ज़्यादातर ग्राहक पुष्टि करने के लिए उपयोगकर्ता नाम के तौर पर, Active Directory SAM खाते के नाम वाले फ़ील्ड का इस्तेमाल करते हैं. वे ईमेल पते का इस्तेमाल नहीं करते, जिसका इस्तेमाल Edge OpenLDAP सर्वर करता है.

अगर आपने बाहरी डायरेक्ट्री सेवा के साथ इंटिग्रेट किया है, तो Edge को 4.17.05 पर अपडेट करते समय, अपनी कॉन्फ़िगरेशन फ़ाइल में यह लाइन जोड़ें:

IS_EXTERNAL_AUTH="true"

यह लाइन, Edge को ईमेल पते के बजाय खाते के नाम को उपयोगकर्ता नाम के तौर पर इस्तेमाल करने के लिए कॉन्फ़िगर करती है.

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

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

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

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

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

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

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

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

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

अगर अपडेट पूरा नहीं हो पाता है और आपको पिछले वर्शन पर वापस जाना है, तो ज़्यादा जानकारी के लिए 4.17.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.16.09 को इंस्टॉल करने के लिए किया था.

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

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

  1. अगर Cassandra पर रिपेयर ऑपरेशन करने के लिए कोई CRON जॉब कॉन्फ़िगर किया गया है, तो अपडेट पूरा होने तक उसे बंद कर दें.
  2. Edge RPM इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
    ध्यान दें: आरपीएम इंस्टॉल करने के लिए रूट ऐक्सेस की ज़रूरत होती है. हालांकि, रूट ऐक्सेस के बिना भी Edge को कॉन्फ़िगर किया जा सकता है.
  3. Edge apigee-setup यूटिलिटी इंस्टॉल करना लेख में बताए गए तरीके से, SELinux को बंद करें.
  4. Edge 4.17.05 bootstrap_4.17.05.sh फ़ाइल को /tmp/bootstrap_4.17.05.sh में डाउनलोड करें:
    > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  5. Edge 4.17.05 apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
    > sudo bash /tmp/bootstrap_4.17.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. (सिर्फ़ CentOS-6.x और RedHat-6.x के लिए) सभी Qpid नोड पर, यह कमांड चलाएं, ताकि यह पक्का किया जा सके कि आपने Qpid का सही वर्शन डाउनलोड किया है:
    > yum install apigee-qpidd --disablerepo=epel
  7. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  8. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  9. apigee-provision यूटिलिटी को अपडेट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. नीचे दिए गए "मशीन अपडेट करने का क्रम" में बताए गए क्रम में, अपने नोड पर अपडेट यूटिलिटी चलाएं:
    > /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 पोर्टल
  11. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी चलाकर, अपडेट की जांच करें. इसके बारे में इंस्टॉल की जांच करें में बताया गया है.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • किसी भी अन्य नोड को अपडेट करने से पहले, आपको Cassandra और ZooKeeper के सभी नोड अपडेट करने होंगे.
  • अगर किसी मशीन में Edge के कई कॉम्पोनेंट (मैनेजमेंट सर्वर, मैसेज प्रोसेसर, राऊटर, QPID सर्वर, लेकिन Postgres सर्वर नहीं) हैं, तो उन सभी को एक साथ अपडेट करने के लिए, "-c edge" विकल्प का इस्तेमाल करें.
  • अगर किसी चरण में यह बताया गया है कि उसे कई मशीनों पर पूरा किया जाना चाहिए, तो उसे बताई गई मशीनों के क्रम में पूरा करें.
  • कमाई करने की सुविधा को अपडेट करने के लिए, कोई अलग चरण नहीं है. "-c edge" विकल्प चुनने पर, यह अपडेट हो जाता है.
  • (सिर्फ़ CentOS-6.x और RedHat-6.x के लिए) बाहरी इंटरनेट कनेक्शन वाले सभी Qpid नोड पर, पक्का करें कि आपने ऊपर बताए गए तरीके से सही Qpid वर्शन डाउनलोड करने के लिए, यह कमांड चलाया हो:
    > yum install apigee-qpidd --disablerepo=epel

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

  1. अगर आपने Edge पर एसएमटीपी चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. यह iptables नियम सेट करें:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. Qpid मैसेज की सूची देखें:
    > qpid-stat -q

    सूची को तब तक देखते रहें, जब तक "msg" कॉलम में संख्या 0 न हो जाए. जब तक Qpid सभी मैसेज प्रोसेस नहीं कर लेता, तब तक इसे अपग्रेड नहीं किया जा सकता.
  5. qpidd को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. iptables को फ़्लश करें:
    > sudo iptables -F
  7. postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. postgresql को चालू करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. Edge के बाकी कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. Edge यूज़र इंटरफ़ेस (यूआई) को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. अगर आपने Edge पर एसएमटीपी चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. मशीन 1 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 2 पर, iptables का यह नियम सेट करें:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. मशीन 2 पर Qpid मैसेज की सूची देखें:
    > qpid-stat -q

    सूची को तब तक देखते रहें, जब तक "msg" कॉलम में संख्या 0 न हो जाए. जब तक Qpid सभी मैसेज प्रोसेस नहीं कर लेता, तब तक इसे अपग्रेड नहीं किया जा सकता.
  5. मशीन 2 पर qpidd को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. मशीन 2 पर iptables को फ़्लश करें:
    > sudo iptables -F
  7. मशीन 2 पर postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. मशीन 2 पर postgresql शुरू करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. मशीन 2 और 1 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. अगर आपने Edge पर एसएमटीपी चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 4 पर, iptables का यह नियम सेट करें:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. मशीन 4 पर Qpid मैसेज की सूची देखें:
    > qpid-stat -q

    सूची को तब तक देखते रहें, जब तक "msg" कॉलम में संख्या 0 न हो जाए. जब तक Qpid सभी मैसेज प्रोसेस नहीं कर लेता, तब तक इसे अपग्रेड नहीं किया जा सकता.
  5. मशीन 4 पर qpidd को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. मशीन 4 पर iptables को फ़्लश करें:
    > sudo iptables -F
  7. मशीन 5 पर तीसरे से छठे चरण को दोहराएं.
  8. मशीन 4 पर postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. मशीन 4 पर postgresql शुरू करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. पांचवीं मशीन पर आठवें और नौवें चरण को दोहराएं.
  11. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. मशीन 4, 5, 1, 2, 3 पर Edge कॉम्पोनेंट अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. अगर आपने Edge पर एसएमटीपी चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 6 पर, iptables का यह नियम सेट करें:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. मशीन 6 पर Qpid मैसेज की सूची देखें:
    > qpid-stat -q

    सूची को तब तक देखते रहें, जब तक "msg" कॉलम में संख्या 0 न हो जाए. जब तक Qpid सभी मैसेज प्रोसेस नहीं कर लेता, तब तक इसे अपग्रेड नहीं किया जा सकता.
  5. छठी मशीन पर qpidd को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. मशीन 6 पर iptables को फ़्लश करें:
    > sudo iptables -F
  7. मशीन 7 पर तीसरे से छठे चरण को दोहराएं.
  8. मशीन 6 पर postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. मशीन 6 पर postgresql को चालू करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. मशीन 7 पर आठवें और नौवें चरण को दोहराएं.
  11. मशीन 1 पर LDAP को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. मशीन 6, 7, 8, 9, 1, 4, और 5 पर Edge कॉम्पोनेंट को इस क्रम में अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. मशीन 1 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. अगर आपने Edge पर एसएमटीपी चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. मशीन 1, 2, और 3 पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 12 पर, iptables का यह नियम सेट करें:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. मशीन 12 पर Qpid मैसेज की सूची देखें:
    > qpid-stat -q

    सूची को तब तक देखते रहें, जब तक "msg" कॉलम में संख्या 0 न हो जाए. जब तक Qpid सभी मैसेज प्रोसेस नहीं कर लेता, तब तक इसे अपग्रेड नहीं किया जा सकता.

  5. मशीन पर qpidd को अपडेट करें:> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. मशीन 12 पर iptables को फ़्लश करें:
    > sudo iptables -F
  7. मशीन 13 पर तीसरे से छठे चरण को दोहराएं.
  8. मशीन 12 पर postgresql को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. मशीन 12 पर postgresql शुरू करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. मशीन 13 पर आठवें और नौवें चरण को दोहराएं.
  11. मशीन 4 और 5 पर एलडीएपी अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. मशीन 12, 13, 8, 9, 6, 7, 10, और 11 पर Edge के कॉम्पोनेंट को इसी क्रम में अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. मशीन 6 और 7 पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. अगर आपने Edge पर एसएमटीपी चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का फ़ॉर्मैट ऐसा होता है:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. 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
  3. qpidd अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 4 और 5
      1. मशीन 4 पर, iptables का यह नियम सेट करें:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. मशीन 4 पर Qpid मैसेज की सूची देखें:
        > qpid-stat -q

        सूची को तब तक देखते रहें, जब तक "msg" कॉलम में संख्या 0 न हो जाए. जब तक Qpid सभी मैसेज प्रोसेस नहीं कर लेता, तब तक उसे अपग्रेड नहीं किया जा सकता.
      3. मशीन 4 पर qpidd को अपडेट करें:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. मशीन 4 पर iptables को फ़्लश करें:
        > sudo iptables -F
      5. मशीन 5 पर, पहले से लेकर चौथे चरण तक को दोहराएं.
    2. डेटा सेंटर 2 में मशीन 10, 11
      1. मशीन 10 पर, iptables का यह नियम सेट करें:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. मशीन 10 पर Qpid मैसेज की सूची देखें:
        > qpid-stat -q

        सूची को तब तक देखते रहें, जब तक "msg" कॉलम में संख्या 0 न हो जाए. जब तक Qpid सभी मैसेज प्रोसेस नहीं कर लेता, तब तक उसे अपग्रेड नहीं किया जा सकता.
      3. मशीन 10 पर qpidd को अपडेट करें:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. मशीन 10 पर iptables को फ़्लश करें:
        > sudo iptables -F
      5. मशीन 11 पर, पहले से लेकर चौथे चरण तक को दोहराएं.
  4. PostgreSQL अपडेट करें:
    1. डेटा सेंटर 1 में मशीन 6
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. डेटा सेंटर 2 में मशीन 12
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  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, 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
  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

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

अपग्रेड की प्रोसेस शुरू करने से पहले, आपको कॉन्फ़िगरेशन फ़ाइल में दो नई प्रॉपर्टी जोड़नी होंगी:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

कॉन्फ़िगरेशन फ़ाइल का पूरा उदाहरण देखने के लिए, API BaaS इंस्टॉलेशन देखें.

आपको यह भी पक्का करना होगा कि सभी स्टैक नोड पर पोर्ट 2551 खुला हो, ताकि अन्य सभी स्टैक नोड से इसे ऐक्सेस किया जा सके.

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 इंस्टॉलेशन के लिए

अपग्रेड की प्रोसेस शुरू करने से पहले, आपको कॉन्फ़िगरेशन फ़ाइल में दो नई प्रॉपर्टी जोड़नी होंगी:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

कॉन्फ़िगरेशन फ़ाइल का पूरा उदाहरण देखने के लिए, API BaaS इंस्टॉलेशन देखें.

आपको यह भी पक्का करना होगा कि सभी स्टैक नोड पर पोर्ट 2551 खुला हो, ताकि अन्य सभी स्टैक नोड से इसे ऐक्सेस किया जा सके.

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, ps
  4. LDAP
  5. Edge, जिसका मतलब है कि सभी नोड पर "-c edge" प्रोफ़ाइल को इस क्रम में अपडेट करें: Qpid सर्वर, Postgres सर्वर, मैनेजमेंट सर्वर, मैसेज प्रोसेसर, और राऊटर वाले नोड.
    ध्यान दें: अगर नोड में Qpid सर्वर और Postgres सर्वर, दोनों इंस्टॉल हैं, तो "-c edge" प्रोफ़ाइल वाला चरण चलाएं.
  6. Edge का यूज़र इंटरफ़ेस (यूआई)