דף זה תורגם על ידי Cloud Translation API.

עדכון של Apigee Edge 4.16.05.x לגרסה 4.16.05 העדכנית ביותר

Edge for Private Cloud גרסה 4.16.05

המסמך הזה מכיל את התהליך שבו אתה משתמש לעדכון ההתקנה הקיימת של 4.16.05 כדי להשתמש בהכנסות האחרונות לאלף חשיפות ובקובצי תמיכה מ-Apigee. בתהליך הזה נעשה שימוש בכלי update.sh כדי לבצע את העדכון.

אילו גרסאות של Edge אפשר לעדכן לגרסה 4.16.05 האחרונה

אפשר לעדכן רק התקנה קיימת של Apigee Edge מגרסה 4.16.05.x לגרסה האחרונה גרסה 4.16.05.

אם במכשיר שלך פועלת כרגע גרסה 4.16.01.0x או גרסאות קודמות, צריך קודם לעבור אל 4.16.05. ראו עדכון Apigee Edge 4.16.01 ל-4.16.05 לקבלת מידע על המעבר לגרסה 4.16.05.

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

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

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

דרישות של שטח הדיסק לעדכון

חשוב לוודא שיש לכם לפחות 1GByts של המקום הפנוי בדיסק לפני ביצוע

הפצה אוטומטית של נכסים הגדרות מ-4.16.05.x

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

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

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

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

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

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

טיפול בעדכון שנכשל

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

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

פרטי העדכון ביומן

כברירת מחדל, הקוד update.sh כלי השירות כותב פרטי יומן ל:

/opt/apigee/var/log/apigee-setup/update.log

אם למשתמש שמפעיל את הכלי update.sh אין גישה אל באותה הספרייה, נכתב את היומן בספרייה /tmp כקובץ בשם update_username.log.

אם למשתמש אין גישה אל /tmp, כלי העזר update.sh נכשל.

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

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

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

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

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

יצירת נתב לא ניתן לגשת למעבד ההודעות

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

הקריאה הבאה ל-API מגדירה צומת כנגיש או לא נגיש:

> curl -u adminEmail:pWord -X POST "http://<ms_IP>:8080/v1/servers/UUID" -d "reachable=true|false"

כאשר UUID הוא ה-UUID של מעבד ההודעות או הנתב, וכן מוגדר כ-true או false.

כדי לזהות את ה-UUID של הנתב, משתמשים בפקודת cURL הבאה:

> curl http://<routerIP>:8081/v1/servers/self

אם צריך לזהות את ה-UUID של מעבד ההודעות, אפשר להשתמש ב-cURL הבא הפקודה:

> curl http://<mpIP>:8082/v1/servers/self

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

בצומת משולב של נתב ומעבד הודעות:
- לפני העדכון – יש לבצע את הפעולות הבאות:
  1. מגדירים שהנתב לא יהיה נגיש באמצעות הקריאה ל-API שמופיעה למעלה.
  2. מגדירים שלא יהיה אפשר לגשת למעבד ההודעות.
- לאחר העדכון, מבצעים את הפעולות הבאות:
  1. מגדירים את מעבד ההודעות כך שניתן יהיה לגשת אליו.
  2. הגדרת הנתב כך שיהיה נגיש.
בצומת נתב יחיד:
- לפני העדכון, צריך להגדיר את הנתב כך שיהיה נגיש.
- אחרי העדכון, ניתן יהיה לגשת לנתב.
בצומת יחיד של מעבד הודעות:
- לפני העדכון, צריך להגדיר שלא תהיה גישה למעבד ההודעות.
- אחרי העדכון, אפשר להגדיר את מעבד ההודעות כך שניתן יהיה לגשת אליו.

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

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

תהליך העדכון 4.16.05 בצומת עם חיבור חיצוני לאינטרנט

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

צריך להשבית את כל משימות CRON שהוגדרו לביצוע פעולת תיקון ב-Cassandra, אם יש כאלה עד לסיום העדכון.
כדי להתקין את ה-RPM ב-Edge
, צריך להתחבר לצומת בתור הרמה הבסיסית (root) הערה: התקנת RPM מחייבת גישה לרמה הבסיסית (root), אבל אפשר להשתמש ב-Edge ללא גישה לרמה הבסיסית (root).
השבתת SELinux כפי שמתואר במאמר התקנת apigee-setup של Edge של Google.
ניקוי כל המטמון של Yum:
> sudo yum,
אפשר להוריד את הקובץ העדכני ביותר של Edge shoestrap_4.16.05.sh אל /tmp/shoestrap_4.16.05.sh:
> תלתל https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh
מעדכנים את כלי השירות ואת יחסי התלות של Edge apigee-service:
> sudo bash /tmp/shoestrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord

כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם ב-Apigee. אם משמיטים את המילה pWord, תתבקשו להזין אותה.
משתמשים ב-apigee-service כדי לעדכן את כלי ההגדרה של apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

העדכון הזה ל-apigee-service מתקין את הכלי update.sh ב-/<inst_dir>/apigee/apigee-setup/bin.
מריצים את הכלי לעדכון בצמתים לפי הסדר הבא שמוצג בקטע 'הזמנת המכונה' עדכון" מתחת:
> /opt/apigee/apigee-setup/bin/update.sh -cComponent -f configFile

הדרישה היחידה בקובץ התצורה היא שקובץ התצורה יהיה נגיש או קריא באמצעות ה-apigee משתמש. לדוגמה, למקם את הקובץ בספרייה /tmp .

