4.19.01 Edge الخاص بملاحظات الإصدار في السحابة الإلكترونية الخاصة

تنسيق ملف البيانات الوصفية لتثبيت apigee-sso

عند تثبيت apigee-sso واستخدام ملف meta.xml بدلاً من عنوان URL، إذا لم يتضمن ملف meta.xml سطرًا جديدًا (CRLF) في نهاية الملف، لن تتم قراءة ملف meta.xml بالكامل.

الحل:

للتغلب على هذه المشكلة، يمكنك تنفيذ أحد الإجراءات التالية:

• إضافة CRLF إلى نهاية ملف meta.xml

  أو

• استخدام موقع جغرافي مستند إلى عنوان URL للبيانات الوصفية

apigee-monit غير متاح على Amazon Linux 1

الحل:

عدم الاحتفاظ بنسخة احتياطية من مجموعة الملفات الصحيحة من خلال "معالج الرسائل"

الحل:

قم بتشغيل النسخة الاحتياطية مرة ثانية وينبغي أن تقوم بعمل نسخة احتياطية من مجموعة الملفات الصحيحة.

عدم صلاحية الرموز المميّزة للجلسة

لا يتم إبطال صلاحية الرموز المميّزة للجلسة على الخادم عندما ينقر المستخدم على زر تسجيل الخروج من Apigee Edge.

الحل:

عمليات Caassandra لا تعمل عند تفعيل مصادقة JMX

الحل:

تعليق طلبات HEAD لأهداف Node.js

يمكن تعليق طلبات HEAD لهدف Node.js، مما يترك الاتصالات معلّقة.

الحل:

للتغلب على هذه المشكلة، حدِّد معالِجًا لطلبات HEAD لعرض استجابة فارغة بشكل صريح.

تعذُّر تحليل أسماء المضيفين

بعد تثبيت أو ترقية Edge لخدمة Private Cloud الخاصة، قد لا يتم ربط أسماء المضيفين بعناوينهم.

الحل:

لحل هذه المشكلة، أعِد تشغيل مكوِّن واجهة مستخدم Edge:

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

DataAccessException في إعدادات مراكز بيانات متعددة

في عمليات إعداد مراكز بيانات متعددة، إذا أصبح مخزن بيانات واحد غير متاح، قد يظهر لك الخطأ التالي:

DataAccessException: Error while accessing datastore;
Please retry later

والنتيجة هي أن خادم الإدارة قد لا يبدأ لأنه يحاول الاتصال بعُقد كاساندرا في كل من dc-1 وdc-2. تحدث القيمة DataAccessExceptions إذا كانت عقدة Cassandra معطّلة. وقد يؤدي ذلك أيضًا إلى انقطاع في حركة بيانات واجهة برمجة التطبيقات، حيث تُبلِغ معالجات الرسائل عن 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 هو اسم المجموعة، وهو تلقائيًا "البوابة". مع ذلك، قد تكون أعدت تسميتها إلى اسم آخر، لذا تحقّق من عملية التنفيذ.
   • 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 لكل معرّف فريد عالمي جمعته في الخطوتين 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. لمزيد من المعلومات حول هذه الأوامر، يُرجى الاطّلاع على مقالة تحديث تسجيلات مخزن البيانات.

سياسة MessageLogging، بما في ذلك المعلومات الإضافية في رسالة السجلّ

يتحكّم العنصر FormatMessage ضِمن سياسة MessageLogging في تنسيق الرسالة المسجَّلة. عند FormatMessage=false، لا من المفترض أن تتضمن الرسالة المسجَّلة أي معلومات تم إنشاؤها من خلال Apigee. ومع ذلك، حتى في حال ضبط FormatMessage=false، ستظل رسالة السجلّ تتضمّن المعلومات التالية:

• نقاط الأولوية
• الطابع الزمني

الحل:

تعذُّر إعادة ضبط كلمة مرور مشرف النظام

ستفشل عملية إعادة ضبط كلمة مرور مشرف النظام لخادم الإدارة التي تحتوي على رموز خاصة.

الحل:

حدِّد كلمة المرور في ملف بيانات ترسله بعد ذلك إلى نقطة النهاية /users في Management API. لمزيد من المعلومات، راجِع إعادة ضبط كلمة مرور مشرف النظام.