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.8.1, você também deve atualizar oArcGIS Notebook Server.
O pacote de instalação do ArcGIS Notebook Server10.8.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 para10.8.1.
Durante o processo de atualização, você deve reautorizar seu software ArcGIS Notebook Server para 10.8.1 se você atualizou de 10.7.1 ou anterior. Você não precisa reautorizar seu software se estiver atualizando de 10.8 para 10.8.1.
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.8.1 . 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.8.1, eles deverão atualizar o tempo de execução dos seus notebooks. Os tempos de execução do notebook correspondentes a 10.8.1 estão na versão 4.0 (ArcGIS Notebook Server Standard 4.0 e ArcGIS Notebook Server Advanced 4.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.8.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 10.8.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 10.8.1.
- Para ArcGIS Notebook Server funcionar corretamente, sua versão deve corresponder à versão do portal ao qual está federado.
- Para atualizar sua implantação do ArcGIS Enterprise, faça o seguinte:
- Atualize o Portal for ArcGIS.
- Atualize o ArcGIS Web Adaptor (para Portal).
- Atualize o site do ArcGIS Server servindo como o servidor de hospedagem do portal.
- Atualize oArcGIS Web Adaptor (para Server).
- Atualize o ArcGIS Data Store (atualize primeiro o primária então, o auxiliar)
- Atualize quaisquer outros servidores, incluindoArcGIS Notebook Server.
- Não desinstale a configuração existente do ArcGIS Notebook Server. ArcGIS Notebook Server e os instaladores de linha de comando são projetados para detectar 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 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:
- 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.
- Vá até o site > Exportar Site.
- 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.
- 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. 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:
É recomendado que você utilize o arquivo de instalação para atualizar o ArcGIS Notebook Server para 10.8.1. Se as restrições organizacionais impedirem você de utilizar o arquivo de instalação, você poderá solicitar a operação Atualizar Site no ArcGIS Notebook Server Administrator Directory usando um script.
Se você tiver um site de múltiplas máquinas, siga as etapas 1 a 5 para uma máquina e repita estas etapas para cada máquina do site.
- Durante a instalação, leia o acordo de licença e o aceite, ou saia se você não concordar com os termos.
O programa de instalação exibe o recurso que será instalado e o espaço livre em disco necessário no disco rígido.
- Na próxima caixa de diálogo, especifique as credenciais de login da conta ou forneça um arquivo de configuração.
A conta do ArcGIS Notebook Server utilizada por sua instalação existente é pré-preenchida na caixa Conta do ArcGIS Server . Forneça a senha da conta do ArcGIS Notebook Server. Normalmente, esta é a senha que você definiu ao instalar o software.
Se a senha não for validada com sucesso, uma mensagem de erro aparecerá indicando que a senha é inválida. Se você não tiver certeza da senha para conta do ArcGIS Notebook Server , entre em contato com seu administrador do sistema ou redefina sua senha utilizando o ArcGIS Notebook Server Administrator Directory.
Se você fornecer um arquivo de configuração, as credenciais no arquivo de configuração do servidor deverão ser as mesmas credenciais usadas por seu site do ArcGIS Notebook Server .
- Se você selecionou Especificar o nome e senha da conta e digitou manualmente as informações de conta do ArcGIS Notebook Server, você poderá exportar um arquivo de configuração do servidor na caixa de diálogo que aparece. Se você não desejar a exportação de um arquivo de configuração, clique em Avançar e aceite a opção padrão Não exportar arquivo de configuração. Se você desejar a exportação de um arquivo de configuração do servidor para instalações futuras, selecione Exportar arquivo de configuração, navegue até uma pasta segura e forneça um nome para o arquivo de configuração.
Anotação:
Talvez queira exportar um arquivo de configuração do servidor se precisar fazer o seguinte:
- Criar a mesma conta do ArcGIS Notebook Server ao instalar em múltiplas máquinas.
- Armazenar a conta para uso ao atualizar para uma versão mais nova.
- Executar uma instalação silenciosa em que o nome de usuário e senha estão codificados.
Aviso:
Ao exportar um arquivo de configuração do servidor para compartilhar na rede, a conta do Sistema Local na máquina onde o ArcGIS Notebook Server está sendo instalado deverá ter permissões de escrita na rede compartilhada. Se as permissões não forem configuradas, o arquivo de configuração do servidor poderá não exportar com sucesso. Se você não tiver certeza de como configurar corretamente as permissões de compartilhamento da rede, entre em contato com o administrador do sistema ou exporte o arquivo de configuração do servidor localmente, então copie no compartilhamento da rede.
- Para completar a instalação, siga as direções na tela.
- Após completar a instalação, o assistente de configuração abrirá em um navegador. Siga as instruções fornecidas no assistente de configuração para concluir o processo de atualização.
- Se você tiver um site com múltiplas máquinas, siga as etapas de 1 a 5 para o restante das máquinas do seu site. Se você tiver um site com uma única máquina e planeja atualizar para um site com múltiplas máquinas, agora você podejuntar as máquinas adicionais ao site. Você deve também modificar os caminhos dediretórios do servidor e do armazenamento de configuração para usar locais compartilhados acessíveis à cada máquina.
Atualizar a partir da linha de comando
Você também pode atualizar o ArcGIS Notebook Server a patir da linha de comando usando o utilitário upgradesite começando na versão 10.8.
Este utilitário tem somente 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 -sO utilitário exibirá relatórios de progresso e encerrará quando a atualização for concluída. Se você tiver múltiplas máquinas em seu site, repita este comando em cada máquina 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 10.8.1se você atualizou de 10.7.1 ou anterior. Você não precisa reautorizar seu software se estiver atualizando de 10.8 para 10.8.1.
Execute a autorização do software com a seguinte sintaxe para autorizar ArcGIS Notebook Server silenciosamente:<ArcGIS Notebook Server install directory>/tools/authorizeSoftware<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.
- 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> - 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 authorize@esri.com. A Esri enviará seu arquivo de autorização .ecp de volta para você por e-mail.
- 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 de pós-instalação 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.
- 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. > ./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. - Cancele o registro da instância anterior do ArcGIS Web Adaptor a partir do site e desinstale.
- Entre no ArcGIS Notebook Server Administrator Directory.
- Navegue até Sistema > Web Adaptors > máquina registrada.
- Clique em Cancelar Registro do Web Adaptor.
- Instale uma nova instância do ArcGIS Web Adaptor 10.8.1 e registre-a com ArcGIS Notebook Server.
- Após a atualização da implantação ser concluída, você poderá aproveitar as vantagens da funcionalidade do 10.8.1 . Para habilitar 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) podem ser agendados.
Seu site do ArcGIS Notebook Server 10.8.1 está agora pronto para hospedar o ArcGIS Notebooks.