עדכון של Apigee Edge 4.16.09 ל-4.17.05

Edge for Private Cloud גרסה 4.17.05

אילו גרסאות של Edge אפשר לעדכן ל-4.17.05

באמצעות התהליך הזה אפשר לעדכן את Apigee Edge מגרסה 4.16.09.0x ל-4.17.05.

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

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

המשתמש שמריץ את העדכון צריך להיות זהה למשתמש שהתקין את Edge, או משתמש שפועל ברמה הבסיסית (root).

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

אילו רכיבים צריך לעדכן

צריך לעדכן את כל הרכיבים של Edge. דפדפן Edge לא תומך בהגדרה שמכילה רכיבים מכמה גרסאות.

נדרש שדרוג ל-Qpid 1.35

הגרסה הזו מכילה עדכון נדרש ל-Qpid 1.35. במסגרת עדכון צומת Qpid, צריכים:

  • מונעים באופן זמני מנתבים וממעבדי הודעות לכתוב לצומת Qpid באמצעות חוסם את היציאה 5672 בצומת Qpid. אפשר להשתמש בפקודה הבאה כדי לחסום את השקע הזה ב- צומת ה-Qpid:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  • יש להמתין עד שתור ה-Qpid יתרוקן מההודעות כדי לוודא שצומת ה-Qpid עיבד את כל הודעות לפני העדכון. השתמשו בפקודה הבאה כדי לוודא שתור ההודעות ב-Qpid ריק:
    > qpid-stat -q
  • מעדכנים את הצומת Qpid.
  • ביטול החסימה של יציאה 5672 בצומת Qpid כדי לאפשר גישה מנתבים וממעבדי הודעות. אפשר להשתמש בפקודה הבאה כדי לבטל את חסימת השקע הזה:
    > sudo iptables -F

    שימו לב שאם משתמשים בטבלאות iptable בכללים אחרים, אפשר להשתמש באפשרות -D כדי להפוך שינוי ספציפי:
    > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP

התהליך הזה מתואר בפירוט בהמשך עבור כל טופולוגיה של Edge.

נדרש כדי להפעיל מאגר EPEL

צריך להפעיל חבילות נוספות עבור Enterprise Linux (או EPEL) כדי להתקין או לעדכן את Edge. הפקודה שבה משתמשים תלויה בגרסת RedHat/CentOS:

  • ל-RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • ל-RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

חובה להוסיף של SMTPMAILFROM פרמטר הגדרה

Edge 4.17.05 הוסיף פרמטר נדרש חדש לקובץ התצורה שמשמש להפעלה של התכונה שרת SMTP. עכשיו צריך להגדיר את האפשרות SMTPMAILFROM בקובץ התצורה. בעת הפעלת שרת ה-SMTP. הפורמט של הפרמטר הזה:

SMTPMAILFROM="My Company <myco@company.com>"

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

אפשר לשלב שירות ספרייה חיצוני בענן פרטי קיים של Apigee Edge בתהליך ההתקנה. התכונה הזו מיועדת לפעול עם כל שירות ספריות שתומך ב-LDAP, כמו Active Directory, OpenLDAP ועוד. פתרון LDAP חיצוני מאפשר למערכת לאדמינים שינהלו פרטי כניסה של משתמשים משירות ניהול ספריות מרכזי, חיצוניים למערכות כמו Apigee Edge שמשתמשות בהם.

מידע נוסף זמין במאמר טופולוגיות התקנה.

כשהאימות החיצוני מופעל, רוב הלקוחות משתמשים בחשבון SAM של Active Directory. השדה name בתור שם המשתמש לאימות, במקום כתובת אימייל שמשמשת את שרת Edge OpenLDAP.

אם שילבתם שירות ספריות חיצוני, יש להוסיף את השורה הבאה אל את קובץ התצורה שלך כשמעדכנים את Edge לגרסה 4.17.05:

IS_EXTERNAL_AUTH="true"

השורה הזו מגדירה ש-Edge יתמוך בשם חשבון ולא בכתובת אימייל, שם משתמש.

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

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

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

