עדכון של Apigee Edge 4.17.0x ל-4.18.01

Edge for Private Cloud גרסה 4.18.01

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

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

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

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

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

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

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

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

שמירה על תאימות

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

מאפיין (property) מיקום תיאור
conf_load_balancing_load.balancing.
  driver.nginx.server.retry
router.properties צריך להסיר את המאפיין הזה מהקובץ router.properties. כדי להגדיר אפשרויות לניסיון חוזר בגרסה 4.18.01 צריך להשתמש במאפיינים של הגדרת המארח הווירטואלי.

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

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

נדרש שדרוג ל-Postgres 9.6

המהדורה הזו של Edge כוללת שדרוג ל-Postgres 9.6. כחלק מהשדרוג הזה, כל נתוני Postgres יועברו ל-Postgres 9.6.

ברוב מערכות הייצור של Edge נעשה שימוש בשני צומתי Postgres שהוגדרו לשכפול במצב המתנה ראשי. במהלך העדכון, בזמן שצמתים של Postgres מושבתים לצורך עדכון, נתוני הניתוח עדיין נכתבים בצומתי ה-Qpid. אחרי העדכון של צומתי Postgres וחיבורם לאינטרנט, נתוני הניתוח מועברים לצומתי Postgres.

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

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

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

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

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

התקנת צומת Postgres חדש במצב המתנה

התהליך הזה יוצר שרת המתנה של Postgres בצומת חדש. חשוב להתקין שרת המתנה חדש של Postgres לגרסה הקיימת של Edge (4.17.0x), ולא לגרסה 4.18.01.

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

כדי ליצור צומת Postgres במצב המתנה:

  1. במאסטר הנוכחי של Postgres, עורכים את הקובץ /opt/apigee/customer/application/postgresql.properties כדי להגדיר את האסימון הבא:
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32
    trust\ \nhost replication apigee new_slave_ip/32 trust

    existing_slave_ip היא כתובת ה-IP של שרת ההמתנה הנוכחי של Postgres ו-new_slave_ip היא כתובת ה-IP של צומת ההמתנה החדש.

    אם הקובץ postgresql.properties לא קיים, יוצרים אותו ומשתמשים ב-chown כדי לתת למשתמש apigee גישה אליו, כמו בדוגמה הבאה:

    chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
  2. מפעילים מחדש את apigee-postgresql במאסטר של Postgres:
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. כדאי לבדוק את הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר כדי לוודא שצומת ההמתנה החדש נוסף. השורות הבאות אמורות להופיע בקובץ הזה:
    host replication apigee existing_slave_ip/32 trust
    host replication apigee new_slave_ip/32 trust
  4. מתקינים את שרת ההמתנה החדש של Postgres:
    1. עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge כדי לציין את הפרטים הבאים:
      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102 
    2. משביתים את SELinux כפי שמתואר במאמר התקנת כלי השירות Edge apigee-setup.
    3. מורידים את קובץ Edge bootrap_4.17.0x.sh (כאשר 4.17.0x הוא 4.17.01, 4.17.05, או 4.17.09) אל /tmp/bootstrap_4.17.0x.sh :
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. מתקינים את תוכנת השירות apigee-service ואת יחסי התלות של Edge:
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName
        apigeepassword=pWord
    5. צריך להשתמש ב-apigee-service כדי להתקין את כלי השירות apigee-setup:
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. התקנת Postgres:
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. בשרת ההמתנה החדש, מריצים את הפקודה הבאה:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שהכתובת במצב המתנה.

