שדרוג הפורטל

התהליך הזה מתאר איך לשדרג פורטל קיים של שירותים למפתחים של Apigee (או פשוט הפורטל) בארגון בתהליך ההתקנה.

בוחרים את תהליך העדכון הנכון

התהליך שבו משתמשים לעדכון הפורטל מבוסס על ההתקנה הנוכחית:

• אם בהתקנה נעשה שימוש ב-NGINX/Postgres, השתמשו שדרוג פורטל באמצעות הכנסה לאלף צפיות בהמשך.
• אם ההתקנה משתמשת ב-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 ואילך.

כדי לבדוק מה גרסת הפורטל שלכם, יש לפתוח את כתובת ה-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=host_IP_address --username=drupaladmin
     --password --format=c > /tmp/portal.dmp

   כאשר:

   • devportal הוא שם מסד הנתונים כפי שצוין על ידי המאפיין PG_NAME בקובץ התצורה להתקנת הפורטל.
   • host_IP_address הוא כתובת ה-IP של צומת הפורטל.
   • drupaladmin הוא שם המשתמש ב-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 או הגדרה > מדיה > קובץ בתפריט Drupal כדי לקבוע את המיקום של מערכת הקבצים הציבורית והנתיב של מערכת הקבצים הפרטיים (במשך בפעימה הזו).

4. ליצור גיבוי של הקבצים בתיקייה /opt/apigee/data/apigee-drupal-devportal/private.
5. הגדרת Drupal למצב תחזוקה:
   1. בוחרים באפשרות Configuration (הגדרה) בתפריט Drupal.
   2. בדף Configuration, בוחרים באפשרות Maintime mode (מצב תחזוקה). בקטע פיתוח.
   3. מסמנים את התיבה העברת האתר למצב תחזוקה.
   4. צריך להזין הודעה שהמשתמשים יראו במהלך התחזוקה.
   5. בוחרים באפשרות Save configuration (שמירת ההגדרות האישיות).
6. השבתת SELinux כפי שמתואר ב מתקינים את כלי ההגדרה של Edge apigee-setup.
7. שינוי לספרייה /opt:

   cd /opt

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

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

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

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

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

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

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

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

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

         tar -xzf apigee-4.51.00.tar.gz

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

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

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

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

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

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

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

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

         sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939
           apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

         כאשר uName ו-pWord הם שם המשתמש והסיסמה במאגר.

10. כדי לעדכן את כלי השירות apigee-setup, צריך להשתמש ב-apigee-service:

    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

11. מריצים את הכלי update בצומת Postgres:

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

    כאשר configFile הוא קובץ התצורה שהשתמשתם בו כדי להתקין במסד הנתונים של Postgres. הדרישה היחידה בקובץ התצורה היא שהתצורה הקובץ חייב להיות נגיש או קריא באמצעות ה-apigee משתמש.