שדרוג מערכת ההפעלה של Apigee Edge לענן פרטי, צומת אחר צומת

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

במאמר הזה מתוארת שיטה חלופית לשדרוג מערכת ההפעלה (OS) של השרתים באשכול Apigee Edge for Private Cloud. במקום להגדיר מרכז נתונים מקביל חדש לגמרי, הגישה הזו של צומת אחר צומת מאפשרת לשדרג את מערכת ההפעלה במקום, מכונה או צומת אחת בכל פעם.

תאימות

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

דרישות מוקדמות

לפני שמתחילים בשדרוג של כל צומת בנפרד, צריך לוודא שביצעתם את המשימות הבאות:

גיבוי של כל הצמתים

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

מוודאים ש-Edge פועל

כדי לוודא ש-Edge פועל במהלך תהליך העדכון, משתמשים בפקודה:

/opt/apigee/apigee-service/bin/apigee-all status

סדר החלפת הצמתים

מומלץ לשדרג את הצמתים לפי הסדר שמופיע בהמשך, על סמך סוג הרכיב:

תרחישים נוספים

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

  • ‫apigee-mtls – אם apigee-mtls מופעל, שדרוג מערכת הפעלה מצומת לצומת (מתגלגל) לא נתמך בהגדרה הזו. כדי לשדרג את אותו שילוב, צריך לפעול לפי המדריך לשדרוג apigee-mtls.

Cassandra

כשמחליפים את Cassandra, מומלץ להחליף קודם את הצמתים שאינם צמתים ראשוניים, ואז את הצמתים הראשוניים.

אלה מקרים מיוחדים שצריך להביא בחשבון כשמשתמשים ב-Cassandra:

  • ‫Cassandra Native-mTLS – אם native-mTLS מופעל ונאכף, צריך להסיר את האכיפה בצמתים שמופעל בהם mTLS על ידי הגדרת conf_cassandra_client_encryption_optional=true. מידע נוסף זמין במסמכי התיעוד בנושא mTLS מקורי.
  • ‫Cassandra internode encryption enabled (הצפנה בין צמתים ב-Cassandra מופעלת) – כדאי לעיין במאמר בנושא הפעלת הצפנה בין צמתים ב-Cassandra כדי לוודא שהאישורים של צמתי Cassandra קיימים כלולים במאגר האישורים של הצומת החדש שהחליף את הצומת הקודם, ולהיפך.

