Skip To Content

Atualize seu portal do ArcGIS Enterprise

A instalação do Portal for ArcGIS 10.6.1 é projetada para detectar e atualizar uma instalação existente do Portal for ArcGIS.

Preparar para atualizar o Portal for ArcGIS

Antes de atualizar, revise cuidadosamente as informações seguintes.

  • Se você estiver atualizando para 10.6.1 a partir da versão 10.5.1 ou anterior, você precisará autorizar novamente seu software com um novo arquivo de autorização para 10.6.1. Você pode acessar seus novos arquivos de autorização em My Esri. Se você estiver atualizando a partir da versão 10.6, você não precisará autorizar novamente.
  • Executar a instalação do Portal for ArcGIS 10.6.1 atualizará automaticamente seu portal para 10.6.1. Não há necessidade de obter e instalar cada versão lançada previamente em sequência ou desinstalar sua versão anterior do Portal for ArcGIS.
  • Se você configurou um portal altamente disponível, há etapas específicas que você precisará seguir para completar a atualização. Estas etapas são apresentadas no tópico Configurando um portal altamente disponível.
    Anotação:

    Na versão 10.6, implantações altamente disponíveis utilizam as portas disponíveis 5701, 7005, 7099, 7654, 7120 e 7220 para comunicações entre máquinas. Você deve garantir que seu firewall permita a comunicação local nestas portas e que não estejam atualmente em uso por outro aplicativo.

  • Se você já configurou um geodatabase enterprise como o banco de dados gerenciado para o seu servidor de hospedagem e estiver atualizando para 10.6.1, você precisará realizar algumas etapas adicionais. Após atualizar o Servidor, você precisará registrar o geodatabase enterprise como um banco de dados (em oposição a um banco de dados gerenciado). Então, instale o ArcGIS Data Store e registre-o como um armazenamento de dados relacional. Isto configurará o ArcGIS Data Store como o banco de dados gerenciado do seu servidor de hospedagem.
  • O tempo que demora para completar a atualização varia dependendo da quantidade de conteúdo do seu portal e quantas contas estão registradas, como também quantos componentes e personalizações você desenvolve.
  • Se você publicou aplicativos baseado em modelos de aplicativo configuráveis, verifique para confirma que o modelo de aplicativo foi retirado. Os modelos de aplicativo configuráveis retirados podem não funcionar ou aparecer corretamente após você atualizar seu portal. Você precisará recriar estes aplicativos utilizando novos modelos de aplicativo. Note que se o seu portal for de várias versões antigas, você precisará verificar os modelo retirados de cada versão. Por exemplo, se você estiver atualizando do Portal for ArcGIS 10.5, verifique a lista de modelos retirados para todas as versões entre 10.5 e versão atual.
  • Se você tiver aplicativos da Esri configurados com seu portal, você precisará garantir que esteja em uma versão que seja compatível com o portal 10.6.1 após a atualização.
  • Se você configurou o Insights for ArcGIS, você deve desinstalar o Insights for ArcGIS antes de atualizar ArcGIS Enterprise. Após a atualização ser concluída, você precisará instalar uma versão compatível do Insights for ArcGIS.
  • Se você configurou pacotes de mapa móvel do Navigator for ArcGIS com o seu portal, você precisará reconfigurá-los após atualizar o portal para versão 10.6.1.

Ordem de atualização do ArcGIS Enterprise

Para seu portal do ArcGIS Enterprise funcionar, ele deve ser da mesma versão que seu servidor de hospedagem, Web Adaptor e Data Store. A ordem recomendada para atualizar seu desenvolvimento do ArcGIS Enterprise é a seguinte:

  1. Atualizar o Portal for ArcGIS
  2. Atualizar ArcGIS Web Adaptor (para Portal)
  3. Atualizar ArcGIS Server (atualizar primeiro o servidor de hospedagem e, em seguida, todos os outros servidores)
  4. Atualizar ArcGIS Web Adaptor (para Servidor)
  5. ArcGIS Data Store (atualizar primário primeiro e então auxiliar)
  • Sua versão de portal do ArcGIS Enterprise deve corresponder à versão do servidor de hospedagem, qualquer GeoAnalytics Server, qualquer GeoEvent Server, e qualquer Raster Analytics Server federado com ele. Entretanto, um portal 10.6 trabalhará com qualquer outro servidor federado que está na versão 10.5 ou posterior. Por exemplo, uma versão 10.5 GIS Server (que não é o servidor de hospedagem) e uma versão 10.5.1 Business Analyst Server pode ser federada com um portal 10.6, desde que seu servidor de hospedagem esteja na versão 10.6.
  • Se você registrou itens no seu portal a partir de um site do ArcGIS Server não federado, você não terá que atualizar o servidor para 10.6.1 para utilizar os serviços do site com seu portal. Os serviços de versões anteriores do ArcGIS Server podem ser consumidos pelo Portal for ArcGIS 10.6.1.
  • Se o site do ArcGIS Server que você federou com o portal incluir múltiplas máquinas, atualize seus servidores GIS consecutivamente. Se você tiver ArcGIS Web Adaptor (único ou múltiplo) configurado com seu site do ArcGIS Server , você também precisa atualizar os Web Adaptors para a mesma versão que o ArcGIS Server.
  • Se você não pode atualizar seu Web Adaptor atual, você pode instalar alternativamente uma versão 10.6.1 do ArcGIS Web Adaptor (IIS) ao lado de sua versão anterior na mesma máquina. Por exemplo, você pode reter sua versão 10.5 do ArcGIS Web Adaptor (IIS) e instalar 10.6.1 no mesmo servidor da web. Você deve manter o mesmo contexto do Web Adaptor ao atualizar. Para fazer isto, você desinstalará o Web Adaptor atualmente configurado com seu portal. Você então instalará o Web Adaptor 10.6.1 com o mesmo nome utilizado previamente. Note que dois Web Adaptors com o mesmo contexto não podem ser instalados na mesma máquina.

Crie uma cópia de segurança de seu conteúdo

Se você estiver utilizando o ArcGIS Data Store com o servidor de hospedagem do seu portal, crie uma cópia de segurança completa do armazenamento de dados antes de atualizar.

Você também precisará criar uma cópia de segurança de qualquer customização que você configurou para seu portal (como propriedades que você modificou em config.js).

Validado:

Anteriormente, você foi solicitado para criar uma cópia de segurança do keystore de certificado (portal.ks) contendo certificados que você importou no portal. Começando no 10.4.1, isto não é mais necessário e o keystore do portal será automaticamente migrado durante sua atualização.

  • Se você personalizou a versão anterior do seu portal, é recomendado que você instale o 10.6.1 em uma máquina separada e no protótipo de atualização do seu portal.
  • Extensões para Operations Dashboard ou Web AppBuilder também devem ter uma cópia de segurança. A atulização não preservará quaisquer extensões que você implantou para estes clientes. Após completar sua atualização, você deverá reimplantar suas extensões.
  • Reciprocamente, seu conteúdo, serviços, informações de site e configurações de segurança são todos automaticamente copiados por segurança e preservados na atualização. As configurações gerais que você editou pelo site da web do portal, como adicionar nome e logotipo da sua organização no site da web, são preservadas ao atualizar. Você não precisa gerar a cópia de segurança manualmente destas informações antes de atualizar.
  • Para garantir que você tem espaço em disco o suficiente para suportar a cópia de segurança automática durante a atualização, determine a quantidade de espaço alocado nos diretórios content, index, db e temp do portal. Valide que a quantidade de espaço livre disponível em disco seja pelo menos 2.5 vezes esta quantidade. Se não, aloque pelo menos 2.5 vezes mais espaço em disco. A atualização do portal precisará deste espaço livre para criar a cópia de segurança com sucesso e atualizar o conteúdo do seu portal, informações do site e configurações de segurança. O local padrão destes diretórios é <Portal for ArcGIS installation directory>/arcgisportal.
  • Quando a atualização completar, as informações da cópia de segurança serão retidas no disco. Você visualizará estas informações denotadas com _10.<version number> anexad no final do diretório. É recomendado que você mova estas informações para outro local para salvar espaço em disco.
  • Também é recomendado que você gere a cópia de segurança da pasta de diretório de conteúdo arcgisportal. Se a sua versão atualizada encontrar problemas e então for necessário reverter para sua versão instalada anteriormente, você poderá aplicar esta pasta para restaurar o conteúdo do seu portal.

