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

Edge for Private Cloud v. 4.17.01

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

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

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

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

अपडेट को लागू करने वाले उपयोगकर्ता को वही उपयोगकर्ता होना चाहिए जिसने मूल रूप से 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 ड्रॉप
• 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 ड्रॉप

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

EPEL डेटा स्टोर करने की सुविधा को चालू करने के लिए, इसे चालू करना ज़रूरी है

Edge को इंस्टॉल या अपडेट करने के लिए, आपको 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

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

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

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

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

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

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 को इंस्टॉल किए बिना अपडेट किया जा सकता है.

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

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

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

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

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

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

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

बाहरी इंटरनेट कनेक्शन वाले नोड पर 4.17.01 पर अपडेट करने की प्रक्रिया

किसी नोड पर एज कॉम्पोनेंट को अपडेट करने के लिए नीचे दी गई प्रक्रिया का इस्तेमाल करें:

1. अगर यह मौजूद हो, तो Cassandra पर रिपेयर प्रोसेस करने के लिए कॉन्फ़िगर किए गए किसी भी CRON जॉब को बंद कर दें. ऐसा अपडेट पूरा होने तक होगा.
2. Edge आरपीएम इंस्टॉल करने के लिए, अपने नोड में रूट के तौर पर लॉग इन करें.
   ध्यान दें: आरपीएम इंस्टॉल करने के लिए, रूट ऐक्सेस की ज़रूरत होती है. हालांकि, रूट ऐक्सेस के बिना भी Edge कॉन्फ़िगरेशन किया जा सकता है.
3. Edge apigee-setup उपयोगिता इंस्टॉल करें में बताए गए तरीके से SELinux को बंद करें.
4. /tmp/bootstrap_4.17.01.sh पर Edge 4.17.01 bootstrap_4.17.01.sh फ़ाइल डाउनलोड करें:
   > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/boot7.4p_1
5. Edge 4.17.01 apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
   > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord
   
   जहां uName:pWorde, आपको उपयोगकर्ता नाम और पासवर्ड मिला है. pWord को छोड़ने पर, आपको इसे डालने के लिए कहा जाएगा.
   
   डिफ़ॉल्ट रूप से, इंस्टॉलर यह जांच करता है कि आपके पास Java 1.8 इंस्टॉल है या नहीं. अगर आप ऐसा नहीं करते हैं, तो यह इसे आपके लिए इंस्टॉल कर देता है. Java इंस्टॉलेशन को मैनेज करने का तरीका बताने के लिए, JAVA_FIX विकल्प का इस्तेमाल करें. JAVA_FIX में ये वैल्यू ली जाती हैं:
   
   I = OpenJDK 1.8 इंस्टॉल करें (डिफ़ॉल्ट)
   C = Java इंस्टॉल किए बिना जारी रखें
   Q = Quit. इस विकल्प का इस्तेमाल करने के लिए, आपको खुद 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 अपडेट
8. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-verification 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
    
    कॉन्फ़िगरेशन फ़ाइल की सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल को उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.
    
    जिस कॉम्पोनेंट को अपडेट करना है उसके बारे में बताने के लिए, “-c” विकल्प का इस्तेमाल करें. संभावित कॉम्पोनेंट की सूची में ये चीज़ें शामिल हैं:
    ldap = OpenLDAP
    ldap = Cassandra
    ldap = ज़ूकीपर
    ldap = qpidd
    ldap = postgresql
    ldap =सभी Edge के कॉम्पोनेंट, QPID सर्वर के अलावा संदेश प्रोसेसर, रूटर, QPID के लिए
    
    
    
    
    
    ldap
11. इंस्टॉल की जांच करना सेक्शन में बताए गए तरीके से, मैनेजमेंट सर्वर पर apigee-Verify यूटिलिटी चलाकर अपडेट की जांच करें.

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

स्थानीय डेटा स्टोर करने की जगह से, 4.17.01 में अपडेट करने की प्रक्रिया

अगर आपके Edge नोड फ़ायरवॉल से सुरक्षित हैं या किसी दूसरे तरीके से उन्हें इंटरनेट पर Apigee डेटा स्टोर करने की जगह को ऐक्सेस करने से रोका गया है, तो आप Apigee डेटा स्टोर करने की स्थानीय जगह या उनके डुप्लीकेट वर्शन से अपडेट कर सकते हैं.

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

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

