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

Edge for Private Cloud בגרסה 4.17.09

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

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

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

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

המשתמש שמריץ את העדכון צריך להיות זהה למשתמש שהתקין את Edge, או משתמש שרץ ברמה הבסיסית (root).

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

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

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

נדרש שדרוג ל-Qpid 1.35

הגרסה הזו כוללת עדכון נדרש ל-Qpid 1.35. כחלק מתהליך העדכון של צומת Qpid, צריך:

• מניעת הכתיבה של נתבים ומעבדי הודעות בצומת Qpid באופן זמני על ידי חסימה של יציאה 5672 בצומת Qpid. אפשר להשתמש בפקודה הבאה כדי לחסום את היציאה הזו בצומת Qpid:
  > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
• צריך להמתין עד שתור ה-Qpid יתרוקן מההודעות כדי לוודא שהצומת של ה-Qpid עיבד את כל ההודעות לפני העדכון. מריצים את הפקודה הבאה כדי לוודא שתור ההודעות של Qpid ריק:
  > qpid-stat -q
• מעדכנים את הצומת Qpid.
• ביטול החסימה של יציאה 5672 בצומת Qpid כדי לאפשר גישה מנתבים וממעבדי הודעות. אפשר להשתמש בפקודה הבאה כדי לבטל את החסימה של השקע:
  > sudo iptables -F
  
  הערה: אם אתם משתמשים ב-iptables לכללים אחרים, תוכלו להשתמש באפשרות -D כדי לבטל את השינוי הספציפי:
  > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP

התהליך הזה מתואר בפירוט בהמשך לכל טופולוגיית Edge.

נדרשת כדי להפעיל את המאגר EPEL

צריך להפעיל חבילות נוספות ל-Enterprise Linux (או EPEL) כדי להתקין או לעדכן את Edge. הפקודה שבה משתמשים תלויה בגרסה של RedHat/CentOS:

• ל-RedHat/‏CentOS/‏Oracle 7.x:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
• ל-RedHat/CentOS/Oracle 6.x:
  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

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

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

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

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

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

חובה אם מבצעים עדכון כשמשתמשים באימות חיצוני

אפשר לשלב שירות ספרייה חיצוני בהתקנה קיימת של Apigee Edge בענן פרטי. התכונה הזו נועדה לפעול עם כל שירות ספרייה שתומך ב-LDAP, כמו Active Directory,‏ OpenLDAP ועוד. פתרון LDAP חיצוני מאפשר לאדמינים של מערכות לנהל את פרטי הכניסה של המשתמשים משירות ניהול ספריות מרכזי, חיצוני למערכות כמו Apigee Edge שמשתמשות בהם.

מידע נוסף זמין במאמר הגדרת אימות חיצוני.

כשהאימות החיצוני מופעל, רוב הלקוחות ישתמשו בשדה של שם החשבון ב-Active Directory SAM כשם המשתמש לאימות, במקום בכתובת אימייל שמשמשת את שרת Edge OpenLDAP.

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

IS_EXTERNAL_AUTH="true"

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

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

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

עדכון התנאים המוקדמים

לפני שמשדרגים את 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 נכשל.

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

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

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

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

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

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

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

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

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

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

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

1. צריך להשבית את כל משימות ה-CRON שהוגדרו לבצע פעולת תיקון ב-Cassandra עד שהעדכון יסתיים.
2. מתחברים לצומת בתור root כדי להתקין את קובצי ה-RPM של Edge.
   הערה: התקנת RPM דורשת הרשאת root, אבל אפשר לבצע הגדרה של Edge בלי הרשאת root.
3. מתקינים את yum-utils ואת yum-Plugin-עדיפות:
   > sudo yum install yum-utils
   > sudo yum install yum-Plugin-עדיפות
4. משביתים את SELinux כפי שמתואר במאמר התקנת הכלי apigee-setup של Edge.
5. מפעילים את המאגר EPEL כמו שמתואר למעלה.
6. אם מתקינים ב-AWS, מריצים את הפקודה הבאה של yum-configure-manager:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
7. מורידים את קובץ 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.
8. מתקינים את השירות 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 בעצמכם.
9. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
10. מעדכנים את הכלי apigee-validate בשרת הניהול:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
11. מעדכנים את השירות apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
12. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בהמשך בקטע סדר העדכון של המכונה:
    > /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 באותו צומת
13. כדי לבדוק את העדכון, מריצים את השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

כדי לבצע החזרה למצב הקודם של העדכון מאוחר יותר, יש לפעול לפי התהליך שמתואר בקטע תהליך החזרה למצב הקודם של גרסת 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 מקומי' ב-התקנת כלי העזר של Edge apigee-setup.
   הערה: אם כבר יש לכם מאגר 4.16.09, תוכלו להוסיף אליו את המאגר 4.17.09 כפי שמתואר בקטע 'עדכון מאגר מקומי של Apigee' במאמר התקנת הכלי apigee-setup ל-Edge.
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' במאמר התקנת כלי ההגדרה של Edge apigee-setup.
   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-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
8. כדי לבדוק את העדכון, מריצים את השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

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

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

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

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

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

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. מגדירים את כלל iptables הבא:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
4. בודקים את תור ההודעות ב-Qpid:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' היא 0. לא ניתן לשדרג את Qpid עד שהוא יטפל בכל ההודעות.
5. מעדכנים את qpidd:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. שטיפה של iptables:
   > sudo iptables -F
7. עדכון postgresql:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. מפעילים את postgresql:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. עדכון LDAP:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. מעדכנים את שאר הרכיבים של Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. עדכון של ממשק המשתמש של Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

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. מגדירים את כלל ה-iptables הבא במכונה 2:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. בודקים את תור ההודעות של Qpid במכונה 2:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. לא ניתן לשדרג את Qpid עד שהוא יטפל בכל ההודעות.
5. מעדכנים את qpidd במכונה 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. מנקים את iptables במכונה 2:
   > sudo iptables -F
7. מעדכנים את postgresql במכונה 2:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. מפעילים את PostgreSQL במכונה 2:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. מעדכנים את LDAP במכונה 1:
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. מעדכנים את רכיבי Edge במכונה 2 ובמכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. עדכון ממשק המשתמש במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. מגדירים את 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. מגדירים את כלל ה-iptables הבא במכונה 4:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. בודקים את תור ההודעות של Qpid במכונה 4:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. אי אפשר לשדרג את Qpid לפני שכל ההודעות יטופלו.
5. עדכון qpidd במכונה 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. Flush iptables במכונה 4:
   > sudo iptables -F
7. חוזרים על שלבים 3 עד 6 במכונה 5.
8. מעדכנים את postgresql במכונה 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. מפעילים את postgresql במכונה 4:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. חוזרים על שלבים 8 ו-9 במכונה 5.
11. מעדכנים את LDAP במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. מעדכנים את רכיבי Edge במכונות 4,‏ 5,‏ 1,‏ 2 ו-3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. מעדכנים את ממשק המשתמש במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

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. מגדירים את כלל ה-iptables הבא במכונה 6:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. בודקים את תור ההודעות ב-Qpid במחשב 6:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' היא 0. אי אפשר לשדרג את Qpid לפני שכל ההודעות יטופלו.
5. מעדכנים את qpidd במכונה 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. מנקים את iptables במכונה 6:
   > sudo iptables -F
7. חוזרים על שלבים 3 עד 6 במכונה 7.
8. מעדכנים את postgresql במכונה 6:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. מפעילים את PostgreSQL במכונה 6:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. חוזרים על שלבים 8 ו-9 במכונה 7.
11. מעדכנים את LDAP במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. מעדכנים את רכיבי Edge במכונות 6, 7, 8, 9, 1, 4 ו-5 לפי הסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. עדכון ממשק המשתמש במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. מגדירים את 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. מגדירים את כלל ה-iptables הבא במכונה 12:
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. בודקים את תור ההודעות של Qpid במכונה 12:
   > qpid-stat -q
   
   ממשיכים לבדוק את התור עד שהספירה בעמודה 'msg' תהיה 0. אי אפשר לשדרג את Qpid לפני שכל ההודעות יטופלו.
5. מעדכנים את qpidd במכונה 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. Flush iptables במכונה 12:
   > sudo iptables -F
7. חוזרים על שלבים 3 עד 6 במכונה 13.
8. עדכון postgresql במכונה 12:
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. מפעילים את postgresql במכונה 12:
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. חוזרים על שלבים 8 ו-9 במכונה 13.
11. מעדכנים את LDAP במכונות 4 ו-5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. מעדכנים את רכיבי Edge במכונות 12, 13, 8, 9, 6, 7, 10 ו-11 לפי הסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. מעדכנים את ממשק המשתמש במכונות 6 ו-7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. מגדירים את 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. מגדירים את הכלל הבא של טבלאות iptable במכונה 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. מנקים את iptables במכונה 4:
         > sudo iptables -F
      5. חוזרים על שלבים 1 עד 4 במכונה 5.
   2. מכונות 10 ו-11 במרכז הנתונים 2
      1. מגדירים את הכלל הבא של טבלאות iptable במכונה 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.
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 ב-Data Center 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 במרכז הנתונים 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

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

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

דוגמה מלאה לקובץ תצורה מופיעה במאמר התקנה של API BaaS.

בנוסף, צריך לוודא ששער 2551 פתוח בכל צמתים של Stack כדי לאפשר גישה מכל שאר הצמתים של Stack.

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

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 Portal במכונה 4:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

דוגמה מלאה לקובץ תצורה מופיעה במאמר התקנה של API BaaS.

בנוסף, צריך לוודא ששער 2551 פתוח בכל צמתים של Stack כדי לאפשר גישה מכל שאר הצמתים של Stack.

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

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 Portal במכונה 7:
   > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

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