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

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

אפשר לחזור לגרסה הבאה של Edge 4.53.00:

  • גרסה 4.52.02

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

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

  1. חזרה לגרסה קודמת. לדוגמה, מ-4.53.00 ל-4.52.02.
  2. חזרה לגרסה קודמת של תיקון באותה גרסה. לדוגמה, מ-4.53.00.01 ל-4.53.00.00.

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

סדר הביטול לאחור

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

סדר אופרטיבי כללי לדחיפה לאחור ב-Private Cloud 4.53.00:

  1. ביטול Rollback של Postgres,‏ Qpid ורכיבים אחרים שקשורים לניתוח נתונים
  2. נתבים ומעבדי הודעות להחזרה למצב קודם
  3. Rollback Cassandra, ‏ Zookeeper
  4. שרת ניהול החזרה לאחור

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

  1. החזרה לאחור של כל ה-RMPs אחד אחרי השני
  2. ביטול טרנזקציות של כל האשכולות של Cassandra באמצעות גיבויים
  3. החזרה לאחור של צמתים של שרת Edge Management אחד אחרי השני

מי יכול לבצע החזרה לאחור

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

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

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

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

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

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

ביטול שינויים ב-Cassandra

ביטול שינויים ב-Cassandra

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

תרחישים של ביטול שינויים

גרסת Cassandra 4.0.X, שזמינה עם Edge for Private Cloud 4.53.00, תואמת לרכיבים אחרים של Private Cloud 4.52.02.

בטבלה הבאה מופיע סיכום של שיטות החזרה לאחור השונות שאפשר להשתמש בהן:

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

שיקולים כלליים

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

  • החזרה לגרסה קודמת של רכיבי זמן ריצה או רכיבי ניהול: אם רוצים לבצע החזרה לגרסה קודמת של רכיבים כמו edge-management-server,‏ edge-message-processor או כל רכיב שאינו Cassandra לגרסה 4.52.02 של Private Cloud, מומלץ לא לבצע החזרה לגרסה קודמת של Cassandra. גרסת Cassandra ששולחת עם Private Cloud 4.53.00 תואמת לכל הרכיבים שאינם Cassandra של Edge for Private Cloud 4.52.02. אפשר לבצע חזרה לגרסה הקודמת של רכיבים שאינם של Cassandra באמצעות השיטה שמפורטת כאן, בזמן שגרסת Cassandra נשארת בגרסה 4.0.13.
  • החזרה לאחור אחרי שכל האשכולות של Cassandra משודרגים לגרסה 4.0.X: אם כל האשכולות של Cassandra משודרגים לגרסה 4.0.X כחלק מהשדרוג לענן פרטי בגרסה 4.53.00, מומלץ להמשיך בהגדרת האשכול הזה ולא לבצע החזרה לאחור של Cassandra. רכיבים כמו edge-management-server,‏ edge-message-processor,‏ edge-router וכו' של Private Cloud בגרסה 4.52.02 תואמים ל-Cassandra בגרסה 4.0.X.
  • החזרה לאחור של Cassandra במהלך השדרוג של Cassandra: אם נתקלתם בבעיות במהלך השדרוג של Cassandra, כדאי לשקול לבצע החזרה לאחור. אפשר לפעול לפי אסטרטגיות החזרה לאחור שמפורטות במאמר הזה בהתאם למצב שבו אתם נמצאים במהלך תהליך השדרוג.
  • החזרה לאחור באמצעות גיבויים: גיבויים שנלקחו מ-Cassandra 4.0.X לא תואמים לגיבויים של Cassandra 3.11.X. כדי לבצע חזרה לאחור של Cassandra באמצעות שחזור גיבוי, צריך ליצור גיבויים של Cassandra 3.11.X לפני שמנסים לבצע את השדרוג.

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

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

  • אתם מפעילים אשכול של Edge for Private Cloud 4.52.02 במספר מרכזי נתונים.
  • אתם בתהליך שדרוג של Cassandra מ-3.11.X ל-4.0.X ונתקלת בבעיות במהלך השדרוג.
  • יש לכם לפחות מרכז נתונים אחד שפועל באופן מלא באשכול, שבו עדיין פועלת הגרסה הישנה יותר של Cassandra‏ (Cassandra 3.11.X).

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

