עדכון של Apigee Edge מגרסה 4.52.02 לגרסה 4.53.00

‫Apigee תומכת בשדרוג של Edge for Private Cloud ישירות מגרסה 4.52.02 לגרסה 4.53.00. בדף הזה מוסבר איך לבצע שדרוגים כאלה.

סקירה כללית של נתיבי שדרוג תואמים זמינה בטבלת התאימות לשדרוג של מהדורות Edge for Private Cloud.

מי יכול לבצע את העדכון

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

אחרי שמתקינים את חבילות ה-RPM של Edge, כל אחד יכול להגדיר אותן.

אילו רכיבים צריך לעדכן

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

עדכון הדרישות המוקדמות

לפני שמשדרגים את Apigee Edge, חשוב לוודא שמתקיימות הדרישות המוקדמות הבאות:

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

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

  • מוודאים ש-Edge פועל
    כדי לוודא ש-Edge פועל במהלך תהליך העדכון, משתמשים בפקודה: 
    /opt/apigee/apigee-service/bin/apigee-all status
  • אימות הדרישות המוקדמות של Cassandra

    אם שדרגתם בעבר מגרסה ישנה יותר של Edge for Private Cloud לגרסה 4.52.02, ועכשיו אתם מתכננים לשדרג לגרסה 4.53.00, הקפידו לבצע את השלבים הנדרשים אחרי השדרוג של Cassandra. השלבים האלה מפורטים במסמכי השדרוג של גרסה 4.52.02, ומוזכרים גם בקטע תנאים מוקדמים לשדרוג Cassandra. אם אתם לא בטוחים שהשלבים האלה בוצעו במהלך השדרוג הקודם, צריך לבצע אותם שוב לפני שממשיכים בשדרוג לגרסה 4.53.00.

  • הגדרת מפתחות ואישורים של ספק זהויות ב-Edge לענן פרטי 4.53.00

    ב-Edge for Private Cloud 4.53.00, מפתחות ואישורים של ספק הזהויות שמשמשים ברכיב apigee-sso מוגדרים עכשיו באמצעות מאגר מפתחות. תצטרכו לייצא את המפתח והאישור שבהם השתמשתם קודם ל-keystore. לפני שמעדכנים את רכיב ה-SSO, צריך לפעול לפי השלבים המפורטים בקטע הוראות לעדכון Apigee SSO מגרסאות ישנות יותר.

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

הפצה אוטומטית של הגדרות הנכס

אם הגדרתם מאפיינים כלשהם על ידי עריכת קובצי .properties ב-/opt/apigee/customer/application, הערכים האלה יישמרו אחרי העדכון.

שדרוג Nginx 1.26 ב-Edge-Router

אם משדרגים ל-Edge for Private Cloud 4.53.00 מגרסאות קודמות, תוכנת Nginx לא משודרגת אוטומטית לגרסה האחרונה (1.26.x). השינוי הזה נועד למנוע תופעות לוואי לא מכוונות בזמן הריצה כתוצאה מהשינויים שמפורטים במאמר Nginx 1.26 changes in Apigee Edge 4.53.00. אחרי האימות בסביבות נמוכות יותר, אפשר לשדרג את Nginx מגרסה 1.20.x לגרסה 1.26.x באופן ידני. כדי לשדרג באופן ידני:

  1. מוודאים שבצומת של נתב הקצה מותקנת התוכנה העדכנית ביותר, 4.53.00

    /opt/apigee/apigee-service/bin/apigee-service edge-router version

  2. בדיקה ואימות של גרסת Nginx שפועלת כרגע

    /opt/nginx/sbin/nginx -V

    אם אתם משתמשים בגרסה ישנה יותר של Nginx, אתם יכולים לפעול לפי השלבים הבאים כדי לשדרג את Nginx לגרסה 1.26.X בצומת הנתב.

  3. הפסקת התהליך של נתב קצה בצומת הנתב

    /opt/apigee/apigee-service/bin/apigee-service edge-router stop

  4. שדרוג תוכנת nginx בצומת הנתב

    dnf update apigee-nginx

  5. מוודאים שגרסת Nginx עודכנה

    /opt/nginx/sbin/nginx -V

  6. הפעלת תהליך הנתב בצומת

    /opt/apigee/apigee-service/bin/apigee-service edge-router start

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

נדרש שדרוג ל-Cassandra 4.0.13

‫Apigee Edge for Private Cloud 4.53.00 כולל שדרוג של Cassandra לגרסה 4.0.13.