הוצאה משימוש של צומת Postgres

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

  1. מוודאים ש-Postgres פועל:
    > /opt/apigee/apigee-service/bin/apigee-all status

    אם Postgres לא פועל, יש להפעיל אותו:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. מריצים את פקודת ה-cURL הבאה בצומת ההמתנה החדש כדי לקבל את ה-UUID של צומת ההמתנה החדש:
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    ה-UUID (מזהה ייחודי) של הצומת ' [eb4-8', ' אמור להופיע "[eb4-server' " בסוף "eb5-server:" "ebtype- "end' בסוף "9ebtype- "end' end5-server"

  3. כדי להפסיק את צומת ההמתנה החדש, מריצים את הפקודה הבאה בצומת ההמתנה החדש:
    > /opt/apigee/apigee-service/bin/apigee-all stop
  4. בצומת המאסטר של Postgres, עורכים את /opt/apigee/customer/application/postgresql.properties כדי להסיר את צומת ההמתנה החדש מ-conf_pg_hba_Replication.connected:
    conf_pg_hba_Replication.connected=host שכפול apigee existing_slave_ip/32 אמון.
  5. מפעילים מחדש את apigee-postgresql במאסטר של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql מחדש
  6. יש לוודא שצומת ההמתנה החדש הוסר על ידי הצגת הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במחשב הראשי. אמורה להופיע רק השורה הבאה בקובץ הזה:
    ממשק השכפול של המארח existing_slave_ip/32 אמון
  7. כדי למחוק את ה-UUID של צומת ההמתנה מ-zoKeeper, צריך לבצע את הקריאה הבאה ל-Edge management API בצומת שרת הניהול:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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

לפני שדרוג 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.0x.

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

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

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

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. במקום זאת, צריך לצלם תמונת מצב של מאגר הנתונים ברשת של Postgres. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.
  2. אם יש משימות של CRON שלא הוגדרו, צריך להשבית אותן לביצוע פעולת תיקון ב-Cassandra עד שהעדכון יושלם.
  3. מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
    הערה: התקנת RPM מחייבת גישה לרמה הבסיסית, אבל אפשר להגדיר את Edge בלי גישה לרמה הבסיסית.
  4. מתקינים את yum-utils ואת yum-Plugin-priorities:
    > sudo yum install yum-utils
    > sudo yum install yum-Plugin-priorities
  5. משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
  6. אם מתקינים ב-Oracle 7.x, מריצים את הפקודה הבאה:
    > sudo yum-config-manager --enable ol7_optional_updated
  7. אם מתקינים ב-AWS, מריצים את הפקודות הבאות של yum-configure-manager:
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  8. מורידים את הקובץ bootstrap_4.18.01.sh מגרסת Edge 4.18.01 לכתובת bootstrap_4.18.01.sh:
    > curl https://software.apigee.com/shoestrap_4.18.01.sh -o /tmp/shoestrap_4.18.
  9. מתקינים את הכלי ואת יחסי התלות של apigee-service 4.18.01:
    > sudo bash /tmp/shoestrap_4.18.01.sh apigeeuser=uName apigeepassword=uName

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

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

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

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

    השתמשו באפשרות '-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
  14. כדי לבדוק את העדכון, מריצים את הכלי apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
  15. אם התקנת צומת Postgres חדש במצב המתנה, צריך להוציא אותו משימוש כפי שמתואר למעלה בקטע ביטול של צומת Postgres.

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.

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

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

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

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

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

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

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

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

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

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

    3. בצומת המרוחק, מתקינים את כלי העזר ויחסי התלות של שירות Edge apigee:
      > sudo bash /tmp/shoestrap_4.18.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=Word.API:
      כאשר שם המשתמש apigeepassword=http
      apigeepassword=pWord:api.
  5. משתמשים ב-apigee-service כדי לעדכן את כלי העזר apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. מעדכנים את הכלי apigee-validate בשרת הניהול.
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. מעדכנים את כלי העזר apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. מריצים את תוכנית השירות לעדכון בצמתים לפי הסדר שמתואר בקטע 'סדר העדכון של המכונה' שבהמשך:
    > /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
  9. כדי לבדוק את העדכון, מריצים את הכלי apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
  10. אם התקנת צומת Postgres חדש במצב המתנה, צריך להוציא אותו משימוש כפי שמתואר למעלה בקטע ביטול ההפעלה של צומת Postgres.

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.

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

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

