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

Edge for Private Cloud גרסה 4.17.09

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

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

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

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

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

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

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

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

הפצה אוטומטית של הגדרות הנכס

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

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

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

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

הפורמט של הפרמטר הזה:

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

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

לפני שדרוג Apigee Edge, יש לעמוד בדרישות המוקדמות הבאות:

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

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

    > /opt/apigee/apigee-service/bin/apigee-all status

מה עושים אם עדכון נכשל

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

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

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

כברירת מחדל, כלי השירות 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.17.01.

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

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

  1. אם יש משימות של CRON שלא הוגדרו, צריך להשבית אותן לביצוע פעולת תיקון ב-Cassandra עד שהעדכון יושלם.
  2. מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
    הערה: התקנת RPM מחייבת גישה לרמה הבסיסית, אבל אפשר להגדיר את Edge בלי גישה לרמה הבסיסית.
  3. מתקינים את yum-utils ואת yum-Plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-Plugin-priorities
  4. משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
  5. אם מתקינים ב-AWS, מריצים את הפקודה yum-configure-manager:
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  6. מורידים את הקובץ של Edge מגרסה 4.17.09 bootstrap_4.17.09.sh אל bootstrap_4.17.09.sh:
    > curl https://software.apigee.com/shoestrap_4.17.09.sh -o /tmp/shoestrap_4.17.
  7. מתקינים את הכלי ואת יחסי התלות של apigee-service 4.17.09:
    > sudo bash /tmp/shoestrap_4.17.09.sh apigeeuser=uName apigeepassword=uName

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

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

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

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

    השתמשו באפשרות '-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
  12. בודקים את העדכון על ידי הרצת כלי השירות לאימות ממשק ה-API בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.

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

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

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

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

    3. בצומת המרוחק, מתקינים את כלי העזר ויחסי התלות של שירות Edge apigee:
      > sudo bash /tmp/shoestrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord:http
      כאשר שם המשתמש 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'.

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

  1. אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. עדכון של Cassandra ו-zoKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. עדכון Qpid ו-Postgres:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. הפעלה של postgresql:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. לעדכון LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. מעדכנים את שאר רכיבי Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון ממשק המשתמש של Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. יש לעדכן את Cassandra ו-zoKeeper במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. עדכון Qpid ו-Postgres במחשב 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. מפעילים את postgresql במכונה 2:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. עדכון רכיבי Edge במחשב 2 ו-1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    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. עדכון Qpid ו-Postgres במחשב 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. מפעילים את postgresql במכונה 4:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. חוזרים על שלבים 3 ו-4 במכונה 5.
  6. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. עדכון רכיבי Edge במחשב 4, 5, 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    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. עדכון Qpid ו-Postgres במחשב 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. מפעילים את postgresql במכונה 6:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. חוזרים על שלבים 3 ו-4 במכונה 7.
  6. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. מעדכנים את רכיבי Edge במחשב מגרסה 6, 7, 8, 9, 1, 4 ו-5 בסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    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. עדכון Qpid ו-Postgres במחשב 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
  4. מפעילים את postgresql במכונה 12:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. חוזרים על שלבים 3 ו-4 במכונה 13.
  6. עדכון LDAP במכונה 4 ו-5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  7. מעדכנים את רכיבי Edge במחשב בגרסאות 12, 13, 8, 9, 6, 7, 10 ו-11 בסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. עדכון ממשק המשתמש במחשב 6 ו-7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

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

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

  4. עדכון של API BaaS Portal במחשב 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

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

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

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

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

  1. מגדירים את SMTPMAILFROM בקובצי התצורה. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="My Company <myco@company.com>"
  2. צריך לעדכן את מרחבי המפתח של Cassandra בגורם השכפול הנכון לשני מרכזי הנתונים. צריך להריץ את השלב הזה פעם אחת בלבד בכל שרת של Cassandra באחד ממרכזי הנתונים:

    הערה: הפקודות שלמטה מגדירות את גורם השכפול כ-"3", ומציינת שלושה צומתי Cassandra באשכול. יש לשנות את הערך הזה לפי הצורך בהתקנה.
    1. מפעילים את הכלי Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. מפעילים את פקודות ה-CQL הבאות בהנחיה cqlsh> כדי להגדיר את רמות השכפול של Cassandra keyspaces:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH + שכפול = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas" WITHקונסולה = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      3. cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH העתק = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      4. cqlsh> ALTER KEYSPACE "system_traces" WITH העתק = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      5. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH + שכפול = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
      6. מציגים את מרחבי המפתחות באמצעות הפקודה:
        cqlsh> select * from system.schema_keyspaces;
      7. יציאה מ-cqlsh:
        cqlsh> exit
  3. (רק אם לא עדכנת את Cassandra כחלק מעדכון Edge) עדכון צומתי Cassandra במרכז נתונים 1, מכשיר אחד בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  4. (רק אם לא עדכנת את Cassandra כחלק מעדכון Edge) עליך לעדכן את צומתי Cassandra במרכז נתונים 2, במכונה אחת בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. יש לעדכן את ElasticSearch במחשבים במרכז נתונים 1, במכשיר אחד בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  6. יש לעדכן את ElasticSearch במחשבים במרכז נתונים 2, במכשיר אחד בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  7. עדכון של API BaaS Stack במכונות במרכז נתונים 1, מכונה אחת בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  8. עדכון של API BaaS Stack במכונות במרכז נתונים 2, מכונה אחת בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  9. עדכון של API BaaS Portal במכונות במרכז נתונים 1, מכשיר אחד בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  10. עדכון של API BaaS Portal במכונות במרכז נתונים 2, מכונה אחת בכל פעם:
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
  11. עדכון הערכים של מרחב המפתחות של BaaS. צריך להגדיר את מרחב המפתחות האלה לשכפול בזמן ההתקנה, אבל לא בזמן הריצה. הסרת השכפול שומרת גם על הזיכרון של Cassandra.

    צריך להריץ את השלב הזה פעם אחת בלבד בכל שרת של Cassandra באחד ממרכזי הנתונים:
    1. מפעילים את הכלי Cassandra cqlsh:
      > /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP
    2. מפעילים את פקודות ה-CQL הבאות כדי להגדיר את רמות הרפליקציה ב-Keyspaces של Cassandra:
      1. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH בנייד = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
      2. cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH במצב שכפול = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
      3. מציגים את מרחבי המפתחות באמצעות הפקודה:
        cqlsh> בוחרים * מתוך system.schema_keyspaces;
      4. יציאה מ-cqlsh:
        cqlsh> exit

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

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

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