יש לעדכן את Apigee Edge בגרסה 4.19.06 או את 4.50.00 ל-4.51.00

בקטע הזה מוסבר איך לשדרג מ-Apigee Edge מ-4.19.06 או מ-4.50.00 ל-4.51.00.

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

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

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

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

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

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

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

נדרש שדרוג ל-Postgres 10.17

המהדורה הזו של Edge כוללת שדרוג ל-Postgres 10.17. במסגרת השדרוג, כל נתוני Postgres יועברו לגרסת Postgres 10.17.

ברוב מערכות הייצור של Edge נעשה שימוש בשני צומתי Postgres שהוגדרו לשכפול במצב המתנה ראשי. במהלך העדכון, בזמן שצמתים של Postgres מושבתים לצורך עדכון, נתוני הניתוח עדיין נכתבים בצומתי ה-Qpid. אחרי העדכון של צומתי Postgres וחיבורם לאינטרנט, נתוני הניתוח מועברים לצומתי Postgres.

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

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

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

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

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

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

התקנת צומת Postgres חדש במצב המתנה

התהליך הזה יוצר שרת המתנה של Postgres בצומת חדש. חשוב להתקין שרת המתנה חדש של Postgres לגרסה הקיימת של Edge (4.19.06 או 4.50.00), ולא לגרסה 4.51.00.

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

כדי ליצור צומת Postgres במצב המתנה:

  1. במאסטר הנוכחי של Postgres, עורכים את הקובץ /opt/apigee/customer/application/postgresql.properties כדי להגדיר את האסימון הבא. אם הקובץ לא קיים, יוצרים אותו: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

    existing_standby_ip היא כתובת ה-IP של שרת ההמתנה הנוכחי של Postgres ו-new_standby_ip היא כתובת ה-IP של צומת ההמתנה החדש.

  2. מפעילים מחדש את apigee-postgresql במאסטר של Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. מוודאים שהצומת החדש של המתנה נוסף על ידי הצגת הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר. השורות הבאות אמורות להופיע בקובץ הזה: 
    host replication apigee existing_standby_ip/32 trust
host replication apigee new_standby_ip/32 trust
  4. מתקינים את שרת ההמתנה החדש של Postgres:
    1. עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge כדי לציין את הפרטים הבאים: 
      # IP address of the current master:
PG_MASTER=192.168.56.103
# IP address of the new standby node
PG_STANDBY=192.168.56.102
    2. משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
    3. מבצעים את אחת מהפעולות הבאות, בהתאם לגרסת Edge שממנה משדרגים:
      • אם בחרת לשדרג מ-Edge 4.19.06, צריך להוריד את הקובץ Edge shoestrap_4.19.06.sh ל-/tmp/bootstrap_4.19.06.sh : 
        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

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

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

      • אם בחרת לשדרג מ-Edge 4.50.00, צריך להוריד את הקובץ Edge shoestrap_4.50.00.sh ל-/tmp/bootstrap_4.50.00.sh : 
        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

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

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

    4. צריך להשתמש ב-apigee-service כדי להתקין את כלי השירות apigee-setup: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. התקנת Postgres: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    6. בצומת ההמתנה החדש, מריצים את הפקודה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שהכתובת במצב המתנה.

ביצוע שדרוג מקומי של Postgres

כדי לבצע שדרוג במקום ל-Postgres 10.17, יש לבצע את השלבים הבאים:

  1. שדרוג הודעות פוסט במארח הראשי 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  2. מריצים את פקודת ההגדרה במארח הראשי: 
    apigee-service apigee-postgresql setup -f /opt/silent.conf
  3. מריצים את פקודת ההגדרה במארח הראשי: 
    apigee-service apigee-postgresql configure
  4. מפעילים מחדש את המארח הראשי: 
    apigee-service apigee-postgresql restart
  5. מגדירים אותו כראשי: 
    apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
  6. מוודאים שהמארח הראשי הופעל: 
    apigee-service apigee-postgresql wait_for_ready
  7. הפסקת ההמתנה: 
    apigee-service apigee-postgresql stop
  8. שדרוג מצב המתנה.

    הערה:אם השלב הזה שגוי או נכשל, אפשר להתעלם ממנו. המערכת של update.sh תנסה להפעיל את שרת ההמתנה עם הגדרה שגויה. אם ההתקנה של Postgres תשודרג ל-10.17, אפשר להתעלם מהשגיאה.

    /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
  9. מוודאים שההמתנה נפסקה: 
    apigee-service apigee-postgresql stop
  10. הסרה של ההגדרות האישיות הישנות למצב המתנה: 
    rm -rf /opt/apigee/data/apigee-postgresql/
  11. מגדירים שכפול בשרת המתנה: 
    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

