עדכון של Apigee Edge ל-4.16.09

Edge for Private Cloud גרסה 4.16.09

אילו גרסאות של Edge אפשר לעדכן לגרסה 4.16.09

אתם יכולים לעדכן את Apigee Edge מגרסה 4.16.01.0x ו-4.16.05.x לגרסה 4.16.09.

אם יש לכם גרסה של Edge שקודמת לגרסה 4.16.01, קודם אתם צריכים לעבור לגרסה 4.16.01.x ואז לעדכן לגרסה 4.16.09.

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

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

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

שדרוג חובה ל-Java JDK גרסה 8

כדי להשתמש בגרסה הזו של Edge, צריך להתקין את Java JDK גרסה 8 בכל צומתי העיבוד של Edge. אפשר להתקין את Oracle JDK 8 או את OpenJDK 8. אם Java JDK 8 עדיין לא מותקן, סקריפט העדכון יכול להתקין אותו בשבילכם.

במסגרת העדכון ל-Java 8, חלק מהצפנות ה-TLS כבר לא זמינות ב-Oracle JDK 8. הרשימה המלאה מופיעה בקטע Default Disabled Cipher Suites בכתובת http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

שדרוג לאחור של Zookeeper אם מעדכנים מגרסה 4.16.01

גרסת ה-RPM של Zookeeper ב-Edge for Private Cloud 4.16.01 היא apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. בגרסאות הבאות של Edge, גרסת Zookeeper שונתה בחזרה ל-apigee-zookeeper-3.4.5-0.0.94x. כך מונעים מ-yum לשדרג את Zookeeper לגרסאות מאוחרות יותר מ-4.16.01. כדי לתקן את המצב, צריך להריץ את הפקודה yum downgrade apigee-zookeeper לפני שמעדכנים את Zookeeper.

כדי לבדוק את הגרסה של Zookeeper, משתמשים בפקודה הבאה:

> rpm -qa |grep apigee-zookeeper

אם הפקודה הזו מחזירה את גרסת Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

ואז צריך לשדרג לאחור.

הפצה אוטומטית של הגדרות הנכס

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

דרישות מוקדמות לעדכון

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

• גיבוי כל הצמתים
  לפני העדכון, מומלץ לבצע גיבוי מלא של כל הצמתים מטעמי בטיחות. כדי לבצע את הגיבוי, משתמשים בהליך שמתאים לגרסה הנוכחית של Edge.
  
  כך תהיה לכם תוכנית גיבוי למקרה שהעדכון לגרסה החדשה לא יפעל כמו שצריך. מידע נוסף על גיבוי זמין במאמר גיבוי ושחזור.
• מוודאים ש-Edge פועל
  מוודאים ש-Edge פועל במהלך תהליך העדכון באמצעות הפקודה:
  
  > ‎/<inst_root>/apigee/apigee-service/bin/apigee-all status

מה עושים אם העדכון נכשל

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

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

רישום פרטי העדכון

כברירת מחדל, כלי השירות update.sh כותב את פרטי היומן בנתיב:

/opt/apigee/var/log/apigee-setup/update.log

אם למשתמש שמפעיל את הכלי update.sh אין גישה לספרייה הזו, הכלי כותב את היומן בספרייה ‎/tmp כקובץ בשם update_username.log.

אם למשתמש אין גישה אל ‎/tmp, הכלי update.sh נכשל.

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

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

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

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

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

התהליך הזה יוצר שרת המתנה של Postgres בצומת חדש. חשוב להתקין שרת Postgres חדש במצב המתנה לגרסה הקיימת של Edge‏ (4.16.01 או 4.16.05), ולא לגרסה 4.16.09.

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

כדי ליצור צומת המתנה חדש של Postgres:

1. ב-Postgres הראשי הנוכחי, עורכים את הקובץ /opt/apigee/customer/application/postgresql.properties כדי להגדיר את הטוקן הבא. אם הקובץ לא קיים, יוצרים אותו:
   
   conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust
   
   כאשר existing_slave_ip היא כתובת ה-IP של שרת הגיבוי הנוכחי של Postgres, ו-new_slave_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_slave_ip/32 trust
   host replication apigee new_slave_ip/32 trust
