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

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

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

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

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

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

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

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

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

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

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

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

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

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

נדרש שדרוג ל-Zookeeper 3.8.0

הגרסה הזו של Edge for Private Clouds כוללת שדרוג ל-Zookeeper 3.8.0. כחלק מהשדרוג, כל נתוני Zookeeper יועברו ל-Zookeeper 3.8.0.

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

במהלך תהליך העדכון, יכול להיות עיכוב זמני או כשל בכתיבה ב-Zookeeper כשצומת המנהיג מושבת. הפעולה הזו עשויה להשפיע על פעולות ניהול שכותבות ב-Zookeeper, כמו פעולת פריסה של שרת proxy ושינוי בתשתית של Apigee, כמו הוספה או הסרה של מעבד הודעות וכו'. לא אמורה להיות השפעה על ממשקי ה-API בסביבת זמן הריצה של Apigee (אלא אם ממשקי ה-API האלה בסביבת זמן הריצה קוראים לממשקי API לניהול) במהלך השדרוג של Zookeeper לפי התהליך שמתואר בהמשך.

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

ביצוע גיבוי

יוצרים גיבוי של כל הצמתים ב-Zookeeper לשימוש במקרה שיהיה צורך בחזרה לגרסה קודמת. חשוב לזכור שביטול השינויים ישחזר את Zookeeper למצב שבו היה בזמן ביצוע הגיבוי. הערה: כל פריסות או שינויים בתשתית ב-Apigee מאז יצירת הגיבוי (שהמידע שלהם מאוחסן ב-Zookeeper) יאבדו במהלך השחזור.

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

אם אתם משתמשים במכונות וירטואליות ויש לכם את היכולת, תוכלו גם ליצור קובצי snapshot או גיבויים של המכונות הווירטואליות כדי לשחזר אותם או לבצע חזרה לאחור (אם צריך).

זיהוי של מנהיגים, עוקבים ומתבוננים

הערה: בפקודות לדוגמה שבהמשך נעשה שימוש בכלי nc כדי לשלוח נתונים ל-Zookeeper. אפשר גם להשתמש בכלים חלופיים כדי לשלוח נתונים ל-Zookeeper.

  1. אם הוא לא מותקן בצומת ZooKeeper, מתקינים את nc:
      sudo yum install nc
  2. מריצים את הפקודה הבאה של nc בצומת, כאשר 2181 הוא היציאה של ZooKeeper:
      echo stat | nc localhost 2181

    הפלט אמור להיראות כך:

      Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
      Clients:
       /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
      
      Latency min/avg/max: 0/0.2518/41
      Received: 647228
      Sent: 647339
      Connections: 4
      Outstanding: 0
      Zxid: 0x400018b15
      Mode: follower
      Node count: 100597

    בשורה Mode של הפלט של הצמתים, אמורה להופיע המילה observer (משתמש צופה), leader (מוביל) או follower (תומך, כלומר מעורב בבחירות אבל לא מוביל), בהתאם להגדרת הצומת. הערה: בהתקנה עצמאית של Edge עם צומת ZooKeeper יחיד, הערך של Mode מוגדר כ-standalone.

  3. חוזרים על שלבים 1 ו-2 בכל צומת של ZooKeeper.

שדרוג של Zookeeper בצמתים של הצופה והעוקב

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

  1. מורידים ומפעילים את ה-bootstrap של Edge for Private Cloud 4.52, כפי שמתואר במאמר עדכון לגרסה 4.52.00 בצומת עם חיבור אינטרנט חיצוני. סביר להניח שהתהליך ישתנה בהתאם לכך שיש לצווארון חיבור חיצוני לאינטרנט או שמבצעים התקנה אופליין.
  2. משדרגים את הרכיב Zookeeper:
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
    הערה: אם מותקנים בצמתים האלה רכיבים אחרים (כמו Cassandra), אפשר לשדרג אותם גם עכשיו (כמו עם פרופיל cs,zk) או לשדרג את הרכיבים האחרים מאוחר יותר. מומלץ לעדכן קודם את Zookeeper ולוודא שהאשכול פועל כמו שצריך, ואז לעדכן את שאר הרכיבים.
  3. חוזרים על השלבים שלמעלה בכל אחד מהצומתים של Zookeeper – צמתים צופים וצמתים עוקבים.

כיבוי המארח

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

חשוב לזכור שבמהלך האירוע הזה, לפני שנבחר מנהיג חדש, יכולים להיות עיכובים זמניים או כשלים בכתיבה ב-Zookeeper. זה עלול להשפיע על פעולות שכותבות ב-Zookeeper, כמו פעולות פריסה של שרתים proxy או שינויים בתשתית של Apigee, כמו הוספה או הסרה של מעבדי הודעות וכו'.

מוודאים שהמנהיג החדש נבחר

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

מנהיג השדרוג

פועלים לפי אותם השלבים שמפורטים בקטע שדרוג Zookeeper בצמתים של משקיפים ומשתמשי עוקב למעלה.

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

Rollback

במקרה שנדרש החזרה לאחור:

  1. קודם מבצעים את השלבים להחזרת הגרסה הקודמת במעקבים ובעוקבים.
  2. מורידים ומפעילים את קובץ ה-bootstrap של הגרסה שאליה רוצים לחזור – 4.50 או 4.51. סביר להניח שהתהליך ישתנה בהתאם לכך שיש לצווארון חיבור חיצוני לאינטרנט או שאתם מבצעים התקנה אופליין.
  3. מפסיקים את Zookeeper אם הוא פועל בצומת:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. מסירים את zookeeper הקיים:
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  • מתקינים את Zookeeper כרגיל:
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  • אחרי שמבצעים חזרה לאחור לכל הצמתים הבאים אחרי הצומת המוביל ומצפינים בו, מבצעים חזרה לאחור בצומת המוביל לפי השלבים 2 עד 5.
  • אחרי שמבטלים את כל השינויים בצמתים, בודקים את תקינות האשכולות ומוודאים שיש צומת מוביל באשכולות.
  • שחזור הגיבוי

    אפשר לעיין במאמר שחזור מהגיבוי. הערה: גיבויים של Zookeeper שנלקחו מגרסאות קודמות של Edge for Private Cloud, כמו 4.50 ו-4.51, אמורים להיות תואמים לגרסה של Zookeeper ב-Edge for Private Cloud 4.52.

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

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

    ברוב מערכות הייצור של 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. לאחר מכן, אם יהיו שגיאות במהלך העדכון ותצטרכו לבצע ביטול משיכה (roll back), תוכלו לשחזר את צומת Postgres מקובץ ה-snapshot הזה.

    התקנת צומת חלופי חדש של Postgres

    בעזרת התהליך הזה יוצרים שרת Postgres במצב המתנה בצומת חדש. חשוב לוודא שמתקינים שרת Postgres חלופי חדש לגרסה הקיימת של Edge (4.50.00 או 4.51.00), ולא לגרסה 4.52.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 4.51.00:

        1. מורידים את הקובץ bootstrap_4.51.00.sh של Edge אל /tmp/bootstrap_4.51.00.sh :
          curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
        2. מתקינים את השירות apigee-service של Edge ואת יחסי התלות שלו:
          sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

        אם אתם משתמשים כרגע ב-Edge 4.50.00:

        1. מורידים את הקובץ 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
        2. מתקינים את השירות 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, צריך לבצע את השלב המקדים הבא.

    שלב מקדים

    לפני שמבצעים שדרוג במקום ל-Postgres, צריך לבצע את השלבים הבאים גם במארח הראשי וגם במארח ה-standby כדי לעדכן את הנכס max_locks_per_transaction ב-apigee-postgresql:

    1. אם הקובץ לא קיים, יוצרים אותו בשם /opt/apigee/customer/application/postgresql.properties.
    2. משנים את הבעלות על הקובץ הזה ל-apigee:
      sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
    3. מוסיפים לקובץ את המאפיין הבא:
      conf/postgresql.conf+max_locks_per_transaction=30000
    4. מגדירים את apigee-postgresql:
      apigee-service apigee-postgresql configure
    5. מפעילים מחדש את apigee-postgresql:
      apigee-service apigee-postgresql restart

    ביצוע השדרוג במקום

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

    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 משודרגת לגרסה 14, אפשר להתעלם מהשגיאה.

      /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
    12. מסירים את השורה conf/postgresql.conf+max_locks_per_transaction=30000 מהקובץ /opt/apigee/customer/application/postgresql.properties גם במארח הראשי וגם במארח הניצב. השורה הזו נוספה בשלב המקדים.

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

    הוצאה משימוש של צומת 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 באמצעות הקריאה הבאה ל-API לניהול של Edge בצומת של שרת הניהול:
      curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

    השלבים שלאחר השדרוג ל-Postgres

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

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

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

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

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

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

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

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

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

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

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

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

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

    ביטול עדכון

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

    אם כתוצאה מהכשל צריך לבצע החזרה לגרסה הקודמת, תוכלו לקרוא את ההוראות המפורטות במאמר החזרה לגרסה 4.52.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.50.00 או 4.51.00.

    עדכון לגרסה 4.52.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. אם אתם משתמשים כרגע ב-Edge 4.51.00:

      1. מורידים את הקובץ bootstrap_4.52.00.sh של Edge אל /tmp/bootstrap_4.52.00.sh:
        curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
      2. כדי להתקין את השירות apigee-service ואת יחסי התלות שלו ב-Edge 4.52.00, מריצים את הפקודה הבאה:
        sudo bash /tmp/bootstrap_4.52.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 בעצמכם.
      3. משתמשים בפקודה apigee-service כדי לעדכן את השירות apigee-setup, כפי שמתואר בדוגמה הבאה:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      4. מעדכנים את השירות apigee-validate בשרת הניהול, כפי שמתואר בדוגמה הבאה:
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      5. מעדכנים את השירות apigee-provision בשרת הניהול, כפי שמתואר בדוגמה הבאה:
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      6. מריצים את השירות update בצמתים באמצעות הפקודה הבאה:
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

        כאשר:

        • component הוא רכיב Edge שרוצים לעדכן. הערכים האפשריים כוללים:
          • cs: Cassandra
          • edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
          • ldap: OpenLDAP
          • ps: postgresql
          • qpid: qpidd
          • sso: Apigee SSO (אם התקנתם SSO)
          • ue: ממשק המשתמש החדש של Edge
          • ui: ממשק המשתמש הקלאסי של Edge
          • zk: Zookeeper
        • configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את הרכיבים של Edge במהלך ההתקנה של גרסת 4.50.00 או 4.51.00.

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

        /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
      7. מפעילים מחדש את רכיבי ממשק המשתמש של Edge בכל הצמתים שבהם הם פועלים, אם עדיין לא עשיתם זאת:
        /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
      8. בודקים את העדכון על ידי הפעלת הכלי apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

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

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

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

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

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

      כדי לעדכן ממאגר מקומי של גרסת 4.52.00:

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

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

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

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

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

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

        3. בצומת המרוחק, מתקינים את השירות apigee-setup של Edge ואת יחסי התלות שלו:
          sudo bash /tmp/bootstrap_4.52.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

          כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.

      4. משתמשים בפקודה apigee-service כדי לעדכן את השירות apigee-setup, כפי שמתואר בדוגמה הבאה:
        /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 
      5. מעדכנים את השירות apigee-validate בשרת הניהול, כפי שמתואר בדוגמה הבאה:
        /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      6. מעדכנים את השירות apigee-provision בשרת הניהול, כפי שמתואר בדוגמה הבאה:
        /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
      7. מריצים את הכלי update בצמתים לפי הסדר שמתואר בקטע סדר העדכון של המכונות:
        /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

        כאשר:

        • component הוא רכיב Edge שרוצים לעדכן. בדרך כלל מעדכנים את הרכיבים הבאים:
          • cs: Cassandra
          • edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID ושרת Postgres
          • ldap: OpenLDAP
          • ps: postgresql
          • qpid: qpidd
          • sso: Apigee SSO (אם התקנתם SSO)
          • ue ממשק המשתמש החדש של Edge
          • ui: ממשק המשתמש הקלאסי של Edge
          • zk: Zookeeper
        • configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסת 4.50.00 או 4.51.00.

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

        /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
      8. מפעילים מחדש את רכיבי ממשק המשתמש בכל הצמתים שבהם הם פועלים, אם עדיין לא עשיתם זאת:
        /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
      9. בודקים את העדכון על ידי הפעלת הכלי apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

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

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

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

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

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

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