Developers Services पोर्टल को अपग्रेड करना

डेवलपर सर्विस पोर्टल v. 4.17.09

इस प्रक्रिया में बताया गया है कि कंपनी की इमारत पर, मौजूदा Apigee डेवलपर चैनल सेवाएं को कैसे अपग्रेड किया जाए.

अपडेट करने की सही प्रक्रिया तय करना

पोर्टल को अपडेट करने के लिए इस्तेमाल की जाने वाली प्रोसेस, आपके मौजूदा इंस्टॉलेशन पर आधारित होती है:

• अगर ऐप्लिकेशन को इंस्टॉल करने के लिए Ngnx/Postgres का इस्तेमाल किया जाता है, तो नीचे दिए गए आरपीएम का इस्तेमाल करके, पोर्टल को अपग्रेड करें.
• अगर इंस्टॉल करने के दौरान Apache/MySQL या Apache/MariaDB का इस्तेमाल किया जाता है, तो टार पर आधारित पोर्टल को आरपीएम पर आधारित पोर्टल में बदलें.

यह पता लगाया जा सकता है कि आपका मौजूदा इंस्टॉल किस तरह का है

अगर आपको ऐप्लिकेशन इंस्टॉल करने के मौजूदा तरीके के बारे में पता नहीं है, तो इसे तय करने के लिए नीचे दिए गए निर्देश का इस्तेमाल करें:

• ls /opt

  अगर आपने Ngnx/Postgres का इस्तेमाल किया है, तो आपको ये डायरेक्ट्री दिखेंगी: /opt/apigee और /opt/nginx.

  अगर Apache/MySQL या Apache/MariaDB का इस्तेमाल किया जा रहा है, तो ये डायरेक्ट्री मौजूद नहीं होनी चाहिए.

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

  अगर Ngnx/Postgres का इस्तेमाल किया जा रहा है, तो आपको यह आउटपुट दिखेगा:

  + apigee-service
    apigee-drupal-devportal status
    OK: apigee-drupal-devportal is up and running
    + apigee-service apigee-lb status
    apigee-service: apigee-lb: OK
    + apigee-service apigee-postgresql status
    apigee-service: apigee-postgresql: OK

• apachectl -S

  अगर Apache/MySQL या Apache/MariaDB का इस्तेमाल किया जा रहा है, तो यह निर्देश, पोर्टल की रूट डायरेक्ट्री को इस फ़ॉर्म में दिखाएगा:

  *:80
    192.168.56.102
    (/etc/httpd/conf/vhosts/devportal.conf:1)

डिफ़ॉल्ट इंस्टॉलेशन डायरेक्ट्री

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

• 4.17.05 और उसके बाद के वर्शन: /opt/apigee/apigee-drupal/wwwroot
• 4.17.05 से पहले: /opt/apigee/apigee-drupal (Ngnx) या /var/www/html (Apache)

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

अपग्रेड के साथ काम करने वाले वर्शन

अपग्रेड की यह प्रक्रिया, पोर्टल के इन वर्शन के लिए काम करती है:

• OPDK-17-01.x
• OPDK-17-05.x

अपने पोर्टल का वर्शन पता करने के लिए, ब्राउज़र में यह यूआरएल खोलें:

http://your_portal.com/buildInfo

अपडेट करने से पहले

मौजूदा इंस्टॉलेशन के लिए, अगर आपने Drupal कोर में या कस्टम मॉड्यूल के किसी भी कोड में बदलाव किया है, तो वे बदलाव बदल जाएंगे. इसमें अन्य चीज़ों के अलावा, .htaccess में किए गए सभी बदलाव शामिल हैं. आपको यह मान लेना चाहिए कि /sites डायरेक्ट्री के बाहर की किसी भी चीज़ का मालिकाना हक Drupal के पास है. robots.txt इस नियम का अपवाद है. अगर यह फ़ाइल वेब रूट में मौजूद है, तो इसे आपके लिए सुरक्षित रखा जाएगा.

इंस्टॉल करने से पहले, अपनी पूरी Drupal वेब रूट डायरेक्ट्री का बैकअप बना लें. नीचे बताए गए इंस्टॉल करने के चरणों को पूरा करने के बाद, आपके पास बैकअप से अपनी पसंद के मुताबिक किए गए बदलाव वापस लाने का विकल्प होगा.

आरपीएम का इस्तेमाल करके पोर्टल को अपग्रेड करना

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

1. Drupal डायरेक्ट्री में बदलें. उदाहरण के लिए, /opt/apigee/apigee-drupal/wwwroot.

   cd /opt/apigee/apigee-drupal/wwwroot

   अपने प्रॉडक्ट वर्शन की डिफ़ॉल्ट डायरेक्ट्री के लिए, डिफ़ॉल्ट इंस्टॉलेशन डायरेक्ट्री देखें.