4. מתקינים את שרת הגיבוי החדש של Postgres:
   1. עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge, ומציינים את הפרטים הבאים:
      
      # כתובת IP של ה-master הנוכחי:
      PG_MASTER=192.168.56.103
      # כתובת IP של ה-standby node החדש
      PG_STANDBY=192.168.56.102
   2. משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
   3. מורידים את הקובץ bootstrap_4.16.05.sh של Edge אל ‎/tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
      
      הערה: אם אתם מעדכנים מגרסה 4.16.01, הורידו את הקובץ bootstrap.sh של Edge.
   4. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
   5. משתמשים ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
   6. מתקינים את Postgres:
      > ‎/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
   7. בצומת ההמתנה החדש, מריצים את הפקודה הבאה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
      
      מוודאים שכתוב שהוא במצב המתנה.

הוצאה משימוש של צומת Postgres

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

1. מוודאים ש-Postgres פועל:
   > /opt/apigee/apigee-service/bin/apigee-all status
   
   אם Postgres לא פועל, מפעילים אותו:
   > /opt/apigee/apigee-service/bin/apigee-all start
2. מריצים את פקודת ה-cURL הבאה בצומת ההמתנה החדש כדי לקבל את ה-UUID שלו:
   > 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_slave_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_slave_ip/32 trust
7. מוחקים את ה-UUID של צומת הגיבוי מ-ZooKeeper על ידי ביצוע הקריאה הבאה ל-Edge Management API בצומת של שרת הניהול:
   > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

עדכון ללא זמן השבתה

עדכון ללא זמן השבתה, או עדכון בהדרגה (rolling), מאפשר לעדכן את ההתקנה של Edge בלי להשבית את Edge.

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

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

1. מעדכנים את המכונות בסדר הנכון להתקנה, כמו שמתואר בהמשך בקטע "סדר עדכון המכונות".
2. כשיגיע הזמן לעדכן את הנתבים, בוחרים נתב אחד והופכים אותו לבלתי נגיש, כפי שמתואר במאמר הפעלה/השבתה של יכולת הגעה (reachability) לשרת (מעבד בקשות/נתב).
3. מעדכנים את הנתב שנבחר ואת כל רכיבי Edge האחרים באותו מחשב כמו הנתב. בכל ההגדרות של Edge מוצגים נתב ומעבד בקשות באותו צומת.
4. צריך לוודא שהנתב זמין שוב.
5. חוזרים על שלבים 2 עד 4 בשאר הנתבים.
6. ממשיכים לעדכן את שאר המחשבים בהתקנה.

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

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

שימוש בקובץ תצורה שקט

צריך להעביר קובץ תצורה שקט לפקודת העדכון. קובץ התצורה השקט צריך להיות זהה לזה שבו השתמשתם כדי להתקין את Edge 4.16.01 או 4.16.05.

תהליך העדכון לגרסה 4.16.09 בצומת עם חיבור חיצוני לאינטרנט

כדי לעדכן את רכיבי Edge בצומת:

1. אם אתם משתמשים כרגע ברפליקציה של Postgres master-standby, התקינו צומת המתנה חדש של Postgres כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
2. אם יש משימות CRON שמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
3. כדי להתקין את חבילות ה-RPM של Edge, מתחברים לצומת כמשתמש root.
   הערה: כדי להתקין את RPM נדרשת גישת root, אבל אפשר להגדיר את Edge בלי גישת root.
4. משביתים את SELinux כמו שמתואר במאמר התקנת הכלי apigee-setup של Edge.
5. מורידים את הקובץ bootstrap_4.16.09.sh של Edge 4.16.09 אל ‎/tmp/bootstrap_4.16.09.sh:
   > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
