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

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

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

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

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

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

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

○ إتاحة بروتوكول LDAP لتفعيل ميزة "تسجيل الدخول الموحّد"
○ إتاحة نشر HTTP
○ إتاحة التحليلات القابلة للتوصيل
○ إتاحة رفوف Cassandra
○ إتاحة بروتوكول 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:
   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.

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

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

○ لم يتم ضبط UseStringDeduplication (140270474)
○ أخطاء MP (111445518)
○ أعطال Cassandra مع JMX (113342838)
○ عمليات ترقية 13 عقدة (138931337)
○ الخوادم الوكيلة التي تحمل الاسم نفسه (119802562)
○ عدم تحميل ملفات تخزين المفاتيح (118851790)
○ تعذُّر إعداد "إحصاءات Google" (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 الآن استخدام 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 المعاملات في البداية عند تفعيل تحقيق الربح لمؤسسة لأول مرة. ينطبق ذلك على المؤسسات الجديدة والحالية.

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

الحل:

أعِد تشغيل أيّ "معالِجات رسائل" (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

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

سياسة MessageLogging تتضمّن معلومات إضافية في رسالة السجلّ

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

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

الحل:

بلا عُري

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

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

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