Atualização

Atualize o Insights para uma nova versão em um par de máquinas Windows e Linux, seguindo etapas baseadas em cenários para o seu ambiente.

Para atualizar para uma nova versão do Insights, você precisa seguir as etapas com base em seu cenário de atualização.

Importante:

• Observe que esta é uma alteração de nossas especificações de HW/SW do Insights 2021.10. O Insights 2021.10 requer uma única máquina Windows, enquanto o Insights 2025.10 requer uma máquina Windows e uma máquina Linux com RHEL. Na versão 2021.10, a máquina Windows do Insights executou o Docker que hospedava o contêiner Linux do Looker. A partir do Windows 2022, o driver usado para aninhar os contêineres do Linux no sistema operacional Windows (conhecido como lcow) não é mais suportado pela Microsoft para aplicativos empresariais. Como resultado, tivemos que alterar nossa arquitetura de implantação para exigir duas máquinas: uma máquina Windows para executar os componentes do UiPath Insights e uma máquina Linux para executar o contêiner do Looker. Com essa alteração, o suporte corporativo é disponibilizado pelos fornecedores do sistema operacional para os componentes necessários para executar os produtos da UiPath. As versões suportadas do sistema operacional Linux são as mesmas que o Automation Suite suporta.

Observação:

Revise os requisitos de hardware e software. Se você tiver um banco de dados grande, considere indexar manualmente os logs de robô usando um script. Considere fazer o mesmo para as colunas ProcessingExceptionDetails e HostMachineName . A instalação pode falhar durante a migração do banco de dados do Insights se tiver que indexar um conjunto de dados grande.

Atualizar cenários

Atualizar de 2021.4 ou versão anterior para 2025.10

Tarefa	Description
1. Migrar usuários	Ao atualizar de uma versão anterior à 2021.10, os usuários com permissões do Insights não são migrados automaticamente para sua nova instalação. Eles podem ser migrados opcionalmente por meio da ferramenta de migração de usuários.
2. Instale a nova versão do Insights em uma máquina separada da instalação existente	Siga as instruções de instalação do Insights para instalá-lo em uma máquina separada. Depois de instalar a versão mais recente do Insights em uma máquina nova, a ingestão de dados antigos será interrompida.
3. Desinstalar a Versão antiga do Insights	Depois de concluir a criação dos novos painéis e fórmulas personalizadas na versão recém-instalada do Insights, você pode desinstalar a versão Versão antiga com segurança.

Observação:

• As instalações antigas e novas do Insights usarão o mesmo banco de dados enquanto os painéis estiverem sendo movidos.
• Para fazer login no Insights, você pode usar o antigo URL https://<old Insights url>/app/account/login e a mesma conta de administrador que foi configurada durante a instalação.

Para desativar as compilações antigas, siga as etapas abaixo:

1. Faça login no URL antigo (https://<old Insights url>/app/account/login).
2. Acesse https://<old Insights url>/app/data.
3. Selecione o ícone de três pontos em cada cubo e acesse o agendamento de compilações para desabilitar as compilações.

Atualizar de 2021.10 para 2025.10

Observação:

Se você fizer atualização do 2021.10.0, exporte os volumes do Looker usando a LookerPreInstallationTool e importe-os durante a inicialização do Looker para migrar seus painéis da máquina Insights antiga para a nova. Ao atualizar a partir da versão 2021.10, você também precisa truncar a coluna Raw Message na tabela do banco de dados. A regra padrão do Nlog foi alterada. Para saber mais detalhes, consulte a página Regras de log padrão para versões 2022.4 e superiores .

Tarefa	Description
1. Revisar comparação de funcionalidades	Revise a folha de referência da atualização para comparações de funcionalidades e recursos das versões de produtos anteriores antes de atualizar.
2. Migrar usuários	Ao atualizar de uma versão anterior a 2021.10, os usuários com permissões do Insights não são migrados automaticamente para sua nova instalação. Opcionalmente, é possível migrá-los com a Ferramenta de migração do usuário. Se você já usou a ferramenta ao atualizar para a versão 2021.10, não precisará executar novamente a ferramenta de migração do usuário.
3. (Migração de painel) Executar LookerPreInstallationTool e exporte volumes do Looker	Ao atualizar o Looker na Máquina Linux do Insights, execute a ferramenta de pré-instalação da Máquina Windows Insights para gerar um arquivo ZIP. Use o mesmo procedimento para executar o script Looker-initialization.sh. Certifique-se de exportar os dados do Looker (painéis, visualizações e configurações do aplicativo), na etapa 6 da seção de ferramenta de Pré-instalação do Looker para migrar seus painéis para a máquina Linux do Insights.
4. Instale a nova versão do Insights em uma máquina separada da instalação existente	Siga as instruções de instalação do Insights para instalá-lo em uma máquina separada. Depois de instalar a versão mais recente do Insights em uma máquina nova, a ingestão de dados antigos será interrompida.
5. Desinstalar a Versão antiga do Insights	Depois de concluir a criação dos novos painéis e fórmulas personalizadas na versão recém-instalada do Insights, você pode desinstalar a versão Versão antiga com segurança.

Upgrade From 2022.4, 2022.10, or 2023.4 to 2025.10

A direct upgrade from Insights 2022.4, 2022.10, or 2023.4 to 2025.10 is not supported. First upgrade Insights and its Looker deployment to 2023.10.x. After the intermediate upgrade completes, you can upgrade to 2024.10.x or 2025.10.x.

Importante:

Do not run migrate_encryption or any other migration command manually. The Insights upgrade process performs the required Looker encryption migration automatically.

To upgrade to 2025.10:

1. Upgrade Insights and its Looker deployment to 2023.10.x.
2. Continue with the standard upgrade steps to upgrade to 2025.10.x.

Upgrade From 2023.10 or 2024.10 to 2025.10

Etapas de atualização

Antes de atualizar o Insights para uma versão superior, certifique-se de que:

• Verifique e atualize a versão do Orchestrator, se necessário. É recomendável que o Orchestrator e o Insights estejam na mesma versão (Ex. Orchestrator versão 2025.10 e Insights versão 2025.10). Não ter a mesma versão afeta o desempenho do aplicativo. Para descobrir como instalar o Orchestrator, consulte Sobre a instalação ; se deseja atualizar sua versão atual, consulte Sobre a atualização .
• Tenha o pacote MSI e o preinstallationtool.exe baixados e certifique-se de que eles correspondam entre as versões.(Ex. Orchestrator versão 2025.10, pré-instalação para Insights versão 2025.10). Acesse o Customer Portal > página Download de produtos para baixar os arquivos necessários ou consulte a equipe de suporte.

Para iniciar o processo de atualização, siga estas etapas:

1. Ter a versão principal do UiPath Orchestrator atualizada para corresponder à versão principal do Insights.
2. Tenha o pacote MSI e opreinstallationtool.exe baixado. Consulte o Portal do cliente > página Download do produto para baixar os arquivos necessários ou solicitar a equipe de suporte.
3. Execute e forneça as informações solicitadas na ferramenta de pré-instalação. (Nome do Host Linux, Impressão Digital do Certificado etc.)
4. Copie o arquivo gerado pelo preinstallationtool para a VM do Linux.
5. Descompacte o arquivo zip da ferramenta de pré-instalação no diretório de instalação. a. Localize o diretório pai: dirname $(sudo docker inspect looker-container | jq -r '.[0].HostConfig.Binds' | grep 'deploy' | awk -F':/app/.deploy:Z' '{print $1}' | awk -F'"' '{print $2}') b. Descompacte para esse diretório: unzip <looker zip file> -d <parent dir>
6. Execute o script looker-initialization.sh. bash insights/looker-initialization.sh.
7. Copie o arquivo gerado para a VM do Windows.
8. Execute o Insights MSI.

Artigos relacionados

• Verificação dos serviços do Insights.
• Modificar as configurações do Insights