- Notas de Versão
- Introdução
- Acesso e permissões
- Instalação e atualização
- Interação com o Insights
- Exportação de dados históricos
- Logs
- Desempenho e escalabilidade
Instalação
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.
/tmp
, pois isso pode criar problemas após uma reinicialização. A instalação precisa ser feita em um diretório persistente.
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.
Para instalar o Insights v2024.10 com licença independente, você precisa seguir estes procedimentos na ordem descrita abaixo:
Prepare o(s) Certificado(s) para habilitar o SSL para ambas as máquinas. Para obter mais informações, clique aqui.
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.
Configure duas máquinas que atendam aos requisitos de hardware e software.
- 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
- Inicie o lançamento da instância.
- Selecione a Imagem do Red Hat Enterprise Linux 8Observaçã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.
- Escolha um Tipo de instância e configure os Detalhes da instância.
- Adicione armazenamento à sua instância e altere o Tamanho para
32
. - Revise e inicie a instância
Para obter mais informações, consulte Iniciar instância no AWS.
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
- Navegue até
- 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.
- 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.
/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:
- Open a SSH client in the Linux machine by running the command below:
ssh azureuser@<your-hostname>
ssh azureuser@<your-hostname>Onde<your-hostname>
precisa ser ajustado para refletir o nome do host da sua máquina. - Change to root user by running the command below:
sudo -i
sudo -i - Verifique o tamanho do disco executando o comando abaixo:
lsblk -f
lsblk -fVocê verá que o Ponto de montagem/var
está sob o nomesda2
>rootvg-varlv
. - Verifique o tamanho do
/dev/sda2
executando o comando abaixo:lsblk /dev/sda2
lsblk /dev/sda2Onde/dev/sda2
é recuperado da etapa 3. Você verá agora o tamanho de/var
, que é 8G. - Next, check the available space by running the command below:
vgdisplay rootvg
vgdisplay rootvgVocê verá que o PE gratuito / Tamanho é de aproximadamente 40 GiB.
rootvg-varlv
Aumente o tamanho de executando o comando abaixo:Você pode alterá-lo para+10G
ou um valor diferente que seja menor que o40GB
disponível (o tamanho da memória livre que você consulta na Etapa 5).lvresize -r -L +10G /dev/mapper/rootvg-varlv
lvresize -r -L +10G /dev/mapper/rootvg-varlvObservação: para instalações com air gap, execute o mesmo comando em/home
.- Verifique se o redimensionamento foi bem-sucedido executando o comando abaixo:
lsblk /dev/sda2
lsblk /dev/sda2
/var/lib/docker
).
/home
para garantir espaço suficiente para imagens e pacotes off-line.
Preparando uma máquina Windows para hospedar o serviço Insights
- Configure uma máquina Windows que atenda aos requisitos de hardware e software.
- 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. - 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:
- Abra uma sessão RDP na máquina criada para instalar os pré-requisitos.
- 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
- Recursos HTTP comuns
- Ferramentas de gerenciamento
- Console de Gerenciamento IIS
- Web Server
- Baixe e instale o Pacote de Hospedagem do .NET versão 6.0.7+.
- No PowerShell, execute os seguintes comandos:
net stop was /y ; net start w3svc
net stop was /y ; net start w3svc
- 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.
- Ao especificar um nome de host para o Insights, certifique-se de que o nome de host desejado seja resolvido no seu DNS.
- Certifique-se de usar o TLS 1.1 ou 1.2.
Antes de instalar o Insights, você precisa configurar a instância SQL Server do Insights que você deseja usar.
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.
- 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.
Para mais detalhes sobre como habilitar a autenticação do Kerberos no Servidor SQL, consulte Registro manual do SPN.
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 executeset user
para obter oUSERDNSDOMAIN
eUSERNAME
. - 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>
enslookup <your_SQL_server_domain_name>
na máquina do host.
Como criar um novo login no SQL Server Management Studio
- No painel Explorador de Objetos, navegue até Segurança > Login.
- Clique com o botão direito do mouse na pasta Logins e selecione Novo Login.
- Selecione a opção Autenticação do Windows. A janela é atualizada de acordo.
- No campo Nome de login, digite o domínio de usuário que você deseja usar como uma conta de serviço.
- 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
. - 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.
Como criar usuário SQL no SQL Server Management Studio
- No painel Explorador de Objetos, navegue até Segurança > Login.
- Clique com o botão direito do mouse na pasta Logins e selecione Novo Login. A janela Login — Novo será exibida.
- Selecione a opção autenticação do SQL Server. A janela é atualizada de acordo.
- Preencha os campos Nome do login, Senha e Confirmar senha adequadamente.
- 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.
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.
db_owner
de mapeamento de usuário, como demonstrado na captura de tela a seguir:
EXECUTE
permissão deve ser concedida usando o GRANT EXECUTE
comando 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
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
USE UiPath Insights GO GRANT EXECUTE ON SCHEMA::dbo TO [sql_user] GOObservaçã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 .
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.
-insightsFeatureEnabled
.
- 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.
Siga o procedimento para inicializar o Looker na máquina Linux do Insights.
Como alternativa, você pode usar o script de implantação:
- Execute a a ferramenta LookerPreinstallationTool.exe para gerar um arquivo ZIP para Looker: Isso gerará arquivos Looker na máquina Windows do Insights.
- 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 comLookerPreinstallationTool.exe
versão 2023.4.0.Para informações detalhadas, consulte o Script de implantação automatizada.
- 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.
- Siga as etapas iniciais para gerar o arquivo ZIP.
- 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).
- 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 .
- (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.
- (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. - (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.
- 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.
Copie o arquivo ZIP para a máquina Linux do Insights.
- Autentique-se em sua máquina Linux do Insights.
- 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>:~/
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.
- Abra o Powershell e execute o comando abaixo para autenticar:
ssh <username@hostname>
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. - Gere a chave GPG usando o comando abaixo:
gpg --generate-key
gpg --generate-keyObservaçã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 executarlooker-initialization.sh
.
- Descompacte os arquivos do Looker Arquivos executando o comando abaixo:
unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directory
unzip <Insights_Lookerfiles_timestamp.zip> -d <installation directoryO 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.
- Execute o script de inicialização do Looker executando o comando abaixo:
cd <installation directory> bash insights/looker-initialization.sh -k <Public Key>
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 comandogpg --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 erroModule 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.
- Saia do Powershell e baixe
looker.json
executando o comando a seguirscp <username@hostname>:~/insights/looker.json <path-to-save-json>
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 usarcat /home/user/insights/looker.json
para copiar o conteúdo e criar um arquivo na máquina Insights Windows chamadolooker.json
no diretório de implantação e, em seguida, colar o conteúdo copiado.
$HOME/_insights
. Não exclua esse arquivo, ele será necessário para para futuras atualizações.
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.
use master
go
GRANT ALTER ANY CONNECTION TO sqladmin
use master
go
GRANT ALTER ANY CONNECTION TO sqladmin
- 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.
-
Baixe o
InsightsInstaller.msi
do Customer Portal, selecionando sua versão. - Execute o instalador como administrador usando o prompt de comando ou o console do PowerShell.
- Navegue até o diretório onde o instalador do
.msi
está localizado. - Execute o instalador do Insights usando o seguinte comando:
msiexec /i InsightsInstaller.msi
msiexec /i InsightsInstaller.msiComo alternativa, você pode usar o seguinte comando:
.\InsightsInstaller.msi
.\InsightsInstaller.msi - 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 oMSI{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
msiexec -I "InsightsInstaller.msi" -L*V c:\logs\interactive.log - Aceite o Contrato de Licença e clique em Avançar.
- 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.
- 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.
- 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.
- 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 demyserver
). 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.
- 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 (
- 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
- Configurar serviço de e-mail (SMTP) — marque para configurar o serviço de e-mail
- 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.
Para migrar tabelas de trabalhos, use as etapas abaixo.
- 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;
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; - 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 )
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 ) - 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);
truncate table [read].[QueueItemEvents]; truncate table [read].[QueueItems]; truncate table [read].[Jobs]; truncate table [read].[JobEvents]; delete [dbo].[IngestionMarkers] where [IngestionEventType] in (9002, 9001);
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).
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.
- Abra um navegador web suportado
- Navegue até
https://hostname:443/Insights
para confirmar que a instalação do Insights foi bem-sucedida.
Mantenha o arquivo de instalação original caso queira modificar ou desinstalá-lo.
Para obter mais informações, consulte Modificando configurações do Insights.
- 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.
- 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
UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json /Q - 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. - Verifique se o arquivo UiPath.Orchestrator.dll. é idêntico em todos os nós após a substituição.
- Visão geral
- Preparar a máquina Windows e a máquina Linux do Insights
- Etapa 1
- Etapa 2
- Configuração do SQL Server
- Instalar o Orchestrator e habilitar a funcionalidade do Insights
- Inicializar o Looker na máquina Linux do Insights
- Gerar arquivos do Looker na máquina Windows do Insights
- Copiar os arquivos do Looker para a máquina Linux do Insights
- Inicializar o Looker
- Instalação do Insights
- Etapas de pós-instalação
- Migrar tabelas
- Garantir o licenciamento adequado
- Habilitar Tenants
- Verificação dos serviços do Insights
- Modificando o Insights
- Ativar Insights de nó único no Orchestrator de vários nós existente
- Artigos relacionados