עדכון של 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 Compaction Strategy היא LeveledCompactionStrategy
    בהתאם לגרסה הנוכחית, מבצעים את השינויים הנדרשים בשיטת הדחיסה של Cassandra. פועלים לפי השלבים הבאים ולאחר מכן חוזרים לתהליך השדרוג הראשי:

אילו שלבים מיוחדים כדאי להביא בחשבון במהלך השדרוג

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

גרסה נוכחית תוכנות שצריך לבצע שלבים מיוחדים כדי לשדרג אותן לגרסה 4.52.02 חומרי עזר
4.52.01 Cassandra שינוי האסטרטגיה של דחיסת נתונים ב-Cassandra
4.52.00 Cassandra, ‏ Zookeeper, ‏ Qpid שינוי האסטרטגיה של דחיסת נתונים ב-Cassandra
4.51.00 Cassandra, ‏ Zookeeper, ‏ Qpid, ‏ Postgres שינוי האסטרטגיה של דחיסת נתונים ב-Cassandra

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

העברה אוטומטית של הגדרות הנכס

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

נדרש שדרוג לגרסה 3.11.16 של Cassandra

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

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

ביטול שינויים ברמה גבוהה

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

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

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

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

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

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

מונחים שמופיעים בקטעים הבאים

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

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

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

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

  1. Cassandra ב-Apigee פועלת בגרסה 2.1.22.
  2. הרכיבים של Edge for Private Cloud 4.52.02:
    • שרת ניהול שמתקשר עם Cassandra באמצעות פרוטוקול thrift ישן יותר.
    • שרתי זמן ריצה (מעבדי הודעות ונתבים) שמתקשרים עם Cassandra דרך פרוטוקול thrift ישן יותר.
המצב של סביבת זמן הריצה בשלב הזה מצב הניהול בשלב הזה
זמן ריצה פונקציונלי במלואו הניהול פועל במלואו

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

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

  1. שינוי Cassandra כך שתשתמש ב-LeveledCompactionStrategy.
  2. גיבוי של Cassandra באמצעות Apigee.
  3. יוצרים קובצי snapshot של צמתים של 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.
  • אם אתם משתמשים בתכונה SmartDocs של פורטל הפיתוח של Apigee Drupal 7, יוצאים כל אחד מהמודלים על ידי הורדה שלהם בפורמט JSON מממשק המשתמש של פורטל הפיתוח. אחרי העדכון של שרתי הניהול, צריך לייבא את המודלים האלה בחזרה ל-Apigee.
  • אם הם עדיין לא קיימים, צריך לוודא שאפשר לגשת ליציאות 9160 ו-9042 מכל הרכיבים של Edge for Private Cloud 4.52.02 לצמתים של Cassandra. מידע נוסף זמין במאמר דרישות לשקע.

שלב 2: משדרגים את כל צמתים של 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
  3. הפלט של הפקודה הזו יהיה משהו כזה:
    Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
המצב של סביבת זמן הריצה בשלב הזה מצב הניהול בשלב הזה
זמן ריצה פונקציונלי במלואו פונקציית הניהול הבאה מושבתת אחרי השדרוג של Cassandra:

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

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
מצב זמן ריצה מצב ניהול
זמן ריצה פונקציונלי במלואו פגיעה ב-Management API:

שלב 3א: [אופציונלי] מייבאים מסמכי SmartDocs שיוצאו בעבר

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

מצב זמן ריצה מצב ניהול
זמן ריצה פונקציונלי במלואו הניהול פועל במלואו

שלב 4: שדרוג כל צמתים של Runtime

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
מצב זמן ריצה מצב ניהול
זמן ריצה פונקציונלי במלואו הניהול פועל במלואו

שלב 5: שדרוג של כל שאר הרכיבים של Edge for Private Cloud 4.52.02

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

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

מצב זמן ריצה מצב ניהול
זמן ריצה פונקציונלי במלואו הניהול פועל במלואו

שלב 6: שלבים לאחר השדרוג

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

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

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

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

אם עדיין לא עשיתם זאת, משלימים את שלב 3א.

מצב זמן ריצה מצב ניהול
זמן ריצה פונקציונלי במלואו הניהול פועל במלואו

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

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

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

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

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

שדרוג נדרש ל-Qpid J-Broker

למרות שגרסה 4.52.02 של Edge for Private Cloud לא כוללת שדרוג ל-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 לענן פרטי.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בטופולוגיות התקנה מופיעה רשימה של טופולוגיות 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. (אם התקנתם את 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. Cassandra
  3. ps
  4. LDAP
  5. קצה (edge), כלומר הפרופיל '-c edge' בכל הצמתים לפי הסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתבים.
  6. qpidd
  7. ממשק המשתמש של Edge (הקלאסי או החדש)
  8. apigee-adminapi
  9. Apigee SSO

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