שדרוגים וביטול שינויים

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

מרכז נתונים יחיד

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

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

כמה מרכזי נתונים

הפעלת מספר מרכזי נתונים עם Edge for Private Cloud 4.52.02 מאפשרת גמישות רבה יותר בהחזרה לגרסה קודמת במהלך השדרוג ל-Edge for Private Cloud 4.53.00.

  • החזרה לגרסה קודמת תלויה בכך שלפחות מרכז נתונים אחד מריץ את הגרסה הישנה יותר של Cassandra‏ (3.11.X).
  • אם כל אשכול Cassandra שודרג לגרסה 4.0.X, אסור לחזור לגרסה 3.11.X של Cassandra. צריך להמשיך להשתמש בגרסה החדשה יותר של Cassandra עם הרכיבים האחרים של Private Cloud 4.53.00 או 4.52.02.
  1. משדרגים מרכז נתונים אחד של Cassandra בכל פעם: מתחילים בשדרוג של צמתי Cassandra בנפרד בתוך מרכז נתונים יחיד. משלימים את השדרוגים של כל צמתי Cassandra במרכז נתונים אחד לפני שעוברים למרכז הבא.
  2. השהיה ואימות: אחרי השדרוג של מרכז נתונים אחד, משהים את הפעולה כדי לוודא שקלאסטר הענן הפרטי, ובמיוחד מרכז הנתונים ששודרג, פועל בצורה תקינה.
  3. חשוב לזכור: אפשר לחזור לגרסה הקודמת של Cassandra רק אם יש לכם לפחות מרכז נתונים אחד שעדיין פועלת בו הגרסה הישנה.
  4. רגיש לזמן: אפשר להשהות את המעבר לפרק זמן קצר (מומלץ לכמה שעות) כדי לאמת את הפונקציונליות, אבל אי אפשר להישאר במצב של גרסה מעורבת לזמן בלתי מוגבל. הסיבה לכך היא שלקלאסטר Cassandra לא אחיד (עם צמתים בגרסאות שונות) יש מגבלות תפעוליות.
  5. בדיקה יסודית: מומלץ מאוד לבצע בדיקה מקיפה של הביצועים והפונקציונליות לפני שמשדרגים את מרכז הנתונים הבא. אחרי שכל מרכזי הנתונים ישודרגו, לא תהיה אפשרות לחזור לגרסה הקודמת.
חזרה לגרסה קודמת כתהליך עם שתי נקודות ביקורת
  1. נקודת ביקורת 1: המצב ההתחלתי, שבו כל הרכיבים הם בגרסה 4.52.02. אפשר לבצע חזרה מלאה לגרסה הקודמת כל עוד לפחות מרכז נתונים אחד של Cassandra נשאר בגרסה הקודמת.
  2. נקודת ביקורת 2: אחרי שכל צמתי Cassandra בכל מרכזי הנתונים מתעדכנים. אפשר לחזור למצב הזה, אבל אי אפשר לחזור לנקודת הבדיקה 1.
דוגמה

נניח שיש לכם קלאסטר עם שני מרכזי נתונים (DC):

  1. מצב התחלתי: צמתי Cassandra בשני מרכזי הנתונים הם בגרסה 3.11.X. כל שאר הצמתים נמצאים ב-Edge for Private Cloud בגרסה 4.52.02. נניח שיש שלושה צמתי Cassandra בכל מרכז נתונים.
  2. שדרוג DC-1: משדרגים את שלושת צמתי Cassandra ב-DC-1 אחד אחרי השני.
  3. השהיה ואימות: מבצעים השהיה כדי לוודא שהאשכול, ובמיוחד DC-1, פועל בצורה תקינה (בודקים את הביצועים והפונקציונליות). אפשר לחזור למצב ההתחלתי באמצעות צמתי Cassandra ב-DC-2. חשוב לזכור שההשהיה הזו חייבת להיות זמנית בגלל המגבלות של אשכול Cassandra עם גרסאות מעורבות.
  4. שדרוג DC-2: משדרגים את שלושת צמתי Cassandra שנותרו ב-DC-2. הנקודה הזו הופכת לנקודת הבדיקה החדשה של החזרה לגרסה קודמת.
  5. שדרוג רכיבים אחרים: משדרגים את ניהול הנתונים, את זמן הריצה ואת צמתי הניתוח כרגיל בכל מרכזי הנתונים, צומת אחד ומרכז נתונים אחד בכל פעם. אם מתעוררות בעיות, אפשר לחזור למצב של שלב 4.

דרישות מוקדמות לשדרוג Cassandra

צריך להפעיל את Cassandra 3.11.16 עם Edge for Private Cloud 4.52.02 ולוודא את הדברים הבאים:
  1. האשכול כולו פועל וכל הפונקציות שלו זמינות עם Cassandra 3.11.16.
  2. אסטרטגיית הדחיסה מוגדרת ל-LeveledCompactionStrategy (דרישה מוקדמת לשדרוג לגרסה 4.52.02).
  3. צריך לוודא שכל השלבים הבאים בוצעו כחלק מהשדרוג הראשוני של Cassandra 3.11 ב-Edge לענן פרטי בגרסה 4.52.02:
    • הפקודה post_upgrade הייתה צריכה להיות מופעלת בכל צומת של Cassandra במהלך השדרוג הקודם.
    • הפקודה drop_old_tables הייתה אמורה להיות מופעלת על כל אשכול Cassandra במהלך השדרוג הקודם.

אם אתם לא בטוחים שהשלבים הקודמים הושלמו, אתם יכולים להריץ אותם שוב. חשוב לוודא שהשלבים האלה מבוצעים ב-Cassandra 3.11 בזמן שאתם עדיין ב-Edge for Private Cloud 4.52.02, לפני שמנסים לשדרג ל-4.53.00:

  1. מריצים את הפקודה post_upgrade הבאה בכל צומת של Cassandra, אחד אחרי השני: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  2. מריצים את הפקודה הבאה כדי להסיר טבלאות ישנות שלא נמצאות בשימוש מאשכול Cassandra. צריך להריץ את הפקודה הזו רק בצומת אחד באשכול: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

שלב 1: הכנה לשדרוג

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

  1. גיבוי של Cassandra באמצעות Apigee.
  2. יוצרים תמונות מצב של מכונות וירטואליות של צמתי Cassandra (אם אפשר).
  3. אם עדיין לא הגדרתם את יציאה 9042, ודאו שהיא נגישה מכל הרכיבים של Edge for Private Cloud, כולל שרת הניהול, מעבד ההודעות, הנתב, Qpid ו-Postgres, לצמתים של Cassandra. מידע נוסף מופיע במאמר בנושא דרישות לגבי יציאות.

שלב 2: משדרגים את כל צמתי Cassandra

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

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

  1. כדי לשדרג צומת Cassandra, מריצים את הפקודה הבאה: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. אחרי שמעדכנים צומת, מריצים את הפקודה הבאה בצומת כדי להריץ כמה אימותים לפני שממשיכים: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
  3. הפלט של הפקודה שלמעלה ייראה בערך כך: 
    Cassandra version is verified - [cqlsh 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. מריצים את הפקודה post_upgrade הבאה בצומת Cassandra: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. מריצים את הפקודות הבאות של nodetool כדי לבנות מחדש את האינדקסים בצומת Cassandra: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     אם אתם משתמשים במונטיזציה, מריצים גם את הפקודות הבאות של בנייה מחדש של אינדקסים שקשורות למרחבי מפתחות של מונטיזציה: 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

שלב 3: שדרוג כל צמתי הניהול

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

שלב 4: שדרוג כל צמתי זמן הריצה

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

/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

שלב 5: משדרגים את כל הרכיבים שנותרו ב-Edge for Private Cloud 4.53.00

משדרגים את כל הצמתים שנותרו מסוג edge-qpid-server ו-edge-postgres-server בכל האזורים, אחד אחרי השני.

שלבים לעדכון Apigee SSO מגרסאות ישנות יותר

ב-Edge for Private Cloud 4.53.00, המפתחות והאישורים של ספק הזהויות שמשמשים ברכיב apigee-sso מוגדרים עכשיו דרך מאגר מפתחות. תצטרכו לייצא את המפתח והאישור שבהם השתמשתם קודם למאגר מפתחות, להגדיר אותו ואז להמשיך בעדכון ה-SSO כרגיל.

  1. מזהים את המפתח והאישור הקיימים שמשמשים להגדרת ספק הזהויות:

    1. מאחזרים את האישור על ידי חיפוש הערך של SSO_SAML_SERVICE_PROVIDER_CERTIFICATE בקובץ התצורה של התקנת ה-SSO או על ידי שליחת שאילתה לרכיב apigee-sso לגבי conf_login_service_provider_certificate.

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

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. מאחזרים את המפתח על ידי חיפוש הערך של SSO_SAML_SERVICE_PROVIDER_KEY בקובץ ההגדרות של התקנת ה-SSO או על ידי שליחת שאילתה לרכיב apigee-sso לגבי conf_login_service_provider_key.

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

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. מייצאים את המפתח והאישור למאגר מפתחות:
    1. מייצאים את המפתח והאישור אל מאגר מפתחות PKCS12: 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      פרמטרים:

      • ‫certificate_path: הנתיב לקובץ האישור שאוחזר בשלב 1.א.
      • ‫key_path: הנתיב לקובץ המפתח הפרטי שאוחזר בשלב 1.ב.
      • ‫keystore_path: הנתיב למאגר המפתחות שנוצר לאחרונה ומכיל את האישור ואת המפתח הפרטי.
      • ‫alias: הכינוי שמשמש לזוג המפתחות והאישורים במאגר המפתחות.

      פרטים נוספים זמינים בתיעוד של OpenSSL.

    2. (אופציונלי) מייצאים את המפתח והאישור מ-PKCS12 למאגר מפתחות JKS: 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      פרמטרים:

      • ‫PKCS12_keystore_path: הנתיב למאגר המפתחות PKCS12 שנוצר בשלב 2א, שמכיל את האישור והמפתח.
      • ‫destination_keystore_path: הנתיב למאגר המפתחות החדש בפורמט JKS שאליו ייוצאו האישור והמפתח.
      • ‫alias: שם הכינוי שמשמש לזוג המפתחות והאישורים במאגר המפתחות JKS.

      3. פרטים נוספים זמינים בתיעוד של keytool.

  3. משנים את הבעלים של קובץ מאגר המפתחות של הפלט למשתמש apigee: 
    sudo chown apigee:apigee <keystore_file>
  4. מוסיפים את המאפיינים הבאים ב קובץ התצורה של Apigee SSO ומעדכנים אותם עם הנתיב לקובץ של מאגר המפתחות, הסיסמה, סוג מאגר המפתחות והכינוי: 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. מעדכנים את תוכנת Apigee SSO בצומת ה-SSO כרגיל באמצעות הפקודה הבאה: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

ממשק משתמש חדש של Edge

בקטע הזה מפורטים שיקולים לגבי ממשק המשתמש של Edge. מידע נוסף זמין במאמר ממשק המשתמש החדש של Edge ל-Private Cloud.

התקנת ממשק המשתמש של Edge

אחרי שמסיימים את ההתקנה הראשונית, מומלץ להתקין את ממשק המשתמש של Edge, שהוא ממשק משתמש משופר למפתחים ולמנהלים של Apigee Edge לענן פרטי.

שימו לב: בממשק המשתמש של Edge צריך להשבית את האימות הבסיסי ולהשתמש בIDP כמו SAML או LDAP.

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

עדכון באמצעות Apigee mTLS

כדי לעדכן את Apigee mTLS , פועלים לפי השלבים הבאים:

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

אם העדכון נכשל, אפשר לנסות לתקן את הבעיה ואז להריץ את הפקודה update.sh שוב. אפשר להריץ את העדכון כמה פעמים, והוא ימשיך מהנקודה שבה הוא הפסיק בפעם האחרונה.

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

רישום מידע על עדכונים

כברירת מחדל, כלי השירות update.sh כותב את פרטי היומן אל:

/opt/apigee/var/log/apigee-setup/update.log

אם לאדם שמריץ את כלי השירות update.sh אין גישה לספרייה הזו, היומן נכתב לספרייה /tmp כקובץ בשם update_username.log.

אם לאדם אין גישה ל-/tmp, כלי השירות update.sh ייכשל.

עדכון ללא השבתה

עדכון ללא השבתה, או עדכון מתגלגל, מאפשר לכם לעדכן את ההתקנה של Edge בלי להשבית את Edge.

אפשר לבצע עדכון ללא השבתה רק בהגדרה של 5 צמתים ומעלה.

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

  1. מעדכנים את המכונות בסדר הנכון להתקנה, כמו שמתואר בסדר העדכון של המכונות.
  2. כשמגיע הזמן לעדכן את הנתבים, בוחרים נתב כלשהו וגורמים לכך שלא תהיה אליו גישה, כמו שמתואר במאמר הפעלה או השבתה של הגישה לשרת (מעבד הודעות או נתב).
  3. מעדכנים את הנתב שנבחר ואת כל רכיבי Edge האחרים באותו מחשב שבו מותקן הנתב. בכל ההגדרות של Edge מוצגים Router ו-Message Processor באותו הצומת.
  4. מוודאים שאפשר להגיע לנתב.
  5. חוזרים על שלבים 2 עד 4 בשביל שאר הנתבים.
  6. ממשיכים את העדכון בכל המחשבים שנותרו בהתקנה.

לפני ואחרי העדכון, חשוב לבצע את הפעולות הבאות:

שימוש בקובץ תצורה שקט

צריך להעביר קובץ תצורה שקט לפקודת העדכון. קובץ התצורה השקט צריך להיות אותו קובץ שבו השתמשתם כדי להתקין את Edge for Private Cloud 4.52.02.

עדכון לגרסה 4.53.00 בצומת עם חיבור אינטרנט חיצוני

כדי לעדכן את רכיבי Edge בצומת, מבצעים את הפעולות הבאות:

  1. אם יש משימות cron שמוגדרות לבצע פעולת תיקון ב-Cassandra, צריך להשבית אותן עד לסיום העדכון.
  2. מתחברים לצומת כמשתמש root כדי להתקין את חבילות ה-RPM של Edge.
  3. משביתים את SELinux כמו שמתואר במאמר התקנה של כלי השירות apigee-setup של Edge.
  4. אם אתם מתקינים ב-AWS, מריצים את הפקודות הבאות של yum-configure-manager: 
    yum update rh-amazon-rhui-client.noarch
sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

  5. אם אתם משתמשים כרגע ב-Edge 4.52.02:

    1. מורידים את קובץ Edge bootstrap_4.53.00.sh אל /tmp/bootstrap_4.53.00.sh: 
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
    2. כדי להתקין את כלי השירות Edge 4.53.00 apigee-service ואת יחסי התלות, מריצים את הפקודה הבאה: 
      sudo bash /tmp/bootstrap_4.53.00.sh apigeeuser=uName apigeepassword=pWord

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

      כברירת מחדל, תוכנת ההתקנה בודקת אם Java 1.8 מותקנת. אם לא, תוכנת ההתקנה תתקין אותו בשבילכם.

      משתמשים באפשרות JAVA_FIX כדי לציין איך לטפל בהתקנה של Java. המאפיין JAVA_FIX יכול לקבל את הערכים הבאים:

      • ‫I: התקנה של OpenJDK 1.8 (ברירת מחדל).
      • ‫C: המשך ללא התקנת Java.
      • ‫Q: יציאה. כדי להשתמש באפשרות הזו, צריך להתקין את Java באופן עצמאי.
    3. משתמשים בפקודה apigee-service כדי לעדכן את כלי השירות apigee-setup, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    4. מעדכנים את כלי השירות apigee-validate בשרת הניהול, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    5. מעדכנים את כלי השירות apigee-provision בשרת הניהול, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
    6. מריצים את כלי השירות update בצמתים באמצעות הפקודה הבאה: 
      /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

      צריך לבצע את הפעולות בסדר שמתואר במאמר סדר העדכון של המכונה.

      כאשר:

      • ‫component הוא רכיב Edge שרוצים לעדכן. הערכים האפשריים כוללים:
        • ‫cs: Cassandra
        • ‫edge: כל רכיבי Edge מלבד ממשק המשתמש של Edge: שרת הניהול, מעבד ההודעות, הנתב, שרת QPID, שרת Postgres
        • ‫ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • ‫sso: Apigee SSO (אם התקנתם SSO)
        • ‫ue: ממשק משתמש חדש של Edge
        • ‫ui: ממשק המשתמש של הגרסה הקלאסית של Edge
        • zk: Zookeeper
      • ‫configFile הוא אותו קובץ הגדרות שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסה 4.52.02.

      אפשר להריץ את update.sh על כל הרכיבים על ידי הגדרת component ל-all, אבל רק אם יש לכם פרופיל התקנה של Edge all-in-one (AIO). לדוגמה:

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
    7. אם עדיין לא עשיתם את זה, מפעילים מחדש את רכיבי Edge UI בכל הצמתים שבהם הם פועלים: 
      /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
    8. כדי לבדוק את העדכון, מריצים את כלי השירות apigee-validate בשרת הניהול, כמו שמתואר במאמר בדיקת ההתקנה.

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

עדכון לגרסה 4.53.00 ממאגר מקומי

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

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

  • יוצרים קובץ ‎ .tar של המאגר, מעתיקים את קובץ ה-‎ .tar לצומת ומעדכנים את Edge מקובץ ה-‎.tar.
  • מתקינים שרת אינטרנט בצומת עם המאגר המקומי כדי שצמתים אחרים יוכלו לגשת אליו. ‫Apigee מספקת לכם את שרת האינטרנט Nginx, או שאתם יכולים להשתמש בשרת אינטרנט משלכם.

כדי לעדכן ממאגר מקומי בגרסה 4.53.00:

  1. יוצרים מאגר מקומי בגרסה 4.53.00 כמו שמתואר במאמר בנושא התקנת כלי השירות apigee-setup של Edge.
  2. כדי להתקין את apigee-service מקובץ ‎ .tar:
    1. בצומת עם המאגר המקומי, משתמשים בפקודה הבאה כדי לארוז את המאגר המקומי לקובץ ‎ .tar יחיד בשם /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. מעתיקים את קובץ ה-‎ .tar לצומת שבו רוצים לעדכן את Edge. לדוגמה, מעתיקים אותו לספרייה /tmp בצומת החדש.
    3. בצומת החדש, מבטלים את הדחיסה של הקובץ בספרייה /tmp: 
      tar -xzf apigee-4.53.00.tar.gz

      הפקודה הזו יוצרת ספרייה חדשה בשם repos בספרייה שמכילה את קובץ ה-‎ .tar. לדוגמה /tmp/repos.

    4. מתקינים את כלי השירות Edge apigee-service ואת יחסי התלות מ-/tmp/repos: 
      sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      שימו לב שכוללים בפקודה הזו את הנתיב לספריית המאגרים.

  3. כדי להתקין את apigee-service באמצעות שרת האינטרנט Nginx:
    1. מגדירים את שרת האינטרנט Nginx כמו שמתואר במאמר בנושא התקנה של כלי השירות apigee-setup של Edge בקטע 'התקנה ממאגר באמצעות שרת האינטרנט Nginx'.
    2. בצומת המרוחק, מורידים את קובץ Edge bootstrap_4.53.00.sh אל /tmp/bootstrap_4.53.00.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh

      כאשר uName:pWord הם שם המשתמש והסיסמה שהגדרתם קודם למאגר, ו-remoteRepo היא כתובת ה-IP או שם ה-DNS של צומת המאגר.

    3. בצומת המרוחק, מתקינים את כלי השירות Edge apigee-setup ואת יחסי התלות: 
      sudo bash /tmp/bootstrap_4.53.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      כאשר uName:pWord הם שם המשתמש והסיסמה של המאגר.

  4. משתמשים בפקודה apigee-service כדי לעדכן את כלי השירות apigee-setup, כמו בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. מעדכנים את כלי השירות apigee-validate בשרת הניהול, כמו בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. מעדכנים את כלי השירות apigee-provision בשרת הניהול, כמו בדוגמה הבאה: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. מריצים את כלי השירות update בצמתים לפי הסדר שמתואר במאמר סדר העדכון של המכונות: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    כאשר:

    • ‫component הוא רכיב Edge שרוצים לעדכן. בדרך כלל מעדכנים את הרכיבים הבאים:
      • ‫cs: Cassandra
      • ‫edge: כל רכיבי Edge חוץ מממשק המשתמש של Edge: שרת הניהול, מעבד ההודעות, הנתב, שרת QPID, שרת Postgres
      • ‫ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • ‫sso: Apigee SSO (אם התקנתם SSO)
      • ue ממשק משתמש חדש של Edge
      • ‫ui: ממשק המשתמש של הגרסה הקלאסית של Edge
      • zk: Zookeeper
    • ‫configFile הוא אותו קובץ הגדרות שבו השתמשתם כדי להגדיר את רכיבי Edge במהלך ההתקנה של גרסה 4.50.00 או 4.51.00.

    אפשר להריץ את update.sh על כל הרכיבים על ידי הגדרת component ל-all, אבל רק אם יש לכם פרופיל התקנה של Edge all-in-one (AIO). לדוגמה:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. אם עדיין לא עשיתם את זה, מפעילים מחדש את רכיבי ממשק המשתמש בכל הצמתים שבהם הוא פועל: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
  9. כדי לבדוק את העדכון, מריצים את כלי השירות apigee-validate בשרת הניהול, כמו שמתואר במאמר בדיקת ההתקנה.

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

סדר העדכון של המכונה

הסדר שבו מעדכנים את המכונות בהתקנת Edge הוא חשוב:

  • חובה לעדכן את כל הצמתים של Cassandra ו-ZooKeeper לפני שמעדכנים צמתים אחרים.
  • בכל מכונה עם כמה רכיבי Edge (שרת ניהול, מעבד הודעות, נתב, שרת QPID אבל לא שרת Postgres), משתמשים באפשרות -c edge כדי לעדכן את כולם בו-זמנית.
  • אם בשלב מסוים מצוין שהוא צריך להתבצע בכמה מכונות, צריך לבצע אותו לפי סדר המכונות שצוין.
  • אין שלב נפרד לעדכון המונטיזציה. הוא מתעדכן כשמציינים את האפשרות -c edge.

שדרוג עצמאי עם צומת אחד

כדי לשדרג הגדרה עצמאית עם צומת אחד לגרסה 4.53.00:

  1. עדכון כל הרכיבים: 
    /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
  2. (אם התקנתם את apigee-adminapi) מעדכנים את כלי השירות apigee-adminapi: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

שדרוג עצמאי של 2 צמתים

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

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות התקנה.

  1. מעדכנים את Cassandra ואת ZooKeeper במכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres במחשב 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. מעדכנים את רכיבי Edge במכונה 2 ובמכונה 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. מעדכנים את Qpid במחשב 2: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מעדכנים את ממשק המשתמש במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. (אם התקנתם את apigee-adminapi) עדכנתם את כלי השירות apigee-adminapi במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ‫sso_config_file הוא קובץ ההגדרות שיצרתם כשהתקנתם את ה-SSO.

  9. מפעילים מחדש את רכיב Edge UI במכונה 1: 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

שדרוג של 5 צמתים

כדי לעדכן את הרכיבים הבאים בהתקנה של 5 צמתים:

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות התקנה.

  1. מעדכנים את Cassandra ואת ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres במחשב 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את Postgres במכונה 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. מעדכנים את LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. עדכון רכיבי Edge במכונות 4, 5, 1, 2, 3: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. מעדכנים את Qpid במחשב 4: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. מעדכנים את Qpid במחשב 5: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. עדכון ממשק המשתמש של Edge:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, אתם צריכים לעדכן את הרכיב ui במכונה 1, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    • ממשק משתמש חדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך לעדכן את הרכיב ue במכונה המתאימה (יכול להיות שלא מדובר במכונה 1): 
      /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf
  9. (אם התקנתם את apigee-adminapi) עדכנתם את כלי השירות apigee-adminapi במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  10. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ‫sso_config_file הוא קובץ ההגדרות שיצרתם כשהתקנתם את ה-SSO.

  11. מפעילים מחדש את רכיב ממשק המשתמש:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, עליכם להפעיל מחדש את הרכיב edge-ui במכונה 1, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק משתמש חדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את רכיב edge-management-ui במחשב המתאים (יכול להיות שלא מדובר במחשב 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג של אשכול עם 9 צמתים

צריך לעדכן את הרכיבים הבאים בהתקנה של אשכול עם 9 צמתים:

רשימת הטופולוגיות של Edge ומספרי הצמתים מופיעה במאמר טופולוגיות של התקנות.

  1. מעדכנים את Cassandra ואת ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres במחשב 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את Postgres במחשב 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. מעדכנים את LDAP במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. מעדכנים את רכיבי Edge במכונות 6, 7, 8, 9, 1, 4 ו-5 בסדר הזה: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. מעדכנים את Qpid במכונות 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. מעדכנים את ממשק המשתמש החדש (ue) או את ממשק המשתמש הקלאסי (ui) במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (אם התקנתם את apigee-adminapi) מעדכנים את כלי השירות apigee-adminapi במחשב 1: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במחשב 1: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ‫sso_config_file הוא קובץ ההגדרות שיצרתם כשהתקנתם את ה-SSO.

  10. מפעילים מחדש את רכיב ממשק המשתמש:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, עליכם להפעיל מחדש את הרכיב edge-ui במכונה 1, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק משתמש חדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את רכיב edge-management-ui במחשב המתאים (יכול להיות שלא מדובר במחשב 1): 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג של אשכול עם 13 צמתים

צריך לעדכן את הרכיבים הבאים בהתקנה של אשכול עם 13 צמתים:

רשימת הטופולוגיות של Edge ומספרי הצמתים מופיעה במאמר טופולוגיות של התקנות.

  1. מעדכנים את Cassandra ואת ZooKeeper במכונות 1, 2 ו-3: 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres במחשב 8: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. מעדכנים את Postgres במחשב 9: 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  4. מעדכנים את LDAP במכונות 4 ו-5: 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. מעדכנים את רכיבי Edge במכונות 12,‏ 13,‏ 8,‏ 9,‏ 6,‏ 7,‏ 10 ו-11 לפי הסדר הזה: 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. עדכון Qpid במכונות 12 ו-13: 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. מעדכנים את ממשק המשתמש החדש (ue) או את ממשק המשתמש הקלאסי (ui) במכונות 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  8. (אם התקנתם את apigee-adminapi) בוצע עדכון של כלי השירות apigee-adminapi במכונות 6 ו-7: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO במכונות 6 ו-7: 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ‫sso_config_file הוא קובץ ההגדרות שיצרתם כשהתקנתם את ה-SSO.

  10. מפעילים מחדש את רכיב ממשק המשתמש:
    • ממשק משתמש קלאסי: אם אתם משתמשים בממשק המשתמש הקלאסי, תצטרכו להפעיל מחדש את הרכיב edge-ui במכונות 6 ו-7, כמו בדוגמה הבאה: 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
    • ממשק משתמש חדש של Edge: אם התקנתם את ממשק המשתמש החדש של Edge, צריך להפעיל מחדש את רכיב edge-management-ui במחשבים 6 ו-7: 
      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

שדרוג של אשכול עם 12 צמתים

צריך לעדכן את הרכיבים הבאים בהתקנה של אשכול עם 12 צמתים:

רשימה של טופולוגיות Edge ומספרי צמתים מופיעה במאמר טופולוגיות התקנה.

  1. מעדכנים את Cassandra ואת ZooKeeper:
    1. במכונות 1, 2 ו-3 במרכז הנתונים 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. במכונות 7, 8 ו-9 במרכז הנתונים 2 
      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. מעדכנים את Postgres:
    1. מכונה 6 במרכז הנתונים 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    2. מכונה 12 במרכז נתונים 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  3. עדכון LDAP:
    1. מכונה 1 במרכז נתונים 1 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. מכונה 7 במרכז נתונים 2 
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. עדכון רכיבי Edge:
    1. מכונות 4, 5, 6, 1, 2, 3 במרכז הנתונים 1 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. מכונות 10, 11, 12, 7, 8, 9 במרכז הנתונים 2 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. ‫Update qpidd:
    1. מכונות 4 ו-5 במרכז הנתונים 1
      1. מעדכנים את qpidd במחשב 4: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. מעדכנים את qpidd במחשב 5: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. מכונות 10 ו-11 במרכז הנתונים 2
      1. עדכון qpidd במחשב 10: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. עדכון qpidd במחשב 11: 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  6. מעדכנים את הממשק החדש (ue) או את הממשק הקלאסי (ui):
    1. מכונה 1 במרכז נתונים 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
    2. מכונה 7 במרכז הנתונים 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
  7. (אם התקנתם את apigee-adminapi) עודכן כלי השירות apigee-adminapi:
    1. מכונה 1 במרכז נתונים 1: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
    2. מכונה 7 במרכז הנתונים 2: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  8. (אם התקנתם את Apigee SSO) מעדכנים את Apigee SSO:
    1. מכונה 1 במרכז נתונים 1: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. מכונה 7 במרכז הנתונים 2: 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. ‫sso_config_file הוא קובץ ההגדרות שיצרתם כשהתקנתם את ה-SSO.

  9. מפעילים מחדש את הרכיב של ממשק המשתמש החדש של Edge‏ (edge-management-ui) או של ממשק המשתמש הקלאסי של Edge‏ (edge-ui) במחשבים 1 ו-7: 
    /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

להגדרה לא רגילה

אם יש לכם הגדרה לא סטנדרטית, צריך לעדכן את רכיבי Edge בסדר הבא:

  1. ZooKeeper
  2. Cassandra
  3. ps
  4. LDAP
  5. ‫Edge, כלומר הפרופיל ‎-c edge בכל הצמתים לפי הסדר: צמתים עם שרת Qpid, שרת Edge Postgres, שרת ניהול, מעבד הודעות ונתב.
  6. qpidd
  7. ממשק המשתמש של Edge (קלאסי או חדש)
  8. apigee-adminapi
  9. Apigee SSO

אחרי שמסיימים את העדכון, חשוב להפעיל מחדש את רכיב Edge UI בכל המכונות שבהן הוא פועל.