6. מתקינים את כלי השירות apigee-service של Edge 4.16.09 ואת יחסי התלות:
   > sudo bash /tmp/bootstrap_4.16.09.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 בעצמכם.
7. משתמשים ב-apigee-service כדי לעדכן את כלי השירות apigee-setup:
   1. אם התקנתם את גרסה 4.16.01 על ידי שדרוג של Edge מגרסה 4.15.07.0x, אתם צריכים להתקין את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      
      הפקודה הזו מתקינה את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
      
      אם כבר התקנתם את הכלי apigee-setup, צריך לעדכן אותו:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
   2. אם התקנתם את גרסה 4.16.01 ישירות, כלומר לא שדרגתם מגרסה 4.15.07.0x, אתם צריכים לעדכן את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      העדכון הזה ל-apigee-service מתקין את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
   3. אם התקנת את גרסה 4.16.05 ישירות או באמצעות עדכון, עליך לעדכן את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      עדכון זה ל-apigee-service מתקין את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
8. בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את כלי השירות apigee-validate בשרת הניהול.
   1. אם אתם משתמשים כרגע ב-Edge 4.16.05: מעדכנים את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
   2. אם אתם משתמשים כרגע ב-Edge 4.16.01: מתקינים את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
      
      הערה: אם התקנתם את כלי השירות apigee-validate בצומת של מעבד בקשות כשהתקנתם את 4.16.01, אתם יכולים לעדכן אותו באמצעות הפקודה הבאה בצומת הזה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      
      עם זאת, החל מגרסה 4.16.05 ואילך, Apigee ממליצה להתקין ולהפעיל את כלי השירות apigee-validate בשרת הניהול.
   3. אם משדרגים מגרסה 4.16.01: עורכים את קובץ התצורה שמועבר לכלי apigee-validate. בגרסה 4.16.01 של Edge, קובץ התצורה ששימש את apigee-validate דרש את המאפיינים הבאים:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1
      
      בגרסה הזו, קובץ התצורה דורש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
9. עדכון כלי השירות apigee-provision:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
10. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "סדר עדכון המכונות" בהמשך:
    > ‎/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    
    הדרישה היחידה לגבי קובץ התצורה היא שהוא יהיה נגיש או קריא למשתמש apigee.
    
    משתמשים באפשרות "‎-c" כדי לציין את הרכיב שרוצים לעדכן. רשימת הרכיבים האפשריים כוללת:
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =כל רכיבי Edge, חוץ מ-Edge UI: Management Server, ‏ Message Processor, ‏ Router, ‏ QPID Server, ‏ Postgres Server
    ui = Edge UI
    all = עדכון כל הרכיבים במכונה (משתמשים רק בפרופיל התקנה של Edge aio או בפרופיל התקנה של API BaaS asa)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, ‏ API BaaS Stack ו-API BaaS Portal באותו צומת
11. בודקים את העדכון על ידי הפעלת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
12. אם התקנתם צומת המתנה חדש של Postgres, הוציאו אותו משימוש כמו שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

כדי לחזור לגרסה הקודמת של העדכון, צריך להשתמש בהליך שמתואר בקטע 4.16.09 Rollback Process.

תהליך העדכון לגרסה 4.16.09 ממאגר מקומי

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

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

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

כדי לעדכן ממאגר מקומי בגרסה 4.16.09:

1. אם אתם משתמשים כרגע ברפליקציה של Postgres master-standby, התקינו צומת המתנה חדש של Postgres כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
2. יוצרים מאגר מקומי של גרסה 4.16.09, כמו שמתואר בקטע "יצירת מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
   הערה: אם כבר יש לכם מאגר קיים בגרסה 4.16.01 או 4.16.05, אתם יכולים להוסיף לו את המאגר בגרסה 4.16.09, כמו שמתואר בקטע "עדכון מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
