Ligar máquinas adicionais a um site do ArcGIS Notebook Server (contêiners Windows)

O ArcGIS Notebook Server suporta sites de múltiplas máquinas. Em um site com múltiplas máquinas, cada máquina deve ter a mesma configuração, com o mesmo sistema operacional, configuração idêntica de Mirantis Container Runtime e unidade de rede mapeada com a mesma letra de unidade para o diretório da área de trabalho.

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

Ao pretender a configuração de 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 43 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. É recomendável usar um domínio ou uma conta do Active Directory, mas se você escolher uma conta local, ela deverá existir em cada máquina com uma combinação idêntica de nome e senha. Mantenha em mente que a conta especificada não tem que ser parte do grupo de Administradores.

2. Certifique-se de que você já fez o seguinte durante o processo de instalação:
   1. Instale o Mirantis Container Runtime 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. ArcGIS Notebook Server suporta contêiners do Windows com Mirantis Container Runtime. Baixe as imagens de contêiner que correspondem à sua instalação do My Esri e execute o utilitário de pós-instalação da linha de comando (localizado em <ArcGIS Notebook Server installation directory>\tools\postInstallUtility) para instalar as imagens de contêiner do Docker no ArcGIS Notebook Server. Repita esta etapa em todas as máquinas do ArcGIS Notebook Server. 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 Compartilhamento UNC mapeado como uma unidade de rede ao usar Mirantis Container Runtime. Conceda permissões de leitura e gravação para esses dois diretórios à conta do ArcGIS Notebook Server em cada máquina (certifique-se de fazer isso em ambas as guias Compartilhamento e Segurança do Microsoft File 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 (como quando você coloca 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.
   • Se você estiver utilizando uma conta de serviço gerenciada por grupo (gMSA) para a conta do ArcGIS Notebook Server, você deverá permitir que as contas de serviço tenham permissões de controle total nas guias Compartilhamento e Segurança. No editor Permissões , clique em Adicionar, então abra a caixa de diálogo Tipos de Objeto . Marque a caixa para Contas de Serviç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. Repita as subetapas de A a D para cada máquina adicional que deseja associar ao site.
Quando máquinas adicionais participam do site, elas são consideradas iguais no site; não há máquina primária.
6. 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âmetro	Descrição
      -u ou --username	O nome de usuário de principal administrador do site. O nome de 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.
      -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

      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.

Configurar uma unidade de rede mapeada para o diretório da área de trabalho

Este é um processo opcional que é necessário somente se você planeja configurar um site do Notebook Server com múltiplas máquinas.

1. Crie um compartilhamento UNC para o diretório da área de trabalho do ArcGIS Notebook Server em uma máquina separada que seja acessível ao Notebook Server.

   Anotação:

   Este diretório deve ter acesso de leitura/gravação à conta ArcGIS Notebook Server Windows. É recomendado que você crie um compartilhamento UNC para o diretório da área de trabalho do ArcGIS Notebook Server em uma máquina separada da máquina participante do site ArcGIS Notebook Server. Há um problema conhecido onde os compartilhamentos SMB criados na mesma máquina do Notebook Server serão desconectados ao reiniciar a máquina.

2. Na máquina do Notebook Server abra a janela PowerShell como um administrador.
3. Salve a senha da sua conta de usuário do ArcGIS Notebook Server como uma string segura para uso posterior usando o seguinte comando:

   $password = ConvertTo-SecureString '<password>' -AsPlainText -Force

4. Adicione suporte a credenciais de funções do PowerShell:

   $credential = New-Object System.Management.Automation.PSCredential('<domain\username>', $password)

5. Monte a pasta com o sinalizador Persistente definido:

   New-SmbGlobalMapping -Persistent $true -RemotePath <shared folder path> -Credential $credential -LocalPath <unassigned drive letter>:

6. Repita as etapas 2 a 5 em todas as máquinas participantes do site ArcGIS Notebook Server e atribua a mesma letra de unidade para a unidade mapeada em todas as máquinas.
7. Use a unidade de rede compartilhada criada na etapa anterior para configurar a área de trabalho ao criar o site ArcGIS Notebook Server.