נתוני גרסה של 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'.

פתרון:

פעולות קסנדרה לא פועלות כשאימות 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

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

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

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

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

פתרון:

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

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

פתרון:

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