עדכון של Apigee Edge מגרסה 4.19.01 ל-4.19.06

בקטע הזה מוסבר איך לבצע את השדרוג הבא:

  • מ-4.19.01 עד 4.19.06

מי יכול לבצע את העדכון

המשתמש שמריץ את העדכון צריך להיות זהה למשתמש שהתקין את Edge במקור, או למשתמש שפועל בתור root.

אחרי שמתקינים את ה-RPM של Edge, כל משתמש יכול להגדיר אותם.

אילו רכיבים צריך לעדכן

צריך לעדכן את כל רכיבי Edge. Edge לא תומך בהגדרה שמכילה רכיבים מכמה גרסאות.

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

אם הגדרת מאפיינים כלשהם על ידי עריכת קובצי .properties בקובץ /opt/apigee/customer/application, הערכים האלה יישמרו במסגרת העדכון.

עדכון דרישות מוקדמות

לפני שדרוג Apigee Edge, יש לעמוד בדרישות המוקדמות הבאות:

  • גיבוי של כל הצמתים
    לפני העדכון, מומלץ לבצע גיבוי מלא לכל הצמתים מטעמי בטיחות. מבצעים את הגיבוי בהתאם לגרסה הנוכחית של Edge.

    כך תהיה לך תוכנית גיבוי למקרה שהעדכון לגרסה חדשה לא יפעל כראוי. מידע נוסף על גיבוי זמין במאמר גיבוי ושחזור.

  • מוודאים ש-Edge פועל
    מוודאים ש-Edge פועל בזמן תהליך העדכון באמצעות הפקודה: 
    /opt/apigee/apigee-service/bin/apigee-all status

ממשק המשתמש החדש של Edge

בקטע הזה מפורטים שיקולים הקשורים לממשק המשתמש של Edge. מידע נוסף זמין במאמר ממשק המשתמש החדש של Edge לענן פרטי.

התקנת ממשק המשתמש של Edge

אחרי השלמת ההתקנה הראשונית, Apigee ממליצה להתקין את ממשק המשתמש של Edge, שהוא ממשק משתמש משופר למפתחים ולאדמינים של Apigee Edge לענן פרטי.

הערה: בממשק המשתמש של Edge צריך להשבית את האימות הבסיסי ולהשתמש ב-IDP כמו SAML או LDAP.

מידע נוסף זמין במאמר התקנת ממשק המשתמש החדש של Edge.

עדכון ממשק המשתמש של Edge

כדי לעדכן את הרכיב בממשק המשתמש של Edge, צריך להשתמש בגרסה של Edge עבור הענן הפרטי שממנו מתבצע השדרוג:

  • מגרסה 4.18.0x:אם התקנתם את גרסת הבטא של ממשק המשתמש של Edge (לשעבר חוויית המשתמש החדשה של Edge או ה-UE החדש) בגרסה 4.18.0x, אתם צריכים להסיר אותה ולהתקין מחדש את הגרסה 4.19.06 של ממשק המשתמש של Edge כפי שמתואר בהתקנת ממשק המשתמש החדש של Edge.
  • החל מ-4.19.01 (כאשר ממשק המשתמש החדש של Edge כבר מותקן): משתמשים בהוראות השדרוג בקטע הזה עבור הרכיב edge-management-ui.
  • החל מ-4.19.01 (עם ממשק המשתמש הקלאסי): משדרגים את Edge להתקנה של הענן הפרטי כפי שמתואר בסעיף הזה ואז מתקינים את ממשק המשתמש של Edge כפי שמתואר במאמר התקנת ממשק המשתמש החדש של Edge.

עדכון באמצעות Apigee mTLS

ב-Apigee Edge לענן הפרטי בגרסה 4.19.06 אין כרגע ספריות משודרגות של Apigee mTLS. אם מותקנת אצלך גרסה 4.19.01 עם Apigee mTLS ורוצה לשדרג לגרסה 4.19.06, עליך לפנות לתמיכה של Apigee Edge.

מה עושים אם עדכון נכשל

אם העדכון נכשל, אפשר לנסות לתקן את הבעיה ולאחר מכן להפעיל שוב את update.sh. אפשר להריץ את העדכון כמה פעמים, והעדכון ימשיך מהמקום שבו הוא הפסיק.

