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

ב-Apigee יש תמיכה בשדרוג של Edge לענן פרטי מגרסה 4.51.00 או מגרסה 4.52.00 ישירות לגרסה 4.52.01. בדף הזה נסביר איך לבצע כל אחד מהשדרוגים.

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

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

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

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

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

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

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

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

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

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

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

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

נדרש שדרוג ל-zokeeper בגרסה 3.8.3

הגרסה הזו של Edge for Private Cloudes כוללת שדרוג ל-Zokeeper בגרסה 3.8.3. כחלק מהשדרוג הזה, כל הנתונים שלzokeeper יועברו ל-Zookeeper בגרסה 3.8.3.

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

במהלך העדכון, ייתכן עיכוב קל או תקלה בכתיבה ב-Zookeeper כשצומת המנהיג נסגר. הדבר עלול להשפיע על פעולות ניהול שנכתבות ב-Zokeeper, כמו פעולת פריסה של שרת proxy ושינויים בתשתית של Apigee, כגון הוספה או הסרה של מעבד הודעות וכו'. לא אמורה להיות השפעה על ממשקי API של זמן הריצה של Apigee (אלא אם ממשקי ה-API לניהול הקריאות של ממשקי ה-API האלה בזמן ריצה) במהלך השדרוג שלzokeeper על פי התהליך שבהמשך.

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

יצירת גיבוי

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

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

זהו מנהיגים, עוקבים ומצופים

הערה: הפקודות לדוגמה שבהמשך משתמשות בכלי השירות nc כדי לשלוח נתונים אלzokeeper. תוכלו להשתמש בכלים חלופיים כדי לשלוח נתונים גם ל-zokeeper.

  1. אם היא לא מותקנת בצומתzoKeeper, מתקינים את nc: 
      sudo yum install nc
  2. מריצים את פקודת ה-nc הבאה בצומת, כאשר 2181 היא היציאה שלzoKeeper: 
      echo stat | nc localhost 2181

    הפלט אמור להיראות כך:

      Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
  Clients:
   /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
  
  Latency min/avg/max: 0/0.2518/41
  Received: 647228
  Sent: 647339
  Connections: 4
  Outstanding: 0
  Zxid: 0x400018b15
  Mode: follower
  Node count: 100597

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

  3. חוזרים על שלבים 1 ו-2 בכל צומת שלzoKeeper.

שדרוג שלzokeeper בצמתים של הצופה והעוקב

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

  1. מורידים ומפעילים את רצועת האתחול של Edge עבור Private Cloud 4.52, כמו שמתואר במאמר עדכון לגרסה 4.52.01 בצומת עם חיבור חיצוני לאינטרנט. סביר להניח שהתהליך ישתנה בהתאם לחיבור האינטרנט החיצוני או לאינטרנט שאתם מבצעים התקנה במצב לא מקוון.
  2. שדרוג הרכיב שלzokeeper : 
      /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
    הערה: אם בצמתים האלה מותקנים רכיבים אחרים (כמו Cassandra), אפשר לשדרג גם אותם עכשיו (למשל באמצעות פרופיל cs,zk) או לשדרג את הרכיבים האחרים מאוחר יותר. ההמלצה של Apigee היא לשדרג רק אתzokeeper לפני שדרוג הרכיבים האחרים, ולוודא שהאשכול פועל כראוי.
  3. חוזרים על השלבים שלמעלה בכל אחד מהצמתים של המשתתפים והעוקבים ב-zokeeper.

סוגרים את המנהיג

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

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

הערה: במהלך האירוע הזה, לפני בחירת מנהיג חדש, עשויים לחול עיכובים זמניים או כישלונות בכתיבה ב-zokeeper. הדבר עלול להשפיע על פעולות שכותבות ב-Zookeeper, כמו פעולת הפריסה של שרתי proxy או שינויים בתשתית של Apigee, כמו הוספה או הסרה של מעבדי הודעות וכו'.

אימות שהמנהיג החדש נבחר

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

שדרוג המנהיג

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

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

חזרה למצב קודם

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

  1. קודם צריך לבצע את שלבי החזרה למצב הקודם לגבי צופים ועוקבים.
  2. מורידים ומפעילים אתחול של הגרסה שאליה אתם חוזרים – 4.50 או 4.51. סביר להניח שהתהליך ישתנה בהתאם לצומת – חיבור חיצוני לאינטרנט או אם אתם עוקבים אחרי התקנה במצב אופליין.
  3. הפסקת הפעילות של Nestkeeper אם הוא פועל בצומת: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
  4. כדי להסיר את המערכת הקיימת של גן חיות: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
  5. מתקינים אתzokeeper כרגיל: 
      /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
  6. אחרי החזרה לאחור של כל העוקבים והצופים, צריך לבצע את השלבים 2 עד 5 בצומת המנהיג למצב הקודם.
  7. אחרי שכל הצמתים הוחזרו למצב הקודם, צריך לבדוק את תקינות האשכול ולוודא שיש צומת מוביל באשכול.

שחזור הגיבוי

ראו שחזור מהגיבוי. שימו לב שגיבויים של יוכלו לשמור מ-Edge for Private Cloud בגרסאות קודמות, כמו 4.50 ו-4.51, צריכים להיות תואמים לגרסה של Zouter ב-Edge for Private Cloud 4.52.

Qpid של שדרוג

גרסת Edge הזו לענן הפרטי כוללת שדרוג ל-Qpid J-Broker. מומלץ לבחור באחת מהשיטות הבאות לשדרוג Qpid:

שדרוג מקומי ללא זמן השבתה

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

כדי לבצע שדרוג במקום, אין צורך בשדרוג ל-Qpid בזמן השבתה:

  1. יש לבחור צומת Qpid אחד שאיתו רוצים להתחיל.
  2. הפסקת המתווך Qpid בצומת: 
    apigee-service apigee-qpidd stop
  3. חסימה של תעבורת נתונים נכנסת ביציאת המתווך 5672 מכל מעבדי ההודעות על ידי החלה של חומת אש. אפשר להחיל את חומת האש הזו ברמת המופע של צומת ה-Qpid או ברמת רכיב חיצוני של חומת אש או רשת.

    מומלץ לבצע את אותו השלב בכל כתובות ה-IP של מעבד ההודעות. לדוגמה, לבקשות DROP שמגיעות מכתובות IP של מעבד הודעות אל צומת Qpid ביציאה 5672 באמצעות IPTables, אפשר להשתמש בפקודה כמו זו:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  4. מפעילים שוב את המתווך Qpid כדי לרוקן הודעות קיימות, אם יש: 
    apigee-service apigee-qpidd start
  5. בודקים שהתורים הקיימים ריקים: 
    qpid-stat -q

    אם ההודעות נתקעות בתור המכתבים המתים (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), אפשר לרוקן את התור בעזרת השלבים לפתרון ניתוח נתונים התכופים בתור המתים.

  6. אחרי שמוודאים שהתורים התרוקנו בצומת הישן, מפסיקים את apigee-qpidd: 
    apigee-service apigee-qpidd stop
  7. שדרוג Qpid בצומת: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. הפעלה מחדש של edge-qpid-server: 
    apigee-service edge-qpid-server restart

  9. מסירים את הכלל של חומת האש שהוחל בשלב 3.

    מבצעים את אותו שלב הסרה לכל כתובות ה-IP של מעבד ההודעות שעליהן הוחלה חומת האש. אחרי הסרת חומות האש, יתקבלו בקשות שמגיעות מכתובות IP של מעבד הודעות לצומת Qpid ביציאה 5672. אם השתמשתם ב-iptables כדי להוסיף את חומת האש, להסיר את חומת האש ולהציג את ההגדרות הקיימות, תוכלו להשתמש בפקודות כמו:

    iptables -F
  iptables -L
  10. משתמשים במעקב באינטרנט כדי לוודא שהתורים של Qpid מקבלים הודעות: 
    http://QPID_NODE_IP:8090
  11. חוזרים על שלבים 1 עד 9 לכל צומת Qpid.

הקצאת צומת Qpid חדש

