Skip To Content

Ligar máquinas adicionais a um site do ArcGIS Notebook Server

O ArcGIS Notebook Server suporta sites de múltiplas máquinas a partir da versão 10.7.1. Em um site de múltiplas máquinas, cada máquina é configurada da mesma forma, com configurações indênticas do Docker e cada pode uma pode executar o ArcGIS Notebooks.

Validado:

Na versão 10.7, somente sites de máquina única eram suportados.

Sites do ArcGIS Notebook Server de múltiplas máquinas permitem a você suportar mais usuários de notebooks simultâneos. Se você tiver muitos usuários ativos ou se os recursos da sua única máquina forem inadequados para as necessidades dos seus usuários, expandir para um site com múltiplas máquinas pode ser benéfico.

Anotação:

Se você tiver alguns usuários do notebook que precisam de mais recursos de máquina, avalie a possibilidade de modificar os limites de recursos do site como uma alternativa limitada à adição de máquinas.

Todas as máquinas em um site do ArcGIS Notebook Server tem o mesmo software instalado, com a mesma versão e o mesmo arquivo de licença. Na primeira máquina que você instalar, você precisará criar o site do ArcGIS Notebook Server. Você poderá então ligar máquinas adicionais do ArcGIS Notebook Server ao site.

Anotação:

Ao contrário de outros papéis do ArcGIS Server, o ArcGIS Notebook Server não suporta a inserção de máquinas adicionais a um site a partir da primeira máquina. Você deve acessar cada máquina e ligá-las ao site, utilizando o assistente de configuração do ArcGIS Notebook Server ou o utilitário joinsite .

Antes de instalar

Ao criar um site, você determina onde armazenar os arquivos de configuração, um diretório hospedando os arquivos críticos e informações de configuração para seu site. Seu site também tem os diretórios do servidor system e workspace .

Ao criar pela primeira vez um site do ArcGIS Notebook Server, você especificará locais para o armazenamento de configuração e os diretórios do servidor. Em um site de múltiplas máquinas, você deve compartilhar o armazenamento de configuração e diretórios do servidor de forma que as outras máquinas possam acessá-los. Cada máquina que participa do site deve receber permissões de leitura e gravação nestes locais compartilhados.

Unidades compartilhadas e replicação

Em sites do ArcGIS Notebook Server de múltiplas máquinas, a maioria dos diretórios do servidor e o armazenamento de configuração do site estão hospedados em locais compartilhados acessíveis para cada máquina. A exceção é o diretório da área de trabalho, que é montado para cada contêiner de usuário do Docker . O Docker não suporta a montagem de unidades compartilhadas para contêiners em sistemas Windows, portanto, o diretório da área de trabalho deve permanecer local em cada máquina. Como os usuários podem iniciar contêiners e abrir notebooks em qualquer máquina em um site com várias máquinas, você deve sincronizar o conteúdo no diretório da área de trabalho entre as máquinas.

Site de múltiplas máquinas do Windows

O Windows oferece uma solução de replicação nativa: replicação de dados do Sistema de Arquivos Distribuídos (DFS), que sincroniza os dados entre as máquinas de maneira eficiente, sincronizando somente os pacotes de dados que foram alterados, em vez de itens inteiros. Ao utilizar o DFS, a pasta a ser replicada é mantida em um local idêntico em cada máquina.

A replicação DFS não é a única maneira possível de sincronizar o conteúdo do seu diretório da área de trabalho do site ArcGIS Notebook Server. Mas como é um método nativo frequentemente utilizado para Windows, as etapas para instalá-la são fornecidas em Configurar replicação DFS do ArcGIS Notebook Server. Você pode discutir com seu administrador de TI se o DFS ou outro sistema de replicação é melhor para sua organização.

Instalar e configurar um site de múltiplas máquinas

