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

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

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

סיכום הגרסה

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

תכונות חדשות

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

○ תמיכה ב-LDAP ל-SSO
○ תמיכה בפריסת HTTP
○ חיבור נתונים אל Analytics
○ תמיכה במדף האחסון של 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 לתכונה 'ענן פרטי', מופיעות הגרסאות הבאות והן נכללות בגרסה הזו:

○:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
{18.18.01}.


19.01.1418.12.0418.08.31 		○:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.2719.02.2119.02.0419.01.16
פרישה לגמלאות ללא
הוצאה משימוש

לאחר השקת גרסה 4.19.06, המהדורות הבאות הוצאו משימוש:

  • 4.18.01: גרסה 4.18.01 של Apigee Edge לענן פרטי הוצאה משימוש.

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

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

○ 18 בקשות גיבוי ○ 18 ○ 18 בקשות גיבוי ל-Google Analytics ○ 1 9-store
○27 בקשות גיבוי ○ 1 9-store
( 180 מיקומים חסרים
(180 בקשות ל-API (180270474 (140270474) לא הוגדר ○ 180 בקשות גיבוי ○ 1 1445518 ) ○ 180 בקשות גיבוי ב-Analytics (113342838) 113342838 (113342838 )







HEAD

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

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

○ 3 9 9 מטבעות שבה לא דירוג עסקאות 141628497 (141628497)
○ ○ דליפת זיכרון של שרתי דירוג Mint (137865184)
○ פורמט קובץ מטא-נתונים להתקנת apigee-sso להתקנת (135616498)
141628497 הגדרות אישיות של מעבד נתונים לא נתמך ב-Amazon Linux 1 (1223709) גיבוי נתונים, מדיניות גיבוי נתונים של Amazon Linux 1 (1223709)



apigee-monit

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

נתיבי שדרוג

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

From 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. המצב הזה עובד טוב מאוד ברוב ההתקנות, אבל טופולוגיות גדולות יותר, עם הרבה MP, עלולות לגרום לזמן קצוב לתפוגה כשמתבצעות מספר גדול של קריאות בו-זמניות דרך RPC.

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

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

תמיכה במתלים של Cassandra

מעכשיו, ב-Apigee יש הנחיות כלליות לגבי פעולות הגדלה ב-Cassandra, על ידי הפיכת המידע ל-Cassandra ב-Apigee Edge למדף של Private Cloud.

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

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

כברירת מחדל, נתוני הניתוח שנאספים על ידי מעבד ההודעות מועלים ל-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
  • Oracle Linux 6.9

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

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

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

תיקוני באגים

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

מזהה הבעיה תיאור
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 מאגרי מפתחות של ארגון או סביבה, ה-Keystore ומקטע העזר בממשק המשתמש של Edge לא נטענו. במקום זאת, ממשק המשתמש הציג את השגיאה Internal Error (Error Fetching Keystores).
110988191

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

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

גיבויים שנכשלו

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

HEAD בקשות ל-Node.js

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

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

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

איפוס סיסמת sysadmin

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

בעיות ידועות

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

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

המטבעה לא מדרגת עסקאות בהתחלה

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

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

פתרון אפשרי:

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

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

137865184

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

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

פתרון אפשרי:

ללא.
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

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

  1. משתמשים בפקודה curl הבאה כדי לקבל את מזהי ה-UUID של צומתי Cassandra: 
    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. חוזרים על השלב הראשון לכל סוג צומת של 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

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

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

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

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

פתרון אפשרי:

ללא.

השלב הבא

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

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