3. כדי להתקין את apigee-service מקובץ ‎ .tar:
   1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ ‎ .tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.16.09.tar.gz:
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   2. מעתיקים את קובץ ה-‎ .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה ‎/tmp בצומת החדש.
   3. בצומת החדש, מחלצים את הקובץ לספרייה ‎ /tmp:
      > tar -xzf apigee-4.16.09.tar.gz
      
      הפקודה הזו יוצרת ספרייה חדשה בשם repos בספרייה שמכילה את קובץ ה-‎ .tar. לדוגמה, ‎ /tmp/repos.
   4. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות מ-‎ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.16.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      שימו לב שאתם כוללים את הנתיב לספריית המאגרים בפקודה הזו.
4. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
   1. מגדירים את שרת האינטרנט Nginx כמו שמתואר בקטע "התקנה מהמאגר באמצעות שרת האינטרנט Nginx" במאמר התקנת כלי השירות apigee-setup של Edge.
   2. בצומת המרוחק, מורידים את הקובץ bootstrap_4.16.09.sh של Edge אל /tmp/bootstrap_4.16.09.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
      
      כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה למאגר, ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של צומת המאגר.
   3. בצומת המרוחק, מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
      > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      
      כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.
5. משתמשים ב-apigee-service כדי לעדכן את כלי השירות apigee-setup:
   1. אם התקנתם את גרסה 4.16.01 על ידי שדרוג גרסה 4.15.07.0x של Edge, אתם צריכים להתקין את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
      
      הפקודה הזו מתקינה את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
      
      אם כבר התקנתם את הכלי apigee-setup, צריך לעדכן אותו:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
   2. אם התקנתם את גרסה 4.16.01 ישירות, כלומר לא שדרגתם מגרסה 4.15.07.0x, אתם צריכים לעדכן את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      העדכון הזה ל-apigee-service מתקין את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
   3. אם התקנתם את גרסה 4.16.05 ישירות או באמצעות עדכון, אתם צריכים לעדכן את כלי השירות apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      העדכון הזה ל-apigee-service מתקין את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
6. בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את כלי השירות apigee-validate בשרת הניהול.
   1. אם אתם משתמשים כרגע ב-Edge 4.16.05: מעדכנים את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
   2. אם אתם משתמשים כרגע ב-Edge 4.16.01: התקינו את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
      
      הערה: אם התקנתם את כלי השירות apigee-validate בצומת של מעבד בקשות כשהתקנתם את 4.16.01, תוכלו לעדכן אותו באמצעות הפקודה הבאה בצומת הזה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
      
      עם זאת, החל מגרסה 4.16.05 ואילך, Apigee ממליצה להתקין ולהפעיל את כלי השירות apigee-validate בשרת הניהול.
   3. אם משדרגים מגרסה 4.16.01: עורכים את קובץ התצורה שמועבר לכלי apigee-validate. בגרסה 4.16.01 של Edge, קובץ התצורה ששימש את apigee-validate דרש את המאפיינים הבאים:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1
      
      בגרסה הזו, קובץ התצורה דורש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
7. עדכון כלי השירות apigee-provision:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
8. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "סדר עדכון המכונות" בהמשך:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
   
   הדרישה היחידה לגבי קובץ התצורה היא שהוא יהיה נגיש או קריא למשתמש apigee.
   
   משתמשים באפשרות "‎-c" כדי לציין את הרכיב שרוצים לעדכן. רשימת הרכיבים האפשריים כוללת:
   ldap = OpenLDAP
   cs = Cassandra
   zk = Zookeeper
   qpid = qpidd
   ps = postgresql
   edge =כל רכיבי Edge, חוץ מ-Edge UI: Management Server, ‏ Message Processor, ‏ Router, ‏ QPID Server, ‏ Postgres Server
   ui = Edge UI
   all = עדכון כל הרכיבים במכונה (משתמשים רק בפרופיל התקנה של Edge aio או בפרופיל התקנה של API BaaS asa)
   e = ElasticSearch
   b = API BaaS Stack
   p = API BaaS Portal
   ebp = ElasticSearch, ‏ API BaaS Stack ו-API BaaS Portal באותו צומת