אחרי שתשלימו את התהליך, ההמתנה תתחיל בהצלחה.

ביטול ההפעלה של צומת Postgres

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

  1. מוודאים ש-Postgres פועל: 
    /opt/apigee/apigee-service/bin/apigee-all status

    אם Postgres לא פועל, מפעילים אותו: 

    /opt/apigee/apigee-service/bin/apigee-all start

  2. מריצים את הפקודה curl בצומת ההמתנה החדש כדי לקבל את ה-UUID של צומת ההמתנה החדש: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    ה-UUID של הצומת אמור להופיע בסוף הפלט, באופן הבא: 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

  3. כדי לעצור את צומת ההמתנה החדש, מריצים את הפקודה הבאה בצומת ההמתנה החדש: 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. בצומת המאסטר של Postgres, יש לערוך את /opt/apigee/customer/application/postgresql.properties כדי להסיר את צומת ההמתנה החדש מ-conf_pg_hba_replication.connection: 
    conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
  5. מפעילים מחדש את apigee-postgresql במאסטר של Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. יש לוודא שהצומת החדש למצב המתנה הוסר על ידי הצגת הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר. בקובץ הזה אמורה להופיע רק השורה הבאה: 
    host replication apigee existing_standby_ip/32 trust
  7. מוחקים את ה-UUID של צומת ההמתנה מ-zoKeeper על ידי ביצוע הקריאה הבאה ל-API של ניהול Edge בצומת שרת הניהול: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

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

לפני שדרוג 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 עבור הענן הפרטי שממנו מתבצע השדרוג:

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

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

ביטול של עדכון

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

אם בעקבות הכשל צריך להחזיר את העדכון לגרסה הקודמת, קראו את המאמר חזרה לגרסה 4.51.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 4.19.06 או 4.50.00.

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

כדי לעדכן את רכיבי 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.51.00.sh Edge 4.51.00 אל /tmp/bootstrap_4.51.00.sh: 
    curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
  8. מתקינים את תוכנת העזר ואת יחסי התלות של 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_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.06 או 4.50.00.

    אפשר להריץ את 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.51.00.

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

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

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

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

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

  1. יוצרים מאגר מקומי של 4.51.00 כמו שמתואר ב'יצירת מאגר Apigee מקומי' במאמר התקנת כלי השירות Edge apigee-setup.
  2. כדי להתקין את שירות API מקובץ .tar:
    1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .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. מתקינים את תוכנת העזר ואת יחסי התלות של Edge apigee-service מ-/tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. כדי להתקין את השירות API באמצעות שרת האינטרנט NGINX:
    1. מגדירים את שרת האינטרנט NGINX כפי שמתואר בקטע "התקנה מהמאגר באמצעות שרת האינטרנט של NGINX", במאמר התקנת כלי השירות של 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-setup של Edge ואת יחסי התלות: 
      sudo bash /tmp/bootstrap_4.51.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: קאסנדרה
      • edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
      • ldap: פתיחת LDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO (אם התקנת SSO)
      • ue ממשק משתמש חדש של Edge
      • ui: ממשק משתמש קלאסי של Edge
      • zk: מנהל/ת גן חיות
    • configFile הוא קובץ התצורה שהשתמשתם בו כדי להגדיר את רכיבי Edge במהלך ההתקנה של 4.19.06 או 4.50.00.

    אפשר להריץ את 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.51.00.

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

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

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

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

כדי לשדרג גרסה עצמאית של צומת אחד ל-4.51.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

שדרוג נפרד ל-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 בכל המכונות שבהן הוא פועל.