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

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

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

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

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

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

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

  • 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-dअपal-devपोर्टल स्थिति
    ठीक है: apigee-dripal-devपोर्टल स्थिति ठीक है: apigee-drapal-devपोर्टल स्टेटस चालू है
    + apigee-drapal-devport


  • PAchectl -S
    अगर Apache/MySQL या Apache/MariaDB का इस्तेमाल किया जा रहा है, तो इस निर्देश को पोर्टल की रूट डायरेक्ट्री इस रूप में मिलनी चाहिए:

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

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

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

  • /opt/apigee/apigee-drupal (Ngnx)
  • /var/www/html (Apache)

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

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

नई डिफ़ॉल्ट इंस्टॉलेशन डायरेक्ट्री, नए 4.17.01 इंस्टॉलेशन से Nkinx/Postgres को अपडेट करने के बाद

Nlinx/Postgres का इस्तेमाल करने वाले 4.17.01 के नए इंस्टॉलेशन को अपडेट करने के बाद, रूट डायरेक्ट्री इससे बदल गई है:

/opt/apigee/apigee-drupal

इससे बदलें:

/opt/apigee/apigee-drupal/wwwroot

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

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

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • Pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x
  • OPDK-17-01.x

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

http://yourportal.com/buildInfo

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

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

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

.tar फ़ाइल का इस्तेमाल करके पोर्टल को अपग्रेड करना

  1. अपने Drupal MySQL/MariaDB इंस्टेंस का बैकअप लें.
    ज़्यादा जानकारी के लिए, http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/ देखें
    1. पहला विकल्प: Drush का इस्तेमाल करें

      Drush कमांड sql-dump डेटाबेस की कॉपी बनाता है. अपनी Drupal डायरेक्ट्री में, डिफ़ॉल्ट रूप से /var/www/html पर जाकर, निर्देश चलाएं:
      > drush sql-dump > /path/to/backup_der/database-backup.sql

      ज़्यादा जानकारी के लिए, drush help sql-dump का इस्तेमाल करें.
    2. दूसरा विकल्प: MySQLdump का इस्तेमाल करें
      डेटाबेस की कॉपी बनाने के लिए, mysqldump कमांड का इस्तेमाल करें:
      mysqldump -u USERNAME -p'पासवर्ड' DATABASENAME > /path/to/backup_der/database-backup.sql
      में, पासवर्ड-पी के लिए कोई स्पेस नहीं होना चाहिए.
      अगर पासवर्ड में खास वर्ण हैं, तो पासवर्ड के लिए सिंगल कोट देना ज़रूरी है.

      आपने पोर्टल इंस्टॉल करते समय, उपयोगकर्ता नाम और DATABASENAME सेट किए हैं. डिफ़ॉल्ट रूप से, दोनों devपोर्टल होते हैं.
  2. अपनी पूरी Drupal वेब रूट डायरेक्ट्री का बैकअप बनाएं. इंस्टॉल करने की डिफ़ॉल्ट जगह /var/www/html है, लेकिन हो सकता है कि आपने इंस्टॉल के समय इसे बदल दिया हो.
  3. ftp.apigee.com से डेवलपर चैनल सेवाएं DeveloperServices_x.y.z.tar फ़ाइल डाउनलोड करें. यहां x.y.z पोर्टल का वर्शन नंबर होता है. जब कहा जाए, तब Apigee से मिले क्रेडेंशियल डालें.

    Apigee से आपको भेजे गए लिंक से, किसी ब्राउज़र में फ़ाइल डाउनलोड की जा सकती है. फ़ाइल को कॉपी करके फिर उसे यहां दिए गए cURL कमांड में जोड़कर डाउनलोड किया जा सकता है:
    > curl -kOL <paste link here>

    ध्यान दें: अगर आपका पोर्टल किसी ऐसे सर्वर पर है जिसके पास कोई बाहरी इंटरनेट कनेक्शन नहीं है, तो ऐक्सेस वाले सर्वर पर यह चरण पूरा करें.

    Apigee Edge की सहायता टीम पर जाएं और .tar फ़ाइल को अपग्रेड करने का अनुरोध करने के लिए, अपने सहायता पोर्टल में लॉगिन करें चुनें. अगर आपके पास सहायता पोर्टल पर कोई खाता नहीं है, तो अपने सहायता पोर्टल में लॉगिन करें चुनें. इसके बाद, साइन इन पेज पर जल्दी हैं? सहायता टिकट यहां दिखाएं.
  4. इंटरनेट कनेक्शन वाले सर्वर पर अपग्रेड करने के लिए:
    1. पोर्टल अपग्रेड फ़ाइल निकालें:
      > tar -xvf <tar file>

      इस निर्देश से एक नई डायरेक्ट्री बनाई जाती है, जिसे DeveloperServices-4.x.y.z कहा जाता है.
    2. DeveloperServices-4.x.y.z डायरेक्ट्री में बदलें.
    3. नीचे दिए गए निर्देश का इस्तेमाल करके, Drupal का नया वर्शन डाउनलोड करें:
      > drush dl drual

      यह निर्देश, drual-x.y नाम की डायरेक्ट्री बनाता है. इसमें x.y, Drupal के मौजूदा वर्शन से मेल खाता है.
    4. networked-update.sh स्क्रिप्ट चलाएं:
      > ./networked-update.sh

      फ़ाइल से जुड़ी अनुमतियों के आधार पर, हो सकता है कि आपको इस निर्देश को चलाने के लिए sudo का इस्तेमाल करना पड़े या इसे एडमिन के तौर पर चलाना पड़े.
    5. Drupal से जुड़े अपडेट की सूचनाएं पाने के लिए, पक्का करें कि Drupal अपडेट मैनेजर मॉड्यूल चालू हो. Drupal मेन्यू में जाकर, मॉड्यूल चुनें. इसके बाद, नीचे की ओर स्क्रोल करके, Update Manager मॉड्यूल पर जाएं. अगर यह सुविधा चालू नहीं है, तो इसे चालू करें.

      चालू करने के बाद, रिपोर्ट > उपलब्ध अपडेट मेन्यू आइटम का इस्तेमाल करके, उपलब्ध अपडेट देखे जा सकते हैं.

      रिपोर्ट > उपलब्ध अपडेट > सेटिंग मेन्यू आइटम का इस्तेमाल करके मॉड्यूल कॉन्फ़िगर करें, ताकि अपडेट उपलब्ध होने पर आपको ईमेल किया जा सके. साथ ही, अपडेट देखने की फ़्रीक्वेंसी सेट करें.
  5. बिना इंटरनेट कनेक्शन वाले सर्वर पर अपग्रेड करने के लिए:
    1. जिस सर्वर से आपने Developer Channel Services DeveloperServices_x.y.z.tar फ़ाइल डाउनलोड की है उस पर पोर्टल अपग्रेड फ़ाइल निकालें:
      > tar -xvf <tar file>

      यह निर्देश एक नई डायरेक्ट्री बनाता है, जिसका नाम DeveloperServices-4.x.y.z होता है.
    2. DeveloperServices-4.x.y.z डायरेक्ट्री में बदलें.
    3. non-networked-update.sh स्क्रिप्ट चलाएं:
      > ./non-networked-update.sh

      फ़ाइल से जुड़ी अनुमतियों के आधार पर, हो सकता है कि आपको इस निर्देश को चलाने के लिए sudo का इस्तेमाल करना पड़े या इसे एडमिन के तौर पर चलाना पड़े.

      यह निर्देश सभी ज़रूरी अपडेट फ़ाइलों को डाउनलोड करता है और उन्हें devportal-update.tgz नाम की एक फ़ाइल में पैकेज करता है. साथ ही, उस फ़ाइल को आपकी पसंद की जगह पर सेव करता है.
    4. devportal-update.tgz को उस टारगेट सर्वर पर कॉपी करें जिस पर पोर्टल चल रहा है.
      ध्यान दें: टारगेट सर्वर के वेब रूट में devportal-update.tgz को कॉपी न करें.
    5. devportal-update.tgz फ़ाइल को मौजूदा डायरेक्ट्री से अनटार करें:
      > tar -xzf /path/to/devDL-update.tgz
    6. डेवलपर-अपडेट डायरेक्ट्री में बदलें.
    7. अपडेट को इंस्टॉल करने के लिए, इस कमांड को चलाएं:
      > ./install-update.sh
    8. सवालों के जवाब दें.

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

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

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

  1. डिफ़ॉल्ट रूप से, Drupal की डायरेक्ट्री /opt/apigee/apigee-drupal में बदलें:
    > cd /opt/apigee/apigee-drpal
  2. अपने Drupal डेटाबेस के इंस्टेंस का बैकअप लें. pg_dump कमांड, इस डेटाबेस की कॉपी बनाता है:

    pg_dump --dbname=devDL --host=192.168.56.101 --username=dअपaladmin --password --format=c > /tmp/DL.dmp
      यहां:
    • dbname, डेटाबेस के उस नाम के बारे में बताता है जिसके बारे में पोर्टल इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में PG_NAME प्रॉपर्टी में बताया गया है.
    • host, पोर्टल नोड के आईपी पते के बारे में बताता है.
    • उपयोगकर्ता नाम से, डेटा बेस को ऐक्सेस करने के लिए पोर्टल पर इस्तेमाल होने वाले Postgres उपयोगकर्ता नाम के बारे में बताया जाता है. पोर्टल इंस्टॉलेशन की कॉन्फ़िगरेशन फ़ाइल में, DRUPAL_PG_USER प्रॉपर्टी के ज़रिए बताया गया है.
    • आपको पोर्टल इंस्टॉलेशन की कॉन्फ़िगरेशन फ़ाइल में, DRUPAL_PG_PASS प्रॉपर्टी की मदद से बताया गया Postgres उपयोगकर्ता पासवर्ड डालने के लिए कहा जाता है.

    अगर आपको बाद में डेटा को बैकअप से वापस लाना पड़े, तो इस निर्देश का इस्तेमाल करें:
    pg_restore --clean --dbname=devपोर्टल --host=localhost --username=apigee < /tmp/DL.dmp
  3. अपनी पूरी Drupal वेब रूट डायरेक्ट्री का बैकअप बनाएं. ऐप्लिकेशन को इंस्टॉल करने की डिफ़ॉल्ट जगह /opt/apigee/apigee-drupal होती है, लेकिन शायद आपने इसे बदल दिया हो.

    अगर आपको इस डायरेक्ट्री की जगह की जानकारी नहीं है, तो सार्वजनिक फ़ाइल सिस्टम और निजी फ़ाइल सिस्टम पाथ की जगह (अगले चरण के लिए) तय करने के लिए, ड्रश स्टेटस कमांड या Drupal मेन्यू में कॉन्फ़िगरेशन > मीडिया > फ़ाइल एंट्री का इस्तेमाल करें.
  4. /opt/apigee/data/apigee-drupal-devportal/private में फ़ाइलों का बैकअप लें.
  5. Edge apigee-setup उपयोगिता इंस्टॉल करें में बताए गए तरीके से SELinux को बंद करें.
  6. इंटरनेट कनेक्शन वाले सर्वर पर अपग्रेड करने के लिए:
    1. /tmp/bootstrap_4.17.05.sh:
      > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/sh.boot7.0 पर Edge 4.17.05 bootstrap_4.17.05.sh फ़ाइल डाउनलोड करें
    2. Edge 4.17.05 apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord जहां uName:pWorde, आपको उपयोगकर्ता नाम और पासवर्ड मिला है.

      pWord को छोड़ने पर, आपको इसे डालने के लिए कहा जाएगा.

      डिफ़ॉल्ट रूप से, इंस्टॉलर यह जांच करता है कि आपके पास Java 1.8 इंस्टॉल है या नहीं. Java इंस्टॉल किए बिना जारी रखने के लिए, "C" विकल्प का इस्तेमाल करें.
  7. बिना इंटरनेट कनेक्शन वाले सर्वर पर अपग्रेड करने के लिए:
    1. Edge apigee-setup उपयोगिता इंस्टॉल करें में "स्थानीय Apigee डेटा स्टोर करने की जगह बनाएं" में बताए गए तरीके से, स्थानीय 4.17.05 डेटा स्टोर करने की सुविधा बनाएं.
      ध्यान दें: अगर आपके पास पहले से ही 4.17.01 रेपो है, तो Edge apigee-setup उपयोगिता इंस्टॉल करें पर "स्थानीय Apigee डेटा स्टोर करने की जगह अपडेट करें" में बताए गए तरीके से, 4.17.05 रेपो जोड़ा जा सकता है.
    2. .tar फ़ाइल से apigee-service इंस्टॉल करने के लिए:
      1. लोकल रेपो वाले नोड पर, नीचे दिए गए कमांड का इस्तेमाल करके, लोकल रेपो को /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz नाम वाली एक.tar फ़ाइल में पैकेज करें:
        > /opt/apigee/apigee-service/bin/apigee-mir-service apige
      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. Ngnx वेबसर्वर का इस्तेमाल करके, apigee-सेवा इंस्टॉल करने के लिए:
      1. Edge apigee-setup उपयोगिता में "Nlinx वेबसर्वर का इस्तेमाल करके रेपो से इंस्टॉल करें" में बताए गए तरीके से Nlinx वेब सर्वर को कॉन्फ़िगर करें.
      2. रिमोट नोड पर, /tmp/bootstrap_4.17.05.sh के लिए Edge bootstrap_4.17.05.sh फ़ाइल डाउनलोड करें. यह ईमेल पता bootstrap_4.17.05.sh है.17.05.sh:
        > /usr/bin/curl http://uName:pWord.@remoteRepo. 3939/boot.5...3.4.
      3. रिमोट नोड पर, Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:
        > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=protocolName

  8. apigee-setup यूटिलिटी को अपडेट करने के लिए, apigee-service का इस्तेमाल करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup अपडेट
  9. Postgres डेटाबेस को अपडेट करने के लिए, अपने नोड पर अपडेट यूटिलिटी चलाएं:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    यहां configFile वह कॉन्फ़िगरेशन फ़ाइल है जिसका इस्तेमाल आपने Postgres डेटाबेस को इंस्टॉल करने के लिए किया था. कॉन्फ़िगरेशन फ़ाइल के लिए, सिर्फ़ यह ज़रूरी है कि कॉन्फ़िगरेशन फ़ाइल ऐसी होनी चाहिए जिसे "apigee" उपयोगकर्ता ऐक्सेस कर सके या पढ़ सके.
  10. Postgres शुरू करें:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  11. पोर्टल को अपडेट करने के लिए, अपने नोड पर अपडेट यूटिलिटी चलाएं:
    > /opt/apigee/apigee-setup/bin/update.sh -c dp -f configFile

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

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

/opt/apigee/apigee-drupal/wwwroot

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