9. בודקים את העדכון על ידי הפעלת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
10. אם התקנתם צומת המתנה חדש של Postgres, הוציאו אותו משימוש כמו שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

כדי לחזור לגרסה הקודמת של העדכון, צריך להשתמש בהליך שמתואר בקטע 4.16.09 Rollback Process.

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

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

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

להתקנה עצמאית במארח אחד

1. אם אתם משדרגים מגרסה 4.16.01, צריך לשדרג לאחור את Zookeeper:
   > yum downgrade apigee-zookeeper
2. מעדכנים את Cassandra ו-ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. מעדכנים את qpidd:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
4. מעדכנים את LDAP:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
5. עוצרים את שרת Postgres, שרת Qpid ו-PostgreSQL:
   > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
6. מעדכנים את postgresql:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
7. מעדכנים את מסד הנתונים של Postgres:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
8. מעדכנים את שאר הרכיבים של Edge:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
9. מעדכנים את ממשק המשתמש של Edge:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

להתקנה עצמאית עם 2 מארחים

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

1. אם אתם משדרגים מגרסה 4.16.01, צריך לשדרג לאחור את Zookeeper במכונה 1:
   > yum downgrade apigee-zookeeper
2. מעדכנים את Cassandra ו-ZooKeeper במכונה 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. מעדכנים את qpidd במכונה 2:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
4. מעדכנים את LDAP במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
5. מעדכנים את רכיבי Edge במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
6. מעדכנים את ממשק המשתמש במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
7. מעדכנים את postgresql במכונה 2:
   1. עוצרים את שרת Postgres, שרת Qpid ו-postgresql:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   2. מעדכנים את postgresql:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   3. מעדכנים את מסד הנתונים של Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   4. מעדכנים את רכיבי Edge במכונה 2 ובמכונה 1:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. מעדכנים את רכיבי Edge במכונה 2:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

להתקנה באשכול של 5 מארחים

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

1. מוודאים שהתקנתם צומת המתנה חדש של Postgres, כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
2. אם אתם מעדכנים מגרסה 4.16.01, צריך לשדרג לאחור את Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
3. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. מעדכנים את qpidd במכונות 4 ו-5:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. מעדכנים את LDAP במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. מעדכנים את רכיבי Edge במכונות 1, 2, 3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. מעדכנים את ממשק המשתמש במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
8. עדכון מכונות 4 ו-5:
   1. עוצרים את שרת Postgres ואת שרת Qpid במכונה 4:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   2. עוצרים את שרת Postgres, שרת Qpid ו-postgresql במכונה 5:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. עוצרים את שרת Postgres ואת postgresql בצומת ההמתנה החדש שהוספתם לצורך החזרה למצב הקודם:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   4. מעדכנים את postgresql במכונות 4:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   5. מעדכנים את מסד הנתונים של Postgres במכונה 4 (רק ב-Postgres master):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   6. מעדכנים את postgresql במכונה 5:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   7. מפעילים את שרת Postgres ואת שרת Qpid במכונות 4 ו-5:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      ‎> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   8. מגדירים את Postgres כצומת המתנה על ידי הפעלת הפקודות הבאות במכונה 5:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
   9. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי לוודא שהשכפול בוצע בהצלחה:
      
      במכונה 4, צומת המאסטר, מריצים:
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
      
      מוודאים שכתוב שזה המאסטר.
      
      במכונה 5, צומת ההמתנה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
      
      מוודאים שכתוב שהיא במצב המתנה.
9. מעדכנים את רכיבי Edge במכונות 4 ו-5:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. חשוב להוציא משימוש את הצומת החדש במצב המתנה, לפי ההליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

להתקנה באשכול של 9 מארחים

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

