עדכון של Apigee Edge 4.16.01/4.16.05 ל-4.17.09

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

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

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

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

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

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

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

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

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

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

כדי לעדכן את רכיבי Edge בצומת, מבצעים את השלבים הבאים:

1. אם אתם משתמשים כרגע ברפליקציה של Postgres master-standby, צריך להתקין צומת סטנדביי חדש של Postgres כפי שמתואר למעלה בקטע התקנה של צומת סטנדביי חדש של Postgres.
2. אם יש כאלה, משביתים את כל משימות ה-CRON שמוגדרות לבצע פעולת תיקון ב-Cassandra, עד לסיום העדכון.
3. מתחברים לצומת בתור root כדי להתקין את קובצי ה-RPM של Edge.
   הערה: כדי להתקין RPM נדרשת גישה לרמה הבסיסית (root), אבל אפשר להגדיר את Edge בלי גישה לרמה הבסיסית (root).
4. מתקינים את yum-utils ואת yum-plugin-priorities:
   > sudo yum install yum-utils
   > sudo yum install yum-plugin-priorities
5. משביתים את SELinux כפי שמתואר בהתקנת כלי ההגדרה של Edge apigee-setup.
6. מפעילים את המאגר EPEL כמו שמתואר למעלה.
7. אם מתקינים ב-AWS, מריצים את הפקודה הבאה של yum-configure-manager:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
8. מורידים את הקובץ bootstrap_4.17.09.sh של Edge 4.17.09 אל ‎/tmp/bootstrap_4.17.09.sh:
   > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
9. מתקינים את כלי השירות apigee-service ויחסי התלות של Edge 4.17.09:
   > sudo bash /tmp/shoestrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
   
   כאשר שם המשתמש שקיבלתם ב-uName:pWordge הוא uName:pWordge אם משמיטים את pWord, תתבקשו להזין אותו.
   
   כברירת מחדל, מנהל ההתקנה בודק אם התקנתם את Java 1.8. אם לא, הוא יתקין אותו בשבילך. אפשר להשתמש באפשרות JAVA_FIX כדי לציין איך לטפל בהתקנת Java. הערכים האפשריים של JAVA_FIX הם:
   
   ‎I = התקנת OpenJDK 1.8 (ברירת המחדל)
   ‎C = המשך ללא התקנת Java
   ‎Q = יציאה. כדי להשתמש באפשרות הזו, צריך להתקין את Java בעצמכם.
10. משתמשים ב-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.shsetup ב-/optbin-apigeapige
       
       אם כבר התקנתם את הכלי 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 ב-/opt/apigee/apigee-setup/bin.
    3. אם התקנתם את גרסה 4.16.05 ישירות או באמצעות עדכון, צריך לעדכן את כלי העזר apigee-setup:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
       
       העדכון הזה ל-apigee-service מתקין את הכלי update.sh ב-/opt.binapige
11. בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את הכלי apigee-validator בשרת הניהול.
    1. אם אתם משתמשים כרגע ב-Edge 4.16.05: מעדכנים את כלי השירות apigee-אטים בשרת הניהול:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-authentic update
    2. 
       
       
       
       
       
       
    3. אם משפרים מ-4.16.01: עורכים את קובץ התצורה שמוענק לכלי apigee-validate. בגרסה 4.16.01 של Edge, קובץ התצורה שמשמש את apigee-validate נדרש את המאפיינים הבאים:
       APIGEE_ADMINPW=sysAdminPword
       MP_POD=gateway
       REGION=dc-1
       
       בגרסה הזו, קובץ התצורה נדרש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר מהקובץ את שני המאפיינים האחרים.
12. עדכון של הכלי apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
13. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בהמשך בקטע סדר העדכון של המכונה:
    > /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 באותו צומת
14. כדי לבדוק את העדכון, מריצים את השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
15. אם התקנתם צומת סטנדביי חדש של Postgres, תוכלו להוציא משימוש את הצומת לפי ההוראות שמפורטות למעלה בקטע הוצאה משימוש של צומת Postgres.

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

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

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

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

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

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