2. अपने Drupal डेटाबेस के इंस्टेंस का बैकअप लें. pg_dump कमांड, इस डेटाबेस की कॉपी बनाता है:
   

   pg_dump --dbname=devportal --host=192.168.56.101
     --username=drupaladmin --password --format=c > /tmp/portal.dmp

   कहां:

   • dbname, डेटाबेस के उस नाम के बारे में बताता है जो पोर्टल इंस्टॉलेशन की कॉन्फ़िगरेशन फ़ाइल में PG_NAME प्रॉपर्टी के ज़रिए बताया गया है.
   • host, पोर्टल नोड के आईपी पते के बारे में बताता है.
   • username, डेटाबेस को ऐक्सेस करने के लिए पोर्टल पर इस्तेमाल किए जाने वाले Postgres उपयोगकर्ता नाम के बारे में बताता है. यह जानकारी, पोर्टल इंस्टॉलेशन की कॉन्फ़िगरेशन फ़ाइल में दी गई DRUPAL_PG_USER प्रॉपर्टी के हिसाब से दी जाती है.
   • आपको पोर्टल इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में DRUPAL_PG_PASS प्रॉपर्टी के मुताबिक, Postgres उपयोगकर्ता पासवर्ड डालने के लिए कहा जाता है.

   अगर आपको बाद में बैकअप से रीस्टोर करना पड़े, तो आदेश का उपयोग करें:

   pg_restore --clean --dbname=devportal --host=localhost  --username=apigee < /tmp/portal.dmp

3. अपनी पूरी Drupal वेब रूट डायरेक्ट्री का बैकअप बनाएं. ऐप्लिकेशन को इंस्टॉल करने की डिफ़ॉल्ट जगह /opt/apigee/apigee-drupal होती है, लेकिन शायद आपने इसे बदल दिया हो.
   अगर आपको इस डायरेक्ट्री की जगह की जानकारी नहीं है, तो सार्वजनिक फ़ाइल सिस्टम और निजी फ़ाइल सिस्टम पाथ की जगह (अगले चरण के लिए) तय करने के लिए, drush status कमांड या Drupal मेन्यू में कॉन्फ़िगरेशन > मीडिया > फ़ाइल एंट्री का इस्तेमाल करें.
4. /opt/apigee/data/apigee-drupal-devportal/private में फ़ाइलों का बैकअप लें.
5. Drupal को रखरखाव मोड पर सेट करें:
   1. Drupal मेन्यू में कॉन्फ़िगरेशन चुनें.
   2. कॉन्फ़िगरेशन पेज पर, डेवलपमेंट में जाकर रखरखाव मोड को चुनें.
   3. साइट को रखरखाव मोड में रखें बॉक्स चुनें.
   4. ऐसा मैसेज डालें जो उपयोगकर्ताओं को रखरखाव के दौरान दिखे.
   5. कॉन्फ़िगरेशन सेव करें चुनें.
6. Edge apigee-setup यूटिलिटी इंस्टॉल करें में बताए गए तरीके से SELinux को बंद करें.
7. /opt डायरेक्ट्री में बदलें:

   cd /opt

8. इंटरनेट कनेक्शन वाले सर्वर पर अपग्रेड करने के लिए:
   1. 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

   2. Edge 4.17.09 apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:

      sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName
        apigeepassword=pWord

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

      डिफ़ॉल्ट रूप से, इंस्टॉलर यह जांच करता है कि आपके पास Java 1.8 इंस्टॉल है या नहीं. Java इंस्टॉल किए बिना जारी रखने के लिए, "C" विकल्प का इस्तेमाल करें.

9. बिना इंटरनेट कनेक्शन वाले सर्वर पर अपग्रेड करने के लिए:
   1. Edge apigee-setup उपयोगिता इंस्टॉल करें में "स्थानीय Apigee डेटा स्टोर करने की जगह बनाएं" में बताए गए तरीके से, स्थानीय 4.17.09 डेटा स्टोर करने की सुविधा बनाएं.
   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. Ngnx वेबसर्वर का इस्तेमाल करके, apigee-सेवा इंस्टॉल करने के लिए:
      1. Edge apigee-setup उपयोगिता में "Nlinx वेबसर्वर का इस्तेमाल करके रेपो से इंस्टॉल करें" में बताए गए तरीके से Nlinx वेब सर्वर को कॉन्फ़िगर करें.
      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 डेटा स्टोर करने की जगह का उपयोगकर्ता नाम और पासवर्ड है.

10. apigee-setup सुविधा को अपडेट करने के लिए apigee-service का इस्तेमाल करें:

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. Postgres डेटाबेस को अपडेट करने के लिए, अपने नोड पर अपडेट यूटिलिटी चलाएं:
    

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    यहां configFile वह कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने Postgres डेटाबेस को इंस्टॉल करने के लिए किया था. कॉन्फ़िगरेशन फ़ाइल के लिए, सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.

12. Postgres शुरू करें:
    

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start

13. पोर्टल को अपडेट करने के लिए, अपने नोड पर अपडेट यूटिलिटी चलाएं:

    /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

14. इस यूआरएल को ब्राउज़र विंडो में खोलकर, Drupal की update.php स्क्रिप्ट चलाएं:

    http://portalIP_DNS:8079/update.php

15. Drupal को रखरखाव मोड में बंद करें:
    1. Drupal मेन्यू में कॉन्फ़िगरेशन चुनें.
    2. कॉन्फ़िगरेशन पेज पर, डेवलपमेंट में जाकर रखरखाव मोड को चुनें.
    3. साइट को रखरखाव मोड में रखें बॉक्स से चुने हुए का निशान हटाएं.
    4. कॉन्फ़िगरेशन सेव करें चुनें.

ध्यान दें कि अपडेट के बाद रूट डायरेक्ट्री:

/opt/apigee/apigee-drupal/wwwroot

अपग्रेड की प्रोसेस पूरी हो गई.