Atualizar ArcGIS Notebook Server

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 do ArcGIS Notebooks. Se você estiver atualizando sua implantação do ArcGIS Enterprise para 10.9, você também deve atualizar oArcGIS Notebook Server.

O pacote de instalação do ArcGIS Notebook Server10.9 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 para10.9.

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

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

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

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

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 10.9.
• Para ArcGIS Notebook Server funcionar corretamente, sua versão deve corresponder à versão do portal ao qual está federado.
• Atualize o Docker para uma versão suportada.
• 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 afeta adversamente o ArcGIS Notebooks existente hospedados pelo portal.
• Você pode atualizar o ArcGIS Notebook Server usando o instalador de configuração ou da 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.

Realize as seguintes etapas para executar a operação da 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.
5. 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. 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 10.9. 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.

1. O ArcGIS Notebook Server é projetado para descobrir e atualizar uma instalação existente de componentes do ArcGIS Notebook Server. 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 configuração identificará a instalação existente e será solicitado que você confirme 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 o utilitário de atualização for concluído, você deve reautorizar seu software ArcGIS Notebook Server para 10.9. 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

1. Para iniciar a atualização, execute o comando de configuração do servidor Notebook com o argumento mostrado no exemplo abaixo. Isto desinstalará a versão anterior do ArcGIS Notebook Server e instalará a versão atualizada do ArcGIS Notebook Server. Certifique-se de utilizar a mesma conta do ArcGIS Notebook Server utilizada por sua instalação existente.

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

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 exibirá relatórios de progresso e encerrará quando a atualização for 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 site com várias máquinas, repita as etapas 1 e 2 para cada máquina no site e continue com as etapas na 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 10.9 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\Common Files\ArcGIS\bin\SoftwareAuthorization.exe /S /Ver 10.7 /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 será gerado para você enviar à 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:
   • Navegue até o site da web da Esri Customer Service em https://service.esri.com/drm. Siga as instruções na tela para trasnferir o arquivo de informações de autorização e fazer download do arquivo de autorização .ecp.
   • Envie seu arquivo de informações de autorização por e-mail para [e-mail]. A Esri enviará seu arquivo de autorização .ecp de volta para você por e-mail.
3. Quando você receber seu 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 postinstallation

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 não estiver instalado, instale-o agora.

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

6. Modifique cada uma das configurações seguintes no Docker:
   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 do sistema e clique em Unidades compartilhadas. Escolha a unidade que será usada para seu armazenamento de configuração do ArcGIS Notebook Server.
      O contêiner Docker precisa acessar sua unidade local.

      Anotação:

      Sempre que as credenciais da sua conta Executar como forem alteradas, você precisará repetir esta etapa.

7. Instale sua imagem Docker especificando o caminho do arquivo. A imagem deve ser compactada no formato .tar.gz. Se você tiver uma licença Avançada, execute o comando duas vezes para instalar as imagens de contêiner Standard e Advanced que você baixou de My Esri. 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 amostras serão instalados no diretório onde ArcGIS Notebook Server está instalado.

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

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. Navegue 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 10.9 e registre-a com ArcGIS Notebook Server.
3. Após a atualização da implantação ser concluída, você poderá aproveitar as vantagens da funcionalidade do 10.9 . Se estiver atualizando da versão 10.8 ou anterior, para permitir o agendamento de notebooks em seu portal, faça o seguinte:

   • Atualize quaisquer dos seus papéis personalizados que incluam privilégios de notebook para adicionar o novo privilégio Agendar Notebooks , se desejado.
   • 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 10.9 está agora pronto para hospedar ArcGIS Notebooks.