השיטה הזו מגדירה ומתקינה את apigee-qpidd ואת edge-qpid-server בצומת חדש.

  1. הוספת צומת Qpid חדש. בשלב הזה מוגדר צומת Qpid עם J-broker. להוראות מפורטות, ראו הוספת שרת Qpid.
  2. בחר צומת Qpid קיים (צומת מהגרסה שממנה אתה משדרג).
  3. עוצרים את המתווך Qpid בצומת: 
    apigee-service apigee-qpidd stop
  4. חסימה של תעבורת נתונים נכנסת ביציאת המתווך 5672 מכל מעבדי ההודעות על ידי החלה של חומת אש. אפשר להחיל את חומת האש הזו ברמת המופע של צומת ה-Qpid או ברמת רכיב חיצוני של חומת אש או רשת.

    מומלץ לבצע את אותו השלב בכל כתובות ה-IP של מעבד ההודעות. לדוגמה, לבקשות DROP שמגיעות מכתובות IP של מעבד הודעות אל צומת Qpid ביציאה 5672 באמצעות IPTables, אפשר להשתמש בפקודה כמו זו:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  5. מפעילים שוב את המתווך Qpid כדי לרוקן הודעות קיימות, אם יש: 
    apigee-service apigee-qpidd start
  6. מוודאים שהתורים הקיימים ריקים: 
    qpid-stat -q

    אם הודעות נתקעות בתור המכתבים המתים (DLQ) (ax-q-axgroup-001-consumer-group-001-dl), מתרוקנים הבאים בתור לפי ההוראות בנושא נתוני Analytics תקועים בתור Qpidd Dead letter.

  7. אחרי שמוודאים שהתורים התרוקנו בצומת הישן, מפסיקים את apigee-qpidd 
    apigee-service apigee-qpidd stop
  8. מבטלים את הרישום של צומת ה-Qpid הישן לפי השלבים במאמר הסרת שרת Qpid.
  9. עליך להמשיך להוסיף צומת חדש ולהסיר צומת ישן, אחד בכל פעם, עד שכל הצמתים ב-Qpid ישודרגו.

חזרה למצב קודם

כדי לחזור לגרסה קודמת של פיצ'ר, צריך להקפיד להוריד את הקובץ bootstrap.sh של הגרסה שאליה רוצים לחזור. כדי לחזור לגרסה 4.52.00, צריך להוריד את bootstrap_4.52.00.sh.

כדי להחזיר את Qpid למצב קודם, צריך לבצע את הפעולות הבאות בכל המארחים ל-Qpid:

  1. הפסקת המתווך הקיים Qpid 
    apigee-service apigee-qpidd stop
  2. חסימה של תעבורת נתונים נכנסת ביציאת המתווך 5672 מכל מעבדי ההודעות על ידי החלה של חומת אש. אפשר להחיל את חומת האש הזו ברמת המופע של צומת ה-Qpid או ברמת רכיב חיצוני של חומת אש או רשת.

    מומלץ לבצע את אותו השלב בכל כתובות ה-IP של מעבד ההודעות. לדוגמה, לבקשות DROP שמגיעות מכתובות IP של מעבד הודעות אל צומת Qpid ביציאה 5672 באמצעות IPTables, אפשר להשתמש בפקודה כמו זו:

    iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP
  3. מפעילים שוב את מתווך ה-qpid כדי לרוקן הודעות קיימות אם יש: 
    apigee-service apigee-qpidd start
  4. מוודאים שהתורים הקיימים ריקים. כדי לבדוק, צריך להתחבר לפורטל הניהול Qpid: 
    http://QPID_NODE_IP:8090
    הערה: אם היציאה 8090 בצומת QPID לא נגישה, אפשר להשתמש במנגנונים חלופיים כמו העברה ליציאת SSH כדי לגשת לכתובת ה-URL הזו.
  5. אחרי שמוודאים שהתורים התרוקנו, עוצרים את Qpid ומסירים אותו: 
    apigee-service apigee-apidd uninstall
  6. מוחקים את ספריית הנתונים Qpid: 
    rm -r APIGEE_ROOT/data/apigee-qpidd
  7. מתקינים מחדש את מתווך ה-Qpid: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  8. לאחר ההתקנה מחדש של מתווך Qpid, מסירים את הגדרות חומת האש ורושמים את ההגדרות הקיימות באמצעות הפקודות הבאות: 
    iptables -F
    iptables -L

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  1. אם יש משימות ב-cron שהוגדרו לביצוע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
  2. עליך להתחבר לצומת שלך בתור הבסיס כדי להתקין את ה-Edge RPM.
  3. מתקינים את yum-utils ואת yum-plugin-priorities: 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. השבת את SELinux כפי שמתואר בהתקנת כלי השירות של Edge apigee-setup.
  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.01.sh אל /tmp/bootstrap_4.52.01.sh: 
      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh
    2. מתקינים את כלי העזר ואת יחסי התלות apigee-service של Edge 4.52.01 על ידי הרצת הפקודה הבאה: 
      sudo bash /tmp/bootstrap_4.52.01.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: קסנדרה
        • edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: SSO ב-Apigee (אם התקנת SSO)
        • ue: ממשק המשתמש החדש של Edge
        • ui: ממשק המשתמש הקלאסי של Edge
        • zk: שומרי גן חיות
      • configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של 4.50.00 או 4.51.00.

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

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

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