Executar uma atualização da sua implantação do portal

Aviso:

A implantação do seu portal, qualquer site do ArcGIS Server que você federou com seu portal, ArcGIS Data Store (se utilizado) e ArcGIS Pro (se utilizado), ficarão offline durante a atualização.

  1. Crie cópia de segurança das seguintes informações:

    Dica:
    Você pode seguir as etapas abaixo para criar uma cópia de segurança do seu site manualmente ou você pode utilizar o utilitário webgisdr para criar uma cópia de segurança no seu desenvolvimento do ArcGIS Enterprise. Para fazer isso, siga as etapas para exportar ArcGIS Enterprise.

    • Qualquer personalização que você configurou para seu portal, tal como, as propriedades que você modificou em config.js. Se você personalizou a versão anterior do seu portal, é recomendado que você instale o 10.6.1 em uma máquina separada e no protótipo de atualização do seu portal.
    • O banco de dados gerenciado do ArcGIS Data Store. Consulte Atualizar ArcGIS Data Store para detalhes sobre executar a cópia de segurança.
    • Quaisquer extensões que você implantou para Operations Dashboard ou Web AppBuilder. Estas não serão preservadas na atualização e devem ser transferidas após completar a atualização.
    • Crie cópia de segurança do seu site do ArcGIS Server de forma que no caso onde você precisa reverter seu site para a versão antiga, você possa importar e restaurar o site.
  2. Determine a quantidade do espaço em disco alocado para os diretórios content, index, db e temp do portal. Valide que a quantidade de espaço livre disponível em disco seja pelo menos 2.5 vezes esta quantidade. Se não, aloque pelo menos 2.5 vezes mais espaço em disco. A atualização do portal precisará deste espaço livre para criar a cópia de segurança com sucesso e atualizar o conteúdo do seu portal, informações do site e configurações de segurança. O local padrão destes diretórios é <Portal for ArcGIS installation directory>/arcgisportal. Se o diretório de conteúdo residir em uma máquina diferente, a mesma recomendação se aplica.
    Anotação:

    Quando a atualização completar, as informações da cópia de segurança serão retidas no disco. Por exemplo, uma nova pasta denominada upgrade-backup é criada e contém pastas de versão específicas voltadas para o conteúdo. É recomendado que você mova estas informações para outro local para salvar espaço em disco.

  3. Entre na máquina hospedando o Web Adaptor que você está utilizando com seu portal e desinstale o ArcGIS Web Adaptor. Para instruções completas, consulte o tópico de desinstalação do IIS, Java (Windows) ou Java (Linux). Não deixe de notar o contexto do Web Adaptor antes de desinstalá-lo.
  4. A partir do comando, inicie o script de instalação do Portal for ArcGIS como o mesmo usuário que foi utilizado para instalar o portal existente (por exemplo, <CD ROOT or untar directory>/Setup). Você não precisa parar o Portal for ArcGIS antes de iniciar este script.
    Dica:

    Para iniciar o script de instalação do Portal for ArcGIS clique no script de instalação e selecione o botão Executar no Terminal.

  5. A instalação detectará sua versão existente do Portal for ArcGIS na máquina de destino e o avisará para continuar ou sair da atualização. Veja os seguintes exemplos:
    =========================================================================
    Portal for ArcGIS 10.6.1 (Linux)
    =========================================================================
    Your Portal for ArcGIS 10.3 is installed at:
    /home/ags/arcgis/portal
    Confirm Settings
    =========================================================================
    Product to upgrade:             Portal for ArcGIS 10.3 (Linux)
    Location to upgrade:            /home/ags/arcgis/portal
    Your Portal for ArcGIS 10.3 will be stopped when performing the 
    upgrade and Portal for ArcGIS 10.6.1 
    will be started after the upgrade completes.
      'y' to continue with these settings
      'q' to exit without upgrading this product
    Enter choice [y,q] (y):
  6. Digite y e pressione Enter para aceitar as configurações detectadas e continuar com a atualização. Você precisará autorizar seu software com um novo arquivo de autorização. Ao completar a atualização do portal, o site da web do portal abrirá em uma janela do navegador.
  7. Limpe o cache do seu navegador (inclusive cookies). As demais informações no cache da versão anterior do site da web podem fazer com que o site da web atualizado apareça incorretamente e você pode não conseguir se registrar. É recomendado que você limpe o cache (inclusive cookies) em todos os navegadores que estarão visualizando o site da web do portal atualizado.
  8. Clique no botão Continuar Atualização do Servidor . 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. Esta etapa pode demorar alguns minutos para completar.
  9. Abra o ArcGIS Portal Directory e entre com a conta inicial de administrador. A URL está formatada como https://portal.domain.com:7443/arcgis/portaladmin.
  10. A página de diretório exibirá uma mensagem de aviso que sua máquina não está completamente atualizada. Clique na operação Após Atualização .
  11. Anotação:
    Iniciando na versão 10.6, você também pode utilizar o utilitário de linha de comandos upgradeportal para completar as operações de atualização e após atualização silenciosamente. Na linha de comando, navegue até seu pasta <Portal install directory>/tools/upgradeportal e execute o seguinte: upgradeportal.sh -s. Para ajuda, execute o comando -h ou --help.
  12. Clique em Sistema > Indexar > Reindexar.
  13. Clique na lista suspensa Modo e selecione Completo.
  14. Clique em Reindexar. Esta etapa completará a atualização do seu portal. Dependendo do número de usuários e volume de conteúdo no seu portal, levará algum tempo para completar a reindexação. Não interrompa o processo de reindexação. Você pode monitorar o status de indexação abrindo uma nova janela do navegador (ou guia), navegando até Sistema > Indexar > Status do Índice e atualizando a página. Quando os valores armazenar e índice se igualam, a reindexação e atualização estão completas.
  15. Instale o Web Adaptor que será utilizado com seu portal. Para instruções completas, consulte o tópico de instalação do IIS, Java (Windows) ou Java (Linux). Tenha certeza que você utiliza o contexto do Web Adaptor que você utilizou na versão anterior.
  16. Configure o ArcGIS Web Adaptor com seu portal. Para instruções completas, consulte o tópico de configuração do IIS, Java (Windows) ou Java (Linux).
  17. Verifique se você pode entrar no site da web do portal pela URL do ArcGIS Web Adaptor como um Administrador da sua organização. A URL está formatada como https://webadaptorhost.domain.com/webadaptorname/home.
  18. Enquanto registrado como um Administrador da organização, atualize seu conteúdo do ArcGIS Living Atlas of the World. Vá até Organização > Editar Configurações > ArcGIS Online. Dentro da seção Configurar Conteúdo do Atlas em Tempo Real, clique em Atualizar Conteúdo. Não feche a página ArcGIS Online até que o portal finalize a atualização do conteúdo do ArcGIS Online . Clique em Salvar para retornar à página Organização . Se seu portal não foi configurado para acessar o conteúdo Living Atlas , esta etapa não é necessária.
  19. Se você federou um site do ArcGIS Server com seu portal e você está utilizando o ArcGIS Web Adaptor com seu site, entre na máquina que hospeda o Web Adaptor e desinstale o Web Adaptor. Anote o nome do Web Adaptor; você precisará utilizar o mesmo nome ao reinstalar. Para instruções completas, consulte o tópico de desinstalação do IIS, Java (Windows) ou Java (Linux).
  20. Se você federou um site do ArcGIS Server com seu portal, atualize cada site para 10.6.1. Não há necessidade de desinstalar e reinstalar. Você precisará executar a configuração em cada máquina do servidor GIS em cada site. Atualize seus servidores GIS consecutivamente (back-to-back). Para instruções completas, consulte Atualizar uma versão anterior do ArcGIS Server.
  21. Quando a atualização do servidor finalizar, verifique se você pode acessar a URL local do ArcGIS Server Services Directory. A URL está formatada como https://gisserver.domain.com:6443/arcgis/rest/services.
  22. Se você estava utilizando anteriormente um ArcGIS Web Adaptor com ArcGIS Server, reinstale o ArcGIS Web Adaptor. Utilize o mesmo nome que você especificou para o Web Adaptor na instalação anterior. Para instruções completas, consulte o tópico de instalação do IIS, Java (Windows) ou Java (Linux).
  23. Configure o ArcGIS Web Adaptor com seu servidor. Para instruções completas, consulte o tópico de configuração do IIS, Java (Windows) ou Java (Linux). Se você habilitou o acesso administrativo anteriormente para seu ArcGIS Server pelo Web Adaptor, certifique-se de ativá-lo novamente. Isto é especialmente importante se você utilizou a URL do Web Adaptor para a URL administrativa ao federar seu portal e o site do ArcGIS Server.
  24. Verifique se você pode acessar o Diretório de Serviços do ArcGIS Server pela URL do ArcGIS Web Adaptor. A URL está formatada como https://webadaptorhost.domain.com/webadaptorname/rest/services.
  25. Se o seu servidor de hospedagem do portal estiver utilizando o ArcGIS Data Store, crie uma cópia de segurança do armazenamento de dados, atualize o ArcGIS Data Store e reconfigure o armazenamento de dados para trabalhar com ArcGIS Server. Consulte Atualizar ArcGIS Data Store para instruções específicas.
  26. Se você configurou as licenças do ArcGIS Pro com sua organização, opcionalmente atualize o ArcGIS License Server Administrator. Ao atualizar o ArcGIS License Server Administrator, membros com licenças do ArcGIS Pro não conseguirão acessar o ArcGIS Pro. Se membros estiverem atualmente registrados no ArcGIS Pro, eles visualizarão uma mensagem declarando que o programa será fechado em vinte e quatro horas. Os membros podem completar ou salvar seu trabalho dentro deste período de tempo. Você não é exigido para reconfigurar as licenças do ArcGIS Pro após atualizar o ArcGIS License Server Administrator.
  27. Restaure qualquer personalização que você configurou anteriormente para seu portal. Ao restaurar as personalizações do seu portal no 10.6.1, não substitua os arquivos que você modificou na versão anterior em 10.6.1. Isto pode afetar adversamente seu desenvolvimento do 10.6.1. Você deve abrir cada arquivo no 10.6.1 e adicionar manualmente novamente seu comportamento personalizado da versão anterior.
    Dica:

    A Esri recomenda utilizar o script portalScan.py para verificar as melhores práticas de segurança com seu portal do ArcGIS Enterprise atualizado.

