Instalaçã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 2024.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 (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.

As instalações em versões não suportadas do RHEL são bloqueadas e você precisa atualizar para uma versão compatível. Verifique o Sistema operacional para descobrir as versões compatíveis.

Importante: O Insights não deve ser instalado em uma pasta /tmp , pois isso pode criar problemas após uma reinicialização. A instalação precisa ser feita em um diretório persistente.

Observação:

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

Observação: Uma instalação de vários nós não é suportada, mas após a instalação, o Insights pode ser habilitado em uma instalação existente do Orchestrator de vários nós.

Visão geral

Para instalar o Insights v2024.10 com licença independente, você precisa seguir estes procedimentos na ordem descrita abaixo:

1. Preparar as máquinas Windows e Linux do Insights
2. Inicializar o Looker na máquina Linux do Insights
3. Instalar o Insights

Preparar a máquina Windows e a máquina Linux do Insights

Etapa 1

Prepare o(s) Certificado(s) para habilitar o SSL para ambas as máquinas. Para obter mais informações, clique aqui.

Observação: Certifique-se de importar os certificados do Looker e do Insights para a máquina na qual você deseja acessar o Insights.

O certificado para a máquina Linux do Insights deve ser instalado na máquina Windows do Insights porque o LookerPreinstallationtool.exe exportará o certificado da máquina Windows do Insights para a máquina Linux do Insights

Tanto a máquina Windows quanto a máquina Linux atenderão à solicitação HTTPS. Como tal, ambas utilizarão um certificado para as conexões HTTPS. Como pré-requisito, certifique-se de ter um certificado válido para o servidor Linux e um certificado válido para a máquina Windows.

Etapa 2

Configure duas máquinas que atendam aos requisitos de hardware e software.

Importante:

• Certifique-se de selecionar a função db_owner, pois isso é necessário quando você adiciona a função de proprietário do banco de dados durante a configuração da máquina SQL do Insights.
• As versões principais do Orchestrator e do Insights precisam corresponder. Por exemplo, se você atualizou o Orchestrator para a versão 2023.4.X, precisa executar uma versão 2023.4.X do Insights para estabelecer uma comunicação adequada entre os dois produtos da UiPath.
• O banco de dados do Insights precisa apontar para o mesmo banco de dados que foi criado quando você ativou o Insights durante a instalação do Orchestrator.
• Se você tiver um banco de dados grande, considere adicionar índices manualmente usando scripts SQL. A instalação do Orchestrator pode falhar durante a migração do banco de dados do Insights se for preciso indexar um conjunto de dados grande (consulte Falha na migração do banco de dados durante a instalação).

Preparando uma máquina Linux

Preparar uma máquina Linux AWS EC2

Etapa 1 Executar uma instância do Linux no AWS EC2

1. Inicie o lançamento da instância.
2. Selecione a Imagem do Red Hat Enterprise Linux 8
   Observação: há suporte para as versões 8.2, 8.4 e 8.6. O suporte para 8.8, 9.1 e 9.2 está disponível a partir do patch de agosto e deve estar disponível para todas as versões após (23.4.2+, 22.10.5+, etc.
3. Escolha um Tipo de instância e configure os Detalhes da instância.
4. Adicione armazenamento à sua instância e altere o Tamanho para 32.
5. Revise e inicie a instância

   Para obter mais informações, consulte Iniciar instância no AWS.

Observação:

O script usa Sudo para fazer a inicialização e se o host Linux usar dzdo em vez de Sudo, o script também usará dzdo.

Etapa 2 Abrir as portas de entrada

Abra as portas de entrada listadas na tabela abaixo seguindo as instruções aqui:

Tipo	Intervalo de porta	Origem	Description
TCP personalizado	9999	Anywhere-IPv4	Esta é a porta do Looker.
TCP personalizado	19999	Anywhere-IPv4	Esta é a porta da API do Looker.
TCP personalizado	29999	Anywhere-IPv4	Esta é a porta de atualização do LookML.

Preparar um ambiente Linux do Microsoft Azure

Etapa 1 Criar uma máquina executando Linux

1. Navegue até Serviços
2. Vá até Ver todas as imagens e selecione o Red Hat Enterprise Linux 8.2 - 8.6 ou 9.0 do Plano. Para o pacote RHEL offline, clique aqui.
   
   

   

   
   
3. Em Conta de administrador, escolha entre Chave pública SSH ou Senha. Se você usar uma chave pública SSH, poderá gerá-la e escolher Usar a chave existente armazenada no Azure.

Etapa 2 Abrir as portas de entrada para a máquina criada

Para abrir as portas de entrada listadas na tabela abaixo, siga as instruções aqui

Destination Port Ranges	Name	Prioridade	Origem
9999	Looker_Port	310	Qualquer
19999	LookerAPI_Port	320	Qualquer
29999	LookMLUpdate_Port	330	Qualquer

Para definir configurações adicionais, consulte Criar uma regra de segurança de entrada.

Etapa 3 Aumentar a alocação de armazenamento para máquinas Linux do Azure

A alocação de armazenamento padrão em uma máquina Linux do Azure é de 8 GB e pode causar erros de falta de espaço ao extrair imagens, criar backups ou usar vários painéis.

Importante: para ambientes isolados, uma verificação de espaço livre suficiente é executada, mas certifique-se de que os volumes /var tenham pelo menos 10 GB de espaço livre (consulte Requisitos de hardware da máquina Linux do Insights). Antes de executar o script de implantação, siga as etapas abaixo para aumentar a alocação de armazenamento e evitar erros de falta de espaço:

1. Open a SSH client in the Linux machine by running the command below:

   ssh azureuser@<your-hostname>

   Onde <your-hostname> precisa ser ajustado para refletir o nome do host da sua máquina.
2. Change to root user by running the command below:

   sudo -i

3. Verifique o tamanho do disco executando o comando abaixo:

   lsblk -f

   Você verá que o Ponto de montagem /var está sob o nome sda2 > rootvg-varlv.

   
4. Verifique o tamanho do /dev/sda2 executando o comando abaixo:

   lsblk /dev/sda2

   Onde /dev/sda2 é recuperado da etapa 3. Você verá agora o tamanho de /var, que é 8G.

   
5. Next, check the available space by running the command below:

   vgdisplay rootvg

   
   

   

   
   

   Você verá que o PE gratuito / Tamanho é de aproximadamente 40 GiB.

6. rootvg-varlvAumente o tamanho de executando o comando abaixo:
   Você pode alterá-lo para +10G ou um valor diferente que seja menor que o 40GB disponível (o tamanho da memória livre que você consulta na Etapa 5).

   lvresize -r -L +10G /dev/mapper/rootvg-varlv

   Observação: para instalações com air gap, execute o mesmo comando em /home.
   
   

   

   
   
7. Verifique se o redimensionamento foi bem-sucedido executando o comando abaixo:

   lsblk /dev/sda2

Agora você terá espaço suficiente para o docker (localizado em /var/lib/docker).

Para ambientes isolados, execute os comandos das etapas 1-6 para aumentar o tamanho de /home para garantir espaço suficiente para imagens e pacotes off-line.

Preparando uma máquina Windows para hospedar o serviço Insights

1. Configure uma máquina Windows que atenda aos requisitos de hardware e software.
2. Abra a porta de entrada padrão 443. Para obter instruções sobre como abrir uma porta de entrada no AWS, consulte Autorizar acesso a uma instância. Para obter instruções sobre como abrir uma porta de entrada no Azure, consulte Portal de início rápido do NSG.
3. Execute o Script Install-Prerequisites.ps1 para habilitar o IIS 10+, instale o .NET 6.0.5+ e reinicie o serviço do IIS. Como alternativa, você pode instalar manualmente os pré-requisitos destacados nas subetapas abaixo:
   1. Abra uma sessão RDP na máquina criada para instalar os pré-requisitos.
   2. Habilitar o IIS 10+.
      Para habilitar o IIS 10+, acesse o Painel de Controle > Programas > Ativar ou desativar recursos do Windows. Isso abrirá o Assistente para adicionar funções e funcionalidades. Siga o assistente para habilitar o Web Server (IIS).

      
      

      

      
      
      Isso abrirá o Assistente para adicionar funções e funcionalidades. Siga o assistente para habilitar o Web Server (IIS).

      
      

      

      
      

      Habilite os seguintes módulos de servidor Web (IIS):

      • Web Server
        • Recursos HTTP comuns
          • Documento Padrão
          • Navegação de diretório
          • Erros de HTTP
          • Conteúdo Estático
        • Saúde e diagnóstico
          • Log in HTPP
        • Desempenho
          • Conteúdo Estático
        • Segurança
          • Filtragem de Solicitação
      • Ferramentas de gerenciamento
        • Console de Gerenciamento IIS
   3. Baixe e instale o Pacote de Hospedagem do .NET versão 6.0.7+.
   4. No PowerShell, execute os seguintes comandos:

      net stop was /y ; net start w3svc

4. Habilite HTTPS na sua máquina usando um certificado SSL. Prepare seu certificado usando um procedimento semelhante ao fornecido para o Orchestrator. Consulte Como usar um certificado para o protocolo HTTPS.
5. Ao especificar um nome de host para o Insights, certifique-se de que o nome de host desejado seja resolvido no seu DNS.
6. Certifique-se de usar o TLS 1.1 ou 1.2.

Configuração do SQL Server

Antes de instalar o Insights, você precisa configurar a instância SQL Server do Insights que você deseja usar.

Observação: O banco de dados SQL do Insights não deve diferenciar maiúsculas de minúsculas (“InsightsDB” = “insightsdb”). Se ele foi criado durante o processo de instalação do Insights, ele está automaticamente definido dessa forma. Se você criar seu próprio banco de dados do Insights, defina a sequência de agrupamento como Latin1_General_CI_AS para configurá-lo manualmente para não diferenciar maiúsculas de minúsculas.

Certifique-se de ter as seguintes informações prontamente disponíveis, pois são necessárias para executar o instalador do Insights:

• O nome da máquina do SQL Server.
• O nome da instância, se ela não for a instância padrão.

Garanta também:

• A porta do SQL Server está aberta no firewall da máquina do SQL Server. Você pode usar SKIP_FIREWALL_RULE_CREATION=true` para ignorar criação de regra no firewall.
• O protocolo TCP no SQL Server Configuration Manager está habilitado.
• O serviço do SQL Server está definido para escutar em uma porta fixa, não em uma alocada dinamicamente.

Configure um dos seguintes métodos de autenticação através do qual o Insights pode se conectar ao banco de dados do SQL Server:

• Autenticação Integrada do Windows
• Autenticação do SQL Server

Autenticação Integrada do Windows

Para esta opção, um novo login é necessário para o SQL Server como uma conta de serviço. A conta de serviço deve ser um usuário de domínio cuja senha nunca expira. O Looker, o mecanismo subjacente usado pelo Insights, é executado em um contêiner do Linux.

Importante: Para habilitar a autenticação do Windows, o SQL Server precisa ser compatível com a autenticação através do protocolo Kerberos.

Para mais detalhes sobre como habilitar a autenticação do Kerberos no Servidor SQL, consulte Registro manual do SPN.

Execute o seguinte comando para verificar o SPN em sua máquina Windows:

setspn -Q MSSQLsvc/<server name>:port

Execute o seguinte comando para definir o SPN:

setspn -S MSSQLsvc/<FQDN server name>:port [domain\<SQL service account>

Observação: opcionalmente, você pode usar uma conta de serviço como um SPN. Esta deve ser a conta na qual o serviço do SQL Server está sendo executado.

Considerações ao configurar a Autenticação Integrada do Windows

• Antes de configurar a autenticação do Kerberos, certifique-se de que o Servidor do Insights pode acessar seu Active Directory (AD) e SQL Server. Você pode revisar isso com seu administrador de TI.
• O SQL Server precisa ser adicionado ao seu domínio do AD.
• A máquina do Insights precisa estar na mesma rede que o Domínio do AD e o SQL Server.
• O DNS deve ser configurado de forma que a máquina do Insights possa resolver os nomes de domínio tanto para o Domínio do AD quanto para o SQL Server.
• O usuário do AD deve existir com acesso ao SQL Server e permissões do DB, conforme definido na seção Permissões. O domínio, nome de usuário e senha para esse usuário devem ser fornecidos durante o processo de instalação do Insights. Não se esqueça de que o nome de usuário é sensível a minúsculas/maiúsculas e que também serve como o sAMAccountName do usuário.
  Abra o cmd como administrador e execute set user para obter o USERDNSDOMAIN e USERNAME.
• O servidor SQL precisa ter entradas de SPN no AD. Para obter mais informações, consulte Registrar um nome de entidade de serviço para conexões de Kerberos.
  Importante: É fundamental que o maquina do Insights precise resolver os nomes de domínio tanto do Domínio do AD quanto do SQL Server. Você pode verificar se isso ocorre executando nslookup <your_AD_domain_name> e nslookup <your_SQL_server_domain_name> na máquina do host.

Como criar um novo login no SQL Server Management Studio

1. No painel Explorador de Objetos, navegue até Segurança > Login.
2. Clique com o botão direito do mouse na pasta Logins e selecione Novo Login.
3. Selecione a opção Autenticação do Windows. A janela é atualizada de acordo.
   
   

   

   
   
4. No campo Nome de login, digite o domínio de usuário que você deseja usar como uma conta de serviço.
5. Na lista Idioma padrão, selecione inglês.
   Importante: certifique-se de que o idioma padrão esteja definido como Inglês. Caso contrário, o site não poderá ser iniciado e o Visualizador de eventos na máquina em que o Insights está instalado exibirá a seguinte mensagem de erro: The conversion of a varchar data type to a datetime data type resulted in an out-of range value.
6. Clique em OK para salvar a configuração.

   Se a conta de serviço já tiver sido criada e adicionada à seção Segurança > Logins do SQL Server, verifique se o Idioma Padrão dessa conta SQL está definido como inglês. Se não estiver, você precisa fazer os ajustes necessários.

Autenticação do SQL Server

Para este método de autenticação, você precisa de um usuário do SQL Server.

Importante: Considere usar uma conta que não seja de administrador do sistema por razões de segurança.

Como criar usuário SQL no SQL Server Management Studio

1. No painel Explorador de Objetos, navegue até Segurança > Login.
2. Clique com o botão direito do mouse na pasta Logins e selecione Novo Login. A janela Login — Novo será exibida.
3. Selecione a opção autenticação do SQL Server. A janela é atualizada de acordo.
   
   

   

   
   
4. Preencha os campos Nome do login, Senha e Confirmar senha adequadamente.
5. Certifique-se de que as opções Aplicar expiração de senha e Usuário deve alterar a senha no próximo login não estejam selecionadas.
   Importante: certifique-se de que o idioma padrão esteja definido como Inglês. Caso contrário, o site não pode ser iniciado e o Visualizador de eventos na máquina em que o Insights está instalado exibe a seguinte mensagem de erro: “A conversão de um tipo de dados varchar em um tipo de dados datetime resultou em um valor fora do intervalo”.

Se a conta do SQL Server já tiver sido criada e adicionada à seção Segurança > Logins do SQL Server, verifique se o Idioma Padrão está definido como inglês. Se não estiver, faça os ajustes necessários.

Permissões

Independentemente do tipo de usuário (domínio ou SQL) que você deseja conectar ao SQL Server, observe que você precisa atribuir a ele a Função de Servidor dbcreator ANTES de instalar o Insights, pois o banco de dados é criado durante esse processo de instalação.

Se as restrições de segurança não permitem o uso da Função de Servidor dbcreator na conta de serviço, crie o banco de dados vazio no SQL Server.

O instalador do Windows se conecta ao SQL Server para verificar a existência do banco de dados.

Após criar o banco de dados, você precisa fornecer ao usuário que se conectar ao banco de dados SQL do Orchestrator, a função db_owner de mapeamento de usuário, como demonstrado na captura de tela a seguir:

A EXECUTEpermissão deve ser concedida usando o GRANT EXECUTEcomando SQL, da seguinte maneira.

• se a Autenticação Integrada do Windows for usada:

  USE UiPath Insights
  GO
  GRANT EXECUTE ON SCHEMA::dbo TO [domain\user]
  GO

• se a Autenticação do SQL Server for usada:

  USE UiPath Insights
  GO
  GRANT EXECUTE ON SCHEMA::dbo TO [sql_user]
  GO

  Observação: Para configurar o MAXDOP padrão do seu banco de dados, consulte Configurar o grau máximo de paralelismo Opção de configuração do servidor .

Instalar o Orchestrator e habilitar a funcionalidade do Insights

Esta seção é obrigatória para preparar o banco de dados do Insights. Antes de continuar a instalação do Insights, você precisa habilitar o recurso do Insights no Orchestrator de acordo com o seu cenário.

Para versões acima de 2021.10, nova instalação do Orchestrator e do Insights ou Adicionar Insights à instalação do Orchestrator existente, consulte a etapa 3 da instalação de nó único do Orchestrator).

Observação: Uma instalação de vários nós não é suportada, mas após a instalação, o Insights pode ser habilitado em uma instalação existente do Orchestrator de vários nós.

Orchestrator instalado como serviço de aplicativo no Azure: se você executa o Orchestrator como um serviço de aplicativo no Azure, você pode executar um script para publicar o Orchestrator e habilitar o Insights por meio do parâmetro -insightsFeatureEnabled.

Observação:

• As versões do Orchestrator e do Insights precisam corresponder. Por exemplo, se você executar o Orchestrator versão 2023.4.0, precisará executar a mesma versão do Insights para estabelecer a comunicação adequada entre os dois produtos da UiPath.
• O banco de dados do Insights precisa apontar para o mesmo banco de dados que foi criado quando você ativou o Insights durante a instalação do Orchestrator.
• Se você tiver um banco de dados grande, considere adicionar índices manualmente usando scripts SQL. A instalação do Orchestrator pode falhar durante a migração do banco de dados do Insights se for preciso indexar um conjunto de dados grande.

Inicializar o Looker na máquina Linux do Insights

Siga o procedimento para inicializar o Looker na máquina Linux do Insights.

Como alternativa, você pode usar o script de implantação:

1. Execute a a ferramenta LookerPreinstallationTool.exe para gerar um arquivo ZIP para Looker: Isso gerará arquivos Looker na máquina Windows do Insights.
2. Copie os arquivos do Looker para a máquina Linux do Insights para implantar o Looker ou use o Script Deploy-Looker.ps1 para copiar os arquivos extraídos para a máquina Linux do Insights e depois inicialize Looker.
   Importante:

   O script Deploy-Looker.ps1 é compatível com LookerPreinstallationTool.exe versão 2023.4.0.

   Para informações detalhadas, consulte o Script de implantação automatizada.

Gerar arquivos do Looker na máquina Windows do Insights

Observação: as definições de SMTP são configuradas automaticamente a partir da versão 2018.4

1. Baixe LookerPreinstallationTool.exe e execute a ferramenta na máquina Windows do Insights.
   Observação:

   A versão da ferramenta deve corresponder exatamente à mesma versão do Ochestrator e do Insights. Para baixar a versão necessária do LookerPreinstallationTool, consulte o Customer Portal > página Download do produto ou pergunte à equipe de suporte.

2. Siga as etapas iniciais para gerar o arquivo ZIP.
3. Selecione o idioma.
   Importante: Se o console não puder exibir chinês/coreano/japonês corretamente, altere a fonte do seu console. Para Powershell, você pode clicar com o botão direito do mouse na barra de título e selecionar Propriedades e depois uma fonte TrueType (por exemplo, MS Gothic, MS Mincho ou NSimSun).
4. Valide e exporte o certificado gerado. Certifique-se de que o nome do host seja totalmente qualificado e abrangido pelo certificado.
   Observação: o certificado precisa ser colocado nas pastas Pessoal e Autoridades de certificação raiz confiáveis .
   
   

   

   
   
5. (Opcional) Configure a autenticação do Windows, se você a usar.
   Observação: se estiver atualizando da versão 2021.10, devido à mudança de arquitetura para 2 máquinas virtuais na 2023.4, o instalador não transfere automaticamente painéis, alertas e agendamentos de 2021.10 para 2023.4. Para evitar perder painéis, alertas e agendamentos, execute a etapa 6 para migrar este conteúdo para a nova máquina do Linux. Isso não se aplica a atualizações a partir de 2022.4. Lembre-se de que se esta etapa não for realizada durante a atualização, todos os painéis, agendamentos e alertas serão excluídos e não estarão mais disponíveis para exportação para a nova máquina Looker quando a instalação via InsightsInstaller.msi for concluída com sucesso.
6. (Opcional) Exporte dados para continuar usando seus painéis, alertas e agendamentos anteriores na nova versão. A ferramenta pode detectar se um looker_container está sendo executado na máquina. Se você mover seus dados, a senha atual do Looker armazenada em $Env:ProgramData\UiPath Insights será exportada e usada na nova máquina Linux do Insights.
7. (Opcional) Criptografe o arquivo ZIP para proteger o segredo do Looker. Se você concluiu a etapa 4, considere usar uma senha para proteger o arquivo ZIP.
   
   

   

   
   
8. Digite o caminho onde você deseja criar o arquivo ZIP. Caso contrário, ele será criado no caminho padrão que será exibido no console.

Copiar os arquivos do Looker para a máquina Linux do Insights

Copie o arquivo ZIP para a máquina Linux do Insights.

1. Autentique-se em sua máquina Linux do Insights.
2. Abra uma sessão do SCP e insira um comando que inclui o caminho do arquivo ZIP e o nome de usuário e senha usados como suas credenciais na máquina Linux do Insights executando o comando abaixo:

   scp <path-to-Insights_Lookerfile>.zip <user@linuxhostname>:~/

   Observação: Considere usar o Powershell 7 ou versão posterior, ou o Putty, pois as versões anteriores (Powershell 5.1) podem apresentar problemas de renderização ou uma tela em branco.

Inicializar o Looker

1. Abra o Powershell e execute o comando abaixo para autenticar:

   ssh <username@hostname>

   Observação: Depois de fazer login na máquina Linux do Insights, verifique se a hora local do sistema está correta. Caso contrário, o Looker pode entrar em um loop de atualização infinito.
2. Gere a chave GPG usando o comando abaixo:

   gpg --generate-key

   Observação: a chave GPG não é mais necessária em todas as versões da instalação a partir da versão de abril de 2023 (23.10.3, 23.4.6, etc.)

   Quando solicitado, insira o nome de usuário, e-mail e defina uma senha. Uma chave pública é gerada. Certifique-se de salvar a chave pública, pois você irá usá-la mais tarde.

   A chave pública é usada para armazenar a senha do Looker e o certificado gerado durante a inicialização do Looker. Você pode passar essa chave pública usando o parâmetro -k ao executar looker-initialization.sh.

   
   

   

   
   
3. Descompacte os arquivos do Looker Arquivos executando o comando abaixo:

   unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directory

   O diretório de instalação para Insights é o diretório a partir do qual o script é executado. Portanto, evite descompactar o arquivo em seu diretório inicial. O diretório padrão do Linux seria /opt, mas ele pode ser instalado em um local que você escolher.

4. Execute o script de inicialização do Looker executando o comando abaixo:

   cd <installation directory>
   bash insights/looker-initialization.sh -k <Public Key>

   Observação: -k <public key> não é mais necessário em todas as versões de instalação a partir da versão de abril de 2023 (23.10.3, 23.4.6, etc.)
   Em que <Public Key> é gerado por meio do comando gpg --generate-key.
   Observação: Talvez você precise inserir sua senha para salvar a senha do Looker.
   Observação: o script usa Sudo para fazer a inicialização e se o host Linux usar dzdo ao invés de Sudo, o script também usará dzdo.
   Observação: Você pode receber o seguinte erro Module yaml error: Unexpected key in data: static_context [line 9 col 3] durante a instalação. Para obter mais informações sobre esse bug, consulte Desativar validação estrita de documentos modulemd (RhBug:2004853).

   Isso não tem impacto na instalação do Insights.

5. Saia do Powershell e baixe looker.json executando o comando a seguir

   scp <username@hostname>:~/insights/looker.json <path-to-save-json>

   Substitua <username@hostname> pelo seu nome de usuário e nome do host do Linux.
   Você pode usar cat /home/user/insights/looker.json para copiar o conteúdo e criar um arquivo na máquina Insights Windows chamado looker.json no diretório de implantação e, em seguida, colar o conteúdo copiado.

Importante: Após a inicialização, um arquivo chamado 'looker.key' será criado na pasta $HOME/_insights. Não exclua esse arquivo, ele será necessário para para futuras atualizações.

Observação:

Você pode criar um usuário do Looker e alterar a propriedade da pasta de implantação para o novo usuário do Looker e definir a permissão da pasta de implantação para 755. Todos os arquivos na pasta terão o atributo 644.

Observação:

O Looker tem a capacidade de eliminar uma consulta SQL após um painel ser fechado, se a consulta não tiver sido concluída. Isso pode solucionar problemas de desempenho em alguns cenários. Se quiser que esse recurso seja habilitado, adicione a permissão de sql abaixo. Essa etapa é opcional.

use master
go
GRANT ALTER ANY CONNECTION TO sqladmin

Instalação do Insights

Observação:

• 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.
• O Instalador usará o Idioma de exibição do Windows se for um dos seguintes: en-US, fr-FR, de-DE, es-ES, es-MX, ja-JP, ko-KR, pt-BR, pt-PT, ru-RU, tr-TR, zh-CN. Se o Idioma de exibição do Windows não for um desses idiomas, o instalador usará o inglês.

1. Baixe o InsightsInstaller.msi do Customer Portal, selecionando sua versão.
2. Execute o instalador como administrador usando o prompt de comando ou o console do PowerShell.
3. Navegue até o diretório onde o instalador do .msi está localizado.
4. Execute o instalador do Insights usando o seguinte comando:

   msiexec /i InsightsInstaller.msi

   Como alternativa, você pode usar o seguinte comando:

   .\InsightsInstaller.msi

5. O instalador do Insights vai verificar agora os pré-requisitos. Se todos os pré-requisitos forem atendidos, o assistente de instalação do UiPath Insights é exibido e orienta você pela instalação e configuração do Insights.
   
   

   

   
   
   Se a instalação falhar ou se você quiser verificar o log da instalação, acesse a pasta %temp% ou %temp%/<sessionID> e verifique o MSI{random chars}.LOG mais recente. Os arquivos deste diretório não são permanentes e podem ser perdidos entre sessões. Você pode digitar o comando abaixo para executar a instalação com o local de log predefinido.

   msiexec -I "InsightsInstaller.msi" -L*V  c:\logs\interactive.log

6. Aceite o Contrato de Licença e clique em Avançar.
   
   

   

   
   
7. O script de inicialização do Looker em seu host Linux gera um arquivo JSON com a configuração da instância. Insira o caminho de arquivo completo do local onde você armazenou esse arquivo neste host Windows.
   
   

   

   
   
8. Insira as configurações da máquina Windows do Insights da seguinte forma:
   • URL do servidor do Insights - O nome do host ou a URL da máquina Windows do Insights.
   • Porta - A porta que você deseja usar para habilitar a comunicação com a máquina Windows do Insights. O número da porta padrão é definido como 443.
   • Certificado — o Assunto ou Impressão Digital do certificado SSL que você deseja usar para proteger conexões com o Insights.
     
     

     

     
     
9. Defina as configurações do Orchestrator da seguinte forma:
   • URL do Orchestrator — a URL do Orchestrator
   • Token de instalação - Insira o Token de acesso de instalação que você gerou na página Token de acesso de instalação do Identity Server fazendo login como o tenant do host. Para obter mais detalhes, consulte Portais de administração de host.
   • Identity Server separado - Se você tiver um Identity Server separado, habilite essa opção.
     Nota: Você precisa de um novo Token de Acesso de Instalação em cada instalação. O token é válido por 2 horas e depois expira. Gere outro se ocorrer uma falha de instalação.
     
     

     

     
     
10. Defina as configurações de banco de dados do Insights da seguinte forma:
    • Nome do Servidor - o nome da máquina do SQL Server onde o banco de dados do Insights está localizado, incluindo a porta de escuta padrão para o SQL Server (1433). Por exemplo: SQLServer,1433.
    • Nome do banco de dados — o nome do banco de dados do Insights
    • Tipo de autenticação — escolha um dos seguintes métodos de autenticação:
      Você deve usar o nome de domínio totalmente qualificado para o banco de dados (por exemplo, mysever.my.domain em vez de myserver). Preferencialmente, o SQL Server deve ingressar no domínio do AD diretamente.
      • Autenticação do Windows — se selecionado, o Insights se conecta ao banco de dados, cria tabelas e executa o Pool de Aplicativos do IIS usando as credenciais especificadas. O instalador valida a conexão usando as credenciais do Windows com as quais você está conectado atualmente. Se você selecionar essa opção, deve especificar o domínio, nome de usuário e senha.
      • Autenticação SQL — se selecionado, a conexão é feita usando a autenticação SQL. Se estiver usando esta opção, os campos Nome de Usuário e Senha se tornam editáveis e você deve fornecer o nome de usuário e senha do SQL usados para se conectar ao banco de dados.
        
        

        

        
        
        Importante: nenhuma autenticação para SMTP é compatível no Insights 2022.4, 2022.10 e 2023.4.
11. Defina as configurações de e-mail da seguinte forma:
    • Configurar serviço de e-mail (SMTP) — marque para configurar o serviço de e-mail
      • Servidor - O nome do host SMTP.
      • De - O endereço de e-mail do qual enviar mensagens de e-mail.
      • Nome de usuário — o nome de usuário do servidor SMTP, se a autenticação for necessária. Por exemplo, se você estiver usando o Gmail, preencha esse campo com o endereço de e-mail usado para enviar mensagens.

        Considere usar SMTP com autenticação, pois SMTP sem autenticação pode não ser suportado no futuro.

      • Senha — a senha da conta de e-mail
      • Porta — a porta SMTP.
      • TLS/SSL — marque para habilitar o TLS/SSL.

        Versão do TLS/SSL — somente visível se TLS/SSL estiver marcado. Escolha entre TLSv1_1 e TLSv1_2

        Observação: assim que essa etapa for concluída, um e-mail será enviado usando os detalhes do servidor SMTP. Isso é para garantir que os detalhes de SMTP estejam corretos. Se houver um erro durante esta etapa, verifique o arquivo de log e navegue até a página de solução de problemas
12. Clique em Avançar para iniciar a instalação. Quando o processo de instalação for concluído, clique em Fechar para sair do instalador.
    
    

    

    
    

Etapas de pós-instalação

Migrar tabelas

Observação: essa etapa só é necessária se você tiver tabelas grandes e enfrentar tempos limite durante a atualização.

Para migrar tabelas de trabalhos, use as etapas abaixo.

1. Preencha JobOrganizationUnitId.

   with CTE as (
   select qie.[JobOrgUnitFullyQualifiedName] as qOrgName, qie.[JobOrganizationUnitId] as qOrgId, j.[OrganizationUnitId] as jOrgId, j.[OrgUnitFullyQualifiedName] as jOrgName
   from [dbo].[QueueItemEvents] qie 
   inner join [dbo].[QueueItems] qi on qie.[QueueItemId] = qi.[Id]
   inner join [dbo].[Jobs] j on qi.[ExecutorJobId] = j.[Id]
   where j.[OrganizationUnitId] != qie.[JobOrganizationUnitId] or (qie.[JobOrganizationUnitId] is null and j.[OrganizationUnitId] is not null))
   update CTE
   set qOrgName = jOrgName, qOrgId = jOrgId;

2. Crie um índice de fluxo de trabalho de longa duração se ele não existir.
   Observação: se esse script foi usado anteriormente, não há necessidade de executá-lo uma segunda vez.

   IF NOT EXISTS(SELECT * FROM sys.indexes WHERE Name = 'IX_JobEvents_JobId_TenantId' and OBJECT_NAME(object_id) = 'JobEvents')
   CREATE NONCLUSTERED INDEX [IX_JobEvents_JobId_TenantId] ON [dbo].[JobEvents]
   (
       [JobId] ASC,
       [TenantId] ASC
   )

3. Truncar tabelas de leitura para preencher campos novos.

   truncate table [read].[QueueItemEvents];
   truncate table [read].[QueueItems];
   truncate table [read].[Jobs];
   truncate table [read].[JobEvents];
   delete [dbo].[IngestionMarkers] where [IngestionEventType] in (9002, 9001);

Garantir o licenciamento adequado

Você precisa ter pelo menos um código de licença, que incluirá Orchestrator, Insights e um robô, todos no nível do Host, anexado ao Orchestrator (consulte Gerenciar licenciamento do host).

Habilitar Tenants

Após a instalação do Insights, você deve habilitá-lo para os tenant(s) desejados no portal do host do Orchestrator. Para obter mais detalhes, consulte Habilitando ou desabilitando recursos.

Verificação dos serviços do Insights

1. Abra um navegador web suportado
2. Navegue até https://hostname:443/Insights para confirmar que a instalação do Insights foi bem-sucedida.

Modificando o Insights

Mantenha o arquivo de instalação original caso queira modificar ou desinstalá-lo.

Para obter mais informações, consulte Modificando configurações do Insights.

Ativar Insights de nó único no Orchestrator de vários nós existente

Para habilitar o UiPath Insights de nó único no UiPath Orchestrator de vários nós, siga as etapas abaixo:

1. Habilite o UiPath Orchestrator em um nó primário e gere um arquivo de parâmetros. Consulte Adição de nós ao Orchestrator de vários nós para obter detalhes.
2. Execute o instalador do Orchestrator (UiPathOrchestrator.msi) em nós secundários com o seguinte comando:

   UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json
         /Q

3. Garanta a consistência em todos os nós, substituindo o UiPath.Orchestrator.dll. .csv em nós secundários com a versão do nó primário. Este arquivo está localizado em C:\Program Files (x86)\UiPath\Orchestrator. É recomendável criar um backup antes da substituição.
4. Verifique se o arquivo UiPath.Orchestrator.dll. é idêntico em todos os nós após a substituição.

Artigos relacionados

• Instalação em ambiente isolado
• Atualizando o Insights
• Solução de problemas