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

Edge for Private Cloud גרסה 4.17.01

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

באמצעות התהליך.

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

  • אפשר להעביר את 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 לא תומך בהגדרה שמכילה רכיבים מכמה גרסאות.

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

הגרסה של Zoomkeeper 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 לשדרג את Zoomkeeper בגרסאות מאוחרות יותר מ-4.16.01. הדרך לתקן את השגיאה במצב הזה, להריץ יומי שדרוג לאחור apigee-zookeeper לפני שמעדכנים אתzokeeper.

אפשר לבדוק את הגרסה שלZokeeper באמצעות הפקודה הבאה:

> rpm -qa |grep apigee-zookeeper

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

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. שוב. אפשר להריץ את העדכון כמה פעמים, והוא ימשיך מהמקום שבו נעצר מושבתת.

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

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

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

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

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

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

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

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

כחלק מהעדכון ל-Java 8, חלק מהצפנים של TLS כבר לא זמינים ב-Oracle JDK 8. עבור את הרשימה המלאה, עיינו בקטע 'חבילות הצפנה מושבתות כברירת מחדל'. בכתובת 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-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

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

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

ראו חיצוני הגדרות אימות לקבלת עוד.

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

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

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 '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.

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

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

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

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

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

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

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

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

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

    conf_pg_hba_replication.connection=host אפיק רפליקציה existing_slave_ip/32 trust\ \nרפליקציית מארח apigee new_slave_ip/32 trust

    כאשר existing_slave_ip הוא כתובת ה-IP של ה-Postgres הנוכחי שרת ההמתנה ו-new_slave_ip הוא כתובת ה-IP של מצב ההמתנה החדש .
  2. הפעלה מחדש של apigee-postgresql במאסטר של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql הפעלה מחדש
  3. כדי לוודא שהצומת החדש של מצב המתנה נוסף, אפשר לעיין ב-/opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר. השורות הבאות אמורות להופיע בקובץ:
    apigee של רפליקציית מארח existing_slave_ip/32 Trust
    host 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 shoestrap_4.16.05.sh אל /tmp/shoestrap_4.16.05.sh:
      > תלתל https://software.apigee.com/shoestrap_4.16.05.sh -o /tmp/shoestrap_4.16.05.sh

      הערה: אם מעדכנים מגרסה 4.16.01, צריך להוריד את הקובץ bootstrap.sh של Edge.
    4. התקנה של תוכנית השירות ויחסי התלות של Edge apigee-service:
      > 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 Install
    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. כדי לקבל את ה-UUID של צומת ההמתנה החדש, מריצים את פקודת ה-cURL הבאה צומת מצב המתנה:
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self

    ה-UUID של הצומת אמור להופיע בסוף הפלט, בפורמט הבא:
    "סוג" : [ "postgres-server" ],
    'uUID' : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. כדי להפסיק את הצומת החדש של מצב המתנה, מריצים את הפקודה הבאה בצומת ההמתנה החדש:
    > /opt/apigee/apigee-service/bin/apigee-all stop
  4. בצומת המאסטר ב-Postgres, עורכים את /opt/apigee/customer/application/postgresql.properties כדי להסיר את הצומת החדש מצב המתנה מ-conf_pg_hba_replication.connection:
    conf_pg_hba_replication.connection=host apigee רפליקציה existing_slave_ip/32 trust
  5. יש להפעיל מחדש את apigee-postgresql במאסטר של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql הפעלה מחדש
  6. כדי לוודא שהצומת החדש של מצב המתנה הוסר, אפשר לעיין ב-/opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר. בקובץ הזה אמורה להופיע רק השורה הבאה:
    apigee של רפליקציית מארח existing_slave_ip/32 אמון
  7. מחיקת ה-UUID של צומת ההמתנה מ-ZooKeeper על ידי ביצוע הפעולות הבאות ב-Edge קריאה ל-API בצומת שרת הניהול:
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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

