שדרוג לאחור של רכיבי Apigee ו-NGINX

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

הפצת תיקון, מרץ 2021

העדכון של Edge for Private Cloud ממרץ 2021, שהועבר אל מאגר הייצור של Apigee, כלל עדכון לא מכוון של התלות ב-apigee-nginx-1.18. לכן הסרנו את קובצי ה-RPM מהמאגר והחלפנו אותם בקובצי RPM תקינים. קבצי ה-RPM הלא תקינים היו במאגר ב-25 במרץ 2021 בין השעות 08:45 ל-15:45 לפי שעון החוף המערבי של ארה"ב (PST). אם הורדתם והתקנתם קובצי RPM של Edge בתאריך הזה, יכול להיות שתצטרכו לשנמך את הרכיבים הבאים של Apigee לגרסאות קודמות:

  • edge-gateway
  • edge-management-server
  • edge-message-processor
  • edge-postgres-server
  • edge-qpid-server
  • edge-router
  • nginx

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

בדיקה אם צריך לשדרג לאחור

כדי לבדוק אם צריך לשנמך את רכיבי Apigee או NGINX, מבצעים את אחד מההליכים הבאים, בהתאם לגרסה של Edge for Private Cloud שבה אתם משתמשים: 4.50.00 או 4.19.06.

הליך ל-Edge 4.50.00

בכל צומת, מזינים את הפקודה הבאה כדי למצוא את גרסת ה-Gateway:

-- apigee-service edge-gateway version

אם מספר הגרסה של edge-gateway הוא:

  • אם מספר ההזמנה קטן מ-20113, לא צריך לבצע פעולה נוספת.
  • אם הגרסה שלכם היא 20113, אתם צריכים להחזיר את הרכיבים של Apigee לגרסה קודמת וגם את NGINX.
  • אם המספר גדול מ-20113, מזינים את הפקודה הבאה כדי למצוא את גרסת NGINX: 
    -- sudo yum list installed apigee-nginx

    דוגמה לפלט של הפקודה:

    Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

    אם גרסת NGINX היא apigee-nginx.x86_64 1.18.0-XXX, צריך רק להוריד את גרסת NGINX.

תהליך ל-Edge 4.19.06

בכל צומת, מזינים את הפקודה הבאה כדי למצוא את גרסת ה-Gateway:

-- apigee-service edge-gateway version

אם מספר הגרסה של edge-gateway הוא:

  • אם המספר קטן מ-20114, לא צריך לבצע פעולה נוספת.
  • אם הערך הוא 20114, צריך לשדרג לאחור את רכיבי Apigee ולשדרג לאחור את NGINX.
  • אם המספר גדול מ-20114, מזינים את הפקודה הבאה כדי למצוא את גרסת NGINX: 
    -- sudo yum list installed apigee-nginx

    דוגמה לפלט של הפקודה:

    Installed Packages
apigee-nginx.x86_64 1.18.0-1.el7
@apigee-thirdparty

    אם גרסת NGINX היא apigee-nginx.x86_64 1.18.0-XXX, צריך רק להוריד את גרסת NGINX.

    רכיבים לשדרוג לאחור

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

    רכיבים לשדרוג לאחור של Edge for Private Cloud 4.50.00

    edge-gateway-4.50.00-0.0.20113.noarch.rpm
edge-management-server-4.50.00-0.0.20113.noarch.rpm
edge-message-processor-4.50.00-0.0.20113.noarch.rpm
edge-postgres-server-4.50.00-0.0.20113.noarch.rpm
edge-qpid-server-4.50.00-0.0.20113.noarch.rpm
edge-router-4.50.00-0.0.20113.noarch.rpm

    רכיבים לשדרוג לאחור של Edge for Private Cloud 4.19.06

    edge-gateway-4.19.06-0.0.20114.noarch.rpm
edge-management-server-4.19.06-0.0.20114.noarch.rpm
edge-message-processor-4.19.06-0.0.20114.noarch.rpm
edge-postgres-server-4.19.06-0.0.20114.noarch.rpm
edge-qpid-server-4.19.06-0.0.20114.noarch.rpm
edge-router-4.19.06-0.0.20114.noarch.rpm

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

    -- apigee-service component version

    חזרה לגרסה קודמת של רכיבי Apigee

    כדי לשנמך רכיבים של Apigee, פועלים לפי השלבים הבאים.

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

    • edge-gateway
    • edge-management-server
    • edge-message-processor
    • edge-postgres-server
    • edge-qpid-server
    • edge-router

    מפסיקים את הרכיב על ידי הזנת

    --apigee-service component stop

    לאחר מכן, מורידים את הרכיבים לגרסה קודמת:

    -- sudo yum downgrade

    הנה כמה דוגמאות:

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

    -- sudo yum downgrade edge-gateway edge-message-processor

    אם מותקנים שער ונתב קצה:

    -- sudo yum downgrade edge-gateway edge-router

    אם ההגדרה היא AIO : 

    -- sudo yum downgrade edge-gateway edge-postgres-server edge-router edge-management-server edge-message-processor edge-qpid-server

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

    --apigee-service  component configure
--apigee-service  component start

    בהמשך מוצגת הגרסה הנכונה של ה-RPM שתהיה לכם אחרי השדרוג לאחור.

    ‫Edge for Private Cloud 4.50.00

    edge-gateway-4.50.00-0.0.20110
Edge-management-server-4.50.00-0.0.20110
edge-message-processor-4.50.00-0.0.20110
edge-postgres-server-4.50.00-0.0.20110
edge-qpid-server-4.50.00-0.0.20110
edge-router-4.50.00-0.0.20110

    ‫Edge for Private Cloud 4.19.06

    edge-gateway-4.19.06-0.0.20112
Edge-management-server-4.19.06-0.0.20112
edge-message-processor-4.19.06-0.0.20112
edge-postgres-server-4.19.06-0.0.20112
edge-qpid-server-4.19.06-0.0.20112
edge-router-4.19.06-0.0.20112

    שדרוג לאחור של NGINX

    כדי לשנמך את apigee-nginx, מבצעים את השלבים הבאים לנתב Edge, כל צומת בנפרד:

    1. מפסיקים את הנתב. 
      --apigee-service edge-router stop
    2. שדרוג לאחור של apigee-ngix. 
       -- sudo yum downgrade apigee-nginx
       גרסת apigee-nginx הצפויה אחרי השנמך: 
      -- yum list installed apigee-nginx
apigee-nginx.x86_64 -1.16.1-6.el7
    3. מגדירים את הנתב. 
      apigee-service edge-router configure
    4. מפעילים את הנתב. 
      apigee-service edge-router start