אם הכשל מחייב להחזיר את העדכון לגרסה הקודמת, אפשר לעיין בחזרה לגרסה 4.19.06 למידע נוסף.

פרטי העדכון ביומן

כברירת מחדל, כלי השירות update.sh כותב את פרטי היומן ב:

/opt/apigee/var/log/apigee-setup/update.log

אם למשתמש שמפעיל את הכלי update.sh אין גישה לספרייה הזו, הוא כותב את היומן לספרייה /tmp כקובץ בשם update_username.log.

אם למשתמש אין גישה אל /tmp, כלי השירות update.sh ייכשל.

עדכון לגבי אפס זמן השבתה

עדכון ללא זמן השבתה, או עדכון מתגלגל, מאפשר לעדכן את התקנת Edge בלי לקטוע את Edge.

ניתן לעדכן ללא זמן השבתה רק בהגדרה של 5 צמתים ומעלה.

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

  1. מעדכנים את המכונות בסדר הנכון להתקנה לפי ההוראות במאמר סדר עדכון המכונה.
  2. כשיגיע הזמן לעדכן את הנתבים, בוחרים נתב אחד ומוודאים שלא ניתן לגשת אליו, כפי שמתואר בקטע יכולת הגעה של השרת (מעבד הודעות/נתב).
  3. עדכון הנתב שנבחר וכל שאר רכיבי Edge באותה מכונה שבה נמצא הנתב. בכל ההגדרות של Edge יוצג נתב ומעבד הודעות באותו צומת.
  4. מגדירים מחדש את הנתב נגיש.
  5. חוזרים על שלבים 2 עד 4 עבור שאר הנתבים.
  6. המשך בעדכון לכל המכונות שנותרו בהתקנה.

חשוב לבצע את הפעולות הבאות לפני/אחרי העדכון:

שימוש בקובץ תצורה שקט

עליך להעביר קובץ תצורה שקט לפקודת העדכון. קובץ התצורה השקטה צריך להיות זהה לקובץ שבו השתמשת כדי להתקין את Edge 4.19.01.

עדכון לגרסה 4.19.06 בצומת עם חיבור חיצוני לאינטרנט

כדי לעדכן את רכיבי Edge בצומת, יש לבצע את התהליך הבא:

  1. אם היא קיימת, משביתים את כל המשימות ב-cron שהוגדרו לבצע פעולת תיקון ב-Cassandra עד שהעדכון יושלם.
  2. מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
  3. מתקינים את yum-utils ואת yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
  5. אם מתקינים ב-Oracle 7.x, מריצים את הפקודה הבאה: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. אם מתקינים ב-AWS, מריצים את הפקודות הבאות של yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. מורידים את קובץ bootstrap_4.19.06.sh של Edge 4.19.06 אל /tmp/bootstrap_4.19.06.sh: 
    curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
  8. מתקינים את תוכנת העזר ואת יחסי התלות של apigee-service Edge 4.19.06 על ידי הרצת הפקודה הבאה: 
    sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

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

    כברירת מחדל, מנהל ההתקנה בודק שמותקנת אצלך גרסת Java 1.8. אם לא תעשו זאת, מנהל ההתקנה יתקין אותו עבורכם.

    השתמשו באפשרות JAVA_FIX כדי לציין איך לטפל בהתקנת Java. הפונקציה JAVA_FIX מקבלת את הערכים הבאים:

    • I: מתקינים את OpenJDK 1.8 (ברירת מחדל).
    • C: המשך ללא התקנת Java.
    • Q: יציאה. עבור אפשרות זו, עליכם להתקין את Java בעצמכם.
  9. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup, כמו שאפשר לראות בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. מעדכנים את הכלי apigee-validate בשרת הניהול, כמו בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. מעדכנים את הכלי apigee-provision בשרת הניהול, כמו בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. מפעילים את כלי השירות update בצמתים על ידי הרצת הפקודה הבאה: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    כאשר:

    • component הוא רכיב Edge שיש לעדכן. הערכים האפשריים כוללים:
      • cs: קאסנדרה
      • edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
      • ldap: פתיחת LDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (אם התקנת SSO)
      • ue: ממשק משתמש חדש של Edge
      • ui: ממשק משתמש קלאסי של Edge
      • zk: מנהל/ת גן חיות
    • configFile הוא אותו קובץ תצורה שבו השתמשתם להגדרת רכיבי Edge במהלך ההתקנה של 4.19.01.

    אפשר להריץ את update.sh בכל הרכיבים על ידי הגדרת component כ-'all', אבל רק אם יש לכם פרופיל התקנה של Edge all-in-one (AIO) ב-Edge. לדוגמה:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  13. אם עדיין לא עשית זאת, עליך להפעיל מחדש את רכיב ממשק המשתמש של Edge בכל הצמתים שבהם הוא פועל: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  14. בודקים את העדכון על ידי הרצת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

