المشاكل الشائعة والحلول

تم إدراج الأسئلة أو المشكلات التي قد تواجهها عند العمل مع ArcGIS Notebook Server وأيضًا تم اقتراح الحلول. إذا لم تجد المشكلة التي تبحث عنها، يمكنك أيضًا البحث عن الموضوعات على موقع مركز دعم Esri .

تثبيت

• يحدث عدم استجابة للدليل الإداري ArcGIS Notebook Server على Windows بعد التثبيت أو بعد إعادة تشغيل جهاز Notebook Server.
• عند تحميل صور وقت تشغيل دفتر الملاحظات، أحصل على الخطأ لا توجد مساحة كافية على الجهاز، على الرغم من وجود مساحة على محرك الأقراص الذي تم تثبيت ArcGIS Notebook Server وDocker عليه.
• كيف يمكنني إزالة صور الحاويات السابقة من جهازي؟

الوصول إلى دفاتر الملاحظات

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

مفكرات

• مع ArcGIS Notebook Server باستخدام حاويات Windows، عندما أقوم بتشغيل دفتري ملاحظات أو أكثر في محرر دفتر الملاحظات الذي يستورد مكتبة Torch أو مكتبات Python التي تحتوي على Torch كعنصر تبعية، تفشل عبارات الاستيراد في الكل ما عدا دفتر الملاحظات الأول الذي قمت بتشغيله مع [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies.
• مع ArcGIS Notebook Server باستخدام حاويات Windows، عندما أقوم بتشغيل دفتر ملاحظات يستورد مكتبة mljar-supervised، يستغرق بيان الاستيراد وقتًا طويلاً أو ينتج عنه خطأ Kernel died.
• عند تشغيل خلية دفتر ملاحظات بتعليمة Python البرمجية التي تستخدم عنصر بوابة ArcGIS Enterprise الإلكترونية، تنتهي مهلة الطلب. يحدث هذا عندما أقوم بتشغيل خلية تحتوي على عنوان URL بعيد.

• عندما أقوم بتشغيل أول خلية افتراضية من دفتر الملاحظات (بما في ذلك سلسلة gis = GIS("home"))، أحصل على خطأ بعنوان URL يقول فشل مؤقت في دقة الاسم.
• عندما أقوم بتشغيل أول خلية افتراضية من دفتر الملاحظات (بما في ذلك سلسلة gis = GIS("home"))، أحصل على خطأ بعنوان: ConnectionError: حدث خطأ في الاتصال: HTTPSConnectionPool(host=،port=443): تم تجاوز الحد الأقصى لمحاولات الوصول إلى عنوان: /portal/sharing/rest/info=fjson (الناتج عن NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: فشل في إنشاء اتصال جديد: [Errno -3] فشل مؤقت في دقة الاسم'))

تثبيت

يحدث عدم استجابة للدليل الإداري ArcGIS Notebook Server على Windows بعد التثبيت أو بعد إعادة تشغيل جهاز Notebook Server.

قد تحدث هذه المشكلة عندما لا تبدأ الخدمة ArcGIS Notebook Server Windows والخدمة Docker بالترتيب الصحيح بعد التثبيت أو إعادة تشغيل الجهاز.

لحل هذه المشكلة، يمكنك تعيين الخدمة ArcGIS Notebook Server Windows للبدء تلقائيًا مع تأخير. هذا سيتيح للخدمة Docker Windows الوقت الكافي للتهيئة الكاملة قبل بدء تشغيل الخدمة ArcGIS Notebook Server Windows.

لتكوين الخدمة ArcGIS Notebook Server Windows للبدء التلقائي مع تأخير، يرجى اتباع الخطوات التالية:

1. افتح تطبيق الخدمات على جهازك ArcGIS Notebook Server Windows.
2. انقر بزر الماوس الأيمن على الخدمة ArcGIS Notebook Server وحدد خصائص.
3. انقر فوق عام.
4. في Startup type، حدد تلقائي (تأخر البدء).
5. انقر على تطبيق.
6. أعد تشغيل الجهاز الخاص بك لتطبيق التغييرات.
7. إذا كان هناك أكثر من جهاز واحد يتبع موقعك ArcGIS Notebook Server، كرر هذه الخطوات على كل جهاز.

عند تحميل صور وقت تشغيل دفتر الملاحظات، أحصل على الخطأ لا توجد مساحة كافية على الجهاز، على الرغم من وجود مساحة على محرك الأقراص الذي تم تثبيت ArcGIS Notebook Server وDocker عليه.

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

كيف يمكنني إزالة صور الحاويات السابقة من جهازي؟

في نظام التشغيل Windows Server بإصدار Mirantis Container Runtime، توجد صور الحاويات في مجلد C:\ProgramData\docker\windowsfilter. لإزالة جميع صور الحاويات السابقة على جهازك وتوفير مساحة على القرص، قم بتشغيل الأمر التالي في PowerShell بامتياز المسؤول.

docker system prune -af

إذا لم يتم إزالة جميع طبقات الصور من C:\ProgramData\docker\windowsfilter، قم بإعادة تشغيل جهازك وقم بتشغيل الأوامر التالية في PowerShell بامتياز المسؤول.

ملاحظة:‏

قم بهذه العمليات قبل تحميل صورة الحاوية ArcGIS Notebook Server Windows، حيث أن هذه العملية ستقوم بإزالة جميع صور الحاويات على الجهاز.

• $FolderPath = "C:\ProgramData\docker\windowsfilter"

• Get-ChildItem -Path $FolderPath -Directory | % {Rename-Item $_.FullName "$($_.FullName)-removing" -ErrorAction:SilentlyContinue}

• while ((Get-ChildItem -Path $FolderPath -Force | Measure-Object).Count -gt 0)
  {
  Restart-Service docker
  }

الوصول إلى دفاتر الملاحظات

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

إذا كان ArcGIS Web Adaptor يعمل على خادم ويب IIS، يحدث هذا الخطأ عند تعطيل بروتوكول WebSocket في ذلك الجهاز. بدءًا من 10.8، يقوم ArcGIS Web Adaptor بتمكين بروتوكول WebSocket تلقائيًا على خوادم ويب IIS؛ يجب عليك ألا تعطل هذا البروتوكول.

عندما أحاول فتح دفتر ملاحظات، أحصل على هذا الخطأ: يتعذر التحميل.

شهادة SSL التي تم تكوينها باستخدام Web Adaptor لموقع ArcGIS Notebook Server غير موثوقة من مستعرض الويب. تأكد من أن شهادة CA الموقعة تم تكوينها وأنه تم تمكين HTTPS في موقعك.

إذا كنت تستخدم شهادة ذاتية التوقيع في بيئة التطور أو التشغيل المرحلي، فافتح عنوان URL الخاص ArcGIS Notebook Serverبدليل مسؤولي وأضف استثناءً إلى متصفح الويب الخاص بك للوثوق بالشهادة ذاتية التوقيع.

عند محاولتي لفتح دفتر ملاحظات، أحصل على هذا الخطأ: خطأ في فتح دفتر الملاحظات. يتعذر الاتصال ببيئة Docker في خادم دفتر الملاحظات. يرجى التأكد من أن متطلبات خادم دفتر الملاحظات الأساسية المطلوبة لتشغيل Docker تم استيفاؤها.

لم يتم تكوين واحد أو أكثر من الإعدادات الأساسية التي تتيح لمكون Docker Engine العمل مع ArcGIS Notebook Server. راجع الموضوعات التالية في دليل التثبيت للمزيد من المعلومات:

• تثبيت Docker لـ ArcGIS Notebook Server
• تكوين ArcGIS Notebook Server بعد التثبيت

عند التحقق من أن كل الإعدادات اللازمة تم تكوينها، قم بتشغيل ما يلي في موجه أوامر لتأكيد أن Docker يعمل على جهاز ArcGIS Notebook Server:

docker version
docker run hello-world

عند محاولتي فتح دفتر ملاحظات، أحصل على خطأ بأن الحاوية لا تعمل.

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

مفكرات

مع ArcGIS Notebook Server باستخدام حاويات Windows، عندما أقوم بتشغيل دفتري ملاحظات أو أكثر في محرر دفتر الملاحظات الذي يستورد مكتبة Torch أو مكتبات Python التي تحتوي على Torch كعنصر تبعية، تفشل عبارات الاستيراد في الكل ما عدا دفتر الملاحظات الأول الذي قمت بتشغيله مع [WinError 1455] The paging file is too small for this operation to complete. Error loading "C:\ArcGIS_Server\Server\framework\runtime\ArcGIS\bin\Python\envs\arcgispro-py3\lib\site-packages\torch\lib\caffe2_detectron_ops_gpu.dll" or one of its dependencies.

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

ملاحظة:‏

استشر مسؤول النظام لديك لمعرفة الحجم المناسب لملف ترحيل الصفحات قبل إجراء هذه التغييرات.

1. من على كل جهاز ArcGIS Notebook Server، انقر على بدء > إعدادات > النظام > حول > إعدادات النظام المتقدمة.
2. في علامة تبويب متقدم لمربع حوار خصائص النظام، انقر على الإعدادات في قسم الأداء.
3. في مربع حوار خيارات الأداء، انقر على علامة التبويب متقدم.
4. انقر فوق تغيير في قسم الذاكرة الافتراضية.
5. في مربع حوار الذاكرة الافتراضية، قم بإلغاء التأشير على إدارة حجم ملف ترحيل الصفحات تلقائيًا لجميع محركات الأقراص.
6. حدد حجم مخصص.
7. أدخل القيم لـ Initial size (MB)و Maximum size (MB).
8. انقر فوق موافق وأعد تشغيل جهاز الكمبيوتر الخاص بك.

بمجرد إعادة تشغيل جهازك، اتبع هذه الخطوات في ArcGIS Notebook Server Manager:

1. انقر فوق الإعدادات > أوقات التشغيل.
2. حدد وقت التشغيل الذي تستخدمه لتشغيل دفاتر الملاحظات التي تستورد Torch وانقر فوق تحرير.
3. قم بتحديث أقصى قدرة لوحدة المعالجة المركزية إلى 4 معالجات والذاكرة القصوى إلى 12 جيجا بايت.
4. انقر على حفظ لتأكيد التحديث.
5. أغلق مدير ArcGIS Notebook Server.

مع ArcGIS Notebook Server باستخدام حاويات Windows، عندما أقوم بتشغيل دفتر ملاحظات يستورد مكتبة mljar-supervised، يستغرق بيان الاستيراد وقتًا طويلاً أو ينتج عنه خطأ Kernel died.

هذا السلوك هو نتيجة وجود العديد من التبعيات في مكتبة mljar-supervised. اتبع هذه الخطوات لزيادة الحد الأقصى لوحدة المعالجة المركزية المخصصة لدفتر ملاحظات "Notebook" في ArcGIS Notebook Server Manager:

1. انقر فوق الإعدادات > أوقات التشغيل.
2. حدد وقت التشغيل الذي تستخدمه لتشغيل دفاتر الملاحظات التي تستورد mljar-supervised وانقر فوق تحرير.
3. قم بتحديث أقصى قدرة لوحدة المعالجة المركزية إلى 4 معالجات.
4. انقر على حفظ لتأكيد التحديث.
5. أغلق مدير ArcGIS Notebook Server.

عند تشغيل خلية دفتر ملاحظات بتعليمة Python البرمجية التي تستخدم عنصر بوابة ArcGIS Enterprise الإلكترونية، تنتهي مهلة الطلب. يحدث هذا عندما أقوم بتشغيل خلية تحتوي على عنوان URL بعيد.

تتعارض الشبكة المستخدمة من قبل حاويات Docker التي تعمل في موقعك مع شبكة ArcGIS Enterprise، مما يمنع تعليمة Python البرمجية من الاتصال بالشبكة. راجع وثائق Docker الخاصة بتكوين الشبكات. عندما تقوم بتكوين الشبكة لـ Docker، قم بتشغيل دفتر الملاحظات مرة أخرى.

عندما أقوم بتشغيل أول خلية افتراضية من دفتر الملاحظات (بما في ذلك سلسلة gis = GIS("home"))، أحصل على خطأ بعنوان URL يقول فشل مؤقت في دقة الاسم.

يمكن أن يقع هذا الخطأ عندما يتم تثبيت ArcGIS Notebook Server ومكونه الخاص Docker في الجهاز نفسه مثل مكونات ArcGIS Enterprise الأخرى. يحدث الخطأ لأن خاصية privatePortalUrl الافتراضية المخزنة في ArcGIS Notebook Server تعد إصدارًا مختصرًا لاسم المجال المؤهل بالكامل. يسبب هذا فشلاً عند محاولة الاتصال بالبوابة.

يكمن الحل في إصلاح خاصية privatePortalUrl لتكون اسم المجال المؤهل بالكامل لموقع ArcGIS Notebook Server:

1. سجّل الدخول علىArcGIS Portal Directory بصفتك عضو لدور المسئول الافتراضي في البوابة الإلكترونية. سيكون تنسيق عنوان URL https://portal.domain.com:7443/arcgis/portaladmin.
2. انقر على نظام > خصائص > تحديث الخصائص.
3. في مربع حوار تحديث خصائص النظام، أدخل سلسلة JSON مع اسم النطاق المؤهل بالكامل للبوابة الإلكترونية، بالتنسيق التالي:
   { "privatePortalUrl": "https://portal.domain.com:7443/arcgis" }

عندما أقوم بتشغيل أول خلية افتراضية من دفتر الملاحظات (بما في ذلك سلسلة gis = GIS("home"))، أحصل على خطأ بعنوان: ConnectionError: حدث خطأ في الاتصال: HTTPSConnectionPool(host=،port=443): تم تجاوز الحد الأقصى لمحاولات الوصول إلى عنوان: /portal/sharing/rest/info=fjson (الناتج عن NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: فشل في إنشاء اتصال جديد: [Errno -3] فشل مؤقت في دقة الاسم'))

عند نشر حاويات Docker، يتم نسخ خوادم الاسم من ملف resolv.conf الخاص بالجهاز المضيف. يمكن أن يؤدي ذلك إلى حدوث أخطاء في عمليات الإعداد التي تستخدم خوادم DNS العامة للأجهزة، إذ يجب أن تكون حاويات Docker قادرة على حل أسماء DNS الداخلية.

يتمثل الحل في تكوين dockerExtraHosts في خصائص نظام ArcGIS Notebook Server:

1. افتح عنوان URL الخاص بدليل مسؤول ArcGIS Notebook Server.
2. انقر على نظام > خصائص > تحديث الخصائص.
3. في مربع حوار تحديث خصائص النظام، أدخل سلسلة JSON لأسماء المضيف وعناوين IP باستخدام التنسيق التالي:
   { "dockerExtraHosts": [ { "hostname" : "portal.domain.com", "ip" : "12.34.56.78" } ] }