השלבים להחלפת צומת Cassandra:

  1. מגבים את הצומת על ידי צילום תמונות מצב של המכונה הווירטואלית (אם אפשר) ומגבים את Apigee עבור Cassandra בכל הצמתים באמצעות הפקודה הבאה: 
    apigee-service apigee-cassandra backup
  2. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  3. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  4. מורידים ומריצים את קובץ Edge כדי להתקין את כלי השירות apigee-service. הפעלה ראשונית של גרסת Apigee שנמצאת בשימוש, run bootstrap כדי לקבל את apigee-service ולהתקין את apigee-setup.
  5. מפרטים את צמתי המקור: 
    apigee-service apigee-cassandra configure -search conf_cassandra_seeds
  6. מעדכנים את קובץ ההגדרות על ידי שינוי כתובת ה-IP של צומת Cassandra הקיים והחלפתה בכתובת ה-IP של הצומת החדש.

    ‫CASS_HOSTS קיים

    CASS_HOSTS="$IP1 $IP2 $IP3"

    CASS_HOSTS עודכן לאחרונה

    CASS_HOSTS="$IP1 $IP4 $IP3"
  7. מגדירים מחדש את הצמתים הקיימים באשכול עם כתובת ה-IP המעודכנת של צומת Cassandra החדש (חוץ מהצומת שרוצים להחליף). מומלץ להשתמש בהפניה לקובץ התצורה. 
    /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
  8. עוצרים את Cassandra ומבטלים את הרישום שלה בצומת הישן:
    1. מפסיקים את Cassandra בצומת שרוצים להחליף: 
      apigee-service apigee-cassandra stop
    2. מציינים את ה-UUID של צומת Cassandra שיוצא משימוש (אם יש כמה מרכזי נתונים, צריך להתייחס לכך בהתאם): 
      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost
    3. מבטלים את הרישום של סוגי מאגרי הנתונים שמשויכים ל-UUID הקיים של Cassandra: 
      curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"
    4. מוחקים את השרת. 
      curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid
  9. מכינים צומת חדש למארח apigee-cassandra. מוסיפים את השורה הבאה לקובץ cassandra.properties בקטע /opt/apigee/customer/application/cassandra.properties (אם הוא לא קיים, צריך ליצור אותו) בצומת החדש של Cassandra: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
  10. מוודאים שהבעלים והקבוצה מוגדרים ל-apigee:apigee בקובץ cassandra.properties. אם צריך, משתמשים בפקודה הבאה כדי לעדכן את הבעלים והקבוצה: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  11. מתקינים את Cassandra ומריצים את ההגדרה בצומת החדש שהתווסף: 
    apigee-service apigee-cassandra install
     
    apigee-service apigee-cassandra setup -f updatedConfigFile
  12. אחרי שמגדירים את הצומת החדש, מסירים את ההגדרה הנוספת שנוספה ל-/opt/apigee/customer/application/cassandra.properties ומפעילים מחדש את apigee-cassandra: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true
     
    apigee-service apigee-cassandra restart
  13. בודקים את הסטטוס של הצומת החדש שהחליף את הצומת הקודם: 
    apigee-service apigee-cassandra status
     
    /opt/apigee/apigee-cassandra/bin/nodetool status
  14. בונים מחדש את הצומת החדש שנוסף לאשכול: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1
  15. מגדירים מחדש את הצמתים הקיימים של שרתי הנתבים, מעבדי ההודעות, Qpid, ‏ Postgres והניהול בהתאמה, על ידי עדכון כתובת ה-IP של צומת Cassandra החדש בקובץ ההגדרות: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  16. הסרה או ביטול התקנה של Cassandra מצומת ישן יותר: 
    apigee-service apigee-cassandra uninstall
  17. חוזרים על הפעולה עבור צמתי Cassandra אחרים באשכול.

מטפל בבעלי חיים

כדי להחליף צמתים של Zookeeper, פועלים לפי השלבים הבאים. כדי לוודא שהקבוצה שומרת על קוורום, כדאי להחליף קודם את הצמתים של העוקבים ואחר כך את הצמתים של המובילים.

  1. מגבים את הצומת על ידי צילום תמונות מצב של המכונה הווירטואלית (אם אפשר) ומגבים את Apigee עבור Zookeeper בכל הצמתים.
  2. מפסיקים את Zookeeper ומסירים אותו בצומת קיים: 
    apigee-service apigee-zookeeper stop
     
    apigee-service apigee-zookeeper uninstall
  3. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  4. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  5. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  6. מעדכנים את קובץ ההגדרות על ידי הסרת כתובות ה-IP של הצמתים שהוצאו משימוש או נמחקו, והחלפתן בכתובות IP חדשות של צמתים עבור Zookeeper. לפרטים נוספים, אפשר לעיין במאמרי העזרה בנושא קובץ התצורה:

    הגדרה קיימת של ZK

    ZK_HOSTS="$IP1 $IP2 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"

    הגדרת ZK עודכנה

    ZK_HOSTS="$IP1 $IP4 $IP3"
ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
  7. מתקינים, מגדירים ומפעילים את Zookeeper בצומת חדש באמצעות קובץ ההגדרות המעודכן: 
    /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
  8. מבצעים שינויים בצומת Zookeeper הקיים באמצעות updatedConfigFile: 
    /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile
  9. מגדירים מחדש את הצמתים הקיימים של שרתי הנתב, עיבוד ההודעות, Qpid,‏ Postgres והניהול בהתאמה, על ידי עדכון כתובת ה-IP של צומת Zookeeper החדש בקובץ ההגדרות: 
    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile
  10. חוזרים על הפעולה לכל צומתי Zookeeper.

Postgres

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

  • מחליפים את אחד מצמתי ההמתנה הקיימים במערכת ההפעלה המיועדת.
  • מקדמים את צומת ההמתנה החדש לצומת ראשי.
  • מוציאים משימוש את השרת הראשי הישן.
  • ממשיכים להחליף עוד צמתים במצב המתנה.

