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

O ArcGIS Notebook Server suporta sites de múltiplas máquinas na versão 10.7.1 e posteriores. 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.

A partir da versão 10.9, o ArcGIS Notebook Server suporta sites com várias licenças, permitindo que todas as máquinas que participam de um site não precisem mais do mesmo nível de licença. Por exemplo, você pode configurar um site de três máquinas com uma máquina configurada com uma licença avançada e duas máquinas configuradas com licenças padrão. Antes da versão 10.9, todas as máquinas eram obrigadas a ter o mesmo nível de licença (avançada ou padrão). Esse recurso de várias licenças introduzido na versão 10.9 permitirá o dimensionamento com um número variável de máquinas que têm uma licença avançada ou padrão.

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 têm o mesmo software instalado, com a mesma versão. 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 um site do ArcGIS Notebook Server , você especifica 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.

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 11443 para comunicação de cada máquina em sua implantação do ArcGIS Enterprise.

   Certifique-se de instalar o mesmo usuário do sistema operacional em ambas as máquinas. A conta de usuário utilizada para instalar o ArcGIS Notebook Server será a conta utilizada para executar o software. Os usuários do grupo e todos os outros devem ter pelo menos permissões de execução no diretório de instalação do ArcGIS Notebook Server . Note que a instalação do ArcGIS Notebook Server com a conta raiz não é suportada. A conta de usuário utilizada para instalar em duas máquinas, por exemplo, poderia ser a seguinte:

   1. Instale o ArcGIS Notebook Server na primeira máquina em /data/ags como usuário ags, com um ID de usuário 58103.
   2. Instale o ArcGIS Notebook Server em uma segunda máquina em /data/ags com o mesmo nome de usuário e ID (ags, ID de usuário 58103).
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, especificando o usuário da instalação como o proprietário. Um deve ser para o armazenamento de configuração e os outros para seus diretórios do servidor. Você deve conceder pelo menos 700 permissões para as pastas.

   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.

   Por exemplo:
   1. Crie um diretório chamado config-store. Especifique o proprietário como ags, com o ID de usuário 58103. Conceda pelo menos 700 permissões para o diretório.
   2. Compartilhe a pasta do armazenamento de configuração de forma que ambas as máquinas possam acessar o diretório utilizando o mesmo caminho, por exemplo, /net/myserver/config-store.
   3. Crie um diretório chamado arcgisnotebookserver. Especifique o proprietário como ags, com o ID de usuário 58103. Conceda pelo menos 700 permissões para o diretório.
   4. Compartilhe a pasta arcgisnotebookserver de forma que ambas as máquinas possam acessar o diretório utilizando o mesmo caminho, por exemplo, /net/myserver/arcgisnotebookserver.

      Mesmo que os diretórios estejam na mesma máquina que você utilizará ao criar o site, você deverá ainda criar e compartilhar os diretórios manualmente e referenciá-los por uma caminho de rede.

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. 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.sh. 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 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.
      -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.sh -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.

Após todas as máquinas participarem do site, o processo de configuração restante é o mesmo dos sites de ú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ê também pode utilizar o utilitário da linha de comando joinSite para ligar sua 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 ligar 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 é /net/mymachine/data/arcgisnotebookserver/usr/config-store:

   {"connectionString": "/net/mymachine/data/arcgisnotebookserver/usr/config-store", " configPersistenceType": "FILESYSTEM" }

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.
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.