Skip To Content

Configurar diretórios do ArcGIS Notebook Server

O ArcGIS Notebook Server armazene as configurações baseadas no arquivo e conteúdo necessário para suas operações em diretórios do servidor. Estes diretórios podem ser adicionados durante a instalação e configuração do ArcGIS Notebook Server ou posteriormente com a utilização do ArcGIS Notebook Server.

Há quatro tipos de diretórios, cada um desempenha um papel específico em operações de servidor: o diretório da área de trabalho, o diretório de dados, o diretório de saída e o diretório do sistema. A área de trabalho e diretórios de dados são descritos abaixo; os diretórios de sistema e saída são para propósitos internos no ArcGIS Notebook Server.

Diretório da área de trabalho

Este diretório da área de trabalho permite que os autores do notebook armazenem e leiam os arquivos em seu notebooks. Cada autor do notebook do portal ArcGIS Enterprise tem uma pasta única dentro do diretório da área de trabalho. Uma única pasta de usuário é montada em cada um de seus ArcGIS Notebooks, para que o notebbok possa ler e gravar no diretório da área de trabalho. Um notebook pode somente ler e gravar informações na pasta de diretório da área de trabalho respectiva do seu usuário; esta pasta não pode ser acessada de outros notebooks dos usuários.

Por padrão, diretórios da área de trabalho privados dos usuários são criados nas pastas /directories/arcgisworkspace/<userid>, com permissões configuradas como -rwxrwxrwx. Este nível de permissão é necessário pois, por padrão, a conta de usuário do Linux que está executando dentro do contêiner terá um UID e GID diferente (ID de grupo) da sua conta de usuário do SO que está sendo executada no daemon do ArcGIS Notebook Server.

Se você não deseja utilizar o modelo de permissão aberto por razões de segurança, é possivel alterar o modelo utilizando uma propriedade de sistema denominada applyDefaultUserWorkspacePermissions. Quando esta propriedade for configurada para true, diretórios da área de trabalho serão criados utilizando a configuração padrão do seu sistema, como -rwx------, ao invés de abrir a configuração do -rwxrwxrwx.

Para utilizar este recurso, o usuário do SO executando o daemon do ArcGIS Notebook Server deve ter um UID de 1050 e um GID de 100 (para corresponder o UID e o GID do usuário do contêiner).

  1. Entre no Diretório do Administrador. A URL está formatada como https://notebookserver.domain.com:11443/arcgis/admin.
  2. Navegue para Sistema > Propriedades, e clique em Editar.
  3. Adicione a seguinte string JSON para a caixa de propriedadese salve sua edição:

    {
       "applyDefaultUserWorkspacePermissions":"true"
    }

Diretório de dados

Os dados são fundamentais para ArcGIS Notebooks. Ao criar notebooks, os usuários podem adicionar camadas de dados a partir de itens do portal ArcGIS Enterprise, a partir de servidores GIS externos ou a partir de diretórios de arquivo local.

Um diretório local contendo dados pode ser disponibilizado para notebooks como um caminho de arquivo sendo registrado com seu site do ArcGIS Notebook Server. Diretórios de dados múltiplos podem ser registrados com um site do servidor. Cada diretório de dados registrado é disponibilizado para utilize uso de cada notebook que executa neste site.

Os Notebooks que utilizam fluxos de trabalho e análise raster tem um uso particular para diretórios de dados. Você pode registrar um armazenamento de raster baseado em arquivo como um diretório de dados, disponibilizando a saída das ferramentas de análise raster imediatamente nos notebooks.

Considerações para diretórios de dados

Para que os notebooks tenham acesso a um diretório de dados registrados, configure as permissões de modo 755 para o diretório.

Todos os autores de notebook em sua organização podem adicionar dados de todos os diretórios de dados registrados para seus notebooks. Não é possível limitar diretórios de dados para certos usuários ou grupos do portal.

Em fluxos de trabalho de aprendizado detalhado que envolve a geração de chips de imagens para treinar um modelo, os chips são hospedados em um armazenamento de raster baseado em arquivo. Ao executar tal fluxo de trabalho, registre o armazenamento de raster com ArcGIS Notebook Server como um diretório de dados para disponibilizar os chips de imagem para seus notebooks.

Dados em um diretório de dados registrado não é parte do portal ArcGIS Enterprise. Consequentemente, quando um notebook for compartilhado, assegure que todos os usuários que visualizarão o notebook compartilhado tenha acesso a qualquer diretório de dados registrado que o notebook referencia.

Registre um novo diretório de dados

Você pode registrar um diretório de dados no ArcGIS Notebook Server Manager para disponibilizar um diretório local ao site do servidor.

  1. Entre no seu portal do ArcGIS Enterprise como um administrador e abra o ArcGIS Notebook Server Manager.
  2. Abra a página Configurações, e clique em Diretórios.
  3. Clique em Registrar Diretório de Dados para abrir o diálogo de registro.
  4. Forneça o nome do diretório e seu caminho completo em sua máquina.
  5. Indique que o diretório funcionará como um diretório do DATA.
  6. Clique em Salvar para confirmar.

Você não pode editar ou atualizar o nome ou caminho de um diretório registrado com ArcGIS Notebook Server. Para fazer as alterações, você deve cancelar o registro do diretório existente e então registrá-lo novamente.

Especifique uma nova localização para um diretório de servidor

Você pode editar um diretório existente no Manager para alterar sua localização iniciando na versão 10.8. Utilize este método ao expandir para um site de múltiplas máquinas para posicionar seus diretórios em caminhos de arquivo compartilhados.

  1. Entre no seu portal do ArcGIS Enterprise como um administrador e abra o ArcGIS Notebook Server Manager.
  2. Abra a página Configurações, e clique em Diretórios.
  3. Escolha o diretório que deseja modificar, e clique no ícone Editar.
  4. Substitua o valor do Caminho de Diretório existente com o novo caminho do diretório. Clique em Salvar para confirmar.

    Após o site reiniciar, ele utilizará o novo caminho para acessar o diretório.

  5. Copie e cole o conteúdo do diretório existente para sua nova localização.

Repita estas etapas para cada diretório que deseja atualizar.

Anotação:

Se o local do diretório arcgisworkspace for atualizado, você deverá executar novamente o utilitário de instalação para extrair dados de amostra para o novo local do diretório da área de trabalho.