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

• O diretório administrativo do ArcGIS Notebook Server no Windows não responde após a instalação ou após a reinicialização da máquina de servidor do notebook.
• 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.
• Como removo as imagens de contêiner anteriores da minha máquina?

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: Ocorreu um erro de conexão: HTTPSConnectionPool(host=,port=443): Max retira excedido com url: /portal/sharing/rest/info=fjson (causado por NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Falha ao estabelecer uma nova conexão: [Errno -3] Falha temporária na resolução de nomes'))

Instalação

O diretório administrativo do ArcGIS Notebook Server no Windows não responde após a instalação ou após a reinicialização da máquina de servidor do notebook.

Esse problema pode ocorrer se o serviço do ArcGIS Notebook Server Windows e o serviço do Docker não iniciar na ordem correta após a instalação ou reinicialização da máquina.

Para resolver esse problema, defina o serviço do ArcGIS Notebook Server Windows para iniciar automaticamente com um atraso. Isso permitirá que o serviço do Docker Windows seja totalmente inicializado antes do serviço do ArcGIS Notebook Server Windows iniciar.

Para configurar o serviço do ArcGIS Notebook Server Windows para iniciar automaticamente com atraso, execute as seguintes etapas:

1. Abra o aplicativo Serviços em sua máquina do ArcGIS Notebook Server Windows.
2. Clique com o botão direito no serviço do ArcGIS Notebook Server e selecione Propriedades.
3. Clique em Geral.
4. Em Startup type, selecione Automático (Início atrasado).
5. Clique em Aplicar.
6. Reinicie sua máquina para aplicar as alterações.
7. Se houver mais de uma máquina que faça parte do seu site do ArcGIS Notebook Server, repita essas etapas em cada máquina.

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.

Como removo as imagens de contêiner anteriores da minha máquina?

No Windows Server com Mirantis Container Runtime, as imagens do contêiner estão localizadas na pasta C:\ProgramData\docker\windowsfilter. Para remover todas as imagens de contêiner anteriores da sua máquina e liberar espaço em disco, execute o seguinte comando no PowerShell com privilégios de administrador.

docker system prune -af

Se nem todas as camadas da imagem forem removidas C:\ProgramData\docker\windowsfilter, reinicie sua máquina e execute os seguintes comandos no PowerShell com privilégios de administrador.

Anotação:

Execute estas operações antes de carregar a imagem do contêiner do ArcGIS Notebook Server Windows, pois este processo removerá todas as imagens de contêiner da máquina.

• $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
  }

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 do 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 valores para 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 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 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. Feche o 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. Feche o 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: Ocorreu um erro de conexão: HTTPSConnectionPool(host=,port=443): Max retira excedido com url: /portal/sharing/rest/info=fjson (causado por NewConnectionError ('urllib3.connection.HTTPSConnection object at 0x7f672e592b0>: Falha ao estabelecer uma nova conexão: [Errno -3] Falha temporária na resolução de nomes'))

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" } ] }