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

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

אפשר להחזיר את Edge מגרסה 4.19.06 לגרסאות הבאות של מהדורת התכונה:

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

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

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

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

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

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

כברירת מחדל, רכיבי Edge פועלים בתור ה-API של המשתמש. במקרים מסוימים, יכול להיות שרכיבי Edge יופעלו כמשתמשים שונים. לדוגמה, אם הנתב צריך לגשת ליציאות עם הרשאות, כמו יציאות מתחת ל-1,000, צריך להפעיל אותו בתור Root או כמשתמש עם גישה ליציאות האלה. לחלופין, אפשר להפעיל רכיב אחד כמשתמש אחד ורכיב אחר כמשתמש אחר.

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

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

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

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

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

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

  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 לגרסה קודמת, עליך למחוק את התוכן של הקובץ /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 לאחור, כדאי לוודא שקובצי iptable שוטפים: 
    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. כדי להתקין את הרכיב: 
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
    , משתמשים ב-apigee-setup

    לדוגמה:

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

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

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