שימו לב לדרישות המוקדמות הבאות לפני שדרוג Apigee Edge:

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

    כך תהיה לכם תוכנית גיבוי, למקרה שהעדכון לגרסה חדשה לא לא תקינה. למידע נוסף על הגיבוי, ראו גיבוי ושחזור.
  • מוודאים ש-Edge פועל
    מוודאים ש-Edge פועל בזמן תהליך העדכון באמצעות הפקודה:

    &gt; /opt/apigee/apigee-service/bin/apigee-all status

טיפול בעדכון שנכשל

במקרה של עדכון נכשל, אפשר לנסות לתקן את הבעיה ולאחר מכן להריץ update.sh. שוב. אפשר להריץ את העדכון כמה פעמים, והוא ימשיך מהמקום שבו נעצר מושבתת.

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

פרטי העדכון ביומן

כברירת מחדל, הקוד update.sh כלי השירות כותב פרטי יומן ל:

/opt/apigee/var/log/apigee-setup/update.log

אם למשתמש שמפעיל את הכלי update.sh אין גישה אל באותה הספרייה, נכתב את היומן בספרייה /tmp כקובץ בשם update_username.log.

אם למשתמש אין גישה ל-/tmp, הכלי /tmp ייכשל.

עדכון ללא הגבלת זמן

עדכון ללא השבתה או עדכון בהדרגה (rolling), מאפשרים לכם לעדכן את התקנת Edge בלי מורידים את Edge.

אפשר לבצע עדכון של אפס זמן השבתה רק בהגדרה של 5 צמתים ומעלה.

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

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

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

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

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

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

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

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

  1. צריך להשבית את כל משימות CRON שהוגדרו לביצוע פעולת תיקון ב-Cassandra, אם יש כאלה עד לסיום העדכון.
  2. כדי להתקין את ההכנסות לאלף חשיפות ב-Edge, צריך להתחבר לצומת בתור הרמה הבסיסית (root).
    הערה: התקנת RPM מחייבת גישה לרמה הבסיסית (root), אבל אפשר להשתמש ב-Edge ללא גישה לרמה הבסיסית (root).
  3. השבתת SELinux כפי שמתואר בהתקנה כלי ההגדרה של Edge apigee-setup.
  4. מורידים את קובץ bootstrap_4.17.05.sh ב-Edge 4.17.05 אל bootstrap_4.17.05.sh:
    > תלתל https://software.apigee.com/shoestrap_4.17.05.sh -o /tmp/shoestrap_4.17.05.sh
  5. מתקינים את כלי השירות apigee-service 4.17.05 ו- של יחסי התלות:
    > sudo bash /tmp/shoestrap_4.17.05.sh apigeeuser=uName apigeepassword=pWord

    כאשר uName:pWord הם שם המשתמש והסיסמה שקיבלתם ב-Apigee. אם משמיטים את המילה pWord, תתבקשו להזין אותה.

    כברירת מחדל, מנהל ההתקנה בודק אם התקנתם את Java 1.8. אם לא, יתקין אותו בשבילך. משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל התקנת Java. JAVA_FIX הפונקציה מקבלת את הערכים הבאים:

    I = התקנת OpenJDK 1.8 (ברירת מחדל)
    C = המשך בלי להתקין Java
    שאלה = יציאה. כדי להשתמש באפשרות הזו, תצטרכו להתקין Java בעצמכם.
  6. (CentOS-6.x ו-RedHat-6.x בלבד) בכל צמתים של Qpid, מריצים את הפקודה כדי להוריד את גרסת ה-Qpid הנכונה:
    &gt; יאמי התקנה apigee-qpidd --disablerepo=epel
  7. להשתמש ב-apigee-service כדי לעדכן את apigee-setup תוכנית שירות:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  8. עדכון של apigee-validate בשרת הניהול:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validator update
  9. עדכון של apigee-provision תוכנית שירות:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. מריצים את כלי העדכון בצמתים לפי הסדר הבא שמוצג בקטע סדר המכונה עדכון" מתחת:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    הדרישה היחידה בקובץ התצורה היא שקובץ התצורה יהיה נגיש או קריא באמצעות ה-apigee משתמש.

    משתמשים באפשרות ' -c' כדי לציין את הרכיב שרוצים לעדכן. רשימת האפשרויות הרכיבים כוללים:
    ldap = OpenLDAP
    cs = Cassandra
    zk = הזואומרים
    qpid = qpidd
    ps = postgresql
    dge =כל רכיבי Edge חוץ מממשק משתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
    ui = ממשק משתמש של Edge
    all = עדכון כל הרכיבים ב- מחשב (לשימוש רק בפרופיל התקנה של ממשק Aio ב-Edge או בהתקנת API BaaS asa) פרופיל)
    e = ElasticSearch
    b = API BaaS Stack
    p = פורטל API BaaS
    ebp = ElasticSearch, API BaaS מקבץ ופורטל BaaS של API באותו צומת
  11. בודקים את העדכון על ידי הרצת הכלי לאימות apigee בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.

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

