Atualizar ArcGIS Notebook Server (contêiners Linux).

A atualização do ArcGIS Notebook Server fornece à sua organização os recursos e melhorias mais recentes do software, ao mesmo tempo que preserva os recursos existentes de usuários de notebooks. Se você estiver atualizando sua implantação do ArcGIS Enterprise para 11.1, você também deve atualizar oArcGIS Notebook Server.

O pacote de instalação do ArcGIS Notebook Server11.1 detecta se você tem uma instalação existente de uma versão anterior do ArcGIS Notebook Server na sua máquina. Se você tiver, poderá atualizar o software para11.1.

Durante o processo de atualização, você deve reautorizar o software ArcGIS Notebook Server para 11.1 se você atualizou de 10.8.1 ou anterior.

Você também deve instalar as novas imagens de contêiner da Esri, fornecendo aos seus usuários o tempo de execução do notebok 11.1. Os tempos de execução do notebook da versão anterior permanecerão no site; os usuários ainda podem executar notebooks usando esses tempos de execução. No entanto, se os seus usuários desejarem o uso de funcionalidades que forem novas no 11.1, eles deverão atualizar o tempo de execução dos seus notebooks. Os tempos de execução do notebook correspondentes à versão 11.1 estão na versão 8.0 (ArcGIS Notebook Server Standard 8.0 e ArcGIS Notebook Server Advanced 8.0).

Anotação:

Se algum notebook estiver usando tempos de execução personalizados, você deverá reconstruir e registrar novamente os tempos de execução personalizados no servidor do notebook Windows e atualizar as configurações de tempo de execução dos itens de notebook associados.

Anotação:

Os tempos de execução do notebook serão descontinuados seguindo a Vida Útil do ArcGIS Enterprise . Os notebooks não devem usar tempos de execução obsoletos e devem ser atualizados para um tempo de execução suportado.

A atualização do portal ArcGIS Enterprise também atualizará os notebooks de amostra disponíveis na galeria do site.

Sites de múltiplas máquinas do ArcGIS Notebook Server são suportados no 10.7.1 e posterior. Se você tiver um site de única máquina e deseja expandir seu site doArcGIS Notebook Server para múltiplas máquinas após a atualização, siga as etapas parajuntar máquinas adicionais ao site após terminar a atualização para 11.1.

O processo de atualização para ArcGIS Notebook Server é uma atualização local, que não exige a desinstalação e reinstalação do software. O site ficará inativo durante o processo de atualização e os usuários não poderão acessar ou executar notebooks até que a atualização seja concluída.

Siga as etapas abaixo para atualizar o ArcGIS Notebook Server para 11.1.

Preparar para atualizar

Antes de atualizar, revise cuidadosamente as seguintes informações:

• Você pode acessar todos os arquivos necessários no My Esri antes da atualização, incluindo imagens de contêiner do 11.1.
• Para ArcGIS Notebook Server funcionar corretamente, sua versão deve corresponder à versão do portal ao qual está federado.
• Atualize o Docker para a versão 20.10.13 ou posterior.
• Para atualizar sua implantação do ArcGIS Enterprise, faça o seguinte:
  1. Atualize o Portal for ArcGIS.
  2. Atualize o ArcGIS Web Adaptor (para Portal).
  3. Atualize o site do ArcGIS Server servindo como o servidor de hospedagem do portal.
  4. Atualize oArcGIS Web Adaptor (para Server).
  5. Atualizar ArcGIS Data Store (atualize primeiro a primária então, a auxiliar).
  6. Atualize quaisquer outros servidores, incluindoArcGIS Notebook Server.
  7. Instalar Dados de Amostra do ArcGIS Notebook Server
