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

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

Edge for Private Cloud גרסה 4.16.05

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

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

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

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

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

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

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

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

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

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

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

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

הפיכת נתב ומעבד בקשות ללא זמינים

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

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

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

כאשר UUID הוא ה-UUID של מעבד הבקשות או הנתב, והערך של reachable מוגדר כ-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. מוודאים שהנתב נגיש.
בצומת Router יחיד:
- לפני העדכון, צריך לוודא שהנתב נגיש.
- אחרי העדכון, צריך לוודא שהנתב נגיש.
בצומת יחיד של מעבד בקשות:
- לפני העדכון, צריך להגדיר שאי אפשר יהיה להגיע למעבד הבקשות.
- אחרי העדכון, צריך לוודא שאפשר להגיע למעבד הבקשות.

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

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

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

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

אם יש משימות CRON שמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
מתחברים לצומת כמשתמש root כדי להתקין את חבילות ה-RPM של Edge
הערה: למרות שהתקנת חבילות RPM דורשת גישת root, אפשר להגדיר את Edge בלי גישת root.
משביתים את SELinux כמו שמתואר במאמר התקנת הכלי apigee-setup של Edge.
מנקים את כל המטמונים של Yum:
> sudo yum clean all
מורידים את הקובץ העדכני של Edge, ‏bootstrap_4.16.05.sh, אל /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 ואת יחסי התלות:
> sudo bash /tmp/bootstrap_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 -c component -f configFile

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

משתמשים באפשרות "‎-c" כדי לציין את הרכיב שרוצים לעדכן. רשימת הרכיבים האפשריים כוללת:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =כל רכיבי Edge חוץ מ-Edge UI: ‏Management Server, ‏מעבד בקשות, ‏Router, ‏QPID Server, ‏Postgres Server
- 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 ממאגר מקומי

אם צומתי 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/bootstrap_4.16.05.sh:
  > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_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. מתחברים לצומת כמשתמש root כדי להתקין את חבילות ה-RPM של Edge
  הערה: כדי להתקין את חבילות ה-RPM נדרשת גישת root, אבל אפשר להגדיר את Edge בלי גישת root.
5. משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
6. מתקינים את כלי השירות 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" במאמר התקנת רכיבי 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. מתחברים לצומת כמשתמש root כדי להתקין את חבילות ה-RPM של Edge
  הערה: כדי להתקין את חבילות ה-RPM נדרשת גישת root, אבל אפשר להגדיר את Edge בלי גישת root.
4. משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
5. בצומת המרוחק, התקן את כלי השירות apigee-service של Edge ואת התלויות בו:
  > sudo bash /tmp/bootstrap_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 -c component -f configFile

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

משתמשים באפשרות "‎-c" כדי לציין את הרכיב שרוצים לעדכן. רשימת הרכיבים האפשריים כוללת:
- ldap = OpenLDAP
- cs = Cassandr
- zk = Zookeeper
- qpid = qpidd
- ps = postgresql
- edge =כל רכיבי Edge חוץ מ-Edge UI: ‏Management Server, ‏מעבד בקשות, ‏Router, ‏QPID Server, ‏Postgres Server
- 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, Test the install.

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

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

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