עדכון של Apigee Edge 4.17.01 ל-4.17.05

Edge for Private Cloud גרסה 4.17.05

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

אתם יכולים לעדכן את Apigee Edge מגרסה 4.17.01.0x לגרסה 4.17.05 באמצעות התהליך הזה.

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

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

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

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

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

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

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

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

חובה להוסיף את פרמטר ההגדרה SMTMAILFROM

בגרסה 4.17.05 של Edge נוסף פרמטר חובה חדש לקובץ התצורה שמשמש להפעלת שרת SMTP. עכשיו צריך להגדיר את SMTPMAILFROM בקובץ התצורה כשמפעילים את שרת ה-SMTP. הפרמטר הזה הוא בפורמט הבא:

SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. אם יש משימות CRON שמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
2. כדי להתקין את חבילות ה-RPM של Edge, מתחברים לצומת כמשתמש root.
   הערה: כדי להתקין את RPM נדרשת גישת root, אבל אפשר להגדיר את Edge בלי גישת root.
3. משביתים את SELinux כמו שמתואר במאמר Install the Edge apigee-setup utility.
4. מורידים את הקובץ bootstrap_4.17.05.sh של Edge 4.17.05 אל ‎/tmp/bootstrap_4.17.05.sh:
   > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
5. מתקינים את כלי השירות apigee-service של Edge 4.17.05 ואת יחסי התלות:
   > sudo bash /tmp/bootstrap_4.17.05.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 בעצמכם.
6. ‫(CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי Qpid, מריצים את הפקודה הבאה כדי לוודא שאתם מורידים את הגרסה הנכונה של Qpid:
   > yum install apigee-qpidd --disablerepo=epel
7. השתמשו ב-apigee-service כדי לעדכן את כלי השירות apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
8. מעדכנים את כלי השירות apigee-validate בשרת הניהול:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
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 בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

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

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

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

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

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

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

1. יוצרים מאגר מקומי בגרסה 4.17.05, כמו שמתואר בקטע "יצירת מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
   הערה: אם כבר יש לכם מאגר 4.17.01, אתם יכולים להוסיף לו את המאגר 4.17.05, כמו שמתואר בקטע "עדכון מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
2. כדי להתקין את apigee-service מקובץ ‎ .tar:
   1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ ‎ .tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
      > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   2. מעתיקים את קובץ ה-‎ .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה ‎/tmp בצומת החדש.
   3. בצומת החדש, מבטלים את הדחיסה של הקובץ לספרייה ‎ /tmp:
      > tar -xzf apigee-4.17.05.tar.gz
      
      הפקודה הזו יוצרת ספרייה חדשה בשם repos בספרייה שמכילה את קובץ ה-‎ .tar. לדוגמה, ‎ /tmp/repos.
   4. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות מ-‎ /tmp/repos:
      > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      שימו לב שאתם כוללים את הנתיב לספריית המאגרים בפקודה הזו.
3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
   1. מגדירים את שרת האינטרנט Nginx כמו שמתואר בקטע "התקנה מהמאגר באמצעות שרת האינטרנט Nginx" במאמר התקנת כלי השירות apigee-setup של Edge.
   2. בצומת המרוחק, מורידים את קובץ ה-Edge bootstrap_4.17.05.sh אל /tmp/bootstrap_4.17.05.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      
      כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה למאגר, ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של צומת המאגר.
   3. בצומת המרוחק, מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
      > sudo bash /tmp/bootstrap_4.17.05.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. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "סדר עדכון המכונות" בהמשך:
   > ‎/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 באותו צומת
8. בודקים את העדכון על ידי הפעלת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

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

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

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

• צריך לעדכן את כל הצמתים של Cassandra ו-ZooKeeper לפני שמעדכנים צמתים אחרים.
• בכל מכונה עם כמה רכיבי Edge (שרת ניהול, מעבד בקשות, נתב, שרת QPID אבל לא שרת Postgres), צריך להשתמש באפשרות "‎-c edge" כדי לעדכן את כולם בו-זמנית.
• אם בשלב מסוים מצוין שצריך לבצע אותו בכמה מכונות, בצעו אותו לפי סדר המכונות שצוין.
• אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את האפשרות "‎-c edge".
• (CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי Qpid עם חיבור חיצוני לאינטרנט, מוודאים שהרצתם את הפקודה הבאה כדי להוריד את גרסת Qpid הנכונה, כמו שמוצג למעלה:
  > yum install apigee-qpidd --disablerepo=epel

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

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מעדכנים את Cassandra ו-ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. מעדכנים את Qpid ו-Postgres:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. מפעילים את postgresql:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. מעדכנים את LDAP:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. מעדכנים את שאר הרכיבים של Edge:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. מעדכנים את ממשק המשתמש של Edge:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מעדכנים את Cassandra ו-ZooKeeper במכונה 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. מעדכנים את Qpid ו-Postgres במכונה 2:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. מפעילים את postgresql במכונה 2:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. מעדכנים את LDAP במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
6. מעדכנים את רכיבי Edge במכונות 2 ו-1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
7. מעדכנים את ממשק המשתמש במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. מעדכנים את Qpid ו-Postgres במכונה 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. מפעילים את postgresql במכונה 4:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. חוזרים על שלבים 3 ו-4 במכונה 5.
6. מעדכנים את LDAP במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. מעדכנים את רכיבי Edge במכונות 4, 5, 1, 2, 3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. מעדכנים את ממשק המשתמש במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. מעדכנים את Qpid ו-Postgres במכונה 6:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. מפעילים את postgresql במכונה 6:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. חוזרים על שלבים 3 ו-4 במכונה 7.
6. מעדכנים את LDAP במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. מעדכנים את רכיבי Edge במכונות 6, 7, 8, 9, 1, 4 ו-5 בסדר הזה:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. מעדכנים את ממשק המשתמש במכונה 1:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. מעדכנים את Qpid ו-Postgres במכונה 12:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
4. מפעילים את postgresql במכונה 12:
   > ‎/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. חוזרים על שלבים 3 ו-4 במכונה 13.
6. מעדכנים את LDAP במכונות 4 ו-5:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
7. מעדכנים את רכיבי Edge במכונות 12, 13, 8, 9, 6, 7, 10 ו-11 בסדר הזה:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
8. מעדכנים את ממשק המשתמש במכונות 6 ו-7:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. אם הפעלתם את SMTP ב-Edge, הגדירו את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה נראה כך:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מעדכנים את 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
3. מעדכנים את qpidd:
   1. מכונות 4 ו-5 במרכז נתונים 1
      1. מעדכנים את qpidd במכונה 4:
         > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. חוזרים על שלב 1 במכונה 5.
   2. מכונות 10 ו-11 במרכז נתונים 2
      1. מעדכנים את qpidd במכונה 10:
         > ‎/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. חוזרים על שלב 1 במכונה 11.
4. עדכון postgresql:
   1. מכונה 6 במרכז נתונים 1
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
   2. מכונה 12 במרכז נתונים 2
      > ‎/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      ‎> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. מעדכנים את ה-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
6. מעדכנים את הרכיבים של 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
7. עדכון ממשק המשתמש:
   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

להתקנת 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‎

להתקנה של API Baas בשני מרכזי נתונים

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

1. מעדכנים את מרחבי המפתחות של Cassandra עם פקטור השכפול הנכון לשני מרכזי הנתונים. צריך להריץ את השלב הזה רק פעם אחת בכל שרת Cassandra בכל אחד ממרכזי הנתונים:
   
   הערה: כל הפקודות שבהמשך מגדירות את פקטור הרפליקציה ל-"3", מה שמציין שלושה צומתי Cassandra באשכול. משנים את הערך הזה לפי הצורך בהתקנה.
   1. מפעילים את כלי השירות cqlsh של Cassandra:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
   2. מריצים את פקודות ה-CQL הבאות בשורת הפקודה "cqlsh>‎" כדי להגדיר את רמות הרפליקציה של מרחבי המפתחות של Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. מציגים את מרחבי המפתחות באמצעות הפקודה:
         cqlsh> select * from system.schema_keyspaces;
      7. יוצאים מ-cqlsh:
         cqlsh> exit
2. (רק אם לא עדכנתם את Cassandra כחלק מעדכון Edge) מעדכנים את צומתי Cassandra במרכז נתונים 1, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
3. (רק אם לא עדכנתם את Cassandra כחלק מהעדכון של Edge) מעדכנים את צומתי Cassandra במרכז הנתונים השני, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
4. מעדכנים את ElasticSearch במכונות במרכז נתונים 1, מכונה אחת בכל פעם:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
5. מעדכנים את ElasticSearch במכונות במרכז הנתונים השני, מכונה אחת בכל פעם:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
6. מעדכנים את API BaaS Stack במכונות במרכז הנתונים הראשון, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
7. מעדכנים את API BaaS Stack במכונות במרכז נתונים 2, מכונה אחת בכל פעם:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
8. מעדכנים את פורטל API BaaS במכונות במרכז נתונים 1, מכונה אחת בכל פעם:
   > ‎/opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
9. מעדכנים את פורטל API BaaS במכונות במרכז נתונים 2, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
10. מעדכנים את הערכים של מרחב המפתחות של BaaS. צריך להגדיר את מרחבי המפתחות האלה לשכפול בזמן ההתקנה, אבל לא בזמן הריצה. הסרת הרפליקציה גם חוסכת בזיכרון של Cassandra.
    
    צריך להריץ את השלב הזה רק פעם אחת בכל שרת Cassandra בכל אחד ממרכזי הנתונים:
    1. מפעילים את כלי השירות cqlsh של Cassandra:
       > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. מריצים את פקודות ה-CQL הבאות כדי להגדיר את רמות השכפול של מרחבי המפתחות של Cassandra:
       1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
       2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH replication = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
       3. מציגים את מרחבי המפתחות באמצעות הפקודה:
          cqlsh> select * from system.schema_keyspaces;
       4. יוצאים מ-cqlsh:
          cqlsh> exit

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

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

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