Resumo
Este artigo percorre o processo de atualização para ArcGIS Enterprise 11.x, com etapas detalhadas sobre o que precisa ser verificado antes da atualização, feito durante a atualização e verificado após a atualização.
Note:
The upgrade process can be time-consuming, and if not done correctly, many things can go wrong. The steps outlined here can save a significant amount of time and make the process more efficient.
Procedimento
Ao planejar uma atualização, lembre-se de que não é recomendável atualizar diretamente de versões com mais de duas versões de diferença. Por exemplo, você não pode atualizar diretamente do ArcGIS Enterprise 10.6.1 ou anterior para a versão 11.0. Você deve primeiro atualizar para uma versão provisória (10.7.x para 10.9.x) e, em seguida, atualizar para 11.0. Antes de atualizar, verifique a documentação de atualização da versão provisória para confirmar se as atualizações diretas são suportadas para a versão inicial do ArcGIS Enterprise.
Prepare-se para a atualização
Antes de iniciar o processo de atualização:
- Verifique se há alguma consideração antes de atualizar para a versão desejada, consulte: Considerações de atualização do ArcGIS Enterprise 10.9.1 e anterior
- Verifique se há avisos de descontinuação: Avisos de descontinuação, por exemplo:
- Fim do suporte para fluxos de trabalho baseados em ArcMap Nesta versão, os fluxos de trabalho baseados em ArcMap não são mais suportados no ArcGIS Enterprise. O software 11.0 e as versões subsequentes incluem o tempo de execução baseado no ArcGIS Pro, mas não incluem o tempo de execução baseado no ArcMap. Consulte: Saiba mais sobre suas opções para migrar serviços para o tempo de execução do ArcGIS Pro.
- Se você publicou aplicativos com base em modelos do ArcGIS Configurable Apps, verifique se o modelo de aplicativo foi desativado.Os modelos de aplicativo configuráveis retirados não funcionarão após você atualizar seu portal para 11.x. Você precisará recriar estes aplicativos utilizando ArcGIS Instant Apps, ArcGIS StoryMaps, ArcGIS Experience Builder, ArcGIS Web AppBuilder ou ArcGIS Dashboards. Observe que se o seu portal tiver várias versões, verifique os modelos retirados para cada versão em seus respectivos tópicos O que há de novo no portal. Por exemplo, se você estiver atualizando do Portal for ArcGIS 10.7, verifique a lista de modelos retirados para todas as versões entre 10.7 e a versão atual.
- Verifique os requisitos do sistema para a(s) máquina(s) que hospeda os produtos ArcGIS Enterprise e certifique-se de que ela atenda aos requisitos mínimos.A partir disso, uma lista das recomendações pode ser feita, como aumentar a CPU, espaço em disco, etc., antes de iniciar o processo de atualização. Consulte: Requisitos de Sistema do ArcGIS Enterprise 11.3
- Lembre-se de que a quantidade de espaço livre disponível no disco deve ser pelo menos 2,5 vezes a quantidade de espaço nos diretórios. Caso contrário, aloque pelo menos 2,5 vezes mais espaço no disco. A atualização deve ter este espaço livre para efetuar a cópia de segurança e atualizar com sucesso o conteúdo do portal, informações do site e configurações de segurança.
- O ArcGIS Web Adaptor (IIS) requer um mínimo de 8 GB de memória, com mais potencialmente necessário dependendo do número de instâncias do ArcGIS Web Adaptor instaladas e do número e tamanho das solicitações recebidas.
- Verifique o tipo e a versão dos bancos de dados usados e registrados (como SQL Server, Oracle, etc.) quanto à compatibilidade. Se não for compatível, atualize-o antes de atualizar o ArcGIS Enterprise. Consulte: Bancos de dados com suporte
- Verifique as permissões na implantação Enterprise. A conta de serviço do Windows que executa os serviços em todos os computadores deve ser a mesma conta administrativa do Active Directory no nível do domínio. A conta deve ter uma senha estática. Adicione permissões explicitamente às pastas a seguir para controle total. Isso deve incluir privilégios de leitura e gravação. A unidade listada aqui deve ser alterada com base na unidade usada, geralmente seria a unidade C, mas nem sempre é esse o caso.
- Verifique as permissões na máquina do ArcGIS Server:
- Verifique C:\arcgisserver
- Verifique C:\Program Files\ArcGIS
- Verifique C:\Python 27
- Verifique as permissões no Portal for ArcGIS Machine:
- Verifique C:\arcgisportal
- Verifique C:\Program Files\ArcGIS
- Verifique as permissões no ArcGIS Data Store Machine:
- Verifique C:\arcgisdatastore
- Verifique C:\Program Files\ArcGIS
- Baixe a versão desejada do Portal for ArcGIS, ArcGIS Server, ArcGIS Data Store e ArcGIS Web Adaptor, como também, o licenciamento associado, do site da web My Esri.
- Vá até a interface do portaladmin: https://domain.com/webadaptor name/portaladmin
- Se o seu portal estiver atualmente no modo somente leitura, desative o modo antes de executar a atualização.
- No Diretório do Administrador do Portal, em Página Inicial > Modo> Atualizar, defina Somente Leitura como false.
Note:
Unlike the portal, if your ArcGIS Server site is in read-only mode, the site mode will be set to editable when you upgrade. After all machines in your site have been successfully upgraded, the site will remain in editable mode. You can switch back to read-only mode once your upgrade is complete.
Verificar o status do indexador
- No diretório do administrador do portal, em Página Inicial > Sistema > Indexador > Status:
- Verifique o status do índice e certifique-se de que os valores do índice estejam alinhados.Se eles estiverem fora de sincronia, indexe novamente.
- Faça um instantâneo de todas as máquinas envolvidas como medida de precaução.
- Valide federação e armazenamentos de dados. Consulte: Validar Servidores e Instrução: Validar ArcGIS Data Store
- Anote os nomes dos adaptadores da web, pois você deve usar exatamente os mesmos nomes ao reinstalar
- Anote o contexto da web atribuído (se houver) para o portal e o servidor.
- Criar cópia de segurança da implantação utilizando.
- O utilitário webgisdr do Portal. Consulte: Utilizar o utilitário webgisdr -Exportar ArcGIS Enterprise
- O utilitário de cópia de segurança do ArcGIS Server: Utilitário de cópia de segurança
- Execute o utilitário backupdatastore para criar uma cópia de segurança de cada armazenamento de dados-backupdatastore
- Faça uma cópia de segurança da pasta do diretório de conteúdo do arcgisportal e quaisquer extensões que você adicionou para Dashboards e Web AppBuilder. Adicionalmente
- Faça uma cópia de segurança da opção do portal avançado de implantação atual copiando o script JSON no ArcGIS Portal Directory. Consulte a Etapa 1 a 3 no Portal for ArcGIS: Definir opções avançadas do portal para obter instruções para acessar o script JSON. O script JSON copiado pode ser colado na nova implantação utilizando a função de atualização no ArcGIS Portal Directory.
- Se possível, pare o antivírus durante o processo de atualização.
Alguns outros pontos a serem considerados (se aplicável):
Inicie o processo de atualização
Note:
Please keep in mind that your deployment (Portal, any ArcGIS Server site you federated with your portal, ArcGIS Data Store, and ArcGIS Pro (if licensed through the portal) will be offline (down) during the upgrade.
Não se esqueça de:
- Verifique as permissões em todos os diretórios.
- Crie um instantâneo de todas as máquinas envolvidas como medida de precaução.
- Anote os nomes dos adaptadores da web (pois a instalação dos adaptadores da web deve ter os mesmos nomes).
- Anote o contexto da web atribuído (se houver) para o portal e o servidor (já que às vezes, após a atualização, eles podem ser perdidos, portanto, é bom crair cópias de segurança deles para reconfigurá-los).
Se for uma implantação de várias máquinas, liste os nomes das máquinas apenas para estar ciente delas durante a atualização: Atualizar seu portal do ArcGIS Enterprise
- Atualizar o Portal for ArcGIS Atualizar o Portal for ArcGIS
- Esteja ciente de que se você atualizar de uma implantação do Portal for ArcGIS 10.8.1 ou 10.9 que tenha o Map Viewer Beta instalado, o Map Viewer Beta será excluído automaticamente.
Juntamente com o Map Viewer Classic, o 11.x também possui o novo Map Viewer (anteriormente conhecido como Map Viewer Beta). - A quantidade de material que seu portal tem, o número de contas registradas, o número de componentes e personalizações que você implanta e o desempenho da máquina que hospeda o portal afetam o tempo necessário para concluir a atualização. Às vezes, leva até três horas para ser concluído.
- Limpe o cache do navegador, incluindo os cookies. Com base na documentação, as informações deixadas no cache da versão anterior do site podem fazer com que o site atualizado seja exibido incorretamente e você pode não conseguir efetuar o login. Recomenda-se limpar o cache (incluindo cookies) em todos os navegadores que visualizarão o site do portal atualizado.
- Execute o arquivo de instalação do Portal (Setup.exe) como administrador e não interrompa o processo de instalação.
- Se for um portal altamente disponível, atualize as máquinas primárias e em espera antes de executar a próxima etapa.
- Depois que a instalação for concluída, uma página de arquivo de licença de importação será iniciada no navegador. Tenha o arquivo de licença (.json) à mão, conforme necessário.
- Clique em Continuar Atualização do Portal. Isto inicia a atualização e cria uma cópia de segurança do conteúdo de seu portal, informações do site e configurações de segurança.
- Desinstale o adaptador da web do portal existente.
- Instale o adaptador web do novo portal com o mesmo nome de antes (a versão para a qual está sendo atualizado).
- Configure o adaptador da web do portal. Para instruções completas, consulte o tópico de configuração do IIS ou Java (Windows). Lembre-se de que, se você tiver algum DNS e ele não estiver listado nas propriedades do sistema, você deve acessar a página de configuração do adaptador da web usando-o.
- Depois de concluído, verifique se você pode efetuar login no portal pela URL do web adaptador, por exemplo, https://webadaptorhost.domain.com/webadaptorname/home
- Se você receber um aviso de que etapas de pós-atualização são necessárias, clique em OK na caixa de diálogo da mensagem para concluir as etapas de pós-atualização necessárias. Isso inclui atualizar o conteúdo do ArcGIS Living Atlas of the World, reindexar o conteúdo e atualizar a associação entre máquinas do portal em um portal de alta disponibilidade.
- Atualize o ArcGIS Server servindo como servidor de hospedagem do portal. Atualizar o ArcGIS Server
- Limpe o cache do navegador (incluindo cookies).
- Não desfedere nenhum servidor federado com um portal ao atualizar sua implantação. Isso afeta negativamente a implantação do portal, pois os usuários não poderão acessar, compartilhar ou usar os serviços do ArcGIS Server no portal.
- Execute o arquivo de instalação do servidor (.exe) como administrador. Um arquivo de licença é necessário após esta etapa.
- Após a instalação ser concluída, o assistente de autorização de software aparece, solicitando a reautorização do ArcGIS Server com um novo arquivo de licença.
- Depois de autorizado, no navegador, inicie uma página 'Continuar a atualização'.
- Desinstale o adaptador da web do servidor existente. Se for um site de servidor de várias máquinas, isso deverá ser feito após a conclusão da atualização de todas as máquinas ingressadas no site.
- Instale o novo adaptador da web do servidor com o mesmo nome de antes.
- Configure o adaptador da web do servidor.Para obter instruções completas, consulte o tópico de instalação do IIS ou Java (Windows).
- Valide se a interface do ArcGIS Server Manager está acessível através do adaptador da web e que você pode entrar utilizando credenciais do portal. Ao efetuar login no Gerenciador do Servidor pelo adaptador da web, você deverá ver o redirecionamento OAuth do portal indicando que a federação foi mantida durante a atualização.
- Atualize o ArcGIS Data Store, consulte: Atualizar ArcGIS Data Store
- Limpe o cache do navegador (incluindo cookies).
- Execute o arquivo de instalação do Data Store (.exe) como administrador.
- Continue a atualização no navegador.
- Depois de concluído, verifique se o Data Store é validado com êxito no Gerenciador do Servidor.
- Atualize quaisquer sites adicionais do ArcGIS Server, se houver quaisquer outros servidores federados, como um servidor de imagem. Repita o processo de atualização para cada site adicional.
- Limpe o cache do navegador (incluindo cookies).
- Execute o arquivo de instalação do servidor (.exe) como administrador. Um arquivo de licença será necessário após esta etapa.
- Continue a atualização no navegador.
- Desinstale o web adaptor do servidor existente (para a versão anterior) Se for um site de servidor de múltiplas máquinas, isso será feito após a conclusão do upgrade de todas as máquinas ingressadas no site.
- Instale o web adaptor do novo servidor com o mesmo nome de antes.
- Configure o adaptador da web do servidor.
- Valide se o gerenciador do ArcGIS Server está acessível através do web adaptor e que você pode entrar utilizando credenciais do portal. Ao efetuar login no Gerenciador do Servidor pelo adaptador da web, você deverá ver o redirecionamento OAuth do portal indicando que a federação foi mantida durante a atualização.
- Depois que todos os aplicativos forem atualizados com sucesso
- Navegue até a página inicial do Portal.
- Valide o ArcGIS Server no Portal for ArcGIS para certificar-se de que tudo foi validado com sucesso.
- Navegue até a interface de administração do portal:
- Verifique o status do índice, se estiver fora de sincronia, reindexe
- Vá até o ArcGIS Server Manager:
- Validar todos os armazenamentos de dados
- Restaure todas as personalizações do portal criadas anteriormente. Ao restaurar as personalizações do seu portal, não substitua os arquivos modificados na versão anterior. Isso tem um efeito adverso em sua implantação. Você deve adicionar manualmente seu comportamento personalizado da versão anterior em cada arquivo.
- É recomendado que você utilize os scripts serverScan.py e portalScan.py para revisar as melhores práticas de segurança com seu portal do ArcGIS Server e ArcGIS Enterprise após a atualização.
- Após atualizar, revise cuidadosamente as seguintes informações: Considerações após atualizar o Portal for ArcGIS
- Se você utilizou o ArcGIS Enterprise Builder para configurar uma implantação base do ArcGIS Enterprise em uma única máquina:
- Revise e conclua as etapas nos pré-requisitos.
- Como administrador, execute o arquivo de instalação do ArcGIS Enterprise Builder (.exe) da versão desejada para instalar componentes.
- Use o assistente de configuração ou outilitário de linha de comando u pgradebasedeployment para executar a atualização.
- Conclua as etapas pós-atualização.