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 .

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 ./Setup a partir da localização onde ArcGIS Notebook Server foi extraído, com o argumento mostrado no exemplo abaixo e siga os avisos para concluir a atualização. Isto desinstalará a versão anterior do ArcGIS Notebook Server e instalará a versão atualizada do ArcGIS Notebook Server.

   <untar directory>/Setup -l yes -m silent

2. Após o utilitário de atualização for concluído, você deve reautorizar seu software ArcGIS Notebook Server para 10.9. Execute a autorização do software com a seguinte sintaxe para autorizar ArcGIS Notebook Server silenciosamente:

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware

   Execute o seguinte comando para visualizar todas as opções de autorização:

   <ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

   Anotação:

   Consulte a seção Autorizar em um ambiente desconectado para obter informações sobre como autorizar a instalação do Notebook Server em um ambiente desconectado.

3. Atualize o site utilizando o utilitário de linha de comandos upgradesite. Este 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.

   Por padrão, o utilitário upgradesite é encontrado em ${HOME}/arcgis/notebookserver/tools/upgradesiteutility/upgradesite.sh.

   Antes de atualizar, revise as informações de preparação no início deste tópico. Quando você estiver pronto para atualizar, abra um terminal de comando na máquina que você está atualizando. Navegue até o diretório onde o utilitário está localizado e execute o seguinte comando:

   > ./upgradesite.sh -s

   O utilitário exibirá relatórios de progresso e encerrará quando a atualização for concluída.

4. Para um site com várias máquinas, siga as etapas de 1 a 3 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 a autorização do software com a seguinte sintaxe para autorizar ArcGIS Notebook Server silenciosamente:

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware

Execute o seguinte comando para visualizar todas as opções de autorização:

<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --help

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 :

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -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:

   <ArcGIS Notebook Server installation directory>/tools/authorizeSoftware -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 um terminal usando a conta de instalação do ArcGIS Notebook Server.
2. Altere os diretórios para a pasta de ferramentas do ArcGIS Notebook Server. Por padrão, este caminho é ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
3. Opcionalmente, consulte a ajuda do utilitário executando o seguinte comando: > ./PostInstallUtility.sh -h
4. O ArcGIS Notebook Server requer que Docker Engine seja instalado em sua máquina. Determina se Docker está ativo em sua máquina executando o comando seguinte: ./PostInstallUtility.sh -d
5. Se Docker não estiver instalado, instale-o agora.
6. 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. Executar o comando seguinte: > ./PostInstallUtility.sh -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.

Siga estas etapas para instalar dados de amostras do ArcGIS Notebook Server

1. Abra um shell de comando como o usuário que irá executar o ArcGIS Notebook Server. Navegue até o diretório onde você baixou o arquivo tar.gz dos dados de amostras do ArcGIS Notebook Server a partir do My Esri.
2. Descompacte o arquivo tar.gz com o seguinte comando:

   tar -xvzf ArcGIS_Notebook_Server_Samples_Data_Linux_.tar.gz

3. Procure por <install directory>/notebookserver/License para ler o contrato de licença.
4. Do diretório, execute o script.

   ./ArcGISNotebookServerSamplesData-Setup.sh

5. Altere os diretórios para a pasta de ferramentas do ArcGIS Notebook Server.

   Por padrão, este caminho é ${HOME}/arcgis/notebookserver/tools/postInstallUtility.

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

   > ./PostInstallUtility.sh -h

7. Execute o utilitário de pós-instalação para extrair os dados de amostras no diretório arcgisworkspace de site doNotebook Server .

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