בקטע הזה מוסבר איך לשדרג מ-Apigee Edge 4.19.06 או 4.50.00 ל-4.51.00.
מי יכול לבצע את העדכון
האדם שמפעיל את העדכון צריך להיות אותו אדם שהתקין את Edge במקור, או אדם שפועל כמשתמש root.
אחרי שמתקינים את ה-RPM של Edge, כל אחד יכול להגדיר אותם.
אילו רכיבים צריך לעדכן
צריך לעדכן את כל הרכיבים של Edge. ב-Edge אין תמיכה בהגדרה שמכילה רכיבים מכמה גרסאות.
הפצה אוטומטית של הגדרות הנכס
אם הגדרתם מאפיינים כלשהם על ידי עריכת קובצי .properties ב-/opt/apigee/customer/application, הערכים האלה נשמרים בעדכון.
שדרוג חובה ל-Postgres 10.17
הגרסה הזו של Edge כוללת שדרוג ל-Postgres 10.17. כחלק מהשדרוג, כל הנתונים של Postgres מועברים ל-Postgres 10.17.
רוב מערכות הייצור של Edge משתמשות בשני צומתי Postgres שמוגדרים לשכפול מאסטר-המתנה. במהלך תהליך העדכון, כשצומתי Postgres מושבתים לצורך עדכון, נתוני הניתוח עדיין נכתבים לצומתי Qpid. אחרי שצומתי Postgres מתעדכנים וחוזרים לפעול, נתוני הניתוח נשלחים לצומתי Postgres.
הדרך שבה מבצעים את עדכון Postgres תלויה באופן שבו הגדרתם את מאגר הנתונים לצומתי Postgres:
- אם אתם משתמשים בשמירת נתונים במאגר מקומי לצומתי Postgres, אתם צריכים להתקין צומת המתנה חדש של Postgres למשך השדרוג. אחרי שהשדרוג מסתיים, אתם יכולים להוציא משימוש את צומת הגיבוי החדש של Postgres.
צומת הגיבוי הנוסף של Postgres נדרש אם צריך לבטל את העדכון מכל סיבה שהיא. אם צריך לבטל את העדכון, צומת ה-Postgres החדש במצב המתנה הופך לצומת ה-Postgres הראשי אחרי הביטול. לכן, כשמתקינים את צומת הגיבוי החדש של Postgres, הוא צריך להיות בצומת שעומד בכל דרישות החומרה של שרת Postgres, כפי שמוגדר בדרישות ההתקנה של Edge.
במערך של צומת אחד או שני צמתים של Edge, טופולוגיות שמשמשות ליצירת אב טיפוס ולבדיקה, יש רק צומת Postgres אחד. אפשר לעדכן את צומתי Postgres האלה ישירות בלי ליצור צומת Postgres חדש.
- אם אתם משתמשים באחסון ברשת לצומתי Postgres, כפי שמומלץ על ידי Apigee, אתם לא צריכים להתקין צומת Postgres חדש. בפעולות הבאות, אתם יכולים לדלג על השלבים שבהם מצוין להתקין צומת המתנה חדש של Postgres ולהוציא אותו משימוש מאוחר יותר.
לפני שמתחילים את תהליך העדכון, צריך ליצור תמונת מצב של הרשת של מאגר הנתונים שמשמש את Postgres. אם יתרחשו שגיאות במהלך העדכון ותצטרכו לבצע חזרה למצב קודם, תוכלו לשחזר את צומת Postgres מה-snapshot הזה.
התקנת צומת המתנה חדש של Postgres
התהליך הזה יוצר שרת המתנה של Postgres בצומת חדש. חשוב לוודא שאתם מתקינים שרת Postgres חדש במצב המתנה לגרסה הקיימת של Edge (4.19.06 או 4.50.00), ולא לגרסה 4.51.00.
כדי לבצע את ההתקנה, משתמשים באותו קובץ תצורה ששימש להתקנת הגרסה הנוכחית של Edge.
כדי ליצור צומת המתנה חדש של Postgres:
- במאסטר הנוכחי של Postgres, עורכים את הקובץ
/opt/apigee/customer/application/postgresql.propertiesכדי להגדיר את הטוקן הבא. אם הקובץ הזה לא קיים, יוצרים אותו:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
כאשר existing_standby_ip היא כתובת ה-IP של שרת ה-Postgres הנוכחי במצב המתנה, ו-new_standby_ip היא כתובת ה-IP של הצומת החדש במצב המתנה.
- מפעילים מחדש את
apigee-postgresqlב-Postgres הראשי:/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- כדי לוודא שצומת ההמתנה החדש נוסף, בודקים את הקובץ
/opt/apigee/apigee-postgresql/conf/pg_hba.confבצומת הראשי. השורות הבאות אמורות להופיע בקובץ:host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- מתקינים את שרת הגיבוי החדש של Postgres:
- עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge, ומציינים את הפרטים הבאים:
# IP address of the current master: PG_MASTER=192.168.56.103 # IP address of the new standby node PG_STANDBY=192.168.56.102
- משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
- מבצעים אחת מהפעולות הבאות, בהתאם לגרסה של Edge שמשדרגים ממנה:
- אם משדרגים מ-Edge 4.19.06, מורידים את הקובץ bootstrap_4.19.06.sh של Edge אל
/tmp/bootstrap_4.19.06.sh:curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
בשלב הבא, מתקינים את כלי השירות של Edge
apigee-serviceואת יחסי התלות:sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord
- אם אתם משדרגים מ-Edge 4.50.00,
הורידו את הקובץ bootstrap_4.50.00.sh של Edge אל
/tmp/bootstrap_4.50.00.sh:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
בשלב הבא, מתקינים את כלי השירות של Edge
apigee-serviceואת יחסי התלות:sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- אם משדרגים מ-Edge 4.19.06, מורידים את הקובץ bootstrap_4.19.06.sh של Edge אל
- משתמשים ב-
apigee-serviceכדי להתקין את הכליapigee-setup:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- מתקינים את Postgres:
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- בצומת החדש במצב המתנה, מריצים את הפקודה הבאה:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
מוודאים שמופיע הכיתוב standby (המתנה).
- עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge, ומציינים את הפרטים הבאים:
ביצוע שדרוג במקום של Postgres
כדי לבצע שדרוג במקום ל-Postgres 10.17, מבצעים את השלבים הבאים:
- שדרוג postgres במארח הראשי
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- מריצים את פקודת ההגדרה במארח הראשי:
apigee-service apigee-postgresql setup -f /opt/silent.conf
- מריצים את פקודת ההגדרה במארח הראשי:
apigee-service apigee-postgresql configure
- מפעילים מחדש את המארח הראשי:
apigee-service apigee-postgresql restart
- מגדירים אותו כמאסטר:
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- מוודאים שהמארח הראשי התחיל:
apigee-service apigee-postgresql wait_for_ready
- כדי להפסיק את מצב ההמתנה:
apigee-service apigee-postgresql stop
- משדרגים את המכשיר החלופי.
הערה: אם השלב הזה נכשל או מופיעה שגיאה, אפשר להתעלם ממנה.
update.shינסה להפעיל את השרת במצב המתנה עם הגדרה שגויה. אם ההתקנה של Postgres משודרגת לגרסה 10.17, אפשר להתעלם מהשגיאה./opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- מוודאים שהמצב המתנה הופסק:
apigee-service apigee-postgresql stop
- מסירים את ההגדרה הישנה של הגיבוי:
rm -rf /opt/apigee/data/apigee-postgresql/
- מגדירים רפליקציה בשרת ההמתנה:
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
אחרי שתסיימו את התהליך הזה, המצב המתנה יתחיל לפעול.
הוצאה משימוש של צומת Postgres
אחרי שהעדכון מסתיים, מוציאים משימוש את הצומת החדש במצב המתנה:
- מוודאים ש-Postgres פועל:
/opt/apigee/apigee-service/bin/apigee-all status
אם Postgres לא פועל, מפעילים אותו:
/opt/apigee/apigee-service/bin/apigee-all start
- מריצים את הפקודה הבאה של
curlבצומת הגיבוי החדש כדי לקבל את ה-UUID שלו:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
ה-UUID של הצומת אמור להופיע בסוף הפלט, בפורמט הבא:
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- מפסיקים את צומת הגיבוי החדש על ידי הרצת הפקודה הבאה בצומת הגיבוי החדש:
/opt/apigee/apigee-service/bin/apigee-all stop
- בצומת הראשי של Postgres, עורכים את
/opt/apigee/customer/application/postgresql.propertiesכדי להסיר את צומת ההמתנה החדש מ-conf_pg_hba_replication.connection:conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
- מפעילים מחדש את apigee-postgresql ב-Postgres הראשי:
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- כדי לוודא שצומת ההמתנה החדש הוסר, בודקים את הקובץ
/opt/apigee/apigee-postgresql/conf/pg_hba.confבמאסטר. בקובץ הזה אמורה להופיע רק השורה הבאה:host replication apigee existing_standby_ip/32 trust
- מוחקים את ה-UUID של הצומת במצב המתנה מ-ZooKeeper באמצעות קריאה ל-API לניהול של Edge בצומת של שרת הניהול:
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
דרישות מוקדמות לעדכון
לפני שמשדרגים את Apigee Edge, צריך לבצע את הפעולות הבאות:
- גיבוי כל הצמתים
לפני העדכון, מומלץ לבצע גיבוי מלא של כל הצמתים מטעמי בטיחות. כדי לבצע את הגיבוי, משתמשים בהליך שמתאים לגרסה הנוכחית של Edge.כך תהיה לכם תוכנית גיבוי למקרה שהעדכון לגרסה חדשה לא יפעל כמו שצריך. מידע נוסף על גיבוי זמין במאמר גיבוי ושחזור.
- מוודאים ש-Edge פועל
כדי לוודא ש-Edge פועל במהלך תהליך העדכון, משתמשים בפקודה:/opt/apigee/apigee-service/bin/apigee-all status
ממשק המשתמש החדש של Edge
בקטע הזה מפורטים שיקולים שקשורים לממשק המשתמש של Edge. מידע נוסף זמין במאמר ממשק המשתמש החדש של Edge ל-Private Cloud.
התקנת ממשק המשתמש של Edge
אחרי ההתקנה הראשונית, מומלץ להתקין את ממשק המשתמש של Edge, שהוא ממשק משתמש משופר למפתחים ולאדמינים של Apigee Edge for Private Cloud.
שימו לב שבממשק המשתמש של Edge צריך להשבית את האימות הבסיסי ולהשתמש ב-IDP כמו SAML או LDAP.
מידע נוסף זמין במאמר התקנת ממשק המשתמש החדש של Edge.
עדכון ממשק המשתמש של Edge
כדי לעדכן את רכיב ממשק המשתמש של Edge, צריך לבדוק מאיזו גרסה של Edge for Private Cloud אתם משדרגים:
- מגרסה 4.19.06 או 4.50.00 לגרסה 4.51.00 (כשהממשק החדש של Edge כבר מותקן): משתמשים בהוראות השדרוג שבקטע הזה לרכיב
edge-management-ui.
עדכון באמצעות Apigee mTLS
כדי לעדכן את Apigee mTLS, מבצעים את הפעולות הבאות:
חזרה לגרסה קודמת של עדכון
אם העדכון נכשל, אתם יכולים לנסות לתקן את הבעיה ואז להריץ שוב את update.sh. אפשר להריץ את העדכון כמה פעמים, והוא ימשיך מהנקודה שבה הוא הפסיק בפעם האחרונה.
אם הכשל מחייב אתכם להחזיר את העדכון לגרסה הקודמת, עיינו בהוראות המפורטות במאמר החזרה לגרסה 4.51.00.
רישום פרטי העדכון ביומן
כברירת מחדל, הכלי 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 האחרים באותו מחשב שבו נמצא ה-Router. בכל ההגדרות של Edge, הנתב ומעבד הבקשות מוצגים באותו צומת.
- מוודאים שהנתב זמין שוב.
- חוזרים על שלבים 2 עד 4 בשאר הנתבים.
- ממשיכים את העדכון בכל המחשבים שנותרו בהתקנה.
לפני ואחרי העדכון, חשוב לבצע את הפעולות הבאות:
- בצומת משולב של נתב ומעבד בקשות:
- לפני העדכון – מבצעים את הפעולות הבאות:
- הופכים את הנתב ללא נגיש.
- הופכים את מעבד הבקשות ללא זמין.
- אחרי העדכון – מבצעים את הפעולות הבאות:
- מוודאים שאפשר להגיע למעבד הבקשות.
- מוודאים שהנתב נגיש.
- לפני העדכון – מבצעים את הפעולות הבאות:
- בצמתים של נתב יחיד:
- לפני העדכון, צריך להגדיר את הנתב כלא נגיש.
- אחרי העדכון, מוודאים שאפשר להגיע לנתב.
- בצמתים של מעבד בקשות יחיד:
- לפני העדכון, צריך להגדיר את מעבד הבקשות כלא נגיש.
- אחרי העדכון, צריך לוודא שאפשר להגיע למעבד הבקשות.
שימוש בקובץ תצורה אוטומטי
צריך להעביר קובץ תצורה אוטומטי לפקודת העדכון. קובץ התצורה האוטומטי צריך להיות זהה לזה שבו השתמשתם כדי להתקין את Edge בגרסה 4.19.06 או 4.50.00.
עדכון לגרסה 4.51.00 בצומת עם חיבור חיצוני לאינטרנט
כדי לעדכן את רכיבי Edge בצומת:
- אם יש משימות
cronשמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון. - מתחברים לצומת כמשתמש הבסיס (root) כדי להתקין את חבילות ה-RPM של Edge.
- התקנת
yum-utilsו-yum-plugin-priorities:sudo yum install yum-utils
sudo yum install yum-plugin-priorities - משביתים את SELinux כמו שמתואר במאמר התקנת כלי השירות apigee-setup של Edge.
- אם אתם מתקינים ב-Oracle 7.x, הריצו את הפקודה הבאה:
sudo yum-config-manager --enable ol7_optional_latest
- אם אתם מתקינים ב-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 - מורידים את הקובץ Edge 4.51.00
bootstrap_4.51.00.shאל/tmp/bootstrap_4.51.00.sh:curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- מתקינים את כלי השירות
apigee-serviceשל Edge 4.51.00 ואת יחסי התלות באמצעות הפקודה הבאה:sudo bash /tmp/bootstrap_4.51.00.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 בעצמכם.
-
- משתמשים ב-
apigee-serviceכדי לעדכן את הכליapigee-setup, כמו בדוגמה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- מעדכנים את הכלי
apigee-validateבשרת הניהול, כמו בדוגמה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- מעדכנים את הכלי
apigee-provisionבשרת הניהול, כמו בדוגמה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- מריצים את כלי השירות
updateבצמתים באמצעות הפקודה הבאה:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
עושים את זה לפי הסדר שמתואר בקטע סדר עדכון המכונות.
כאשר:
- component הוא הרכיב של Edge שרוצים לעדכן. הערכים האפשריים כוללים:
cs: Cassandra-
edge: כל רכיבי Edge חוץ מממשק המשתמש של Edge: שרת ניהול, מעבד בקשות, נתב, שרת QPID, שרת Postgres ldap: OpenLDAPps: postgresql-
qpid: qpidd -
sso: מודול SSO ב-Apigee (אם התקנתם את SSO) -
ue: ממשק משתמש חדש של Edge ui: ממשק המשתמש הקלאסי של Edgezk: Zookeeper
- configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסה 4.19.06 או 4.50.00.
אפשר להריץ את
update.shבכל הרכיבים על ידי הגדרת component ל-"all", אבל רק אם יש לכם פרופיל התקנה של Edge All-In-One (AIO). לדוגמה:/opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
- component הוא הרכיב של Edge שרוצים לעדכן. הערכים האפשריים כוללים:
- אם עדיין לא עשיתם זאת, הפעילו מחדש את רכיב ממשק המשתמש של Edge בכל הצמתים שבהם הוא פועל:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- בודקים את העדכון על ידי הפעלת הכלי
apigee-validateבשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
אם תחליטו מאוחר יותר לחזור לגרסה הקודמת, תוכלו להשתמש בהליך שמתואר בקטע חזרה לגרסה הקודמת של 4.51.00.
עדכון לגרסה 4.51.00 ממאגר מקומי
אם צומתי Edge נמצאים מאחורי חומת אש, או אם נאסר עליהם בדרך אחרת לגשת למאגר Apigee דרך האינטרנט, אתם יכולים לבצע את העדכון ממאגר מקומי או ממאגר מראה של מאגר Apigee.
אחרי שיוצרים מאגר מקומי של Edge, יש שתי אפשרויות לעדכון Edge מהמאגר המקומי:
- יוצרים קובץ .tar של המאגר, מעתיקים את קובץ ה- .tar לצומת ואז מעדכנים את Edge מקובץ ה-.tar.
- מתקינים שרת אינטרנט בצומת עם המאגר המקומי כדי שצמתים אחרים יוכלו לגשת אליו. Apigee מספקת את שרת האינטרנט NGINX, אבל אתם יכולים להשתמש בשרת אינטרנט משלכם.
כדי לעדכן ממאגר מקומי של גרסה 4.51.00:
- יוצרים מאגר מקומי בגרסה 4.51.00, כמו שמתואר בקטע "יצירת מאגר Apigee מקומי" במאמר התקנת כלי השירות apigee-setup של Edge.
- כדי להתקין את apigee-service מקובץ .tar:
- בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar יחיד בשם
/opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz:/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה
/tmpבצומת החדש. - בצומת החדש, מבטלים את הדחיסה של הקובץ לספרייה
/tmp:tar -xzf apigee-4.51.00.tar.gz
הפקודה הזו יוצרת ספרייה חדשה בשם
reposבספרייה שמכילה את קובץ ה- .tar. לדוגמה/tmp/repos. - מתקינים את כלי השירות של Edge
apigee-serviceואת יחסי התלות מ-/tmp/repos:sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
שימו לב שאתם כוללים את הנתיב לספריית המאגרים בפקודה הזו.
- בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar יחיד בשם
- כדי להתקין את apigee-service באמצעות שרת האינטרנט NGINX:
- מגדירים את שרת האינטרנט NGINX כמו שמתואר בקטע "Install from the repo using the NGINX webserver" במאמר Install the Edge apigee-setup utility.
- בצומת המרוחק, מורידים את קובץ Edge
bootstrap_4.51.00.shאל/tmp/bootstrap_4.51.00.sh:/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם קודם למאגר, ו-remoteRepo היא כתובת ה-IP או שם ה-DNS של צומת המאגר.
- בצומת המרוחק, מתקינים את כלי השירות
apigee-setupשל Edge ואת יחסי התלות:sudo bash /tmp/bootstrap_4.51.00.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-validate update
- מעדכנים את הכלי
apigee-provisionבשרת הניהול, כמו בדוגמה הבאה:/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- מריצים את כלי השירות
updateבצמתים לפי הסדר שמתואר בקטע סדר עדכון המכונות:/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
כאשר:
- component הוא הרכיב של Edge שרוצים לעדכן. בדרך כלל מעדכנים את הרכיבים הבאים:
cs: Cassandra-
edge: כל רכיבי Edge חוץ מ-Edge UI: Management Server, Message Processor, Router, QPID Server, Postgres Server ldap: OpenLDAPps: postgresql-
qpid: qpidd -
sso: מודול SSO ב-Apigee (אם התקנתם את SSO) ueממשק המשתמש החדש של Edgeui: ממשק המשתמש הקלאסי של Edgezk: Zookeeper
- configFile הוא אותו קובץ תצורה שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסה 4.19.06 או 4.50.00.
אפשר להריץ את
update.shבכל הרכיבים על ידי הגדרת component ל-"all", אבל רק אם יש לכם פרופיל התקנה של Edge All-In-One (AIO). לדוגמה:/opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
- component הוא הרכיב של Edge שרוצים לעדכן. בדרך כלל מעדכנים את הרכיבים הבאים:
- אם עדיין לא עשיתם את זה, הפעילו מחדש את רכיבי ממשק המשתמש בכל הצמתים שבהם הוא פועל:
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- בודקים את העדכון על ידי הפעלת הכלי
apigee-validateבשרת הניהול, כפי שמתואר בקטע בדיקת ההתקנה.
אם תחליטו מאוחר יותר לחזור לגרסה הקודמת, תוכלו להשתמש בהליך שמתואר בקטע חזרה לגרסה הקודמת של 4.51.00.
סדר העדכון של המכונות
חשוב להקפיד על סדר עדכון המכונות בהתקנה של Edge:
- צריך לעדכן את כל הצמתים של Cassandra ו-ZooKeeper לפני שמעדכנים צמתים אחרים.
- בכל מכונה עם כמה רכיבי Edge (שרת ניהול, מעבד בקשות, נתב, שרת QPID אבל לא שרת Postgres), משתמשים באפשרות
-c edgeכדי לעדכן את כולם בו-זמנית. - אם בשלב מסוים מצוין שצריך לבצע אותו בכמה מכונות, בצעו אותו לפי סדר המכונות שצוין.
- אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את האפשרות
-c edge.
שדרוג שנרכש בנפרד של צומת אחד
כדי לשדרג הגדרה עצמאית של צומת אחד לגרסה 4.51.00:
- עדכון כל הרכיבים:
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
- (אם התקנתם את
apigee-adminapi) מעדכנים את הכליapigee-adminapi:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
שדרוג שנרכש בנפרד של 2 צמתים
מעדכנים את הרכיבים הבאים להתקנה עצמאית של 2 צמתים:
במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.
- מעדכנים את Cassandra ו-ZooKeeper במכונה 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- מעדכנים את Qpid ו-Postgres במכונה 2:
/opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile
- מעדכנים את LDAP במכונה 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- מעדכנים את רכיבי Edge במכונות 2 ו-1:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- מעדכנים את ממשק המשתמש במכונה 1:
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (אם התקנתם את
apigee-adminapi) עדכון של כלי השירותapigee-adminapiבמכונה 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (אם התקנתם את מודול SSO ב-Apigee) מעדכנים את מודול SSO ב-Apigee במכונה 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם את ה-SSO.
- מפעילים מחדש את רכיב ממשק המשתמש של Edge במכונה 1:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
שדרוג של 5 צמתים
מעדכנים את הרכיבים הבאים להתקנה של 5 צמתים:
במאמר טופולוגיות של התקנה מפורטות הטופולוגיות של Edge ומספרי הצמתים.
- מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- מעדכנים את Qpid ו-Postgres במכונה 4:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- מעדכנים את Qpid ו-Postgres במכונה 5:
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- מעדכנים את LDAP במכונה 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- מעדכנים את רכיבי Edge במכונות 4, 5, 1, 2, 3:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- מעדכנים את ממשק המשתמש של 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
- ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, עדכנו את הרכיב
- (אם התקנתם את
apigee-adminapi) עדכון של כלי השירותapigee-adminapiבמכונה 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (אם התקנתם את מודול SSO ב-Apigee) מעדכנים את מודול SSO ב-Apigee במכונה 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם את ה-SSO.
- מפעילים מחדש את רכיב ממשק המשתמש:
- ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, הפעילו מחדש את הרכיב
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 ומספרי הצמתים.
- מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- מעדכנים את Qpid במכונות 6 ו-7:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- עדכון Postgres במכונה 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- עדכון Postgres במכונה 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- מעדכנים את LDAP במכונה 1:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- מעדכנים את רכיבי Edge במכונות 6, 7, 8, 9, 1, 4 ו-5 בסדר הזה:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- מעדכנים את ממשק המשתמש החדש (
ue) או את ממשק המשתמש הקלאסי (ui) במכונה 1:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (אם התקנתם את
apigee-adminapi) מעדכנים את הכליapigee-adminapiבמכונה 1:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (אם התקנתם את מודול SSO ב-Apigee) מעדכנים את מודול SSO ב-Apigee במכונה 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם את ה-SSO.
- מפעילים מחדש את רכיב ממשק המשתמש:
- ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, הפעילו מחדש את הרכיב
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 ומספרי הצמתים.
- מעדכנים את Cassandra ו-ZooKeeper במכונות 1, 2 ו-3:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- מעדכנים את Qpid במכונות 12 ו-13:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- עדכון Postgres במכונה 8:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- עדכון Postgres במכונה 9:
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- מעדכנים את LDAP במכונות 4 ו-5:
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- מעדכנים את רכיבי Edge במכונות 12, 13, 8, 9, 6, 7, 10 ו-11 בסדר הזה:
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- מעדכנים את ממשק המשתמש החדש (
ue) או את ממשק המשתמש הקלאסי (ui) במכונות 6 ו-7:/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (אם התקנתם את
apigee-adminapi) עדכנו את הכליapigee-adminapiבמכונות 6 ו-7:/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- (אם התקנתם את מודול ה-SSO ב-Apigee) מעדכנים את מודול ה-SSO ב-Apigee במכונות 6 ו-7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם את ה-SSO.
- מפעילים מחדש את רכיב ממשק המשתמש:
- ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, הפעילו מחדש את הרכיב
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 ומספרי הצמתים.
- מעדכנים את Cassandra ו-ZooKeeper:
- במכונות 1, 2 ו-3 במרכז נתונים 1:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- במכונות 7, 8 ו-9 במרכז נתונים 2
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- במכונות 1, 2 ו-3 במרכז נתונים 1:
- מעדכנים את qpidd:
- מכונות 4 ו-5 במרכז נתונים 1
- עדכון של
qpiddבמחשב 4:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- עדכון של
qpiddבמכונה 5:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- עדכון של
- מכונות 10 ו-11 במרכז נתונים 2
- עדכון
qpiddבמחשב 10:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- עדכון
qpiddבמכונה 11:/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- עדכון
- מכונות 4 ו-5 במרכז נתונים 1
- מעדכנים את Postgres:
- מכונה 6 במרכז נתונים 1
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- מכונה 12 במרכז נתונים 2
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- מכונה 6 במרכז נתונים 1
- עדכון LDAP:
- מכונה 1 במרכז נתונים 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- מכונה 7 במרכז נתונים 2
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- מכונה 1 במרכז נתונים 1
- מעדכנים את הרכיבים של Edge:
- מכונות 4, 5, 6, 1, 2, 3 במרכז נתונים 1
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- מכונות 10, 11, 12, 7, 8, 9 במרכז נתונים 2
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- מכונות 4, 5, 6, 1, 2, 3 במרכז נתונים 1
- מעדכנים את ממשק המשתמש החדש (
ue) או את ממשק המשתמש הקלאסי (ui):- מכונה 1 במרכז נתונים 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- מכונה 7 במרכז נתונים 2:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- מכונה 1 במרכז נתונים 1:
- (אם התקנתם את
apigee-adminapi) עדכנו את הכליapigee-adminapi:- מכונה 1 במרכז נתונים 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- מכונה 7 במרכז נתונים 2:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- מכונה 1 במרכז נתונים 1:
- (אם התקנתם את מודול ה-SSO ב-Apigee) מעדכנים את מודול ה-SSO ב-Apigee:
- מכונה 1 במרכז נתונים 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- מכונה 7 במרכז נתונים 2:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
sso_config_file הוא קובץ התצורה שיצרתם כשהתקנתם את ה-SSO.
- מכונה 1 במרכז נתונים 1:
- מפעילים מחדש את הרכיב של ממשק המשתמש החדש של Edge (
edge-management-ui) או של ממשק המשתמש הקלאסי של Edge (edge-ui) במכונות 1 ו-7:/opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart
להגדרה לא סטנדרטית
אם יש לכם הגדרה לא סטנדרטית, צריך לעדכן את רכיבי Edge בסדר הבא:
- ZooKeeper
- Cassandra
- qpidd, ps
- LDAP
- Edge, כלומר הפרופיל "-c edge" בכל הצמתים בסדר הבא: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד בקשות ונתב.
- ממשק המשתמש של Edge (הקלאסי או החדש)
apigee-adminapi- מודול SSO ב-Apigee
אחרי שמסיימים לעדכן, חשוב להפעיל מחדש את רכיב ממשק המשתמש של Edge בכל המכונות שבהן הוא פועל.