Atualização

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, já o Insights 2023.10 requer uma máquina Windows e uma máquina Linux com RHEL.
• Se o cliente usar a chave GPG para qualquer versão anterior ao lançamento de abril (23.10.3, 23.4.6, etc.), ele deve atualizar usando a mesma conta/usuário que realizou a instalação inicial, ou ele precisará fazer uma instalação nova.

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 (chamado 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.

As versões do Orchestrator e do Insights precisam corresponder. Por exemplo, se você atualizou o Orchestrator para a versão 2023.10.1, precisa executar a mesma versão 2023.10.1 do Insights para estabelecer uma comunicação adequada entre os dois produtos da UiPath.

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 HostMachineName e ProcessingExceptionDetails. 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 2023.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. Clique no ícone de três pontos em cada cubo e vá para o cronograma de compilação para desabilitar as compilações.

Atualização de 2021.10 para 2023.4

Observação: se você atualizar a versão 2021.10.0, exporte os volumes do Looker usando 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 obter mais detalhes, consulte a página Regras de log padrão para versões 2022.4 e acima .

Tarefa	Description
1. Revisar comparação de funcionalidades	Revise os para comparações de funcionalidades e recursos das versões de produtos anteriores antes de atualizar para a 2022.10.
2. 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. 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.

Atualização da versão 2022.4, 2022.10 ou 2023.4 para 2023.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 2022.10.3 e Insights versão 2022.10.3). Não ter a mesma versão afeta o desempenho do aplicativo. Para saber como instalar o Orchestrator, verifique Sobre a Instalação e Sobre a Atualização , se desejar atualizar sua versão atual (a versão secundária deve corresponder).
• Tenha o pacote MSI e o preinstallationtool.exe baixados e certifique-se de que haja correspondência entre as versões. (Ex. Orchestrator versão 2022.10.3 , pré-instalação para Insights versão 2022.10.3). Consulte o Portal do cliente > página Download do produto para baixar os arquivos necessários ou solicitar a equipe de suporte.

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

1. Ter a versão do UiPath Orchestrator atualizada para corresponder à versão 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 do preinstallationtool para o diretório de instalação.
   1. 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}')
   2. Descompacte para esse diretório: unzip <looker zip file> -d <parent dir>
6. Execute o script looker-initialization.sh. bash insights/looker-initialization.sh -k <Public Key>
7. Copie o arquivo gerado para a VM do Windows.
8. Execute o Insights MSI e forneça o caminho para looker.json quando a janela pop-up for exibida.

Artigos relacionados

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