אם תחליטו לבטל את העדכון בשלב מאוחר יותר, בצעו את התהליך שמתואר בחזרה לגרסה 4.19.06.

עדכון ל-4.19.06 ממאגר מקומי

אם צמתים של Edge נמצאים מאחורי חומת אש, או שהגישה שלהם למאגר Apigee באינטרנט אסורה בדרך אחרת, ניתן לבצע את העדכון ממאגר מקומי או משיקוף של המאגר של Apigee.

אחרי שיוצרים מאגר מקומי של Edge, יש שתי אפשרויות לעדכון Edge מהמאגר המקומי:

  • יוצרים קובץ .tar של המאגר, מעתיקים את קובץ ה- .tar לצומת ואז מעדכנים את Edge מקובץ ה- .tar.
  • מתקינים שרת אינטרנט בצומת עם המאגר המקומי כדי שצמתים אחרים יוכלו לגשת אליו. Apigee מספקת לך את שרת האינטרנט של Nginx, או שתוכל להשתמש בשרת אינטרנט משלך.

כדי לבצע עדכון ממאגר מקומי של 4.19.06:

  1. יוצרים מאגר מקומי בגרסה 4.19.06 כמו שמתואר ב'יצירת מאגר Apigee מקומי' במאמר התקנת כלי השירות Edge apigee-setup.
  2. כדי להתקין את שירות API מקובץ .tar:
    1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.19.06.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
    3. בצומת החדש, מבטלים את סימון הקובץ לספרייה /tmp: 
      tar -xzf apigee-4.19.06.tar.gz

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

    4. מתקינים את תוכנת העזר ואת יחסי התלות של Edge apigee-service מ-/tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.19.06.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. כדי להתקין את השירות API באמצעות שרת האינטרנט של Nginx:
    1. מגדירים את שרת האינטרנט של Nginx כפי שמתואר במאמר 'התקנה מהמאגר באמצעות שרת האינטרנט של Nginx' במאמר התקנת כלי השירות Edge apigee-setup.
    2. בצומת המרוחק, יש להוריד את קובץ Edge bootstrap_4.19.06.sh אל /tmp/bootstrap_4.19.06.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

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

    3. בצומת המרוחק, מתקינים את תוכנת השירות apigee-setup של Edge ואת יחסי התלות: 
      sudo bash /tmp/bootstrap_4.19.06.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

  4. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup, כמו שאפשר לראות בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. מעדכנים את הכלי apigee-validate בשרת הניהול, כמו בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. מעדכנים את הכלי apigee-provision בשרת הניהול, כמו בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. מריצים את תוכנית השירות update בצמתים לפי הסדר שמתואר בסדר עדכון המכונה: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    כאשר:

    • component הוא רכיב Edge שיש לעדכן. בדרך כלל מעדכנים את הרכיבים הבאים:
      • cs: קאסנדרה
      • edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
      • ldap: פתיחת LDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (אם התקנת SSO)
      • ue ממשק משתמש חדש של Edge
      • ui: ממשק משתמש קלאסי של Edge
      • zk: מנהל/ת גן חיות
    • configFile הוא אותו קובץ תצורה שבו השתמשתם להגדרת רכיבי Edge במהלך ההתקנה של גרסה 4.19.01.

    אפשר להריץ את update.sh בכל הרכיבים על ידי הגדרת component כ-'all', אבל רק אם יש לכם פרופיל התקנה של Edge all-in-one (AIO) ב-Edge. לדוגמה:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. אם עדיין לא עשית זאת, צריך להפעיל מחדש את רכיבי ממשק המשתמש בכל הצמתים שמריצים אותו: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. בודקים את העדכון על ידי הרצת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

אם תחליטו לבטל את העדכון בשלב מאוחר יותר, בצעו את התהליך שמתואר בחזרה לגרסה 4.19.06.