1. אם אתם משתמשים כרגע ברפליקציה של Postgres master-standby, צריך להתקין צומת סטנדביי חדש של Postgres כפי שמתואר למעלה בקטע התקנה של צומת סטנדביי חדש של Postgres.
2. יוצרים מאגר מקומי של 4.17.09 כפי שמתואר בקטע 'יצירת מאגר מקומי של Apigee' במאמר התקנת הכלי apigee-setup של Edge.
   הערה: אם כבר יש לכם מאגר 4.16.01 או 4.16.05, תוכלו להוסיף אליו את המאגר 4.17.09 כפי שמתואר בקטע 'עדכון מאגר מקומי של Apigee' במאמר התקנת הכלי apigee-setup ל-Edge.
3. כדי להתקין את שירות apigee מקובץ .tar:
   1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service package apigee-service/bin/apigee-service package
   2. מעתיקים את קובץ ה-tar.‎ לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
   3. בצומת החדש, מפרקים את הקובץ לתיקיית ‎ /tmp:
      > tar -xzf apigee-4.17.09.tar.gz
      
      הפקודה הזו יוצרת תיקייה חדשה בשם repos בתיקייה שמכילה את הקובץ ‎ .tar. לדוגמה, ‎ /tmp/repos.
   4. מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service מ- /tmp/repos:
      > sudo bash /tmp/repos/shoestrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      שימו לב שהפקודה הזו כוללת את הנתיב ל-repos.
4. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
   1. מגדירים את שרת האינטרנט Nginx כפי שמתואר בקטע 'התקנה מהמאגר באמצעות שרת האינטרנט Nginx' במאמר התקנה של הכלי apigee-setup ל-Edge.
   2. bootstrap_4.17.09.sh
      
      
      
   3. בצומת המרוחק, מתקינים את השירות apigee-service של Edge ואת יחסי התלות שלו:
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      
      כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.
5. משתמשים ב-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 ב-/opt/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 ב-/opt/apigee/apigee-setup/bin.
   3. אם התקנתם את גרסת 4.16.05 ישירות או באמצעות עדכון, עליכם לעדכן את הכלי apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      העדכון הזה ל-apigee-service מתקין את הכלי update.sh ב-/opt/apigee/apigee-setup/bin.
6. בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את השירות apigee-validate בשרת הניהול.
   1. אם אתם משתמשים כרגע ב-Edge 4.16.05: מעדכנים את כלי השירות apigee-אטים בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-authentic 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-validate בשרת הניהול.
   3. אם משדרגים מ-4.16.01: עורכים את קובץ התצורה שהועבר לכלי השירות apigee-אטים. בגרסה 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: שרת ניהול, מעבד הודעות, נתב, שרת 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 באותו צומת
9. כדי לבדוק את העדכון, מריצים את השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
10. אם התקנתם צומת חדש במצב המתנה של Postgres, צריך להסיר את הצומת כפי שמתואר למעלה בהסרת צומת של Postgres.

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

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

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

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

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

1. מגדירים את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   SMTPMAILFROM="My Company <myco@company.com>"
2. אם מעדכנים מ-4.16.01, צריך לשדרג לאחור את גן החיות:
   > yum downdown apigee-zookeeper
3. מעדכנים את Cassandra ו-ZooKeeper:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. מגדירים את כלל iptables הבא:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
5. בודקים את תור ההודעות של Qpid:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. לא ניתן לשדרג את Qpid עד שהוא יטפל בכל ההודעות.
6. מעדכנים את qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. Flush iptables:
   > sudo iptables -F
8. עדכון LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. הפסקת Postgres Server, שרת 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/apigeapige/
10. עדכון postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
11. מעדכנים את מסד הנתונים של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
12. מעדכנים את שאר הרכיבים של Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. עדכון ממשק המשתמש של Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. מגדירים את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   SMTPMAILFROM="My Company <myco@company.com>"
2. אם מעדכנים מ-4.16.01, מבצעים שדרוג לאחור של Zookeeper במכונה 1:
   > yum downgrade apigee-zookeeper
