שדרוג הפורטל של השירותים למפתחים

Developer Services Portal v. 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

כדי לזהות את גרסת הפורטל, פותחים את כתובת ה-URL הבאה בדפדפן:

http://your_portal.com/buildInfo

לפני שמעדכנים

אם שיניתם קוד כלשהו בליבה של Drupal או במודולים לא מותאמים אישית, השינויים יוחלפו. זה כולל, בין היתר, שינויים שביצעת ב-.htaccess. כדאי להניח שכל מה שנמצא מחוץ לספרייה /sites נמצא בבעלות Drupal. החריג היחיד לכלל הזה הוא robots.txt. אם הקובץ הזה קיים בתיקיית השורש של האתר, הוא יישמר.

לפני שמתחילים בהתקנה, צריך לגבות את כל תיקיית השורש של Drupal. אחרי שתבצעו את שלבי ההתקנה שמתוארים בהמשך, תוכלו לשחזר את ההתאמות האישיות מהגיבוי.

שדרוג פורטל באמצעות RPM

כדי לעדכן את ה-RPM של הפורטל בצומת:

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 מציין את כתובת ה-IP של צומת הפורטל.
   • ‫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 או בערך Configuration > Media > File בתפריט של Drupal כדי לזהות את המיקום של מערכת הקבצים הציבורית ואת הנתיב של מערכת הקבצים הפרטית (לשלב הבא).
4. מגבים את הקבצים ב-/opt/apigee/data/apigee-drupal-devportal/private.
5. מגדירים את Drupal למצב תחזוקה:
   1. בתפריט של Drupal, לוחצים על Configuration (הגדרה).
   2. בדף Configuration, בוחרים באפשרות Maintenance mode בקטע Development.
   3. מסמנים את התיבה העברת האתר למצב תחזוקה.
   4. מזינים הודעה שהמשתמשים יראו במהלך התחזוקה.
   5. לוחצים על שמירת ההגדרה.
6. משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
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. מתקינים את כלי השירות apigee-service של Edge 4.17.09 ואת יחסי התלות:

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

      כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.
      

      כברירת מחדל, מנהל ההתקנה בודק אם מותקנת גרסה 1.8 של Java. אפשר להשתמש באפשרות "C" כדי להמשיך בלי להתקין את Java.

9. כדי לשדרג בשרת ללא חיבור לאינטרנט:
   1. יוצרים מאגר מקומי בגרסה 4.17.09, כמו שמתואר בקטע "יצירת מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
   2. כדי להתקין את apigee-service מקובץ ‎ .tar:
      1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ ‎ .tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:

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

      2. מעתיקים את קובץ ה-‎ .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה ‎/tmp בצומת החדש.
      3. בצומת החדש, מבטלים את הדחיסה של הקובץ לספרייה ‎ /tmp:
         

         tar -xzf apigee-4.17.09.tar.gz

         הפקודה הזו יוצרת ספרייה חדשה בשם repos, בספרייה שמכילה את קובץ ה-‎ .tar. לדוגמה, ‎ /tmp/repos.

      4. מתקינים את כלי השירות של Edge apigee-service ואת יחסי התלות מ-/tmp/repos:

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

         שימו לב שהפקודה הזו כוללת את הנתיב לספריית המאגרים.

   3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
      1. מגדירים את שרת האינטרנט Nginx כמו שמתואר בקטע "התקנה מהמאגר באמצעות שרת האינטרנט Nginx" במאמר התקנת כלי השירות apigee-setup של Edge.
      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 היא כתובת ה-IP או שם ה-DNS של צומת המאגר.

      3. בצומת המרוחק, מתקינים את כלי השירות של Edge apigee-service ואת יחסי התלות:code

         sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939
           apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.

10. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:

    /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. מריצים את הסקריפט update.php של Drupal על ידי פתיחת כתובת ה-URL הבאה בחלון דפדפן:

    http://portalIP_DNS:8079/update.php

15. משביתים את Drupal למצב תחזוקה:
    1. בתפריט של Drupal, לוחצים על Configuration (הגדרה).
    2. בדף Configuration, בוחרים באפשרות Maintenance mode בקטע Development.
    3. מבטלים את הסימון של התיבה Put site into maintenance mode (העברת האתר למצב תחזוקה).
    4. לוחצים על שמירת ההגדרה.

שימו לב שתיקיית השורש אחרי העדכון היא:

/opt/apigee/apigee-drupal/wwwroot

השדרוג הושלם.