עדכון ל-4.52.01 ממאגר מקומי

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

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

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

כדי לעדכן ממאגר מקומי של 4.52.01:

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

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

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

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

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

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

    3. בצומת המרוחק, מתקינים את כלי העזר apigee-setup ואת יחסי התלות של Edge: 
      sudo bash /tmp/bootstrap_4.52.01.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: קסנדרה
      • edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: SSO ב-Apigee (אם התקנת SSO)
      • ממשק משתמש חדש של Edge (ue)
      • ui: ממשק המשתמש הקלאסי של Edge
      • zk: שומרי גן חיות
    • configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של 4.50.00 או 4.51.00.

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

    /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.01.

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

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

  • לפני עדכון של צמתים אחרים, צריך לעדכן את כל הצמתים של Cassandra ו-ZooKeeper.
  • בכל מכונה עם מספר רכיבי Edge (שרת ניהול, מעבד הודעות, נתב, שרת QPID אבל לא שרת Postgres), משתמשים באפשרות -c edge כדי לעדכן את כולם בבת אחת.
  • אם שלב מציין שצריך לבצע אותו במספר מכונות, מבצעים אותו בסדר המכונה שצוין.
  • אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את האפשרות -c edge.

שדרוג נפרד לצומת אחד

כדי לשדרג תצורה עצמאית עם צומת אחד ל-4.52.01:

  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. מעדכנים את Cassandra ו-ZooKeeper במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,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. עדכון רכיבי Edge במחשב 2 ו-1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. עדכון Qpid במכשיר 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מעדכנים את ממשק המשתמש במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (אם התקנתם את apigee-adminapi) כלי העזר apigee-adminapi עודכן במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (אם התקנת SSO ב-Apigee) עדכון ה-SSO של Apigee במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

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

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

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

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

  1. מעדכנים את Cassandra ו-zoKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,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. עדכון רכיבי Edge במכונה 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. עדכון Qpid במכונה 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. עדכון Qpid במכונה 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. מעדכנים את ממשק המשתמש של 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
  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

שדרוג מקבץ של 9 צמתים

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

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

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

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

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

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

  9. מפעילים מחדש את ממשק המשתמש החדש של Edge (edge-management-ui) או את רכיב הממשק הקלאסי של Edge (edge-ui) במכונות 1 ו-7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

להגדרות לא סטנדרטיות

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

  1. ZooKeeper
  2. קסנדרה
  3. ps
  4. LDAP
  5. Edge, שפירושו פרופיל "-c edge" בכל הצמתים לפי הסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתב.
  6. Qpidd
  7. ממשק המשתמש של Edge (קלאסי או חדש)
  8. apigee-adminapi
  9. SSO ב-Apigee

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