שלבים ברמה גבוהה

  1. בוחרים מרכז נתונים אחד (ששדרגתם באופן חלקי או מלא) שרוצים לבצע בו חזרה לאחור. הפניית התנועה בסביבת זמן הריצה למרכז נתונים פעיל אחר.
  2. מאתרים את צומת המקור במרכז הנתונים ומתחילים באחד מצומתי המקור.
  3. עצירת הצומת של Cassandra, הסרתו וניקוי.
  4. מתקינים את הגרסה הישנה יותר של Cassandra בצומת ומגדירים אותה לפי הצורך.
  5. מסירים את ההגדרות הנוספות שנוספו קודם.
  6. חוזרים על השלבים שלמעלה לכל צומת זרע במרכז הנתונים, אחד אחרי השני.
  7. חוזרים על השלבים שלמעלה לכל צומת Cassandra שנותר במרכז הנתונים, אחד אחרי השני.
  8. צריך לבנות מחדש את הצמתים מתוך מרכז הנתונים הפונקציונלי הקיים, אחד אחרי השני.
  9. מפעילים מחדש את כל הרכיבים מסוג edge-* במרכז הנתונים שמחוברים ל-Cassandra.
  10. בודקים את תעבורת הנתונים ומנתבים אותה חזרה למרכז הנתונים הזה.
  11. חוזרים על השלבים בכל מרכז נתונים, אחד אחרי השני.

שלבים מפורטים

  1. בוחרים מרכז נתונים אחד שבו משדרגים את כל צמתי Cassandra או חלק מהם. הפניית כל תעבורת הנתונים של שרת ה-proxy בסביבת זמן הריצה ותעבורת הנתונים לניהול ממרכז הנתונים הזה, בזמן החזרה לאחור של צמתים של Cassandra במרכז הנתונים הזה. מוודאים שכל צמתים של Cassandra נמצאים במצב UN (פעיל/רגיל) כשמפעילים את הפקודה nodetool ring בצמתים. אם צמתים מסוימים לא פועלים, צריך לפתור את הבעיה ולהפעיל מחדש את הצמתים האלה לפני שממשיכים.

    דוגמה:

    /opt/apigee/apigee-cassandra/bin/nodetool status
Datacenter: dc-1
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC1-1IP1  456.41 KiB  1            100.0%            78fc4ddd-2ed9-4a8c-98a2-63a38c2f1920  ra-1
UN  DC1-1IP2  870.93 KiB  1            100.0%            160db01a-64ab-43a7-b9ea-3b7f8f66d52b  ra-1
UN  DC1-1IP3  824.08 KiB  1            100.0%            21d61543-d59e-403a-bf5d-bfe7f664baa6  ra-1
Datacenter: dc-2
================
Status=Up/Down
|/ State=Normal/Leaving/Joining/Moving
--  Address      Load       Tokens       Owns (effective)  Host ID                               Rack
UN  DC2-1IP1   802.08 KiB  1            100.0%            583e0576-336d-4ce7-9729-2ae74e0abde2  ra-1
UN  DC2-1IP2   844.4 KiB   1            100.0%            fef794d5-f4c2-4a4e-bb05-9adaeb4aea4b  ra-1
UN  DC2-1IP3   878.12 KiB  1            100.0%            3894b3d9-1f5a-444d-83db-7b1e338bbfc9  ra-1

    אפשר להריץ את הפקודה nodetool describecluster בצמתים כדי להבין את המצב הנוכחי של כל האשכולות. לדוגמה, בדוגמה הבאה מוצגת מכונה של אשכול עם 2 מרכזי נתונים, שבה כל הצמתים של DC-1 פועלים ב-Cassandra בגרסה 4, ואילו כל הצמתים של DC-2 פועלים ב-Cassandra בגרסה 3:

    # On nodes where Cassandra is upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]

Stats for all nodes:
    Live: 6
    Joining: 0
    Moving: 0
    Leaving: 0
    Unreachable: 0

Data Centers:
    dc-1 #Nodes: 3 #Down: 0
    dc-2 #Nodes: 3 #Down: 0

Database versions:
    4.0.13: [DC-1-IP1:7000, DC-1-IP2:7000, DC-1-IP3:7000]
    3.11.16: [DC-2-IP1:7000, DC-2-IP2:7000, DC-2-IP3:7000]