1. מוודאים שהתקנתם צומת המתנה חדש של Postgres, כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
2. אם אתם מעדכנים מגרסה 4.16.01, צריך לשדרג לאחור את Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
3. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. מעדכנים את qpidd במכונות 6 ו-7:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. מעדכנים את LDAP במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. מעדכנים את רכיבי Edge במכונות 6, 7, 1, 4 ו-5 בסדר הזה:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. מעדכנים את ממשק המשתמש במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
8. עדכון מכונות 8 ו-9:
   1. עוצרים את שרת Postgres במכונה 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   2. עוצרים את שרת Postgres ואת postgresql במכונה 9:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. עוצרים את שרת Qpid במכונות 6 ו-7:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   4. עוצרים את שרת Postgres ואת postgresql בצומת ההמתנה החדש שהוספתם לצורך החזרה למצב הקודם:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   5. מעדכנים את postgresql במכונות 8:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. מעדכנים את מסד הנתונים של Postgres במכונה 8 (רק ב-Postgres הראשי):
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. מעדכנים את postgresql במכונות 9:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   8. מפעילים את שרת Postgres במכונות 8 ו-9:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
   9. מפעילים את שרת Qpid במכונות 6 ו-7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. מגדירים את Postgres כצומת המתנה על ידי הפעלת הפקודות הבאות במכונה 9:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
   11. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי לוודא שהשכפול בוצע בהצלחה:
       במכונה 8, צומת המאסטר, מריצים את הפקודה:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       מוודאים שמופיע הכיתוב שזהו המאסטר.
       
       במכונה 9, צומת ההמתנה:
       > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       מוודאים שמופיע הכיתוב standby.
9. מעדכנים את רכיבי Edge במכונות 8 ו-9:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. חשוב להוציא משימוש את הצומת החדש במצב המתנה, לפי ההליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

להתקנה באשכול של 13 מארחים

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

1. מוודאים שהתקנתם צומת המתנה חדש של Postgres, כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
2. אם אתם מעדכנים מגרסה 4.16.01, צריך לשדרג לאחור את Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
3. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. מעדכנים את qpidd במכונות 12 ו-13:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
5. מעדכנים את LDAP במכונות 4 ו-5:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. מעדכנים את רכיבי Edge במכונות 12, 13, 6, 7, 10 ו-11 בסדר הזה:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. מעדכנים את ממשק המשתמש במכונות 6 ו-7:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
8. עדכון מכונות 8 ו-9:
   1. עוצרים את שרת Postgres במכונה 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   2. עוצרים את שרת Postgres ואת postgresql במכונה 9:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. עוצרים את שרת Qpid במכונות 12 ו-13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   4. עוצרים את שרת Postgres ואת postgresql בצומת ההמתנה החדש שהוספתם לצורך החזרה למצב הקודם:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   5. מעדכנים את postgresql במכונות 8:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. מעדכנים את מסד הנתונים של Postgres במכונה 8 (רק ב-Postgres הראשי):
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. מעדכנים את postgresql במכונות 9:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   8. מפעילים את שרת Postgres במכונות 8 ו-9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
   9. מפעילים את שרת Qpid במכונות 12 ו-13:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. מגדירים את Postgres כצומת המתנה על ידי הפעלת הפקודות הבאות במכונה 9:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
   11. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי לוודא שהשכפול בוצע בהצלחה:
       במכונה 8, צומת המאסטר, מריצים את הפקודה:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       מוודאים שמופיע הכיתוב שזהו המאסטר.
       
       במכונה 9, צומת ההמתנה:
       > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       מוודאים שמופיע הכיתוב standby.
9. מעדכנים את רכיבי Edge במכונות 8 ו-9:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. חשוב להוציא משימוש את הצומת החדש במצב המתנה, לפי ההליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

להתקנה באשכול של 12 מארחים

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