• Não desinstale seu ArcGIS Notebook Serverexistente. A instalação do ArcGIS Notebook Server e instaladores da linha de comando são projetados para descobrir e atualizar uma instalação existente de componentes do ArcGIS Notebook Server.
• Não cancele sua federação de site do ArcGIS Notebook Server a partir do portal ou remova sua designação como o Servidor de Notebook do portal em nenhum momento durante o processo de atualização. Isto impacta negativamente os notebooks existentes hospedados pelo portal.
• Você pode atualizar o ArcGIS Notebook Serverusando o instalador de Configuração ou linha de Comando. Escolha um destes métodos para atualizar.
• Antes de atualizar, limpe os caches de todos os navegadores da web utilizados na máquina do ArcGIS Notebook Server .
• A conta de serviço do Windows para seu site do ArcGIS Notebook Server (sua conta Executar Como) deve permanecer a mesma durante a atualização.

Criar cópia de segurança da sua implantação

Antes de atualizar, é recomendado que você crie cópias de segurança de sua implantação.

Validado:

Na versão 10.7, você deve criar cópias de segurança manualmente do armazenamento de configuração do site e de diretórios do servidor.

Notebooks serão incluídos nas cópias de segurança do portal usando o utilitário webgisdr.

Você pode utilizar a operação exportSite no ArcGIS Notebook Server Administrator Directory para criar a cópia de segurança de um armazenamento de configuração do site, como descrito abaixo. Além desta cópia de segurança da configuração do site, considere criar cópias de segurança manuais do seu sistema de arquivos.

Execute as seguintes etapas para executar a operação de cópia de segurança.

1. Abra o ArcGIS Notebook Server Administrator Directory e entre como um usuário com privilégios administrativos.

   A URL é normalmente https://notebookserver.domain.com:11443/arcgis/admin.

2. Vá até o site > Exportar Site.
3. Insira o caminho completo da localização em sua máquina o qual deseja exportar o arquivo.

   O site deve ter acesso a este diretório.

4. Clique em Exportar.

   Quando a operação de exportação estiver concluída, o diretório fornecerá um link para a localização do arquivo de cópia de segurança no servidor.

5. Baixe o arquivo, que terá uma extensão do arquivo .agssite, tão prontamente quanto possível.

Atualizar utilizando o programa de instalação

Anotação:

Utilize o arquivo de configuração para atualizar ArcGIS Notebook Server para 11.1. Após atualizar a configuração, você deve atualizar o site do ArcGIS Notebook Server usando o assistente de configuração ou o utilitário de atualização do site.

Se você tiver um site com várias máquinas, siga as etapas 1 a 3 para uma máquina e repita essas etapas para cada máquina do site.

O ArcGIS Notebook Server é projetado para descobrir e atualizar uma instalação existente de componentes do ArcGIS Notebook Server.

1. Para iniciar a atualização, execute ./Setup a partir da localização onde ArcGIS Notebook Server foi extraído e siga as instruções para concluir a atualização.

   A configuração deve ser executada como a conta do usuário que instalou o ArcGIS Notebook Server existente. Durante a instalação, o programa de instalação identifica a instalação existente e você será solicitado a confirmar a atualização. Digite a opção y para prosseguir com a instalação.

   Isto desinstalará a versão anterior do ArcGIS Notebook Server e instalará a versão atualizada do ArcGIS Notebook Server.

2. Após a conclusão do utilitário de atualização, autorize novamente o software ArcGIS Notebook Server para 11.1. Use o assistente de autorização de software para concluir a autorização.
3. Abra o assistente de configuração usando a URL listada no final da atualização de sua instalação e siga as instruções na tela para atualizar o site.
4. Para um site de várias máquinas, siga as etapas 1 a 3 para cada máquina no site.

Atualizar a partir da linha de comando

Para atualizar a partir da linha de comando, conclua as seguintes etapas:

1. Para iniciar a atualização, execute o comando de configuração do ArcGIS Notebook Server com o argumento mostrado no exemplo abaixo. Certifique-se de utilizar a mesma conta do ArcGIS Notebook Server utilizada por sua instalação existente.

   Isso desinstala a versão anterior do ArcGIS Notebook Server e instala a versão atualizada do ArcGIS Notebook Server.

   setup.exe /qn USER_NAME=<ArcGIS Notebook Server account username> PASSWORD=<password> ACCEPTEULA=yes

