עדכון של Apigee Edge 4.16.01/4.16.05 ל-4.17.05

Edge for Private Cloud גרסה 4.17.05

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

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

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

  • אפשר להעביר את Apigee Edge מגרסה 4.15.07 ל-4.16.01.
  • אם משתמשים בגרסה הקודמת של Edge לגרסה 4.15.07, קודם צריך לעבור לגרסה 4.15.07 ואז לגרסה 4.16.01.
    • כשמבצעים העברה מ-Edge מגרסה 4.14.04 ואילך: צריך לעבור ישירות לגרסה 4.15.07.
    • אם מבצעים מיגרציה מגרסה 4.14.01 של Edge, צריך קודם לעבור לגרסה 4.14.04 ואז לעבור לגרסה 4.15.07.

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

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

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

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

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

שדרוג לאחור של גן החיות אם מתבצע עדכון מ- 4.16.01

הגרסה של ה-RPM של גן החיות ב-Edge for Private Cloud 4.16.01 היא apigee-zookeeper-3.4.5-1.0.905.noarch.rpm. בגרסאות הבאות של Edge, הגרסה שלzokeeper שונתה חזרה ל-apigee-zookeeper-3.4.5-0.0.94x. הפעולה הזו מונעת מ-yum לשדרג אתzokeeper לגרסה מאוחרת יותר מ-4.16.01. הדרך לפתור את המצב הזה היא להריץ את הפקודה yum שדרוג לאחור apigee-zookeeper לפני עדכון שלzokeeper.

כדי לבדוק את הגרסה שלzokeeper, תוכלו להשתמש בפקודה הבאה:

> rpm -qa |grep apigee-zookeeper

אם פקודה זו מחזירה את הגרסה שלzokeeper:

apigee-zookeeper-3.4.5-1.0.905

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

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

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

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

לפני שדרוג 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 ייכשל.

נדרש שדרוג ל-Java JDK גרסה 8

בגרסה הזו של Edge נדרשת התקנה של Java JDK בגרסה 8 בכל צומתי העיבוד של Edge. אפשר להתקין את Oracle JDK 8 או OpenJDK 8. אם Java JDK 8 עדיין לא מותקן, סקריפט העדכון יכול להתקין אותו.

כחלק מהעדכון ל-Java 8, חלק מהצפנות TLS כבר לא זמינות ב-Oracle JDK 8. לרשימה המלאה, עיינו בקטע "Default Disabled Cipher suite" בכתובת http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html.

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

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

  • ל-RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-popup-7.noarch.rpm; rpm -ivh epel-release-release-7.noarch.rpm
  • ל-RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-release-6.noarch.rpm; rpm -ivh epel-release-popup-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 כשם המשתמש לאימות, במקום בכתובת אימייל שמשמשת את שרת Edge OpenLDAP.

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

IS_EXTERNAL_AUTH="true"

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

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

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

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

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

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

נדרש שדרוג ל-Postgres 9.4

המהדורה הזו של Edge כוללת שדרוג ל-Postgres 9.4. במסגרת השדרוג, כל נתוני Postgres יועברו ל-Postgres 9.4.

במהלך העדכון, בזמן שצומתי Postgres מושבתים לעדכון, נתוני הניתוח עדיין נכתבים בצומתי ה-Qpid. אחרי שצומתי Postgres מעדכנים וחוזרים למצב מקוון, נתוני הניתוח נשלחים לצומתי Postgres.

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

התקנת צומת Postgres חדש במצב המתנה

התהליך הזה יוצר שרת המתנה של Postgres בצומת חדש. חשוב להקפיד להתקין שרת המתנה חדש של Postgres לגרסה הקיימת של Edge (4.16.01 או 4.16.05), ולא לגרסה 4.17.05.

כדי להתקין את הגרסה האחרונה של Edge צריך להשתמש באותו קובץ תצורה שהשתמשתם בו כדי להתקין את הגרסה הנוכחית של Edge.

