עדכון של Apigee Edge מגרסה 4.52.02 לגרסה 4.53.00

ב-Apigee יש תמיכה בשדרוג של Edge for Private Cloud ישירות מגרסה 4.52.02 לגרסה 4.53.00. בדף הזה נסביר איך לבצע שדרוגים כאלה.

במטריצה של תאימות השדרוגים למהדורות של Edge for Private Cloud תוכלו למצוא סקירה כללית של נתיבי השדרוג התואמים.

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

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

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

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

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

עדכון התנאים המוקדמים

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

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

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

  • מוודאים ש-Edge פועל
    מוודאים ש-Edge פועל במהלך תהליך העדכון באמצעות הפקודה: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • אימות התנאים המוקדמים ל-Cassandra
    אם שדרגתם בעבר מגרסה ישנה יותר של Edge for Private Cloud לגרסה 4.52.02, ועכשיו אתם מתכננים לשדרג לגרסה 4.53.00, עליכם לוודא שהשלמתם את השלבים הנדרשים לאחר השדרוג של Cassandra. השלבים האלה מפורטים במסמכי העזרה לגרסה 4.52.02 בקטע שלבים לאחר השדרוג. אם אתם לא בטוחים שהשלבים האלה בוצעו במהלך השדרוג הקודם, עליכם לבצע אותם שוב לפני שתמשיכו בשדרוג לגרסה 4.53.00.
  • דרישות Python
    לפני שמנסים לבצע את השדרוג, צריך לוודא ש-Python 3 מותקן בכל הצמתים, כולל צמתים של Cassandra.

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

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

נדרש שדרוג ל-Cassandra 4.0.13

Apigee Edge for Private Cloud 4.53.00 כולל שדרוג של Cassandra לגרסה 4.0.13.

שדרוגים וביטול שינויים

  • השדרוג מ-Cassandra 3.11.X ל-Cassandra 4.0.X הוא תהליך חלק. גרסת Cassandra 4.0.X, שפורסמה עם Edge for Private Cloud 4.53.00, תואמת לרכיבי זמן הריצה ולרכיבי הניהול של Private Cloud 4.52.02.
  • אי אפשר לבצע חזרה לאחור ישירות במקום מ-Cassandra 4.0.X ל-3.11.X. חזרה לאחור באמצעות רפליקות או גיבויים היא תהליך מורכב שעלול לגרום לזמן השבתה ו/או לאובדן נתונים. עדיף לפתור את הבעיות ולשדרג ל-Cassandra 4.0.X במקום לבצע חזרה לאחור.
  • חשוב להכיר את הנהלים לשחזור גרסה קודמת לפני שמנסים לבצע את השדרוג. חשוב להביא בחשבון את הדקויות של החזרה לאחור במהלך השדרוג כדי לוודא שנתיבי החזרה לאחור המתאימים זמינים.

מרכז נתונים יחיד

השדרוג של Cassandra מ-3.11.X ל-4.0.X במרכז נתונים אחד הוא חלק, אבל החזרה לאחור מורכבת ועשויה לגרום לזמן השבתה ולאובדן נתונים. בעומסי עבודה בסביבת הייצור, מומלץ מאוד להוסיף מרכז נתונים חדש עם לפחות צמתים של Cassandra שזמינים במרכז הנתונים החדש לפני שמתחילים את השדרוג. כך תוכלו לבצע ביטול קודם (rollback) של Cassandra בלי לאבד נתונים או לשבש את תעבורת הנתונים ב-API. אפשר להוציא משימוש את מרכז הנתונים הנוסף הזה אחרי שהשדרוג יסתיים או לאחר שמגיעים לנקודת הבדיקה 2.

אם לא ניתן להוסיף מרכז נתונים חדש אבל עדיין רוצים לשמור על היכולת לבצע חזרה לאחור, יידרשו גיבויים לשחזור של Cassandra 3.11.X. עם זאת, סביר להניח שהשיטה הזו תגרום גם לזמן השבתה וגם לאובדן נתונים.

כמה מרכזי נתונים

