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

Edge for Private Cloud v4.18.01

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

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

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

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

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

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

• 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)

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

इस्तेमाल किए जा सकने वाले अपग्रेड वर्शन

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

• ओपीडीके-17-01.x
• ओपीडीके-17-05.x
• ओपीडीके-17-09.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=192.168.56.101 --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   कहां:

   • dbname, डेटाबेस का नाम बताता है जो पोर्टल इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में PG_NAME प्रॉपर्टी.
   • host, पोर्टल नोड का आईपी पता बताता है.
   • username तय करता है डेटा बेस को ऐक्सेस करने के लिए पोर्टल, Postgres का इस्तेमाल करता है पोर्टल इंस्टॉलेशन कॉन्फ़िगरेशन फ़ाइल में DRUPAL_PG_USER प्रॉपर्टी.
   • आपको पोर्टल इंस्टॉलेशन की कॉन्फ़िगरेशन फ़ाइल में 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. इसमें बताए गए तरीके से SELinux को बंद करें Edge apigee-setup सुविधा इंस्टॉल करें.
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. "स्थानीय Apigee डेटा स्टोर करने की जगह बनाएं" में बताए गए तरीके से, लोकल 4.18.01 रेपो बनाएं पर Edge इंस्टॉल करें apigee-setup उपयोगिता.
   2. .tar फ़ाइल से apigee-service इंस्टॉल करने के लिए:
      1. लोकल रेपो वाले नोड पर, लोकल स्टोर करने की जगह को पैकेज करने के लिए नीचे दिए गए कमांड का इस्तेमाल करें इसे एक ही .tar फ़ाइल में, फिर से सेव करें /opt/apigee/data/apigee-mirror/apigee-4.18.01.tar.gz:

          /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. Nginx वेब सर्वर को कॉन्फ़िगर करने के लिए " Nginx वेबसर्वर" Edge इंस्टॉल करें apigee-setup उपयोगिता.
      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

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