כדי ליצור צומת Postgres במצב המתנה:

  1. במאסטר הנוכחי של Postgres, עורכים את הקובץ /opt/apigee/customer/application/postgresql.properties כדי להגדיר את האסימון הבא. אם הקובץ לא קיים, יוצרים אותו:

    conf_pg_hba_Replication.אימות=host שכפול apigee existing_slave_ip/32 אמון\ \nשכפול מארח apigee new_slave_ip/32 נקודת האמינות

    כאשר כתובת ה-IP הנוכחית של שרת ה-IP היא הצומת הנוכחי, כתובת ה-IP החדשה וכתובת ה-IP החדשה היא כתובת ה-IP הנוכחית של שרת ה-IP.
  2. מפעילים מחדש את apigee-postgresql במאסטר של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql מחדש
  3. יש לוודא שצומת ההמתנה החדש נוסף על ידי הצגת הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במחשב הראשי. בקובץ הזה אמורות להופיע השורות הבאות:
    host שמשתמשות בשכפול apigee קיים_slave_ip/32 אמון
    שכפול מארח apigee new_slave_ip/32 trust
  4. מתקינים את שרת ההמתנה החדש של Postgres:
    1. עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge כדי לציין את הפרטים הבאים:

      # כתובת IP של המאסטר הנוכחי:
      PG_MASTER=192.168.56.103
      כתובת IP אחת של צומת ההמתנה החדש
      PG_STANDBY=192.168.56.102
    2. משביתים את SELinux כפי שמתואר בהתקנת כלי השירות Edge apigee-setup.
    3. מורידים את הקובץ Edge bootrap_4.16.05.sh אל /tmp/bootstrap_4.16.05.sh:
      > curl https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.shrap_4.16.05.shrap:
      כאשר מפעילים את הקובץ Edge.shrap :
      1.
    4. מתקינים את כלי השירות ואת יחסי התלות של שירות Edge apigee:
      > sudo bash /tmp/shoestrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. משתמשים בשירות apigee-service כדי להתקין את כלי העזר apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup התקנה
    6. מתקינים את Postgres:
      > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. בצומת ההמתנה החדש, מריצים את הפקודה הבאה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.

הוצאה משימוש של צומת Postgres

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

  1. מוודאים ש-Postgres פועל:
    > /opt/apigee/apigee-service/bin/apigee-all status

    אם Postgres לא פועל, יש להפעיל אותו:
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. מריצים את פקודת ה-cURL הבאה בצומת ההמתנה החדש כדי לקבל את ה-UUID של צומת ההמתנה החדש:
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    ה-UUID (מזהה ייחודי) של הצומת ' [eb4-8', ' אמור להופיע "[eb4-server' " בסוף "eb5-server:" "ebtype- "end' בסוף "9ebtype- "end' end5-server"

  3. כדי להפסיק את צומת ההמתנה החדש, מריצים את הפקודה הבאה בצומת ההמתנה החדש:
    > /opt/apigee/apigee-service/bin/apigee-all stop
  4. בצומת המאסטר של Postgres, עורכים את /opt/apigee/customer/application/postgresql.properties כדי להסיר את צומת ההמתנה החדש מ-conf_pg_hba_Replication.connected:
    conf_pg_hba_Replication.connected=host שכפול apigee existing_slave_ip/32 אמון.
  5. מפעילים מחדש את apigee-postgresql במאסטר של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql מחדש
  6. יש לוודא שצומת ההמתנה החדש הוסר על ידי הצגת הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במחשב הראשי. אמורה להופיע רק השורה הבאה בקובץ הזה:
    ממשק השכפול של המארח existing_slave_ip/32 אמון
  7. כדי למחוק את ה-UUID של צומת ההמתנה מ-zoKeeper, צריך לבצע את הקריאה הבאה ל-Edge management API בצומת שרת הניהול:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

עדכון לגבי אפס זמן השבתה

עדכון ללא זמן השבתה, או עדכון מתגלגל, מאפשר לעדכן את התקנת Edge בלי לקטוע את Edge.

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

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

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

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

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

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

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

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

