יש לעדכן את 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 מושבתים לעדכון, נתוני Analytics עדיין לא פעילים שנכתב בצמתים של Qpid. אחרי שמעדכנים את הצמתים של Postgres וחוזרים למצב אונליין, נתוני ניתוח הנתונים מתעדכנים לאחר מכן נדחף לצמתים של Postgres.

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

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

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

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

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

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

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

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

כדי לבצע את ההתקנה, צריך להשתמש באותו קובץ תצורה שבו השתמשת כדי להתקין את הגרסה הנוכחית מ-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 bootrap_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 bootrap_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-setup, צריך להשתמש ב-apigee-service: 
      /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. שדרוג Postgres במארח הראשי 
    /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. כדי לקבל את ה-UUID של הצומת החדש למצב המתנה, מריצים את הפקודה הבאה של curl צומת מצב המתנה: 
    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 של צומת ההמתנה מ-ZooKeeper על ידי ביצוע הפעולות הבאות ב-Edge קריאה ל-API בצומת של שרת הניהול: 
    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 נכשל.

עדכון ללא הגבלת זמן

עדכון ללא השבתה או עדכון בהדרגה (rolling), מאפשרים לכם לעדכן את התקנת 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 שהוגדרו לביצוע פעולת תיקון, אם יש כאלה קרן עד אחרי שהעדכון יסתיים.
  2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root).
  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. מורידים את קובץ 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
  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: OpenLDAP
      • 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-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. כדי להתקין את apigee-service מקובץ .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. התקנת כלי השירות 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 webserver" בדף 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-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: OpenLDAP
      • 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-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

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

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

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

  1. עדכון Cassandra ו-ZooKeeper במכונה 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 ו-ZooKeeper במכונה 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 ו-ZooKeeper במכונה 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 ו-ZooKeeper במכונות 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 ו-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. עדכון 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, ps
  4. LDAP
  5. קצה, שפירושו "קצה-c" פרופיל בכל הצמתים בסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתב.
  6. ממשק המשתמש של Edge (קלאסי או חדש)
  7. apigee-adminapi
  8. SSO ב-Apigee

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