החזרת Apigee Edge 4.18.05 לגרסה קודמת

Edge for Private Cloud v4.18.05

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

אפשר להחזיר את Edge 4.18.05 לגרסאות הבאות של Feature Release:

  • גרסה 4.18.01
  • גרסה 4.17.09*
  • גרסה 4.17.05*

‫* כדי לחזור מגרסה 4.18.05 לגרסה 4.17.09 או 4.17.05, צריך להחזיר את Postgres לגרסה קודמת בנוסף להחזרת הרכיבים בכל צומת לגרסה קודמת. אם חוזרים לגרסה 4.18.01, לא צריך להחזיר את Postgres לגרסה קודמת כי תהליך השדרוג לא כלל עדכון של Postgres.

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

  1. חזרה לגרסת פיצ'רים קודמת. לדוגמה, מגרסה 4.18.05 לגרסה 4.18.01.
  2. חזרה לגרסת עדכון קודמת באותו עדכון גרסה. לדוגמה, מגרסה 4.18.05.02 לגרסה 4.18.05.01.

מידע נוסף זמין במאמר תהליך הפרסום של Apigee Edge.

מי יכול לבצע החזרה לגרסה קודמת

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

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

רכיבים עם קוד משותף

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

  • edge-management-server (שרת ניהול)
  • ‫edge-message-processor (מעבד בקשות)
  • edge-router (נתב)
  • edge-postgres-server (שרת Postgres)
  • edge-qpid-server (שרת Qpid)

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

חזרה לגרסת Feature Release קודמת

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

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

  1. מורידים את קובץ ה-bootstrap.sh של הגרסה שאליה רוצים לחזור:

    • כדי לחזור לגרסה 4.18.01, צריך להוריד את bootstrap_4.18.01.sh: 
      curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
    • כדי לחזור לגרסה 4.17.09, מורידים את bootstrap_4.17.09.sh: 
      curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
    • כדי לחזור לגרסה 4.17.05, צריך להוריד את bootstrap_4.17.05.sh: 
      curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  2. עוצרים את הרכיב שרוצים להחזיר לגרסה קודמת:
    1. כדי להחזיר לגרסה קודמת את אחד מהרכיבים עם הקוד המשותף בצומת, צריך לעצור את כולם, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. כדי לחזור לגרסה קודמת של רכיב אחר בצומת, עוצרים רק את הרכיב הזה: 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. אם אתם מחזירים את המונטיזציה לגרסה קודמת, צריך להסיר אותה מכל הצמתים של שרת הניהול ומעבד הבקשות: 
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. מסירים את הרכיב כדי לחזור לגרסה הקודמת בצומת:
    1. כדי להחזיר לגרסה קודמת את אחד מהרכיבים עם קוד משותף בצומת, צריך להסיר את כולם על ידי הסרת קבוצת הרכיבים edge-gateway, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. כדי להחזיר לגרסה קודמת רכיב אחר בצומת, מסירים רק את הרכיב הזה, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      כאשר component הוא שם הרכיב.

    3. כדי להחזיר את Edge Router לגרסה קודמת, צריך למחוק את התוכן של הקובץ /opt/nginx/conf.d בנוסף להסרת ההתקנה של קבוצת הרכיבים edge-gateway: 
      cd /opt/nginx/conf.d
rm -rf *
  5. מסירים את גרסה 4.18.05 של apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. מתקינים את גרסה 4.18.01,‏ 4.17.09 או 4.17.05 של כלי השירות apigee-service ואת יחסי התלות שלו. בדוגמה הבאה מתקינים את גרסה 4.17.09 של apigee-service: 
    sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord

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

    אם מופיעה הודעת שגיאה, צריך לוודא שהורדתם את הקובץ bootstrap.sh בשלב 1.

  7. התקנת apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. מתקינים את הגרסה הישנה יותר של הרכיב: 
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    ‫component הוא הרכיב שרוצים להתקין ו-configFile הוא קובץ התצורה של הגרסה הישנה יותר.

  9. אם אתם מחזירים את Qpid לגרסה קודמת, צריך לנקות את iptables: 
    sudo iptables -F
  10. חוזרים על התהליך הזה בכל צומת שמארח את הרכיב שאתם מחזירים לגרסה קודמת.

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