Considerações após atualizar o Portal for ArcGIS

Após atualizar, revise cuidadosamente as informações seguintes.

Após atualizar, o site da web do portal não aparecerá corretamente, ele exibirá uma mensagem de erro ou Eu não posso entrar. O que está errado?

Limpe o cache do seu navegador (inclusive cookies). Estes erros são normalmente devido às informações mantidas da versão anterior do site da web com o cache gerado no navegador. Se você ainda não conseguir entrar, certifique-se que esteja utilizando a conta inicial de administrador ou uma conta que tem privilégios administrativos para seu portal.

Após atualizar, eu não visualizo todos os meus itens, grupos e usuários no meu portal. O que está acontecendo?

Após instalar o software e especificar a conta inicial de administrador, você será solicitado para reindexar seu portal. Esta etapa completa a atualização do seu portal. A princípio, você pode não visualizar todos os seus itens, grupos e usuários, pois a reindexação não está completa. Dependendo do número de usuários e volume de conteúdo no seu portal, levará algum tempo para completar a reindexação. Por exemplo, uma organização pequena (centenas de usuários e itens de conteúdo) executando o Portal for ArcGIS em uma máquina com 8 núcleos pode levar 15 minutos para reindexar. Reciprocamente, uma organização grande (dezenas de milhares de usuários e itens de conteúdo) executando o Portal for ArcGIS em uma máquina com 8 núcleos pode levar até 3 horas para reindexar.

