שדרוג הפורטל

Edge for Private Cloud גרסה 4.19.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
• OPDK-18-01.x
• OPDK-18-05.x

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

http://yourportal.com/buildInfo

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

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

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

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

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

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 היא כתובת ה-IP של צומת הפורטל.
   • ‫drupaladmin הוא שם המשתמש ב-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.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, תתבקשו להזין אותו.

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

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

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

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

         tar -xzf apigee-4.19.01.tar.gz

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

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

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

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

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

      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-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. מריצים את כלי העדכון בצומת כדי לעדכן את הפורטל:

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

    כאשר configFile הוא קובץ התצורה שבו השתמשתם כדי להתקין את הפורטל. הדרישה היחידה לגבי קובץ התצורה היא שמשתמש ה-"apigee" יוכל לגשת אליו או לקרוא אותו.

13. מריצים את הסקריפט update.php של Drupal על ידי פתיחת כתובת ה-URL הבאה בחלון דפדפן:

    http://portal_IP_DNS:8079/update.php

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

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

/opt/apigee/apigee-drupal/wwwroot

השדרוג הושלם. אם כלי העדכון של Apigee שדרג לאחור את גרסת Drupal, יכול להיות שתצטרכו להפעיל מחדש את כלי השדרוג של Drupal. מידע נוסף זמין במאמר הפעלה מחדש של השדרוג של Drupal.

מפעילים מחדש את השדרוג של Drupal.

אם הפעלתם את כלי העדכון של Apigee כדי לשדרג את Edge for Private Cloud, אבל בפועל גרסת Drupal שודרגה לאחור, תצטרכו להתקין מחדש את השדרוג של Drupal. יכול להיות שזה יקרה אם שדרגתם רק את Drupal בין עדכונים של ענן פרטי.

לדוגמה:

1. הפעלתם את גרסה 4.18.05 של Edge for Private Cloud, שכללה את Drupal 7.59.
2. שדרגתם את Drupal לגרסה 7.64 בגלל עדכון אבטחה נדרש.
3. עכשיו אתם משדרגים את הענן הפרטי לגרסה 4.19.01, שכוללת את Drupal 7.61.

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