2. Utilize o utilitário upgradesite e conclua a atualização executando o seguinte comando. Por padrão, o utilitário upgradesite é encontrado em C:\Program Files\ArcGIS\NotebookServer\tools\upgradesiteutility\upgradesite.bat.

   upgradesite.bat -s

   O utilitário exibe relatórios de progresso e para quando a atualização é concluída. O utilitário possui dois parâmetros:

   • -s—Quando incluído no comando, solicita ao utilitário que execute a atualização. A atualização não será executada sem -s. Isto serve como uma proteção para garantir que você execute somente a atualização quando estiver pronto.
   • -h—Exibe a ajuda da ferramenta. Quando o comando é executado sem -s, a ajuda também aparece.

3. Para um local com várias máquinas, repita as etapas 1 e 2 para cada máquina no local e continue com as etapas da próxima seção.

Autorizar silenciosamente

Após o utilitário de atualização ser concluído, você deverá reautorizar seu software ArcGIS Notebook Server para 11.1 se você atualizou de 10.8.1 ou anterior.

Execute SoftwareAuthorization.exe com a sintaxe seguinte para autorizar o ArcGIS Notebook Server silenciosamente. Você deve ter todas as informações do usuário completas no arquivo de autorização ou provisionamento antes de executar o arquivo.

Se você tiver um arquivo de autorização e sua máquina estiver conectada à Internet, execute o seguinte:

<System disk drive>\Program Files\ArcGIS\NotebookServer\framework\bin /S /Ver <version number> /LIF <full path and name of authorization file>

Autorizar em um ambiente desconectado

Você pode autorizar o ArcGIS Notebook Server em um ambiente desconectado usando um arquivo de aprovisionamento (.prvc). Durante o processo, um arquivo é gerado para você enviar para Esri para concluir o processo.

1. Na janela de comando, execute o comando fornecido abaixo após a conclusão da instalação do ArcGIS Notebook Server :

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .prvc file> /O <full path to authorization file output>

2. Quando o arquivo de informações de saída for criado, siga um destes procedimentos:
   • Procure pelo site da web de atendimento ao consumidor da Esri em https://service.esri.com/drm. Siga as instruções na tela para transferir o arquivo de informações de autorização e baixar o arquivo de autorização .ecp.
   • Envie o arquivo de informações de autorização por e-mail para [e-mail]. A Esri enviará um arquivo de autorização .ecp de volta para você por e-mail.
3. Quando você receber o arquivo de autorização .ecp usando um dos métodos acima, execute o script authorizeSoftware novamente para processá-lo e concluir o processo de autorização do servidor:

   <System disk drive>\Program Files\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /F <full path to the .ecp file>

Repita este fluxo de trabalho para cada máquina em execução no ArcGIS Notebook Server.

Etapas após a atualização

Antes que o site do ArcGIS Notebook Server atualizado e reautorizado possa ser usado, você deve executar o utilitário postinstallation para adicionar suas novas imagens de contêiner do Docker ao site. Você também deve substituir as instâncias do ArcGIS Web Adaptor registradas em seu site para corresponder à nova versão.

Execute o utilitário de pós-instalação

Para executar o utilitário de pós-instalação, conclua as seguintes etapas:

1. Abra a janela de comando como um administrador.
2. Altere os diretórios para a pasta de ferramentas do ArcGIS Notebook Server. Por padrão, este caminho é C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.
3. Opcionalmente, consulte a ajuda do utilitário executando o seguinte comando: PostInstallUtility.bat -h
4. O ArcGIS Notebook Server requer que Docker Engine Community Edition seja instalado em sua máquina. Determina se Docker está ativo em sua máquina executando o comando seguinte: PostInstallUtility.bat -d
5. Se Docker Desktop não estiver instalado, instale-o agora.

   O ArcGIS Notebook Server utiliza contêiners do Linux no Docker Desktop. Ao instalar o Docker Desktop, certifique-se de especificar os contêineres do Linux e não clique na opção Alternar para contêiners do Windows.