הפעלת כמה מרכזי נתונים עם Edge for Private Cloud 4.52.02 מספקת גמישות רבה יותר לביצוע החזרות לאחור במהלך השדרוג ל-Edge for Private Cloud 4.53.00.

  • כדי לבצע החזרה לאחור, צריך לפחות מרכז נתונים אחד שבו פועלת גרסת Cassandra הישנה יותר (3.11.X).
  • אם כל האשכולות של Cassandra משודרגים לגרסה 4.0.X, אסור לבצע חזרה לגרסה 3.11.X של Cassandra. צריך להמשיך להשתמש בגרסה החדשה יותר של Cassandra עם שאר הרכיבים של Private Cloud 4.53.00 או 4.52.02.
  1. שדרוג של מרכז נתונים אחד של Cassandra בכל פעם: מתחילים בשדרוג של צמתים של Cassandra בנפרד בתוך מרכז נתונים אחד. צריך להשלים את השדרוגים של כל צמתים של Cassandra במרכז נתונים אחד לפני שממשיכים למרכז הנתונים הבא.
  2. השהיה ואימות: אחרי שמשדרגים מרכז נתונים אחד, משהים את הפעולה כדי לוודא שהאשכול של הענן הפרטי, במיוחד מרכז הנתונים המשודרג, פועלים בצורה תקינה.
  3. חשוב לזכור: אפשר לחזור לגרסה הקודמת של Cassandra רק אם יש לכם לפחות מרכז נתונים אחד שבו עדיין פועלת הגרסה הישנה.
  4. זמן מוגבל: אפשר להשהות את המעבר לפרק זמן קצר (מומלץ להשהות למשך כמה שעות) כדי לאמת את הפונקציונליות, אבל אי אפשר להישאר במצב של גרסאות מעורבות ללא הגבלת זמן. הסיבה לכך היא שלאשכול Cassandra לא אחיד (עם צמתים בגרסאות שונות) יש מגבלות תפעוליות.
  5. בדיקה יסודית: מומלץ מאוד לבצע בדיקה מקיפה של הביצועים והפונקציונליות לפני שמשדרגים את מרכז הנתונים הבא. אחרי שכל מרכזי הנתונים ישודרגו, לא תהיה אפשרות לבצע חזרה לגרסה הקודמת.
חזרה לאחור בתהליך של שני ציוני דרך
  1. נקודת ביקורת 1: המצב הראשוני, שבו כל הרכיבים בגרסה 4.52.02. אפשר לבצע חזרה לאחור מלאה כל עוד מרכז נתונים אחד לפחות של Cassandra נשאר בגרסה הישנה.
  2. נקודת עצירה 2: אחרי שכל צמתים של Cassandra בכל מרכזי הנתונים מתעדכנים. אפשר לחזור למצב הזה, אבל אי אפשר לחזור לנקודת הבדיקה הראשונה.
דוגמה

נניח שיש לכם אשכול עם שני מרכזי נתונים (DC):

  1. מצב ההתחלה: צמתים של Cassandra בשני מרכזי הנתונים (DC) הם בגרסה 3.11.X. כל שאר הצמתים הם בגרסה 4.52.02 של Edge for Private Cloud. נניח שיהיו שלושה צמתים של Cassandra לכל DC.
  2. שדרוג DC-1: משדרגים את שלושת הצמתים של Cassandra ב-DC-1 אחד אחרי השני.
  3. השהיה ואימות: משהים את האשכולות, במיוחד DC-1, כדי לוודא שהם פועלים כמו שצריך (בודקים את הביצועים והפונקציונליות). אפשר לחזור למצב הראשוני באמצעות צמתים של Cassandra ב-DC-2. חשוב לזכור שההשהיה הזו צריכה להיות זמנית בגלל המגבלות של אשכול Cassandra עם גרסאות מעורבות.
  4. שדרוג DC-2: שדרוג של שלושת צמתים הנותרים של Cassandra ב-DC-2. זה יהפוך לנקודת הבדיקה החדשה לשחזור לאחור.
  5. שדרוג רכיבים אחרים: משדרגים את צמתים הניהול, צמתים בסביבת זמן הריצה וצמתים לניתוח נתונים כרגיל בכל מרכזי הנתונים, צומת אחד ומרכז נתונים אחד בכל פעם. אם יהיו בעיות, תוכלו לחזור למצב של שלב 4.

דרישות מוקדמות לשדרוג של Cassandra

צריך להריץ את Cassandra 3.11.16 עם Edge for Private Cloud 4.52.02 ולוודא את הפרטים הבאים:
  • כל האשכולות פועלים ופועלים באופן מלא עם Cassandra 3.11.16.
  • אסטרטגיית הדחיסה מוגדרת כ-LeveledCompactionStrategy (דרישה מוקדמת לשדרוג לגרסה 4.52.02).
  • כל השלבים שלאחר השדרוג מהשדרוג הראשוני ל-Cassandra 3.11.16 כחלק מהשדרוג ל-4.52.02 הושלמו. אם לא, צריך להריץ מחדש את השלבים האלה. האפשרות הזו רלוונטית רק אם שדרגתם ל-Private Cloud בגרסה 4.52.02 מגרסה ישנה יותר.

שלב 1: הכנה לשדרוג

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

  1. גיבוי של Cassandra באמצעות Apigee.
  2. יוצרים קובצי snapshot של צמתים של Cassandra ב-VM (אם אפשר).
  3. אם עדיין לא הגדרתם את האפשרות הזו, עליכם לוודא שאפשר לגשת ליציאה 9042 מכל הרכיבים של Edge for Private Cloud, כולל שרת הניהול, מעבד ההודעות, הנתב, Qpid ו-Postgres, לצמתים של Cassandra. מידע נוסף זמין במאמר דרישות לשקע.

