4.19.06 נתוני הגרסה של Edge לענן פרטי

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

בקטע הזה מוסבר על גרסה 4.19.06 של Edge for Private Cloud Feature Release.

סיכום הגרסה

בטבלה הבאה מפורטים השינויים בגרסה הזו:

תכונות חדשות

הגרסה הזו כוללת את התכונות החדשות הבאות:

‫○ תמיכה ב-LDAP ל-SSO
‫○ תמיכה בפריסה של HTTP
‫○ ניתוח נתונים שניתן להטמעה
‫○ תמיכה ב-Cassandra rack
‫○ תמיכה ב-IPv6
‫○ התקנה פשוטה של New Edge
‫○ החרגת עסקאות INVALID_TSC (מונטיזציה)

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

הבעיות הבאות שמשפיעות על תאימות לאחור נוספו בגרסה הזו של Apigee Edge for Private Cloud:

     

  • בגלל התיקון של בעיה 132443137 (כפי שמתואר בהערות הגרסה של Cloud 19.03.01 שזמינות לציבור), מעבדי ההודעות מתעלמים עכשיו מכותרות שמתחילות ב-X-Apigee-*. לכן, צריך לשנות את כל הקוד שמשתמש בכותרות X-Apigee-* ולהחליף את הכותרות האלה בכותרות נתמכות.

  • השם של קובצי היומן של Cassandra השתנה. עכשיו הוא:

    /opt/apigee/var/log/apigee-cassandra/system.log
פריטי תוכן כלולים

מאז הגרסה הקודמת של Edge for Private Cloud Feature Release, יצאו הגרסאות הבאות, והן כלולות בגרסה הזו:

‫○ Edge:
   19.07.23 (ממשק משתמש)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31 		‫○ Portal:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
הוצאה משימוש ללא
הפסקת תמיכה

עם יציאת הגרסה 4.19.06, הפריטים הבאים יצאו משימוש:

  • ‫4.18.01: הגרסה 4.18.01 של Apigee Edge for Private Cloud הוצאה משימוש.

מידע נוסף זמין במאמר בנושא הוצאה משימוש, סגירה ושינויים ב-CPS ב-Apigee.
תיקוני באגים

הגרסה הזו כוללת את תיקוני הבאגים הבאים:

○ UseStringDeduplication not set (140270474)
○ MP errors (111445518)
○ Cassandra failures with JMX (113342838)
○ 13-node upgrades (138931337)
○ Proxies with the same name (119802562)
○ Keystores not loading (118851790)
○ Analytics failed (110988191)
○ Backup failures (110785400)
○ HEAD requests to Node.js (79993247)
○ apigee-postgres backup/restore (70291825)
○ Resetting sysadmin password (65737520)

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

הגרסה הזו כוללת את הבעיות הידועות הבאות:

‫○ Mint לא מדרג עסקאות בהתחלה (141628497)
‫○ דליפת זיכרון בשרתי דירוג של Mint (137865184)
‫○ פורמט קובץ מטא-נתונים להתקנת apigee-sso (135616498)
‫○ apigee-monit לא אפשרי ב-Amazon Linux 1 (122370980)
‫○ גיבוי מעבד בקשות לא מגבה את קבוצת הקבצים הנכונה (121095148)
‫○ DataAccessExceptions בתצורות מרובות של מרכזי נתונים (76087166)
‫○ מדיניות MessageLogging כוללת מידע נוסף בהודעה ביומן (68722102)

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

נתיבי שדרוג

בטבלה הבאה מפורטים נתיבי השדרוג של הגרסה הזו:

מגרסה 4.19.01 שדרוג ישירות מגרסה 4.19.01 לגרסה 4.19.06
מגרסה 4.18.05 שדרוג ישירות מגרסה 4.18.05 לגרסה 4.19.06
מגרסה 4.18.01 שדרוג ישירות מגרסה 4.18.01 לגרסה 4.19.06

תכונות חדשות

בקטע הזה מפורטות התכונות החדשות בגרסה הזו. בנוסף, הגרסה הזו כוללת את כל התכונות בגרסאות של Edge UI,‏ Edge Management ו-Portal שמפורטות בגרסאות הכלולות.

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

תמיכה בפריסת HTTP

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

לכן, ב-Apigee מומלץ להשתמש ב-HTTP ולא ב-RPC לפריסות גדולות. מעכשיו יש תמיכה בהפעלת פריסות של HTTP.

מידע נוסף זמין במאמר הפעלת פריסה של HTTP.

תמיכה ב-Cassandra rack

‫Apigee מספקת עכשיו הנחיות כלליות להרחבת פעולות של Cassandra על ידי הפיכת Cassandra ב-Apigee Edge for Private Cloud למודעת-מתלים (rack-aware).

מידע נוסף זמין במאמר בנושא תמיכה ב-Cassandra rack.

ניתוח נתונים באמצעות תוספים

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

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

מידע נוסף זמין במאמר בנושא כתיבת נתוני Analytics לקובץ.

התקנה פשוטה יותר של חוויית New Edge

התקנת הגרסה החדשה של Edge פשוטה יותר בזכות סקריפט חדש.

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

תמיכה ב-LDAP IdP

האימות של משתמשים באמצעות ממשק המשתמש של Edge וקריאות ל-Edge Management API תומך עכשיו ב-LDAP בנוסף ל-SAML. התמיכה ב-LDAP כוללת שיטות של קשירה ישירה וקשירה עקיפה.

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

תמיכה ב-IPv6

כברירת מחדל, כל הקריאות ל-API בזמן הריצה אל Apigee Edge for Private Cloud משתמשות ב-IPv4. אפשר להוסיף תמיכה ב-IPv6 לנתב באמצעות נכס חדש.

מידע נוסף זמין במאמר בנושא שימוש ב-IPv6 בנתב.

החרגת עסקאות INVALID_TSC (מונטיזציה)

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

מידע נוסף מופיע במאמר מאפייני שרת של מונטיזציה.

תוכנות נתמכות

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

הוספת תמיכה אין יותר תמיכה

בגרסה הזו נוספה תמיכה בפלטפורמות הבאות:

  • ‫Red Hat Enterprise Linux‏ (RHEL) 6.10
  • ‫CentOS 6.10
  • Oracle Linux 6.9

הפלטפורמות הבאות כבר לא נתמכות בגרסה הזו:

  • ‫Red Hat Enterprise Linux‏ (RHEL) 6.9
  • ‫CentOS 6.9
  • ‫Oracle 6.8

כאן אפשר לעיין ברשימה המלאה של הפלטפורמות הנתמכות.

תיקוני באגים

בקטע הזה מפורטים הבאגים ב-Private Cloud שתוקנו בגרסה הזו. בנוסף, הגרסה הזו כוללת את כל תיקוני הבאגים בגרסאות של Edge UI,‏ Edge Management ו-Portal שמוצגות בגרסאות כלולות.

מזהה הבעיה תיאור
140270474

ההגדרה UseStringDeduplication לא נקבעה

‫UseStringDeduplication לא הוגדר לרכיבי edge-message-processor בסביבות ייצור.
111445518

שגיאות ב-MP

מעבדי ההודעות רשמו באופן רציף את הודעת השגיאה הבאה כל 5 דקות: 
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

כשלים ב-Cassandra עם JMX

פעולות Cassandra לא פעלו כשהאימות של JMX הופעל
138931337

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

שדרוגים של התקנות עם 13 צמתים מגרסאות 17.09,‏ 18.01 ו-18.05 נכשלו.
119802562

שרתי proxy עם אותו שם

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

מאגרי מפתחות לא נטענים

אם יש יותר מ-100 מאגרי מפתחות לארגון או לסביבה, הקטע של מאגר המפתחות וההפניה בממשק המשתמש של Edge לא נטען. במקום זאת, בממשק המשתמש מוצגת השגיאה Internal Error (Error Fetching Keystores).
110988191

הפעולה ב-Analytics נכשלה

השימוש ב-Analytics בסביבה מסוימת נכשל כשסופקו נתונים מ-Microgateway שהוגדר לתאריך עתידי.
110785400

כשלים בגיבוי

הגיבוי של הנתונים ב-ZooKeeper,‏ Cassandra ו-OpenLDAP נכשל לסירוגין עם השגיאה הבאה: File changed as we read it.
79993247

בקשות HEAD אל Node.js

HEAD בקשות ליעד Node.js עלולות להיתקע, ולגרום לחיבורים להישאר בהמתנה.
70291825

גיבוי ושחזור של apigee-postgres

כשמריצים גיבוי או שחזור של apigee-postgres, הנתונים מגובים עכשיו לכל הרכיבים.
65737520

איפוס הסיסמה של מנהל המערכת

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

בעיות מוכרות

בטבלה הבאה מפורטות בעיות מוכרות בגרסה הזו:

מזהה הבעיה תיאור
141628497

המערכת של Mint לא מדרגת עסקאות בהתחלה

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

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

פתרון עקיף:

מפעילים מחדש את כל מעבדי ההודעות (MP). אפשר לעשות זאת באמצעות הפעולות הבאות: 
apigee-service edge-message-processor restart

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

137865184

דליפת זיכרון בשרתי דירוג של Mint

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

פתרון עקיף:

ללא.
135616498

פורמט קובץ המטא-נתונים להתקנה של apigee-sso

כשמתקינים את apigee-sso ומשתמשים בקובץ metadata.xml במקום בכתובת URL, אם הקובץ לא כולל שורה חדשה (CRLF) בסוף הקובץ, הקובץ לא נקרא במלואו.

פתרון עקיף:

כדי לעקוף את הבעיה, אפשר לבצע אחת מהפעולות הבאות:

  • מוסיפים CRLF בסוף הקובץ metadata.xml

    או

  • שימוש במיקום שמבוסס על כתובת URL למטא-נתונים
122370980

‫apigee-monit לא נתמך ב-Amazon Linux 1

פתרון עקיף:

ללא.
121095148

גיבוי מעבד ההודעות לא מגבה את קבוצת הקבצים הנכונה

פתרון עקיף:

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

DataAccessException בהגדרות של כמה מרכזי נתונים

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

DataAccessException: Error while accessing datastore;
Please retry later

התוצאה היא ששרת הניהול לא יופעל כי הוא ינסה להתחבר לצמתי Cassandra ב-dc-1 וב-dc-2. השגיאה DataAccessExceptions מתרחשת אם צומת Cassandra מושבת. יכול להיות שזה גם יגרום לשיבוש בתנועת הנתונים של ה-API, כשמעבדי ההודעות מדווחים על DataAccessExceptions בניסיון לאחזר KVM.

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

פתרון עקיף

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

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

כדי לבטל את הרישום של סוגי הצמתים האלה של Cassandra ולרשום אותם מחדש:

  1. מקבלים את מזהי ה-UUID של צמתי Cassandra באמצעות הפקודה curl הבאה: 
    curl -u ADMIN_EMAIL:ADMIN_PW \
  "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
  &type=CASSANDRA_NODE_TYPE"

    כאשר:

    • ‫ADMIN_EMAIL ו-ADMIN_PW הם פרטי הכניסה לחשבון Apigee שלכם.
    • ‫MS_IP ו-MS_PORT הם כתובת ה-IP ומספר היציאה של שרת הניהול.
    • ‫REGION הוא השם של מרכז הנתונים שבו נמצא שרת הניהול.
    • ‫GATEWAY_POD הוא שם ה-pod, שהוא כברירת מחדל gateway. יכול להיות ששיניתם את השם שלו למשהו אחר, לכן כדאי לבדוק את ההטמעה.
    • ‫CASSANDRA_NODE_TYPE הוא אחד מהערכים kms-datastore, dc-datastore ו-keyvaluemap-datastore.

    לדוגמה: 

    curl -u nickdanger@google.com:myP@$$w0rD
  "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    התשובה מבוססת על הפורמט הבא: 

    {
  "internalIP" : "POD_IP_ADDRESS",
  "isUp" : [true|false],
  "pod" : "GATEWAY_POD",
  "reachable" : [true|false],
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
    "uUID" : "POD_UUID"
}

    לדוגמה: 

    {
  "internalIP" : "192.168.1.11",
  "isUp" : false,
  "pod" : "gateway",
  "reachable" : false,
  "region" : "dc-1",
  "tags" : {
    "property" : [ ]
  },
  "type" : "dc-datastore",
  "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
}

    שימו לב לערכים של השדה uUID בתגובה. תשתמשו בהם כדי לבטל את הרישום של הצמתים.

  2. חוזרים על שלב 1 לכל סוג הצומת של Cassandra: ‏ kms-datastore,‏ dc-datastore וkeyvaluemap-datastore. חשוב לשים לב ל-UUID שמוחזר.
  3. מבטלים את הרישום של הצמתים באמצעות הפקודה הבאה: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    כאשר UUID הוא ה-UUID שמוחזר בתגובה של הפקודה הקודמת.

  4. חוזרים על שלב 3 לכל UUID שאספתם בשלבים 1 ו-2.
  5. מבצעים רישום מחדש של הצמתים באמצעות הפקודה הבאה: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
  Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
  region=REGION&pod=GATEWAY_POD" -H \
  'content-type: application/x-www-form-urlencoded' -X POST

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

מדיניות MessageLogging שכוללת מידע נוסף בהודעת היומן

האלמנט FormatMessage של מדיניות MessageLogging שולט בפורמט של ההודעה שנרשמת ביומן. כשמשתמשים ב-FormatMessage=false, ההודעה שנרשמת ביומן לא אמורה לכלול מידע שנוצר על ידי Apigee. עם זאת, גם אם מגדירים את FormatMessage=false, הודעת היומן עדיין כוללת את הפרטים הבאים:

  • ציון העדיפות
  • חותמת הזמן

פתרון עקיף:

ללא.

השלב הבא

כדי להתחיל להשתמש ב-Edge for Private Cloud 4.19.06, אפשר להיעזר בקישורים הבאים:

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