3. מעדכנים את Cassandra ו-ZooKeeper במכונה 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
4. מגדירים את כלל ה-iptables הבא במכונה 2:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
5. בודקים את תור ההודעות ב-Qpid במחשב 2:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' היא 0. לא ניתן לשדרג את Qpid עד שהוא יטפל בכל ההודעות.
6. מעדכנים את qpidd במכונה 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
7. מנקים את iptables במכונה 2:
   > sudo iptables -F
8. מעדכנים את LDAP במכונה 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
9. מעדכנים את רכיבי Edge במכונה 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. עדכון ממשק המשתמש במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
11. מעדכנים את 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
12. מעדכנים את רכיבי Edge במכונה 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

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

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

1. מגדירים את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מוודאים שהתקנתם צומת סטנדביי חדש של Postgres, כפי שמתואר למעלה בקטע התקנת צומת סטנדביי חדש של Postgres.
3. אם מעדכנים מגרסה 4.16.01, מבצעים שדרוג לאחור של Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
4. מעדכנים את Cassandra ו-ZooKeeper במכונה 1, 2 ו-3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. מגדירים את כלל ה-iptables הבא במכונה 4:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. בודקים את תור ההודעות של Qpid במכונה 4:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. לא ניתן לשדרג את Qpid עד שהוא יטפל בכל ההודעות.
7. מעדכנים את qpidd במכונה 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. מנקים את iptables במכונה 4:
   > sudo iptables -F
9. חוזרים על שלבים 5 עד 8 במכונה 5.
10. מעדכנים את LDAP במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. עדכון רכיבי Edge במכונה 1, 2 ו-3:
    > /opt/apigee/apigee-setup/bin/update.sh -c dge -f configFile
12. מעדכנים את ממשק המשתמש במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. מעדכנים את המכונות 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 configFile
    9. מוודאים את סטטוס הרפליקציה על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי לוודא שההעתקה בוצעה בהצלחה:
       
       במכונה 4, צומת המאסטר, מריצים את הפקודה:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
       
       מוודאים שכתוב שהוא המאסטר.
       
       הצומת במצב המתנה:
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
       
       מוודאים שהוא כתוב במצב המתנה.
14. מעדכנים את רכיבי Edge במכונות 4 ו-5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. חשוב להוציא משימוש את צומת ה-standby החדש באמצעות התהליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

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

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

1. מגדירים את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מוודאים שהתקנתם צומת סטנדביי חדש של Postgres, כפי שמתואר למעלה בקטע התקנת צומת סטנדביי חדש של Postgres.
3. אם מעדכנים מגרסה 4.16.01, מבצעים שדרוג לאחור של Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
4. מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. מגדירים את כלל ה-iptables הבא במכונה 6:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. בודקים את תור ההודעות של Qpid במכונה 6:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. לא ניתן לשדרג את Qpid עד שהוא יטפל בכל ההודעות.
7. מעדכנים את qpidd במכונה 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. מנקים את iptables במכונה 6:
   > sudo iptables -F
9. חוזרים על שלבים 5 עד 8 במכונה 7.
10. מעדכנים את LDAP במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. מעדכנים את רכיבי Edge במכונה 6, 7, 1, 4 ו-5 בסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c Edge -f configFile
12. עדכון ממשק המשתמש במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. מעדכנים את מכונות 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 Master בלבד):
       > /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
        
        מוודאים שהוא מוגדר כצמת המתנה.
14. מעדכנים את רכיבי Edge במכונות 8 ו-9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. חשוב להוציא משימוש את צומת ה-standby החדש באמצעות התהליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

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

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

1. אם הפעלתם את SMTP ב-Edge, צריך להגדיר את SMTPMAILFROM בקובץ התצורה. הפרמטר הזה צריך להיות בפורמט:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מוודאים שהתקנתם צומת המתנה חדש של Postgres כפי שמתואר למעלה, במאמר התקנת צומת המתנה חדש של Postgres.
3. אם מעדכנים מגרסה 4.16.01, מבצעים שדרוג לאחור של Zookeeper במכונות 1, 2 ו-3:
   > yum downgrade apigee-zookeeper