Você pode verificar o status da reindexação seguindo as etapas abaixo. Quando os valores armazenar e índice se igualam, a reindexação e atualização estão completas.

  1. Abra o ArcGIS Portal Directory e entre com a conta inicial de administrador. A URL está formatada como https://portal.domain.com:7443/arcgis/portaladmin.
  2. Clique em Sistema > Indexar > Status do Índice.
  3. Atualize a página para obter o status mais recente.

Após atualizar para 10.6.1, o conteúdo do Atlas em Tempo Real não está mais acessível em meu portal.

Se uma camada do Atlas em Tempo Real não estiver acessível em seu portal, é possível que o item tenha sido retirado desta versão. Verifique o tópico O que há de novo no Portal para uma lista atualizada dos itens retirados.

Se itens do conteúdo de assinante ou premium não puderem ser abertos na versão após a atualização, verifique se você completou as etapas para atualizar o conteúdo do Atlas em Tempo Real.

Após atualizar para 10.6.1, Eu vejo que todos os meus membros pertencem ao nível 2 de associação. Posso atualizar alguns destes membros para o nível 1 de associação?

Por padrão, todos os membros atualizados são atribuídos para papéis no nível 2 de associação. O administrador do portal pode atualizar os membros para papéis no nível 1 de associação desde que estes membros não tenham conteúdo e que a associação suficiente esteja disponível. Se os membros tiverem conteúdo, o administrador do portal deverá reatribuir seu conteúdo antes de alterar seu nível de associação.