Keyspaces:
    system_schema -> Replication class: LocalStrategy {}
    system -> Replication class: LocalStrategy {}
    auth -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    cache -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    devconnect -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    dek -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    user_settings -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apprepo -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    kms -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    identityzone -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    audit -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    analytics -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    keyvaluemap -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    counter -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    apimodel_v2 -> Replication class: NetworkTopologyStrategy {dc-2=3, dc-1=3}
    system_distributed -> Replication class: SimpleStrategy {replication_factor=3}
    system_traces -> Replication class: SimpleStrategy {replication_factor=2}
    system_auth -> Replication class: SimpleStrategy {replication_factor=1}

# On nodes where Cassandra is not upgraded
/opt/apigee/apigee-cassandra/bin/nodetool describecluster
Cluster Information:
    Name: Apigee
    Snitch: org.apache.cassandra.locator.PropertyFileSnitch
    DynamicEndPointSnitch: enabled
    Partitioner: org.apache.cassandra.dht.RandomPartitioner
    Schema versions:
        2eadcd74-0245-309a-9992-3625afa70038: [DC-1-IP1, DC-1-IP2, DC-1-IP3]
        129dc15e-198e-3c11-b64c-701044a3a1ad: [DC-2-IP1, DC-2-IP2, DC-2-IP3]
  2. מזהים את צמתים המקור במרכז הנתונים: אפשר לעיין בקטע איך מזהים צמתים מקור שבנספח. מבצעים את השלבים הבאים באחד מצמתי ה-seed:
  3. איך מפסיקים, מסירים ומנקים נתונים מהצומת של Cassandra. בוחרים את צומת הזרע הראשון ב-Cassandra בגרסה 4 במרכז הנתונים הזה. תפסיקו. 
    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe out Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra
  4. מתקינים את תוכנת Cassandra הישנה בצומת ומגדירים כמה הגדרות. מריצים את קובץ ה-bootstrap של Edge for Private Cloud 4.52.02. 
    5. # Download bootstrap of 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u uName:pWord

# Execute bootstrap of 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

הגדרת ההגדרות של Cassandra

  1. יוצרים או עורכים את הקובץ /opt/apigee/customer/application/cassandra.properties.
  2. מוסיפים לקובץ את התוכן הבא. ipOfNode היא כתובת ה-IP של הצומת ש-Cassandra משתמשת בה כדי לתקשר עם צמתים אחרים של Cassandra: 
    conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
  3. מוודאים שהקובץ נמצא בבעלות של משתמש apigee ואפשר לקרוא אותו: 
    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
  4. התקנה והגדרה של Cassandra:
    • התקנה של Cassandra בגרסה 3.11.X: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install
    • מגדירים את Cassandra על ידי העברת קובץ התצורה הרגיל: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile
    • מוודאים ש-Cassandra 3.11.X מותקנת והשירות פועל: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
      /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status
  5. מוודאים שהצומת התחיל לפעול. בודקים את הפקודה הבאה בצומת הזה ובצומתים אחרים באשכול. הצומת אמור לדווח שהוא נמצא בסטטוס 'UN' (פעיל/רגיל): 
    /opt/apigee/apigee-cassandra/bin/nodetool status
  6. מסירים מהקובץ /opt/apigee/customer/application/cassandra.properties את ההגדרות הנוספות שנוספו קודם.
  7. חוזרים על שלבים 3 עד 6 בכל צמתים המקור של Cassandra במרכז הנתונים, אחד אחרי השני.
  8. חוזרים על שלבים 3 עד 6 בכל צמתים הנותרים של Cassandra במרכז הנתונים, אחד אחרי השני.
  9. יצירת מחדש של כל הצמתים במרכז הנתונים ממרכז נתונים שבו פועלת גרסת Cassandra ישנה יותר. מבצעים את השלב הזה בצורה ידנית בכל צומת בנפרד: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc <name of working DC>
    ההליך הזה עשוי להימשך זמן מה. אם צריך, אפשר לשנות את הערך של streamingthroughput. אפשר לבדוק את הסטטוס באמצעות: 
    /opt/apigee/apigee-cassandra/bin/nodetool netstats
  10. מפעילים מחדש את כל הרכיבים מסוג edge-* במרכז הנתונים, אחד אחרי השני: 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
  11. אימות ותעבורת נתונים חזרה למרכז הנתונים הזה. מריצים כמה בדיקות לאימות של תעבורת נתונים בסביבת זמן הריצה וממשקי API לניהול במרכז הנתונים הזה, ומתחילים לנתב מחדש את תעבורת הנתונים של שרת proxy וממשקי API לניהול אליו.
  12. חוזרים על השלבים שלמעלה לכל מרכז נתונים שרוצים לבצע בו חזרה לאחור.

ביטול השינויים ב-Cassandra באמצעות גיבוי

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

  1. אתם בתהליך שדרוג של Cassandra מ-3.11.X ל-4.0.X ונתקלת בבעיות במהלך השדרוג.
  2. יש לכם גיבויים של הצומת שאליו אתם רוצים לחזור. הגיבוי בוצע לפני ניסיון השדרוג מ-3.11.X ל-4.0.X.

שלבים

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

  2. עוצרים, מסירים ומנקים את צומת Cassandra:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Uninstall Cassandra software
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra uninstall

# Wipe Cassandra data
rm -rf /opt/apigee/data/apigee-cassandra

  3. מתקינים את תוכנת Cassandra הישנה בצומת ומגדירים אותה:

    • מריצים את קובץ ה-bootstrap של Edge for Private Cloud 4.52.02:
      • # Download bootstrap for 4.52.02
curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh -u ‘uName:pWord’

# Execute bootstrap for 4.52.02
sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord
    • יוצרים או עורכים את הקובץ /opt/apigee/customer/application/cassandra.properties:
      • conf_jvm_options_custom_settings=-Dcassandra.replace_address=ipOfNode -Dcassandra.allow_unsafe_replace=true
    • מוודאים שהקובץ בבעלות משתמש apigee ואפשר לקרוא אותו:
      • chown apigee:apigee /opt/apigee/customer/application/cassandra.properties
    • מתקינים ומגדירים את Cassandra:
      • # Install Cassandra version 3.11.X
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra install

# Set up Cassandra with the standard configuration file
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra setup -f configFile

# Verify Cassandra version and check service status
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra version
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra status

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

    /opt/apigee/apigee-cassandra/bin/nodetool status

  4. מפסיקים את שירות Cassandra ומשחזרים את הגיבוי. פרטים נוספים זמינים במסמכי התיעוד בנושא גיבוי ושחזור:

    # Stop Cassandra service on the node
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra stop

# Wipe the data directory in preparation for restore
rm -rf /opt/apigee/data/apigee-cassandra/data

# Restore the backup taken before the upgrade attempt
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restore backupFile

  5. אחרי שחזור הגיבוי, מסירים את ההגדרות הנוספות:

    מסירים מהקובץ /opt/apigee/customer/application/cassandra.properties את ההגדרה שנוספה קודם.

  6. מפעילים את שירות Cassandra בצומת:

    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra start

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

  8. אחרי שכל צמתי Cassandra ישוחזרו, מפעילים מחדש את כל הרכיבים מסוג edge-* אחד אחרי השני:

    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

אופטימיזציה של הגיבוי (אפשרות מתקדמת)

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

נספח

איך מזהים צמתים מקור

בכל צומת של Cassandra במרכז נתונים, מריצים את הפקודה הבאה:

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra configure -search conf_cassandra_seeds

הפקודה תציג מספר שורות בפלט. מחפשים את השורה האחרונה בפלט. כתובות ה-IP שמפורטות בשורה האחרונה הן צמתים מקוריים. בדוגמה הבאה, DC-1-IP1,‏ DC-1-IP2,‏ DC-2-IP1 ו-DC-2-IP2 הן כתובות ה-IP של צמת ה-seed:

Found key conf_cassandra_seeds, with value, "127.0.0.1", in /opt/apigee/apigee-cassandra/token/default.properties

Found key conf_cassandra_seeds, with value, 127.0.0.1, in /opt/apigee/apigee-cassandra/token/application/cassandra.properties

Found key conf_cassandra_seeds, with value, "DC-1-IP1, DC-1-IP2, DC-2-IP1, DC-2-IP2", in /opt/apigee/token/application/cassandra.properties
apigee-configutil: apigee-cassandra: # OK

חזרה לגרסה קודמת (מיור או מיינור)

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

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

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

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

כדי לבטל את העדכון של mTLS, מבצעים את השלבים הבאים בכל המארחים:

  1. עצירת Apigee: 
    apigee-all stop
  2. הפסקת mTLS: 
    apigee-service apigee-mtls uninstall
  3. התקנה מחדש של mTLS: 
    apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf