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

Edge for Private Cloud v4.18.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

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

http://yourportal.com/buildInfo

לפני העדכון

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

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

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

כדי לעדכן את ההכנסה לאלף צפיות (RPM) בפורטל בצומת:

1. עוברים לספריית Drupal, /opt/apigee/apigee-drupal כברירת מחדל:

   cd /opt/apigee/apigee-drupal

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

   > cd /opt

8. כדי לשדרג בשרת עם חיבור לאינטרנט:
   1. מורידים את קובץ Edge 4.18.01 bootstrap_4.18.01.sh אל /tmp/bootstrap_4.18.01.sh:

      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh

   2. מתקינים את הכלי ואת יחסי התלות apigee-service של Edge 4.18.01:

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

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

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

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

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

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

         tar -xzf apigee-4.18.01.tar.gz

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

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

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

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

   3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
      1. מגדירים את שרת האינטרנט Nginx כפי שמתואר בקטע 'התקנה מהמאגר באמצעות שרת האינטרנט Nginx בדף Install the Edge הכלי apigee-setup.
      2. בצומת המרוחק, מורידים את הקובץ bootstrap_4.18.01.sh של Edge אל /tmp/bootstrap_4.18.01.sh:

         /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.01.sh
           -o /tmp/bootstrap_4.18.01.sh

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

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

         sudo bash /tmp/bootstrap_4.18.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. מריצים את כלי העדכון בצומת 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://portalIP_DNS:8079/update.php

15. משביתים את Drupal למצב תחזוקה:
    1. בתפריט Drupal, בוחרים באפשרות Configuration.
    2. בדף Configuration, בוחרים באפשרות Maintenance mode בקטע Development.
    3. מבטלים את סימון התיבה העברת האתר למצב תחזוקה.
    4. בוחרים באפשרות Save configuration.

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

/opt/apigee/apigee-drupal/wwwroot

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