לפני שמתחילים בהחלפה, מומלץ להפסיק את edge-qpid-server כדי לצמצם את הסיכון לאובדן של הודעות ניתוח.

apigee-service edge-qpid-server stop

המתנה

  1. מקבלים את ה-UUID של הצמתים edge-postgres-server: 
    curl http://pg_standby_ip:8084/v1/servers/self
  2. עוצרים את Postgres: 
    apigee-service edge-postgres-server stop
     
    apigee-service apigee-postgresql stop
  3. מסירים את Postgres standby הקיים מקבוצת הניתוח לפי השלבים האלה.
  4. מסירים את apigee-postgres ואת postgres-server: 
    apigee-service edge-postgres-server uninstall
     
    apigee-service apigee-postgresql uninstall
  5. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  6. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  7. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  8. כדי להגדיר שכפול של master-standby ב-master הקיים, צריך לעדכן את קובץ ההגדרות עם EXISTING_PG_MASTER_IP ו-NEW_PG_STANDBY_IP. מידע נוסף זמין במאמר בנושא קובץ ההגדרות: 
    PG_MASTER=EXISTING_PG_MASTER_IP
     
    PG_STANDBY=NEW_PG_STANDBY_IP
     
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  9. מתקינים, מגדירים ומפעילים את Postgres עם הגדרות master-standby בצומת ההמתנה החדש: 
    PG_MASTER=EXISTING_PG_MASTER_IP
     
    PG_STANDBY=NEW_PG_STANDBY_IP
     
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
  10. אימות ההגדרה של הגיבוי: 
    apigee-service apigee-postgresql postgres-check-standby

ראשי

  1. מקבלים את המזהה הייחודי האוניברסלי (UUID) של צומת ה-Postgres הראשי הקיים: 
    curl http://pg_ip:8084/v1/servers/self
  2. מקדמים את צומת ההמתנה של מערכת ההפעלה המשודרגת החדשה לסטטוס מאסטר.
  3. מפסיקים את Postgres בשרת הראשי הקיים: 
    apigee-service apigee-postgresql stop
     
    apigee-service edge-postgres-server stop
  4. קידום צומת ההמתנה החדש לראשי: 
    apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP
  5. מסירים את הצומת הראשי הישן מקבוצות הצרכנים והניתוח.
  6. מוסיפים את הצומת הראשי החדש לקבוצות של Analytics ושל צרכנים.
  7. אם אתם משתמשים בהפעלת מונטיזציה, אתם צריכים לעדכן את צומת ה-Postgres הראשי החדש ולבצע את השלבים הבאים.
  8. אחרי שמחליפים את הצומת הראשי, אפשר להפעיל את edge-qpid-server עם הגדרות מעודכנות של הצומת הראשי: 
    apigee-service edge-qpid-server start
  9. אם אתם משתמשים במונטיזציה, צריך להפעיל מחדש גם את שרת הניהול ואת מעבד ההודעות: 
    apigee-service edge-management-server restart
  10. עוצרים ומסירים את ההתקנה של apigee-postgres ושל postgres-server במאסטר הישן: 
    apigee-service edge-postgres-server uninstall
     
    apigee-service apigee-postgresql uninstall

הוספת כרטיס חדש למצב המתנה

  1. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  2. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  3. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  4. מגדירים שכפול של master-standby באמצעות כתובת IP חדשה של master וכתובת IP חדשה של צומת standby בקובץ ההגדרה של master חדש וצומת standby חדש. מידע נוסף זמין במאמר בנושא קובץ ההגדרות: 
    apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile
  5. מתקינים ומגדירים בצומת ההמתנה החדש: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile
  6. מוסיפים את הגיבוי החדש לקבוצות הניתוח לפי השלבים להגדרת גיבוי ראשי.

LDAP