משתמשים באפשרות ' -c' כדי לציין את הרכיב שרוצים לעדכן. רשימת האפשרויות כולל:
- ldap = OpenLDAP
- cs = Cassandr
- zk = גן החיות
- qpid = qpidd
- ps = postgresql
- Edge =כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
- ui = ממשק משתמש של Edge
- all = עדכון כל הרכיבים במחשב (שימוש רק בפרופיל התקנת aio של Edge) או פרופיל התקנת API של BaaS asa)
- e = ElasticSearch
- b = מקבץ BaaS ל-API
- p = פורטל API BaaS
- ebp = ElasticSearch, API BaaS Stack ו-API BaaS Portal באותו צומת
כדי לבדוק את העדכון, מפעילים את הכלי apigee-validate, בדיקת ההתקנה.

הליך לעדכון 4.16.05 מערוץ מקומי מאגר

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

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

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

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

ודאו שיש לכם מאגר 4.16.05 מקומי, כפי שמתואר במאמר התקנת רכיבי Edge צומת.
מעדכנים את המאגר המקומי:
1. מורידים את קובץ bootstrap_4.16.05.sh העדכני של Edge אל /tmp/shoestrap_4.16.05.sh:
  > תלתל https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh
2. ביצוע הסנכרון:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror Sync --only-new-rpms
כדי להתקין את apigee-service מקובץ .tar:
1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.16.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, העתקה אל את הספרייה /tmp צומת חדש.
3. בצומת החדש, מסירים את הקובץ לספריית /tmp:
  > tar -xzf apigee-4.16.05.tar.gz
  
  הפקודה הזו יוצרת ספרייה חדשה בשם repos, בספרייה שמכילה את קובץ ה- .tar חדש. לדוגמה, /tmp/repos.
4. כדי להתקין את ה-RPM ב-Edge
  , צריך להתחבר לצומת בתור הרמה הבסיסית (root) הערה: התקנת RPM מחייבת גישה לרמה הבסיסית (root), אבל אפשר להשתמש ב-Edge ללא גישה לרמה הבסיסית (root).
5. השבתת SELinux כפי שמתואר במאמר התקנת Edge הכלי apigee-setup.
6. התקנה של כלי העזר של Edge apigee-service ויחסי תלות מ- /tmp/repos:
  > sudo bash /tmp/repos/shoestrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  שימו לב שהפקודה הזו כוללת את הנתיב לספריית ה-repos.
כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
1. הגדרת שרת האינטרנט Nginx כפי שמתואר ב"התקנה מהמאגר באמצעות ה-Nginx webserver" בהתקנה רכיבי קצה בצומת.
2. בצומת המרוחק, מורידים את קובץ Edge bootrap_4.16.05.sh כדי /tmp/shoestrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh
  
  כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה המאגר ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של מאגר מאגר.
3. כדי להתקין את ה-RPM ב-Edge
  , צריך להתחבר לצומת בתור הרמה הבסיסית (root) הערה: התקנת RPM מחייבת גישה לרמה הבסיסית (root), אבל אפשר להשתמש ב-Edge ללא גישה לרמה הבסיסית (root).
4. השבתת SELinux כפי שמתואר במאמר התקנת Edge הכלי apigee-setup.
5. בצומת המרוחק, מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service:
  > sudo bash /tmp/shoestrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uNamea pigeepassword=pWord apigeeprotocol=http://
  
  כאשר uName:pWord הם שם המשתמש והסיסמה במאגר.
צריך להשבית את כל משימות CRON שהוגדרו לביצוע פעולת תיקון ב-Cassandra, אם יש כאלה עד לסיום העדכון.
משתמשים ב-apigee-service כדי לעדכן את כלי ההגדרה של apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

העדכון הזה ל-apigee-service מתקין את הכלי update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
מריצים את הכלי לעדכון בצמתים לפי הסדר הבא שמוצג בקטע 'הזמנת המכונה' עדכון" מתחת:
> /opt/apigee/apigee-setup/bin/update.sh -cComponent -f configFile

הדרישה היחידה בקובץ התצורה היא שקובץ התצורה יהיה נגיש או קריא באמצעות ה-apigee משתמש. לדוגמה, למקם את הקובץ בספרייה /tmp .

משתמשים באפשרות ' -c' כדי לציין את הרכיב שרוצים לעדכן. רשימת האפשרויות כולל:
- ldap = OpenLDAP
- cs = Cassandr
- zk = גן החיות
- qpid = qpidd
- ps = postgresql
- Edge =כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
- ui = ממשק משתמש של Edge
- all = עדכון כל הרכיבים במחשב (שימוש רק בפרופיל התקנת aio של Edge) או פרופיל התקנת API של BaaS asa)
- e = ElasticSearch
- b = מקבץ BaaS ל-API
- p = פורטל API BaaS
- ebp = ElasticSearch, API BaaS Stack ו-API BaaS Portal באותו צומת
כדי לבדוק את העדכון, מפעילים את הכלי apigee-validator (בדיקת התקנה).

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

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

עליך לעדכן את כל הצמתים של Cassandra ו-zoKeeper לפני עדכון של רכיבים צמתים אחרים.
צריך לעדכן את כל צומתי ה-qpidd וה-postgresql לפני שמבצעים עדכון צמתים של נתב ומעבד הודעות.
לכל מכונה עם מספר רכיבי Edge (שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres), שימוש בקצה '-c' אפשרות לעדכן את כולם בו-זמנית בזמן האימון.
אם שלב מציין שצריך לבצע אותו במספר מכונות, צריך לבצע אותו בסדר המכונה הספציפי.
אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את " -c" קצה" כאפשרות.
אחרי שמעדכנים צומת של נתב, צריך להסיר את כל הקבצים מהספרייה /opt/nginx/conf.d, ואז להפעיל מחדש את הנתב.