עדכון של Apigee Edge 4.51.00 או 4.52.00 או 4.52.01 ל-4.52.02

‫Apigee תומך בשדרוג של Edge for Private Cloud ישירות מגרסה 4.51.00, 4.52.00 או 4.52.01 לגרסה 4.52.02. בדף הזה מוסבר איך לבצע שדרוגים כאלה.

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

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

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

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

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

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

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

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

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

  • מוודאים ש-Edge פועל
    כדי לוודא ש-Edge פועל במהלך תהליך העדכון, משתמשים בפקודה: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • מוודאים ששיטת הדחיסה של Cassandra היא LeveledCompactionStrategy
    בהתאם לגרסה הנוכחית, מבצעים את השינויים הנדרשים בשיטת הדחיסה של Cassandra. פועלים לפי השלבים הבאים ואז חוזרים לתהליך השדרוג הראשי:

אילו שלבים מיוחדים צריך לבצע כדי לשדרג

כדי לשדרג ל-Edge for Private Cloud 4.52.02, כדאי לבצע שלבים ספציפיים לשדרוג תוכנה מסוימת. השלבים הנדרשים משתנים בהתאם לגרסה הנוכחית. בטבלה שלמטה מפורטות תוכנות שנדרשים עבורן שלבים נוספים, ובהמשך מופיעות הוראות מפורטות לכל אחת מהן. אחרי שמשלימים את המשימות הנדרשות, חוזרים לתהליך השדרוג הראשי כדי להמשיך בתהליך השדרוג.

גרסה נוכחית תוכנה שנדרשים שלבים מיוחדים כדי לשדרג אותה לגרסה 4.52.02
4.52.01 Cassandra
4.52.00 ‫Zookeeper, ‏ Cassandra, ‏ Qpid
4.51.00 ‫Zookeeper, ‏ Postgres, ‏ Cassandra, ‏ Qpid

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

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

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

שדרוג ל-Zookeeper 3.8.3

‫Edge for Private Cloud 4.52.02 לא כולל שדרוג של Zookeeper. עם זאת, אם אתם משדרגים מגרסה ישנה יותר מ-4.52.01, אתם צריכים לפעול לפי השלבים לשדרוג Zookeeper שמפורטים בהמשך.

  • אם אתם משדרגים מגרסה 4.51.00 או 4.52.00 של Edge for Private Cloud, אתם צריכים לפעול לפי השלבים שמפורטים במאמר שדרוג חובה ל-Zookeeper 3.8.3 כדי לשדרג את Zookeeper.
  • אם אתם משדרגים מ-Edge for Private Cloud גרסה 4.52.01, אתם כבר אמורים להשתמש ב-Zookeeper גרסה 3.8.3, ולא צריך לבצע שלבים מיוחדים כדי לשדרג את Zookeeper.

שדרוג ל-Postgres 14

  • אם אתם משדרגים מ-Edge for Private Cloud 4.51.00 ל-4.52.02, אתם צריכים לבצע את השלבים לשדרוג Postgres, גם אם Edge for Private Cloud 4.52.02 לא כולל שדרוג של Postgres. שדרוג מ-Edge for Private Cloud 4.51.00 ל-4.52.02 מחייב ביצוע של שלבי שדרוג נוספים של Postgres. מומלץ לעיין בקטע שדרוג חובה ל-Postgres 14.
  • אם אתם משדרגים מ-Edge for Private Cloud 4.52.00 או 4.52.01 ל-4.52.02, לא נדרשים שלבי שדרוג נוספים של Postgres.

שדרוג ל-Cassandra 3.11.16

‫Apigee Edge for Private Cloud 4.52.02 כולל שדרוג של Cassandra לגרסה 3.11.16. ‫Cassandra הוא רכיב קריטי של Apigee, והשדרוג הזה כולל גם עדכונים לתוכנת הדרייבר ברכיבי זמן ריצה וניהול שונים שמשמשים לשליחת שאילתות ל-Cassandra ולכתיבה ב-Cassandra.

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

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

פורטל המפתחים – תיעוד של ממשקי API

פורטל המפתחים של Apigee Drupal מציע מגוון תכונות לתיעוד ממשקי ה-API. מומלץ להפסיק להשתמש בפורטל למפתחים שמבוסס על Drupal 7. אם אתם עדיין משתמשים בו ומנצלים את התכונה SmartDocs שלו, המאמר שימוש בממשקי SmartDocs API רלוונטי לכם. אם אתם משתמשים בגרסאות חדשות יותר של פורטל המפתחים, לא תהיה השפעה על תיעוד ה-API במהלך השדרוג הזה.

כשמשדרגים את Apigee לגרסה 4.52.02, מודלים של API שנוצרו באמצעות התכונה SmartDocs של פורטל המפתחים Drupal 7 לא מועברים אוטומטית לגרסה החדשה יותר. תצטרכו לייצא ידנית כל מודל באמצעות פורטל המפתחים ולייבא אותו שוב אחרי השלמת השדרוג.

הסברים על המונחים שבהמשך

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

ניהול: ניהול כולל את האדמיניסטרציה של מערכת Apigee Edge. האיסור הזה כולל, בין היתר, פריסות, שינויים באפליקציות, במוצרים, בשרתי יעד, במאגרי מפתחות וכו'. כל ממשקי הניהול (והלקוחות שלהם, כמו ממשק המשתמש של Apigee ופורטל המפתחים) כלולים בהיקף הזה.

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

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

אסטרטגיות שדרוג

כמה מרכזי נתונים

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

מרכז נתונים יחיד

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

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

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

  • רענון טוקנים של OAuth ב-Runtime APIs
  • ממשקי API של זמן ריצה באמצעות מדיניות גישה לישות
  • רשימה של ממשקי API לניהול אפליקציות למפתחים
  • מוצרי API לניהול

ההשפעה שמתוארת למעלה היא בנוסף לממשקי ה-API הספציפיים לניהול, שלא יפעלו בכל מרכזי הנתונים עד שכל מרכזי הנתונים ישודרגו. רשימה של ממשקי ניהול כאלה מופיעה בשלבים בסעיפים הבאים.

רולבק – רמה גבוהה

  • ההשפעה במהלך החזרה למצב הקודם

    חזרה מ-Cassandra 3.11.x ל-2.1.x משפיעה על תעבורת הנתונים בזמן הריצה ועל תעבורת הנתונים של הניהול במרכז הנתונים (DC) שבו מתבצעת החזרה. בנוסף, יכול להיות שיהיו שיבושים בממשקי API מסוימים לניהול בכל מרכזי הנתונים, בלי קשר למרכז הנתונים שמתבצע בו כרגע שחזור.

  • איך מבצעים חזרה לגרסה קודמת של DC לפי DC

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

  • החזרה לגרסה קודמת של אשכול ששודרג חלקית

    אם לפחות מרכז נתונים אחד נשאר פעיל באופן מלא בגרסה הישנה של Cassandra‏ (2.1.22), אפשר לבצע Rollback למרכזי נתונים משודרגים אחרים על ידי ביצוע בנייה מחדש ממרכז נתונים של Cassandra 2.1.X שפועל באופן מלא.

  • Cluster-Wide Rollback

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

  • נקודות שחשוב להביא בחשבון לפני השדרוג

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

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

שדרוג של Cassandra מגרסה 2.1.x לגרסה 3.11.x יכול להשפיע באופן משמעותי על תנועת זמן הריצה ועל ממשקי API מסוימים לניהול. ההשפעות האלה חלות גם במהלך החזרה לגרסה קודמת, ויכולות לגרום להשבתה או לאובדן נתונים.

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

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

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

החזרה של כמה מרכזי נתונים מתבצעת בגישה של מרכז נתונים אחר מרכז נתונים (DC-by-DC). בגישה הזו, התנועה ממרכז הנתונים שמתבצע בו שחזור מועברת למרכזי נתונים פונקציונליים אחרים, כדי להבטיח תהליך שחזור מבוקר ומבודד של Cassandra, ‏ Management Server וRuntime nodes, וכדי למנוע שיבושים בתנועה.