כדי להחליף את צומת ה-LDAP, צריך לעצור את שרת הניהול. כל ממשקי ה-API של הניהול לא יהיו זמינים למשך ההחלפה של הצומת הזה.

  1. עוצרים את שרת הניהול בכל הצמתים: 
    apigee-service edge-management-server stop
  2. הוצאה משימוש של צומת LDAP קיים:
    1. מבצעים גיבוי או יוצרים תמונת מצב ברמת ה-VM של צומת LDAP.
    2. לפני שמפסיקים את LDAP, חשוב לתעד את מספר נתוני ה-LDAP, שאפשר יהיה לאמת אותו בהמשך. למשל: 
      ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l
    3. בהגדרה של active-passive:
      1. כדי להפוך את השרת הפסיבי לנוכחי, מוסיפים קובץ mark_writable.ldif בצומת הפסיבי עם התוכן הבא: 
        dn: olcDatabase={2}bdb,cn=config
changetype: modify
replace: olcReadOnly
olcReadOnly: FALSE
      2. מריצים את הפקודה הבאה בצומת הפסיבי כדי להפוך אותו לפעיל: 
        ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif
      3. במקרה של active-active, ממשיכים לשלב ד' כדי להוציא את הצמתים משימוש.
    4. בהגדרת LDAP פעילה-פעילה, צריך להפסיק את השכפול בין שני צמתי ה-LDAP ולעדכן את ההגדרות. פועלים לפי השלבים שמפורטים במסמך בנושא הוצאה משימוש של LDAP.
    5. מפסיקים את השירות ומגבים את נתוני ה-LDAP ומסירים את צומת ה-LDAP הקיים (אם כבר עשיתם את זה, דלגו לשלב הבא): 
      apigee-service apigee-openldap stop
       
      apigee-service apigee-openldap backup
       
      apigee-service apigee-openldap uninstall
  3. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  4. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  5. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  6. הגדרת צומת LDAP חדש:
    1. מעדכנים את configFile עבור צומת חדש על סמך ההגדרה. אפשר לעיין בהפניה לקובץ התצורה של Edge, על סמך הגדרה פעילה בלבד או הגדרה פעילה-פעילה:
      • LDAP_TYPE
      • LDAP_PEER
      • LDAP_SID
      • USE_LDAP_REMOTE_HOST=y/n
    2. מגדירים ומפעילים LDAP בצומת חדש עם updatedConfigFile: 
      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile
    3. מגבים את נתוני ה-LDAP מצמתים ישנים יותר (אם אפשר לדלג על הגדרת active-active):
      1. מבצעים גיבוי לדוגמה בצומת החדש כדי ליצור תיקיית גיבוי או נתיב גיבוי שמוגדרים כברירת מחדל: 
        apigee-service apigee-openldap backup
      2. מעבירים את הנתונים המגובים מהצומת הישן לתיקיית הגיבוי שנוצרה.
      3. לפני שמשחזרים את הנתונים, צריך לעצור את apigee-openldap: 
        apigee-service apigee-openldap stop
      4. משחזרים את הגיבוי שנוצר מהצומת הישן: 
        apigee-service apigee-openldap restore backup_file

        לדוגמה:

        apigee-service apigee-openldap restore 2026.02.09,10.28.20
  7. חוזרים על הפעולה עבור צומת LDAP אחר (אם מדובר ב-active-active).
  8. מגדירים מחדש ומפעילים את שרת הניהול עם הגדרות מעודכנות של מארח LDAP: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  9. איפוס והפעלה של SSO (אם רלוונטי): 
    apigee-service apigee-sso setup -f updatedConfigFile
     
    apigee-service apigee-sso restart
  10. (אופציונלי) מגדירים את ספריית Active Directory השנייה לקריאה בלבד לפי השלבים שמפורטים במסמכי התיעוד.

Qpid

כדי להחליף צומת Qpid קיים בצומת מערכת הפעלה משודרגת, צריך לוודא שביצעתם את השלבים הבאים:

  1. הפסקת קבלת הודעות בתור הקיים של הצומת ממעבדי ההודעות.
  2. רוקנו את ההודעות הקיימות בתור.
  3. עוצרים את הצומת הקיים ומוציאים אותו משימוש.

הוצאה משימוש של צמתים קיימים. כדי לוודא שאף הודעה לא תאבד, מפורטים כאן אמצעים נוספים:

  1. מפסיקים את Qpid broker: 
    apigee-service apigee-qpidd stop
  2. חסימת תנועה נכנסת ביציאה 5672 מכל מעבדי ההודעות: 
    iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP
  3. מפעילים מחדש את Qpid broker כדי לרוקן את ההודעות הקיימות: 
    apigee-service apigee-qpidd start
  4. לפני שמתחילים להוציא את התור משימוש, צריך לוודא שכל ההודעות בתור הועברו לצרכן.
  5. מקבלים את ה-UUID של הצומת edge-qpid-server: 
    curl http://qpid_node_ip:8083/v1/servers/self
  6. משלימים את השלבים להוצאה משימוש או להסרה של Qpid מ-Analytics עבור apigee-qpidd ו-edge-qpid-server.
  7. עוצרים ומסירים את apigee-qpidd ואת edge-qpid-server: 
    apigee-service apigee-qpidd stop
     
    apigee-service edge-qpid-server stop
     
    apigee-service apigee-qpidd uninstall
     
    apigee-service edge-qpid-server uninstall

הוספת צומת חדש:

  1. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  2. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  3. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  4. מגדירים ומפעילים את שירותי Qpid בצומת החדש ומוסיפים אותם לקבוצות הצרכנים, לפי השלבים האלה. אפשר לבצע את אותם השלבים כדי להוסיף קבוצות אחרות, למשל קבוצות שקשורות למונטיזציה.
  5. אם שירות המונטיזציה מופעל, מפעילים מחדש את שרת הניהול ואת מעבד ההודעות: 
    apigee-service edge-management-server restart
     
    apigee-service edge-message-processor restart
  6. חוזרים על הפעולה בכל צמתי Qpid.

מעבד הודעות

  1. קבלת מזהה ייחודי אוניברסלי (UUID) של הצומת edge-message-processor: 
    curl http://mp_ip:8082/v1/servers/self
  2. מוציאים משימוש ומסירים את הצומת של מעבד ההודעות.
  3. אם שירות המונטיזציה מופעל, צריך להסיר את edge-mint-message-processor.
  4. הסרת מעבד ההודעות: 
    apigee-service edge-message-processor uninstall
  5. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  6. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  7. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  8. מוסיפים את Message Processor לאשכול, מגדירים אותו ומפעילים אותו, לפי השלבים.
  9. אם המונטיזציה מופעלת, צריך להגדיר את שירות המונטיזציה יחד עם מעבד ההודעות. מידע נוסף זמין במאמרי העזרה הבאים.

נתב

  1. קבלת מזהה ייחודי אוניברסלי (UUID) של הצומת edge-router: 
    curl http://router_ip:8081/v1/servers/self
  2. השבתה של יכולת ההגעה (reachability) ואימות אם אפשר להגיע אליו: 
    iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT
     
    curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable
  3. הוצאה משימוש והסרה של צומת הנתב.
  4. הסרת הנתב: 
    apigee-service edge-router uninstall
  5. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  6. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  7. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  8. מוסיפים, מגדירים ומפעילים נתב באשכול.

שרת ניהול

שרת ניהול יחיד בלבד

  1. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  2. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  3. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  4. מוסיפים את שרת הניהול באמצעות כתובת ה-IP המעודכנת וקובץ ההגדרות שאפשר למצוא כאן, ומריצים את פקודת ההגדרה: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  5. מגדירים מחדש ומפעילים מחדש את ממשק המשתמש עם הגדרת IP חדשה לניהול. 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  6. הגדרה מחדש של SSO עם הגדרת IP חדשה לניהול (אם רלוונטי): 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  7. הגדרה מחדש של ממשק המשתמש החדש (UE) עם הגדרת כתובת IP חדשה לניהול (אם רלוונטי): 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  8. אם המונטיזציה מופעלת:
    1. מגדירים מחדש את המונטיזציה של MS עם הגדרת IP חדשה לניהול (אם רלוונטי), בהתאם למסמכי הגדרת המונטיזציה. 
      /opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile
    2. מפעילים מחדש את שרת הניהול: 
      apigee-service edge-management-server restart
  9. מוציאים משימוש את שרת הניהול בצומת הקיים או הישן, לפי השלבים.
  10. אם ההפעלה של המוניטיזציה מופעלת, צריך להסיר את ה-UUID של שרת הניהול מקבוצות הניתוח. דוגמה: 
    curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"
  11. מסירים את שרת ניהול המונטיזציה: 
    apigee-service edge-mint-management-server uninstall

כמה שרתי ניהול

  1. מוציאים משימוש אחד מהשרתים לניהול באמצעות השרת השני בצומת קיים, לפי השלבים.
  2. עוצרים ומסירים את ההתקנה של שרת הניהול: 
    apigee-service edge-management-server stop
     
    apigee-service edge-management-server uninstall
  3. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  4. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  5. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  6. מוסיפים את שרת הניהול באמצעות כתובת ה-IP המעודכנת וקובץ ההגדרות שאפשר למצוא כאן, ומריצים את פקודת ההגדרה: 
    /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile
  7. הגדרה מחדש והפעלה מחדש של ממשק המשתמש עם הגדרת IP מעודכנת לניהול: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  8. (רק אם מופעל SSO) מגדירים מחדש ומפעילים מחדש את ה-SSO עם הגדרת IP ניהול מעודכנת: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (רק אם הממשק החדש מופעל) מגדירים מחדש ומפעילים מחדש את הממשק החדש עם הגדרות IP מעודכנות לניהול: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
  10. חוזרים על הפעולה עבור שרת ניהול אחר.

ממשק משתמש/חוויית משתמש

  1. יצירת גיבוי או snapshot של מכונה וירטואלית של צומת ממשק המשתמש.
  2. הפסקה והסרה של ממשק המשתמש: 
    apigee-service edge-ui stop
     
    apigee-service edge-ui uninstall
  3. (אם משתמשים רק בממשק המשתמש החדש) מפסיקים את השימוש בממשק המשתמש החדש ומסירים אותו: 
    apigee-service edge-management-ui stop
     
    apigee-service edge-management-ui uninstall
  4. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  5. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  6. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  7. מגדירים ומריצים את edge-ui בצומת החדש, עם הגדרות IP מעודכנות: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile
  8. (רק אם הופעל SSO) מגדירים מחדש ומריצים SSO עם הגדרות חדשות של צומת IP בממשק המשתמש, לפי הצורך: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  9. (רק אם הממשק החדש מופעל) מגדירים ומריצים את הממשק החדש בצומת החדש, עם הגדרות IP מעודכנות: 
    /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile
     
    apigee-service edge-management-ui configure-sso -f updatedConfigFile
     
    apigee-service edge-ui configure-sso -f updatedConfigFile

SSO

  1. יצירת גיבוי או snapshot של מכונה וירטואלית של צומת ממשק המשתמש.
  2. הפסקה והסרה של SSO: 
    apigee-service apigee-sso stop
     
    apigee-service apigee-sso uninstall
  3. צירוף צומת חדש עם מערכת ההפעלה המשודרגת.
  4. מחילים את הדרישות המוקדמות הספציפיות למערכת ההפעלה.
  5. מורידים את קובץ ה-bootstrap של גרסת Apigee שבשימוש, מריצים את קובץ ה-bootstrap כדי לקבל את apigee-service ומתקינים את apigee-setup.
  6. מוסיפים הגדרות ומפתחות ל-SSO לפי המדריך, תוך התחשבות בכתובת ה-IP של הצומת החדש.
  7. הגדרה והפעלה של SSO: 
    /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile
  8. מעדכנים את ההגדרה עם כתובות ה-IP של צומת ה-SSO החדש ומגדירים מחדש את ה-SSO לממשק המשתמש: 
    apigee-service edge-ui configure-sso -f updatedConfigFile
  9. (אם משתמשים בממשק משתמש חדש) מריצים את הפקודה configure-sso בצומת של ממשק המשתמש החדש, בהתאם למסמכים: 
    apigee-service edge-management-ui configure-sso -f updatedConfigFile
     
    apigee-service edge-ui configure-sso -f updatedConfigFile