Edge for Private Cloud גרסה 4.17.09
אילו גרסאות Edge אפשר לעדכן לגרסה 4.17.09
באמצעות התהליך הזה אפשר לעדכן את Apigee Edge מגרסה 4.17.01.0x/4.17.05.0x ל-4.17.09.
אם מותקנת אצלכם גרסה של Edge בגרסה 4.16.01, קודם צריך לעבור לגרסה 4.16.01.x ואז לעדכן לגרסה 4.17.09.
מי יכול לבצע את העדכון
המשתמש שמריץ את העדכון צריך להיות זהה למשתמש שהתקין את Edge במקור, או למשתמש שפועל בתור root.
אחרי שמתקינים את ה-RPM של Edge, כל משתמש יכול להגדיר אותם.
אילו רכיבים צריך לעדכן
צריך לעדכן את כל רכיבי Edge. Edge לא תומך בהגדרה שמכילה רכיבים מכמה גרסאות.
הפצה אוטומטית של הגדרות הנכס
אם הגדרתם מאפיינים כלשהם על ידי עריכה של קובצי .properties ב-/opt/apigee/customer/application, ערכים אלה יישמרו עד העדכון.
נדרשת הוספה של פרמטר ההגדרה SMTPMAILFROM
Edge 4.17.05 הוסיף פרמטר נדרש חדש לקובץ התצורה שבו נעשה שימוש בהפעלת שרת SMTP. אם מעדכנים מ-4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה בעת הפעלת שרת ה-SMTP.
בגרסה 4.17.09 של API BaaS נוספה גם תמיכה בנכס SMTPMAILFROM. כשמעדכנים את BaaS של API מ-4.17.01 או מ-4.17.05, צריך להגדיר את SMTPMAILFROM בקובץ התצורה.
הפורמט של הפרמטר הזה:
SMTPMAILFROM="My Company <myco@company.com>"
עדכון דרישות מוקדמות
לפני שדרוג Apigee Edge, יש לעמוד בדרישות המוקדמות הבאות:
- גיבוי של כל הצמתים
לפני העדכון, מומלץ לבצע גיבוי מלא לכל הצמתים מטעמי בטיחות. מבצעים את הגיבוי בהתאם לגרסה הנוכחית של Edge.
כך תהיה לך תוכנית גיבוי למקרה שהעדכון לגרסה חדשה לא יפעל כמו שצריך. למידע נוסף על גיבוי, תוכלו לקרוא את המאמר גיבוי ושחזור. - מוודאים ש-Edge פועל
מוודאים ש-Edge פועל בזמן תהליך העדכון באמצעות הפקודה:
> /opt/apigee/apigee-service/bin/apigee-all status
מה עושים אם עדכון נכשל
אם העדכון נכשל, אפשר לנסות לתקן את הבעיה ולאחר מכן להפעיל שוב את update.sh. אפשר להריץ את העדכון כמה פעמים, והעדכון ימשיך מהמקום שבו הוא הפסיק.
אם הכשל מחייב להחזיר את העדכון לגרסה הקודמת, יש לעיין בתהליך החזרה לגרסה קודמת.
פרטי העדכון ביומן
כברירת מחדל, כלי השירות 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.17.01.
תהליך עדכון לגרסה 4.17.09 בצומת עם חיבור חיצוני לאינטרנט
כדי לעדכן את רכיבי Edge בצומת, יש לבצע את התהליך הבא:
- אם יש משימות של CRON שלא הוגדרו, צריך להשבית אותן לביצוע פעולת תיקון ב-Cassandra עד שהעדכון יושלם.
- מתחברים לצומת בתור הבסיס כדי להתקין את ה-RPM של Edge.
הערה: התקנת RPM מחייבת גישה לרמה הבסיסית, אבל אפשר להגדיר את Edge בלי גישה לרמה הבסיסית. - מתקינים את yum-utils ואת
yum-Plugin-priorities:
> sudo yum install yum-utils
> sudo yum install yum-Plugin-priorities - משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
- אם מתקינים ב-AWS, מריצים את הפקודה yum-configure-manager:
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional - מורידים את הקובץ של Edge מגרסה 4.17.09 bootstrap_4.17.09.sh אל bootstrap_4.17.09.sh:
> curl https://software.apigee.com/shoestrap_4.17.09.sh -o /tmp/shoestrap_4.17. - מתקינים את הכלי ואת יחסי התלות של apigee-service 4.17.09:
> sudo bash /tmp/shoestrap_4.17.09.sh apigeeuser=uName apigeepassword=uName
כאשר uName הוא שם המשתמש והסיסמה שקיבלת. אם לא תשמיטו את 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 - מעדכנים את כלי העזר apigee-provision:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision update - מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "עדכון המכונה" שבהמשך:
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
הדרישה היחידה בקובץ התצורה היא שקובץ התצורה צריך להיות נגיש או קריא למשתמש.
השתמשו באפשרות '-c' כדי לציין את הרכיב שיש לעדכן. רשימת הרכיבים האפשריים כוללת:
ldap = OpenLDAP
cs = Cassandra
zk =, zokeeper
qpid = qpidd
ps = postgresql
edge =All Edge רכיבי Edge מלבד ממשק המשתמש של Edge ב-API: ממשק ה-API לניהול, מעבד הודעות, נתב, ממשק API של שרת QPID, ממשק API של מנהל הודעות, ממשק API של ממשק API עבור ממשק API של ניהול, ממשק API של ממשק API
התקנת ממשק API של ממשק API
ו-API של ממשק API עבור ממשק API של Edge
qpid = qpidd
ps = postgresql
edge =כל רכיבי Edge למעט ממשק משתמש של Edge בממשק API: ממשק API לניהול, מעבד הודעות, נתב, ממשק API של שרת QPID, עדכון API
ו-API של ממשק API של Edge
- בודקים את העדכון על ידי הרצת כלי השירות לאימות ממשק ה-API בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.
כדי לבטל את העדכון מאוחר יותר, יש להשתמש בהליך שמתואר בתהליך החזרה לגרסה קודמת.
הליך לעדכון ממאגר מקומי ל-4.17.09
אם צמתים של Edge נמצאים מאחורי חומת אש, או שהגישה שלהם למאגר Apigee באינטרנט אסורה בדרך אחרת, ניתן לבצע את העדכון ממאגר מקומי או משיקוף של המאגר של Apigee.
אחרי שיוצרים מאגר מקומי של Edge, יש שתי אפשרויות לעדכון Edge מהמאגר המקומי:
- יוצרים קובץ .tar של המאגר, מעתיקים את קובץ ה- .tar לצומת ואז מעדכנים את Edge מקובץ ה- .tar.
- מתקינים שרת אינטרנט בצומת עם המאגר המקומי כדי שצמתים אחרים יוכלו לגשת אליו. Apigee מספקת לך את שרת האינטרנט של Nginx, או שתוכל להשתמש בשרת אינטרנט משלך.
כדי לבצע עדכון ממאגר מקומי של 4.17.09:
- יוצרים מאגר מקומי בגרסה 4.17.09 כמו שמתואר ב'יצירת מאגר Apigee מקומי' במאמר התקנת כלי השירות Edge apigee-setup.
הערה: אם כבר יש לכם מאגר 4.17.01/4.17.05, תוכלו להוסיף לו את המאגר 4.17.09 כמו שמתואר ב'עדכון מאגר Apigee מקומי' בהתקנת כלי ההגדרה של Edge apigee. -
כדי להתקין את שירות ה-API מקובץ .tar:
- בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
> /opt/apigee/apigee-service/bin/apigee-miror apigee package - מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
- בצומת החדש, מבטלים את קידוד הקובץ לספרייה /tmp:
> tar -xzf apigee-4.17.09.tar.gz
פקודה זו יוצרת ספרייה חדשה בשם repos, בספרייה שמכילה את קובץ ה- .tar. לדוגמה: /tmp/repos. - מתקינים את תוכנת השירות ואת יחסי התלות של Edge apigee-service from /tmp/repos:
> sudo bash /tmp/repos/shoestrap_4.17.09.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
שימו לב שאתם כוללים את הנתיב למאגר ה-repos.
- בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.09.tar.gz:
-
כדי להתקין את השירות API באמצעות שרת האינטרנט של Nginx:
- מגדירים את שרת האינטרנט של Nginx כפי שמתואר במאמר 'התקנה מהמאגר באמצעות שרת האינטרנט של Nginx' במאמר התקנת כלי השירות Edge apigee-setup.
- בנקודת הצומת המרוחקת, מורידים את הקובץ Edge bootstrap_4.17.09.sh מהקובץ /tmp/shoestrap_4.17.09.sh:
bootstrap_4.17.09.sh
- בצומת המרוחק, מתקינים את כלי העזר ויחסי התלות של שירות Edge apigee:
> sudo bash /tmp/shoestrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord:http
כאשר שם המשתמש apigeepassword=pWord:פרוטוקול api:
- משתמשים ב-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 - מריצים את תוכנית השירות לעדכון בצמתים לפי הסדר שמתואר בקטע 'סדר העדכון של המכונה' שבהמשך:
> /opt/apigee/apigee-setup/bin/update.sh -c element -f configFile
הדרישה היחידה בקובץ התצורה היא שקובץ התצורה צריך להיות נגיש או קריא למשתמש ה-API.
השתמשו באפשרות '-c' כדי לציין את הרכיב שיש לעדכן. רשימת הרכיבים האפשריים כוללת:
ldap = OpenLDAP
cs = Cassandra
zk =, zokeeper
qpid = qpidd
ps = postgresql
edge =All Edge רכיבי Edge מלבד ממשק המשתמש של Edge ב-API: ממשק ה-API לניהול, מעבד הודעות, נתב, ממשק API של שרת QPID, ממשק API של מנהל הודעות, ממשק API של ממשק API עבור ממשק API של ניהול, ממשק API של ממשק API
התקנת ממשק API של ממשק API
ו-API של ממשק API עבור ממשק API של Edge
qpid = qpidd
ps = postgresql
edge =כל רכיבי Edge למעט ממשק משתמש של Edge בממשק API: ממשק API לניהול, מעבד הודעות, נתב, ממשק API של שרת QPID, עדכון API
ו-API של ממשק API של Edge
- בודקים את העדכון על ידי הרצת כלי השירות לאימות ממשק ה-API בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.
כדי לבטל את העדכון מאוחר יותר, יש להשתמש בהליך שמתואר בתהליך החזרה לגרסה קודמת.
סדר העדכון של המכשיר
הסדר שבו מעדכנים את המכונות בהתקנת Edge הוא חשוב. השיקולים החשובים ביותר לעדכון הם:
- לפני עדכון של צמתים אחרים, עליך לעדכן את כל הצמתים של Cassandra ו-ZoKeeper.
- לכל מכונה עם מספר רכיבי Edge (שרת ניהול, מעבד הודעות, נתב, שרת QPID אבל לא שרת Postgres), יש להשתמש באפשרות ' -c edge' כדי לעדכן את כולם בו-זמנית.
- אם שלב מציין שצריך לבצע אותו במספר מכונות, מבצעים אותו בסדר המכונה שצוין.
- אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את האפשרות ' -c edge'.
להתקנה עצמאית עם מארח אחד
- אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - עדכון של Cassandra ו-zoKeeper:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - עדכון Qpid ו-Postgres:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile - הפעלה של postgresql:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - לעדכון LDAP:
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - מעדכנים את שאר רכיבי Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - עדכון ממשק המשתמש של Edge:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
להתקנה עצמאית עם 2 מארחים
בדף טופולוגיות התקנה מופיעה רשימה של הטופולוגיות של Edge ומספרי הצמתים.
- אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - יש לעדכן את 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 - מפעילים את postgresql במכונה 2:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - עדכון 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
להתקנה של אשכולות עם 5 מארחים
בדף טופולוגיות התקנה מופיעה רשימה של הטופולוגיות של Edge ומספרי הצמתים.
- אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - יש לעדכן את 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 - מפעילים את postgresql במכונה 4:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - חוזרים על שלבים 3 ו-4 במכונה 5.
- עדכון 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 - עדכון ממשק המשתמש במחשב 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
להתקנה באשכולות עם 9 מארחים
בדף טופולוגיות התקנה מופיעה רשימה של הטופולוגיות של Edge ומספרי הצמתים.
- אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - עדכון של Cassandra ו-zoKeeper במכונה 1, 2 ו-3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - עדכון Qpid ו-Postgres במחשב 6:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile - מפעילים את postgresql במכונה 6:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - חוזרים על שלבים 3 ו-4 במכונה 7.
- עדכון 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 - עדכון ממשק המשתמש במחשב 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
להתקנה באשכולות של 13 מארחים
בדף טופולוגיות התקנה מופיעה רשימה של הטופולוגיות של Edge ומספרי הצמתים.
- אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - עדכון של Cassandra ו-zoKeeper במכונה 1, 2 ו-3:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - עדכון Qpid ו-Postgres במחשב 12:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile - מפעילים את postgresql במכונה 12:
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - חוזרים על שלבים 3 ו-4 במכונה 13.
- עדכון 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 - עדכון ממשק המשתמש במחשב 6 ו-7:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
להתקנה של אשכולות עם 12 מארחים
בדף טופולוגיות התקנה מופיעה רשימה של הטופולוגיות של Edge ומספרי הצמתים.
- אם בחרת לעדכן מגרסה 4.17.01, צריך להגדיר את SMTPMAILFROM בקובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - מעדכנים את Cassandra ו-zoKeeper:
- במכונות 1, 2 ו-3 ב-Data Center 1:
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - במכונות 7, 8 ו-9 ב-Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- במכונות 1, 2 ו-3 ב-Data Center 1:
- מעדכנים את qpidd:
- מכונות 4, 5 במרכז הנתונים 1
- מעדכנים את qpidd במכונה 4:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - חוזרים על שלב 1 במכונה 5.
- מעדכנים את qpidd במכונה 4:
- מכונות 10, 11 במרכז הנתונים 2
- מעדכנים את qpidd במכונה 10:
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - חוזרים על שלב 1 במכונה 11.
- מעדכנים את qpidd במכונה 10:
- מכונות 4, 5 במרכז הנתונים 1
-
עדכון postgresql:
-
Machines 6 in Data Center 1
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start -
Machines 12 in Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
-
- עדכון LDAP:
- מכונות 1 ב-Data Center 1
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - מכונות 7 ב-Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- מכונות 1 ב-Data Center 1
- מעדכנים את רכיבי Edge:
- מכונות 4, 5, 6, 1, 2, 3 ב-Data Center 1
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - מכונות מספר 10, 11, 12, 7, 8, 9 ב-Data Center 2
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- מכונות 4, 5, 6, 1, 2, 3 ב-Data Center 1
- עדכון ממשק המשתמש:
- מכונה 1 ב-Data Center 1:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile - מכונה 7 ב-Data Center 2:
> /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- מכונה 1 ב-Data Center 1:
להתקנת BaaS של API עם 7 מארחים
- מגדירים את SMTPMAILFROM בקובץ התצורה. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - עדכון Cassandra בגרסאות 5, 6 ו-7 של מכונות 5, 6 ו-7:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile -
עדכון של ElasticSearch ו-API BaaS Stack במחשב 1, 2 ו-3:
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile - עדכון של API BaaS Portal במחשב 4:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
להתקנת BaaS של API עם 10 מארחים
- מגדירים את SMTPMAILFROM בקובץ התצורה. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - עדכון Cassandra בגרסאות 8, 9 ו-10:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - עדכון ElasticSearch במחשב 1, 2 ו-3:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - עדכון של API BaaS Stack במכונה 4, 5 ו-6:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - עדכון של API BaaS Portal במחשב 7:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
להתקנת Baas של שני מרכזי נתונים של API
כדי לעשות את זה, צריך לעדכן את צומתי Cassandra בשני מרכזי הנתונים. אם בחרת לשתף את צומתי Cassandra עם Edge, בדרך כלל הצמתים האלה מתעדכנים כחלק מעדכון Edge.
- מגדירים את SMTPMAILFROM בקובצי התצורה. הפורמט של הפרמטר הזה הוא:
SMTPMAILFROM="My Company <myco@company.com>" - צריך לעדכן את מרחבי המפתח של Cassandra בגורם השכפול הנכון לשני מרכזי הנתונים. צריך
להריץ את השלב הזה פעם אחת בלבד בכל שרת של Cassandra באחד ממרכזי הנתונים:
הערה: הפקודות שלמטה מגדירות את גורם השכפול כ-"3", ומציינת שלושה צומתי Cassandra באשכול. יש לשנות את הערך הזה לפי הצורך בהתקנה.- מפעילים את הכלי Cassandra cqlsh:
> /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP - מפעילים את פקודות ה-CQL הבאות בהנחיה cqlsh> כדי להגדיר את רמות
השכפול של Cassandra keyspaces:
- cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH + שכפול = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- cqlsh> ALTER KEYSPACE "Apigee_Baas" WITHקונסולה = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- cqlsh> ALTER KEYSPACE "Apigee_Baas_Locks" WITH העתק = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- cqlsh> ALTER KEYSPACE "system_traces" WITH העתק = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH + שכפול = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3','dc-2': '3' };
- מציגים את מרחבי המפתחות באמצעות הפקודה:
cqlsh> select * from system.schema_keyspaces; - יציאה מ-cqlsh:
cqlsh> exit
- מפעילים את הכלי Cassandra cqlsh:
- (רק אם לא עדכנת את Cassandra כחלק מעדכון Edge) עדכון צומתי Cassandra במרכז נתונים 1, מכשיר אחד בכל פעם:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - (רק אם לא עדכנת את Cassandra כחלק מעדכון Edge) עליך לעדכן את צומתי Cassandra במרכז נתונים 2, במכונה אחת בכל פעם:
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - יש לעדכן את ElasticSearch במחשבים במרכז נתונים 1, במכשיר אחד בכל פעם:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - יש לעדכן את ElasticSearch במחשבים במרכז נתונים 2, במכשיר אחד בכל פעם:
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - עדכון של API BaaS Stack במכונות במרכז נתונים 1, מכונה אחת בכל פעם:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - עדכון של API BaaS Stack במכונות במרכז נתונים 2, מכונה אחת בכל פעם:
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - עדכון של API BaaS Portal במכונות במרכז נתונים 1, מכשיר אחד בכל פעם:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile - עדכון של API BaaS Portal במכונות במרכז נתונים 2, מכונה אחת בכל פעם:
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile - עדכון הערכים של מרחב המפתחות של BaaS. צריך להגדיר את מרחב המפתחות האלה לשכפול בזמן ההתקנה, אבל לא בזמן הריצה. הסרת השכפול שומרת גם על הזיכרון של Cassandra.
צריך להריץ את השלב הזה פעם אחת בלבד בכל שרת של Cassandra באחד ממרכזי הנתונים:- מפעילים את הכלי Cassandra cqlsh:
> /opt/apigee/apigee-cassandra/bin/cqlsh cassandraIP - מפעילים את פקודות ה-CQL הבאות כדי להגדיר את רמות הרפליקציה ב-Keyspaces
של Cassandra:
- cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_1" WITH בנייד = { 'class': 'NetworkTopologyStrategy', 'dc-1': '3' };
- cqlsh> ALTER KEYSPACE "Apigee_Baas_dc_2" WITH במצב שכפול = { 'class': 'NetworkTopologyStrategy', 'dc-2': '3' };
- מציגים את מרחבי המפתחות באמצעות הפקודה:
cqlsh> בוחרים * מתוך system.schema_keyspaces; - יציאה מ-cqlsh:
cqlsh> exit
- מפעילים את הכלי Cassandra cqlsh:
להתקנה לא סטנדרטית
אם אין לכם התקנה לא סטנדרטית, צריך לעדכן את רכיבי Edge לפי הסדר הבא:
- ZooKeeper
- קסנדרה
- qpidd, פס
- LDAP
- Edge, כלומר פרופיל "-c edge" בכל הצמתים שבסדר: צמתים עם שרת Qpid,
שרת Postgres, שרת ניהול, מעבד הודעות ונתב.
הערה: אם בצומת יש גם שרת Qpid וגם שרת Postgres, מריצים את שלב הפרופיל "-c edge". - ממשק המשתמש של Edge