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

פורטל השירותים למפתחים בגרסה 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 Core או במודולים שלא מותאמים אישית, השינויים יוחלפו. בין היתר, השינויים האלה כוללים שינויים שביצעתם ב-.htaccess. צריך להניח שכל דבר מחוץ לספרייה /sites הוא בבעלות Drupal. robots.txt הוא יוצא מן הכלל. אם הקובץ הזה קיים בספריית השורש של האתר, הוא יישמר.

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

שדרוג פורטל באמצעות הכנסה לאלף צפיות

כדי לעדכן את ה-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. בוחרים באפשרות Save configuration.
6. משביתים את SELinux כפי שמתואר במאמר התקנת הכלי apigee-setup ב-Edge.
7. עוברים לספרייה /opt:

   cd /opt

8. לשדרוג בשרת עם חיבור לאינטרנט:
   1. מורידים את הקובץ bootstrap_4.17.09.sh של Edge 4.17.09 אל /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, תופיע בקשה להזין אותו.
      

      כברירת מחדל, מנהל ההתקנה בודק אם Java 1.8 מותקנת. אפשר להשתמש באפשרות '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. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות מ-/tmp/repos:

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

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

   3. כדי להתקין את שירות apigee באמצעות שרת האינטרנט Nginx:
      1. מגדירים את שרת האינטרנט Nginx כפי שמתואר בקטע 'התקנה מהמאגר באמצעות שרת האינטרנט Nginx' במאמר התקנה של הכלי apigee-setup ל-Edge.
      2. בצומת המרוחק, מורידים את הקובץ bootstrap_4.17.09.sh של Edge אל /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. בצומת המרוחק, מתקינים את הכלי apigee-service של Edge ואת ה-dependencies: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. מבטלים את הסימון של התיבה העברת האתר למצב תחזוקה.
    4. בוחרים באפשרות Save configuration.

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

/opt/apigee/apigee-drupal/wwwroot

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