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, התרחשו הגרסאות הבאות והן כלולות בגרסה הזו:

‫○ 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 לענן פרטי הוצאה משימוש.

מידע נוסף זמין במאמר בנושא הוצאה משימוש, סגירה ושינויים ב-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 לענן פרטי למודעת-מתלים (rack aware).

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

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

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

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

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

התקנה פשוטה יותר של הגרסה החדשה של 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, של Edge Management ושל Portal שמופיעות בגרסאות הכלולות.

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

UseStringDeduplication not set

המאפיין 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 עם אותם שמות, השרת השני שיצרתם יחליף את הראשון. הבעיה הזו קרתה רק כשמשתמשים שונים לא יכלו לראות את ה-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, אפשר להיעזר בקישורים הבאים:

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