בקטע הזה מוסבר איך לשדרג מ-Apigee Edge מ-4.19.06 או מ-4.50.00 ל-4.51.00.
מי יכול לבצע את העדכון
האדם שמפעיל את העדכון צריך להיות זהה למשתמש שהתקין את Edge במקור, או לאדם עם הרשאות בסיס.
אחרי שמתקינים את ה-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.
בטופולוגיות שמשמשות ליצירת אב טיפוס ולבדיקה בתצורה של צומת אחד ושני צמתים, יש רק צומת Postgres אחד. אפשר לעדכן את צומתי Postgres ישירות בלי ליצור צומת חדש של Postgres.
- אם אתם משתמשים באחסון ברשת לצומתי Postgres, בהתאם להמלצה של Apigee, אין צורך להתקין צומת Postgres חדש. בתהליכים שבהמשך אפשר לדלג על השלבים של התקנה של צומת Postgres המתנה חדש והוצאה משימוש מאוחר יותר.
לפני התחלת תהליך העדכון, חשוב לצלם תמונת מצב של מאגר הנתונים שמשמש את Postgres. לאחר מכן, אם מתרחשות שגיאות במהלך העדכון ותאלצו לבצע החזרה למצב הקודם, תוכלו לשחזר את צומת Postgres מתמונת המצב הזו.
התקנת צומת Postgres חדש במצב המתנה
התהליך הזה יוצר שרת המתנה של Postgres בצומת חדש. חשוב להתקין שרת המתנה חדש של Postgres לגרסה הקיימת של Edge (4.19.06 או 4.50.00), ולא לגרסה 4.51.00.
כדי להתקין את הגרסה האחרונה של Edge צריך להשתמש באותו קובץ תצורה שהשתמשתם בו כדי להתקין את הגרסה הנוכחית של 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 כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
- מבצעים את אחת מהפעולות הבאות, בהתאם לגרסת Edge שממנה משדרגים:
- אם בחרת לשדרג מ-Edge 4.19.06,
צריך להוריד את הקובץ Edge shoestrap_4.19.06.sh ל-
/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,
צריך להוריד את הקובץ Edge shoestrap_4.50.00.sh ל-
/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,
צריך להוריד את הקובץ Edge shoestrap_4.19.06.sh ל-
- צריך להשתמש ב-
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
מוודאים שהכתובת במצב המתנה.
- עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge כדי לציין את הפרטים הבאים:
ביצוע שדרוג מקומי של Postgres
כדי לבצע שדרוג במקום ל-Postgres 10.17, יש לבצע את השלבים הבאים:
- שדרוג הודעות פוסט במארח הראשי
/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 של צומת ההמתנה מ-zoKeeper על ידי ביצוע הקריאה הבאה ל-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 לענן פרטי.
התקנת ממשק המשתמש של Edge
אחרי השלמת ההתקנה הראשונית, Apigee ממליצה להתקין את ממשק המשתמש של Edge, שהוא ממשק משתמש משופר למפתחים ולאדמינים של Apigee Edge לענן פרטי.
הערה: בממשק המשתמש של Edge צריך להשבית את האימות הבסיסי ולהשתמש ב-IDP כמו SAML או LDAP.
מידע נוסף זמין במאמר התקנת ממשק המשתמש החדש של Edge.
עדכון ממשק המשתמש של Edge
כדי לעדכן את הרכיב בממשק המשתמש של Edge, צריך להשתמש בגרסה של Edge עבור הענן הפרטי שממנו מתבצע השדרוג:
- מ-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
ייכשל.
עדכון לגבי אפס זמן השבתה
עדכון ללא זמן השבתה, או עדכון מתגלגל, מאפשר לעדכן את התקנת Edge בלי לקטוע את Edge.
ניתן לעדכן ללא זמן השבתה רק בהגדרה של 5 צמתים ומעלה.
המפתח לשדרוג ללא זמן השבתה הוא להסיר כל נתב, בזה אחר זה, ממאזן העומסים. לאחר מכן מעדכנים את הנתב ואת כל הרכיבים האחרים במכונה שבהם נמצא הנתב, ואז מוסיפים אותו בחזרה למאזן העומסים.
- מעדכנים את המכונות בסדר הנכון להתקנה לפי ההוראות במאמר סדר עדכון המכונה.
- כשיגיע הזמן לעדכן את הנתבים, בוחרים נתב אחד ומוודאים שלא ניתן לגשת אליו, כפי שמתואר בקטע יכולת הגעה של השרת (מעבד הודעות/נתב).
- עדכון הנתב שנבחר וכל שאר רכיבי Edge באותה מכונה שבה נמצא הנתב. בכל ההגדרות של Edge יוצג נתב ומעבד הודעות באותו צומת.
- מגדירים מחדש את הנתב נגיש.
- חוזרים על שלבים 2 עד 4 עבור שאר הנתבים.
- המשך בעדכון לכל המכונות שנותרו בהתקנה.
חשוב לבצע את הפעולות הבאות לפני ואחרי העדכון:
- בצומת המשולב של הנתב ומעבד ההודעות:
- לפני העדכון – מבצעים את הפעולות הבאות:
- מגדירים את הנתב כלא נגיש.
- מוודאים שלא ניתן לגשת למעבד ההודעות.
- לאחר העדכון – מבצעים את הפעולות הבאות:
- פותחים את מעבד ההודעות.
- מגדירים שהנתב נמצא בהישג יד.
- לפני העדכון – מבצעים את הפעולות הבאות:
- בצומתי נתב בודדים:
- לפני העדכון, צריך לוודא שהנתב לא נגיש.
- אחרי העדכון, מגדירים את הנתב נגיש.
- בצמתים נפרדים של מעבד ההודעות:
- לפני העדכון, צריך להפוך את מעבד ההודעות לבלתי נגיש.
- אחרי העדכון, אפשר לגשת למעבד ההודעות.
שימוש בקובץ תצורה שקט
עליך להעביר קובץ תצורה שקט לפקודת העדכון. קובץ התצורה השקטה צריך להיות זהה לקובץ שבו השתמשת כדי להתקין את Edge 4.19.06 או 4.50.00.
עדכון לגרסה 4.51.00 בצומת עם חיבור חיצוני לאינטרנט
כדי לעדכן את רכיבי Edge בצומת, יש לבצע את התהליך הבא:
- אם היא קיימת, משביתים את כל המשימות ב-
cron
שהוגדרו לבצע פעולת תיקון ב-Cassandra עד שהעדכון יושלם. - מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
- התקנה של
yum-utils
ואתyum-plugin-priorities
:sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
- אם מתקינים ב-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
- מורידים את קובץ
bootstrap_4.51.00.sh
Edge 4.51.00 אל/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
: קאסנדרהedge
: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgresldap
: פתיחת LDAPps
: postgresqlqpid
: qpiddsso
: Apigee SSO (אם התקנת SSO)ue
: ממשק משתמש חדש של Edgeui
: ממשק משתמש קלאסי של Edgezk
: מנהל/ת גן חיות
- configFile הוא אותו קובץ תצורה שבו השתמשתם להגדרת רכיבי Edge במהלך ההתקנה של 4.19.06 או 4.50.00.
אפשר להריץ את
update.sh
בכל הרכיבים על ידי הגדרת component כ-'all', אבל רק אם יש לכם פרופיל התקנה של Edge all-in-one (AIO) ב-Edge. לדוגמה:/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 מקומי' במאמר התקנת כלי השירות Edge apigee-setup.
- כדי להתקין את שירות API מקובץ .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
שימו לב שאתם כוללים בפקודה הזו את הנתיב לספריית ה-repos.
- בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם
- כדי להתקין את השירות API באמצעות שרת האינטרנט NGINX:
- מגדירים את שרת האינטרנט NGINX כפי שמתואר בקטע "התקנה מהמאגר באמצעות שרת האינטרנט של NGINX", במאמר התקנת כלי השירות של Edge apigee-setup.
- בצומת המרוחק, יש להוריד את קובץ 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
: קאסנדרהedge
: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgresldap
: פתיחת LDAPps
: postgresqlqpid
: qpiddsso
: Apigee SSO (אם התקנת SSO)ue
ממשק משתמש חדש של Edgeui
: ממשק משתמש קלאסי של Edgezk
: מנהל/ת גן חיות
- configFile הוא קובץ התצורה שהשתמשתם בו כדי להגדיר את רכיבי Edge במהלך ההתקנה של 4.19.06 או 4.50.00.
אפשר להריץ את
update.sh
בכל הרכיבים על ידי הגדרת component כ-'all', אבל רק אם יש לכם פרופיל התקנה של Edge all-in-one (AIO) ב-Edge. לדוגמה:/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 ו-ZoKeeper.
- בכל מכונה עם מספר רכיבי 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 צמתים
עדכן את הרכיבים הבאים להתקנה עצמאית עם שני צמתים:
לרשימת הטופולוגיות של Edge ומספרי הצמתים, אפשר לעיין בקטע טופולוגיות התקנה.
- עדכון של Cassandra ו-zoKeeper במחשב 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
- (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 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 ו-zoKeeper במכונות 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
- (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 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 ו-zoKeeper במכונות 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
- (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 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 ו-zoKeeper במכשירים 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
- (אם התקנת את Apigee SSO) עליך לעדכן את Apigee SSO במחשבים 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 ו-zoKeeper:
- במחשבים 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:
- (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO:
- מכונה 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
- קסנדרה
- qpidd, פס
- LDAP
- Edge, כלומר פרופיל "-c edge" בכל הצמתים שבסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתב.
- ממשק משתמש Edge (קלאסי או חדש)
apigee-adminapi
- כניסה יחידה (SSO) ב-Apigee
אחרי שמסיימים את העדכון, חשוב להפעיל מחדש את רכיב ממשק המשתמש של Edge בכל המכונות שבהן הוא פועל.