פרטים נוספים זמינים בקטע החזרה לגרסה הקודמת של Cassandra 3.11.16.

שלב 0: מצב התחלתי

  • רכיבי Zookeeper, ‏ Postgres ו-LDAP כבר שודרגו לגרסאות 4.52.02. ה-Edge שלכם עבור אשכול ענן פרטי יציב ועובד. אם נדרשת חזרה לגרסה קודמת, האשכול יחזור למצב הזה.
  • ‫Cassandra ב-Apigee פועל עם גרסה 2.1.22.
  • רכיבי Edge:
    • שרת הניהול מתקשר עם Cassandra באמצעות פרוטוקול thrift ישן יותר.
    • שרתי זמן ריצה (מעבדי הודעות ונתבים) שמתקשרים עם Cassandra באמצעות פרוטוקול thrift ישן יותר.
מצב זמן הריצה בשלב הזה סטטוס הניהול בשלב הזה
זמן הריצה פועל באופן מלא הניהול פועל באופן מלא

שלב 1: הכנה לשדרוג

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

  1. משנים את Cassandra כך שישתמש ב-LeveledCompactionStrategy.
  2. גיבוי של Cassandra באמצעות Apigee.
  3. יוצרים תמונות מצב של מכונות וירטואליות של צמתי Cassandra (אם אפשר).
  4. יוצרים קובץ תצורה לשדרוג Cassandra בכל צומת Cassandra בנתיב /opt/apigee/apigee-cassandra/cass_upgrade.conf עם התוכן הבא: 
    # IP Address of node
HOSTIP=10.0.0.1

# Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_USERNAME=<cassuser>

# Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
CASS_PASSWORD=<casspass>

# Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
CASS_PORT=9160

# Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
CASS_CQL_PORT=9042

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    אם אי אפשר ליצור את הקובץ בנתיב /opt/apigee/apigee-cassandra/cass_upgrade.conf, יוצרים את הקובץ /opt/silent.conf עם אותו תוכן בכל צומת של Cassandra.
  5. אם אתם משתמשים בתכונה SmartDocs של פורטל הפיתוח Apigee Drupal 7, אתם צריכים לייצא כל אחד מהמודלים שלכם על ידי הורדה שלהם בפורמט JSON מממשק המשתמש של פורטל הפיתוח. יהיה צורך לייבא מחדש את המודלים האלה אל Apigee אחרי ששרתי הניהול יעודכנו.
  6. אם היציאות 9160 ו-9042 לא קיימות, צריך לוודא שאפשר לגשת אליהן מכל רכיבי Edge לצמתי Cassandra. מידע נוסף זמין במאמר בנושא דרישות לגבי יציאות.

שלב 2: הפניית התנועה ממרכז הנתונים הראשון

  1. חסימת תנועת נתונים נכנסת של זמן ריצה וניהול ממרכז הנתונים הראשון.
  2. הפניית כל התנועה בזמן הריצה וממשקי הניהול אל מרכזי הנתונים הפונקציונליים האחרים.
  3. מוודאים שהתעבורה של זמן הריצה והניהול מטופלת בהצלחה על ידי מרכזי הנתונים האחרים.

שלב 3: משדרגים את כל צמתי Cassandra במרכז הנתונים הראשון

  1. משדרגים את כל הצמתים של Cassandra במרכז הנתונים אחד אחרי השני. מריצים את הפקודות הבאות בכל צומת, אחת אחרי השנייה: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. אחרי שמעדכנים צומת, מריצים את הפקודה הבאה בצומת כדי להריץ כמה אימותים לפני שממשיכים:
    ‫
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
     הפלט של הפקודה שלמעלה יהיה דומה לזה: 
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
  3. מריצים את הפקודה post_upgrade הבאה בכל צומת של Cassandra, אחד אחרי השני, אחרי שהשדרוג מסתיים: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
מצב זמן הריצה בשלב הזה סטטוס הניהול בשלב הזה
  • תנועה בזמן ריצה נחסמת במרכזי נתונים שעוברים שדרוג
  • זמן הריצה פועל באופן מלא במרכזי נתונים אחרים

שלב 4: משדרגים את כל צמתי הניהול במרכז הנתונים הראשון

משדרגים את כל צמתי הניהול במרכז הנתונים:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
מצב זמן הריצה בשלב הזה סטטוס הניהול בשלב הזה
  • תנועה בזמן ריצה נחסמת במרכזי נתונים שעוברים שדרוג
  • זמן הריצה פועל באופן מלא

שלב 5: משדרגים את כל צמתי זמן הריצה במרכז הנתונים הראשון

משדרגים את כל נתבי (Router) ועיבודי ההודעות (Message Processor) במרכז הנתונים אחד אחרי השני:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
מצב זמן הריצה בשלב הזה סטטוס הניהול בשלב הזה
  • תנועה בזמן ריצה נחסמת במרכזי נתונים שעוברים שדרוג
  • זמן הריצה פועל באופן מלא במרכזי נתונים אחרים

שלב 6: מפנים מחדש את התנועה למרכז הנתונים הראשון

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

שלב 7: שדרוג של מרכזי נתונים אחרים

חוזרים על שלב 1 עד שלב 6 במרכזי הנתונים הנותרים, אחד בכל פעם, על ידי הפניית התנועה ממרכזי הנתונים האלה, עדכון תוכנת Apigee והפעלה מחדש של התנועה במרכזי הנתונים האלה.

שלב 8: מריצים מחדש את שלב השדרוג בכל צמתי הניהול

מריצים מחדש את פקודת השדרוג הבאה בכל צמתי הניהול במרכזי הנתונים:

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

שלב 9 – [אופציונלי] ייבוא של מסמכים חכמים שיוצאו בעבר

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

צריך לבצע את הפעולה הזו רק אם משתמשים בפורטל מפתחים שמבוסס על Drupal 7 ובתכונה smartdocs.

מצב זמן הריצה בשלב הזה סטטוס הניהול בשלב הזה
זמן הריצה פועל באופן מלא הניהול פועל באופן מלא

שלב 10 – מחיקת טבלאות שלא בשימוש

מריצים את הפקודה הבאה כדי להסיר טבלאות ישנות שלא נמצאות בשימוש מאשכול Cassandra. עד שהסקריפט יופעל, לא תוכלו להשתמש בתכונות מסוימות של Cassandra (למשל, הגדרת אימות חדש – מנגנוני אימות ישנים ימשיכו לפעול). אפשר להריץ את הפקודה הזו רק בצומת אחד באשכול

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

שלב 11 – שדרוג כל שאר הרכיבים של Edge ורכיבים אחרים ל-Private Cloud 4.52.02

משדרגים את כל הצמתים שנותרו מסוג edge-qpid-server ו-edge-postgres-server בכל האזורים, אחד אחרי השני.

בשלב הזה, אם אתם משדרגים מגרסאות קודמות ל-Edge for Private Cloud 4.52.01 כמו שמתואר בהמשך, צריך לבצע שלבים נוספים לשדרוג Qpid ו-Postgres בהתאמה, ולשדרג את שאר הרכיבים לפי השלבים האלה.

שדרוג ל-Qpid J-Broker

גם אם Edge for Private Cloud 4.52.02 לא כולל שדרוג ל-Qpid, אם אתם משדרגים מגרסאות ישנות יותר מ-4.52.01, אתם צריכים לבצע את השלבים לשדרוג QPID.

  • אם אתם משדרגים מ-Edge for Private Cloud בגרסה 4.51.00 או 4.52.00 לגרסה 4.52.02, אתם צריכים לבצע שלבים נוספים לשדרוג Qpid. אם אתם משדרגים מגרסה 4.51.00 או 4.52.00 לגרסה 4.52.02, אתם צריכים לעיין בקטע שדרוג Qpid.
  • אם אתם משדרגים מ-Edge for Private Cloud 4.52.01 ל-4.52.02, אתם כבר אמורים להשתמש בגרסה האחרונה של Qpid Broker, ולא נדרשים שלבים נוספים של Qpidupgrade.

