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

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

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

פתרון אפשרי:

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

• יש להוסיף CRLF לסוף הקובץ metadata.xml

  או

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

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

פתרון אפשרי:

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

פתרון אפשרי:

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

אסימוני הסשן לא בוטלו

אסימוני הסשן לא מבוטלים בשרת כשהמשתמש לוחץ על הלחצן 'התנתקות' ב-Apigee Edge.

פתרון אפשרי:

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

פתרון אפשרי:

HEAD בקשות ליעדי Node.js תקועות

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

פתרון אפשרי:

כדי לעקוף את הבעיה הזו, יש להגדיר handler לבקשות של HEAD שיחזירו באופן מפורש תגובה ריקה.

שמות מארחים לא מזוהים

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

פתרון אפשרי:

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

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

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

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

פתרון אפשרי:

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

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

פתרון אפשרי:

צריך להגדיר את הסיסמה בקובץ נתונים שמעבירים לנקודת הקצה /users בממשק ה-API לניהול. מידע נוסף זמין במאמר איפוס הסיסמה של אדמין המערכת.