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

Apigee תומכת בשדרוג של Edge לענן פרטי מגרסה 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 למצב שבו היה בזמן ביצוע הגיבוי. הערה: כל פריסות או שינויים בתשתית ב-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 בצמתים של הצופים והעוקבים

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

1. מורידים ומפעילים את שלבי האתחול של Edge ל-Cloud Private Cloud 4.52, כפי שמתואר במאמר עדכון לגרסה 4.52.00 בצומת עם חיבור חיצוני לאינטרנט. סביר להניח שהתהליך ישתנה בהתאם לכך שיש לצווארון חיבור חיצוני לאינטרנט או שמבצעים התקנה אופליין.
2. שדרוג הרכיב של Zooring:

     /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>

   הערה: אם בצמתים האלה מותקנים רכיבים אחרים (כמו Cassandra), אפשר לשדרג גם אותם עכשיו (למשל באמצעות פרופיל cs,k,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. מסירים את עובדי גן החיות הקיים:

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

שחזור הגיבוי

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

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

• מ-4.51.00 עד 4.52.00 (כשממשק המשתמש החדש של Edge כבר מותקן): מבצעים את ההוראות לשדרוג בקטע הזה לרכיב edge-management-ui.

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

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

• מסירים את 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. ממשיכים את העדכון בכל המכונות הנותרות בהתקנה.

לפני ואחרי העדכון, חשוב לבצע את הפעולות הבאות:

• בצומת המשולב של הנתב ומעבד ההודעות:
  • לפני העדכון – מבצעים את הפעולות הבאות:
    1. הגדרת הנתב שלא ניתן לגשת אליו.
    2. אי אפשר לגשת למעבד הבקשות.
  • אחרי העדכון – מבצעים את הפעולות הבאות:
    1. צריך לוודא שאפשר לגשת למעבד הבקשות.
    2. הגדרת הנתב כך שיהיה נגיש.
• בצמתים של רוטר יחיד:
  • לפני העדכון, צריך למנוע גישה לנתב.
  • אחרי העדכון, מאפשרים גישה לנתב.
• בצמתים בודדים של מעבדי הודעות:
  • לפני העדכון, צריך לוודא שמעבד ההודעות לא נגיש.
  • אחרי העדכון, צריך לוודא שאפשר לגשת למעבד ההודעות.

שימוש בקובץ תצורה ללא הודעות

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

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

      אפשר להשתמש באפשרות 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: שומר בגן החיות
      • 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-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: שומר בגן החיות
      • 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

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