יש לעדכן את 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 למשך השדרוג. אחרי שהשדרוג יושלם, תוכלו להוציא משימוש את צומת ה-standby החדש של Postgres.

    צומת ה-Postgres הנוסף במצב המתנה נדרש אם צריך לבצע חזרה לאחור של העדכון מסיבה כלשהי. אם תצטרכו לבצע ביטול עדכון, צומת ה-standby החדש של 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. עורכים את הקובץ /opt/apigee/customer/application/postgresql.properties במאסטר הנוכחי של Postgres כדי להגדיר את האסימון הבא. אם הקובץ הזה לא קיים, יוצרים אותו: 
    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

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

        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

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

        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. שדרוג 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. מריצים את הפקודה configure במארח הראשי: 
    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

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

  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. כדי לוודא שצומת ה-standby החדש הוסר, בודקים את הקובץ /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 לענן פרטי.

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

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

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

  3. כדי להתקין את apigee-service באמצעות שרת האינטרנט NGINX:
    1. מגדירים את שרת האינטרנט NGINX כפי שמתואר בקטע 'התקנה מהמאגר באמצעות שרת האינטרנט NGINX' במאמר התקנה של הכלי apigee-setup ל-Edge.
    2. בצומת המרוחק, מורידים את הקובץ bootstrap_4.51.00.sh של Edge אל /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: 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.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

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

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

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

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