Problemas e soluções comuns

As perguntas ou problemas que você pode encontrar ao trabalhar com ArcGIS Notebook Server são listados e as soluções são sugeridas. Se você não encontrar o problema que está procurando, você também poderá pesquisar por artigos no site da web do Esri Support Center.

Instalação

• Ao carregar imagens de tempo de execução do notebook, recebo o erro nenhum espaço no dispositivo, apesar de ter espaço sobrando na unidade onde ArcGIS Notebook Server e Docker são instalados.

Acesso aos notebooks

• Quando tento abrir um notebook, recebo este erro: Falha na conexão. Não foi possível estabelecer uma conexão com o servidor do notebook. O notebook continuará a tentar reconectar. Verifique sua conexão de rede ou configuração do servidor do notebook.
• Quando tento abrir um notebook, recebo este erro: Não foi possível carregar.
• Quando tento abrir um notebook, recebo este erro: Erro ao abrir o notebook. Não foi possível conectar ao ambiente Docker no servidor do notebook. Certifique-se de que os pré-requisitos do servidor do notebook para executar o Docker foram atendidos.
• Quando tento abrir um notebook, recebo um erro informando que o contêiner não está funcionando.

Notebooks

• Com ArcGIS Notebook Server utilizando contêiners do Windows, quando eu executo dois ou mais notebooks no editor de notebooks que importam a biblioteca de torch ou bibliotecas Python que têm o Torch como dependência, as instruções de importação falham em todos, exceto no primeiro notebook com o qual executei [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.
• Com ArcGIS Notebook Server utilizando contêiners Windows, quando executo um notebook que importa a biblioteca mljar-supervised, a instrução de importação leva muito tempo ou resulta em um erro Kernel died.
• Quando executo uma célula de notebook com código Python que usa um item do portal ArcGIS Enterprise, a solicitação atinge o tempo limite. Isso acontece sempre que executo uma célula que contém uma URL remota.

• Quando executo a primeira célula de notebook padrão (incluindo a string gis = GIS("home")), recebo um erro de URL dizendo Falha temporária na resolução de nomes.
• Quando executo a primeira célula de notebook padrão (incluindo a string gis = GIS("home")), recebo um erro informando: 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'))

Instalação

Ao carregar imagens de tempo de execução do notebook, recebo o erro nenhum espaço no dispositivo, apesar de ter espaço sobrando na unidade onde ArcGIS Notebook Server e Docker são instalados.

Marque as configurações de desktop do Docker para alocação de recurso avançada e verifique se há um tamanho de imagem de disco suficiente alocado para o local da imagem de disco. Aumente o espaço em disco alocado e tente carregar novamente as imagens de tempo de execução do notebook.

Acesso aos notebooks

Quando tento abrir um notebook, recebo este erro: Falha na conexão. Não foi possível estabelecer uma conexão com o servidor do notebook. O notebook continuará a tentar reconectar. Verifique sua conexão de rede ou configuração do servidor do notebook.

Se o seu ArcGIS Web Adaptor for executado em um servidor da web IIS, este erro ocorre quando o protocolo WebSocket é desabilitado nessa máquina. A partir de 10.8, o ArcGIS Web Adaptor ativa automaticamente o protocolo WebSocket nos servidores da Web IIS; você não deve desativar o protocolo.

Quando tento abrir um notebook, recebo este erro: Não foi possível carregar.

O certificado SSL configurado com site web adaptor ArcGIS Notebook Server não é confiável para o seu navegador. Certifique-se de ter um certificado assinado por CA configurado e HTTPS habilitado em seu site.

Se você estiver usando um certificado autoassinado em um ambiente de desenvolvimento ou teste, abra a URL do seu ArcGIS Notebook ServerDiretório do Administrador e adicione uma exceção em seu navegador da web para confiar no certificado autoassinado.

Quando tento abrir um notebook, recebo este erro: Erro ao abrir o notebook. Não foi possível conectar ao ambiente Docker no servidor do notebook. Certifique-se de que os pré-requisitos do servidor do notebook para executar o Docker foram atendidos.

Uma ou mais das configurações de pré-requisito que permitem que o componente Docker Engine trabalhe com ArcGIS Notebook Server não foram configuradas Consulte os seguintes tópicos na guia de instalação para obter mais informações:

• Instalar o Docker para ArcGIS Notebook Server
• Configurar o ArcGIS Notebook Server após a instalação

Ao verificar se todas as configurações necessárias foram definidas, execute o seguinte em um comando para confirmar que Docker está sendo executado em sua máquina do ArcGIS Notebook Server:

docker version
docker run hello-world

Quando tento abrir um notebook, recebo um erro informando que o contêiner não está funcionando.

Se essa mensagem de erro for exibida, o contêiner está disponível, mas não em um estado de execução ou utilizável. Para torná-lo acessível, você deveencerrar o contêiner usando o Diretório do Administrador. Certifique-se de encerrar o contêiner especificado na mensagem de erro. Depois de encerrado, peça ao proprietário do notebook para reabri-lo, o que reiniciará o contêiner.

Notebooks

Com ArcGIS Notebook Server utilizando contêiners do Windows, quando eu executo dois ou mais notebooks no editor de notebooks que importam a biblioteca de torch ou bibliotecas Python que têm o Torch como dependência, as instruções de importação falham em todos, exceto no primeiro notebook com o qual executei [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.

Esse comportamento ocorre devido ao tamanho máximo padrão do arquivo de paginação configurado para a memória virtual nas máquinas Notebook Server. Siga estas etapas para aumentar o tamanho do arquivo de paginação padrão e o máximo de CPU e memória alocados para um notebook.

Anotação:

Consulte o administrador do sistema para obter o tamanho de arquivo de paginação apropriado antes de fazer essas alterações.

1. Em cada máquina ArcGIS Notebook Server clique em Iniciar > Configurações > Sistema > Sobre > Configurações avançadas do sistema
2. Na guia Avançado da caixa de diálogo Propriedades do Sistema, clique em Configurações na seção Desempenho.
3. Na caixa de diálogo Opções de Desempenho, clique na guia Avançado.
4. Clique em Alterar na seção Memória virtual.
5. Na caixa de diálogo Memória virtual, desmarque Gerenciar automaticamente o tamanho do arquivo de paginação para todas as unidades.
6. Selecione Tamanho personalizado.
7. Insira o seu Initial size (MB) e Maximum size (MB).
8. Clique em Ok e reinicie sua máquina.

Depois que sua máquina for reiniciada, siga estas etapas em ArcGIS Notebook Server Manager.

1. Clique em Configurações > Tempos de execução.
2. Selecione o tempo de execução que você usa para executar notebooks que importam a torch e clique em Editar.
3. Atualize o CPU máxima para 4 núcleos e o Memória máxima para 12 GB.
4. Clique em Salvar para confirmar a atualização.
5. Saia do ArcGIS Notebook Server Manager.

Com ArcGIS Notebook Server utilizando contêiners Windows, quando executo um notebook que importa a biblioteca mljar-supervised, a instrução de importação leva muito tempo ou resulta em um erro Kernel died.

Esse comportamento é resultado da biblioteca mljar-supervised tendo muitas dependências. Siga estas etapas para aumentar a CPU máxima alocada para um notebook no ArcGIS Notebook Server Manager.

1. Clique em Configurações > Tempos de execução.
2. Selecione o tempo de execução que você usa para executar notebooks que importam mljar-supervised e clique em Editar.
3. Atualize CPU Máxima para 4 núcleos.
4. Clique em Salvar para confirmar a atualização.
5. Saia do ArcGIS Notebook Server Manager.

Quando executo uma célula de notebook com código Python que usa um item do portal ArcGIS Enterprise, a solicitação atinge o tempo limite. Isso acontece sempre que executo uma célula que contém uma URL remota.

A rede que está sendo usada pelos contêiners Docker em execução em seu site está em conflito com sua rede do ArcGIS Enterprise , que impede que o código Python se conecte à rede. Consulte a documentação Docker sobre configuração de rede. Depois de configurar sua rede para Docker, execute seus notebooks novamente.

Quando executo a primeira célula de notebook padrão (incluindo a string gis = GIS("home")), recebo um erro de URL dizendo Falha temporária na resolução de nomes.

Este erro pode ocorrer quando o ArcGIS Notebook Server e seu componente Docker estão instalados na mesma máquina que outros componentes do ArcGIS Enterprise. Isso ocorre porque a propriedade padrão privatePortalUrl armazenada no ArcGIS Notebook Server é uma versão abreviada do nome de domínio totalmente qualificado. Isso causa uma falha ao tentar entrar em contato com o portal.

A solução é alterar a propriedade privatePortalUrl para ser o nome de domínio totalmente qualificado do site ArcGIS Notebook Server:

1. Entre no ArcGIS Portal Directory como um membro do papel de administrador padrão na sua organização do portal. O formato da URL é https://portal.domain.com:7443/arcgis/portaladmin.
2. Clique em Sistema > Propriedades > Atualizar Propriedades.
3. Na caixa de diálogo Atualizar Propriedades do Sistema, insira uma string JSON com o nome de domínio totalmente qualificado do portal, no seguinte formato:
   { "privatePortalUrl": "https://portal.domain.com:7443/arcgis" }

Quando executo a primeira célula de notebook padrão (incluindo a string gis = GIS("home")), recebo um erro informando: 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'))

Ao implantar contêineres Docker, os servidores de nomes são copiados do arquivo resolv.conf da máquina host. Isso pode resultar em erros nas configurações que usam servidores DNS públicos para máquinas, pois os contêineres Docker precisam ser capazes de resolver nomes DNS internos.

A solução é configurar dockerExtraHosts nas propriedades do sistema ArcGIS Notebook Server:

1. Abra a URL do seu Diretório de Administrador do ArcGIS Notebook Server .
2. Clique em Sistema > Propriedades > Atualizar Propriedades.
3. Na caixa de diálogo Atualizar Propriedades do Sistema, insira uma sequência JSON dos nomes de host e endereços IP no seguinte formato:
   { "dockerExtraHosts": [ { "hostname" : "<host name>", "ip" : "12.34.56.78" } ] }