ממשק משתמש חדש של Edge

בקטע הזה מפורטים שיקולים לגבי ממשק המשתמש של Edge. מידע נוסף זמין במאמר בנושא ממשק המשתמש החדש של Edge ל-Private Cloud.

התקנת ממשק המשתמש של Edge

אחרי שמסיימים את ההתקנה הראשונית, מומלץ להתקין את ממשק המשתמש של Edge, שהוא ממשק משתמש משופר למפתחים ולמנהלים של Apigee Edge לענן פרטי.

שימו לב: בממשק המשתמש של Edge צריך להשבית את האימות הבסיסי ולהשתמש בIDP כמו SAML או LDAP.

מידע נוסף זמין במאמר התקנת ממשק המשתמש החדש של Edge.

עדכון ממשק המשתמש של Edge

כדי לעדכן את רכיב ממשק המשתמש של Edge, צריך לבדוק את הגרסה של Edge for Private Cloud שממנה משדרגים:

עדכון באמצעות Apigee mTLS

כדי לעדכן את Apigee mTLS , פועלים לפי השלבים הבאים:

חזרה לגרסה קודמת של עדכון

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

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

רישום מידע על עדכונים

כברירת מחדל, כלי השירות 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 מוצגים Router ומעבד בקשות באותו הצומת.
  4. מוודאים שאפשר להגיע לנתב.
  5. חוזרים על שלבים 2 עד 4 בשביל כל הנתבים שנותרו.
  6. ממשיכים את העדכון בכל המחשבים שנותרו בהתקנה.

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

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

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

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

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

  1. אם יש משימות cron שמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
  2. מתחברים לצומת כמשתמש root כדי להתקין את חבילות ה-RPM של Edge.
  3. מתקינים את yum-utils ואת yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. משביתים את SELinux כמו שמתואר במאמר התקנה של כלי השירות apigee-setup של Edge.
  5. אם אתם מתקינים ב-Oracle 7.x, מריצים את הפקודה הבאה: 
    sudo yum-config-manager --enable ol7_optional_latest
  6. אם אתם מתקינים ב-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

  7. אם אתם משתמשים כרגע ב-Edge 4.51.00:

    1. מורידים את קובץ Edge bootstrap_4.52.02.sh אל /tmp/bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. מריצים את הפקודה הבאה כדי להתקין את כלי השירות Edge 4.52.02 apigee-service ואת יחסי התלות: 
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.

      כברירת מחדל, תוכנת ההתקנה בודקת אם Java 1.8 מותקנת. אם לא, תוכנת ההתקנה תתקין אותו בשבילכם.

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

      • ‫I: התקנה של OpenJDK 1.8 (ברירת מחדל).
      • ‫C: המשך ללא התקנת Java.
      • ‫Q: יציאה. כדי להשתמש באפשרות הזו, צריך להתקין את Java באופן עצמאי.
    3. משתמשים בפקודה apigee-service כדי לעדכן את כלי השירות apigee-setup, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. מעדכנים את כלי השירות apigee-validate בשרת הניהול, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. מעדכנים את כלי השירות apigee-provision בשרת הניהול, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. מריצים את כלי השירות update בצמתים באמצעות הפקודה הבאה: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      צריך לבצע את הפעולות בסדר שמתואר במאמר סדר העדכון של המכונות.

      כאשר:

      • ‫component הוא רכיב Edge שרוצים לעדכן. הערכים האפשריים כוללים:
        • cs: Cassandra
        • ‫edge: כל רכיבי Edge חוץ מ-Edge UI: שרת ניהול, מעבד הודעות, נתב, שרת Qpid, שרת Postgres
        • ‫ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • ‫sso: Apigee SSO (אם התקנתם SSO)
        • ‫ue: ממשק משתמש חדש של Edge
        • ‫ui: ממשק משתמש קלאסי של Edge
        • zk: Zookeeper
      • ‫configFile הוא אותו קובץ הגדרות שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסה 4.50.00 או 4.51.00.

      אפשר להריץ את update.sh על כל הרכיבים על ידי הגדרת component ל-all, אבל רק אם יש לכם פרופיל התקנה של Edge all-in-one (AIO). לדוגמה:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. אם עדיין לא עשיתם זאת, מפעילים מחדש את רכיבי Edge UI בכל הצמתים שבהם הם פועלים: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. כדי לבדוק את העדכון, מריצים את כלי השירות apigee-validate בשרת הניהול, כמו שמתואר במאמר בדיקת ההתקנה.

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

