Se presentan los problemas o las preguntas que puedan presentarse al trabajar con ArcGIS Notebook Server, así como posibles soluciones. Si no encuentra el problema que está buscando, también puede buscar artículos en el sitio web del centro de Soporte de Esri.
Instalación
Acceder a notebooks
- Cuando intento abrir un notebook, aparece este error: Error en la conexión. No se ha podido establecer una conexión con Notebook Server. El notebook seguirá intentando conectarse. Compruebe su conexión de red o la configuración de Notebook Server.
- Cuando intento abrir un notebook, aparece este error: No se puede cargar.
- Cuando intento abrir un notebook, aparece este error: Error al abrir Notebook. No se pudo conectar al entorno de Docker en Notebook Server. Asegúrese de que se cumplen los requisitos previos de Notebook Server para ejecutar Docker.
- Cuando intento abrir un notebook, aparece un error que indica que el contenedor no se está ejecutando.
Notebooks
- Con ArcGIS Notebook Server y al utilizar contenedores de Windows, cuando ejecuto dos o más notebooks en el editor de notebooks que importan la biblioteca torch o las bibliotecas de Python que tienen Torch como dependencia, las declaraciones de importación fallan en todo excepto en el primer notebook que he ejecutado con [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.
- Con ArcGIS Notebook Server y al utilizar contenedores de Windows, cuando ejecuto un notebook que importa la biblioteca mljar-supervised, la declaración de importación tarda mucho tiempo o da como resultado un error de Kernel died.
- Al ejecutar una celda de notebook con un código de Python que utiliza un elemento del portal de ArcGIS Enterprise, la solicitud caduca. Esto ocurre cuando ejecuto una celda que contiene una URL remota.
- Al ejecutar la primera celda predeterminada del notebook (incluida la cadena de caracteres gis = GIS("home")), aparece un error de URL que indica que se ha producido un error temporal en la resolución del nombre.
- Al ejecutar la primera celda predeterminada del notebook (incluida la cadena de caracteres gis = GIS("home")), aparece un error que indica: ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))
Instalación
Al cargar imágenes en tiempo de ejecución del notebook, aparece el error no queda espacio en el dispositivo, a pesar de tener espacio en la unidad donde están instalados ArcGIS Notebook Server y Docker.
Compruebe la asignación de recursos avanzados en la configuración de escritorio de Docker y asegúrese de que se ha asignado un tamaño suficiente para las imágenes de disco a la ubicación en la que se guardan. Aumente el espacio en disco asignado y vuelva a intentar cargar las imágenes en tiempo de ejecución del notebook.
En Windows Server con Mirantis Container Runtime, las imágenes de contenedor se encuentran en la carpeta C:\ProgramData\docker\windowsfilter. Para eliminar todas las imágenes de contenedor anteriores que haya en el equipo y liberar espacio en disco, ejecute el comando siguiente en PowerShell con privilegios de administrador.
docker system prune -af
Si no se eliminan todas las capas de imágenes de C:\ProgramData\docker\windowsfilter, reinicie el equipo y ejecute los comandos siguientes en PowerShell con privilegios de administrador.
Nota:
Realice estas operaciones antes de cargar la imagen de contenedor de ArcGIS Notebook Server Windows, ya que este proceso eliminará todas las imágenes de contenedor del equipo.
$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 }
Acceder a notebooks
Su navegador web no confía en el certificado SSL configurado con el Web Adaptor del sitio de ArcGIS Notebook Server. Asegúrese de que tiene configurado un certificado firmado por una autoridad certificadora y de que HTTPS esté habilitado en su sitio.
Si utiliza un certificado autofirmado en un entorno de desarrollo o provisional, abra la URL del Directorio de administrador de ArcGIS Notebook Server y agregue una excepción en el navegador web para que confíe en el certificado autofirmado.
Cuando intento abrir un notebook, aparece este error: Error al abrir Notebook. No se pudo conectar al entorno de Docker en Notebook Server. Asegúrese de que se cumplen los requisitos previos de Notebook Server para ejecutar Docker.
No se han configurado uno o varios de los ajustes de requisitos previos que posibilitan que el componente Docker Engine funcione con ArcGIS Notebook Server. Consulte los temas siguientes en la guía de instalación para obtener más información:
- Instalar Docker para ArcGIS Notebook Server
- Configurar ArcGIS Notebook Server después de la instalación
Cuando verifique que se han configurado todos los ajustes necesarios, ejecute lo siguiente en una línea de comandos para confirmar que Docker se está ejecutando en su equipo de ArcGIS Notebook Server:
docker version
docker run hello-world
Cuando intento abrir un notebook, aparece un error que indica que el contenedor no se está ejecutando.
Si aparece este mensaje de error, el contenedor está disponible, pero no se encuentra en estado de ejecución o utilización. Para que sea accesible, debe cerrar el contenedor mediante el Directorio de administrador. Asegúrese de cerrar el contenedor especificado en el mensaje de error. Una vez cerrado, haga que el propietario del notebook vuelva a abrir el notebook, que volverá a iniciar el contenedor.
Notebooks
Con ArcGIS Notebook Server y al utilizar contenedores de Windows, cuando ejecuto dos o más notebooks en el editor de notebooks que importan la biblioteca torch o las bibliotecas de Python que tienen Torch como dependencia, las declaraciones de importación fallan en todo excepto en el primer notebook que he ejecutado con [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.
Este comportamiento se debe al tamaño máximo de archivo de paginación predeterminado configurado para la memoria virtual en los equipos Notebook Server. Siga estos pasos para aumentar el tamaño del archivo de paginación predeterminado y el máximo de CPU y memoria asignados a un notebook.
Nota:
Consulte al administrador del sistema el tamaño de archivo de paginación adecuado antes de realizar estos cambios.
- En cada equipo ArcGIS Notebook Server, haga clic en Inicio > Configuración > Sistema > Acerca de > Configuración avanzada del sistema.
- En la pestaña Opciones avanzadas del cuadro de diálogo Propiedades del sistema, haga clic en Configuración en la sección Rendimiento.
- En el cuadro de diálogo Opciones de rendimiento, haga clic en la pestaña Opciones avanzadas.
- Haga clic en Cambiar en la sección Memoria virtual.
- En el cuadro de diálogo Memoria virtual, desactive Administrar automáticamente el tamaño de archivo de paginación para todas las unidades.
- Seleccione Tamaño personalizado.
- Introduzca su Initial size (MB) y Maximum size (MB).
- Haga clic en Aceptar y reinicie el equipo.
Una vez reiniciado el equipo, siga estos pasos en ArcGIS Notebook Server Manager.
- Haga clic en Configuración > Tiempos de ejecución.
- Seleccione el tiempo de ejecución que utiliza para ejecutar notebooks que importan torch y haga clic en Editar.
- Actualice la CPU máxima a 4 núcleos y la Memoria máx. a 12 GB.
- Haga clic en Guardar para confirmar la actualización.
- Salga de ArcGIS Notebook Server Manager.
Con ArcGIS Notebook Server y al utilizar contenedores de Windows, cuando ejecuto un notebook que importa la biblioteca mljar-supervised, la declaración de importación tarda mucho tiempo o da como resultado un error de Kernel died.
Este comportamiento se debe a que la biblioteca mljar-supervised tiene muchas dependencias. Siga estos pasos para aumentar el número máximo de CPU asignado a un notebook en ArcGIS Notebook Server Manager.
- Haga clic en Configuración > Tiempos de ejecución.
- Seleccione el tiempo de ejecución que utiliza para ejecutar notebooks que importan mljar-supervised y haga clic en Editar.
- Actualice la CPU máxima a 4 núcleos.
- Haga clic en Guardar para confirmar la actualización.
- Salga de ArcGIS Notebook Server Manager.
Al ejecutar una celda de notebook con un código de Python que utiliza un elemento del portal de ArcGIS Enterprise, la solicitud caduca. Esto ocurre cuando ejecuto una celda que contiene una URL remota.
La red utilizada por los contenedores de Docker que se ejecutan en su sitio está en conflicto con su red de ArcGIS Enterprise, lo que impide que el código de Python se conecte a la red. Consulte la documentación de Docker sobre la configuración de redes. Cuando haya configurado su red para Docker, vuelva a ejecutar sus notebooks.
Al ejecutar la primera celda predeterminada del notebook (incluida la cadena de caracteres gis = GIS("home")), aparece un error de URL que indica que se ha producido un error temporal en la resolución del nombre.
Este error puede producirse cuando ArcGIS Notebook Server y su componente de Docker se instalan en el mismo equipo que otros componentes de ArcGIS Enterprise. Se produce porque la propiedad predeterminada privatePortalUrl almacenada en ArcGIS Notebook Server es una versión abreviada del nombre de dominio totalmente calificado. Esto provoca un error al intentar ponerse en contacto con el portal.
La solución es hacer que la propiedad privatePortalUrl sea el nombre de dominio totalmente calificado del sitio de ArcGIS Notebook Server:
- Inicie sesión en el Directorio de Portal for ArcGIS como miembro del rol de administrador predeterminado en su portal. El formato de URL es https://portal.domain.com:7443/arcgis/portaladmin.
- Haga clic en Sistema > Propiedades > Actualizar propiedades.
- En el cuadro de diálogo Actualizar propiedades del sistema, inserte una cadena de caracteres JSON con el nombre de dominio totalmente calificado del portal, en el siguiente formato:
{ "privatePortalUrl": "https://portal.domain.com:7443/arcgis" }
Al ejecutar la primera celda predeterminada del notebook (incluida la cadena de caracteres gis = GIS("home")), aparece un error que indica: ConnectionError: A connection error has occurred: HTTPSConnectionPool(host=,port=443): Max retires exceeded with url: /portal/sharing/rest/info=fjson (caused by NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Failed to establish a new connection: [Errno -3] Temporary failure in name resolution'))
Al implementar contenedores Docker, se copian los servidores con nombre del archivo resolv.conf del equipo host. Esto puede dar lugar a errores en la configuración que utilizan los servidores DNS públicos para los equipos, como los contenedores Docker que se necesitan para averiguar los nombres DNS internos.
La solución consiste en configurar dockerExtraHosts en las propiedades del sistema ArcGIS Notebook Server:
- Abra la URL del directorio del administrador de ArcGIS Notebook Server.
- Haga clic en Sistema > Propiedades > Actualizar propiedades.
- En el cuadro de diálogo Actualizar propiedades del sistema, inserte una cadena de caracteres JSON de los nombres de host y las direcciones IP en el siguiente formato:
{ "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }