יש לעדכן את 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 Cloud כוללת שדרוג ל-Zookeeper 3.8.0. כחלק מהשדרוג הזה, כל הנתונים של Zookeeper יועברו ל-Zookeeper 3.8.0.

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

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

באופן כללי, תהליך השדרוג כולל גיבוי של כל צומת. אחרי זה משדרגים את כל הצמתים מסוג observer ו-follower, ולבסוף משדרגים את הצומת מסוג leader.

גיבוי

מגבים את כל הצמתים של 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) או לשדרג את הרכיבים האחרים מאוחר יותר. ‫Apigee ממליצה לשדרג קודם רק את Zookeeper ולוודא שהאשכול פועל כמו שצריך לפני שמשדרגים רכיבים אחרים.
  3. חוזרים על השלבים שלמעלה בכל אחד מצומתי ה-observer וה-follower של ZooKeeper.

כיבוי המכשיר הראשי

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

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

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

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

בעזרת השלבים בקטע זיהוי ה-leader, ה-followers וה-observers שלמעלה, מוודאים שנבחר leader חדש מבין ה-followers, אחרי שה-leader הקיים נעצר. שימו לב שיכול להיות שהמנהיג נבחר במרכז נתונים אחר מזה של המנהיג הנוכחי.

מוביל השדרוג

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

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

חזרה לגרסה קודמת

אם צריך לחזור לגרסה הקודמת:

  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>
  • אחרי שכל הצמתים מסוג follower ו-observer חזרו לגרסה הקודמת, מחזירים את הצומת מסוג leader לגרסה הקודמת לפי שלבים 2 עד 5 בצומת מסוג leader.
  • אחרי שכל הצמתים חזרו לגרסה הקודמת, בודקים את תקינות האשכול ומוודאים שיש צומת מוביל באשכול.

    • שחזור הגיבוי

    איך משחזרים מהגיבוי שימו לב שגיבויים של 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 למשך השדרוג. אחרי שהשדרוג מסתיים, אפשר להוציא משימוש את צומת הגיבוי החדש של Postgres.

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

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

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

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

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

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

        1. מורידים את הקובץ Edge 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
        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 במקום, מבצעים את השלבים הבאים גם במארח הראשי וגם במארח הגיבוי כדי לעדכן את המאפיין 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. מריצים את פקודת ההגדרה במארח הראשי: 
      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

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

    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

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

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

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

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

    ממשק משתמש חדש של 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.52.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.50.00 או 4.51.00.

    עדכון לגרסה 4.52.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:

      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 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.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. מתקינים את כלי השירות Edge apigee-service ואת יחסי התלות שלו מ-/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. בצומת המרוחק, מורידים את קובץ ה-Edge bootstrap_4.52.00.sh אל /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. בצומת המרוחק, מתקינים את כלי השירות של Edge apigee-setup ואת יחסי התלות: 
          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 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.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

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