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

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

يصف هذا القسم الإصدار 4.19.06 من إصدار ميزات السحابة الإلكترونية الخاصة من Edge.

ملخّص الإصدار

يلخص الجدول التالي التغييرات في هذا الإصدار:

الميزات الجديدة

يتضمن هذا الإصدار الميزات الجديدة التالية:

○ دعم LDAP للدخول المُوحَّد (SSO)
○ دعم نشر HTTP
○ الإحصاءات القابلة للتوصيل
○ حامل Cassandra
○ دعم IPv6
○ تجربة التثبيت الجديدة المبسّطة على Edge
○ معاملة استبعاد INVALID_TSC (تحقيق الربح)

لمزيد من المعلومات عن كل ميزة من هذه الميزات الجديدة، يُرجى مراجعة الميزات الجديدة:
التوافق مع الأنظمة القديمة

وقد تم عرض المشاكل التالية التي تؤثر على التوافق مع الأنظمة القديمة في هذا الإصدار. في Apigee Edge for Private Cloud:

     

  • نظرًا لإصلاح المشكلة 132443137 (كما هو موضح في 19.03.01 الجمهور ملاحظات إصدار السحابة الإلكترونية)، تتجاهل معالجات الرسائل الآن العناوين التي تبدأ بـ X-Apigee-* نتيجة لذلك، يجب إعادة هيكلة أي تعليمة برمجية تستخدم X-Apigee-* عنوان واستبدال هذه العناوين بأخرى متوافقة.

  • تم تغيير اسم ملفات سجلّ "كاساندرا". وهي الآن:

    /opt/apigee/var/log/apigee-cassandra/system.log
الإصدارات المضمّنة

منذ الإصدار السابق من Edge for Private Cloud Feature، إليك الإصدارات التالية التي تم تضمينها في هذا الإصدار:

○ الحدّ:
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 for Private Cloud.

لمزيد من المعلومات، يُرجى مراجعة الإيقاف النهائي في Apigee وعمليات التقاعد وبرنامج CPS التغييرات.
إصلاح الأخطاء

يتضمّن هذا الإصدار إصلاحات الأخطاء التالية:

○ لم يتم ضبط UseStringDedupliification (140270474)
. ○ أخطاء MP (111445518)
○ "كاساندرا" لم تنجح في عَرضها JMX (113342838)
○ ترقيات مكونة من 13 عقدة (138931337)
○ الأجهزة الوكيلة التي تحمل الاسم نفسه (119802562)
○ ملفات تخزين المفاتيح لا يتم تحميلها (118851790)
○ تحليل الإحصاءات (110988191)
○ حالات تعذُّر الاحتفاظ بنسخة احتياطية (110785400)
○ HEAD طلبات إلى Node.js (79993247)
○ apigee-postgres backup/restore (70291825)
○ إعادة ضبط كلمة مرور مسؤول إدارة النظم (65737520)

لمزيد من المعلومات حول كل من هذه الحلول، يمكنك الاطّلاع على مقالة إصلاح الأخطاء.
المشاكل المعروفة

يتضمن هذا الإصدار المشاكل المعروفة التالية:

○ إنشاء المعاملات بدون تقييم في البداية (141628497)
○ تسرُّب الذاكرة في خوادم تقييم النعناع (137865184)
○ تنسيق ملف البيانات الوصفية لتثبيت apigee-sso (135616498)
○ apigee-monit غير متاح على Amazon Linux 1 (122370980)
○ عملية النسخ الاحتياطي لمعالج الرسائل لا تحتفظ بنسخة احتياطية من مجموعة الملفات الصحيحة (121095148)
○ DataAccessExceptions في تكوينات مراكز بيانات متعددة (76087166)
○ سياسة تسجيل الرسائل التي تتضمن معلومات إضافية في رسالة السجل (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 و Portal المدرجة في الإصدارات المضمَّنة:

بالإضافة إلى التحسينات التالية، يشتمل هذا الإصدار أيضًا على العديد من ميزات تحسينات على الأداء والأمان والثبات.

دعم نشر HTTP

بشكل تلقائي، تستخدم شبكة Edge استدعاء إجراء عن بُعد (RPC) لنشر الخوادم الوكيلة لواجهة برمجة التطبيقات. على الرغم من أنّ هذا الوضع يعمل بشكل جيد جدًا بالنسبة إلى معظم من عمليات التثبيت، وقد تواجه فترات مهلات كبيرة لدى العديد من أعضاء البرلمان في حالة استخدام عدد كبير من إجراء اتصالات متزامنة عن طريق استدعاء إجراء عن بُعد (RPC).

ونتيجةً لذلك، تنصح Apigee بأن تستخدم عمليات النشر الأكبر HTTP بدلاً من استدعاء إجراء عن بُعد (RPC) النشر. يُتاح الآن تفعيل عمليات نشر HTTP.

لمزيد من المعلومات، راجع تفعيل HTTP النشر.

دعامة حامل Cassandra

توفّر Apigee الآن إرشادات عامة لتوسيع نطاق عمليات "كاساندرا" من خلال إعداد "كاساندرا" على Apigee Edge for Private Cloud.

لمزيد من المعلومات، يُرجى مراجعة رفوف كاساندرا.

إحصاءات قابلة للتوصيل

بشكل تلقائي، يتم تحميل بيانات الإحصاءات التي يجمعها معالج الرسائل إلى Qpid وPostgres. للمعالجة. يمكنك بعد ذلك عرض بيانات الإحصاءات في واجهة مستخدم Edge.

باستخدام إصدار الميزات هذا، يمكنك ضبط معالج الرسائل لكتابة بيانات الإحصاءات إلى قرص أو يمكنك اختيار استخدام كلا الخيارين.

لمزيد من المعلومات، يُرجى مراجعة كتابة بيانات إحصائية في ملف:

تثبيت تجربة Edge الجديدة المبسّطة

تم تبسيط عملية تثبيت تجربة New Edge باستخدام نص برمجي جديد.

للحصول على مزيد من المعلومات، يمكنك الاطّلاع على تثبيت تجربة Edge الجديدة.

دعم موفِّر الهوية (idP) في LDAP

توفّر مصادقة المستخدمين من خلال طلبات البيانات من واجهة برمجة التطبيقات Edge UI وEdge management API الآن LDAP في بالإضافة إلى SAML. يشتمل دعم LDAP على كل من طريقة الربط المباشر وطرق الربط غير المباشر.

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على التقارير الخارجية مصادقة موفِّر الهوية (idP)

دعم IPv6

إنّ جميع طلبات البيانات من واجهة برمجة التطبيقات في Apigee Edge for Private Cloud تستخدم IPv4 تلقائيًا. يمكنك إضافة IPv6 جهاز التوجيه من خلال خاصية جديدة.

لمزيد من المعلومات، راجع استخدام IPv6 على جهاز التوجيه.

استبعاد معاملات INVALID_TSC (تحقيق الربح)

يمكنك الآن استبعاد إضافة INVALID_TSC معاملة إلى Postgres. قاعدة البيانات عند استخدام ميزة "تحقيق الربح"

لمزيد من المعلومات، يُرجى الاطّلاع على المقالة تحقيق الربح. الخاصة بالخادم.

البرامج المتوافقة

يتضمن هذا الإصدار التغييرات التالية على البرامج المتوافقة:

تمت إضافة الدعم لم يعد متوفرًا

يتوافق هذا الإصدار مع المنصّات التالية:

  • الإصدار 6.10 من نظام التشغيل Red Hat Enterprise Linux (RHEL)
  • نظام التشغيل CentOS 6.10
  • Oracle Linux 6.9

لم تعُد المنصات التالية متوافقة مع هذا الإصدار:

  • الإصدار 6.9 من Red Hat Enterprise Linux (RHEL)
  • نظام التشغيل CentOS 6.9
  • Oracle 6.8

للحصول على قائمة كاملة بالأنظمة الأساسية المتوافقة، راجع البرامج المتوافقة والإصدارات المتوافقة

إصلاح الأخطاء

يسرد هذا القسم أخطاء Private Cloud التي تم إصلاحها في هذا الإصدار. بالإضافة إلى ذلك، الإصدار يتضمن جميع إصلاحات الأخطاء في إصدارات واجهة مستخدم Edge وEdge Management وبوابة البوابة المعروضة في الإصدارات المضمَّنة:

معرّف المشكلة الوصف
140270474

لم يتم ضبط UseStringDeduplieration

لم يكن 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

إخفاقات "كاساندرا" مع JMX

لم تكن عمليات Cassandra تعمل عند تفعيل مصادقة JMX.
138931337

الترقيات ذات الـ 13 عقدة

تعذّرت ترقيات عمليات تثبيت العُقدة ذات 13 عقدة من 17.09 و18.01 و18.05.
119802562

الخوادم الوكيلة التي تحمل الاسم نفسه

إذا أنشأ مستخدمان في نفس المؤسسة خوادم وكيلة بنفس الأسماء، فإن الاسم الثاني الذي تم إنشاؤه سيحل محل الأول. لم يحدث ذلك إلا عندما لا يمكن لمستخدمين مختلفين رؤية الخادم الوكيل الآخر.
118851790

تعذُّر تحميل ملفات تخزين المفاتيح

وعندما كان هناك أكثر من 100 ملف تخزين مفاتيح لمؤسسة أو بيئة، كان ملف تخزين المفاتيح تعذّر تحميل قسم المرجع في واجهة مستخدم Edge. بدلاً من ذلك، عرضت واجهة المستخدم الخطأ Internal Error (Error Fetching Keystores).
110988191

تعذّرت الإحصاءات

تعذّر إجراء "إحصاءات Google" لبيئة ما عند تزويدها ببيانات من المدخل الصغير الذي كانت تعيينه على تاريخ في المستقبل.
110785400

حالات تعذُّر الاحتفاظ بنسخة احتياطية

فشل ZooKeeper وCassandra وOpenLDAP بشكل متقطع في الاحتفاظ بنسخة احتياطية من البيانات بشكلٍ صحيح مع ظهور الخطأ التالي: File changed as we read it.
79993247

طلبات HEAD إلى Node.js

قد يتم تعليق طلبات HEAD إلى هدف Node.js، ما يترك الاتصالات في انتظار المراجعة.
70291825

apigee-postgres backup/restore

يؤدي تنفيذ عملية النسخ الاحتياطي/الاستعادة بشكل apigee-postgres الآن إلى النسخ الاحتياطي للبيانات لجميع المكونات.
65737520

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

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

المشاكل المعروفة

يسرد الجدول التالي المشاكل المعروفة في هذا الإصدار:

معرّف المشكلة الوصف
141628497

الحذف بدون تقييم المعاملات في البداية

لا تقيّم Edge for the Private Cloud المعاملات مبدئيًا عند تفعيل تحقيق الربح لمؤسّسة لأول مرة. وينطبق ذلك على المؤسسات الجديدة والحالية.

تستجيب واجهة برمجة تطبيقات تحقيق الربح المادي مع معرّف الوظيفة، وعند اكتمال العملية ستشير حالة الوظيفة إلى نجاحها. ومع ذلك، لن تتم معالجة أي طلبات بيانات يتم تحقيق الربح منها من واجهة برمجة التطبيقات يتم إجراؤها في البداية عن طريق تحقيق الربح ولن يتم تقييمها. ستظهر هذه المعاملات في الإحصاءات المنتظمة فقط.

الحل:

أعد تشغيل أي معالِجات للرسائل، والتي يمكن إجراء ذلك بما يلي: 
apigee-service edge-message-processor restart

بعد تفعيل ميزة تحقيق الربح، تؤدي إعادة تشغيل MPs إلى تحميل Edge للإعدادات من ZooKeeper عند بدء التشغيل. ويحدث ذلك عند كل عملية إعادة تشغيل، ما يعني أنّ المشكلة لا تنطبق إلا في البداية.

137865184

تسرُّب الذاكرة في خوادم التقييم الصغيرة

عند تسجيل مثيل Qpid جديد في مجموعة MX، يتم إنشاء قوائم الانتظار بدون مستهلكين، ما يؤدي إلى زيادة عمق قائمة الانتظار إلى أن يتم استخدام جميع الموارد المتاحة.

الحل:

بلا عُري
135616498

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

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

الحل:

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

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

    أو

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

لا يتوافق التطبيق apigee-monit مع Amazon Linux 1

الحل:

بلا عُري
121095148

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

الحل:

شغِّل عملية النسخ الاحتياطي مرة ثانية وسيتم إجراء نسخ احتياطي لمجموعة الملفات الصحيحة.
76087166

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

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

DataAccessException: Error while accessing datastore;
Please retry later

والنتيجة هي أنه قد لا يبدأ "خادم الإدارة" لأنه يحاول الاتصال بـ "كاساندرا". في كل من dc-1 وdc-2. وتحدث DataAccessExceptions إذا كانت عقدة كاساندرا إلى الأسفل. وقد يؤدي ذلك أيضًا إلى حدوث خلل في حركة بيانات واجهة برمجة التطبيقات، حيث يتم عرض تقرير "معالجي الرسائل". 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 تأكد من تدوين أرقام التعريف الفريدة العالمية التي يتم عرضها.
  3. إلغاء تسجيل العُقد باستخدام الأمر التالي: 
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    يشير الرمز 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 ولا تحتوي على أي على المجموعة العنقودية كاساندرا. لمزيد من المعلومات حول هذه الأوامر، يمكنك الاطّلاع على تحديث عمليات تسجيل تخزين البيانات.
68722102

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

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

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

الحل:

بلا عُري

الخطوة التالية

لبدء استخدام Edge for Private Cloud 4.19.06، استخدِم الروابط التالية:

عمليات التثبيت الجديدة:
نظرة عامة على التثبيت الجديدة
عمليات التثبيت الحالية:
مسارات الترقية
السابق
4.19.06.01
التالي
11.01.11