שלב 2: משדרגים את כל צמתים של Cassandra

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

אחרי שמשדרגים את כל הצמתים של Cassandra במרכז הנתונים, צריך להמתין זמן מה (30 דקות עד כמה שעות) לפני שממשיכים עם הצמתים במרכז הנתונים הבא. במהלך התקופה הזו, כדאי לבדוק היטב את מרכז הנתונים שעודכן ולוודא שמדדי הפונקציונליות והביצועים של אשכול Apigee תקינים. השלב הזה חיוני כדי להבטיח את היציבות של מרכז הנתונים שבו Cassandra שודרגה לגרסה 4.0.X, בעוד ששאר הרכיבים של Apigee נשארים בגרסה 4.52.02.

  1. כדי לשדרג צומת של Cassandra, מריצים את הפקודה הבאה: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. אחרי שמעדכנים צומת, מריצים את הפקודה הבאה בצומת כדי להריץ כמה בדיקות אימות לפני שממשיכים: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. הפלט של הפקודה הזו יהיה משהו כזה: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified

שלב 3: שדרוג כל צמתים הניהול

משדרגים את כל צמתים הניהול בכל האזורים, אחד אחרי השני:

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

שלב 4: שדרוג כל צמתים של Runtime

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

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

שלב 5: שדרוג של כל שאר הרכיבים של Edge for Private Cloud 4.53.00

משדרגים את כל שאר הצמתים מסוג edge-qpid-server ו-edge-postgres-server בכל האזורים, אחד אחרי השני.

שלב 6: שלבים לאחר השדרוג

אחרי שהשדרוג יושלם, מריצים את הפקודה הבאה בכל צומת של Cassandra בנפרד:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

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

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

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

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

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

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

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

כדי לעדכן את Apigee mTLS:

ביטול עדכון

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

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

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

כברירת מחדל, הכלי 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 for Private Cloud 4.52.02.

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

כדי לעדכן את רכיבי Edge בצומת:

  1. אם יש כאלה, משביתים את כל המשימות של cron שמוגדרות לבצע פעולת תיקון ב-Cassandra עד לסיום העדכון.
  2. מתחברים לצומת בתור root כדי להתקין את קובצי ה-RPM של Edge.
  3. משביתים את SELinux כפי שמתואר במאמר התקנת הכלי apigee-setup ב-Edge.
  4. אם מתקינים ב-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

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

עדכון לגרסה 4.53.00 ממאגר מקומי

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

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

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

כדי לעדכן ממאגר מקומי של 4.53.00:

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

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

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

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

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

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

    3. בצומת המרוחק, מתקינים את השירות apigee-setup של Edge ואת יחסי התלות שלו: 
      sudo bash /tmp/bootstrap_4.53.00.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: Cassandra
      • edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID ושרת Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (אם התקנתם SSO)
      • ue ממשק המשתמש החדש של Edge
      • ui: ממשק המשתמש הקלאסי של Edge
      • zk: Zookeeper
    • configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסת 4.50.00 או 4.51.00.

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

    /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.53.00.

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

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

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

שדרוג עצמאי של צומת אחד

כדי לשדרג הגדרה של צומת יחיד ל-4.53.00:

  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

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

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

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

  1. מעדכנים את Cassandra ו-ZooKeeper במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres במכונה 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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. מעדכנים את Qpid במכונה 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מעדכנים את ממשק המשתמש במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  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 במכונה 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

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

  1. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres במכונה 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את Postgres במכונה 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c 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. מעדכנים את Qpid במכונה 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. מעדכנים את Qpid במכונה 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. עדכון ממשק המשתמש של 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
  9. (אם התקנתם את apigee-adminapi) מעדכנים את הכלי apigee-adminapi במכונה 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  11. מפעילים מחדש את רכיב ממשק המשתמש:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, צריך להפעיל מחדש את הרכיב 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 ו-ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres במכונה 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את Postgres במכונה 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. מעדכנים את LDAP במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. מעדכנים את רכיבי Edge במכונות 6, 7, 8, 9, 1, 4 ו-5 לפי הסדר הזה: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. מעדכנים את Qpid במכונות 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 ו-ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres במכונה 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את Postgres במכונה 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. מעדכנים את LDAP במכונות 4 ו-5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. מעדכנים את רכיבי Edge במכונות 12, 13, 8, 9, 6, 7, 10 ו-11 לפי הסדר הזה: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. מעדכנים את Qpid במכונות 12 ו-13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 ואת ZooKeeper:
    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. מעדכנים את 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
  3. עדכון 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
  4. עדכון רכיבי 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
  5. מעדכנים את 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
  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. Cassandra
  3. ps
  4. LDAP
  5. קצה (edge), כלומר הפרופיל '-c edge' בכל הצמתים לפי הסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתבים.
  6. qpidd
  7. ממשק המשתמש של Edge (הקלאסי או החדש)
  8. apigee-adminapi
  9. Apigee SSO

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