שדרוג הפורטל

Edge for Private Cloud v4.18.05

כאן מוסבר איך לשדרג התקנה מקומית של פורטל Apigee Developer Services (או פשוט הפורטל) שכבר קיים.

איך קובעים את תהליך העדכון הנכון

ההליך לעדכון הפורטל מבוסס על ההתקנה הנוכחית שלכם:

איך בודקים איזה סוג התקנה יש לכם?

אם אתם לא בטוחים מהו סוג ההתקנה הנוכחי, תוכלו להשתמש בפקודה הבאה כדי לבדוק זאת:

  • 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

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

http://yourportal.com/buildInfo

לפני העדכון

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

לפני שממשיכים בתהליך ההתקנה, צריך ליצור גיבוי של כל הספרייה ברמה הבסיסית של האתר ב-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. בוחרים באפשרות Save configuration.
  6. משביתים את SELinux כפי שמתואר במאמר התקנת הכלי apigee-setup ב-Edge.
  7. עוברים לספרייה /opt: 
    cd /opt
  8. לשדרוג בשרת עם חיבור לאינטרנט:
    1. מורידים את קובץ Edge 4.18.05 bootstrap_4.18.05.sh אל /tmp/bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
    2. מתקינים את השירות apigee-service ואת יחסי התלות שלו ב-Edge 4.18.05: 
      sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

      כאשר uName ו-pWord הם שם המשתמש והסיסמה שקיבלת מ-Apigee. אם משמיטים את pWord, תופיע בקשה להזין אותו.

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

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

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

      4. מתקינים את כלי השירות apigee-service ואת יחסי התלות מ-/tmp/repos: 
        sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

    3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
      1. מגדירים את שרת האינטרנט Nginx כפי שמתואר בקטע 'התקנה מהמאגר באמצעות שרת האינטרנט Nginx' במאמר התקנה של הכלי apigee-setup ל-Edge.
      2. בצומת המרוחק, מורידים את קובץ Edge bootstrap_4.18.05.sh אל /tmp/bootstrap_4.18.05.sh: 
        /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh
  -o /tmp/bootstrap_4.18.05.sh

        כאשר uName ו-pWord הם שם המשתמש והסיסמה שהגדרתם למאגר למעלה, ו-remoteRepo היא כתובת ה-IP או שם ה-DNS של צומת המאגר.

      3. בצומת המרוחק, מתקינים את השירות apigee-service של Edge ואת יחסי התלות שלו: 
        sudo bash /tmp/bootstrap_4.18.05.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. מריצים את כלי העדכון בצומת 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. מריצים את הסקריפט update.php של Drupal על ידי פתיחת כתובת ה-URL הבאה בחלון דפדפן: 
    http://portal_IP_DNS:8079/update.php
  15. משביתים את Drupal למצב תחזוקה:
    1. בוחרים באפשרות Configuration (הגדרה) בתפריט Drupal.
    2. בדף Configuration, בוחרים באפשרות Maintenance mode בקטע Development.
    3. מבטלים את הסימון של התיבה העברת האתר למצב תחזוקה.
    4. בוחרים באפשרות Save configuration.

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

/opt/apigee/apigee-drupal/wwwroot

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