סדר העדכון של המכשיר

הסדר שבו מעדכנים את המכונות בהתקנת Edge הוא חשוב:

  • לפני עדכון של צמתים אחרים, עליך לעדכן את כל הצמתים של Cassandra ו-ZoKeeper.
  • בכל מכונה עם מספר רכיבי Edge (שרת ניהול, מעבד הודעות, נתב, שרת QPID אבל לא שרת Postgres), משתמשים באפשרות -c edge כדי לעדכן את כולם בו-זמנית.
  • אם שלב מציין שצריך לבצע אותו במספר מכונות, מבצעים אותו בסדר המכונה שצוין.
  • אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את האפשרות -c edge.

שדרוג נפרד של צומת אחד

כדי לשדרג גרסה עצמאית של צומת אחד לגרסה 4.19.06:

  1. מעדכנים את כל הרכיבים: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (אם התקנת את apigee-adminapi) עדכנת את תוכנת העזר apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

שדרוג נפרד ל-2 צמתים

עדכן את הרכיבים הבאים להתקנה עצמאית עם שני צמתים:

לרשימת הטופולוגיות של Edge ומספרי הצמתים, אפשר לעיין בקטע טופולוגיות התקנה.

  1. עדכון של Cassandra ו-zoKeeper במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. עדכון Qpid ו-Postgres במכונה 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  3. עדכון LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. מעדכנים את רכיבי Edge במחשב 2 ו-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. מעדכנים את ממשק המשתמש במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. (אם התקנת את apigee-adminapi) הכלי apigee-adminapi עודכן במכונה 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  7. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    כאשר sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם SSO.

  8. מפעילים מחדש את רכיב ממשק המשתמש של Edge במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

שדרוג ל-5 צמתים

עדכן את הרכיבים הבאים להתקנה של 5 צמתים:

לרשימת הטופולוגיות של Edge ומספרי הצמתים, אפשר לעיין בקטע טופולוגיות התקנה.

  1. מעדכנים את Cassandra ו-zoKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. עדכון Qpid ו-Postgres במכונה 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  3. עדכון Qpid ו-Postgres במכונה 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
  4. עדכון LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. עדכון רכיבי Edge במכונה 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. מעדכנים את ממשק המשתמש של Edge:
    • ממשק המשתמש הקלאסי: אם משתמשים בממשק המשתמש הקלאסי, צריך לעדכן את הרכיב ui במחשב 1 כמו בדוגמה הבאה: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • ממשק המשתמש החדש של Edge: אם התקנת את ממשק המשתמש החדש של Edge, צריך לעדכן את הרכיב ue במחשב המתאים (יכול להיות שלא יהיה מחשב 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  7. (אם התקנת את apigee-adminapi) הכלי apigee-adminapi עודכן במכונה 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    כאשר sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם SSO.

  9. מפעילים מחדש את הרכיב של ממשק המשתמש:
    • ממשק המשתמש הקלאסי: אם משתמשים בממשק המשתמש הקלאסי, צריך להפעיל מחדש את הרכיב edge-ui במחשב 1, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק המשתמש החדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את הרכיב edge-management-ui במחשב המתאים (יכול להיות שהוא לא יהיה מכונה 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג אשכולות של 9 צמתים

עדכון הרכיבים הבאים להתקנה באשכולות עם 9 צמתים:

לרשימת הטופולוגיות של Edge ומספרי הצמתים, אפשר לעיין בקטע טופולוגיות התקנה.

  1. מעדכנים את Cassandra ו-zoKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. עדכון Qpid במחשבים 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. עדכון Postgres במחשב 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. עדכון Postgres במחשב 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. עדכון LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. מעדכנים את רכיבי Edge במחשבים 6, 7, 8, 9, 1, 4 ו-5 בסדר הזה: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. מעדכנים את ממשק המשתמש החדש (ue) או את ממשק המשתמש הקלאסי (ui) במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (אם התקנתם את apigee-adminapi) מעדכנים את הכלי apigee-adminapi במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    כאשר sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם SSO.

  10. מפעילים מחדש את הרכיב של ממשק המשתמש:
    • ממשק המשתמש הקלאסי: אם משתמשים בממשק המשתמש הקלאסי, צריך להפעיל מחדש את הרכיב edge-ui במחשב 1, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק המשתמש החדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את הרכיב edge-management-ui במחשב המתאים (יכול להיות שהוא לא יהיה מכונה 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג אשכולות של 13 צמתים

עדכון הרכיבים הבאים להתקנה באשכולות של 13 צמתים:

לרשימת הטופולוגיות של Edge ומספרי הצמתים, אפשר לעיין בקטע טופולוגיות התקנה.

  1. מעדכנים את Cassandra ו-zoKeeper במכשירים 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. עדכון Qpid במחשבים 12 ו-13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. עדכון Postgres במחשב 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. עדכון Postgres במחשב 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  5. עדכון LDAP במכונות 4 ו-5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. מעדכנים את רכיבי Edge במחשבים 12, 13, 8, 9, 6, 7, 10 ו-11 בסדר הזה: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. מעדכנים את ממשק המשתמש החדש (ue) או את ממשק המשתמש הקלאסי (ui) במחשבים 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (אם התקנת את apigee-adminapi) כלי השירות apigee-adminapi עודכן במחשבים 6 ו-7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (אם התקנת את Apigee SSO) עליך לעדכן את Apigee SSO במחשבים 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    כאשר sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם SSO.

  10. מפעילים מחדש את הרכיב של ממשק המשתמש:
    • ממשק המשתמש הקלאסי: אם משתמשים בממשק המשתמש הקלאסי, צריך להפעיל מחדש את הרכיב edge-ui במחשבים 6 ו-7, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק המשתמש החדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את הרכיב edge-management-ui במחשבים 6 ו-7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג אשכולות של 12 צמתים

עדכון הרכיבים הבאים להתקנה באשכולות של 12 צמתים:

לרשימת הטופולוגיות של Edge ומספרי הצמתים, אפשר לעיין בקטע טופולוגיות התקנה.

  1. מעדכנים את Cassandra ו-zoKeeper:
    1. במחשבים 1, 2 ו-3 במרכז הנתונים 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. במכונות 7, 8 ו-9 במרכז הנתונים 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. צריך לעדכן את qpidd:
    1. מכונות 4, 5 במרכז הנתונים 1
      1. עדכון qpidd במחשב 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. עדכון qpidd במחשב 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. מכונות 10, 11 במרכז הנתונים 2
      1. עדכון qpidd במחשב 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. עדכון qpidd במחשב 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. מעדכנים את Postgres:
    1. מכונה 6 במרכז נתונים 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. מכונה 12 במרכז הנתונים 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. עדכון LDAP:
    1. מכונה 1 במרכז הנתונים 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. מכונה 7 במרכז הנתונים 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. מעדכנים את רכיבי Edge:
    1. מכונות 4, 5, 6, 1, 2, 3 במרכז הנתונים 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. מכונות 10, 11, 12, 7, 8, 9 במרכז הנתונים 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. מעדכנים את ממשק המשתמש החדש (ue) או את ממשק המשתמש הקלאסי (ui):
    1. מכונה 1 במרכז הנתונים 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. מכונה 7 במרכז הנתונים 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (אם התקנתם את apigee-adminapi) עדכנתם את תוכנת העזר apigee-adminapi:
    1. מכונה 1 במרכז הנתונים 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. מכונה 7 במרכז הנתונים 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO:
    1. מכונה 1 במרכז הנתונים 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. מכונה 7 במרכז הנתונים 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. כאשר sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם SSO.

  9. מפעילים מחדש את ממשק המשתמש החדש של Edge (edge-management-ui) או את רכיב ממשק המשתמש הקלאסי של Edge (edge-ui) במחשבים 1 ו-7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

לתצורה לא סטנדרטית

אם יש לכם תצורה לא רגילה, צריך לעדכן את רכיבי Edge בסדר הבא:

  1. ZooKeeper
  2. קסנדרה
  3. qpidd, פס
  4. LDAP
  5. Edge, כלומר פרופיל "-c edge" בכל הצמתים שבסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתב.
  6. ממשק משתמש Edge (קלאסי או חדש)
  7. apigee-adminapi
  8. כניסה יחידה (SSO) ב-Apigee

אחרי שמסיימים את העדכון, חשוב להפעיל מחדש את רכיב ממשק המשתמש של Edge בכל המכונות שבהן הוא פועל.