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

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

  • אם אתם משדרגים מגרסאות 4.51.00 או 4.52.00 של Edge for Private Cloud, עיינו בשלבים שבקטע שדרוג נדרש ל-Zookeeper 3.8.3 כדי לשדרג את Zookeeper.
  • אם אתם משדרגים מגרסה 4.52.01 של Edge for Private Cloud, אתם כבר אמורים להשתמש בגרסה 3.8.3 של Zookeeper, ואין צורך לבצע שלבים מיוחדים כדי לשדרג את 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

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

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

בנוסף, תהליך השדרוג גורם לשיבוש קבוצה גדולה יותר של תהליכי שרת proxy בזמן ריצה וממשקי Management 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. ההגדרה הזו כוללת, בין היתר, פריסות, שינויים באפליקציות, מוצרים, שרתי יעד, מאגרי מפתחות וכו'. כל ממשקי ה-Management API (והלקוחות שלהם, כמו ממשק המשתמש של Apigee ופורטל המפתחים) נכללים בהיקף הזה.

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

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

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

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

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

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

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

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

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

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

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

חזרה לגרסה קודמת – רמה גבוהה

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

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

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

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

  • החזרה למצב קודם של אשכול ששודרג באופן חלקי

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

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

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

  • מה צריך להביא בחשבון לפני השדרוג

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

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

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

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

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

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

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

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

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

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

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

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

  1. משנים את Cassandra כך שתשתמש ב-LeveledCompactionStrategy.
  2. גיבוי Cassandra באמצעות Apigee.
  3. יוצרים תמונות מצב של צומתי Cassandra ב-VM (אם אפשר).
  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. הפניית כל התנועה בזמן הריצה וממשקי ה-Management API לניהול למרכזי הנתונים האחרים שפועלים.
  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: משדרגים את כל צומתי זמן הריצה במרכז הנתונים הראשון

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

/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 – [אופציונלי] ייבוא של SmartDocs שיוצאו בעבר

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

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

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

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

אחרי ההתקנה הראשונית, מומלץ להתקין את ממשק המשתמש של Edge, שהוא ממשק משתמש משופר למפתחים ולאדמינים של Apigee Edge for Private Cloud.

שימו לב שבממשק המשתמש של 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 ייכשל.

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

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

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

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

  1. מעדכנים את המכונות בסדר הנכון להתקנה, כמו שמתואר בקטע סדר עדכון המכונות.
  2. כשיגיע הזמן לעדכן את הנתבים, בוחרים נתב אחד ומשביתים את הגישה אליו, כמו שמתואר במאמר הפעלה או השבתה של הגישה לשרת (מעבד בקשות או נתב).
  3. מעדכנים את ה-Router שנבחר ואת כל רכיבי Edge האחרים באותו מחשב שבו נמצא ה-Router. בכל ההגדרות של Edge, הנתב ומעבד הבקשות מוצגים באותו צומת.
  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. מורידים את הקובץ bootstrap_4.52.02.sh של Edge אל /tmp/bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. מתקינים את כלי השירות apigee-service של Edge 4.52.02 ואת יחסי התלות שלו באמצעות הפקודה הבאה: 
      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: ‏Management Server, ‏Message Processor, ‏Router, ‏Qpid Server, ‏Postgres Server
        • ldap: OpenLDAP
        • ps: postgresql
        • ‫qpid: qpidd
        • ‫sso: מודול SSO ב-Apigee (אם התקנתם את 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 בכל הצמתים שבהם הם פועלים: 
      /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" במאמר התקנת כלי השירות 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

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

  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. בצומת המרוחק, מתקינים את כלי השירות apigee-setup של Edge ואת יחסי התלות: 
      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: מודול SSO ב-Apigee (אם התקנתם את 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, ‏ מעבד בקשות ו-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. (אם התקנתם את מודול SSO ב-Apigee) מעדכנים את מודול SSO ב-Apigee במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. מפעילים מחדש את רכיב ממשק המשתמש של Edge במכונה 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. (אם התקנתם את מודול SSO ב-Apigee) מעדכנים את מודול SSO ב-Apigee במכונה 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. (אם התקנתם את מודול SSO ב-Apigee) מעדכנים את מודול SSO ב-Apigee במכונה 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. (אם התקנתם את מודול ה-SSO ב-Apigee) מעדכנים את מודול ה-SSO ב-Apigee במכונות 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. מעדכנים את הנתב ואת מעבד הבקשות במכונות 8 ו-9 ב-DC-2: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. מבטלים את החסימה של התנועה ב-DC-2, ועכשיו שני מרכזי הנתונים יטפלו בתנועה
  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. (אם התקנתם את מודול SSO ב-Apigee) מעדכנים את צומתי מודול SSO ב-Apigee בשני מרכזי הנתונים: 
    /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