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.2, você também deve atualizar oArcGIS Notebook Server.
O pacote de instalação do ArcGIS Notebook Server11.2 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.2.
Durante o processo de atualização, você deve reautorizar o software ArcGIS Notebook Server para 11.2 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.2. 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.2, eles deverão atualizar o tempo de execução dos seus notebooks. Os tempos de execução do notebook correspondentes à versão 11.2 estão na versão 9.0 (ArcGIS Notebook Server Standard 9.0 e ArcGIS Notebook Server Advanced 9.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.2.
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.2.
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.2.
- Para ArcGIS Notebook Server funcionar corretamente, sua versão deve corresponder à versão do portal ao qual está federado.
- Se o seu servidor de Notebook estiver atualmente no modo de somente leitura, desative o modo antes de iniciar o processo de atualização.
- Atualize o Docker para a versão 23.0 ou posterior.
- 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).
- Atualizar ArcGIS Data Store (atualize primeiro a primária então, a auxiliar).
- Atualize quaisquer outros servidores, incluindoArcGIS Notebook Server.
- 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 .
Mova o diretório da sua área de trabalho
Este processo é necessário para implantações em uma única máquina do ArcGIS Notebook Server no Linux que possuem um diretório da área de trabalho localizado dentro do diretório de instalação do servidor do notebook.
- Entre no seu portal do ArcGIS Enterprise como um administrador e abra o ArcGIS Notebook Server Manager.
- Clique na guia Configurações.
- Clique em Diretórios.
- Verifique se o caminho atual para o diretório arcgisworkspace está dentro do diretório de instalação do ArcGIS Notebook Server.
<installdir>/arcgis/notebook/directories/arcgisworkspace
Se o diretório arcgisworkspace estiver dentro do diretório de instalação do ArcGIS Notebook Server, você deve mover o diretório da área de trabalho para um local fora do diretório de instalação antes de poder atualizar.
Se o diretório arcgisworkspace não estiver dentro do diretório de instalação do ArcGIS Notebook Server, você não precisa executar as etapas restantes desta seção.
- Clique em Editar para o diretório arcgisworkspace.
- Substitua o valor do caminho do diretório existente pelo novo caminho do diretório arcgisworkspace que está fora do diretório de instalação.
<installdir>/arcgis/arcgisnotebookserver/directories/arcgisworkspace
- Clique em Salvar.
- Copie manualmente todo o conteúdo dentro do diretório anterior arcgisworkspace para o novo diretório arcgisworkspace.
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.
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.
- 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:
Utilize o arquivo de configuração para atualizar ArcGIS Notebook Server para 11.2. 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.
- 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.
- Após a conclusão do utilitário de atualização, autorize novamente o software ArcGIS Notebook Server para 11.2. Use o assistente de autorização de software para concluir a autorização.
- 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.
- 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:
- 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.
Isso desinstala a versão anterior do ArcGIS Notebook Server e instala a versão atualizada do ArcGIS Notebook Server.
<untar directory>/Setup -l yes -m silent - Após a conclusão do utilitário de atualização, autorize novamente o software ArcGIS Notebook Server para 11.2. Execute a autorização do software com a seguinte sintaxe para autorizar ArcGIS Notebook Server silenciosamente:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftwareExecute o seguinte comando para visualizar todas as opções de autorização:
<ArcGIS Notebook Server install directory>/tools/authorizeSoftware --helpAnotação:
Veja a seção Autorizar em um ambiente desconectado para obter informações sobre autorização ArcGIS Notebook Server, é instalado em um ambiente desconectado. - 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 -sO utilitário exibe relatórios de progresso e para quando a atualização é concluída.
- Para um site com vários computadores, siga as etapas de 1 a 3 para cada máquina do site e continue com as etapas da próxima seção.
Autorizar silenciosamente
Após a conclusão do utilitário de atualização, você deverá reautorizar o software ArcGIS Notebook Server para 11.2.
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 é gerado para você enviar para 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:
- Vá até o site de autoatendimento da Esri . 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 authorize@esri.com. A Esri enviará um arquivo de autorização .ecp de volta para você por e-mail.
- 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:
<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 de pós-instalação
Para executar o utilitário de pós-instalação, conclua as seguintes etapas:
- Abra um terminal usando a conta de instalação do ArcGIS Notebook Server.
- Altere os diretórios para a pasta de ferramentas do ArcGIS Notebook Server. Por padrão, este caminho é ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
- Opcionalmente, consulte a ajuda do utilitário executando o seguinte comando: ./PostInstallUtility.sh -h
- 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
- Se Docker Desktop não estiver instalado, instale-o agora.
- 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.
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
- Abra um shell de comando como o usuário que irá executar o ArcGIS Notebook Server. Vá até o diretório onde você baixou o arquivo dos dados de amostras do ArcGIS Notebook Server tar.gz a partir do My Esri.
- Descompacte o arquivo tar.gz com o seguinte comando:
tar -xvzf ArcGIS_Notebook_Server_Samples_Data_Linux_.tar.gz - Procure por <install directory>/notebookserver/License para ler o contrato de licença.
- Do diretório, execute o script.
./ArcGISNotebookServerSamplesData-Setup.sh - Altere os diretórios para a pasta de ferramentas do ArcGIS Notebook Server.
Por padrão, este caminho é ${HOME}/arcgis/notebookserver/tools/postInstallUtility.
- Opcionalmente, consulte a ajuda do utilitário executando o seguinte comando:
> ./PostInstallUtility.sh -h - 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
Para substituir instâncias do ArcGIS Web Adaptor, conclua as seguintes etapas:
- Cancele o registro da instância anterior do ArcGIS Web Adaptor a partir do site e desinstale.
- Registre no seu Administrator Directory em ArcGIS Notebook Server.
- Vá até Sistema > Web Adaptors > máquina registrada.
- Clique em Cancelar Registro do Web Adaptor.
- Instale uma nova instância do ArcGIS Web Adaptor 11.2 e configurá-lo com ArcGIS Notebook Server.
- Se estiver atualizando da versão 10.8 ou anterior, para permitir o agendamento de notebooks em seu portal, faça o seguinte:
- Opcionalmente, atualize qualquer um dos seus papéis personalizados que incluem privilégios de notebook para adicionar o novo privilégio Agendar Notebooks.
- 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.2 está agora pronto para hospedar ArcGIS Notebooks.