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

Edge for Private Cloud גרסה 4.17.05

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

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

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

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

המשתמש שמריץ את העדכון צריך להיות זהה למשתמש שהתקין את 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 'שם מארח' -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 'שם מארח' -i eth0 -j DROP

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

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

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

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

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

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

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

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

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

מידע נוסף זמין במאמר טופולוגיות התקנה.

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

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

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

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

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

כברירת מחדל, כלי השירות 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. מגדירים שהנתב נמצא בהישג יד.
  • בצומת של נתב יחיד:
    • לפני העדכון, עליך להגדיר את הנתב כלא נגיש.
    • אחרי העדכון מגדירים שהנתב נמצא בהישג יד.
  • בצומת אחד של מעבד ההודעות:
    • לפני העדכון, צריך לוודא שלא ניתן לגשת למעבד ההודעות.
    • אחרי העדכון, אפשר להגיע למעבד ההודעות.

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

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

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

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

  1. אם יש משימות של CRON שלא הוגדרו, צריך להשבית אותן לביצוע פעולת תיקון ב-Cassandra עד שהעדכון יושלם.
  2. מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
    הערה: התקנת RPM מחייבת גישה לרמה הבסיסית, אבל אפשר להגדיר את Edge בלי גישה לרמה הבסיסית.
  3. משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
  4. מורידים את קובץ Edge מגרסה 4.17.05 bootstrap_4.17.05.sh אל bootstrap_4.17.05.sh:
    > curl https://software.apigee.com/shoestrap_4.17.05.sh -o /tmp/shoestrap_4.17.
  5. מתקינים את הכלי ואת יחסי התלות של apigee-service 4.17.05:
    > sudo bash /tmp/shoestrap_4.17.05.sh apigeeuser=uName apigeepassword=uName

    כאשר uName הוא שם המשתמש והסיסמה שקיבלת. אם לא תשמיטו את pWord, תתבקשו להזין אותו.

    כברירת מחדל, מנהל ההתקנה בודק שמותקנת במכשיר Java 1.8. אם לא, הוא יתקין אותו עבורכם. משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל בהתקנת Java. JAVA_FIX מקבל את הערכים הבאים:

    I = התקנה של OpenJDK 1.8 (ברירת מחדל)
    C = המשך ללא התקנה של Java
    Q = יציאה. עבור אפשרות זו, עליכם להתקין את Java בעצמכם.
  6. (CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי Qpid, מריצים את הפקודה הבאה כדי להוריד את גרסת ה-Qpid הנכונה:
    > yum install apigee-qpidd --disablerepo=epel
  7. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  8. מעדכנים את הכלי apigee-validate בשרת הניהול:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate
  9. מעדכנים את כלי העזר apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "עדכון המכונה" שבהמשך:
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    הדרישה היחידה בקובץ התצורה היא שקובץ התצורה צריך להיות נגיש או קריא למשתמש.

    השתמשו באפשרות '-c' כדי לציין את הרכיב שיש לעדכן. רשימת הרכיבים האפשריים כוללת:
    ldap = OpenLDAP
    cs = Cassandra
    zk =, zokeeper
    qpid = qpidd
    ps = postgresql
    edge =All Edge רכיבי Edge מלבד ממשק המשתמש של Edge ב-API: ממשק ה-API לניהול, מעבד הודעות, נתב, ממשק API של שרת QPID, ממשק API של מנהל הודעות, ממשק API של ממשק API עבור ממשק API של ניהול, ממשק API של ממשק API
    התקנת ממשק API של ממשק API
    ו-API של ממשק API עבור ממשק API של Edge
    qpid = qpidd
    ps = postgresql
    edge =כל רכיבי Edge למעט ממשק משתמש של Edge בממשק API: ממשק API לניהול, מעבד הודעות, נתב, ממשק API של שרת QPID, עדכון API
    ו-API של ממשק API של Edge
  11. בודקים את העדכון על ידי הרצת כלי השירות לאימות ממשק ה-API בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.

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

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

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

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

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

כדי לבצע עדכון ממאגר מקומי של 4.17.05:

  1. יוצרים מאגר מקומי 4.17.05 כפי שמתואר ב'יצירת מאגר Apigee מקומי' בהתקנת כלי השירות Edge apigee-setup.
    הערה: אם כבר יש לכם מאגר 4.16.09, אפשר להוסיף אליו את המאגר 4.17.05 כמו שמתואר ב'עדכון מאגר Apigee מקומי' בהתקנת כלי השירות Edge apigee-setup.
  2. כדי להתקין את שירות ה-API מקובץ .tar:
    1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-miror apigee package
    2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
    3. בצומת החדש, מבטלים את היררכיית הקובץ /tmp:
      > tar -xzf apigee-4.17.05.tar.gz

      פקודה זו יוצרת ספרייה חדשה שנקראת repos, בספרייה שמכילה את קובץ ה- .tar. לדוגמה: /tmp/repos.
    4. מתקינים את תוכנת השירות ואת יחסי התלות של Edge apigee-service from /tmp/repos:
      > sudo bash /tmp/repos/shoestrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      שימו לב שאתם כוללים את הנתיב למאגר ה-repos.
  3. כדי להתקין את השירות API באמצעות שרת האינטרנט של Nginx:
    1. מגדירים את שרת האינטרנט של Nginx כפי שמתואר במאמר 'התקנה מהמאגר באמצעות שרת האינטרנט של Nginx' במאמר התקנת כלי השירות Edge apigee-setup.
    2. בצומת המרוחק, מורידים את הקובץ bootstrap_4.17.05.sh ל- /tmp/shoestrap_4.17.05.sh:
      bootstrap_4.17.05.sh

    3. בצומת המרוחק, מתקינים את כלי העזר ויחסי התלות של שירות Edge apigee:
      > sudo bash /tmp/shoestrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=Word.API:
      כאשר שם המשתמש apigeepassword=      pWord:פרוטוקול api.
  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 element -f configFile

    הדרישה היחידה בקובץ התצורה היא שקובץ התצורה צריך להיות נגיש או קריא למשתמש ה-API.

    השתמשו באפשרות '-c' כדי לציין את הרכיב שיש לעדכן. רשימת הרכיבים האפשריים כוללת:
    ldap = OpenLDAP
    cs = Cassandra
    zk =, zokeeper
    qpid = qpidd
    ps = postgresql
    edge =All Edge רכיבי Edge מלבד ממשק המשתמש של Edge ב-API: ממשק ה-API לניהול, מעבד הודעות, נתב, ממשק API של שרת QPID, ממשק API של מנהל הודעות, ממשק API של ממשק API עבור ממשק API של ניהול, ממשק API של ממשק API
    התקנת ממשק API של ממשק API
    ו-API של ממשק API עבור ממשק API של Edge
    qpid = qpidd
    ps = postgresql
    edge =כל רכיבי Edge למעט ממשק משתמש של Edge בממשק API: ממשק API לניהול, מעבד הודעות, נתב, ממשק API של שרת QPID, עדכון API
    ו-API של ממשק API של Edge
  8. בודקים את העדכון על ידי הרצת כלי השירות לאימות ממשק ה-API בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.

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

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

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

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

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

  1. אם הפעלתם את SMTP ב-Edge, מגדירים את SMTPMAILFROM בקובץ התצורה. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. עדכון של Cassandra ו-zoKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. מגדירים את כלל ה-iptables הבא:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'שם מארח' -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 ו-zoKeeper במחשב 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 'שם מארח' -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. נקה טבלאות iptable במחשב 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 ו-zoKeeper במכונה 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 'שם מארח' -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 ו-zoKeeper במכונה 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 'שם מארח' -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. נקה קובצי iptable במחשב 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 ו-zoKeeper במכונה 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 'שם מארח' -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. נקה קובצי iptable במחשב 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 ו-zoKeeper:
    1. במכונות 1, 2 ו-3 ב-Data Center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. במכונות 7, 8 ו-9 ב-Data Center 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 'שם מארח' -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. נקה קובצי iptable במחשב 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 'שם מארח' -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. נקה קובצי iptable במחשב 10:
        > sudo iptables -F
      5. חוזרים על שלבים 1 עד 4 במכונה 11.
  4. עדכון postgresql:
    1. Machines 6 in Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. Machines 12 in 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 ב-Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. מכונות 7 ב-Data Center 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 ב-Data Center 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 מארחים

צריך להוסיף שני מאפיינים חדשים לקובץ התצורה לפני שמריצים את תהליך השדרוג:

# 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"

דוגמה לקובץ תצורה מלא: התקנת API BaaS.

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

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

  1. עדכון Cassandra בגרסאות 5, 6 ו-7 של מכונות 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"

דוגמה לקובץ תצורה מלא: התקנת 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 Portal במחשב 7:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

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