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

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

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

  • גרסה 4.19.01
  • גרסה 4.18.05
  • גרסה 4.18.01

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

  1. חזרה לגרסה קודמת של Feature Release. לדוגמה, מ-4.19.06 עד 4.18.05.
  2. חזרה לגרסת עדכון קודמת באותה גרסה. לדוגמה, מ-2 בינואר 2019 עד 1 בינואר 2019.

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

מי יכול לבצע החזרה למצב קודם

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

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

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

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

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

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

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

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

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

    • כדי לחזור לגרסה 4.19.01, מורידים את bootstrap_4.19.01.sh: 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • כדי לחזור לגרסה 4.18.05, מורידים את bootstrap_4.18.05.sh: 
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.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
  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.19.06 של apigee-setup: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. מתקינים את הגרסה 4.19.01, 4.18.05 או 4.18.01 של כלי השירות apigee-service ואת יחסי התלות שלו. בדוגמה הבאה מתבצעת התקנה של הגרסה 4.18.01 של apigee-service: 
    sudo bash /tmp/bootstrap_4.18.01.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. חוזרים על התהליך הזה בכל צומת שמארח את הרכיב שאתם רוצים לבצע לו חזרה לאחור.

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

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

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

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

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.01-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. חוזרים על התהליך הזה בכל צומת שמארח את הרכיב שאתם רוצים לבצע לו חזרה לאחור.