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

Edge for Private Cloud v. 4.17.09

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

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

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

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

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

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

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

आपको 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 ET0 -j DROP
  • Qpid सूची के मैसेज खाली होने का इंतज़ार करें. इससे यह पक्का किया जा सकेगा कि Qpid नोड अपडेट से पहले सभी मैसेज प्रोसेस कर चुका है. इस निर्देश का इस्तेमाल करके पक्का करें कि Qpid मैसेज की सूची खाली है:
    > qpid-stat -q
  • Qpid नोड अपडेट करें.
  • राऊटर और मैसेज प्रोसेसर से ऐक्सेस देने के लिए, Qpid नोड पर पोर्ट 5672 को अनब्लॉक करें. इस पोर्ट को अनब्लॉक करने के लिए, यहां दिए गए निर्देश का इस्तेमाल किया जा सकता है:
    > sudo iptables -F

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

हर एज टोपोलॉजी के लिए, नीचे इस प्रोसेस के बारे में विस्तार से बताया गया है.

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

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

  • RedHat/CentOS/Oracle 7.x के लिए:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.no Arc.rpm; rpm -ivh epel-release-latest-7.noach.rpm
  • RedHat/CentOS/Oracle 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 में, कॉन्फ़िगरेशन फ़ाइल में एक नया ज़रूरी पैरामीटर जोड़ा गया है. इसका इस्तेमाल, SMTP सर्वर चालू करने के लिए किया जाता है. अगर आपको 4.17.01 से अपडेट करना है, तो एसएमटीपी सर्वर चालू करते समय, आपको कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करना होगा.

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

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

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

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

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

ज़्यादा जानकारी के लिए, बाहरी पुष्टि करने की सुविधा का कॉन्फ़िगरेशन देखें.

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

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

IS_EXTERNAL_AUTH="true"

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

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

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

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

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

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

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

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

सफल न होने वाले अपडेट को मैनेज करना

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

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

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

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

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

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

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

बिना किसी डाउनटाइम के अपडेट करना

बिना किसी रुकावट के अपडेट करने की सुविधा या रोलिंग अपडेट की मदद से, Edge को बंद किए बिना ही उसे अपडेट किया जा सकता है.

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

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

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

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

  • मिले-जुले राऊटर और मैसेज प्रोसेसर नोड पर:
    • अपडेट करने से पहले – ये काम करें:
      1. राऊटर को ऐक्सेस न किया जा सके.
      2. मैसेज प्रोसेसर को ऐक्सेस न किया जा सके.
    • अपडेट करने के बाद, ये काम करें:
      1. मैसेज प्रोसेसर को ऐक्सेस किया जा सके.
      2. राऊटर को ऐक्सेस किया जा सके.
  • एक राऊटर नोड पर:
    • अपडेट करने से पहले, राऊटर को ऐक्सेस न किया जा सके.
    • अपडेट के बाद, राऊटर को ऐक्सेस करने लायक बनाएं.
  • एक मैसेज प्रोसेसर नोड पर:
    • अपडेट करने से पहले, पक्का करें कि मैसेज प्रोसेसर को ऐक्सेस न किया जा सके.
    • अपडेट करने के बाद, मैसेज प्रोसेसर को ऐक्सेस किया जा सकता है.

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

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

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

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

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

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

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

    I = OpenJDK 1.8 इंस्टॉल करें (डिफ़ॉल्ट)
    C = Java इंस्टॉल किए बिना जारी रखें
    Q = छोड़ें. इस विकल्प के लिए, आपको खुद Java इंस्टॉल करना होगा.
  9. apigee-setup यूटिलिटी को अपडेट करने के लिए apigee-service का इस्तेमाल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup अपडेट
  10. मैनेजमेंट सर्वर पर apigee-Validation सुविधा को अपडेट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-verification अपडेट
  11. apigee-provision उपयोगिता को अपडेट करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. अपने नोड पर अपडेट की सुविधा को, "मशीन को अपडेट करने का क्रम" में बताए गए क्रम में चलाएं:
    > /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 के तौर पर इंस्टॉलेशन प्रोफ़ाइल के लिए इस्तेमाल करें)
    e = ElasticSearch
    b = API BaaS स्टैक
    p = API BaaS पोर्टल
    ebp = एक ही नोड पर ElasticSearch, API BaaS स्टैक, और API BaaS पोर्टल
  13. इंस्टॉल की जांच करें में बताए गए तरीके के मुताबिक, मैनेजमेंट सर्वर पर apigee-validate टूल चलाकर अपडेट की जांच करें.

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

