قد تظهر لك رسائل الخطأ التالية عند استخدام "أداة مزامنة دليل Google Cloud" (GCDS). يمكنك الرجوع إلى الجدول أدناه لتحديد الأخطاء وحلها.
تجربة "أداة تحليل السجلات"
يمكن أن تتعرّف هذه الأداة على معظم المشاكل خلال بضع دقائق من إرسال السجلات.
- أرسِل سجلات التتبّع (كملفات غير مضغوطة أو ملفات ZIP) إلى أداة تحليل سجلات مجموعة أدوات وحدة تحكُّم المشرف في Google.
- للحصول على تحليل سجلّ متقدّم، أرسِل الملفات غير المضغوطة إلى أداة تحليل السجلات 2.
تعرَّف على تفاصيل كيفية تفعيل التسجيل على مستوى التتبُّع.
رسائل الخطأ وحلولها
| رسالة الخطأ | الوصف والحل |
|---|---|
|
مشكلة في الشبكة: يتعذّر الاتصال بخادم LDAP المحدّد: تعذّر الربط البسيط: اسم الخادم:636، السبب: SSLHandshakeException - لم يتم تقديم أي أسماء بديلة للموضوع مشكلة في الشبكة: يتعذّر الاتصال بخادم LDAP المحدّد: تعذّر الربط البسيط: اسم الخادم:636، السبب: SSLHandshakeException - لم يتم العثور على اسم بديل للموضوع في نظام أسماء النطاقات (DNS) يطابق اسم الخادم |
لا يتطابق "الاسم الشائع (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: مَعلمات التشفير غير صالحة. Salt/Iteration/Initialization Vector |
في حال كنت تشغِّل "أداة مزامنة دليل Google Cloud" على جهاز كمبيوتر لا يتضمّن واجهة مستخدم تصويرية (GUI)، قد يرجع ذلك إلى عدم استيراد المفتاح بشكلٍ صحيح. لمعرفة الخطوات، يُرجى الانتقال إلى كيف يمكنني تفويض "أداة مزامنة دليل Google Cloud" على جهاز بدون توفر واجهة مستخدم تصويرية (GUI)؟ |
| java.lang.RuntimeException: Encountered unrecoverable SQLException. قاعدة بيانات الحالة المحدّدة "path-to-folder\syncState\folder-name" |
يُرجى تحديد موقع المجلد المذكور في الرسالة وحذفه. بعد ذلك، ابدأ المزامنة مرة أخرى. |
| java.sql.SQLException: المجموع الاختباري غير صالح في الصفحة |
تصل عملية أخرى إلى مجلد أو ملفات ذاكرة التخزين المؤقت في نفس الوقت الذي تصل فيه "أداة مزامنة دليل Google Cloud". لتحديد المشاكل وحلّها، يمكنك تنزيل وتشغيل أداة Microsoft's Process Monitor (أداة مراقبة العمليات) ثم إنشاء فلتر. في خيارات الفلترة، استخدِم Path وContains وpath-to-folder\syncState لتحديد عمليات الوصول إلى المجلد أو الملفات. لمزيد من المعلومات، يُرجى الانتقال إلى مقالة Process Monitor(أداة مراقبة العمليات). |
| إدخال غير صالح: طلب البحث |
لقد أدخلت طلب بحث غير صالح في الحقل طلب بحث المستخدمين. يمكنك إزالة طلب البحث أو التأكد من توافقه مع إرشادات البحث في البحث عن المستخدمين. لمزيد من المعلومات عن طلبات البحث للمستخدمين، يُرجى الانتقال إلى حذف البيانات التي تتضمّن طلبات البحث وقواعد الاستبعاد. |
| SocketException - Connection reset |
إذا تلقيت هذه الرسالة عند الاتصال بخادم LDAP، هذا يعني أن الخادم أنهى الاتصال. في ما يلي الأسباب المحتمَلة:
|
| تعذّر الحصول على قفل خلال الوقت المطلوب |
لتحديد سبب هذه المشكلة وحلّها، اتّبِع الخطوات التالية:
|
| الخطأ 400: invalid_request: The version of the app you're using doesn't include the latest security features to keep you protected (لا يتضمن إصدار التطبيق الذي تستخدمه أحدث ميزات الأمان لحمايتك). يُرجى التأكُّد من التنزيل من مصدر موثوق به وتحديثه إلى الإصدار الأحدث والأكثر أمانًا. |
تأكَّد من استخدام أحدث إصدار من "أداة مزامنة دليل Google Cloud". للحصول على التفاصيل، انتقِل إلى تحديث أداة مزامنة دليل Google Cloud. |
| java.sql.SQLException: لا يمكن إنشاء الدليل <directory>. |
تتطلب "أداة مزامنة دليل Google Cloud" إذنًا كاملاً للدليل للحفاظ على قاعدة بيانات حالة المزامنة. قد يظهر لك هذا الخطأ في الحالات التالية:
|
| org.jdom.input. JDOMParseException: خطأ في السطر 1: المحتوى غير مسموح به بلغة prolog |
تحاول أداة مزامنة دليل Google Cloud تحميل ملف إعداد من خلال ترميز أحرف غير متوافق. تستخدم أداة GCDS الترميز UTF-8 كترميز أحرف تلقائي. ننصحك باستخدام الترميز نفسه لملفات الإعداد، على الرغم من توافق الترميزات الأخرى. لحلّ هذه المشكلة، يُرجى اتّباع الخطوات التالية:
أكثر ترميزين غير متوافقين هما UTF-7 وUTF-8 BOM. |
| javax.net.ssl. SSLHandshakeException: connection during handshake |
هناك مشكلة في اتصال الشبكة تمنع أداة GCDS من إكمال تأكيد اتصال طبقة المقابس الآمنة (SSL) بخادم Google. وقد ترجع هذه المشكلة إلى البطء الشديد في توجيه جهاز الكومبيوتر لحزمة أو لانقطاع الخدمة لدى مزوّد خدمة الإنترنت مؤقتًا. تُحاول أداة GCDS إتمام تبادل تأكيد اتصال طبقة المقابس الآمنة (SSL) حتى ثلاث مرات. إذا ظهرت الرسالة التالية في السجلّات، تكون أداة GCDS قد أكملت عملية تأكيد الاتصال بنجاح في المحاولات التالية، ولا حاجة لاتخاذ أي إجراء آخر: [usersyncapp.sync.FullSyncAgent] No differences detected, no changes necessary (لم يتم اكتشاف أوجه اختلاف، لا حاجة إلى إجراء تغييرات). يُمكنك التعاون مع مشرف الشبكة المحلية لمعرفة الأسباب المؤدية إلى انتهاء مهلة الشبكة. |
| تم تجاوز الحصّة المقررة للطلب الحالي |
إذا ظهر لك هذا الخطأ في السجلات، يعني هذا أنّه تم حظر "أداة مزامنة دليل Google Cloud" مؤقتًا من استخدام Google APIs. تستعيد "أداة مزامنة دليل Google Cloud" تجربة واجهات برمجة التطبيقات، ومن المفترض أن تستمر المزامنة كما هو متوقع. إذا ظهرت لك رسالة الخطأ في تقرير ملخّص المزامنة ولم تكتمل عملية المزامنة بشكل صحيح، يمكنك التواصل مع فريق الدعم. لمعرفة التفاصيل، يُرجى الانتقال إلى ما المعلومات التي أحتاج إليها عن "أداة مزامنة دليل Google Cloud" قبل التواصل مع فريق الدعم؟ |
| java.lang.RuntimeException: نطاق قاعدة بحث LDAP غير معروف "خالٍ" |
هناك قاعدة خالية في أحد أقسام Configuration Manager (مدير الإعداد) التالية:
لمزيد من المعلومات، يُرجى الانتقال إلى إعداد المزامنة باستخدام "مدير الإعداد". |
| طول الملخّص غير صالح لكلمة المرور |
لم يتم ضبط طريقة ترميز كلمة المرور الخاصة بمزامنة كلمات المرور بشكلٍ صحيح في "مدير الإعداد" أو خادم LDAP يستخدم طريقة ترميز غير متوافقة مع أداة GCDS. والطرق المتوافقة هي Plaintext وBase64 وMD5 وSHA1. لمزامنة كلمات المرور مع Microsoft Active Directory، يُرجى استخدام ميزة مزامنة كلمات المرور. لمزيد من المعلومات، يُرجى الانتقال إلى كيف ستتم مزامنة كلمات المرور؟ وتحديث أداة مزامنة دليل Google Cloud. |
| لا توجد مجموعات متداخلة |
لا تُفرِّق "أداة مزامنة دليل Google Cloud" على نحوٍ صحيح بين المستخدمين والمجموعات المتداخلة على خادم LDAP. لحلّ هذه المشكلة، يُرجى اتّباع الخطوات التالية:
|
| تعليق حساب مستخدم |
قد تحاول أداة GCDS إجراء تغييرات غير متوقعة في حال إجراء مزامنة باستخدام ملف إعداد تم تكراره خارج "مدير الإعداد". يدخل ملف الإعداد الجديد إلى ذاكرة التخزين المؤقت نفسها باعتباره ملف الإعداد الأصلي، ويمكن أن يؤدي عدم الاتساق بينهما إلى تعليق حساب المستخدم. لتكرار ملف إعداد GCDS، استخدِم الخيار حفظ باسم دائمًا في "مدير الإعداد". ويضمن ذلك أن يكون لملف الإعداد الجديد ذاكرة تخزين مؤقت خاصة به. لمزيد من المعلومات، يُرجى الانتقال إلى العمل باستخدام ملفات الإعداد. |
| يتم تخطّي عضو غير معروف |
أنت تستخدم ملف إعداد أقدم بتنسيق 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 تحتوي على قيمة مفتاح المزامنة لكل مورد ولا تُعيد سلاسل خالية أو فارغة. |
| تجاوزت الاختلافات التي تمّ رصدها حدود الحذف التي تم ضبطها، لا يتم تطبيق تغييرات |
تم الوصول إلى حد الحذف أو التعليق الذي تم ضبطه في "أداة مزامنة دليل Google Cloud". يُمكنك تغيير إعدادات Delete Limits (حدود الحذف) في أداة GCDS لتفادي حدوث هذا الخطأ أو الاطِّلاع على سجل المزامنة للحصول على مزيد من التفاصيل حول ما تم حذفه أو تعليقه، ثم يمكنك اختيار ما إذا كنت تحتاج إلى تغيير الحدّ أم لا. |
| InvalidEmail |
تحاول أداة GCDS إنشاء مستخدم أو عنوان بريد إلكتروني بديل متوفِّر في نطاق ليس جزءًا من حسابك في Google. جرِّب الخيارات التالية:
|
| تم الوصول إلى الحدّ الأقصى لعدد المستخدمين في النطاق |
تُجري أداة GCDS مزامنةً لعدد من المستخدمين يفوق العدد المُحدَّد لحسابك. جرِّب الخيارات التالية:
|
| java.lang.RuntimeException: javax.naming.InvalidNameException: [LDAP: error code 34 - invalid DN] |
قد يشير الاسم المميز الأساسي المُحدَّد في "مدير الإعداد" إلى عنصر غير متوفِّر في خادم LDAP. راجِع الاسم المميز الأساسي المُحدَّد في أقسام فلتر جهات الاتصال المشتركة واتصال LDAP والمستخدم والمجموعة والملف الشخصي. تأكَّد من استخدامك لعنصر متوفِّر كاسم مميز أساسي لكلٍ من هذه الأقسام. |
| java.security.cert. CertPathValidatorException: تعذّر التحقّق من حالة الإبطال: لم يتم العثور على CRL |
هناك خدمة أخرى أو جهاز شبكة آخر يُعيق اتصال "أداة مزامنة دليل Google Cloud" بمرجع التصديق لشهادة بروتوكول HTTPS المُستخدمة في واجهات برمجة التطبيقات. تحقَّق من وجود قواعد جدار حماية أو خادم وكيل تعمل على تقييد الاتصالات من الجهاز الذي يُشغِّل "أداة مزامنة دليل Google Cloud". إذا كان الوصول إلى الإنترنت من جهاز يُشغِّل أداة GCDS يتطلب وجود خادم وكيل، يجب ضبط الخادم الوكيل بشكلٍ صحيح. لحل هذه المشكلة، يمكنك إيقاف فحص قائمة الشهادات الباطلة (CRL). لإيقاف فحص قائمة الشهادات الباطلة عن طريق إضافة السطور التالية إلى ملفَي config-manager.vmoptions وsync-cmd.vmoptions في دليل تثبيت أداة مزامنة دليل Google Cloud: لمزيد من المعلومات، يُرجى الانتقال إلى كيفية تحقُّق "أداة مزامنة دليل Google Cloud" من قوائم الشهادات الباطلة. |
| javax.naming.directory. InvalidSearchFilterException: الأقواس غير متوازنة؛ هناك اسم متبقٍ |
لا تحتوي طلبات البحث المُحدَّدة في صفحة أو أكثر من الصفحات التالية في "مدير الإعداد" على أقواس متوازنة:
|
| Root exception is javax.naming. CommunicationException: servername:389 |
تعذَّر على أداة GCDS مطابقة اسم خادم LDAP المُحدَّد. تأكَّد من إدخال اسم نطاق مؤهل بالكامل لخادم LDAP، وتأكَّد أيضًا من أنّ الكمبيوتر الذي يُشغِّل أداة GCDS يمكنه مطابقته. ملاحظة:عند استخدام Active Directory، استخدِم اسم النطاق المؤهل بالكامل لنطاقك باعتباره اسم الخادم. |
| يتم إيقاف تشغيل نظير طبقة المقابس الآمنة (SSL) بصورة غير صحيحة |
غالبًا ما ترجع هذه المشكلة إلى فرض حركة بيانات عبر خادم وكيل. إذا كنت تستخدم خادمًا وكيلاً، ستحتاج إلى ضبط إعدادات الخادم الوكيل في أداة GCDS. تأكَّد من إمكانية اتصال أداة مزامنة دليل Google Cloud بعناوين URL والمنافذ المُحدَّدة هذه من خلال إكمال الخطوات الواردة في السماح بالوصول إلى عناوين URL والمنافذ. قد تنشأ عن برنامج الأمان على الكمبيوتر المحلي مشاكل في الاتصال. ويُمكنك مطالبة المشرف بتعطيل أي برنامج أمان على جهاز العميل والمحاولة مرة أخرى. |
| ليس لديك إذن بالوصول إلى واجهة برمجة التطبيقات هذه |
تأكَّد من تفعيل Google APIs المطلوبة. لمزيد من المعلومات، يُرجى الانتقال إلى تفويض حسابك على Google. |
| تم تجاوز الحدّ الأقصى لعدد المستخدمين في النطاق |
لقد حاولت إضافة مستخدمين يتجاوز عددهم تراخيص المستخدمين المتوفرة. تواصَل مع ممثل المبيعات لشراء المزيد من تراخيص المستخدمين. أو يمكنك تغيير طلبات بحث LDAP لمزامنة عدد أقل من المستخدمين. |
| java.lang.RuntimeException: Failed to execute query because the object at Base DN: "DC=domain,DC=com" is missing or inaccessible (تعذَّر تنفيذ طلب البحث؛ لأن العنصر في الاسم المميز الأساسي: "DC=domain,DC=com" مفقود أو لا يمكن الوصول إليه) |
ابدأ بالتحقق من اسم النطاق في كل من علامة التبويب تهيئة 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 |
تم تجاوز حدّ الذاكرة المُحدَّد. ذلك ما تسبب في تعذُّر المزامنة. لحلّ هذه المشكلة، يُرجى الانتقال إلى ماذا أفعل لو ظهرت لي أخطاء تتعلق بالذاكرة؟ |
| حدث فشل أثناء محاولة الاتصال بخادم LDAP المحدّد |
يتعذّر على أداة GCDS الاتصال بخادم LDAP. تأكد مما يلي:
|
| مشكلة في الشبكة: يتعذّر الاتصال بخادم LDAP المحدّد |
يتعذَّر على أداة GCDS العثور على خادم LDAP. تأكَّد من أنّ الكمبيوتر الذي يُشغِّل أداة GCDS يمكنه الوصول إلى المضيف والمنفذ المُحدَّدين. |
| مشكلة في المصادقة: يتعذّر الاتصال باستخدام بيانات الاعتماد المحدّدة |
يرفض خادم LDAP طلبات "أداة مزامنة دليل Google Cloud" بسبب مشكلة في المصادقة. تأكَّد من صحة المستخدم المفوَّض وكلمة مروره. عليك إضافة المستخدم المفوَّض باستخدام الاسم المميز الكامل. للحصول على تفاصيل حول إضافة مستخدم مفوَّض، يُرجى الانتقال إلى إعدادات اتصال LDAP. |
| تعذّر تنفيذ طلب البحث بالاسم المميز الأساسي <base-dn> |
يتعذَّر على "أداة مزامنة دليل Google Cloud" الاتصال بالاسم المميز الأساسي. تأكد مما يلي:
|
| تعذّر تنفيذ طلب البحث بالاسم المميز الأساسي <base-dn> للسمة: <attribute>، السبب: NameNotFoundException |
فشلت "أداة مزامنة دليل Google Cloud" في استرداد المعلومات من خادم LDAP. تأكد مما يلي:
|
|
العضو موجود من قبل |
قد يظهر لك هذا الخطأ في الحالات التالية:
يمكنك إزالة العلامة من المربّع أو تغيير أحد أسماء المستخدمين الخاصة بعنوان البريد الإلكتروني البديل. إذا تلقّيت أيضًا رسالة الخطأ التالية في السجلّات: "حدث خطأ أثناء إضافة العضو user-email-address إلى المجموعة group-email-address بسبب مشكلة في العنوان"، عليك التحقَّق مما إذا:
|
| إدخال غير صالح: INVALID_OU_ID |
تحاول "أداة مزامنة دليل Google Cloud" وضع مستخدم في وحدة تنظيمية غير متوفِّرة في حساب مؤسستك على Google. يُرجى تعديل قواعد بحث المستخدم وإعادة المحاولة. لمعرفة التفاصيل، يُرجى الانتقال إلى قواعد البحث عن المستخدم. |
| تم تجاوز الحصة المحدَّدة لمقياس الحصة "طلبات البحث" والحد "طلبات البحث في الدقيقة لكل مستخدم" للخدمة "licensing.googleapis.com" "السبب": "rateLimitExceeded" |
في ملف XML الخاص بإعدادات "أداة مزامنة دليل Google Cloud"، يجب التأكُّد من ضبط القيمة <maxResults> على 500. يمكنك تغيير هذا العدد إلى 500 إذا لزم الأمر وإعادة تنفيذ المزامنة. |
موضوع ذو صلة
تحديد المشاكل الشائعة في "أداة مزامنة دليل Google Cloud" وحلّها
إنّ Google وGoogle Workspace والعلامات والشعارات المرتبطة بهما هي علامات تجارية مسجَّلة مملوكة من قِبل شركة Google LLC. وجميع أسماء الشركات والمنتجات الأخرى هي علامات تجارية تملكها الشركات ذات الصلة بها.