כדי לעדכן את רכיבי Edge בצומת, יש לבצע את התהליך הבא:

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

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

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

    I = התקנה של OpenJDK 1.8 (ברירת מחדל)
    C = המשך ללא התקנה של Java
    Q = יציאה. עבור אפשרות זו, עליכם להתקין את Java בעצמכם.
  7. (CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי Qpid, מריצים את הפקודה הבאה כדי להוריד את גרסת ה-Qpid הנכונה:
    > yum install apigee-qpidd --disablerepo=epel
  8. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:
    1. אם התקנת את 4.16.01 על ידי שדרוג גרסה 4.15.07.0x של Edge, עליך להתקין את כלי העזר apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup setup

      פקודה זו מתקינה את הכלי update.shב-/opt.apige-setupe

      אם כבר התקנת את הכלי apigee-setup, צריך לעדכן אותו:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. אם התקנת את 4.16.01 באופן ישיר, כלומר לא ביצעת שדרוג מ-4.15.07.0x, עליך לעדכן את apigee-setup כלי השירות:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      עדכון זה ל-apigee-setup/setupapi התקנות apigee-setup.
    3. אם התקנת את 4.16.05 באופן ישיר או על ידי עדכון, עליך לעדכן את כלי העזר apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      העדכון הזה של apigee-service מתקין את update.apigee-setup כלי העזר /opt.apigee/apigee-service/bin/apigee-service apigee-setup
  9. בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את כלי השירות apigee-validate בשרת הניהול.
    1. אם אתם משתמשים כרגע ב-Edge 4.16.05: עדכנו את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. אם אתם משתמשים כרגע ב-Edge 4.16.01: צריך להתקין את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      הערה: אם התקנתם את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      הערה: אם התקנתם את כלי השירות apigee-validate באמצעות הפקודה apige-apige רשימת ההתקנים שבצמתים/העדכונים הבאים.
    3. אם משדרגים מגרסה 4.16.01: עורכים את קובץ התצורה שהועבר לכלי השירות apigee-validate. בגרסה 4.16.01 Edge, קובץ התצורה שנעשה בו שימוש ב-apigee-validate מחייב את המאפיינים הבאים:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      בגרסה הזו, קובץ התצורה דורש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
  10. מעדכנים את כלי העזר apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  11. מריצים את כלי העדכון בצמתים לפי הסדר שמתואר בקטע "עדכון המכונה" שבהמשך:
    > /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
  12. בודקים את העדכון על ידי הרצת כלי השירות לאימות ממשק ה-API בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.
  13. אם התקנתם צומת Postgres חדש במצב המתנה, צריך להוציא אותו משימוש כפי שמתואר למעלה בקטע ביטול של צומת Postgres.

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

הליך לעדכון ממאגר מקומי ל-4.17.05

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

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

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

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

  1. אם אתם משתמשים כרגע בשכפול של Postgres במצב המתנה, צריך להתקין צומת חדש של Postgres במצב המתנה, כפי שמתואר למעלה בסעיף התקנת צומת Postgres במצב המתנה.
  2. יוצרים מאגר מקומי 4.17.05 כפי שמתואר ב'יצירת מאגר Apigee מקומי' בהתקנת כלי השירות Edge apigee-setup.
    הערה: אם כבר יש לכם מאגר 4.16.01 או 4.16.05, תוכלו להוסיף אליו את המאגר 4.17.05 כמו שמתואר ב'עדכון מאגר Apigee מקומי' בInstall the Edge apigee-setup Utility.
  3. כדי להתקין את שירות ה-API מקובץ .tar:
    1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי בקובץ .tar אחד בשם /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz:
      > /opt/apigee/apigee-service/bin/apigee-miror apigee package
    2. מעתיקים את קובץ ה- .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
    3. בצומת החדש, מבטלים את היררכיית הקובץ /tmp:
      > tar -xzf apigee-4.17.05.tar.gz

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

      שימו לב שאתם כוללים את הנתיב למאגר ה-repos.
  4. כדי להתקין את השירות API באמצעות שרת האינטרנט של Nginx:
    1. מגדירים את שרת האינטרנט של Nginx כפי שמתואר במאמר 'התקנה מהמאגר באמצעות שרת האינטרנט של Nginx' במאמר התקנת כלי השירות Edge apigee-setup.
    2. בצומת המרוחק, מורידים את הקובץ Edge bootstrap_4.17.05.sh אל bootstrap_4.17.05.sh:
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/shoestrap_4.1mp
      .posh.remote /remote/shoes.

    3. בצומת המרוחק, מתקינים את כלי העזר ויחסי התלות של שירות Edge apigee:
      > sudo bash /tmp/shoestrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=Word.API:
      כאשר שם המשתמש apigeepassword=
      pWord:פרוטוקול api.
  5. משתמשים ב-apigee-service כדי לעדכן את הכלי apigee-setup:
    1. אם התקנת את 4.16.01 על ידי שדרוג גרסה 4.15.07.0x של Edge, עליך להתקין את כלי העזר apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup setup

      פקודה זו מתקינה את הכלי update.shב-/opt.apige-setupe

      אם כבר התקנת את הכלי apigee-setup, צריך לעדכן אותו:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. אם התקנת את 4.16.01 באופן ישיר, כלומר לא ביצעת שדרוג מ-4.15.07.0x, עליך לעדכן את apigee-setup כלי השירות:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      העדכון הזה כולל את apigee-update/setup.api?
    3. אם התקנת את 4.16.05 באופן ישיר או על ידי עדכון, עליך לעדכן את כלי העזר apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

      העדכון הזה ל-apigee-service מתקין את update.apigee-setup הכלי עזר ב-/opt.apigee/apigee-service/bin/apigee-service apigee-setup .
  6. בהתאם לגרסה הנוכחית של Edge, צריך להתקין או לעדכן את כלי השירות apigee-validate בשרת הניהול.
    1. אם אתם משתמשים כרגע ב-Edge 4.16.05: עדכנו את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. אם אתם משתמשים כרגע ב-Edge 4.16.01: מתקינים את כלי השירות apigee-validate on the Management Server:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate Regulation

      הערה: אם התקנתם את כלי השירות apigee-validate בשרת הניהול:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      הערה: אם התקנתם את הכלי apigee-validate בפקודה Message/apige כדי לאמת את הטמעת השירות apigee-apige על צומת של Message/apige.
    3. אם משדרגים מגרסה 4.16.01: עורכים את קובץ התצורה שהועבר לכלי השירות apigee-validate. בגרסה 4.16.01 Edge, קובץ התצורה שנעשה בו שימוש ב-apigee-validate מחייב את המאפיינים הבאים:
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      בגרסה הזו, קובץ התצורה דורש רק את המאפיין APIGEE_ADMINPW. אפשר להסיר את שני המאפיינים האחרים מהקובץ.
  7. מעדכנים את כלי העזר apigee-provision:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. מריצים את תוכנית השירות לעדכון בצמתים לפי הסדר שמתואר בקטע 'סדר העדכון של המכונה' שבהמשך:
    > /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
  9. בודקים את העדכון על ידי הרצת כלי השירות לאימות ממשק ה-API בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.
  10. אם התקנתם צומת Postgres חדש במצב המתנה, צריך להוציא אותו משימוש כפי שמתואר למעלה בקטע ביטול של צומת Postgres.

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

סדר העדכון של המכשיר

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

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

להתקנה עצמאית עם מארח אחד

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

    ממשיכים לבדוק את התור עד שהמספר בעמודה "msg" יהיה 0. לא ניתן לשדרג את Qpid לפני שכל ההודעות יטופלו.
  6. עדכון של qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. רצף iptables:
    > sudo iptables -F
  8. לעדכון LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Stop Postgres Server, Qpid server ו-PostgreSQL:
    > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    > /opt/apigee-service edge-postgres-server stop
  10. עדכון postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. מעדכנים את מסד הנתונים Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. מעדכנים את שאר רכיבי Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. עדכון ממשק המשתמש של Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

להתקנה עצמאית עם 2 מארחים

בקטע טופולוגיות התקנה יש רשימה של הטופולוגיות ומספרי הצמתים של Edge.

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

    ממשיכים לבדוק את התור עד שהמספר בעמודה "msg" יהיה 0. לא ניתן לשדרג את Qpid לפני שכל ההודעות יטופלו.
  6. מעדכנים את qpidd במכונה 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. נקה טבלאות iptable במחשב 2:
    > sudo iptables -F
  8. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. עדכון רכיבי Edge במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  11. מעדכנים את postgresql במכונה 2:
    1. הפסקת השימוש ב-Postgres Server, ב-Qpid server וב-postgresql:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/apigee-apigestop
    2. עדכון postgresql:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. מעדכנים את מסד הנתונים Postgres:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. עדכון רכיבי Edge במחשב 2 ובמכונה 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. מעדכנים את רכיבי Edge במחשב 2:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

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

בקטע טופולוגיות התקנה יש רשימה של הטופולוגיות ומספרי הצמתים של Edge.

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

    ממשיכים לבדוק את התור עד שהמספר בעמודה "msg" יהיה 0. לא ניתן לשדרג את Qpid לפני שכל ההודעות יטופלו.
  7. מעדכנים את qpidd במכונה 4:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. רצף iptables במחשב 4:
    > sudo iptables -F
  9. חוזרים על שלבים 5 עד 8 במכונה 5.
  10. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. עדכון רכיבי Edge במחשב 1, 2, 3:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. מעדכנים את מכונות 4 ו-5:
    1. הפסקת שרת Postgres ושרת Qpid במחשב 4:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. עצירה של שרת Postgres, שרת Qpid ו-postgresql במכונה 5:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop/opt/apigeapigeapigeapil/
    3. הפסקת שרת Postgres ו-postgresql בצומת ההמתנה החדש שהוספת עבור החזרה למצב קודם:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    4. עדכון postgresql במכונות מס' 4:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. עדכון מסד הנתונים Postgres במחשב 4 (מאסטר של Postgres בלבד):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. עדכון postgresql במחשבים 5:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. הפעלה של שרת Postgres ושרת Qpid במחשבים 4 ו-5:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. מגדירים את Postgres כצומת המתנה על ידי הרצת הפקודות הבאות במכונה 5:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    9. מאמתים את סטטוס השכפול על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול מוצלח:

      במכונה 4, הצומת הראשי, מריצים את:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      מאמתים שהיא המאסטר.

      צומת ההמתנה במחשב 5:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.
  14. עדכון רכיבי Edge במחשב גרסה 4, 5:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. מקפידים להוציא את צומת ההמתנה החדש לפי התהליך שמפורט בקטע ביטול של צומת Postgres.

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

בקטע טופולוגיות התקנה יש רשימה של הטופולוגיות ומספרי הצמתים של Edge.

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

    ממשיכים לבדוק את התור עד שהמספר בעמודה "msg" יהיה 0. לא ניתן לשדרג את Qpid לפני שכל ההודעות יטופלו.
  7. מעדכנים את qpidd במכונה 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. נקה קובצי iptable במחשב 6:
    > sudo iptables -F
  9. חוזרים על שלבים 5 עד 8 במכונה 7.
  10. עדכון LDAP במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. מעדכנים את רכיבי Edge במחשב בגרסאות 6, 7, 1, 4 ו-5 לפי הסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. עדכון ממשק המשתמש במחשב 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. עדכון מכונות מגרסה 8 ו-9:
    1. הפסקת שרת Postgres במחשב 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. הפסקת שרת Postgres ו-postgresql במחשב 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. הפסקת שרת Qpid במחשבים 6 ו-7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. הפסקת שרת Postgres ו-postgresql בצומת ההמתנה החדש שהוספת עבור החזרה למצב קודם:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. עדכון postgresql במחשבים 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. עדכון מסד הנתונים Postgres במחשב 8 (מאסטר של Postgres בלבד):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. עדכון postgresql במכונות 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. הפעלת שרת Postgres במחשבים 8 ו-9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. הפעלת שרת Qpid במחשבים 6 ו-7:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. מגדירים את Postgres כצומת המתנה באמצעות הרצת הפקודות הבאות במכונה 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    11. מאמתים את סטטוס השכפול על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול תקין:
      במכונה 8, הצומת הראשי, מריצים את:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      מאמתים שהיא המאסטר.

      צומת ההמתנה במחשב 9:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.
  14. מעדכנים את רכיבי Edge במחשב 8 ובמכונה 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. מקפידים להוציא את צומת ההמתנה החדש לפי התהליך שמפורט בקטע ביטול של צומת Postgres.

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

בקטע טופולוגיות התקנה יש רשימה של הטופולוגיות ומספרי הצמתים של Edge.

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

    ממשיכים לבדוק את התור עד שהמספר בעמודה "msg" יהיה 0. לא ניתן לשדרג את Qpid לפני שכל ההודעות יטופלו.
  7. מעדכנים את qpidd במכונה 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. נקה קובצי iptable במחשב 12:
    > sudo iptables -F
  9. חוזרים על שלבים 5 עד 8 במכונה 13.
  10. עדכון LDAP במכונה 4 ו-5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. מעדכנים את רכיבי Edge במחשב בגרסאות 12, 13, 6, 7, 10 ו-11 בסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. עדכון ממשק המשתמש במחשב 6 ו-7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  13. עדכון מכונות מגרסה 8 ו-9:
    1. הפסקת שרת Postgres במחשב 8:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. הפסקת שרת Postgres ו-postgresql במחשב 9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. הפסקת שרת Qpid במחשבים 12 ו-13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. הפסקת שרת Postgres ו-postgresql בצומת ההמתנה החדש שהוספת עבור החזרה למצב קודם:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. עדכון postgresql במחשבים 8:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. עדכון מסד הנתונים Postgres במחשב 8 (מאסטר של Postgres בלבד):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. עדכון postgresql במכונות 9:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. הפעלת שרת Postgres במחשבים 8 ו-9:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. הפעלת שרת Qpid במחשבים 12 ו-13:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. מגדירים את Postgres כצומת המתנה באמצעות הרצת הפקודות הבאות במכונה 9:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql
    11. מאמתים את סטטוס השכפול על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול תקין:
      במכונה 8, הצומת הראשי, מריצים את:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      מאמתים שהיא המאסטר.

      צומת ההמתנה במחשב 9:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.
  14. מעדכנים את רכיבי Edge במחשב 8 ובמכונה 9:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. מקפידים להוציא את צומת ההמתנה החדש לפי התהליך שמפורט בקטע ביטול של צומת Postgres.

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

בקטע טופולוגיות התקנה יש רשימה של הטופולוגיות ומספרי הצמתים של Edge.

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

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

        ממשיכים לבדוק את התור עד שהמספר בעמודה "msg" יהיה 0. לא ניתן לשדרג את Qpid עד שכל ההודעות יטופלו.
      3. מעדכנים את qpidd במכונה 10:
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. נקה קובצי iptable במחשב 10:
        > sudo iptables -F
      5. חוזרים על שלבים 1 עד 4 במכונה 11.
  5. עדכון LDAP:
    1. מכונות 1 ב-Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. מכונות 7 ב-Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. מעדכנים את רכיבי Edge:
    1. מכונות 4, 5, 1, 2, 3 ב-Data Center 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. מכונות 10, 11, 7, 8, 9 ב-Data Center 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. עדכון ממשק המשתמש:
    1. מכונה 1 ב-Data Center 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. מכונה 7 ב-Data Center 2:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. עדכון מכונה 6 במרכז נתונים 1 ו-12 במרכז נתונים 2:
    1. הפסקת שרת Postgres במחשב 6:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. הפסקת שרת Postgres ו-postgresql במחשב 12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. הפסקת שרת Qpid במחשבים 4, 5, 10 ו-11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. הפסקת שרת Postgres ו-postgresql בצומת ההמתנה החדש שהוספת עבור החזרה למצב קודם:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. עדכון postgresql במחשבים 6:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. עדכון מסד הנתונים Postgres במחשב 6 (מאסטר של Postgres בלבד):
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. עדכון postgresql במחשבים 12:
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. הפעלת שרת Postgres במחשבים 6 ו-12:
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. הפעלת שרת Qpid במחשבים 4, 5, 10 ו-11:
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. מגדירים את Postgres כצומת המתנה על ידי הרצת הפקודות הבאות במכונה 12:
      > cd /opt/apigee/data/apigee-postgresql/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postlication-configlication
      apigee-postgresq
    11. מאמתים את סטטוס השכפול על ידי הנפקת הסקריפטים הבאים בשני השרתים. המערכת צריכה להציג תוצאות זהות בשני השרתים כדי להבטיח שכפול בהצלחה:
      במכונה 6, הצומת הראשי, מריצים את:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      מאמתים שהיא המאסטר.

      צומת ההמתנה במחשב 12:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      מוודאים שמדובר במצב המתנה.
  9. עדכון רכיבי Edge במחשב גרסה 6 ו-12:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. מקפידים להוציא את צומת ההמתנה החדש לפי התהליך שמפורט בקטע ביטול של צומת Postgres.

להתקנת API עם 7 מארחים או 10 מארחים

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

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

  1. ZooKeeper
  2. קסנדרה
  3. Qpidd
  4. LDAP
  5. Edge, כלומר הפרופיל מסוג "-c edge" בכל הצמתים שבסדר: צמתים עם שרת Qpid, אבל לא שרת Postgres, שרת ניהול, מעבד הודעות ונתב.
    הערה: אם בצומת יש גם שרת Qpid וגם שרת Postgres, מריצים את שלב הפרופיל ' -c edge' כחלק משלב 8.
  6. ממשק המשתמש של Edge
  7. postgresql במאסטר של Postgres, כולל שדרוג.
  8. Postgresql במצב המתנה של Postgres.
  9. Edge, כלומר הפרופיל "-c edge" בכל הצמתים המשולבים של Qpid ו-Postgres, או בכל צומתי Postgres עצמאיים.