‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

עדכון של Apigee Edge 4.16.01 ל-4.16.05

Edge for Private Cloud גרסה 4.16.05

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

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

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

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

המשתמש שמפעיל את העדכון צריך להיות אותו משתמש שהתקין את Edge במקור, או משתמש שפועל כ-root.

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

שדרוג חובה ל-Java JDK גרסה 8

כדי להשתמש בגרסה הזו של Edge, צריך להתקין את Java JDK גרסה 8 בכל צומתי העיבוד של Edge. אפשר להתקין את Oracle JDK 8 או את OpenJDK 8. אם Java JDK 8 עדיין לא מותקן, סקריפט העדכון יכול להתקין אותו בשבילכם.

במסגרת העדכון ל-Java 8, חלק מהצפנות ה-TLS כבר לא זמינות ב-Oracle JDK 8. הרשימה המלאה מופיעה בקטע Default Disabled Cipher Suites בכתובת http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

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

שנמוך של Zookeeper

גרסת ה-RPM של Zookeeper ב-Edge for Private Cloud 4.16.01 היא apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. בגרסאות הבאות של Edge, גרסת ZooKeeper שונתה בחזרה ל-apigee-zookeeper-3.4.5-0.0.948. כך yum לא ישדרג את Zookeeper לגרסאות חדשות יותר מ-4.16.01. כדי לתקן את המצב, צריך להריץ את הפקודה yum downgrade apigee-zookeeper לפני שמעדכנים את Zookeeper.

כדי לבדוק את הגרסה של Zookeeper, משתמשים בפקודה הבאה:

> rpm -qa |grep apigee-zookeeper

אם הפקודה הזו מחזירה את גרסת Zookeeper:

apigee-zookeeper-3.4.5-1.0.905

ואז צריך לשדרג לאחור.

דרישות המקום בכונן לצורך עדכון

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

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

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

עדכון כלי השירות apigee-validate

בגרסה 4.16.01, התקנתם והפעלתם את כלי השירות apigee-validate בצומת מעבד בקשות. בגרסה 4.16.05, כלי השירות apigee-validate עודכן כך שיפעל בצומת Management Server.

כשמעדכנים לגרסה 4.16.05, יש שתי אפשרויות לעדכון של כלי השירות apigee-validate:

מומלץ על ידי Apigee – מתקינים ומריצים את כלי השירות apigee-validate בצומת של שרת הניהול.

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

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

לפני שמשדרגים את 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 צמתים ומעלה.

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

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

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

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

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

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

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

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

אם יש משימות CRON שמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
מתחברים לצומת כמשתמש root כדי להתקין את חבילות ה-RPM של Edge
הערה: למרות שהתקנת חבילות RPM דורשת גישת root, אפשר להגדיר את Edge בלי גישת root.
משביתים את SELinux כמו שמתואר במאמר התקנת הכלי apigee-setup של Edge.
מורידים את הקובץ bootstrap_4.16.05.sh של Edge 4.16.05 אל /tmp/bootstrap_4.16.05.sh:
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
מתקינים את כלי השירות apigee-service של Edge 4.16.05 ואת יחסי התלות:
> sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם מ-Apigee. אם לא תציינו את pWord, תתבקשו להזין אותו.
כברירת מחדל, מנהל ההתקנה בודק אם מותקנת גרסה 1.8 של Java. אם לא, היא תתקין אותה. משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל בהתקנה של Java. JAVA_FIX מקבל את הערכים הבאים:
I = התקנת OpenJDK 1.8 (ברירת מחדל)
C = המשך בלי להתקין את Java
Q = יציאה. כדי להשתמש באפשרות הזו, צריך להתקין את Java בעצמכם.
משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:
1. אם התקנתם את גרסה 4.16.01 על ידי שדרוג גרסה 4.15.07.0x של Edge, אתם צריכים להתקין את כלי השירות apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  הפקודה הזו מתקינה את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
  
  אם כבר התקנתם את הכלי apigee-setup, צריך לעדכן אותו:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. אם התקנתם את גרסה 4.16.01 ישירות, כלומר לא ביצעתם שדרוג מגרסה 4.15.07.0x, אתם צריכים לעדכן את כלי השירות apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  העדכון הזה ל-apigee-service מתקין את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
מתקינים את הכלי apigee-validate בשרת הניהול:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
הערה: אם התקנתם את הכלי apigee-validate בצומת של מעבד בקשות, אתם יכולים לעדכן אותו באמצעות הפקודה הבאה בצומת הזה:
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
עם זאת, בגרסה 4.16.05, Apigee ממליצה להתקין ולהפעיל את הכלי apigee-validate בשרת הניהול.
עורכים את קובץ התצורה שמועבר לכלי apigee-validate. בגרסה הקודמת של Edge, קובץ התצורה ששימש את apigee-validate דרש את המאפיינים הבאים:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
בגרסה הזו, קובץ התצורה דורש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "סדר עדכון המכונות" בהמשך:
> ‎/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
הדרישה היחידה לגבי קובץ התצורה היא שהוא יהיה נגיש או קריא למשתמש "apigee". לדוגמה, אפשר לשים את הקובץ בספרייה ‎ /tmp בצומת.
משתמשים באפשרות "‎-c" כדי לציין את הרכיב שרוצים לעדכן. רשימת הרכיבים האפשריים כוללת:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- ‫edge =כל רכיבי Edge חוץ מ-Edge UI: שרת ניהול, מעבד בקשות, נתב, שרת QPID, שרת Postgres
- ‫ui = ממשק המשתמש של Edge
- ‫all = עדכון כל הרכיבים במכונה (משתמשים באפשרות הזו רק לפרופיל התקנה של Edge aio או לפרופיל התקנה של API BaaS asa)
- e = ElasticSearch
- b = API BaaS Stack
- ‫p = פורטל API BaaS
- ‫ebp = ElasticSearch,‏ API BaaS Stack ו-API BaaS Portal באותו צומת
בודקים את העדכון על ידי הפעלת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

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

איך מעדכנים לגרסה 4.16.05 ממאגר מקומי

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

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

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

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

יוצרים מאגר מקומי של גרסה 4.16.05, כמו שמתואר בקטע "יצירת מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
הערה: אם כבר יש לכם מאגר 4.16.01, אתם יכולים להוסיף לו את המאגר 4.16.05.
כדי להתקין את 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. מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות מ-‎ /tmp/repos:
  > sudo bash /tmp/repos/bootstrap_4.16.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
  שימו לב שאתם כוללים את הנתיב לספריית המאגרים בפקודה הזו.
כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
1. מגדירים את שרת האינטרנט Nginx כמו שמתואר בקטע "התקנה מהמאגר באמצעות שרת האינטרנט Nginx" במאמר התקנת כלי השירות apigee-setup של Edge.
2. בצומת המרוחק, מורידים את הקובץ Edge bootstrap_4.16.05.sh אל /tmp/bootstrap_4.16.05.sh:
  > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
  כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה למאגר, ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של צומת המאגר.
3. בצומת המרוחק, מתקינים את כלי השירות apigee-service של Edge ואת יחסי התלות:
  > sudo bash /tmp/bootstrap_4.16.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
  כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.
משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:
1. אם התקנתם את גרסה 4.16.01 על ידי שדרוג של Edge מגרסה 4.15.07.0x, אתם צריכים להתקין את כלי השירות apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  הפקודה הזו מתקינה את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
  
  אם כבר התקנתם את הכלי apigee-setup, צריך לעדכן אותו:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. אם התקנתם את גרסה 4.16.01 ישירות, כלומר לא ביצעתם שדרוג מגרסה 4.15.07.0x, אתם צריכים לעדכן את כלי השירות apigee-setup:
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  העדכון הזה של apigee-service מתקין את כלי השירות update.sh ב-<inst_dir>/apigee/apigee-setup/bin.
מתקינים את כלי השירות apigee-validate בצומת של שרת הניהול:
> ‎/opt/apigee/apigee-service/bin/apigee-service apigee-validate install
הערה: אם התקנתם את כלי השירות apigee-validate בצומת של מעבד בקשות, אתם יכולים לעדכן אותו באמצעות הפקודה הבאה בצומת הזה:

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
עם זאת, בגרסה 4.16.05, מומלץ להתקין ולהריץ את כלי השירות apigee-validate בשרת הניהול.
עורכים את קובץ התצורה שמועבר לכלי apigee-validate. בגרסה הקודמת של Edge, קובץ התצורה ששימש את apigee-validate דרש את המאפיינים הבאים:
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
בגרסה הזו, קובץ התצורה דורש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "סדר עדכון המכונות" בהמשך:
> ‎/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
הדרישה היחידה לגבי קובץ התצורה היא שהוא יהיה נגיש או קריא למשתמש "apigee". לדוגמה, אפשר לשים את הקובץ בספרייה ‎ /tmp בצומת.
משתמשים באפשרות "‎-c" כדי לציין את הרכיב שרוצים לעדכן. רשימת הרכיבים האפשריים כוללת:
- ldap = OpenLDAP
- cs = Cassandra
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- ‫edge =כל רכיבי Edge חוץ מ-Edge UI: שרת ניהול, מעבד בקשות, נתב, שרת QPID, שרת Postgres
- ‫ui = ממשק המשתמש של Edge
- ‫all = עדכון כל הרכיבים במכונה (משתמשים באפשרות הזו רק לפרופיל התקנה של Edge aio או לפרופיל התקנה של API BaaS asa)
- e = ElasticSearch
- b = API BaaS Stack
- ‫p = פורטל API BaaS
- ‫ebp = ElasticSearch,‏ API BaaS Stack ו-API BaaS Portal באותו צומת
בודקים את העדכון על ידי הפעלת כלי השירות apigee-validate בשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.

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

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

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

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