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

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

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

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

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

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

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

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

للحصول على مزيد من المعلومات عن كل من هذه الميزات الجديدة، يمكنك الاطّلاع على الميزات الجديدة.
التوافق مع الأنظمة القديمة

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

     

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

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

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

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

○ Edge:
   19.07.23 (واجهة المستخدم)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
{19.03.01. {19.03.01} {19.03.01} {19.03.01} {19.02.19
   19.02.04
   19.01.23
19.01.23
{141.01}49.19.19.19}19.19.18} {18.19.01.1418.12.0418.08.3118.07.31 		○ البوابة:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
{11 19.23}.
2 19.02.2719.02.2119.02.0419.01.16
التقاعد لا ينطبق
عمليات الإيقاف

ومع إصدار 4.19.06، تم إيقاف ما يلي:

  • 4.18.01: تم إيقاف الإصدار 4.18.01 من Apigee Edge for Private Cloud الآن.

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

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

UseStringDeduplations not set (140270474) (○27.○1 -140270474 رسالة)










HEAD

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

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

○ وضع عدم تقييم المعاملات مبدئيًا (141628497 رسالة)
تسرّب الذاكرة لخوادم تقييم Mint (137865184)
○ تنسيق ملف البيانات الوصفية لتثبيت apigee-sso (135616498)
1



apigee-monit

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

مسارات الترقية

يعرض الجدول التالي مسارات الترقية لهذا الإصدار:

From 4.19.01 الترقية مباشرةً من 4.19.01 ← 4.19.06
من 4 تشرين الثاني (نوفمبر) الترقية مباشرةً من الإصدار 4.18.05 ← 4.19.06
من 4: 18 الترقية مباشرةً من 4.18.01 ← 4.19.06

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

يسرد هذا القسم الميزات الجديدة في هذا الإصدار. إضافةً إلى ذلك، يتضمّن هذا الإصدار جميع الميزات المتوفّرة في إصدارات واجهة مستخدم Edge وEdge Management وبوابة المدرجات في الإصدارات المضمّنة.

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

إتاحة نشر HTTP

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

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

ولمزيد من المعلومات، يمكنك الاطّلاع على تفعيل نشر HTTP.

دعم حامل Cassandra

تقدّم Apigee الآن إرشادات عامة حول عمليات توسيع نطاق Cassandra من خلال تعريف Cassandra على Apigee Edge لأجهزة Private Cloud rack.

لمزيد من المعلومات، يمكنك الاطّلاع على دعم Cassandra rack.

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

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

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

ولمزيد من المعلومات، يُرجى الاطّلاع على كتابة بيانات الإحصاءات في ملف.

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

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

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

دعم موفِّر الهوية لـ LDAP

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

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

دعم IPv6

ويتم تلقائيًا استخدام IPv4 في جميع طلبات البيانات من واجهة برمجة التطبيقات في وقت التشغيل إلى Apigee Edge for Private Cloud. يمكنك إضافة بروتوكول 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

لم يتم ضبط UseStringDduplction

تعذّر ضبط 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

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

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

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

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

تعذّر إجراء "إحصاءات Google"

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

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

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

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

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

النسخ الاحتياطي/الاستعادة في apigee-postgres

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

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

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

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

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

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

عدم تقييم العملة في البداية

لا يقيِّم Edge لخدمة Private Cloud المعاملات بشكلٍ مبدئي عند تفعيل ميزة تحقيق الربح لأول مرة في إحدى المؤسسات. ينطبق ذلك على المؤسسات الجديدة والحالية.

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

الحل:

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

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

137865184

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

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

الحل:

بلا عُري
135616498

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

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

الحل:

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

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

    أو

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

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

الحل:

بلا عُري
121095148

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

الحل:

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

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

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

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

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

الحل:

بلا عُري

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

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

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