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

Developer Services पोर्टल वर्शन 4.17.09

इस प्रोसेस में, Apigee Developer Channel Services के मौजूदा ऑन-प्राइमिस इंस्टॉलेशन को अपग्रेड करने का तरीका बताया गया है.

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

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

• अगर आपके इंस्टॉलेशन में Nginx/Postgres का इस्तेमाल किया जाता है, तो यहां दिए गए RPM का इस्तेमाल करके पोर्टल को अपग्रेड करने का तरीका अपनाएं.
• अगर आपके इंस्टॉलेशन में Apache/MySQL या Apache/MariaDB का इस्तेमाल किया जाता है, तो tar-आधारित पोर्टल को RPM-आधारित पोर्टल में बदलना लेख पढ़ें.

आपके मौजूदा इंस्टॉलेशन टाइप का पता लगाना

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

• ls /opt

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

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

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

  Nginx/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 (Nginx) या /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 प्रॉपर्टी में बताया गया होता है.
   • आपसे Postgres उपयोगकर्ता का पासवर्ड मांगा जाएगा. यह पासवर्ड, पोर्टल के इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में बताई गई DRUPAL_PG_PASS प्रॉपर्टी के हिसाब से होना चाहिए.

   अगर आपको बाद में बैकअप से डेटा वापस लाना है, तो इस कमांड का इस्तेमाल करें:

   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-सेटअप यूटिलिटी इंस्टॉल करें में बताए गए तरीके से, 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. Edge apigee-service की यूटिलिटी और /tmp/repos से डिपेंडेंसी इंस्टॉल करें:

         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, रिपॉज़िटरी का उपयोगकर्ता नाम और पासवर्ड है.

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

अपग्रेड हो गया है.