חזרה לגרסת עדכון קודמת

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

  1. מורידים את הגרסה הספציפית של הרכיב: 
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    כאשר component_version הוא הרכיב וגרסת העדכון שצריך להתקין. לדוגמה:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-0.0.3749 install

    אם אתם משתמשים במאגר אונליין של Apigee, אתם יכולים להשתמש בפקודה הבאה כדי לראות את גרסאות הרכיבים הזמינות: 

    yum --showduplicates list comp

    לדוגמה:

    yum --showduplicates list edge-ui
  2. משתמשים ב-apigee-setup כדי להתקין את הרכיב: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    לדוגמה:

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    שימו לב שאתם מציינים רק את שם הרכיב כשאתם מתקינים אותו, ולא את הגרסה.

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

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

ביטול העדכון של Postgres 9.6

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

כדי להחזיר את עדכון Postgres לגרסה קודמת כשמעדכנים את Postgres בהגדרת מאסטר-גיבוי:

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

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

  1. מוודאים שצומת הגיבוי החדש של Postgres פועל: 
    /opt/apigee/apigee-service/bin/apigee-all status

    אם Postgres לא פועל, מפעילים אותו:

    /opt/apigee/apigee-service/bin/apigee-all start
  2. מוודאים ש-Postgres הופסק בצומת הראשי הישן ובצומת הגיבוי הישן: 
    /opt/apigee/apigee-service/bin/apigee-all status

    אם Postgres פועל, עוצרים אותו: 

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  3. אם הוא מותקן, מפעילים את Qpid בצומת ההמתנה הישן: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
  4. מקַדמים את צומת הגיבוי החדש כמאסטר של Postgres:
    1. מקַדמים את הצומת החדש במצב המתנה כדי שיהיה המאסטר החדש: 
      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      אם מוצגת בקשה, מזינים את סיסמת Postgres של המשתמש apigee, שמוגדרת כברירת מחדל ל-"postgres".

    2. עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge, ומציינים את הפרטים הבאים: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    3. מגדירים את המאסטר החדש:
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
  5. בונים מחדש את הצומת הישן במצב המתנה:
    1. עורכים את קובץ התצורה שבו השתמשתם כדי להתקין את הגרסה הנוכחית של Edge, ומציינים את הפרטים הבאים: 
      # IP address of the new master:
PG_MASTER=new_standby_IP
# IP address of the old standby node
PG_STANDBY=old_standby_IP
    2. מסירים את ספריית הנתונים בצומת הגיבוי הישן: 
      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
    3. מגדירים מחדש את צומת הגיבוי הישן כצומת גיבוי של הצומת הראשי החדש: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    4. מוודאים ש-Postgres פועל בצומת ההמתנה הישן: 
      /opt/apigee/apigee-service/bin/apigee-all status

      אם הוא לא פועל, מפעילים אותו:

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
  6. מוודאים שצומת ההמתנה החדש נוסף על ידי הצגת הקובץ /opt/apigee/apigee-postgresql/conf/pg_hba.conf במאסטר החדש.
  7. כדי להציג את המידע הנוכחי על קבוצת הצרכנים ועל ניתוח הנתונים, מריצים את הפקודה הבאה בשרת הניהול: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    הפקודה הזו מחזירה את שם קבוצת הניתוח בשדה name, ואת שם קבוצת הצרכנים בשדה name בקטע consumer-groups. היא גם מחזירה את מזהי ה-UUID של הצמתים הישנים של Postgres, הראשי והמשני, בשדה postgres-server ובשדה datastores. הפלט אמור להיראות כך: 

    {
  "name" : "axgroup-001",
  "properties" : {
  },
  "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
  "uuids" : {
    "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "postgres-server" : [
      "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
    ]
  },
  "consumer-groups" : [ {
    "name" : "consumer-group-001",
    "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
    "datastores" :
      [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
      "properties" : {     }
    }
  ],
  "data-processors" : {
  }
}
  8. משיגים את כתובת ה-UUID של המאסטר הישן על ידי הרצת הפקודה הבאה של curl בצומת המאסטר הישן: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    בסוף הפלט אמור להופיע ה-UUID של הצומת, בפורמט הבא:

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  9. חוזרים על השלב הקודם כדי לקבל את כתובות ה-IP של הצומת הישן במצב המתנה ושל הצומת הראשי החדש.
  10. מסירים את הצמתים הישנים של המאסטר וההמתנה מקבוצת הצרכנים: 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    כאשר axgroup-001 ו-consumer-group-001 הם שמות ברירת המחדל של קבוצות הניתוח והצרכנים. masterUUID,standbyUUID מופיעים באותו סדר שבו הם הופיעו למעלה, כשצפית במידע הנוכחי על קבוצת הצרכנים ועל ניתוח הנתונים. יכול להיות שתצטרכו לציין אותם בתור standbyUUID,masterUUID.

    המאפיין datastores של consumer-groups אמור להיות ריק עכשיו.

  11. מסירים את הצמתים הישנים של המאסטר וההמתנה מקבוצת הניתוח: 
    curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    המאפיין postgres-server בקטע uuids אמור להיות ריק עכשיו.

  12. רושמים צומתי PG ראשיים וצומתי המתנה חדשים עם קבוצות הניתוח והצרכנים:
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
  13. מאמתים את קבוצת הניתוח: 
    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    מזהי ה-UUID של הצמתים החדשים של המאסטר וההמתנה אמורים להופיע ברשימה בקבוצת הניתוח ובקבוצת הצרכנים.

  14. מפעילים מחדש את Edge Management Server: 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
  15. מפעילים מחדש את כל שרתי Qpid: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
  16. מפעילים מחדש את כל שרתי Postgres: 
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  17. כדי לאמת את סטטוס הרפליקציה, מריצים את הסקריפטים הבאים בשני השרתים. המערכת אמורה להציג תוצאות זהות בשני השרתים כדי לוודא שהשכפול בוצע בהצלחה:

    במאסטר החדש, מריצים את הפקודה:

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

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

    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

    מוודאים שמופיע הכיתוב "standby" (המתנה).

  18. חוזרים על השלב הקודם אחרי ששולחים כמה בקשות API כדי לוודא שהצמתים מסונכרנים.
  19. מוציאים משימוש את שרת המאסטר הישן של Postgres באמצעות ההליך שמפורט במאמר עדכון Apigee Edge מגרסה 4.16.01 או 4.16.05 לגרסה 4.17.09.

    לחלופין, אפשר להסיר את Qpid מהצומת הראשי הישן ולהתקין את Qpid בצומת הראשי החדש. אחרי הסרת ההתקנה של Qpid, אפשר להוציא משימוש את צומת המאסטר הישן.