עדכון לגרסה 4.52.02 ממאגר מקומי

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

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

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

כדי לעדכן ממאגר מקומי בגרסה 4.52.02:

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

      הפקודה הזו יוצרת ספרייה חדשה בשם repos בספרייה שמכילה את קובץ ה-‎ .tar. לדוגמה /tmp/repos.

    4. מתקינים את כלי השירות Edge apigee-service ואת יחסי התלות מכתובת /tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      שימו לב שכוללים בפקודה הזו את הנתיב לספרייה repos.

  3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
    1. מגדירים את שרת האינטרנט Nginx כמו שמתואר במאמר בנושא התקנה ממאגר באמצעות שרת האינטרנט Nginx בקטע בנושא התקנת כלי השירות apigee-setup של Edge.
    2. בצומת המרוחק, מורידים את קובץ Edge bootstrap_4.52.02.sh אל /tmp/bootstrap_4.52.02.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh

      כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם קודם למאגר, ו-remoteRepo היא כתובת ה-IP או שם ה-DNS של צומת המאגר.

    3. בצומת המרוחק, מתקינים את כלי השירות Edge apigee-setup ואת יחסי התלות: 
      sudo bash /tmp/bootstrap_4.52.02.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. מריצים את כלי השירות update בצמתים לפי הסדר שמתואר במאמר סדר העדכון של המכונות: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    כאשר:

    • ‫component הוא רכיב Edge שרוצים לעדכן. בדרך כלל מעדכנים את הרכיבים הבאים:
      • cs: Cassandra
      • ‫edge: כל רכיבי Edge חוץ מ-Edge UI: שרת ניהול, מעבד הודעות, נתב, שרת Qpid, שרת Postgres
      • ‫ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • ‫sso: Apigee SSO (אם התקנתם SSO)
      • ue ממשק המשתמש החדש של Edge
      • ‫ui: ממשק משתמש קלאסי של Edge
      • zk: Zookeeper
    • ‫configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסה 4.50.00 או 4.51.00.

    אפשר להריץ את update.sh על כל הרכיבים על ידי הגדרת component ל-all, אבל רק אם יש לכם פרופיל התקנה של Edge all-in-one (AIO). לדוגמה:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. אם עדיין לא עשיתם זאת, מפעילים מחדש את רכיבי ממשק המשתמש בכל הצמתים שבהם הוא פועל: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. כדי לבדוק את העדכון, מריצים את כלי השירות apigee-validate בשרת הניהול, כמו שמתואר במאמר בדיקת ההתקנה.

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

סדר העדכון של המכונה – שדרוג מגרסה 4.51.00 (או) 4.52.00 (או) 4.52.01

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

  • חובה לעדכן את כל הצמתים של ZooKeeper במרכזי הנתונים לפני שמשדרגים את כל הרכיבים האחרים. אם אתם משדרגים מ-Edge Private Cloud 4.51.00 (או) 4.52.00, תצטרכו גם לבצע שלבים נוספים כדי לשדרג את zookeeper.
  • צריך לעדכן את Postgresql בכל מרכזי הנתונים. אם אתם משדרגים מ-Edge Private Cloud 4.51.00, תצטרכו גם לבצע שלבים נוספים כדי לשדרג את postgres.
  • צריך לעדכן את צמתי LDAP בכל מרכזי הנתונים.
  • צריך לעדכן את כל הצמתים של Cassandra, ‏ Management Server, ‏ Message Processor ו-Router, מרכז נתונים אחד בכל פעם, עד שכל מרכזי הנתונים ישודרגו.
  • חובה לעדכן את הרכיבים edge-qpid-server ו-edge-postgres-server בכל מרכזי הנתונים.
  • צריך לשדרג את צמתי Qpid בכל מרכזי הנתונים. אם אתם משדרגים מ-Edge Private Cloud 4.51.00 (או) 4.52.00, תצטרכו גם לבצע שלבים נוספים כדי לשדרג את Qpid.
  • עדכון ממשק המשתמש של Edge וממשק המשתמש החדש של Edge, צמתי SSO בכל מרכזי הנתונים.
  • אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את האפשרות -c edge.