עדכון ללא השבתה או עדכון בהדרגה (rolling), מאפשרים לכם לעדכן את התקנת 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.01 בצומת עם חיבור חיצוני לאינטרנט

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

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

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

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

    I = התקנת OpenJDK 1.8 (ברירת מחדל)
    C = המשך בלי להתקין Java
    שאלה = יציאה. כדי להשתמש באפשרות הזו, תצטרכו להתקין Java בעצמכם.
  7. (CentOS-6.x ו-RedHat-6.x בלבד) בכל צומתי Qpid, מריצים את הפקודה הבאה כדי לוודא שהורדתם את גרסת ה-Qpid הנכונה:
    > יאמי התקנה 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 Install

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

      אם כבר התקנת את כלי השירות 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-service מתקין את השירות update.sh ב- /opt/apigee/apigee-setup/bin.
    3. אם התקנת את גרסה 4.16.05 ישירות או באמצעות עדכון, עליך לעדכן את הכלי apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

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

      הערה: אם התקנתם את הכלי apigee-validate בהודעה צומת של מעבד המידע כשמתקינים את גרסה 4.16.01, אפשר לעדכן אותו באמצעות הפקודה הבאה ב- הצומת הזה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-authentic update

      עם זאת, החל מ-4.16.05 ואילך, Apigee ממליצה להתקין ולהריץ את השירות apigee-validate מופעל את שרת הניהול.
    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

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

    משתמשים באפשרות ' -c' כדי לציין את הרכיב שרוצים לעדכן. רשימת האפשרויות הרכיבים כוללים:
    ldap = OpenLDAP
    cs = Cassandra
    zk = zokeeper
    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 באותו צומת
  12. בודקים את העדכון על ידי הרצת הכלי לאימות apigee בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.
  13. אם התקנתם צומת מצב המתנה חדש ב-Postgres, צריך להוציא את הצומת משימוש כפי שמתואר למעלה הסרת צומת של Postgres.

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

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

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

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

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

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

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

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

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

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

      כאשר uName:pWord הם שם המשתמש והסיסמה במאגר.
  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 Install

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

      אם כבר התקנת את כלי השירות 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-service מתקין את השירות update.sh ב- /opt/apigee/apigee-setup/bin.
    3. אם התקנת את גרסה 4.16.05 ישירות או באמצעות עדכון, עליך לעדכן את הכלי apigee-setup:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

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

      הערה: אם התקנתם את הכלי apigee-validate בהודעה צומת של מעבד המידע כשמתקינים את גרסה 4.16.01, אפשר לעדכן אותו באמצעות הפקודה הבאה ב- הצומת הזה:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-authentic update

      עם זאת, החל מ-4.16.05 ואילך, Apigee ממליצה להתקין ולהריץ את שירות לאימות apigee בשרת הניהול.
    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 -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 באותו צומת
  9. בודקים את העדכון על ידי הרצת הכלי לאימות apigee בשרת הניהול, כפי שמתואר במאמר בדיקת ההתקנה.
  10. אם התקנתם צומת מצב המתנה חדש ב-Postgres, צריך להוציא את הצומת משימוש כפי שמתואר למעלה הסרת צומת של Postgres.

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

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

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

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

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

  1. אם מעדכנים מ-4.16.01, צריך לשדרג לאחור את Zoomkeeper:
    > שדרוג לאחור של יאמי apigee-zookeeper
  2. עדכון של Cassandra ו-ZooKeeper:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. הגדרת הכלל הבא של טבלאות IP:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  4. בדיקת תור ההודעות ב-Qpid:
    > qpid-stat -q

    ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אין לך אפשרות לשדרג את Qpid עד שהוא יסיים לעבד את כל ההודעות.
  5. עדכון qpidd:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מכשירי אידוי נשלפים:
    > sudo iptables -F
  7. עדכון LDAP:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  8. הפסקת שרת Postgres, שרת Qpid ו-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/apigee-service/bin/apigee-service apigee-postgresql stop
  9. עדכון postgresql:
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  10. עדכון מסד הנתונים של Postgres:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  11. מעדכנים את שאר רכיבי Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. עדכון ממשק המשתמש של Edge:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. אם מעדכנים מ-4.16.01, צריך לשדרג לאחור את Zoomkeeper במכונה 1:
    > שדרוג לאחור של יאמי apigee-zookeeper
  2. עדכון Cassandra ו-ZooKeeper במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. הגדרת הכלל הבא של טבלאות IP במכונה 2:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  4. בדיקת תור ההודעות ב-Qpid במכונה 2:
    > qpid-stat -q

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

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

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

  1. יש לוודא שהתקנתם צומת המתנה חדש של Postgres, כפי שמתואר למעלה בקטע התקנת Postgres חדש צומת במצב המתנה.
  2. אם מעדכנים מ-4.16.01, צריך לשדרג לאחור את גן החיות במכונה 1, 2 ו-3:
    > שדרוג לאחור של יאמי apigee-zookeeper
  3. עדכון Cassandra ו-ZooKeeper במכונה 1, 2 ו-3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. הגדרת הכלל הבא של טבלאות IP במכונה 4:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  5. בדיקת תור ההודעות ב-Qpid במכונה 4:
    > qpid-stat -q

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

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

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

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

  1. יש לוודא שהתקנתם צומת המתנה חדש של Postgres, כפי שמתואר למעלה בקטע התקנת Postgres חדש צומת במצב המתנה.
  2. אם מעדכנים מ-4.16.01, צריך לשדרג לאחור את גן החיות במכונה 1, 2 ו-3:
    > שדרוג לאחור של יאמי apigee-zookeeper
  3. עדכון Cassandra ו-ZooKeeper במכונה 1, 2 ו-3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. הגדרת הכלל הבא של טבלאות IP במכונה 6:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  5. בדיקת תור ההודעות ב-Qpid במכונה 6:
    > qpid-stat -q

    ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אין לך אפשרות לשדרג את Qpid עד שהוא יסיים לעבד את כל ההודעות.
  6. מעדכנים את qpidd ב- מכונה 6:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. מכשירי IPtable במכונה 6:
    > sudo iptables -F
  8. חוזרים על שלבים 3 עד 6 במכונה 7.
  9. עדכון LDAP במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. מעדכנים את רכיבי Edge במכונה 6, 7, 1, 4 ו-5 לפי הסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. עדכון ממשק המשתמש במכונה 1:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  12. עדכון מכונות 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 setup-replication-on-standby -f
      configFile
    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

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

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

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

  1. יש לוודא שהתקנתם צומת המתנה חדש של Postgres, כפי שמתואר למעלה בקטע התקנת Postgres חדש צומת במצב המתנה.
  2. אם מעדכנים מ-4.16.01, צריך לשדרג לאחור את גן החיות במכונה 1, 2 ו-3:
    > שדרוג לאחור של יאמי apigee-zookeeper
  3. עדכון Cassandra ו-ZooKeeper במכונה 1, 2 ו-3:
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. הגדרת הכלל הבא של טבלאות IP במכונה 12:
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -i eth0 -j DROP
  5. בדיקת תור ההודעות ב-Qpid במחשב 12:
    > qpid-stat -q

    ממשיכים לבדוק את התור עד שמגיעים לספירה ב-'msg' העמודה היא 0. אין לך אפשרות לשדרג את Qpid עד שהוא יסיים לעבד את כל ההודעות.
  6. מעדכנים את qpidd ב- מכונה 12:
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. מכשירי IPtable במכונה 12:
    > sudo iptables -F
  8. חוזרים על שלבים 3 עד 6 במכונה 13.
  9. עדכון LDAP במכונה 4 ו-5:
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. צריך לעדכן את רכיבי Edge במכונה 12, 13, 6, 7, 10 ו-11 לפי הסדר הזה:
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  11. עדכון ממשק המשתמש במכונה 6 ו-7:
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  12. עדכון מכונות 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 setup-replication-on-standby -f
      configFile
    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

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

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

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

  1. יש לוודא שהתקנתם צומת המתנה חדש של Postgres, כפי שמתואר למעלה בקטע התקנת Postgres חדש צומת במצב המתנה.
  2. עדכון של Cassandra ו-ZooKeeper:
    1. אם מעדכנים מ-4.16.01, צריך לשדרג לאחור את גן החיות במכונה 1, 2 ו-3. במרכז הנתונים 1:
      > יאמי שדרוג לאחור של apigee-zookeeper
    2. במכונות 1, 2 ו-3 במרכז הנתונים 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. אם מעדכנים מ-4.16.01, צריך לשדרג לאחור את גן החיות במכונה 7, 8 ו-9. במרכז נתונים 2:
      > יאמי שדרוג לאחור של apigee-zookeeper
    4. במכונות 7, 8 ו-9 במרכז הנתונים 2
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. עדכון qpidd:
    1. מכונות 4 ו-5 במרכז הנתונים 1
      1. הגדרת הכלל הבא של טבלאות IP במכונה 4:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -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 iptable -F
      5. חוזרים על שלבים 1 עד 4 במכונה 5.
    2. מכונות 10, 11 במרכז נתונים 2
      1. הגדרת הכלל הבא של טבלאות IP במכונה 10:
        > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s 'hostname' -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 iptable -F
      5. חוזרים על שלבים 1 עד 4 במכונה 11.
  4. עדכון 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
  5. עדכון רכיבי Edge:
    1. מכונות 4, 5, 1, 2, 3 במרכז הנתונים 1
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. מכונות 10, 11, 7, 8, 9 במרכז נתונים 2
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. עדכון ממשק המשתמש:
    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
  7. עדכון מכונה 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-postgresql setup-replication-on-standby -f
      configFile
    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

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

ל-API של 7 מארחים או 10 מארחים התקנת BaaS

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

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

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