स्थानीय रिपॉज़िटरी से 4.17.09 पर अपडेट करने का तरीका

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

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

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

लोकल 4.17.09 रेपो से अपडेट करने के लिए:

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

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

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

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

      यहां uName:pWord, repo का उपयोगकर्ता नाम और पासवर्ड है.
  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 के तौर पर इंस्टॉलेशन प्रोफ़ाइल के लिए इस्तेमाल करें)
    e = ElasticSearch
    b = API BaaS स्टैक
    p = API BaaS पोर्टल
    ebp = एक ही नोड पर ElasticSearch, API BaaS स्टैक, और API BaaS पोर्टल
  8. इंस्टॉल की जांच करें में बताए गए तरीके के मुताबिक, मैनेजमेंट सर्वर पर apigee-validate टूल चलाकर अपडेट की जांच करें.

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

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

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

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

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

  1. अगर आपने Edge पर एसएमटीपी चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPMAILFROM सेट करें. इस पैरामीटर का यह फ़ॉर्म है:
    SMTPEMAILFROM="मेरी कंपनी <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. एलडीपी अपडेट करें:
    > /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. पहली मशीन पर Cassandra और ZooKeeper को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. मशीन 2 पर यह iptables नियम सेट करें:
    > sudo iptables -A इनपुट -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. मशीन 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. पहली मशीन पर यूज़र इंटरफ़ेस (यूआई) अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

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

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

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

  1. अगर आपने Edge पर SMTP चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPEMAILFROM को सेट करें. इस पैरामीटर का फ़ॉर्मैट यह है:
    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 ET0 -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. सातवीं मशीन पर, तीसरे से लेकर छठे चरण तक दोहराएं.
  8. छठी मशीन पर 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. सातवीं मशीन पर आठवां और नौवां चरण दोहराएं.
  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 पर SMTP चालू किया है, तो अपनी कॉन्फ़िगरेशन फ़ाइल में SMTPEMAILFROM को सेट करें. इस पैरामीटर का यह फ़ॉर्म है:
    SMTPEMAILFROM="मेरी कंपनी <myco@company.com>"
  2. पहली, दूसरी, और तीसरी मशीन पर 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 ET0 -j DROP
  4. मशीन 12 पर Qpid मैसेज की सूची देखें:
    > qpid-stat -q

    "मैसेज" कॉलम में संख्या 0 होने तक, सूची देखना जारी रखें. Qpid को तब तक अपग्रेड नहीं किया जा सकता, जब तक वह सभी मैसेज प्रोसेस नहीं कर लेता.
  5. qpidd को अपडेट करें मशीन 12 पर:
    > /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. चौथी और पांचवीं मशीन पर एलडीपी अपडेट करें:
    > /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. चौथी मशीन पर, iptables का यह नियम सेट करें:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. चौथी मशीन पर Qpid मैसेज क्यू देखें:
        > qpid-stat -q

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

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

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

  1. पांचवीं, छठी, और सातवीं मशीन पर 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-host 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"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

  1. मशीन 8, 9, और 10 पर कैसंड्रा को अपडेट करें:
    > /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 पर API BaaS स्टैक को अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. सातवीं मशीन पर API BaaS पोर्टल अपडेट करें:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

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