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

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

يوضّح هذا القسم الإصدار 4.19.06 من ميزة Edge for Private Cloud.

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

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

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

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

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

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

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

     

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

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

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

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

‫○ Edge:
   23/07/19 (واجهة المستخدم)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31 		○ Portal:
   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.

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

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

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

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

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

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

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

إتاحة عملية النشر عبر HTTP

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

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

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

دعم رفوف Cassandra

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

لمزيد من المعلومات، يُرجى الاطّلاع على توافق Cassandra مع الرفوف.

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

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

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

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

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

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

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

إتاحة موفِّر الهوية LDAP

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

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

توافق IPv6

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

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

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

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

لمزيد من المعلومات، اطّلِع على سمات خادم تحقيق الربح.

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

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

تمت إضافة الدعم لم تعُد متاحة

يضيف هذا الإصدار إمكانية استخدام المنصّات التالية:

  • ‫Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

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

  • Red Hat Enterprise Linux (RHEL) 6.9
  • ‫CentOS 6.9
  • Oracle 6.8

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

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

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

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

لم يتم ضبط UseStringDeduplication

لم يتم ضبط 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

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

تعذّر إجراء الإحصاءات لبيئة معيّنة عند تزويدها ببيانات من 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

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

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

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

الحلّ البديل:

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

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

137865184

تسريب الذاكرة في خوادم تقييم Mint

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

الحلّ البديل:

بلا عُري
135616498

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

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

الحلّ البديل:

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

  • أضِف CRLF إلى نهاية ملف metadata.xml

    أو

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

‫apigee-monit غير متوافق مع Amazon Linux 1

الحلّ البديل:

بلا عُري
121095148

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

الحلّ البديل:

نفِّذ عملية الاحتفاظ بنسخة احتياطية مرة ثانية، ومن المفترض أن يتم الاحتفاظ بالمجموعة الصحيحة من الملفات.
76087166

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

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

DataAccessException: Error while accessing datastore;
Please retry later

ونتيجةً لذلك، قد لا يبدأ تشغيل Management Server لأنّه يحاول الاتصال بعُقد Cassandra في كلّ من dc-1 وdc-2. يحدث الخطأ DataAccessExceptions إذا كانت إحدى عُقد Cassandra غير متاحة. قد يؤدي ذلك أيضًا إلى حدوث انقطاع في عدد الزيارات إلى واجهة برمجة التطبيقات، حيث تعرض "معالجات الرسائل" القيمة DataAccessExceptions أثناء محاولة استرداد خرائط المفاتيح والقيم.

يُرجى العِلم أنّ الحالة المتوقّعة هي عدم اتصال "خادم الإدارة" بمكوّنات مخزن البيانات في مناطق مختلفة.

حل بديل

الحل البديل هو إلغاء تسجيل أنواع عقد 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، استخدِم الروابط التالية:

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