נוהל עדכון לגרסה 4.17.05 מרשת מקומית מאגר

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

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

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

כדי לעדכן ממאגר 4.17.05 מקומי:

  1. יוצרים מאגר 4.17.05 מקומי כפי שמתואר ב"יצירת מאגר Apigee מקומי" מתקינים את כלי ההגדרה של Edge apigee-setup.
    הערה: אם כבר יש לכם מאגר 4.16.09 קיים, תוכלו להוסיף את 4.17.05 מאגר שלו כפי שמתואר ב'עדכון מאגר Apigee מקומי' בהתקנת כלי ההגדרה של Edge apigee-setup.
  2. כדי להתקין את apigee-service מקובץ .tar:
    1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, העתקה אל את הספרייה /tmp צומת חדש.
    3. בצומת החדש, מסירים את הקובץ לספריית /tmp:
      &gt; tar -xzf apigee-4.17.05.tar.gz

      הפקודה הזו יוצרת ספרייה חדשה בשם repos, בספרייה שמכילה את קובץ ה- .tar חדש. לדוגמה, /tmp/repos.
    4. התקנה של כלי העזר של Edge apigee-service ויחסי תלות מ- /tmp/repos:
      &gt; sudo bash /tmp/repos/shoestrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      שימו לב שהפקודה הזו כוללת את הנתיב לספריית ה-repos.
  3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
    1. הגדרת שרת האינטרנט Nginx כפי שמתואר ב"התקנה מהמאגר באמצעות ה-Nginx webserver&quot; בדף Install the Edge הכלי apigee-setup.
    2. בצומת המרוחק, מורידים את קובץ bootstrap_4.17.05.sh של Edge אל /tmp/shoestrap_4.17.05.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/shoestrap_4.17.05.sh

      כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם למעלה המאגר ו-remoteRepo הוא כתובת ה-IP או שם ה-DNS של מאגר מאגר.
    3. בצומת המרוחק, מתקינים את כלי השירות ואת יחסי התלות של Edge apigee-service:
      &gt; sudo bash /tmp/shoestrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      כאשר uName:pWord הם שם המשתמש והסיסמה במאגר.
  4. להשתמש ב-apigee-service כדי מעדכנים את כלי ההגדרה של apigee-setup:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. עדכון של apigee-validate בשרת הניהול.
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-authentic update
  6. עדכון של apigee-provision תוכנית שירות:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. מריצים את הכלי לעדכון בצמתים לפי הסדר הבא שמוצג בקטע 'הזמנת המכונה' עדכון" מתחת:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -cComponent -f configFile

    הדרישה היחידה בקובץ התצורה היא שקובץ התצורה יהיה נגיש או קריא באמצעות ה-apigee משתמש.

    משתמשים באפשרות ' -c' כדי לציין את הרכיב שרוצים לעדכן. רשימת האפשרויות הרכיבים כוללים:
    ldap = OpenLDAP
    cs = Cassandra
    zk = הזואומרים
    qpid = qpidd
    ps = postgresql
    dge =כל רכיבי Edge חוץ מממשק משתמש של Edge: שרת ניהול, מעבד הודעות, נתב, שרת QPID, שרת Postgres
    ui = ממשק משתמש של Edge
    all = עדכון כל הרכיבים ב- מחשב (לשימוש רק בפרופיל התקנה של ממשק Aio ב-Edge או בהתקנת API BaaS asa) פרופיל)
    e = ElasticSearch
    b = API BaaS Stack
    p = פורטל API BaaS
    ebp = ElasticSearch, API BaaS מקבץ ופורטל BaaS של API באותו צומת
  8. בודקים את העדכון על ידי הרצת הכלי לאימות apigee בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.

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

