עדכון של 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

כדי להתקין או לעדכן את Edge, צריך להפעיל את Extra Packages for Enterprise Linux (או EPEL). הפקודה שבה משתמשים תלויה בגרסה של 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

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

בגרסה 4.17.09 של API BaaS נוספה גם תמיכה במאפיין SMTPMAILFROM. כשמעדכנים את API BaaS, צריך להגדיר את 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 נכשל.

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

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

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

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

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

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

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

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

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

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

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

1. אם יש משימות CRON שמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
2. כדי להתקין את חבילות ה-RPM של 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. מפעילים את מאגר EPEL כמו שמתואר למעלה.
6. אם מתקינים ב-AWS, מריצים את הפקודה הבאה של yum-configure-manager:
   > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
7. מורידים את הקובץ 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
8. מתקינים את כלי השירות apigee-service של Edge 4.17.09 ואת יחסי התלות:
   > sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
   
   כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.
   
   כברירת מחדל, מנהל ההתקנה בודק אם מותקנת גרסה 1.8 של Java. אם לא, היא תתקין אותה. משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל בהתקנה של Java. JAVA_FIX מקבל את הערכים הבאים:
   
   I = התקנת OpenJDK 1.8 (ברירת מחדל)
   C = המשך בלי להתקין את Java
   Q = יציאה. כדי להשתמש באפשרות הזו, צריך להתקין את Java בעצמכם.
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 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 באותו צומת
13. בודקים את העדכון על ידי הפעלת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

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

איך מעדכנים לגרסה 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.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
      
      שימו לב שאתם כוללים את הנתיב לספריית המאגרים בפקודה הזו.
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-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.09 Rollback Process.

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

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

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

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

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 ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

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 ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

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 הבא במכונה 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. מנקים את 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 ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

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 ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

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 הבא במכונה 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. מנקים את 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 ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

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

# 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 ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

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 מארחים

# 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 ומספרי צמתים מופיעה במאמר טופולוגיות של התקנה.

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

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

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

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