Quando você pretende configurar um site do ArcGIS Notebook Server de múltiplas máquinas, há alguns etapas adicionais a seguir neste guia de instalação.

  1. Revise os requisitos de sistema do ArcGIS Notebook Server para verificar se cada máquina está qualificada. Em cada máquina, ajuste os firewalls para abrir a porta 11443 para comunicação de cada máquina em sua implantação do ArcGIS Enterprise.

    A versão instalada do ArcGIS Notebook Server e seu arquivo de licença devem ser os mesmos em cada máquina. Insira a mesma conta do ArcGIS Notebook Server durante cada instalação. É recomendado que você utilize um domínio ou conta de Diretório Ativo, mas se você escolher uma conta local, ela precisará existir em cada máquina com uma combinação de nome e senha idêntica. Mantenha em mente que a conta especificada não tem que ser parte do grupo de Administradores.

  2. Certifique-se que você já tenha feito o seguinte durante o processo de instalação até este ponto:
    1. Instalar o Docker em cada máquina. Em cada máquina, baixe as imagens do Docker fornecidas pela Esri e salve-as em um local que o sistema possa acessar.
    2. Instalar e autorizar o ArcGIS Notebook Server em cada máquina. Você também pode instalar silenciosamente o software.
    3. Execute o utilitário PostInstaller da linha de comandos (localizado em <ArcGIS Notebook Server installation directory>\tools\postInstallUtility) para carregar as imagens do Docker no repositório local em cada máquina.
    4. Siga as etapas para configurar o ArcGIS Notebook Server após a instalação.
  3. Crie e compartilhe dois diretórios em sua rede. Um deve ser para o armazenamento de configuração e o outro para alguns dos diretórios do servidor. O diretório workspace deve permanecer em um caminho local. Conceda permissões de leitura e gravação para estes dois diretórios na conta do ArcGIS Notebook Server em cada máquina (tenha certeza de fazer isto em ambas a guia Compartilhamento e a guia Segurança do Windows Explorer).
    Anotação:

    Os diretórios de rede compartilhados que estão ocultos ou utilizam caracteres especiais (por exemplo, $) não são suportados pelo ArcGIS Notebook Server.

    • Mesmo que os diretórios estejam na mesma máquina que você utilizará ao criar o site, você deve ainda criar e compartilhar os diretórios manualmente e referenciá-los por um caminho de rede (UNC).
    • Se a conta do ArcGIS Notebook Server não existir na máquina (no caso de você colocar o armazenamento de configuração e os diretórios do servidor em um servidor de arquivos), é necessário criar a conta do ArcGIS Notebook Server utilizando o mesmo nome e senha que você utilizou em todas as outras máquinas em sua implementação.
  4. De uma das suas máquinas, crie um site do ArcGIS Notebook Server . Certifique-se de utilizar os caminhos para os diretórios do servidor e armazenamento de configuração que você configurou anteriormente.
  5. Após as etapas anteriores serem concluídas, você poderá associar cada máquina adicional ao site que você criou utilizando um assistente de configuração. Se você preferir participar do site a partir da linha de comando, consulte a etapa 6.
    1. Da primeira máquina adicional, abra o Assistente de Configuração do ArcGIS Notebook Server.
    2. Revise e siga as instruções fornecidas no assistente, e então clique em Continuar.
    3. Clique em Participar de Um Site Existente.
    4. Insira a URL do site e as credenciais do seu site do ArcGIS Notebook Server conforme criado na etapa 4.
    5. Repitas as etapas pelo para cada máquina adicional que você deseja que participe do site.
  6. Quando máquinas adicionais participam do site, elas são consideradas iguais no site; não há máquina primária.
  7. Como alternativa ao uso do assistente de configuração, você pode ligar a máquina ao site utilizando um utilitário da linha de comando como a seguir.
    1. Verifique se você está logado na máquina com a conta do ArcGIS Notebook Server.
    2. Abra uma janela de comando e execute o utilitário, que está localizado em <ArcGIS Notebook Server install directory>\tools\JoinSiteUtility\joinsite.bat. A seguir estão os parâmetros de linha de comando do utilitário:

      ParâmetroDescrição

      -u ou --username

      O nome de usuário do administrador do site primário.

      O nome do usuário não pode conter esses caracteres: \/:*?|<>

      -p ou --password

      A senha de principal administrador do site.

      A senha não pode conter estes caracteres: \/:*?|<>

      -f ou --file

      O arquivo de conexão do armazenamento de configuração do utilitário joinsite .

      -s ou --siteUrl

      A URL de site do ArcGIS Notebook Server existente para participar, no formato https://notebookserver.domain.com:11443/arcgis/admin.

      -h ou --help

      Exibe ajuda da linha de comando e sai.

      Um comando de exemplo para o utilitário:

      <ArcGIS Notebook Server install directory>\tools\JoinSiteUtility\joinsite.bat -u notebookPSA -p my.Password3 -s https://notebookserver.domain.com:11443/arcgis/admin

      Se as credenciais da conta e a URL do site forem inseridas corretamente, o utilitário ligará a máquina ao site do ArcGIS Notebook Server. Repita esta etapa para cada máquina adicional.