Eu recebi um erro de autorização do software declarando que o número de membros registrados no portal excede o número máximo que o portal foi licenciado. Como eu resolvo este problema?

No Portal for ArcGIS 10.2.1 e versões mais antigas, o modelo de licenciamento do usuário nomeado do portal é obrigatório. Você não poderá adicionar mais membros no seu portal do que está atualmente licenciado. Se o número de membros que o seu portal está licenciado estiver excedido no 10.6.1, você verá uma mensagem de erro da autorização do software quando acessar o site da web do portal com uma conta que tem privilégios administrativos. Adicionalmente, usuários não poderão criar novas contas e membros sem privilégios administrativos não poderão entrar no portal. Consulte Execução de licenciamento de usuário nomeado para mais informações sobre como solucionar estes problemas.

Ocorreu um erro ao criar minha conta inicial de administrador. Como eu resolvo isto para completar a atualização?

Se você receber este erro ao criar a conta inicial de administrador, informações de registro do portal poderão ajudá-lo a resolver o problema. Frequentemente, este erro pode ocorrer se a conectividade de rede foi temporariamente perdida ao criar a conta. Para acessar os logs, navegue até o diretório de logs e abra o arquivo de log mais recente (por exemplo, <Portal for ArcGIS installation directory>/arcgisportal/logs/<machine name>/portal/portal-20141201.095803-8596-0.0.log). Se necessário, você poderá compartilhar estas informações no Esri Support.

Se você for atualizar da versão 10.3.1 e tiver Survey123 for ArcGIS ou Collector for ArcGIS configurado com seu portal, você precisará contactar o Suporte da Esri para continuar a atualização.

Se você estiver revertendo para sua implantação anterior, antes de reverter para a versão antiga, copie todos arquivos de log para ajudar na solução de problemas do seu incidente de suporte. (Para acessar os logs, navegue até o diretório de logs (por exemplo, <Portal for ArcGIS installation directory>/arcgisportal/logs/).

Eu preciso fazer algo com meus serviços de utilitário após atualizar?

Se você estiver utilizando os serviços de utilitário OfflinePackaging, RasterUtilities ou GeocodingTools, você precisa atualizá-los manualmente após você atualizar:

  1. Após sua atualização ser concluída, efetue o login no ArcGIS Server Manager como o usuário que possui os serviços de utilitário.
  2. Na seção Gerenciar Serviços da guia Serviços , clique na pasta Utilitários .
  3. Clique no ícone Propriedades de Compartilhamento Compartilhado .
  4. Na caixa de diálogo que abre, clique em Salvar. Isto atualizará o serviço em seu portal do ArcGIS Enterprise .
  5. Entre no portal como um administrador. Na guia Conteúdo , localize o serviço que você atualizou. Clique em Compartilhar. Atualize as configurações de compartilhamento se necessário, então clique em OK. Este procedimento atualiza o serviço com cada grupo que é compartilhado.
  6. Repita estas etapas para cada serviço aplicável.

Meu portal é configurado com o Serviço ArcGIS Online World Geocode. Eu preciso configurar novamente após atualizar?

Se você atualizou da versão 10.2.x, você precisará recriar o item de proxy em seu portal para o Serviço ArcGIS Online World Geocode. Então, configure o item como um geocodificador para o portal. A partir da versão 10.3.1, você não precisa atualizar o item de proxy para o serviço ArcGIS Online World Geocode.