פורטל השירותים למפתחים בגרסה 4.16.09
כאן מוסבר איך לשדרג התקנה מקומית קיימת של 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
כדי לבדוק מהי גרסת הפורטל שלכם, פותחים את כתובת ה-URL הבאה בדפדפן:
http://yourportal.com/buildInfo
לפני ההתקנה
בהתקנות קיימות, אם שיניתם קוד בליבה של Drupal או במודולים לא מותאמים אישית, השינויים שלכם יימחקו. השינויים האלה כוללים, בין היתר, שינויים שביצעת ב-.htaccess. צריך להניח שכל מה שנמצא מחוץ לספרייה /sites הוא בבעלות Drupal. robots.txt הוא חריג לכלל הזה. אם הקובץ הזה קיים בספריית השורש של האתר, הוא יישמר.
לפני שממשיכים בתהליך ההתקנה, צריך ליצור גיבוי של כל הספרייה ברמה הבסיסית של האתר ב-Drupal. ברירת המחדל של מיקום ההתקנה היא /var/www/html, אבל יכול להיות ששיניתם אותה בזמן ההתקנה. אחרי ביצוע שלבי ההתקנה שמפורטים בהמשך, תוכלו לשחזר את ההתאמות האישיות מהגיבוי.
שדרוג שירותי ערוצים למפתחים של Apigee לגרסה חדשה
- גיבוי של מכונת Drupal MySQL.
מידע נוסף זמין בכתובת http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/- אפשרות 1: שימוש ב-Drush
הפקודה sql-dump של Drush יוצרת עותק של מסד הנתונים. בספריית Drupal, /var/www/html כברירת מחדל, מריצים את הפקודה:
> drush sql-dump > /path/to/backup_dir/database-backup.sql
מידע נוסף זמין ב-drush help sql-dump. - אפשרות 2: שימוש ב-MySQLdump
משתמשים בפקודה mysqldump כדי ליצור עותק של מסד הנתונים:
mysqldump -u USERNAME -p'password' DATABASENAME > /path/to/backup_dir/database-backup.sql
לא אמור להיות רווח בין האפשרות לסיסמה. אם הסיסמה מכילה תווים מיוחדים, צריך להוסיף לה מירכאות בודדות.
מגדירים את USERNAME ואת DATABASENAME בזמן התקנת הפורטל. כברירת מחדל, שתיהן הן devportal.
- אפשרות 1: שימוש ב-Drush
- יוצרים גיבוי של כל ספריית השורש של האתר ב-Drupal. מיקום ברירת המחדל של ההתקנה הוא /var/www/html, אבל יכול להיות ששיניתם אותו בזמן ההתקנה.
- מורידים את הקובץ DeveloperServices_x.y.z.tar של Developer Channel Services, כאשר x.y.z תואם למספר הגרסה של הפורטל.
אפשר להוריד קובץ מהקישור שנשלח אליכם על ידי Apigee בדפדפן, או להעתיק אותו ולהוסיף אותו לפקודה הבאה של cURL:
> curl -kOL <paste link here>
הערה: אם הפורטל נמצא בשרת ללא חיבור אינטרנט חיצוני, צריך לבצע את השלב הזה בשרת עם גישה.
נכנסים לכתובת http://community.apigee.com/content/apigee-customer-support ובוחרים באפשרות התחברות לפורטל התמיכה כדי לבקש את קובץ ה- .tar לשדרוג השירותים של הערוץ למפתחים. אם אין לכם חשבון בפורטל התמיכה, בוחרים באפשרות Login to your Support Portal (כניסה לפורטל התמיכה) ואז בדף הכניסה בוחרים באפשרות In a hurry? כאן אפשר לפתוח כרטיס תמיכה. -
לשדרוג בשרת עם חיבור לאינטרנט:
- מחלצים את קובץ השדרוג של הפורטל:
> tar -xvf <tar file>
חֶלֶץ הפקודה הזו יוצר ספרייה חדשה שנקראת DeveloperServices-4.x.y.z. - עוברים לספרייה DeveloperServices-4.x.y.z.
- מורידים את הגרסה העדכנית של Drupal באמצעות הפקודה הבאה:
> drush dl drupal
הפקודה הזו יוצרת ספרייה בשם drupal-x.y, שבה x.y תואם לגרסה הנוכחית של Drupal. - מריצים את הסקריפט networked-update.sh:
> ./networked-update.sh
בהתאם להרשאות הקובץ, יכול להיות שתצטרכו להשתמש ב-sudo כדי להריץ את הפקודה הזו, או להריץ אותה בתור אדמין. - כדי לקבל התראות על עדכוני Drupal, צריך לוודא שהמודול של מנהל העדכונים של Drupal מופעל. בתפריט Drupal, בוחרים באפשרות Modules וגוללים למטה אל המודול Update Manager. אם היא לא מופעלת, מפעילים אותה.
אחרי ההפעלה, אפשר לראות את העדכונים הזמינים באמצעות הפריט דוחות > עדכונים זמינים בתפריט.
אפשר להשתמש באפשרות דוחות > עדכונים זמינים > הגדרות בתפריט כדי להגדיר שהמודול ישלח לכם אימייל כשיהיו עדכונים זמינים, ולהגדיר את התדירות של בדיקת העדכונים.
- מחלצים את קובץ השדרוג של הפורטל:
-
לשדרוג בשרת ללא חיבור לאינטרנט:
- בשרת שבו הורדתם את הקובץ DeveloperServices_x.y.z.tar של Developer Channel Services, מנתקים את קובץ השדרוג של הפורטל:
> tar -xvf <tar file>
הפקודה הזו יוצרת ספרייה חדשה בשם DeveloperServices-4.x.y.z. - עוברים לספרייה DeveloperServices-4.x.y.z.
- מריצים את הסקריפט non-networked-update.sh:
> ./non-networked-update.sh
בהתאם להרשאות הקובץ, יכול להיות שתצטרכו להשתמש ב-sudo כדי להריץ את הפקודה הזו, או להריץ אותה בתור אדמין.
הפקודה הזו מאפשרת להוריד את כל קובצי העדכון הנדרשים, לארוז אותם בקובץ אחד בשם devportal-update.tgz ולכתוב את הקובץ במיקום שבוחרים. - מעתיקים את הכתובת devportal-update.tgz לשרת היעד, שהוא זה שמפעיל את הפורטל.
הערה: לא מעתיקים את הקובץ devportal-update.tgz לשורש האתר של השרת היעד. - מחלצים את הקובץ devportal-update.tgz לספרייה הנוכחית:
> tar -xzf /path/to/devportal-update.tgz - עוברים לספרייה developer-update.
- מריצים את הפקודה הבאה כדי להתקין את העדכון:
> ./install-update.sh - עונים על ההנחיות.
- בשרת שבו הורדתם את הקובץ DeveloperServices_x.y.z.tar של Developer Channel Services, מנתקים את קובץ השדרוג של הפורטל:
השדרוג הושלם.