Neste ponto, você pode configurar um sistema de replicação para o diretório da área de trabalho em todas as máquinas do ArcGIS Notebook Server. As etapas para configurar uma opção para replicação são fornecidas em Configurar replicação DFS para ArcGIS Notebook Server. Você pode configurar um sistema de replicação a qualquer momento durante o processo de instalação.

Após todas as máquinas participarem do site, o processo de configuração restante é o mesmo dos sites de uma única máquina. Prossiga para instalar e configurar ArcGIS Web Adaptor com seu site. Você configurará seu site com o seu portal do ArcGIS Enterprise .

Entre em um site a partir da linha de comandos

Você pode utilizar o utilitário da linha de comando joinSite para adicionar uma máquina a um site do ArcGIS Notebook Server. Este utilitário exige que você especifique o local do armazenamento de configuração do site existente, em vez da sua URL. Por causa disto, o utilitário é vantajoso para certos casos no qual o uso da URL obstruiria a fila de solicitações de rede do site. Considere utilizar este utilitário se as máquinas em seu site do ArcGIS Notebook Server já estiverem sobrecarregadas com solicitações de rede ou se você deseja adicionar um grande número de máquinas ao seu site ao mesmo tempo.

O utilitário join-site é instalado em \tools\JoinSiteUtility no diretório da instalação do ArcGIS Notebook Server. Execute o utilitário join-site a partir da máquina do ArcGIS Notebook Server que deseja adicionar a um site existente, utilizando a conta de Run As do ArcGIS Notebook Server.

  1. Conceda acesso de leitura e gravação na pasta do armazenamento de configuração do site existente à conta de rede utilizada para executar o serviço do ArcGIS Notebook Server na máquina ou nas máquinas que você deseja unir ao site.
  2. Crie um arquivo JavaScript Object Notation (JSON) denominado connection.json.
  3. Adicione a seguinte linha ao arquivo, substituindo <path to the configuration store> pelo local de armazenamento de configuração do site ArcGIS Server existente

    {"configPersistenceType": "FILESYSTEM", "connectionString": "<path to the configuration store>"}

    Neste exemplo, o caminho para o armazenamento de configuração do site existente é \\\\myshare\\arcgisserver\\config-store

    {" configPersistenceType": "FILESYSTEM", "connectionString": "\\\\myshare\\arcgisserver\\config-store"}

  4. Salve e feche o arquivo connection.json.
  5. Adicione o arquivo connection.json na máquina que participará do site ou em um diretório compartilhado que você possa acessar a partir da máquina que participará do site.
  6. Abra uma janela de comando e execute o join-site.
  7. A sintaxe é como segue:
    joinSite -f <The file path to the configuration store JSON file>
    Neste exemplo, o arquivo JSON do armazenamento de configuração (connection.json) presume-se que esteja localizado no mesmo diretório que a ferramenta join-site (\tools\JoinSiteUtility).
    joinsite.bat -f connection.json

A máquina é adicionada ao site ArcGIS Notebook Server.