סדר עדכון המכונה

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

  • עליך לעדכן את כל הצמתים של Cassandra ו-zoKeeper לפני עדכון של רכיבים צמתים אחרים.
  • לכל מכונה עם מספר רכיבי Edge (שרת ניהול, מעבד הודעות, נתב, שרת QPID אבל לא שרת Postgres), שימוש בקצה '-c' אפשרות לעדכן את כולם בכל כמעט באותה עת.
  • אם שלב מציין שצריך לבצע אותו במספר מכונות, צריך לבצע אותו בסדר המכונה הספציפי.
  • אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את " -c" קצה" כאפשרות.
  • (CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי Qpid עם לחיבור חיצוני לאינטרנט, יש לוודא שהרצת את הפקודה הבאה כדי להוריד את גרסת ה-Qpid הנכונה כפי שמוצג למעלה:
    &gt; יאמי התקנה apigee-qpidd --disablerepo=epel

לחשבון עצמאי של מארח אחד התקנה

  1. מגדירים את SMTPMAILFROM בקובץ קובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="החברה שלי <myco@company.com>"
  2. עדכון של Cassandra ו-ZooKeeper:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. הגדרת הכלל הבא של טבלאות IP:
    &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  4. בדיקת תור ההודעות ב-Qpid:
    &gt; qpid-stat -q

    ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אין לך אפשרות לשדרג את Qpid עד שהוא יסיים לעבד את כל ההודעות.
  5. עדכון qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מכשירי אידוי נשלפים:
    &gt; sudo iptables -F
  7. עדכון postgresql:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. התחלת postgresql:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. עדכון LDAP:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. מעדכנים את שאר רכיבי Edge:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. עדכון ממשק המשתמש של Edge:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

לחשבון עצמאי של 2 מארחים התקנה

כאן אפשר למצוא את רשימת טופולוגיות של Edge. באמצעות טופולוגיות ומספרי צמתים.

  1. מגדירים את SMTPMAILFROM בקובץ קובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="החברה שלי <myco@company.com>"
  2. עדכון Cassandra ו-ZooKeeper במכונה 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. הגדרת הכלל הבא של טבלאות IP במכונה 2:
    &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  4. בדיקת תור ההודעות ב-Qpid במכונה 2:
    &gt; qpid-stat -q

    ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אין לך אפשרות לשדרג את Qpid עד שהוא יסיים לעבד את כל ההודעות.
  5. מעדכנים את qpidd ב- מכונה 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מכשירי iptable במכונה 2:
    &gt; sudo iptables -F
  7. עדכון Postgresql במכונה 2:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. התחלת Postgresql במכונה 2:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. עדכון LDAP במכונה 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. עדכון רכיבי Edge במכונה 2 ו-1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. עדכון ממשק המשתמש במכונה 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

לאשכולות של 5 מארחים התקנה

כאן אפשר למצוא את רשימת טופולוגיות של Edge. באמצעות טופולוגיות ומספרי צמתים.

  1. מגדירים את SMTPMAILFROM בקובץ קובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="החברה שלי <myco@company.com>"
  2. עדכון Cassandra ו-ZooKeeper במכונה 1, 2 ו-3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. הגדרת הכלל הבא של טבלאות IP במכונה 4:
    &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  4. בדיקת תור ההודעות ב-Qpid במכונה 4:
    &gt; qpid-stat -q

    ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אין לך אפשרות לשדרג את Qpid עד שהוא יסיים לעבד את כל ההודעות.
  5. מעדכנים את qpidd ב- מכונה 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מכשירי IPtable במכונה 4:
    &gt; sudo iptables -F
  7. חוזרים על שלבים 3 עד 6 במכשיר 5.
  8. עדכון Postgresql במכונה 4:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. התחלת Postgresql במכונה 4:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. חוזרים על שלבים 8 ו-9 במכונה 5.
  11. עדכון LDAP במכונה 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. עדכון רכיבי Edge במכונה 4, 5, 1, 2, 3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. עדכון ממשק המשתמש במכונה 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

לאשכולות של 9 מארחים התקנה

כאן אפשר למצוא את רשימת טופולוגיות של Edge. באמצעות טופולוגיות ומספרי צמתים.

  1. מגדירים את SMTPMAILFROM בקובץ קובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="החברה שלי <myco@company.com>"
  2. עדכון Cassandra ו-ZooKeeper במכונה 1, 2 ו-3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. הגדרת הכלל הבא של טבלאות IP במכונה 6:
    &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  4. בדיקת תור ההודעות ב-Qpid במכונה 6:
    &gt; qpid-stat -q

    ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אין לך אפשרות לשדרג את Qpid עד שהוא יסיים לעבד את כל ההודעות.
  5. מעדכנים את qpidd ב- מכונה 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מכשירי IPtable במכונה 6:
    &gt; sudo iptables -F
  7. חוזרים על שלבים 3 עד 6 במכונה 7.
  8. עדכון Postgresql במכונה 6:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. התחלת Postgresql במכונה 6:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. חוזרים על שלבים 8 ו-9 במכונה 7.
  11. עדכון LDAP במכונה 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. צריך לעדכן את רכיבי Edge במכונה 6, 7, 8, 9, 1, 4 ו-5 לפי הסדר הזה:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. עדכון ממשק המשתמש במכונה 1:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

לאשכולות של 13 מארחים התקנה

כאן אפשר למצוא את רשימת טופולוגיות של Edge. באמצעות טופולוגיות ומספרי צמתים.

  1. מגדירים את SMTPMAILFROM בקובץ קובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="החברה שלי <myco@company.com>"
  2. עדכון Cassandra ו-ZooKeeper במכונה 1, 2 ו-3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. הגדרת הכלל הבא של טבלאות IP במכונה 12:
    &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  4. בדיקת תור ההודעות ב-Qpid במחשב 12:
    &gt; qpid-stat -q

    ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אין לך אפשרות לשדרג את Qpid עד שהוא יסיים לעבד את כל ההודעות.
  5. מעדכנים את qpidd ב- מכונה 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מכשירי IPtable במכונה 12:
    &gt; sudo iptables -F
  7. חוזרים על שלבים 3 עד 6 במכונה 13.
  8. עדכון Postgresql במכונה 12:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  9. התחלת Postgresql במכונה 12:
    &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  10. חוזרים על שלבים 8 ו-9 במכונה 13.
  11. עדכון LDAP במכונה 4 ו-5:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  12. עדכון רכיבי Edge במכונה 12, 13, 8, 9, 6, 7, 10 ו-11 לפי הסדר הזה:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. עדכון ממשק המשתמש במכונה 6 ו-7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

לאשכולות של 12 מארחים התקנה

כאן אפשר למצוא את רשימת טופולוגיות של Edge. באמצעות טופולוגיות ומספרי צמתים.

  1. מגדירים את SMTPMAILFROM בקובץ קובץ התצורה אם הפעלת את SMTP ב-Edge. הפורמט של הפרמטר הזה הוא:
    SMTPMAILFROM="החברה שלי <myco@company.com>"
  2. עדכון של Cassandra ו-ZooKeeper:
    1. במכונות 1, 2 ו-3 במרכז הנתונים 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. במכונות 7, 8 ו-9 במרכז הנתונים 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. עדכון qpidd:
    1. מכונות 4 ו-5 במרכז הנתונים 1
      1. הגדרת הכלל הבא של טבלאות IP במכונה 4:
        &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
      2. בדיקת תור ההודעות ב-Qpid במכונה 4:
        &gt; qpid-stat -q

        ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אי אפשר לשדרג את Qpid עד שיסיים לעבד את כל ההודעות.
      3. עדכון qpidd במכונה 4:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. מכשירי IPtable במכונה 4:
        &gt; מכשירי sudo iptable -F
      5. חוזרים על שלבים 1 עד 4 במכונה 5.
    2. מכונות 10, 11 במרכז נתונים 2
      1. הגדרת הכלל הבא של טבלאות IP במכונה 10:
        &gt; sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
      2. בדיקת תור ההודעות ב-Qpid במכונה 10:
        &gt; qpid-stat -q

        ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אי אפשר לשדרג את Qpid עד שיסיים לעבד את כל ההודעות.
      3. עדכון qpidd במכונה 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. מכשירי IPtable במכונה 10:
        &gt; מכשירי sudo iptable -F
      5. חוזרים על שלבים 1 עד 4 במכונה 11.
  4. עדכון postgresql:
    1. מכונות 6 ב-Data Center 1
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. מכונות 12 ב-Data Center 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  5. עדכון LDAP:
    1. מכונות 1 ב-Data Center 1
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. מכונות 7 ב-Data Center 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. עדכון רכיבי Edge:
    1. מכונות 4, 5, 6, 1, 2, 3 במרכז הנתונים 1
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. מכונות 10, 11, 12, 7, 8, 9 במרכז הנתונים 2
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון ממשק המשתמש:
    1. מכונה 1 ב-Data Center 1:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. מכונה 7 ב-Data Center 2:
      &gt; /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

ל-BaaS API עם 7 מארחים התקנה

עליך להוסיף שני מאפיינים חדשים לקובץ התצורה לפני הרצת השדרוג תהליך:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

דוגמה של קובץ תצורה מלא מופיעה במאמר התקנת API BaaS.

צריך גם לוודא שיציאה 2551 פתוחה בכל צומתי ה-Stack כדי לקבל גישה מכל שאר המקבצים צמתים.

כאן אפשר למצוא את רשימת טופולוגיות של Edge. באמצעות טופולוגיות ומספרי צמתים.

  1. צריך לעדכן את Cassandra במכונה 5, 6 ו-7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  2. עדכון ElasticSearch ו-BaaS Stack במחשב 1, 2 ו-3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. עדכון פורטל API BaaS במחשב 4:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

ל-BaaS API עם 10 מארח התקנה

עליך להוסיף שני מאפיינים חדשים לקובץ התצורה לפני הרצת השדרוג תהליך:

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

דוגמה של קובץ תצורה מלא מופיעה במאמר התקנת API BaaS.

צריך גם לוודא שיציאה 2551 פתוחה בכל צומתי ה-Stack כדי לקבל גישה מכל שאר המקבצים צמתים.

כאן אפשר למצוא את רשימת טופולוגיות של Edge. באמצעות טופולוגיות ומספרי צמתים.

  1. צריך לעדכן את Cassandra במכונה 8, 9 ו-10:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. עדכון ElasticSearch במכונה 1, 2 ו-3:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. עדכון מקבץ BaaS של API במכונה 4, 5 ו-6:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. עדכון פורטל API BaaS במחשב 7:
    &gt; /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

בהתקנה לא סטנדרטית

אם יש לך התקנה לא סטנדרטית, עליך לעדכן את רכיבי Edge בתוספות הבאות הזמנה:

  1. ZooKeeper
  2. קסנדרה
  3. qpidd, ps
  4. LDAP
  5. קצה, שפירושו "קצה-c" פרופיל בכל הצמתים בסדר: צמתים עם שרת Qpid, שרת Postgres, שרת ניהול, מעבד הודעות ונתב.
    הערה: אם בצומת מותקן גם שרת Qpid וגם שרת Postgres, מריצים את ' -c dge' בפרופיל.
  6. ממשק המשתמש של Edge