Instalação

Pré-requisitos para a instalação

1. Ensure that you meet the Hardware and Software Requirements for Insights.

2. Habilitar o IIS 10+.

   Para habilitar o IIS 10+, vá para o Painel de Controle > Programas > Ativar ou desativar recursos do Windows > 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
       • Documento Padrão
       • Conteúdo Estático
     • Saúde e diagnóstico
       • Log HTTP
     • 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 3.1.17+.

   1. Download .NET Hosting Bundle.
   2. No prompt de comando, execute net stop was /y e, em seguida, net start w3svc.

4. Install Orchestrator and enable the Insights feature. You need to get an installation access token from Orchestrator.

   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 do Insights SQL Server.

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

   

5. Enable HTTPS on your server using an SSL certificate. The procedure is similar to the one provided for Orchestrator. See Using a Certificate for the HTTPS Protocol.

   1. 1. Obtenha um certificado autoassinado com seu DNS e importe-o para certlm.msc.

      

   2. Execute o seguinte comando:

      $cert = New-SelfSignedCertificate -certstorelocation cert:\localmachine\my -dnsname <your-dns-name> -KeySpec KeyExchange
      $pwd = ConvertTo-SecureString -String '<your-password>' -Force -AsPlainText
      $path = 'cert:\localMachine\my\' + $cert.thumbprint
      Export-PfxCertificate -cert $path -FilePath <path-to-save>\cert.pfx -Password $pwd
      

      Observação:

      Certifique-se de substituir o seguinte:

      • <your-dns-name> pelo nome de DNS do seu servidor ou máquina virtual
      • <your-password> pela senha com que você deseja criptografar o certificado
      • <path-to-save> pelo local em que você deseja salvar o certificado de formato .pfx exportado

   3. Instale o certificado manualmente tanto em Pessoal quanto Confiável usando o gerenciador de certificados.

      Importante:

      É preferível usar um certificado SSL SAN enviado a uma Autoridade de Certificação do que um certificado autoassinado.

      • Certificados autoassinados (e aqueles da sua própria autoridade de certificação) devem ser instalados em ambos os armazenamentos de certificados Raiz Confiável e Pessoal na máquina do Insights, e também devem ser marcados como Exportáveis.
      • Os certificados enviados para uma autoridade de certificação só precisam ser instalados na Raiz Confiável.

      Observe que, ao usar um certificado autoassinado, você pode ter problemas se acessar o Insights por meio do Firefox ou Edge. O suporte para Internet Explorer não é mais oferecido para o Insights 2021.4 ou mais recente.

6. Ao especificar um nome de host para o Insights, certifique-se de que o nome de host desejado seja resolvido no seu DNS.

   

7. Verifique se o servidor em que o Insights será instalado pode se comunicar com o(s) servidor(es) onde o Orchestrator é instalado e vice-versa.

8. Se você estiver usando uma VM local ou hospedada na nuvem, ela deve oferecer suporte à virtualização aninhada em sistemas operacionais Windows.

   • Azure - See more
   • AWS - See more

9. Certifique-se de usar o TLS 1.1 ou 1.2.

10. Certifique-se de que as portas a seguir estejam abertas e acessíveis: 543 (padrão), 9999 e 19999.

    Crie uma regra de entrada para cada porta abri-lo: 543, 9999 e 19999.

    

    • Porta 543:

      

    • Porta 9999:

      

    • Porta 19999:

      

