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

עדכון של Apigee Edge 4.17.01 ל-4.17.05

Edge for Private Cloud גרסה 4.17.05

אילו גרסאות של Edge אפשר לעדכן ל-4.17.05

באמצעות התהליך הזה אפשר לעדכן את גרסה 4.17.01.0x של Apigee Edge ל-4.17.05.

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

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

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

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

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

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

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

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

תוספת נדרשת של SMTMAILFROM פרמטר הגדרה

Edge 4.17.05 הוסיף פרמטר נדרש חדש לקובץ התצורה שמשמש להפעלה של התכונה שרת SMTP. עכשיו צריך להגדיר את האפשרות SMTPMAILFROM בקובץ התצורה. בעת הפעלת שרת ה-SMTP. הפורמט של הפרמטר הזה:

SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

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

> /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

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

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

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

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

אם למשתמש אין גישה ל-/tmp, הכלי /tmp ייכשל.

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

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

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

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

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

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

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

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

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

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

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

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

כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם ב-Apigee. אם משמיטים את המילה pWord, תתבקשו להזין אותה.

כברירת מחדל, מנהל ההתקנה בודק אם התקנתם את Java 1.8. אם לא, יתקין אותו בשבילך. משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל התקנת Java. JAVA_FIX הפונקציה מקבלת את הערכים הבאים:

I = התקנת OpenJDK 1.8 (ברירת מחדל)
C = המשך בלי להתקין Java
שאלה = יציאה. כדי להשתמש באפשרות הזו, תצטרכו להתקין Java בעצמכם.
(CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי Qpid, מריצים את הפקודה הבאה כדי לוודא שהורדתם את גרסת ה-Qpid הנכונה:
> יאמי התקנה apigee-qpidd --disablerepo=epel
להשתמש ב-apigee-service כדי לעדכן את apigee-setup תוכנית שירות:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
עדכון של apigee-validate בשרת הניהול:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validator update
עדכון של apigee-provision תוכנית שירות:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
מריצים את כלי העדכון בצמתים לפי הסדר הבא שמוצג בקטע סדר המכונה עדכון" מתחת:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

הדרישה היחידה בקובץ התצורה היא שקובץ התצורה יהיה נגיש או קריא באמצעות ה-apigee משתמש.

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

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

נוהל עדכון לגרסה 4.17.05 מרשת מקומית מאגר

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

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

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

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

יוצרים מאגר 4.17.05 מקומי כפי שמתואר ב"יצירת מאגר Apigee מקומי" מתקינים את כלי ההגדרה של Edge apigee-setup.
הערה: אם כבר יש לכם מאגר 4.17.01 קיים, תוכלו להוסיף את 4.17.05 מאגר שלו כפי שמתואר ב'עדכון מאגר Apigee מקומי' בהתקנת כלי ההגדרה של Edge apigee-setup.
כדי להתקין את apigee-service מקובץ .tar:
1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, העתקה אל את הספרייה /tmp צומת חדש.
3. בצומת החדש, מסירים את הקובץ לספריית /tmp:
  > tar -xzf apigee-4.17.05.tar.gz
  
  הפקודה הזו יוצרת ספרייה חדשה בשם repos, בספרייה שמכילה את קובץ ה- .tar חדש. לדוגמה, /tmp/repos.
4. התקנה של כלי העזר של Edge apigee-service ויחסי תלות מ- /tmp/repos:
  > sudo bash /tmp/repos/shoestrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  
  שימו לב שהפקודה הזו כוללת את הנתיב לספריית ה-repos.
כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
1. הגדרת שרת האינטרנט Nginx כפי שמתואר ב"התקנה מהמאגר באמצעות ה-Nginx webserver" בדף Install the Edge הכלי apigee-setup.
2. בצומת המרוחק, מורידים את קובץ bootstrap_4.17.05.sh של Edge אל /tmp/shoestrap_4.17.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/shoestrap_4.17.05.sh
  
  כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה המאגר ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של מאגר מאגר.
3. בצומת המרוחק, מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service:
  > sudo bash /tmp/shoestrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  
  כאשר uName:pWord הם שם המשתמש והסיסמה במאגר.
להשתמש ב-apigee-service כדי מעדכנים את כלי ההגדרה של apigee-setup:
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
עדכון של apigee-validate בשרת הניהול.
> /opt/apigee/apigee-service/bin/apigee-service apigee-authentic update
עדכון של apigee-provision תוכנית שירות:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
מריצים את הכלי לעדכון בצמתים לפי הסדר הבא שמוצג בקטע 'הזמנת המכונה' עדכון" מתחת:
> /opt/apigee/apigee-setup/bin/update.sh -cComponent -f configFile

הדרישה היחידה בקובץ התצורה היא שקובץ התצורה יהיה נגיש או קריא באמצעות ה-apigee משתמש.

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

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

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

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

עליך לעדכן את כל הצמתים של Cassandra ו-zoKeeper לפני עדכון של רכיבים צמתים אחרים.
לכל מכונה עם מספר רכיבי Edge (שרת ניהול, מעבד הודעות, נתב, שרת QPID אבל לא שרת Postgres), שימוש בקצה '-c' אפשרות לעדכן את כולם בכל כמעט באותה עת.
אם שלב מציין שצריך לבצע אותו במספר מכונות, צריך לבצע אותו בסדר המכונה הספציפי.
אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את " -c" קצה" כאפשרות.
(CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי Qpid עם לחיבור חיצוני לאינטרנט, יש לוודא שהרצת את הפקודה הבאה כדי להוריד את גרסת ה-Qpid הנכונה כפי שמוצג למעלה:
> יאמי התקנה apigee-qpidd --disablerepo=epel