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

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

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

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

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

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

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

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

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

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

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

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

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

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

גרסה נוכחית תוכנה שדורשת שלבים מיוחדים לשדרוג ל-4.52.02
4.52.01 קסנדרה
4.52.00 קסנדרה, גן החיות, Qpid
4.51.00 קסנדרה, גן החיות, Qpid, Postgres

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

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

נדרש שדרוג ל-Cassandra 3.11.16

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

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

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

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

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

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

ממשקי API לניהול מסמכים בפורטל המפתחים

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

# Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
# Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
CASS_TMP_DIR=/tmp/cass_upgrade_scripts
    אם לא ניתן ליצור את הקובץ ב-/opt/apigee/apigee-cassandra/cass_upgrade.conf, צריך ליצור את הקובץ /opt/silent.conf עם אותו תוכן בכל צומת של Cassandra.
  • אם אתם משתמשים בתכונה 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: שדרוג כל הצמתים של סביבת זמן הריצה

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

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

שלב 5: משדרגים את כל שאר רכיבי Edge ל-Private Cloud 4.52.02

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

בשלב הזה, אם אתם משדרגים מגרסאות שקודמות ל-Edge ל-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

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

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

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

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

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

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

  • אם אתם משדרגים מ-Edge ל-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 ייכשל.

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

עדכון ללא השבתה או עדכון בהדרגה (rolling) יאפשרו לכם לעדכן את ההתקנה של 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. כדי להתקין את ההכנסות לאלף חשיפות ב-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.02.sh אל /tmp/bootstrap_4.52.02.sh: 
      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
    2. מריצים את הפקודה הבאה כדי להתקין את כלי השירות 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: קסנדרה
        • 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' כ'הכול', אבל רק אם יש לכם פרופיל התקנה הכול כלול (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.02.

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

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

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

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

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

  1. יוצרים מאגר מקומי 4.52.02 כפי שמתואר ב "יצירת מאגר Apigee מקומי" ב-התקנת כלי העזר של Edge apigee-setup.
  2. כדי להתקין את שירות apigee מקובץ .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 ואת יחסי התלות מ-/tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

  3. כדי להתקין את שירות apigee באמצעות שרת האינטרנט Nginx:
    1. מגדירים את שרת האינטרנט Nginx כפי שמתואר במאמר 'התקנה מהמאגר באמצעות שרת האינטרנט Nginx' במאמר התקנת כלי ההגדרה של Edge apigee-setup.
    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: קסנדרה
      • 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' כ'הכול', אבל רק אם יש לכם פרופיל התקנה הכול כלול (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.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 ב-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 ב-Data Center 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. מכונה 12 ב-Data Center 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. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO:
    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 dge' בכל הצמתים בסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתב.
  6. Qpidd
  7. ממשק המשתמש של Edge (קלאסי או חדש)
  8. apigee-adminapi
  9. SSO ב-Apigee

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