6. Ao usar Docker Desktop, modifique cada uma das seguintes configurações:
   1. Clique com o botão direito do mouse no botão Docker na bandeja de sistema e clique em Configurações. Em Geral, verifique Expor daemon em tcp://localhost:2375 sem TLS.

      Você usará a API remota Docker, que requer o uso da porta 2375.

   2. Clique com o botão direito do mouse no botão Docker na bandeja de sistema e clique em Configurações. No menu Configurações, clique em Recursos > Compartilhamento de arquivos e adicione o diretório da unidade que será usado para o seu armazenamento de configuração do ArcGIS Notebook Server.

      Anotação:

      Docker for Windows suporta somente diretórios locais no Windows que devem ser compartilhados com ontêiners do Linux .

7. Instale sua imagem do Notebooks especificando o caminho do arquivo. A imagem deve ser compactada no formato .tar.gz. Se você tiver uma licença Advanced e Docker Desktop, execute o comando duas vezes para instalar as imagens de contêiner Standard e Advanced que você baixou do My Esri.

   Anotação:

   Certifique-se de que sua máquina tenha pelo menos 75 GB de espaço em disco disponível.

   Execute o comando seguinte: PostInstallUtility.bat -l <path of .tar.gz Docker image>

   Anotação:

   Certifique-se de instalar as duas imagens de contêiner. Mesmo se você tiver a licença Avançada, seus usuários ainda podem precisar usar o tempo de execução padrão.

Instalar e configurar dados de amostras do ArcGIS Notebook Server

Ao configurar um site do ArcGIS Notebook Server de múltiplas máquinas, você deve instalar e configurar os dados de amostra apenas na primeira máquina onde você instalou o Notebook Server e criou o site.

Para instalar e configurar os dados de amostras, siga estas etapas:

1. Execute o assistente de instalação dos dados de amostras do ArcGIS Notebook Server que você baixou do My Esri.

   Os dados de amostra são instalados no diretório onde ArcGIS Notebook Server estão instalados.

2. Abra a janela de comando como um administrador.
3. Altere os diretórios para a pasta de ferramentas do ArcGIS Notebook Server.

   Por padrão, este caminho é C:\Program Files\ArcGIS\NotebookServer\tools\postInstallUtility.

4. Opcionalmente, consulte a ajuda do utilitário executando o seguinte comando:

    > PostInstallUtility.bat -h

5. Execute o utilitário de pós-instalação para extrair os dados de amostras no diretório arcgisworkspace de site do servidor de notebook:

    PostInstallUtility.bat -x

Substituir instâncias do ArcGIS Web Adaptor

Para substituir instâncias do ArcGIS Web Adaptor, conclua as seguintes etapas:

1. Cancele o registro da instância anterior do ArcGIS Web Adaptor a partir do site e desinstale.
   1. Registre no seu Administrator Directory em ArcGIS Notebook Server.
   2. Vá até Sistema > Web Adaptors > máquina registrada.
   3. Clique em Cancelar Registro do Web Adaptor.
2. Instale uma nova instância do ArcGIS Web Adaptor 11.1 e configurá-lo com ArcGIS Notebook Server.
Depois que a atualização da implantação for concluída, você poderá usar a funcionalidade 11.1 .
3. Se estiver atualizando da versão 10.8 ou anterior, para permitir o agendamento de notebooks em seu portal, faça o seguinte:
   1. Opcionalmente, atualize qualquer um dos seus papéis personalizados que incluem privilégios de notebook para adicionar o novo privilégio Agendar Notebooks.
   2. Instrua os autores de notebook aatualizarem o tempo de execução de cada um de seus notebooks se desejarem o uso do recurso de agendamento.

      Somente notebooks usando o tempo de execução 10.8.1 (versão 4.0) ou posterior podem ser agendados.

Seu site do ArcGIS Notebook Server 11.1 está agora pronto para hospedar ArcGIS Notebooks.