הסדר שבו מעדכנים את המכונות בהתקנת 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:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. לעדכון LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Stop Postgres Server, Qpid server ו-PostgreSQL:
    > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    > /opt/apigee-service edge-postgres-server stop
  6. עדכון postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. מעדכנים את מסד הנתונים Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. מעדכנים את שאר רכיבי Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. עדכון ממשק המשתמש של 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 במחשב 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. עדכון רכיבי Edge במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. מעדכנים את postgresql במכונה 2:
    1. הפסקת השימוש ב-Postgres Server, ב-Qpid server וב-postgresql:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/apigee-apigestop
    2. עדכון postgresql:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. מעדכנים את מסד הנתונים Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. מעדכנים את רכיבי Edge במחשב 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

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

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

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

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. במקום זאת, צריך לצלם תמונת מצב של מאגר הנתונים ברשת של Postgres. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.
  3. יש לעדכן את Cassandra ו-zoKeeper במכונה 1, 2 ו-3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. עדכון Qpid במכונה 4 ו-5:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. עדכון רכיבי Edge במחשב 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. ??מעדכנים את מכונות 4 ו-5:
    1. הפסקת שרת Postgres ושרת Qpid במחשב 4:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. עצירה של שרת Postgres, שרת Qpid ו-postgresql במכונה 5:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop/opt/apigeapigeapigeapil/
    3. אם מותקן, מפסיקים את פעולת השרת Postgres ו-postgresql בצומת ההמתנה החדשה שהוספת עבור החזרה למצב הקודם:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgr
    4. עדכון postgresql במכונות מס' 4:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. עדכון מסד הנתונים Postgres במחשב 4 (מאסטר של Postgres בלבד):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. עדכון postgresql במחשבים 5:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. הפעלה של שרת Postgres ושרת Qpid במחשבים 4 ו-5:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. מגדירים את Postgres כצומת המתנה על ידי הרצת הפקודות הבאות במכונה 5:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    9. מאמתים את סטטוס השכפול על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול מוצלח:

      במכונה 4, הצומת הראשי, מריצים את:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      מאמתים שהיא המאסטר.

      צומת ההמתנה במחשב 5:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.
  9. עדכון רכיבי Edge במחשב גרסה 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. מקפידים להוציא את צומת ההמתנה החדש לפי התהליך שמתואר למעלה בקטע ביטול ההפעלה של צומת Postgres.

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.

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

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

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

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. במקום זאת, צריך לצלם תמונת מצב של מאגר הנתונים ברשת של Postgres. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.
  3. עדכון של Cassandra ו-zoKeeper במכונה 1, 2 ו-3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. עדכון Qpid במכונה 6 ו-7:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. מעדכנים את רכיבי Edge במחשב בגרסאות 6, 7, 1, 4 ו-5 לפי הסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
  8. עדכון מכונות מגרסה 8 ו-9:
    1. הפסקת שרת Postgres במחשב 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. הפסקת שרת Postgres ו-postgresql במחשב 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. הפסקת שרת Qpid במחשבים 6 ו-7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. אם מותקן, מפסיקים את פעולת השרת Postgres ו-postgresql בצומת ההמתנה החדשה שהוספת עבור החזרה למצב הקודם:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgr
    5. עדכון postgresql במחשבים 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. עדכון מסד הנתונים Postgres במחשב 8 (מאסטר של Postgres בלבד):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. עדכון postgresql במכונות 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. הפעלת שרת Postgres במחשבים 8 ו-9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. הפעלת שרת Qpid במחשבים 6 ו-7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. מגדירים את Postgres כצומת המתנה באמצעות הרצת הפקודות הבאות במכונה 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    11. מאמתים את סטטוס השכפול על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול תקין:
      במכונה 8, הצומת הראשי, מריצים את:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      מאמתים שהיא המאסטר.

      צומת ההמתנה במחשב 9:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.
  9. מעדכנים את רכיבי Edge במחשב 8 ובמכונה 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. מקפידים להוציא את צומת ההמתנה החדש לפי התהליך שמתואר למעלה בקטע ביטול ההפעלה של צומת Postgres.

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.

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

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

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

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. במקום זאת, צריך לצלם תמונת מצב של מאגר הנתונים ברשת של Postgres. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.
  3. עדכון של Cassandra ו-zoKeeper במכונה 1, 2 ו-3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. עדכון Qpid במכונה 12 ו-13:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. עדכון LDAP במכונה 4 ו-5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. מעדכנים את רכיבי Edge במחשב בגרסאות 12, 13, 6, 7, 10 ו-11 בסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון ממשק המשתמש במחשב 6 ו-7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile??
  8. עדכון מכונות מגרסה 8 ו-9:
    1. הפסקת שרת Postgres במחשב 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. הפסקת שרת Postgres ו-postgresql במחשב 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. הפסקת שרת Qpid במחשבים 12 ו-13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. אם מותקן, מפסיקים את פעולת השרת Postgres ו-postgresql בצומת ההמתנה החדשה שהוספת עבור החזרה למצב הקודם:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgr
    5. עדכון postgresql במחשבים 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. עדכון מסד הנתונים Postgres במחשב 8 (מאסטר של Postgres בלבד):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. עדכון postgresql במכונות 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. הפעלת שרת Postgres במחשבים 8 ו-9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. הפעלת שרת Qpid במחשבים 12 ו-13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. מגדירים את Postgres כצומת המתנה באמצעות הרצת הפקודות הבאות במכונה 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    11. מאמתים את סטטוס השכפול על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול תקין:
      במכונה 8, הצומת הראשי, מריצים את:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      מאמתים שהיא המאסטר.

      צומת ההמתנה במחשב 9:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.
  9. מעדכנים את רכיבי Edge במחשב 8 ובמכונה 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile??
  10. מקפידים להוציא את צומת ההמתנה החדש לפי התהליך שמתואר למעלה בקטע ביטול ההפעלה של צומת Postgres.

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.

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

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

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

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. במקום זאת, צריך לצלם תמונת מצב של מאגר הנתונים ברשת של Postgres. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.
  3. מעדכנים את 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
  4. מעדכנים את 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.
  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, 1, 2, 3 ב-Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. מכונות 10, 11, 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
  8. ?מעדכנים את מכונה 6 במרכז הנתונים 1 ו-12 במרכז הנתונים 2:
    1. הפסקת שרת Postgres במחשב 6:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. הפסקת שרת Postgres ו-postgresql במחשב 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. הפסקת שרת Qpid במחשבים 4, 5, 10 ו-11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. אם מותקן, מפסיקים את פעולת השרת Postgres ו-postgresql בצומת ההמתנה החדשה שהוספת עבור החזרה למצב הקודם:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgr
    5. עדכון postgresql במחשבים 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. עדכון מסד הנתונים Postgres במחשב 6 (מאסטר של Postgres בלבד):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. עדכון postgresql במחשבים 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. הפעלת שרת Postgres במחשבים 6 ו-12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. הפעלת שרת Qpid במחשבים 4, 5, 10 ו-11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. מגדירים את Postgres כצומת המתנה על ידי הרצת הפקודות הבאות במכונה 12:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postlication-configlication
      apigee-postgresq
    11. מאמתים את סטטוס השכפול על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת צריכה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול בהצלחה:
      במכונה 6, הצומת הראשי, מריצים את:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      מאמתים שהיא המאסטר.

      צומת ההמתנה במחשב 12:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.
  9. עדכון רכיבי Edge במחשב גרסה 6 ו-12:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. מקפידים להוציא את צומת ההמתנה החדש לפי התהליך שמתואר למעלה בקטע ביטול ההפעלה של צומת Postgres.

    אם אתם משתמשים באחסון ברשת, אין צורך להתקין את הצומת החדש. מידע נוסף זמין בקטע שדרוג נדרש ל-Postgres 9.6.

להתקנת 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
עדכון של Apigee Edge מ-4.17.01/4.17.05 ל-4.17.09