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

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

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

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

אחרי שמתקינים את ה-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.

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

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

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

התקנת צומת המתנה חדש של 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 כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
    3. מבצעים אחת מהפעולות הבאות, בהתאם לגרסה של Edge שמשדרגים ממנה:
      • אם אתם משדרגים מ-Edge 4.19.06, הורידו את הקובץ bootstrap_4.19.06.sh של Edge אל /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, מורידים את הקובץ bootstrap_4.50.00.sh של Edge אל /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

      מוודאים שמופיע הכיתוב "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 Management 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 ל-Private Cloud.

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

אחרי שמסיימים את ההתקנה הראשונית, מומלץ להתקין את ממשק המשתמש של Edge, שהוא ממשק משתמש משופר למפתחים ולאדמינים של Apigee Edge for Private Cloud.

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

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

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

כדי לעדכן את רכיב ממשק המשתמש של Edge, צריך לבדוק מאיזו גרסה של Edge for Private Cloud אתם משדרגים:

עדכון באמצעות 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 צמתים ומעלה.

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

  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, מתחברים לצומת כמשתמש root.
  3. התקנת yum-utils ו-yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
  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, תתבקשו להזין אותו.

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

    אפשר להשתמש באפשרות 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: Cassandra
      • ‫edge: כל רכיבי Edge חוץ מ-Edge UI: ‏Management Server, ‏Message Processor, ‏Router, ‏QPID Server, ‏Postgres Server
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • ‫sso: מודול SSO ב-Apigee (אם התקנתם את SSO)
      • ue: ממשק משתמש חדש של Edge
      • ui: ממשק המשתמש הקלאסי של Edge
      • zk: Zookeeper
    • ‫configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסה 4.19.06 או 4.50.00.

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

    /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 מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
  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. מתקינים את כלי השירות Edge apigee-service ואת יחסי התלות שלו מ-/tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. כדי להתקין את apigee-service באמצעות שרת האינטרנט NGINX:
    1. מגדירים את שרת האינטרנט NGINX כמו שמתואר בקטע "Install from the repo using the NGINX webserver" במאמר Install the Edge apigee-setup utility.
    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. בצומת המרוחק, מתקינים את כלי השירות של Edge apigee-setup ואת יחסי התלות: 
      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: Cassandra
      • ‫edge: כל רכיבי Edge חוץ מ-Edge UI: ‏Management Server, ‏Message Processor, ‏Router, ‏QPID Server, ‏Postgres Server
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • ‫sso: מודול SSO ב-Apigee (אם התקנתם את SSO)
      • ue ממשק המשתמש החדש של Edge
      • ui: ממשק המשתמש הקלאסי של Edge
      • zk: Zookeeper
    • ‫configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסה 4.19.06 או 4.50.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.51.00.

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

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

  • צריך לעדכן את כל הצמתים של Cassandra ו-ZooKeeper לפני שמעדכנים צמתים אחרים.
  • בכל מכונה עם כמה רכיבי 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 צמתים

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

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

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