स्थानीय 4.17.01 डेटा स्टोर करने की जगह से अपडेट करने के लिए:

1. Edge apigee-setup उपयोगिता इंस्टॉल करें में "स्थानीय Apigee डेटा स्टोर करने की जगह बनाएं" में बताए गए तरीके से, स्थानीय 4.17.01 डेटा स्टोर करने की सुविधा बनाएं.
   ध्यान दें: अगर आपके पास पहले से ही 4.16.09 डेटा स्टोर है, तो उसमें 4.17.01 रेपो जोड़ा जा सकता है. Edge apigee-setup उपयोगिता इंस्टॉल करें पर जाकर, "स्थानीय Apigee डेटा स्टोर करने की जगह अपडेट करें" में बताया गया तरीका अपनाएं.
2. .tar फ़ाइल से apigee-service इंस्टॉल करने के लिए:
   1. लोकल रेपो वाले नोड पर, नीचे दिए गए कमांड का इस्तेमाल करके, लोकल रेपो को /opt/apigee/data/apigee-mirror/apigee-4.17.01.tar.gz नाम वाली एक.tar फ़ाइल में पैकेज करें:
      > /opt/apigee/apigee-service/bin/apigee-mir-service apige
   2. .tar फ़ाइल को उस नोड में कॉपी करें जहां आपको Edge को अपडेट करना है. उदाहरण के लिए, इसे नए नोड पर मौजूद /tmp डायरेक्ट्री में कॉपी करें.
   3. नए नोड पर, फ़ाइल को /tmp डायरेक्ट्री से अनटार करें:
      > tar -xzf apigee-4.17.01.tar.gz
      
      यह निर्देश .tar फ़ाइल वाली डायरेक्ट्री में repos नाम से एक नई डायरेक्ट्री बनाता है. उदाहरण के लिए, /tmp/repos.
   4. /tmp/repos से Edge apigee-सेवा यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
      > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      ध्यान दें कि आप इस कमांड में डायरेक्ट्री को शामिल करते हैं.
      
3. Ngnx वेबसर्वर का इस्तेमाल करके, apigee-सेवा इंस्टॉल करने के लिए:
   1. In the Edge apigee-setup उपयोगिता में "Ngnx वेबसर्वर का इस्तेमाल करके रेपो से इंस्टॉल करें" में बताए गए तरीके से Nlinx वेब सर्वर को कॉन्फ़िगर करें.
   2. रिमोट नोड पर /tmp/bootstrap_4.17.01.sh:
      के लिए Edge bootstrap_4.17.01.sh फ़ाइल डाउनलोड करें. bootstrap_4.17.01.sh फ़ाइल.17.01.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo. @remoteRepo. नोड.1.
      
   3. रिमोट नोड पर, Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWorde पासवर्ड.
      
      
4. apigee-setup यूटिलिटी अपडेट करने के लिए, apigee-service का इस्तेमाल करें:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup अपडेट
5. मैनेजमेंट सर्वर पर apigee-validate यूटिलिटी को अपडेट करें.
   > /opt/apigee/apigee-service/bin/apigee-service apigee-verification अपडेट
6. apigee-provision सुविधा को अपडेट करें:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
7. नीचे "मशीन अपडेट का क्रम" में बताए गए क्रम के मुताबिक, अपने नोड पर अपडेट यूटिलिटी चलाएं:
   > /opt/apigee/apigee-setup/bin/update.sh -ccomponent -f configFile
   
   कॉन्फ़िगरेशन फ़ाइल के लिए, सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल को "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.
   
   जिस कॉम्पोनेंट को अपडेट करना है उसके बारे में बताने के लिए, “-c” विकल्प का इस्तेमाल करें. संभावित कॉम्पोनेंट की सूची में ये चीज़ें शामिल हैं:
   ldap = OpenLDAP
   ldap = Cassandra
   ldap = ज़ूकीपर
   ldap = qpidd
   ldap = postgresql
   ldap =सभी Edge के कॉम्पोनेंट, QPID सर्वर के अलावा संदेश प्रोसेसर, रूटर, QPID के लिए
   
   
   
   
   
   ldap
8. इंस्टॉल की जांच करना सेक्शन में बताए गए तरीके से, मैनेजमेंट सर्वर पर apigee-Verify यूटिलिटी चलाकर अपडेट की जांच करें.

# 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"

# 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"