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

פורטל השירותים למפתחים גרסה 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. בוחרים באפשרות Configuration (הגדרה) בתפריט Drupal (הגדרות אישיות).
   2. בדף Configuration (הגדרה) בוחרים באפשרות Wintenance mode (מצב תחזוקה) בקטע הודעת פתיחה.
   3. בוחרים את התיבה העברת האתר למצב תחזוקה.
   4. צריך להזין הודעה שהמשתמשים יראו במהלך פעולות תחזוקה.
   5. בוחרים באפשרות Save configuration (שמירת ההגדרות האישיות).
6. משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
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. מתקינים את Edge 4.17.09 apigee-service, ומתקינים את תוכנת העזר ואת יחסי התלות:

      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 מקומי" בהתקנת כלי השירות Edge apigee-setup.
   2. כדי להתקין את שירות API מקובץ .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

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

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

         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 הוא קובץ התצורה שבו השתמשתם כדי להתקין את הפורטל. הדרישה היחידה בקובץ התצורה היא שקובץ התצורה חייב להיות נגיש או קריא למשתמש ה-API.

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

    http://portalIP_DNS:8079/update.php

15. משביתים את Drupal למצב תחזוקה:
    1. בוחרים באפשרות Configuration (הגדרה) בתפריט Drupal (הגדרות אישיות).
    2. בדף Configuration (הגדרה) בוחרים באפשרות Wintenance mode (מצב תחזוקה) בקטע הודעת פתיחה.
    3. מבטלים את הבחירה בתיבה העברת האתר למצב תחזוקה.
    4. בוחרים באפשרות Save configuration (שמירת ההגדרות האישיות).

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

/opt/apigee/apigee-drupal/wwwroot

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