पोर्टल अपग्रेड करें

Edge for Private Cloud v4.19.01

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

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

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

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

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

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

• 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
• OPDK-17-09.x
• OPDK-18-01.x
• OPDK-18-05.x

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

http://yourportal.com/buildInfo

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

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

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

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

किसी नोड पर पोर्टल आरपीएम को अपडेट करने के लिए:

1. डिफ़ॉल्ट रूप से, Drupal डायरेक्ट्री /opt/apigee/apigee-drupal पर जाएं:

   cd /opt/apigee/apigee-drupal

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

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

   कहां:

   • devportal, डेटाबेस का नाम है, जैसा कि पोर्टल के इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में बताई गई PG_NAME प्रॉपर्टी में बताया गया है.
   • host_IP_address, पोर्टल नोड का आईपी पता है.
   • drupaladmin, 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.19.01 bootstrap_4.19.01.sh फ़ाइल को डाउनलोड करके, /tmp/bootstrap_4.19.01.sh पर डालें:

      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

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

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

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

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

9. इंटरनेट कनेक्शन के बिना सर्वर पर अपग्रेड करने के लिए:
   1. स्थानीय Apigee रिपॉज़िटरी बनाना में बताए गए तरीके के हिसाब से, 4.19.01 का लोकल रिपॉज़िटरी बनाएं.
   2. .tar फ़ाइल से apigee-service इंस्टॉल करने के लिए:
      1. लोकल रिपॉज़िटरी वाले नोड पर, लोकल रिपॉज़िटरी को /opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz नाम वाली एक .tar फ़ाइल में पैकेज करने के लिए, यह कमांड इस्तेमाल करें:

         /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

      2. .tar फ़ाइल को उस नोड पर कॉपी करें जहां आपको Edge अपडेट करना है. उदाहरण के लिए, इसे नए नोड पर /tmp डायरेक्ट्री में कॉपी करें.
      3. नए नोड पर, फ़ाइल को /tmp डायरेक्ट्री में अनटैग करें:

         tar -xzf apigee-4.19.01.tar.gz

         यह कमांड, .tar फ़ाइल वाली डायरेक्ट्री में repos नाम की एक नई डायरेक्ट्री बनाता है. उदाहरण के लिए, /tmp/repos.

      4. /tmp/repos से Edge apigee-service की यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:

         sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

         ध्यान दें कि इस कमांड में, रिपॉज़िटरी डायरेक्ट्री का पाथ शामिल किया गया है.

   3. Nginx वेब सर्वर का इस्तेमाल करके apigee-service इंस्टॉल करने के लिए:
      1. Edge apigee-setup टूल इंस्टॉल करें में, "Nginx वेब सर्वर का इस्तेमाल करके, रिपॉज़िटरी से इंस्टॉल करें" में बताए गए तरीके से Nginx वेब सर्वर को कॉन्फ़िगर करें.
      2. रिमोट नोड पर, Edge bootstrap_4.19.01.sh फ़ाइल को /tmp/bootstrap_4.19.01.sh पर डाउनलोड करें:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh
           -o /tmp/bootstrap_4.19.01.sh

         जहां uName और pWord, ऊपर दिए गए उपयोगकर्ता नाम और पासवर्ड हैं, जिन्हें आपने रेपो के लिए सेट किया है. साथ ही, remoteRepo, रेपो नोड का आईपी पता या डीएनएस नाम है.

      3. रिमोट नोड पर, Edge apigee-service यूटिलिटी और डिपेंडेंसी इंस्टॉल करें:

         sudo bash /tmp/bootstrap_4.19.01.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. पोर्टल को अपडेट करने के लिए, अपने नोड पर अपडेट की सुविधा को चलाएं:

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

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

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

    http://portal_IP_DNS:8079/update.php

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

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

/opt/apigee/apigee-drupal/wwwroot

अपग्रेड हो गया है. अगर Apigee की अपडेट करने वाली सुविधा ने Drupal के वर्शन को डाउनग्रेड कर दिया है, तो आपको Drupal की अपग्रेड करने वाली सुविधा को फिर से चलाना पड़ सकता है. ज़्यादा जानकारी के लिए, Drupal अपग्रेड को फिर से चलाना देखें.

Drupal को फिर से अपग्रेड करना

अगर Edge के लिए Private Cloud को अपग्रेड करने के लिए, Apigee अपडेट यूटिलिटी का इस्तेमाल किया जाता है, तो असल में आपके Drupal वर्शन को डाउनग्रेड किया जाता है, तो Drupal अपग्रेड को फिर से इंस्टॉल करें. ऐसा तब हो सकता है, जब आपने Private Cloud के अपडेट के बीच में सिर्फ़ Drupal को अपग्रेड किया हो.

उदाहरण के लिए:

1. आपके पास Edge for Private Cloud का वर्शन 4.18.05 था, जिसमें Drupal 7.59 शामिल था.
2. आपने सुरक्षा से जुड़े ज़रूरी अपडेट की वजह से, Drupal को 7.64 पर अपग्रेड किया है.
3. अब Private Cloud को 4.19.01 में अपग्रेड किया जा रहा है. इसमें Drupal 7.61 शामिल है.

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