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

Edge for Private Cloud v4.18.01

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

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

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

• अगर आपके इंस्टॉलेशन में 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
• OPDK-17-09.x

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

http://yourportal.com/buildInfo

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

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

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

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

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

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

   cd /opt/apigee/apigee-drupal

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, पोर्टल के इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में बताई गई 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-setup टूल इंस्टॉल करें में बताए गए तरीके से, SELinux को बंद करें.
7. /opt डायरेक्ट्री पर जाएं:

   > cd /opt

8. इंटरनेट कनेक्शन वाले सर्वर पर अपग्रेड करने के लिए:
   1. Edge 4.18.01 bootstrap_4.18.01.sh फ़ाइल को डाउनलोड करके, /tmp/bootstrap_4.18.01.sh पर डालें:

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

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

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

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

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

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

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

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

         tar -xzf apigee-4.18.01.tar.gz

         अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

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

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

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

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

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

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

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

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

         sudo bash /tmp/bootstrap_4.18.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. अपने Postgre नोड पर अपडेट उपयोगिता चलाएं:

    /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 db_upgrade

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

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