11. Instale o Docker com base no seu ambiente.

    Instale o Docker para Windows Server 2019:

    1. Usando o PowerShell, crie a seguinte variável:

       $TMP_WORKDIR="c:\docker"
       

    2. Usando o PowerShell, crie o seguinte diretório:

       New-Item $TMP_WORKDIR -ItemType Directory -force
       

    3. Habilite os seguintes recursos do Windows: Hyper-V e Contêiner. Para fazer isso, siga as seguintes etapas:

       1. Navigate to the Control Panel, then go to Programs.

       2. Click Turning the Windows features on or off.

       3. Select the checkboxes next to Hyper-V in the Server Roles tab and Container in the Features tab.

       4. Reinicie o servidor se necessário.

          

          

    4. You can use PowerShell to download Docker and unzip the Linux Containers to the $TMP_WORKDIR folder, by running the following command:

       Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip"
       

    5. You can use PowerShell to download lcow kernel and unzip the Linux Containers to the $TMP_WORKDIR folder, by running the following command:

       Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"
       

    6. Em seguida, instale o Docker e o lcow:

       Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force
       Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force
       

    7. Então, usando o PowerShell, defina as variáveis de ambiente executando o seguinte comando:

       [Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine)
       [Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine")
       [Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine")
       

    8. Usando o PowerShell, habilite os Recursos Experimentais em daemon.json executando o seguinte comando:

       $configfile = @"
       {
           "experimental": true
       }
       "@
       $configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force
       

    9. Registre o serviço executando o seguinte comando no PowerShell:

       cd $Env:ProgramFiles\docker
       .\dockerd.exe --register-service
       

    10. Por fim, reinicie seu computador executando o seguinte comando no PowerShell:

        Restart-Computer -Force
        

    Instale o Docker em VMs sem espaço:

    Para instalar o Docker em ambientes air-gapped, você precisa realizar duas etapas. Primeiro, baixe os arquivos de instalação para uma VM online, em seguida, copie os arquivos para sua VM offline em que você deseja instalá-lo.

    Requisitos

    • Make sure the offline VM meets the requirements for the Insights Server.
    • A VM online precisa estar executando o Windows Server 2019+ e ter acesso à Internet.

    Como baixar arquivos de instalação do Docker na VM online

    Em sua máquina virtual online, abra o PowerShell como Administrator e execute os seguintes comandos para criar uma nova pasta do Docker.

    # variables
    $TMP_WORKDIR="c:\docker"
    
    # Create tmp_workdir
    New-Item $TMP_WORKDIR -ItemType Directory -force
    
    # Install Hyper-V and Containers
    Install-WindowsFeature Hyper-V
    Install-WindowsFeature containers
    

    Download lcow kernel and unzip the Linux Containers to the $TMP_WORKDIR folder.

    # Get docker
    Invoke-WebRequest -URI "https://download.docker.com/win/static/stable/x86_64/docker-20.10.24.zip" -OutFile "$TMP_WORKDIR\docker-20.10.24.zip"
    
    # Get lcow
    Invoke-WebRequest -Uri "https://github.com/linuxkit/lcow/releases/download/v4.14.35-v0.3.9/release.zip" -UseBasicParsing -OutFile "$TMP_WORKDIR\release.zip"
    

    Como instalar o Docker na VM offline

    Na sua VM offline, abra o PowerShell como administrador e execute os seguintes comandos para instalar o Docker, registrar o serviço e reiniciar a máquina.

    # Install
    Expand-Archive $TMP_WORKDIR\Docker-20.10.24.zip -DestinationPath $Env:ProgramFiles -Force
    Expand-Archive $TMP_WORKDIR\release.zip -DestinationPath "$Env:ProgramFiles\Linux Containers\." -Force
    
    # Add Environment Variables
    [Environment]::SetEnvironmentVariable("PATH", $Env:PATH + ";$Env:ProgramFiles\docker", [EnvironmentVariableTarget]::Machine)
    [Environment]::SetEnvironmentVariable("LCOW_SUPPORTED", "1", "Machine")
    [Environment]::SetEnvironmentVariable("LCOW_API_PLATFORM_IF_OMITTED", "linux", "Machine")
    
    # Enable Experimental Features in Docker daemon.conf
    $configfile = @"
    {
        "experimental": true
    }
    "@
    $configfile|Out-File -FilePath C:\ProgramData\docker\config\daemon.json -Encoding ascii -Force
    
    # Register service
    cd $Env:ProgramFiles\docker
    .\dockerd.exe --register-service
    
    # Restart Computer
    Restart-Computer -Force
    

12. Se você usa o VMWare, certifique-se de usar o VMwareToolboxCmd 11.0.6+. As versões anteriores podem fazer com que o contêiner do Docker seja reiniciado inesperadamente.

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 diferencia minúsculas/maiúsculas (“InsightsDB” = “insightsdb”). Se ele é criado durante o processo de instalação do Insights, ele é automaticamente definido dessa forma. Se não, você deve configurá-lo manualmente para ignorar maiúsculas e minúsculas.

Se você decidir criar seu próprio banco de dados do Insights, precisará definir a sequência de agrupamento como Latin1_General_CI_AS.

Pré-requisitos

Certifique-se de que você tenha os seguintes itens em mão ou que eles tenham sido feitos nas etapas de configuração inicial:

• O nome da máquina do SQL Server.
• O nome da instância, se ela não for a instância padrão.
• A porta do SQL Server está aberta no firewall da máquina do SQL Server.
• 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.

Recomendações

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 .

Métodos de autenticação do SQL Server

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

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, plataforma de análise usada pelo Insights, é executado em um contêiner Linux. Para habilitar a autenticação do Windows, o SQL Server precisa ser compatível com a autenticação através do protocolo Kerberos.

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.

• O Servidor 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 o Servidor do Insights possa resolver os nomes de domínio tanto para o Domínio do AD quanto o SQL Server.

• AD user should exist with access to SQL server and DB permissions as defined in the Permissions section. Domain, username, and password for this user must be provided during the Insights install process. Keep in mind that the username is case sensitive and that this also serves as the sAMAccountName of the user.

  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 servidor 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. Se não estiver, o site não poderá ser iniciado e o Visualizador de Eventos no computador 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. Se não estiver, o site não pode iniciar e o Visualizador de Eventos no computador no qual 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 aFunção de Servidordbcreator ANTES de instalar o Insights, pois o banco de dados é criado durante esse processo de instalação.

If security restrictions do not allow the use of thedbcreator Server Role in the service account, create the empty database in 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 conecta ao banco de dados SQL do Orchestrator a função de mapeamento de usuário db_owner, como na seguinte captura de tela.

Se as restrições de segurança não permitem que você use afunção de mapeamento de usuários db_owner com o login da UiPath, conceda o seguinte:

• db_datareader

• db_datawriter

• db_ddladmin

• EXECUTEpermissão em dboesquema

  

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
  

Insights Installation

Observação:

• Ao atualizar para a versão 2021.10, atualmente, usuários com permissões do Insights não são migrados para a nova versão. Um script para fazer isso será disponibilizado em breve.
• 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. Execute o instalador InsightsInstaller.msi como administrador usando o prompt de comando ou o console do PowerShell.

2. Digite cmd ou powershell, em seguida, clique com o botão direito do mouse no aplicativo e em Executar como administrador.

3. Digite o comando cd <path-to-msi>, onde <path-to-msi> é o local em que seu instalador .msi está localizado. Por exemplo: C:\Users\yourUsername\Downloads>.

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.

   

   Observação:

   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.

   If you would like to specify a different directory, use the command msiexec.exe /i InsightsInstaller.msi /L*V logfilepath. For more details, see the Support page.

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

   

7. Altere as configurações de servidor do Insights da seguinte forma:

   • URL do Servidor do Insights — o nome do host ou a URL do Servidor do Insights.

   • Porta — a porta que você deseja usar para habilitar a comunicação entre o computador e o Insights.

   • Certificado — o Assunto ou Impressão Digital do certificado SSL que você deseja usar para proteger conexões com o Insights.

     

8. Defina as configurações do Orchestrator da seguinte forma:

   • URL do Orchestrator — a URL do Orchestrator

   • Identity Server separado - Se você tiver um Identity Server separado, habilite essa opção.

   • Installation Token - enter the Installation Access Token you generated on Identity Server's Installation Access Token page by logging in as the host tenant. For more details, see Installation Access Token.

     Observação:

     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 tiver uma falha de instalação.

     

9. Defina as configurações de banco de dados do Insights da seguinte forma:

   • Nome do servidor — o nome da máquina do SQL Server em que o banco de dados do Insights está localizado

   • 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:

     Importante:

     You must use the fully-qualified domain name for the database (e.g., mysever.my.domain instead of myserver). Preferably the SQL Server must join the AD domain directly.

     • 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.

       

   • 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 host do SMTP

     • De — o endereço de e-mail do qual enviar mensagens de e-mail. Ele deve corresponder ao fornecido para o Nome de usuário.

     • 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.

       Importante:

       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.

   • 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.

     

     Importante:

     Após a instalação do Insights terminar, não se esqueça de reiniciar o Docker.

Instalação offline

Para a instalação offline, você precisa considerar o seguinte:

• Instale o Docker para Windows Server 2019.
• Tanto o banco de dados do Orchestrator quanto do Insights estão acessíveis.
• Certifique-se de que o servidor de e-mail SMTP esteja acessível, se tiver sido configurado.

Etapas de pós-instalação

Verificação dos serviços do Insights

Observação:

Não remova a pasta C:\Users\yourUsername\_insights.

Acessando o Looker

Para verificar se o Looker está em execução, certifique-se de que o contêiner do Docker esteja ativo.

Após a instalação do Insights terminar, vá até o navegador para confirmar se a instalação foi bem-sucedida.

Como lidar com a vulnerabilidade do log4j

Para lidar com a vulnerabilidade do log4j, certifique-se de executar o hotfix para atualizar as dependências para a versão mais recente não vulnerável do Apache Log4j.

For more information, see the UiPath Insights (version 2021.10+) / Automation Suite Advisory section in UiPath Security Advisory CVE-2021-44228, CVE-2021-45046 & CVE-2021-45105.

Modificando o Insights

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

For more information, see Modifying Insights configurations.

Configuração do tenant

After installing Insights, you must then enable it for your desired tenant(s) from the Orchestrator host portal. For more details, see Enabling or disabling features.

Observação:

There are scenarios where the Orchestrator table dbo.tenants has the key and accountId columns in uppercase values. This typically only happens with older versions of Orchestrator (Orchestrat 18.X or lower).

1. Verifique os logs em %programdata%/UiPath Insights/Provisioning
2. Deve haver um erro sobre o OrchestratorTenantJob falhando.
3. Faça login no banco de dados do Orchestrator usando um cliente sql.
4. Verifique a tabela dbo.Tenants.
5. Verifique se as colunas "Key" e "AccountId" estão todas em letras maiúsculas.
6. Se existirem, usá-las em letras minúsculas corrige o problema.
7. Se houver um tenant que esteja em letras minúsculas, tente habilitar somente esse tenant e veja se o erro ainda ocorre.
8. Para corrigir o problema, altere as maiúsculas/minúsculas dos campos (certifique-se de fazer backup do banco de dados antes. Anote também as KEYs que já estão em letras minúsculas).
   • UPDATE [UiPath].[dbo].[Tenants]
   • set [key] = LOWER([key]), [AccountId] = LOWER([AccountId])
9. Para reverter a alteração, execute
   • UPDATE [UiPath].[dbo].[Tenants]
   • set [key] = UPPER([key]), [AccountId] = UPPER([AccountId])
   • WHERE [key] NOT IN ('xx-xx-xx-xx', 'xx-xx-xx-xx');
10. Talvez seja necessário fazer uma redefinição do IIS (ou apenas reutilizar o pool de aplicativos de provisionamento). O serviço de provisionamento tenta provisionar a instância a cada 10 minutos, portanto, se isso não for feito, aguarde 10 minutos no máximo.
11. Se o problema ainda estiver ocorrendo, abra um tíquete com a UiPath e inclua o seguinte
    • Captura de Tela da tabela dbo.tenants.
    • Os logs de provisionamento mencionados acima.

Artigos relacionados

• Folha de referência da atualização 2021.10
• Atualizando o Insights
• Solução de problemas
• Arquivos de apoio