قد تظهر لك رسائل الخطأ التالية عند استخدام "أداة مزامنة دليل Google Cloud" (GCDS). يمكنك الرجوع إلى الجدول أدناه لتحديد الأخطاء وحلها.
تجربة "أداة تحليل السجلات"
يمكن أن تتعرّف هذه الأداة على معظم المشاكل خلال بضع دقائق من إرسال السجلات.
- أرسِل سجلات التتبّع (كملفات غير مضغوطة أو ملفات ZIP) إلى أداة تحليل سجلات مجموعة أدوات وحدة تحكُّم المشرف في Google.
- للحصول على تحليل سجلّ متقدّم، أرسِل الملفات غير المضغوطة إلى أداة تحليل السجلات 2.
تعرَّف على تفاصيل كيفية تفعيل التسجيل على مستوى التتبُّع.
رسائل الخطأ وحلولها
| رسالة الخطأ | الوصف والحل |
|---|---|
|
Network problem: Unable to connect to the specified LDAP server: simple bind failed: servername:636, reason: SSLHandshakeException - No subject alternative names present
Network problem: Unable to connect to the specified LDAP server: simple bind failed: servername:636, reason: SSLHandshakeException - No subject alternative DNS name matching servername found |
لا يتطابق "الاسم الشائع (CN)" للشهادة "والاسم البديل للموضوع (SAN)" مع اسم خادم LDAP في ملف إعداد "أداة مزامنة دليل Google Cloud". لحلّ هذه المشكلة، عليك تنفيذ أحد الإجراءين التاليَين:
يمكنك، كحل بديل مؤقت، إيقاف "تحديد نقطة النهاية" عن طريق إضافة سطر جديد إلى ملفي config-manager.vmoptions وsync-cmd.vmoptions في مجلد تثبيت "أداة مزامنة دليل Google Cloud". أزِل فاصل الأسطر قبل إضافة المحتوى إلى الملفات: -Dcom.sun.jndi.ldap.object. disableEndpointIdentification=true |
|
sun.security.provider.certpath.SunCertPathBuilder Exception: unable to find valid certification path to requested target
ldap_simple_bind_s() failed: Strong Authentication Required |
اتّبِع الخطوات الواردة في تحديد المشاكل المتعلقة بالشهادات وحلّها. |
| InvalidCipherTextException: Invalid encryption parameters. Salt/Iteration/Initialization Vector | في حال كنت تشغِّل "أداة مزامنة دليل Google Cloud" على جهاز كمبيوتر لا يتضمّن واجهة مستخدم تصويرية (GUI)، قد يرجع ذلك إلى عدم استيراد المفتاح بشكلٍ صحيح. لمعرفة الخطوات، يُرجى الانتقال إلى كيف يمكنني تفويض "أداة مزامنة دليل Google Cloud" على جهاز بدون توفر واجهة مستخدم تصويرية (GUI)؟ |
| java.lang.RuntimeException: Encountered unrecoverable SQLException. The state database specified "*path-to-folder*\syncState\*folder-name*" | يُرجى تحديد موقع المجلد المذكور في الرسالة وحذفه. بعد ذلك، ابدأ المزامنة مرة أخرى. |
| java.sql.SQLException: Invalid checksum on Page |
تصل عملية أخرى إلى مجلد أو ملفات ذاكرة التخزين المؤقت في نفس الوقت الذي تصل فيه "أداة مزامنة دليل Google Cloud". لتحديد المشاكل وحلّها، يمكنك تنزيل وتشغيل أداة Microsoft's Process Monitor (أداة مراقبة العمليات) ثم إنشاء فلتر. في خيارات الفلترة، استخدِم Path وContains و*path-to-folder*\syncState لتحديد عمليات الوصول إلى المجلد أو الملفات. لمزيد من المعلومات، يُرجى الانتقال إلى مقالة Process Monitor(أداة مراقبة العمليات). |
| Invalid Input: query | لقد أدخلت طلب بحث غير صالح في الحقل طلب بحث المستخدمين. يمكنك إزالة طلب البحث أو التأكد من توافقه مع إرشادات البحث في البحث عن المستخدمين. لمزيد من المعلومات عن طلبات البحث للمستخدمين، يُرجى الانتقال إلى حذف البيانات التي تتضمّن طلبات البحث وقواعد الاستبعاد. |
| SocketException - Connection reset |
إذا تلقيت هذه الرسالة عند الاتصال بخادم LDAP، هذا يعني أن الخادم أنهى الاتصال. في ما يلي الأسباب المحتمَلة:
|
| A lock could not be obtained within the time requested |
لتحديد هذه المشكلة وحلّها:
|
| Error 400: invalid_request: The version of the app you're using doesn't include the latest security features to keep you protected. Please make sure to download from a trusted source and update to the latest, most secure version. | تأكَّد من استخدام أحدث إصدار من "أداة مزامنة دليل Google Cloud". للحصول على التفاصيل، انتقِل إلى تحديث أداة مزامنة دليل Google Cloud. |
| java.sql.SQLException: Directory <directory> cannot be created. |
تتطلب "أداة مزامنة دليل Google Cloud" إذنًا كاملاً للدليل للحفاظ على قاعدة بيانات حالة المزامنة. قد يظهر لك هذا الخطأ في الحالات التالية:
|
| org.jdom.input.JDOMParseException: Error on line 1: Content is not allowed in prolog |
تحاول أداة مزامنة دليل Google Cloud تحميل ملف إعداد من خلال ترميز أحرف غير متوافق. تستخدم أداة GCDS الترميز UTF-8 كترميز أحرف تلقائي. ننصحك باستخدام الترميز نفسه لملفات الإعداد، على الرغم من توافق الترميزات الأخرى. لحلّ هذه المشكلة، يُرجى اتّباع الخطوات التالية:
أكثر ترميزين غير متوافقين هما UTF-7 وUTF-8 BOM. |
| javax.net.ssl.SSLHandshakeException: connection during handshake |
هناك مشكلة في اتصال الشبكة تمنع أداة GCDS من إكمال تأكيد اتصال طبقة المقابس الآمنة (SSL) بخادم Google. وقد ترجع هذه المشكلة إلى البطء الشديد في توجيه جهاز الكومبيوتر لحزمة أو لانقطاع الخدمة لدى مزوّد خدمة الإنترنت مؤقتًا. تُحاول أداة GCDS إتمام تبادل تأكيد اتصال طبقة المقابس الآمنة (SSL) حتى ثلاث مرات. في حال ظهور الرسالة التالية في السجلّات، تكون "أداة مزامنة دليل Google Cloud" قد أكملت عملية تأكيد الاتصال بنجاح في المحاولات التالية، وليس عليك اتخاذ أي إجراء آخر: [usersyncapp.sync.FullSyncAgent] No differences detected, no changes necessary. يُمكنك التعاون مع مشرف الشبكة المحلية لمعرفة الأسباب المؤدية إلى انتهاء مهلة الشبكة. |
| Quota exceeded for the current request | إذا ظهر لك هذا الخطأ في السجلات، يعني هذا أنّه تم حظر "أداة مزامنة دليل Google Cloud" مؤقتًا من استخدام Google APIs. تعيد "أداة مزامنة دليل Google Cloud" تجربة واجهات برمجة التطبيقات، ومن المفترض أن تستمر المزامنة كما هو متوقع. إذا ظهرت لك رسالة الخطأ في تقرير ملخّص المزامنة ولم تكتمل عملية المزامنة بشكل صحيح، يمكنك التواصل مع فريق الدعم. لمعرفة التفاصيل، يُرجى الانتقال إلى ما المعلومات التي أحتاج إليها عن "أداة مزامنة دليل Google Cloud" قبل التواصل مع فريق الدعم؟ |
| java.lang.RuntimeException: Unknown LDAP search rule scope "null" |
هناك قاعدة خالية في أحد أقسام Configuration Manager (مدير الإعداد) التالية:
|
| Invalid digest length for password | لم يتم ضبط طريقة ترميز كلمة المرور الخاصة بمزامنة كلمات المرور بشكلٍ صحيح في "مدير الإعداد" أو خادم LDAP يستخدم طريقة ترميز غير متوافقة مع أداة GCDS. والطرق المتوافقة هي Plaintext وBase64 وMD5 وSHA1. لمزامنة كلمات المرور مع Microsoft Active Directory، يُرجى استخدام ميزة مزامنة كلمات المرور. لمزيد من المعلومات، يُرجى الانتقال إلى كيف ستتم مزامنة كلمات المرور؟ وتحديث أداة مزامنة دليل Google Cloud. |
| 0 nested group(s) |
لحلّ هذه المشكلة، اتّبِع الخطوات التالية:
|
| Suspend user |
قد تحاول أداة GCDS إجراء تغييرات غير متوقعة في حال إجراء مزامنة باستخدام ملف إعداد تم تكراره خارج "مدير الإعداد". يدخل ملف الإعداد الجديد إلى ذاكرة التخزين المؤقت نفسها باعتباره ملف الإعداد الأصلي، ويمكن أن يؤدي عدم الاتساق بينهما إلى تعليق حساب المستخدم. لتكرار ملف إعداد GCDS، استخدِم الخيار حفظ باسم دائمًا في "مدير الإعداد". ويضمن ذلك أن يكون لملف الإعداد الجديد ذاكرة تخزين مؤقت خاصة به. لمزيد من المعلومات، يُرجى الانتقال إلى العمل باستخدام ملفات الإعداد. |
| Skipping unknown member |
أنت تستخدم ملف إعداد أقدم بتنسيق XML لأداة GCDS، وظهر لأداة GCDS عضو مجموعة لا تتضمنه قواعد البحث عن المستخدمين الخاصة بالإعداد. عليك تضمين جميع أعضاء المجموعة والمالكين في قواعد البحث عن المستخدمين، حتى إذا لم تكن تريد مزامنة هؤلاء المستخدمين في نطاق Google. وتحتاج أداة GCDS إلى استخلاص عناوين البريد الإلكتروني لهؤلاء المستخدمين لمعالجة المجموعات بشكل صحيح. بدلاً من ذلك، يُمكنك إنشاء ملف إعداد XML جديد وفارغ. وستفعِّل أداة GCDS عملية مزامنة مجموعات مستقلة تفرض على أداة GCDS مطابقة أعضاء المجموعة بغض النظر عن قواعد مزامنة المستخدمين. وهذا هو الخيار الذي يُنصَح به إذا لم تكن متأكدًا. عند إجراء أي تغييرات على الإعداد، أو إنشاء ملف تهيئة جديد، تأكَّد من إجراء محاكاة ومراجعة للنتائج قبل تشغيل المزامنة الكاملة. لمزيد من المعلومات، يُرجى الانتقال إلى تحديد قائمة المستخدمين. |
| com.google.data.client.GoogleServiceException: Invalid credentials |
إنّ حساب المشرف الذي حدّدته في "مدير الإعداد" ليس حساب مشرف أو ربما يكون هناك خطأ في اسم المستخدم أو كلمة المرور. في Configuration Manager (مدير الإعداد)، انتقِل إلى نطاق Google
لمزيد من المعلومات، انتقِل إلى تحديد إعدادات نطاقك على Google. |
| com.google.gdata.util.ResourceNotFoundException: | تؤدي سمة مفتاح المزامنة المحدّدة في قسم جهات الاتصال المشتركة ضمن "مدير الإعداد" إلى إرجاع قيم فارغة من خادم LDAP. اختَر سمةً من خادم LDAP تحتوي على قيمة مفتاح المزامنة لكل مورد ولا تُعيد سلاسل خالية أو فارغة. |
| Computed differences exceed configured deletion limits, not applying changes | تم الوصول إلى حد الحذف أو التعليق الذي تم ضبطه في "أداة مزامنة دليل Google Cloud". يُمكنك تغيير إعدادات Delete Limits (حدود الحذف) في أداة GCDS لتفادي حدوث هذا الخطأ أو الاطِّلاع على سجل المزامنة للحصول على مزيد من التفاصيل حول ما تم حذفه أو تعليقه، ثم يمكنك اختيار ما إذا كنت تحتاج إلى تغيير الحدّ أم لا. |
| InvalidEmail |
جرِّب الخيارات التالية:
|
| Domain user limit reached |
تُجري أداة GCDS مزامنةً لعدد من المستخدمين يفوق العدد المُحدَّد لحسابك. جرِّب الخيارات التالية:
|
| java.lang.RuntimeException: javax.naming.InvalidNameException: [LDAP: error code 34 - invalid DN] | قد يشير الاسم المميز الأساسي المُحدَّد في "مدير الإعداد" إلى عنصر غير متوفِّر في خادم LDAP. راجِع الاسم المميز الأساسي المُحدَّد في أقسام فلتر جهات الاتصال المشتركة واتصال LDAP والمستخدم والمجموعة والملف الشخصي. تأكَّد من استخدامك لعنصر متوفِّر كاسم مميز أساسي لكلٍ من هذه الأقسام. |
| java.security.cert.CertPathValidatorException: revocation status check failed: no CRL found |
هناك خدمة أخرى أو جهاز شبكة آخر يُعيق اتصال "أداة مزامنة دليل Google Cloud" بمرجع التصديق لشهادة بروتوكول HTTPS المُستخدمة في واجهات برمجة التطبيقات. تحقَّق من وجود قواعد جدار حماية أو خادم وكيل تعمل على تقييد الاتصالات من الجهاز الذي يُشغِّل "أداة مزامنة دليل Google Cloud". إذا كان الوصول إلى الإنترنت من جهاز يُشغِّل أداة GCDS يتطلب وجود خادم وكيل، يجب ضبط الخادم الوكيل بشكلٍ صحيح. لحل هذه المشكلة، يمكنك إيقاف فحص قائمة الشهادات الباطلة (CRL). لإيقاف فحص قائمة الشهادات الباطلة عن طريق إضافة السطور التالية إلى ملفَي config-manager.vmoptions وsync-cmd.vmoptions في دليل تثبيت "أداة مزامنة دليل Google Cloud": -Dcom.sun.net.ssl.checkRevocation=false لمزيد من المعلومات، يُرجى الانتقال إلى كيفية تحقُّق "أداة مزامنة دليل Google Cloud" من قوائم الشهادات الباطلة. |
| javax.naming.directory.InvalidSearchFilterException: Unbalanced parenthesis; remaining name |
لا تحتوي طلبات البحث المُحدَّدة في صفحة أو أكثر من الصفحات التالية في "مدير الإعداد" على أقواس متوازنة:
|
| Root exception is javax.naming.CommunicationException: *servername*:389 |
تعذَّر على أداة GCDS مطابقة اسم خادم LDAP المُحدَّد. تأكَّد من إدخال اسم نطاق مؤهل بالكامل لخادم LDAP، وتأكَّد أيضًا من أنّ الكمبيوتر الذي يُشغِّل أداة GCDS يمكنه مطابقته. ملاحظة:عند استخدام Active Directory، استخدِم اسم النطاق المؤهل بالكامل لنطاقك باعتباره اسم الخادم. |
| SSL peer shut down incorrectly |
غالبًا ما ترجع هذه المشكلة إلى فرض حركة بيانات عبر خادم وكيل. إذا كنت تستخدم خادمًا وكيلاً، ستحتاج إلى ضبط إعدادات الخادم الوكيل في أداة GCDS. تأكَّد من إمكانية اتصال أداة مزامنة دليل Google Cloud بعناوين URL والمنافذ المُحدَّدة هذه من خلال إكمال الخطوات الواردة في السماح بالوصول إلى عناوين URL والمنافذ. قد تنشأ عن برنامج الأمان على الكمبيوتر المحلي مشاكل في الاتصال. ويُمكنك مطالبة المشرف بتعطيل أي برنامج أمان على جهاز العميل والمحاولة مرة أخرى. |
| You are not authorized to access this API | تأكَّد من تفعيل Google APIs المطلوبة. لمزيد من المعلومات، يُرجى الانتقال إلى تفويض حسابك على Google. |
| Domain user limit exceeded | لقد حاولت إضافة مستخدمين يتجاوز عددهم تراخيص المستخدمين المتوفرة. تواصَل مع ممثل المبيعات لشراء المزيد من تراخيص المستخدمين. أو يمكنك تغيير طلبات بحث LDAP لمزامنة عدد أقل من المستخدمين. |
| java.lang.RuntimeException: Failed to execute query because the object at Base DN: "DC=domain,DC=com" is missing or inaccessible |
ابدأ بالتحقق من اسم النطاق في كل من علامة التبويب تهيئة LDAP وفي أي من قواعد البحث التي قد حددت فيها اسم نطاق أساسيًّا ملغيًا. في حال لم يحل هذا الإجراء المشكلة، وأنت متأكد من صلاحية الاسم المميز، قد تكون المشكلة في التحويل باستخدام نظام أسماء النطاقات (DNS). قد تظهر لك معلومات إضافية عن الخطأ في السجلّ، مثل:
تحدد هذه الأخطاء أن اسم المضيف يرفض الاتصال أو الوقت المنقضي. جرّب تشغيل بحث نظام أسماء النطاق على اسم المضيف هذا، وتأكد أن كل العناوين التي يتم عرضها صالحة وتسمح بالاتصالات على المنفذ الذي هيأته. ملاحظة: يمكن أن تحدث هذه الأخطاء حتى إذا حدَّدت اسم مضيف أو عنوان IP صالحًا في إعداد أداة GCDS. قد تصدر عن Active Directory استجابة لإحالة LDAP مع توجيه أداة GCDS للاتصال عبر اسم مضيف. وقد تكون هذه الإحالة مرتبطة في النهاية باسم مضيف يتعذّر مطابقته. يمكنك تجنُّب هذه الإحالات من خلال الاتصال بخادم Active Directory باستخدام منفذ "الكتالوج العام" المُعدّ تلقائيًا على 3268. للحصول على التفاصيل، يُرجى الرجوع إلى وثائق Microsoft. |
| Character is invalid at location |
بعض المعلومات الواردة في المخطط المُخصّص غير صالحة. لمراجعة القيود التي تنطبق على المخطط المُخصَّص، يُرجى الانتقال إلى Directory API: حقول المستخدم المُخصَّص. في حال تفعيل السجلات على مستوى التتبُّع، يمكنك أيضًا الاطّلاع على طلب HTTP الكامل للمخطط المُخصَّص. |
| java.util.concurrent.ExecutionException: java.lang.OutOfMemoryError: GC overhead limit exceeded | تم تجاوز حدّ الذاكرة المُحدَّد. ذلك ما تسبب في تعذُّر المزامنة. لحلّ هذه المشكلة، يُرجى الانتقال إلى ماذا أفعل لو ظهرت لي أخطاء تتعلق بالذاكرة؟ |
| Failed trying to connect to the specified LDAP server |
يتعذّر على أداة GCDS الاتصال بخادم LDAP. تأكَّد مما يلي:
|
| Network problem: Unable to connect to the specified LDAP server | يتعذَّر على أداة GCDS العثور على خادم LDAP. تأكَّد من أنّ الكمبيوتر الذي يُشغِّل أداة GCDS يمكنه الوصول إلى المضيف والمنفذ المُحدَّدين. |
| Authentication problem: Unable to connect using the credentials supplied | يرفض خادم LDAP طلبات "أداة مزامنة دليل Google Cloud" بسبب مشكلة في المصادقة. تأكَّد من صحة المستخدم المفوَّض وكلمة مروره. عليك إضافة المستخدم المفوَّض باستخدام الاسم المميز الكامل. للحصول على تفاصيل حول إضافة مستخدم مفوَّض، يُرجى الانتقال إلى إعدادات اتصال LDAP. |
| Failed to execute query at Base DN <*base-dn*> |
يتعذَّر على "أداة مزامنة دليل Google Cloud" الاتصال بالاسم المميز الأساسي. تأكَّد مما يلي:
|
| Failed to execute query at Base DN <*base-dn*> for attribute: <*attribute*>، reason: NameNotFoundException |
فشلت "أداة مزامنة دليل Google Cloud" في استرداد المعلومات من خادم LDAP. تأكَّد مما يلي:
|
| Member already exists |
قد يظهر لك هذا الخطأ في الحالات التالية:
يمكنك إزالة العلامة من المربّع أو تغيير أحد أسماء المستخدمين الخاصة بعنوان البريد الإلكتروني البديل. إذا تلقّيت أيضًا رسالة الخطأ التالية في السجلّات: "حدث خطأ أثناء إضافة العضو *user-email-address* إلى المجموعة *group-email-address* بسبب مشكلة في العنوان"، عليك التحقَّق مما إذا:
|
| Invalid Input: INVALID_OU_ID | تحاول "أداة مزامنة دليل Google Cloud" وضع مستخدم في وحدة تنظيمية غير متوفِّرة في حساب مؤسستك على Google. يُرجى تعديل قواعد بحث المستخدم وإعادة المحاولة. لمعرفة التفاصيل، يُرجى الانتقال إلى قواعد بحث المستخدم. |
| تم تجاوز الحصة المحدَّدة لمقياس الحصة "طلبات البحث" والحد "طلبات البحث في الدقيقة لكل مستخدم" للخدمة "licensing.googleapis.com" "السبب": "rateLimitExceeded" | في ملف XML الخاص بإعدادات "أداة مزامنة دليل Google Cloud"، يجب التأكُّد من ضبط القيمة *<maxResults>* على 500. يمكنك تغيير هذا العدد إلى 500 إذا لزم الأمر وإعادة تنفيذ المزامنة. |
موضوع ذو صلة
تحديد المشاكل الشائعة في "أداة مزامنة دليل Google Cloud" وحلّها
إنّ Google وGoogle Workspace والعلامات والشعارات المرتبطة بهما هي علامات تجارية مسجَّلة مملوكة من قِبل شركة Google LLC. وجميع أسماء الشركات والمنتجات الأخرى هي علامات تجارية تملكها الشركات ذات الصلة بها.