עדכון של 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, הערכים האלה נשמרים על ידי העדכון.

שדרוג נדרש ל-Zookeeper 3.8.3

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

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

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

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

יצירת גיבוי

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

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

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

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

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

  1. אם האפליקציה לא מותקנת בצומת ZoomKeeper, מתקינים את nc:
      sudo yum install nc
  2. מריצים את פקודת ה-nc הבאה בצומת, כאשר 2181 היא יציאת זוKeeper:
      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 בכל צומת של ZoomKeeper.

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

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

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

כיבוי מנהיג

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

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

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

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

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

שדרוג בכיר בארגון

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

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

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

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

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

שחזור הגיבוי

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

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

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

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

שדרוג ה-Qpid

הגרסה הזו של Edge for Private Cloud כוללת שדרוג ל-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.

  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 נכשל.

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

עדכון ללא השבתה או עדכון בהדרגה (rolling), מאפשרים לכם לעדכן את התקנת 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 שהוגדרו לביצוע פעולת תיקון, אם יש כאלה קרן עד אחרי שהעדכון יסתיים.
  2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root).
  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. מתקינים את הכלי ואת יחסי התלות של Edge 4.52.01 apigee-service על ידי הרצת הפקודה הבאה:
      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: Apigee SSO (אם התקנתם SSO)
        • ue: ממשק המשתמש החדש של Edge
        • ui: ממשק המשתמש הקלאסי של Edge
        • zk: שומר בגן החיות
      • configFile הוא אותו קובץ תצורה שבו השתמשתם כדי הגדרת Edge שונים במהלך ההתקנה בגרסה 4.50.00 או 4.51.00.

      אפשר להריץ את update.sh על כל הרכיבים על ידי הגדרה של component אלא רק אם יש לך פרופיל התקנה 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. התקנת כלי השירות 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 webserver&quot; בדף Install the Edge הכלי apigee-setup.
    2. בצומת המרוחק, מורידים את קובץ Edge bootstrap_4.52.01.sh אל /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: Apigee SSO (אם התקנתם SSO)
      • ue ממשק המשתמש החדש של Edge
      • ui: ממשק המשתמש הקלאסי של Edge
      • zk: שומר בגן החיות
    • configFile הוא אותו קובץ תצורה שבו השתמשתם כדי הגדרת רכיבי Edge במהלך ההתקנה בגרסה 4.50.00 או 4.51.00.

    אפשר להריץ את update.sh על כל הרכיבים על ידי הגדרה של component אלא רק אם יש לך פרופיל התקנה 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 ו-zoKeeper לפני עדכון של רכיבים צמתים אחרים.
  • לכל מכונה עם מספר רכיבי 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

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

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

במאמר טופולוגיות של התקנה אפשר למצוא רשימה של הטופולוגיות של 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 ב-Machine 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. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במכונה 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 ו-ZooKeeper במכונה 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. (אם התקנתם את 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

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

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

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

  1. עדכון Cassandra ו-ZooKeeper במכונה 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. (אם התקנתם את 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
    • ממשק המשתמש החדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, ואז הפעילו מחדש את רכיב edge-management-ui במחשב המתאים (ייתכן שלא יהיה מחשב 1):
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

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

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

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

  1. מעדכנים את Cassandra ו-ZooKeeper במכונות 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. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במכונות 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 במרכז נתונים 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 במרכז נתונים 1
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. מכונה 7 במרכז נתונים 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 במרכז נתונים 1:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. מכונה 7 במרכז נתונים 2:
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (אם התקנת את apigee-adminapi) עדכנת את כלי השירות apigee-adminapi:
    1. מכונה 1 במרכז נתונים 1:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. מכונה 7 במרכז נתונים 2:
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO:
    1. מכונה 1 במרכז נתונים 1:
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. מכונה 7 במרכז נתונים 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. קצה, שפירושו "קצה-c" פרופיל בכל הצמתים בסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתב.
  6. qpidd
  7. ממשק המשתמש של Edge (קלאסי או חדש)
  8. apigee-adminapi
  9. SSO ב-Apigee

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