4. מעדכנים את Cassandra ו-ZooKeeper במכונה 1, 2 ו-3:
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
5. מגדירים את כלל ה-iptables הבא במכונה 12:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
6. בודקים את תור ההודעות של Qpid במכונה 12:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. לא ניתן לשדרג את Qpid עד שהוא יטפל בכל ההודעות.
7. עדכון qpidd במכונה 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
8. מנקים את iptables במכונה 12:
   > sudo iptables -F
9. חוזרים על שלבים 5 עד 8 במכונה 13.
10. מעדכנים את LDAP במכונות 4 ו-5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
11. מעדכנים את רכיבי Edge במכונות 12,‏ 13,‏ 6,‏ 7,‏ 10 ו-11 לפי הסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
12. עדכון ממשק המשתמש במכונה 6 ו-7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
13. מעדכנים את המכונות 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 Master בלבד):
       > /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
        
        מוודאים שהוא מוגדר כצמת המתנה.
14. מעדכנים את רכיבי Edge במכונות 8 ו-9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
15. חשוב להוציא משימוש את צומת ה-standby החדש באמצעות התהליך שמתואר למעלה בקטע הוצאה משימוש של צומת Postgres.

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

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

1. מגדירים את SMTPMAILFROM בקובץ התצורה אם הפעלתם את SMTP ב-Edge. הפרמטר הזה צריך להיות בפורמט:
   SMTPMAILFROM="My Company <myco@company.com>"
2. מוודאים שהתקנתם צומת סטנדביי חדש של Postgres, כפי שמתואר למעלה בקטע התקנת צומת סטנדביי חדש של Postgres.
3. מעדכנים את 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
4. מעדכנים את qpidd:
   1. מכונות 4 ו-5 במרכז הנתונים 1
      1. מגדירים את כלל ה-iptables הבא במכונה 4:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. בודקים את תור ההודעות של Qpid במכונה 4:
         > qpid-stat -q
         
         ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. לא ניתן לשדרג את Qpid עד שהוא מעבד את כל ההודעות.
      3. מעדכנים את qpidd במכונה 4:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. Flush iptables במכונה 4:
         > sudo iptables -F
      5. חוזרים על שלבים 1 עד 4 במכונה 5.
   2. מכונות 10 ו-11 במרכז הנתונים 2
      1. מגדירים את כלל ה-iptables הבא במכונה 10:
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. בודקים את תור ההודעות של Qpid במכונה 10:
         > qpid-stat -q
         
         ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. לא ניתן לשדרג את Qpid עד שהוא מעבד את כל ההודעות.
      3. עדכון qpidd במכונה 10:
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. שטיפה של iptables במכונה 10:
         > sudo iptables -F
      5. חוזרים על שלבים 1 עד 4 במכונה 11.
5. עדכון LDAP:
   1. מכונות 1 ב-Data Center 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, 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
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
8. מעדכנים את המכונה 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 master בלבד):
      > /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
       
       מוודאים שכתוב שהוא צומת המתנה.
9. מעדכנים את רכיבי Edge במכונות 6 ו-12:
   > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
10. חשוב לוודא שמוציאים את הצומת החדש ממצב המתנה באמצעות התהליך שמתואר למעלה בקטע פירוק צומת של Postgres.

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

להתקנה לא רגילה

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

1. ZooKeeper
2. Cassandra
3. qpidd
4. LDAP
5. קצה (edge), כלומר פרופיל '-c edge' בכל הצמתים לפי הסדר: צמתים עם שרת Qpid, אבל לא שרת Postgres, שרת הניהול, מעבד ההודעות והנתב.
   הערה: אם בשלב 8 מותקנים בשרת גם שרת Qpid וגם שרת Postgres, צריך להריץ את השלב '-c edge' בפרופיל.
6. ממשק המשתמש של Edge
7. postgresql במאסטר של Postgres, כולל שדרוג.
8. postgresql במצב המתנה של Postgres.
9. Edge, כלומר הפרופיל '-c edge' בכל הצמתים המשולבים של Qpid ו-Postgres, או בכל צומת Postgres עצמאי.