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

Edge for Private Cloud גרסה 4.17.09

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

אפשר לעדכן את Apigee Edge מגרסה 4.17.01.0x/4.17.05.0x לגרסה 4.17.09 באמצעות התהליך הזה.

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

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

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

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

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

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

העברה אוטומטית של הגדרות המלון

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

הוספה נדרשת של פרמטר ההגדרה SMTPMAILFROM

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

בגרסת API BaaS 4.17.09 נוספה גם תמיכה במאפיין SMTPMAILFROM. כשמעדכנים את BaaS ל-API מגרסה 4.17.01 או 4.17.05, צריך להגדיר את SMTPMAILFROM בקובץ התצורה.

הפרמטר הזה בפורמט:

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

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

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

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

טיפול בעדכון שנכשל

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. אם יש כאלה, משביתים את כל משימות ה-CRON שמוגדרות לבצע פעולת תיקון ב-Cassandra, עד לסיום העדכון.
2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root).
   הערה: התקנת RPM דורשת הרשאת root, אבל אפשר לבצע הגדרה של Edge בלי הרשאת root.
3. מתקינים את yum-utils ואת yum-plugin-priorities:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
4. משביתים את SELinux כפי שמתואר במאמר התקנת הכלי apigee-setup של Edge.
5. אם מתקינים ב-AWS, מריצים את הפקודה yum-Configure-manager הבאה:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
6. מורידים את קובץ bootrap_4.17.09.sh של Edge 4.17.09 אל /tmp/shoestrap_4.17.09.sh:
   > curl https://software.apigee.com/shoestrap_4.17.09.sh -o /tmp/shoestrap_4.17.0.
7. מתקינים את השירות apigee-service ואת יחסי התלות של Edge 4.17.09:
   > sudo bash /tmp/bootstrap_4.17.09.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 בעצמכם.
8. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
9. מעדכנים את הכלי apigee-validate בשרת הניהול:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
10. עדכון של הכלי apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
11. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בהמשך בקטע סדר העדכון של המכונה:
    > /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: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
    ui = ממשק המשתמש של Edge
    all = עדכון כל הרכיבים במכונה (יש להשתמש רק בפרופיל התקנה של Edge aio או בפרופיל התקנה של API BaaS asa)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = ElasticSearch, ‏ API BaaS Stack ו-API BaaS Portal באותו צומת
12. כדי לבדוק את העדכון, מפעילים את הכלי לאימות apigee בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.

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

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

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

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

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

כדי לעדכן ממאגר 4.17.09 מקומי:

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

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

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

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

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

1. אם מעדכנים מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   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

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

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

1. אם מעדכנים מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   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 ומספרי הצמתים מפורטת במאמר Installation Topologies.

1. אם מעדכנים מגרסה 4.17.01, מגדירים את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   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 ומספרי הצמתים מפורטת במאמר Installation Topologies.

1. אם מעדכנים מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
   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 dge -f configFile
8. מעדכנים את ממשק המשתמש במכונה 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. אם מעדכנים מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   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 ומספרי הצמתים מפורטת במאמר Installation Topologies.

1. אם מעדכנים מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   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 ב-Data Center 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 ב-Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
   2. מכונות 10, 11, 12, 7, 8, 9 ב-Data Center 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 ב-Data Center 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

1. מגדירים את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה צריך להיות בפורמט:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מעדכנים את Cassandra במכונות 5,‏ 6 ו-7:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

3. מעדכנים את ElasticSearch ו-BaaS Stack במכונה 1, 2 ו-3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

4. מעדכנים את API BaaS Portal במכונה 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

1. מגדירים את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה צריך להיות בפורמט:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מעדכנים את Cassandra במכונות 8,‏ 9 ו-10:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
3. מעדכנים את ElasticSearch במכונות 1, 2 ו-3:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
4. מעדכנים את BaaS Stack במכונה 4, 5 ו-6:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
5. מעדכנים את API BaaS Portal במכונה 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

1. מגדירים את SMTPMAILFROM בקובצי התצורה. הפרמטר הזה צריך להיות בפורמט:
   SMTPMAILFROM="My Company <myco@company.com>"
2. יש לעדכן את מרחבי המפתחות של 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> בחירת * מתוך system.schema_keyspaces;
      7. יציאה מ-cqlsh:
         cqlsh> exit
3. (רק אם לא עדכנת את Cassandra כחלק מעדכון Edge) עדכון צמתים של Cassandra במרכז הנתונים 1, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
4. (רק אם לא עדכנתם את Cassandra כחלק מהעדכון של Edge) מעדכנים את צמתים של Cassandra במרכז הנתונים 2, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
5. מעדכנים את ElasticSearch במכונות במרכז הנתונים 1, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
6. מעדכנים את ElasticSearch במכונות במרכז הנתונים 2, מחשב אחד בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
7. מעדכנים את API BaaS Stack במכונות במרכז הנתונים 1, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
8. מעדכנים את API BaaS Stack במכונות במרכז הנתונים 2, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
9. מעדכנים את API BaaS Portal במכונות במרכז הנתונים 1, מכונה אחת בכל פעם:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
10. מעדכנים את API BaaS Portal במכונות במרכז הנתונים 2, מכונה אחת בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
11. עדכון הערכים של מרחבי המפתחות ב-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 dge' בכל הצמתים בסדר: צמתים עם שרת Qpid, שרת Postgres, שרת ניהול, מעבד הודעות ונתב.
   הערה: אם בשרת מותקנים גם שרת Qpid וגם שרת Postgres, צריך להריץ את שלב הפרופיל '-c edge'.
6. ממשק המשתמש של Edge