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

Developer Services Portal v. 4.17.01

כאן מוסבר איך לשדרג התקנה מקומית קיימת של Apigee Developer Channel Services.

ספריית ברירת המחדל להתקנה

תהליך השדרוג מניח שפורטל המפתחים הותקן ב-/var/www/html. אם לא התקנתם את הפורטל בספריית ברירת המחדל, שנו את הנתיבים בתהליך הבא כדי להשתמש בספריית ההתקנה שלכם.

אם אתם לא יודעים מהי ספריית ההתקנה, אתם יכולים לזהות אותה כפי שמתואר בקטע פקודות Drush נפוצות.

גרסאות שדרוג נתמכות

תהליך השדרוג הזה נתמך בגרסאות הבאות של הפורטל:

  • pantheon-14.02.x
  • pantheon-14.03.x
  • pantheon-14.04.x
  • pantheon-14.07.x
  • pantheon-15-01.x
  • OPDK-15-04.x
  • OPDK-15-07.x
  • OPDK-16-01.x
  • OPDK-16-05.x
  • OPDK-16-09.x

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

http://yourportal.com/buildInfo

לפני ההתקנה

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

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

שדרוג של Apigee Developer Channel Services לגרסה חדשה

  1. גיבוי של מכונת Drupal MySQL.
    מידע נוסף זמין בכתובת http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. אפשרות 1: שימוש ב-Drush

      הפקודה sql-dump ב-Drush יוצרת עותק של מסד הנתונים. מספריית Drupal, כברירת מחדל ‎/var/www/html, מריצים את הפקודה:
      ‎> drush sql-dump > /path/to/backup_dir/database-backup.sql

      אפשר להשתמש ב-drush help sql-dump כדי לקבל מידע נוסף.
    2. אפשרות 2: שימוש ב-MySQLdump
      משתמשים בפקודה mysqldump כדי ליצור עותק של מסד הנתונים:
      mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql

      לא אמור להיות רווח בין האפשרות ‎-p לבין הסיסמה. אם הסיסמה מכילה תווים מיוחדים, צריך להקיף אותה בגרש בודד.

      הגדרתם את USERNAME ואת DATABASENAME כשהתקנתם את הפורטל. כברירת מחדל, שניהם devportal.
  2. יוצרים גיבוי של כל תיקיית השורש של Drupal באינטרנט. מיקום ההתקנה שמוגדר כברירת מחדל הוא /var/www/html, אבל יכול להיות ששיניתם אותו בזמן ההתקנה.
  3. מורידים את הקובץ DeveloperServices_x.y.z.tar של Developer Channel Services מ-ftp.apigee.com, כאשר x.y.z תואם למספר הגרסה של הפורטל. כשמוצגת בקשה, מזינים את פרטי הכניסה שקיבלתם מ-Apigee.

    אפשר להוריד קובץ מהקישור שנשלח אליכם על ידי Apigee בדפדפן או על ידי העתקה שלו ואז הוספה שלו לפקודת ה-cURL הבאה:
    > curl -kOL <paste link here>

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

    נכנסים לכתובת http://community.apigee.com/content/apigee-customer-support ובוחרים באפשרות Login to your Support Portal כדי לבקש את קובץ ה-‎ .tar לשדרוג של Developer Channel Services. אם אין לכם חשבון בפורטל התמיכה, לחצו על Login to your Support Portal ובדף הכניסה לחצו על In a hurry? אפשר לפתוח כרטיס תמיכה כאן.
  4. כדי לשדרג בשרת עם חיבור לאינטרנט:
    1. מחלצים את קובץ השדרוג של הפורטל:
      > tar -xvf <tar file>

      הפקודה הזו יוצרת ספרייה חדשה בשם DeveloperServices-4.x.y.z.
    2. עוברים לספרייה DeveloperServices-4.x.y.z.
    3. מורידים את הגרסה העדכנית של Drupal באמצעות הפקודה הבאה:
      > drush dl drupal

      הפקודה הזו יוצרת ספרייה בשם drupal-x.y, כאשר x.y תואם לגרסה הנוכחית של Drupal.
    4. מריצים את הסקריפט networked-update.sh:
      > ./networked-update.sh

      בהתאם להרשאות לקבצים, יכול להיות שתצטרכו להשתמש ב-sudo כדי להריץ את הפקודה הזו, או להריץ אותה כאדמינים.
    5. כדי לקבל התראות על עדכונים של Drupal, צריך לוודא שהמודול Drupal Update manager מופעל. בתפריט של Drupal, בוחרים באפשרות Modules (מודולים) וגוללים למטה למודול Update manager (מנהל העדכונים). אם הוא לא מופעל, מפעילים אותו.

      אחרי ההפעלה, אפשר לראות את העדכונים הזמינים דרך פריט התפריט דוחות > עדכונים זמינים.

      משתמשים בפריט התפריט Reports > Available Updates > Settings כדי להגדיר את המודול כך שישלח לכם אימייל כשיש עדכונים זמינים, וכדי להגדיר את תדירות הבדיקה של עדכונים.
  5. כדי לשדרג בשרת ללא חיבור לאינטרנט:
    1. בשרת שבו הורדתם את קובץ DeveloperServices_x.y.z.tar של Developer Channel Services, מחלצים את קובץ השדרוג של הפורטל:
      > tar -xvf <tar file>

      הפקודה הזו יוצרת ספרייה חדשה בשם DeveloperServices-4.x.y.z.
    2. עוברים לספרייה DeveloperServices-4.x.y.z.
    3. מריצים את הסקריפט non-networked-update.sh:
      > ./non-networked-update.sh

      בהתאם להרשאות הקבצים, יכול להיות שתצטרכו להשתמש ב-sudo כדי להריץ את הפקודה הזו, או להריץ אותה כאדמינים.

      הפקודה הזו מורידה את כל קובצי העדכון הנדרשים, אורזת אותם בקובץ אחד בשם devportal-update.tgz וכותבת את הקובץ במיקום שבחרתם.
    4. מעתיקים את devportal-update.tgz לשרת היעד, שבו פועל הפורטל.
      הערה: אל תעתיקו את הקובץ devportal-update.tgz לשורש האינטרנט של שרת היעד.
    5. מבטלים את הדחיסה של הקובץ devportal-update.tgz לספרייה הנוכחית:
      > tar -xzf /path/to/devportal-update.tgz
    6. עוברים לספרייה developer-update.
    7. מריצים את הפקודה הבאה כדי להתקין את העדכון:
      > ‎./install-update.sh
    8. עונים על השאלות.

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