1. מוודאים שהתקנתם צומת המתנה חדש של Postgres, כמו שמתואר למעלה בקטע התקנת צומת המתנה חדש של Postgres.
2. מעדכנים את Cassandra ואת ZooKeeper:
   1. אם אתם משדרגים מגרסה 4.16.01, צריך לשדרג לאחור את Zookeeper במכונות 1, 2 ו-3 במרכז נתונים 1:
      > yum downgrade apigee-zookeeper
   2. במכונות 1, 2 ו-3 במרכז נתונים 1:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
   3. אם אתם משדרגים מגרסה 4.16.01, צריך לשדרג לאחור את Zookeeper במכונות 7, 8 ו-9 במרכז הנתונים 2:
      > yum downgrade apigee-zookeeper
   4. במכונות 7, 8 ו-9 במרכז הנתונים 2
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. מעדכנים את qpidd:
   1. מכונות 4, 5 במרכז נתונים 1
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
   2. מכונות 10, 11 במרכז נתונים 2
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -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, 1, 2, 3 במרכז נתונים 1
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
   2. מכונות 10, 11, 7, 8, 9 במרכז נתונים 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
6. עדכון ממשק המשתמש:
   1. מכונה 1 במרכז נתונים 1:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
   2. מכונה 7 במרכז נתונים 2:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
7. מעדכנים את מכונה 6 במרכז נתונים 1 ואת מכונה 12 במרכז נתונים 2:
   1. עוצרים את שרת Postgres במכונה 6:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
   2. עוצרים את שרת Postgres ואת postgresql במכונה 12:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. עוצרים את שרת Qpid במכונות 4, 5, 10 ו-11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   4. עוצרים את שרת Postgres ואת postgresql בצומת ההמתנה החדש שהוספתם לצורך החזרה למצב הקודם:
      > ‎/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   5. מעדכנים את postgresql במכונות 6:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile‎
   6. מעדכנים את מסד הנתונים של Postgres במכונה 6 (רק ב-Postgres הראשי):
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. מעדכנים את postgresql במכונות 12:
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   8. מפעילים את שרת Postgres במכונות 6 ו-12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
   9. מפעילים את שרת Qpid במכונות 4, 5, 10 ו-11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. מגדירים את Postgres כצומת המתנה על ידי הפעלת הפקודות הבאות במכונה 12:
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
   11. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול מוצלח:
       במכונה 6, צומת המאסטר, מריצים:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       מוודאים שכתוב שזה המאסטר.
       
       במכונה 12, צומת ההמתנה:
       > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       מוודאים שכתוב שהצומת במצב המתנה.
8. מעדכנים את רכיבי Edge במכונות 6 ו-12:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
9. חשוב להוציא משימוש את הצומת החדש במצב המתנה, לפי ההליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

להתקנת API BaaS עם 7 מארחים

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

1. מעדכנים את Cassandra במכונות 5, 6 ו-7:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
2. מעדכנים את ElasticSearch ואת API BaaS Stack במכונות 1, 2 ו-3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
3. מעדכנים את פורטל API BaaS במכונה 4:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

להתקנה של API BaaS עם 10 מארחים

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

1. מעדכנים את Cassandra במכונות 8, 9 ו-10:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile‎
2. מעדכנים את ElasticSearch במכונות 1, 2 ו-3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
3. מעדכנים את API BaaS Stack במכונות 4, 5 ו-6:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c b -f configFile‎
4. מעדכנים את פורטל API BaaS במכונה 7:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c p -f configFile‎

להתקנה לא סטנדרטית

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

1. ZooKeeper
2. Cassandra
3. qpidd
4. LDAP
5. ‫Edge, כלומר הפרופיל "‎-c edge" בכל הצמתים לפי הסדר: צמתים עם שרת Qpid אבל לא שרת Postgres, שרת ניהול, מעבד בקשות ונתב.
   הערה: אם בצומת מותקנים גם שרת Qpid וגם שרת Postgres, מריצים את שלב הפרופיל "‎-c edge" כחלק משלב 8.
6. ממשק המשתמש של Edge
7. ‫postgresql ב-Postgres הראשי, כולל שדרוג.
8. ‫postgresql ב-Postgres standby.
9. Edge, כלומר הפרופיל "-c edge" בכל הצמתים המשולבים של Qpid ו-Postgres, או בכל צומת עצמאי של Postgres.