שדרוג שנרכש בנפרד עם צומת אחד

כדי לשדרג הגדרה עצמאית עם צומת אחד לגרסה 4.52.02:
  1. עדכון כל הרכיבים: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (אם התקנתם את apigee-adminapi) כלי השירות apigee-adminapi עודכן: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

שדרוג שנרכש בנפרד של 2 צמתים

מעדכנים את הרכיבים הבאים בהתקנה עצמאית של 2 צמתים:

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

  1. מעדכנים את Zookeeper במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. מעדכנים את Postgres במכונה 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. מעדכנים את Cassandra במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  5. מעדכנים את רכיבי Edge במכונה 1 ובמכונה 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. מעדכנים את Qpid במכונה 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. מעדכנים את ממשק המשתמש במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. (אם התקנתם את apigee-adminapi) עדכנתם את כלי השירות apigee-adminapi במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    כאשר sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם את ה-SSO.

  10. מפעילים מחדש את רכיב Edge UI במכונה 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

שדרוג של 5 צמתים

כדי לעדכן את הרכיבים הבאים בהתקנה של 5 צמתים:

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

  1. מעדכנים את ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. עדכון של Postgres במכונה 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. עדכון של Postgres במכונה 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. מעדכנים את LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. מעדכנים את Cassandra במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. מעדכנים את רכיבי Edge במכונות 1, 2, 3, 4 ו-5: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. מעדכנים את Qpid במחשב 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. מעדכנים את Qpid במחשב 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  9. מעדכנים את ממשק המשתמש של Edge:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, אתם צריכים לעדכן את הרכיב ui במכונה 1, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • ממשק משתמש חדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך לעדכן את רכיב ue במכונה המתאימה (יכול להיות שלא מדובר במכונה 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  10. (אם התקנתם את apigee-adminapi) עדכנתם את כלי השירות apigee-adminapi במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  11. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ‫sso_config_file הוא קובץ ההגדרות שיצרתם כשהתקנתם את ה-SSO.

  12. מפעילים מחדש את רכיב ממשק המשתמש:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, עליכם להפעיל מחדש את הרכיב edge-ui במכונה 1, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק משתמש חדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את רכיב edge-management-ui במחשב המתאים (יכול להיות שלא מדובר במחשב 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג אשכול עם 9 צמתים

צריך לעדכן את הרכיבים הבאים בהתקנה של אשכול עם 9 צמתים:

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

  1. מעדכנים את ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. מעדכנים את Postgres במחשב 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את Postgres במכונה 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. מעדכנים את LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. מעדכנים את Cassandra במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. מעדכנים את רכיבי Edge במכונות 1, 4, 5, 6, 7, 8 ו-9 בסדר הזה: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. מעדכנים את Qpid במכונות 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. מעדכנים את ממשק המשתמש החדש (ue) או את ממשק המשתמש הקלאסי (ui) במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (אם התקנתם את apigee-adminapi) מעדכנים את כלי השירות apigee-adminapi במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ‫sso_config_file הוא קובץ ההגדרות שיצרתם כשהתקנתם את ה-SSO.

  11. מפעילים מחדש את רכיב ממשק המשתמש:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, עליכם להפעיל מחדש את הרכיב edge-ui במכונה 1, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק משתמש חדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את רכיב edge-management-ui במחשב המתאים (יכול להיות שלא מדובר במחשב 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג אשכול עם 13 צמתים

מעדכנים את הרכיבים הבאים בהתקנה של אשכול עם 13 צמתים:

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

  1. מעדכנים את ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. מעדכנים את Postgres במחשב 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את Postgres במכונה 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. מעדכנים את LDAP במכונות 4 ו-5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. מעדכנים את Cassandra במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. מעדכנים את רכיבי Edge במכונות 6,‏ 7,‏ 10,‏ 11,‏ 12,‏ 13,‏ 8 ו-9 בסדר הזה: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון Qpid במכונות 12 ו-13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. מעדכנים את ממשק המשתמש החדש (ue) או את ממשק המשתמש הקלאסי (ui) במכונות 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  9. (אם התקנתם את apigee-adminapi) עודכן כלי השירות apigee-adminapi במכונות 6 ו-7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במכונות 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ‫sso_config_file הוא קובץ ההגדרות שיצרתם כשהתקנתם את ה-SSO.

  11. מפעילים מחדש את רכיב ממשק המשתמש:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, תצטרכו להפעיל מחדש את הרכיב edge-ui במכונות 6 ו-7, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק משתמש חדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את רכיב edge-management-ui במכונות 6 ו-7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג אשכול עם 12 צמתים

כדי לעדכן את הרכיבים הבאים בהתקנה של אשכול עם 12 צמתים:

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

  1. מעדכנים את ZooKeeper במכונות 1, 2, 3, 7, 8 ו-9 בשני מרכזי הנתונים:

    /opt/apigee/apigee-setup/bin/update.sh -c zk -f configFile
  2. מעדכנים את Postgres במכונות 6 ו-12 בשני מרכזי הנתונים: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את LDAP במכונות 1 ו-7 בשני בקרי הדומיין: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

  4. חוסמים את התנועה ב-DC-1 ומוודאים שכל התנועה מנותבת מחדש ל-DC-2

  5. עדכון של Cassandra במכונות 1, 2 ו-3 ב-DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  6. עדכון שרת הניהול במחשב 1 ב-DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון הנתב ומעבד ההודעות במכונה 2,3 ב-DC-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. מבטלים את החסימה של התעבורה ב-DC-1, מאמתים את DC-1 וממשיכים עם DC-2 על ידי חסימת התעבורה ב-DC-2 והפניית התעבורה ל-DC-1
  9. עדכון של Cassandra במכונות 7, 8 ו-9 ב-DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  10. עדכון שרת ניהול העדכונים במחשב 7 ב-DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. עדכון של Router ו-Message Processor במכונה 8,9 ב-DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. מבטלים את חסימת התנועה ב-DC-2 ועכשיו שני ה-DC יטפלו בתנועה
  13. מריצים מחדש את פקודת העדכון בכל שרת הניהול בכל מרכזי הנתונים במכונות 1 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  14. מעדכנים את edge-qpid-server ואת edge-postgres-server במכונות 4, 5, 6, 10, 11 ו-12 בשני מרכזי הנתונים: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. מעדכנים את Qpid במכונות 4, 5, 10 ו-11 בשני מרכזי הנתונים: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  16. מעדכנים את ממשק המשתמש החדש (ue) או את ממשק המשתמש הקלאסי (ui) בשני מרכזי הנתונים: 
    /opt/apigee/apigee-setup/bin/update.sh -c  [ui|ue] -f configFile
  17. (אם התקנתם את apigee-adminapi) מעדכנים את apigee-adminapi בשני מרכזי הנתונים: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  18. (אם התקנתם את Apigee SSO) מעדכנים את צמתי Apigee SSO בשני מרכזי הנתונים: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  19. מפעילים מחדש את הרכיב של ממשק המשתמש החדש של Edge‏ (edge-management-ui) או את הרכיב של ממשק המשתמש הקלאסי של Edge‏ (edge-ui) בשני מרכזי הנתונים: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart