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

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

הקטע הזה מתאר את גרסה 4.19.06 של Edge להשקת תכונות בענן פרטי.

סיכום הגרסה

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

תכונות חדשות

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

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

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

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

     

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

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

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

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

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

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

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

○ UseStringDeduplication not set (140270474)
○ שגיאות MP (111445518)
○ כשלים ב-Cassandra עם JMX (113342838)
○ שדרוגי 13 צמתים (138931337)
○ שרתי proxy עם אותו שם (119802562)
○ Keystores לא בטעינה (118851790)
○ Analytics שנכשלו (110988191)
○ כשלים בגיבוי (110785400)
○ HEAD בקשות ל-Node.js (79993247)
○ apigee-postgres backup/restore (70291825)
○ איפוס סיסמת המערכת של האדמין (65737520)

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

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

○ ללא דירוג עסקאות (141628497) בהתחלה (141628497)
○ דליפת זיכרון מהשרתים של דירוג Mint (137865184)
○ פורמט של קובץ מטא-נתונים להתקנת apigee-sso (135616498)
○ apigee-monit לא נתמכת ב-Amazon Linux 1 (122370980)
○ בגיבוי של מעבד ההודעות לא מתבצע גיבוי של קבוצת הקבצים הנכונה (121095148)
○ DataAccessSCC בתצורות מרובות של מרכזי נתונים (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, ב-Edge Management וב-פורטל, שרשומות פריטי תוכן כלולים.

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

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

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

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

למידע נוסף, ראה הפעלת HTTP .

תמיכה במארז של Cassandra

Apigee מספקת עכשיו הדרכה כללית על הרחבת הפעילות של Cassandra על ידי הפיכת Cassandra ב-Apigee Edge למארז פרטי בענן.

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

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

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

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

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

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

תהליך ההתקנה של ממשק Edge החדש היה פשוט יותר, ועכשיו קל יותר להתקין אותו.

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

תמיכה ב-LDAP IDP

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

לקבלת מידע נוסף, ראו סקירה כללית של מקורות חיצוניים אימות IdP.

תמיכה ב-IPv6

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

למידע נוסף, ראה שימוש ב-IPv6 נתב.

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

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

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

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

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

נוספה תמיכה התמיכה הופסקה

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

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • גרסה 6.9 של Oracle ל-Linux

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

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

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

תיקוני באגים

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

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

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

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

ניתוח הנתונים נכשל

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

כשלים בגיבוי

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

HEAD בקשות ל-Node.js

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

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

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

איפוס הסיסמה של האדמין

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

בעיות מוכרות

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

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

מינימום דירוג עסקאות

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

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

פתרון:

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

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

137865184

דליפת זיכרון של שרתים עם דירוג מינימלי

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

פתרון:

ללא.
135616498

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

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

פתרון:

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

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

    או

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

התכונה apigee-monit לא נתמכת ב-Amazon Linux 1

פתרון:

ללא.
121095148

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

פתרון:

כדאי להריץ שוב את הגיבוי, והוא אמור לגבות את קבוצת הקבצים הנכונה.
76087166

DataAccessתרחיש (חריג) בהגדרות מרובות של מרכז נתונים

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

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

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

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

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

פתרון:

ללא.

השלב הבא

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

התקנות חדשות:
סקירה כללית של התקנה חדשה
התקנות קיימות:
מסלולי שדרוג
הקודם
4.19.06.01
הבא
19.09.11