מסירים את Qpid מהמאסטר הישן ומתקינים את Qpid במאסטר החדש

כדי להסיר את Qpid מהמאסטר הישן ולהתקין אותו במאסטר החדש:

  1. חוסמים את הגישה ליציאה 5672 של Qpid בשרת הראשי הישן ממעבדי הבקשות, על ידי הפעלת הפקודה הבאה בכל מעבדי הבקשות: 
    iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
  2. כדי לוודא שתור ההודעות של Qpid ריק, מריצים את הפקודה הבאה. אי אפשר להסיר את ההתקנה של Qpid עד שהוא יעבד את כל ההודעות בהמתנה: 
    qpid-stat -q

    הפקודה הזו מציגה טבלה עם ספירה של msg, msgIn, and msgOut. כל ההודעות יעובדו כש-msg=0, וגם msgIn=msgOut.

  3. מריצים את הפקודה הבאה בשרת הראשי הישן כדי לזהות את ה-UUID של שרת ה-Qpid בשרת הראשי הישן. שומרים את הפרטים האלה כדי להשתמש בהם בהמשך התהליך: 
    curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
  4. עוצרים את Qpid בשרת הראשי הישן: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop
  5. הסרת ההתקנה של שרת Qpid: 
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
/opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall
  6. מסירים את שרת Qpid הישן מקבוצות הניתוח והצרכנים: 
    curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d '' \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/qpid_UUID" -v
curl -u sysAdminEmail:password -X DELETE \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v
  7. מסירים את שרת Qpid הישן מ-Zookeeper: 
    curl -u sysAdminEmail:password -X DELETE \
  http://ms_IP:8080/v1/servers/qpid_UUID
  8. מתקינים את Qpid בשרת ה-Master החדש: 
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile
  9. מריצים את הפקודה הבאה בשרת הראשי החדש כדי לקבוע את ה-UUID של שרת ה-Qpid בשרת הראשי החדש. שומרים את הפרטים האלה כדי להשתמש בהם בהמשך התהליך: 
    curl -u sysAdminEmail:password
  http://node_IP::8083/v1/servers/self
  10. רושמים את שרת Qpid החדש בקבוצות של ניתוח הנתונים והצרכנים: 
    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d '' \
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers?uuid=qpid_UUID" -v
  11. מפעילים מחדש את כל מעבדי הבקשות: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  12. מריצים את הפקודה הבאה בשרת Qpid החדש כדי לבדוק שהתורים נוצרו:
    qpid-stat -q

    מוודאים שהערכים של msg,‏ msgIn ו-msgOut מתעדכנים בזמן ששרת Qpid מעבד הודעות.

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