Instalação ou atualização de um Agente do Robôs local

O Agente do Robôs executa as tarefas agendadas no aplicativo Robôs. O agente executa as tarefas no Windows Server local seguro da sua empresa, perto da fonte de dados e dentro dos limites de proteção de sua rede.

Observação

As informações neste tópico se aplicam apenas a organizações que usam um Agente do Robôs local para executar scripts ACL em robôs ACL.

Indivíduos e organizações com o ACL Robotics Professional Edition não têm um Agente do Robôs local. Os scripts Python/HCL executados em robôs HighBond e de fluxo de trabalho não usam o Agente do Robôs.

Informações gerais

Baixe o pacote de instalação do Agente do Robôs e use-o para instalar o agente em um servidor Windows. Você também pode usar o pacote de instalação para atualizar um Agente do Robôs existente no servidor.

Arquivos de chave

Durante a instalação, você registra o Agente do Robôs usando um arquivo de chave de registro (registration.key). Você gera o arquivo de chave no aplicativo Robôs e o baixa no servidor do Windows em que o Agente do Robôs foi instalado.

O arquivo de chave de registro autentica a primeira conexão entre o Agente do Robôs e o aplicativo Robôs. As conexões posteriores e os fluxos de dados são protegidos por chaves de criptografia (um par de chaves RSA públicas-privadas). O par de chaves RSA é gerado automaticamente quando você inicia o serviço do Agente do Robôs.

O arquivo de chave de registro e as chaves de criptografia são objetos separados usados em diferentes etapas do processo de registro e conexão.

Se você estiver atualizando o Agente do Robôs, o arquivo de chave de registro não será envolvido. Não gere uma nova instância de registration.key.

Vários agentes

Para aumentar a capacidade de processamento de análise e implementar o balanceamento de carga, você tem a opção de instalar instâncias adicionais do Agente do Robôs em servidores do Windows adicionais.

Serviços e contas do Agente do Robôs para Windows

Quando você instala o Agente do Robôs, ele implanta dois serviços do Windows no servidor:

  • O Agente do Robôs executa tarefas agendadas e ad hoc do Robôs
  • O Serviço de Dados do Robôs fornece a conectividade que permite aos usuários abrir as tabelas do Agente do Robôs no Analytics

Se um desses serviços não estiver em execução, a funcionalidade que eles fornecem não estará disponível.

Dica

Se as tarefas permanecerem na fila por muito tempo no Robôs e depois falharem ou forem ignoradas, verifique se o serviço do Agente do Robôs está em execução.

Se os usuários receberem um erro de conexão ao tentar abrir uma tabela do Agente do Robôs no Analytics, verifique se o Serviço de Dados do Robôs está em execução.

Contas e portas de serviço

Use contas de serviço para executar os dois serviços do Windows do Agente do Robôs. Para obter mais informações sobre os direitos e permissões de login exigidos pelas contas, consulte Segurança do Agente do Robôs local.

Observação

Se você alterar as propriedades de qualquer um dos serviços do Windows depois de instalar o Agente do Robôs, deverá reiniciar o serviço para que a alteração entre em vigor.

Serviço do Windows Conta que executa o serviço Porta
Serviço Agente do Robôs

Conta de domínio especificada durante a instalação ou pós-instalação

 Somente comunicação de saída 443
Serviço de dados do Robôs Sistema local 10000 por padrão, configurável durante e após a instalação

Verifique se o Agente do Robôs pode se conectar à autoridade de certificação

O Agente do Robôs usa um certificado digital para validar sua autenticidade e integridade. O certificado exige uma conexão de Internet com a DigiCert, autoridade de certificação externa, para que possa ser verificado. Se você estiver instalando o Agente do Robôs atrás de um firewall de rede, o firewall deverá ser configurado para permitir que o certificado se conecte à DigiCert. Sem a conexão necessária, o Agente do Robôs não funcionará.

Se for preciso, trabalhe com o departamento de TI da sua organização para configurar um firewall de rede ou um servidor proxy e permitir a conexão entre o certificado e a DigiCert. O certificado digital no Agente do Robôs usa os URLs a seguir para se conectar à lista de certificados revogados e ao servidor OCSP da DigiCert:

  • http://cacerts.digicert.com
  • http://crl3.digicert.com
  • http://crl4.digicert.com
  • http://ocsp.digicert.com

Para obter mais informações sobre os URLs, inspecione o certificado instalado.

Inspecione o certificado instalado

Após instalar o Agente do Robôs, inspecione o certificado instalado para ver os URLs da autoridade de certificação.

  1. No diretório de instalação do Agente do Robôs, clique com o botão direito em Agent.exe e selecione Propriedades.

    O diretório de instalação padrão é: C:\Arquivo de Programas (x86)\ACL Software\Robots Agent\agent

  2. Na caixa de diálogo Propriedades de Agent.exe, selecione a guia Assinaturas digitais.

  3. Na Lista de Assinaturas, clique duas vezes em Diligent Corporation e depois em Exibir Certificado.

  4. Na guia Detalhes na caixa de diálogo Certificado, selecione cada um destes campos:

    • Pontos de distribuição da lista de certificados revogados

    • Acesso às informações da autoridade

    Para cada campo, os URLs aparecem na área de exibição na parte inferior da caixa de diálogo.

  5. Na guia Caminho de Certificação na caixa de diálogo Certificado, faça o seguinte:

    1. Selecione cada uma destas entradas de caminho de certificação:

      • Raiz confiável G4 DigiCert

      • Assinatura de código da raiz confiável G4 DigiCert…

    2. Para cada entrada, clique em Exibir Certificado.

    3. Na guia Detalhes, selecione cada um destes campos:

      • Acesso às informações da autoridade

      • Pontos de distribuição da lista de certificados revogados

      Para cada campo, os URLs aparecem na área de exibição na parte inferior da caixa de diálogo.

Gerar o arquivo de chave de registro do Agente do Robôs

Se você for um cliente novo instalando o Agente do Robôs pela primeira vez, será necessário gerar um arquivo de chave de registro (registration.key). O arquivo de chave de registro autentica a primeira conexão entre o Agente do Robôs e o aplicativo Robôs.

Se você for um cliente existente e já tiver um Agente do Robôs instalado e em uso, em muitos casos, não será necessário gerar um novo arquivo de chave de registro. Muitas vezes, gerar um novo arquivo é desnecessário e pode interferir na configuração da instância do Robôs da sua organização.

Status do Agente do Robôs Gerar um arquivo de chave de registro
Nova instalação do Agente do Robôs, instalação de agente único Sim
Nova instalação de uma instância adicional do Agente do Robôs em um cluster de vários agentes

Não

Copiar o arquivo de chave de registro existente

Para obter mais informações, consulte Instalar uma instância adicional do Agente do Robôs.
Atualização de um Agente do Robôs instalado atualmente

Não

O arquivo de chave de registro não está envolvido na atualização
Problema com um arquivo de chave de registro existente, o Agente do Robôs não consegue se conectar ao aplicativo Robôs Sim
Troca da conta do Windows que está executando um Agente do Robôs instalado atualmente

Não

O arquivo de chave de registro não está envolvido na troca de conta

Para obter mais informações, consulte Alterar a conta de serviço do Agente do Robôs.

Observação

Você deve ter a permissão Gerenciar Agente para gerar um arquivo de chave de registro do Agente do Robôs. Para obter mais informações, consulte Permissões do aplicativo Robôs.

  1. Na página inicial do Launchpad (www.highbond.com), selecione o aplicativo Robôs para abri-lo.

    Se já tiver entrado na Diligent One, você pode usar o menu de navegação à esquerda para mudar para o aplicativo Robôs.

  2. Clique em Configurações no canto superior direito do painel.

  3. No painel esquerdo, certifique-se de que Gerenciamento de agente está selecionado.

  4. Se a sua instância do Robôs usar um Agente do Robôs na nuvem atualmente, faça o seguinte:

    1. Clique em Substituir agente em nuvem.

    2. Clique em Registrar agente e gerar chave.

  5. Se a sua instância do Robôs usar um Agente do Robôs local ou não tiver um Agente do Robôs especificado no momento, faça o seguinte:

    1. Clique em Gerar nova chave de registro.

      A caixa de diálogo de aviso que aparece se aplicará quando você tiver um ou mais agentes locais já instalados.

    2. Clique em Gerar nova chave de registro.

  6. Clique em Baixar o arquivo de chave e fechar.

    Cuidado

    Não feche a janela do navegador antes de baixar o arquivo de chaves.

  7. Salve o arquivo de chave baixado em um local seguro no servidor Windows que abrigará o Agente do Robôs.

    Observação

    A geração de um arquivo de chave é a primeira parte do registro de um Agente do Robôs. O processo de registro está concluído quando você coloca o arquivo de chave no local correto na estrutura do diretório do Agente do Robôs, inicia ou reinicia o serviço do Agente do Robôs e conecta-se com sucesso ao aplicativo Robôs.

Instale o Agente do Robôs

Use o pacote de instalação do Agente do Robôs para executar uma nova instalação do Agente do Robôs.

Observação

Você precisa ter permissões locais de administrador no servidor Windows para concluir a instalação.

Se você está usando contas do Windows diferentes para instalar o Agente do Robôs e executar o serviço do Agente do Robôs, é necessário ter a senha para a conta de serviço do Agente do Robôs antes de começar a instalação.

Baixe o pacote de instalação

  1. Baixe o pacote de instalação do Agente do Robôs (RobotsAgent18.exe) do Launchpad:

    1. Na página inicial do Launchpad (www.highbond.com), selecione o aplicativo Analytics para acessar os downloads.

    2. No menu superior, clique em Agente do Robôs.

    3. Clique em Baixar versão 18.

  2. Com o pacote de instalação baixado em seu servidor Windows, clique duas vezes no pacote de instalação.

  3. Se uma caixa de diálogo de aviso de segurança for exibida, verifique as informações listadas e clique em Sim.

    Dica

    A caixa de diálogo do alerta de segurança pode estar oculta atrás das janelas que estão abertas.

Extrair e executar o instalador

  1. Selecione o idioma que deseja usar na instalação e clique em OK.

  2. Na página Local de descompactação da instalação, especifique a pasta onde os arquivos de instalação serão extraídos e clique em Extrair.

    Clique em Procurar para selecionar uma pasta ou aceite o local padrão:

    C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent18

    Os arquivos de instalação são extraídos na pasta de destino especificada. Após os arquivos serem extraídos, o instalador será iniciado automaticamente.

    Observação

    Se o instalador não iniciar automaticamente por algum motivo desconhecido, utilize o Windows Explorer para navegar até a pasta onde os arquivos de instalação foram extraídos e clique duas vezes em setup.exe.

Instale os prerrequisitos, se necessário

Se for solicitada a instalação de pré-requisitos, clique em Instalar.

Após a instalação dos pré-requisitos, o instalador continua automaticamente.

Para obter uma lista dos prerrequisitos, consulte Requisitos do sistema do Agente do Robôs Local.

Configurar as propriedades de instalação

  1. Na página Bem-vindo, clique em Avançar.

  2. Na página Contrato de licença, selecione Eu aceito os termos acima e clique em Avançar.

  3. Na página Seleção da Edição do Agente do Robôs, selecione a edição que você deseja instalar e clique em Avançar:

    • Não Unicode

    • Unicode

    Cuidado

    Verifique se a edição instalada é a edição correta para a sua empresa. Para abrir as tabelas do Agente do Robôs no Analytics, as edições devem coincidir.

    Se você estiver configurando um cluster de vários agentes, todos os agentes no cluster devem ter a mesma edição. Todos não Unicode ou todos Unicode.

    Para obter mais informações, consulte Produtos Unicode da Diligent.

  4. Na página Ativar aprendizado de máquina, deixe a opção Habilitar selecionada, a menos que tenha um motivo para não instalar o mecanismo Python, e clique em Avançar.

    Observação

    Se optar por não instalar o mecanismo do Python e depois quiser usá-lo para executar comandos de aprendizado de máquina, você deverá desinstalar e reinstalar o Agente do Robôs.

  5. Na página Configurações de Serviços do Agente do Robôs, conclua as seguintes configurações da conta de serviço e clique em Avançar:

    • Número da porta do serviço de dados do Robôs Especifique uma porta para o serviço de dados ou use o padrão 10000.

      Você pode especificar qualquer porta disponível entre 0 e 65536.

    • Conta do serviço de agente do Robôs Especifique uma conta de domínio existente para executar o serviço do Agente do Robôs e forneça a senha.

      A conta deve ser uma conta de domínio, especificada usando o formulário Domínio\conta_serviço. A conta requer permissão de execução de serviços no Windows Server bem como acesso total à pasta de dados que você especificar durante a instalação. Para obter mais informações, consulte Segurança do Agente do Robôs local.

      Observação

      Se necessário, você pode trocar a conta de serviço do Agente do Robôs após a instalação.

  6. Caso precise conceder a permissão Fazer logon como um serviço para a conta de serviço do Agente do Robôs, clique em Sim e em OK.

  7. Na página Pastas de Destino, conclua as seguintes configurações de destino e conexão, depois clique em Avançar:

    • Pastas de Destino do Agente do Robôs

      • Selecione uma pasta de destino para a instalação do Agente do Robôs ou use o local padrão.

        Padrão: C:\Program Files (x86)\ACL Software\Robots Agent\

      • Selecione um local de pasta de dados ou use a localização padrão.

        Padrão: C:\acl\robots\

        Observação

        Não coloque a pasta de dados dentro da pasta de destino da instalação ou vice-versa. Isso pode causar perda de dados ao desinstalar o Agente do Robôs.

    • Localização de arquivo de registro do Agente do Robôs

      • Selecione Copiar arquivo de registro e navegue para o local onde salvou o arquivo registration.key ou insira o caminho do arquivo manualmente.

        Quando o instalador for executado, copiará automaticamente o arquivo de chave para o local correto na estrutura de diretórios do Agente do Robôs.

        Observação

        Desmarque a opção Copiar arquivo de registro e não especifique um arquivo de registro caso planeje alterar a conta de serviço do Agente do Robôs depois de instalá-lo.

Concluir a instalação

  1. Na página Pronto para instalar o programa, clique em Instalar.

    O Agente do Robôs é instalado.

  2. Se um aviso que oferece a opção de instalar o Mecanismo de banco de dados do Microsoft Access for exibido, siga um destes procedimentos:

    • Clique em "Sim" para instalar o mecanismo de banco de dados caso você precise que o Agente do Robôs importe ou exporte dados usando arquivos antigos do Excel (*.xls) ou arquivos do Microsoft Access (*.mdb).

    • Clique em "Não" para excluir o mecanismo de banco de dados caso você use o Agente do Robôs apenas com a geração atual de arquivos do Excel (*.xlsx) e não utilize arquivos antigos do programa nem arquivos do Microsoft Access. O mecanismo de banco de dados pode causar problemas de compatibilidade com outros produtos Microsoft Office mais recentes. Por esse motivo, exclua o mecanismo de banco de dados, a menos que você realmente precise dele.

  3. Quando o processo de instalação estiver concluído, clique em Finalizar.

Confirmar se o serviço do Agente do Robôs está em execução

O serviço do Agente do Robôs precisa estar em execução para o Agente do Robôs se conectar ao aplicativo Robôs. Sem uma conexão, o Agente do Robôs não pode processar tarefas e scripts do robô.

Se necessário, você pode trocar a conta de serviço do Agente do Robôs ao mesmo tempo que confirma se o serviço do Agente do Robôs está em execução.

Usar a conta de serviço do Agente do Robôs que você especificou durante a instalação

  1. Abra o gerenciador de Serviços do Windows.

  2. Verifique se os serviços do Windows do Agente do Robôs estão em execução:

    • Agente do Robôs

    • Serviço de dados do Robôs

    Se necessário, inicie um ou os dois serviços.

    Observação

    Se aparecer uma mensagem de erro que diga que o serviço do Agente do Robôs começou e depois parou, o registro do Agente do Robôs pode não ter sido concluído com sucesso.

    Verifique se o arquivo de chave de registro (registration.key) está presente no diretório de instalação do Agente do Robôs. Se o arquivo de chave de registro não estiver presente, copie manualmente o arquivo de chave do local onde o salvou no diretório de instalação. Tente iniciar o serviço do Agente do Robôs novamente.

    O diretório de instalação padrão é: C:\Arquivo de Programas (x86)\ACL Software\Robots Agent\agent

  3. Verifique o arquivo de log de aplicativos para confirmar se o Agente do Robôs foi conectado ao aplicativo Robôs.

    Vá até o final do arquivo de log e procure uma entrada INFO|Connected com data e hora que correspondam ao início do serviço do Agente do Robôs.

    A localização padrão do arquivo de log é: C:\acl\robots\logs\application.log

  4. No aplicativo Robôs, vá para a tela de Gerenciamento de agente e pressione F5 para recarregar a página.

    Se o Agente do Robôs aparecer com o status On-line, ele foi registrado com sucesso.

Alterar a conta de serviço do Agente do Robôs

Siga estas etapas se você desmarcou Copiar arquivo de registro durante a instalação do Agente do Robôs e deseja trocar a conta de serviço do Agente do Robôs.

Instale manualmente o arquivo de chaves de registro

  1. Copie o arquivo de chave de registro (registration.key) do local onde o salvou.

  2. Navegue até o diretório de instalação do Agente do Robôs e cole o arquivo de chave de registro na subpasta agente.

    O diretório de instalação padrão é: C:\Arquivo de Programas (x86)\ACL Software\Robots Agent\agent

    Se necessário, exclua ou substitua um arquivo de chaves existente.

Trocar o serviço do Agente do Robôs para uma conta diferente

  1. Abra o gerenciador de Serviços do Windows.

  2. Clique com o botão direito do mouse no Agente do Robôs e selecione Propriedades.

  3. Na guia Fazer login, clique em Procurar.

  4. Na caixa de diálogo Selecionar usuário, no campo Insira o nome do objeto para selecionar, insira o nome da conta de serviço que deseja usar e clique em Verificar nomes.

    A conta de serviço deve ser preenchida automaticamente no campo.

  5. Clique em OK.

  6. Na guia Fazer login, insira e confirme a senha da conta de serviço e clique em OK.

  7. No gerenciador de Serviços do Windows, reinicie (ou inicie) o serviço do Agente do Robôs.

  8. Se necessário, inicie o Serviço de Dados do Robôs.

Confirmar se o Agente do Robôs foi registrado com êxito

  1. Verifique o arquivo de log de aplicativos para confirmar se o Agente do Robôs foi conectado ao aplicativo Robôs.

    Vá até o final do arquivo de log e procure uma entrada INFO|Connected com data e hora que correspondam ao início do serviço do Agente do Robôs.

    A localização padrão do arquivo de log é: C:\acl\robots\logs\application.log

  2. No aplicativo Robôs, vá para a tela de Gerenciamento de agente e pressione F5 para recarregar a página.

    Se o Agente do Robôs aparecer com o status On-line, ele foi registrado com sucesso.

Definir as configurações do Agente do Robôs no aplicativo Robôs

Se apropriado para sua organização, atualize os valores padrão no aplicativo Robôs para duas definições de configuração do Agente do Robôs:

  • A opção Carregamentos de arquivos permitidos controla se os resultados de saída são enviados do Agente do Robôs para o aplicativo Robôs na nuvem

  • A Configuração de caminhos especifica o servidor do Windows ou os diretórios de rede para tabelas de dados do Analytics e tabelas de resultados

Para obter mais informações, consulte Configuração de um Agente do Robôs local.

Testar o Agente do Robôs

Depois de instalar o Agente do Robôs, é possível enviar e executar um script simples para testar se o Agente do Robôs está funcionando corretamente.

Observação

Este teste requer que sejam permitidos uploads de arquivos para o Robôs. Se necessário, habilite temporariamente os uploads de arquivos para o teste. Para obter mais informações, consulte Configuração de um Agente do Robôs local.

Criar um projeto no Analytics e baixar o arquivo de teste

  1. Crie um novo projeto no Analytics chamado teste Agente do Robôs.acl.

  2. Clique com o botão direito do mouse no link abaixo e salve o arquivo na mesma pasta do projeto que criou:

    Robots_Agent_test_file.txt

Copie o script de teste

  1. No projeto do Analytics, crie um novo script chamado script_teste Agente_do_Robôs.

  2. Clique no link abaixo para abrir o script de teste em um navegador:

    Robots_Agent_test_script.txt

  3. Pressione Ctrl+A para selecionar o script inteiro e Ctrl+C para copiá-lo para a área de transferência.

  4. Cole o script no script_teste_Agente_do_Robôs e clique em Salvar o Projeto Aberto .

Confirme e envie o script para o Robôs para criar um robô rapidamente

  1. No menu principal do Analytics, selecione Arquivo > Confirmar e enviar scripts.

  2. Se necessário, na caixa de diálogo Selecionar destino, clique duas vezes na instância do Diligent One adequada.

    A Coleção de robôs é exibida, com a lista de robôs existentes, se já houver algum. Um robô é um contêiner para scripts, dados e tarefas automatizadas.

  3. Digite Robô de Teste no campo Novo Robô e clique em Criar.

    O robô é criado e um ID de robô é gerado automaticamente.

  4. Na caixa de diálogo Confirmar e Enviar Scripts, digite uma mensagem de confirmação e envio como "Carregar script de teste" e clique em OK.

    O script é enviado para o Robôs e localizado no robô que acabou de criar.

  5. Na caixa de diálogo Scripts confirmados com sucesso, clique no segundo link.

    Resultado O aplicativo Robôs é aberto em uma janela do navegador com a guia Versões do Script selecionada. Pode ser necessário fazer login no Diligent One. Você deve ver a versão do script que acabou de enviar.

  6. No Analytics, clique em OK para sair da caixa de diálogo Scripts confirmados com sucesso.

Carregar arquivo de teste

  1. Selecione a guia Entrada/Saída.

  2. Clique em Escolher no seu computador e vá para o local onde salvou Arquivo_teste_Agente_do_Robôs.txt.

  3. Selecione o arquivo e clique em Abrir.

    Resultado O arquivo é enviado e aparece em Arquivos na guia Entrada/Saída.

Crie uma tarefa e execute o script de texto

  1. Selecione a guia Tarefas e clique em Criar tarefa.

  2. Digite o nome Tarefa de Teste para a tarefa e clique em Salvar.

  3. Selecione o script de teste do Agente do Robôs e clique em Ignorar até o fim > Confirmar e criar tarefa.

  4. Na guia Tarefas, na Tarefa de Teste, clique em > Executar agora.

    Resultado A tarefa com o script de teste é executada.

    Se a tarefa for concluída com um status de Sucesso, o Agente do Robôs local instalado está funcionando corretamente.

    Observação

    Se a tarefa falhar, verifique se o serviço do Windows do Agente do Robôs está funcionando no servidor onde você instalou o Agente do Robôs. Inicie o serviço se não estiver em execução e tente executar a Tarefa de Teste novamente.

    Se a tarefa continuar a falhar, entre em contato com o Suporte da Diligent para obter ajuda.

Verificar a saída do script

Verifique os seguintes locais no Robôs para ter certeza de que o script de teste gera os arquivos corretos.

Localização no Robôs Saída de arquivos por script de teste

Guia Execuções de tarefas

Selecione a entrada Tarefa de Teste.

No painel lateral Detalhes da execução da tarefa, em Saída:

  • Tabela_metadados Tabela de resultados do Analytics

  • Script de teste do Agente do Robôs.log Arquivo de log do Analytics

Guia de Entrada/Saída

Selecione a entrada arquivo_teste_Agente_do_Robôs.

Na seção Outras tabelas:

  • arquivo_teste_Agente_do_Robôs Tabela de dados do Analytics

Selecione arquivo_teste_Agente_do_Robôs. No painel lateral Detalhes da tabela, em Campos:

Você deve ver informações de Nome, Tipo e Tamanho (comprimento) para três campos:

  • Campo_de_caractere

  • Campo_numérico

  • Campo_de_datahora

Fazer upgrade do Agente do Robôs

Use o pacote de instalação do Agente do Robôs para atualizar uma instalação existente do Agente do Robôs para a versão 18.0.

Antes de fazer a atualização, certifique-se de que não há tarefas do robô em execução, na fila ou agendadas para execução próxima.

Observação

Você precisa ter permissões locais de administrador no servidor Windows para concluir a atualização.

Interromper os serviços do Windows do Agente do Robôs

  1. No servidor Windows onde o Agente do Robôs está localizado, abra o Gerenciador de Serviços do Windows.

  2. Interrompa os dois serviços do Windows para o Agente do Robôs:

    • Agente do Robôs

    • Serviço de dados do Robôs

Baixe o pacote de instalação

  1. Baixe o pacote de instalação do Agente do Robôs (RobotsAgent18.exe) do Launchpad:

    1. Na página inicial do Launchpad (www.highbond.com), selecione o aplicativo Analytics para acessar os downloads.

    2. No menu superior, clique em Agente do Robôs.

    3. Clique em Baixar versão 18.

  2. Com o pacote de instalação baixado no servidor Windows, clique duas vezes no pacote de instalação.

  3. Se uma caixa de diálogo de aviso de segurança for exibida, verifique as informações listadas e clique em Sim.

    Dica

    A caixa de diálogo do alerta de segurança pode estar oculta atrás das janelas que estão abertas.

Extrair e executar o instalador

  1. Selecione o idioma que deseja usar na instalação e clique em OK.

  2. Na página Local de descompactação da instalação, especifique a pasta onde os arquivos de instalação serão extraídos e clique em Extrair.

    Clique em Procurar para selecionar uma pasta ou aceite o local padrão:

    C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent18

    Os arquivos de instalação são extraídos na pasta de destino especificada. Após os arquivos serem extraídos, o instalador será iniciado automaticamente.

    Observação

    Se o instalador não iniciar automaticamente por algum motivo desconhecido, utilize o Windows Explorer para navegar até a pasta onde os arquivos de instalação foram extraídos e clique duas vezes em setup.exe.

  3. Clique em Sim no prompt do upgrade.

  4. Na caixa de diálogo Informações do instalador do Agente do Robôs, clique em OK somente se você cumprir os requisitos listados.

    Se ainda não cumprir os requisitos, faça isso agora antes de continuar com a atualização. Se necessário, desabilite temporariamente qualquer tarefa do robô agendada para execução em breve.

Instale os prerrequisitos, se necessário

Se for solicitada a instalação de pré-requisitos, clique em Instalar.

Após a instalação dos pré-requisitos, o instalador continua automaticamente.

Para obter uma lista dos prerrequisitos, consulte Requisitos do sistema do Agente do Robôs Local.

Configurar as propriedades de instalação

  1. Na página Bem-vindo, clique em Avançar.

  2. Na página Contrato de licença, selecione Eu aceito os termos acima e clique em Avançar.

  3. Na página Seleção da Edição do Agente do Robôs e clique em Avançar.

    O instalador impõe a edição do Agente do Robôs que você tem instalada no momento (não Unicode ou Unicode).

    Observação

    Não é possível mudar a edição durante uma atualização. Para mudar a edição, você precisa desinstalar a versão atual do Agente do Robôs e instalar a versão 18.0.

  4. Na página Conectores de dados opcionais do Analytics, deixe a opção Instalar selecionada, a menos que tenha um motivo para não instalar os conectores opcionais, e clique em Avançar.

    Observação

    Se optar por não instalar os conectores opcionais e depois quiser usar um deles, você deverá desinstalar e reinstalar o Agente do Robôs.

  5. Na página Ativar aprendizado de máquina, deixe a opção Habilitar selecionada, a menos que tenha um motivo para não instalar o mecanismo Python, e clique em Avançar.

    Observação

    Se optar por não instalar o mecanismo do Python e depois quiser usá-lo para executar comandos de aprendizado de máquina, você deverá desinstalar e reinstalar o Agente do Robôs.

  6. Na página Configurações de Serviços do Agente do Robôs, conclua as seguintes configurações da conta de serviço e clique em Avançar:

    • Número da porta do Serviço de Dados do Robôs Mantenha a porta existente especificada para o serviço de dados ou especifique uma porta diferente.

      Você pode especificar qualquer porta disponível entre 0 e 65536.

    • Conta do serviço de agente do Robôs Mantenha a conta de domínio existente que executa o serviço do Agente do Robôs ou especifique uma conta diferente. Forneça a senha da conta.

      A conta deve ser uma conta de domínio, especificada usando o formulário Domínio\conta_serviço. A conta requer permissão de execução de serviços no Windows Server bem como acesso total à pasta de dados do Agente do Robôs existente. Para obter mais informações, consulte Segurança do Agente do Robôs local.

      Observação

      Se você precisa trocar a conta de serviço do Agente do Robôs, uma opção melhor é trocá-la após a atualização.

      Se você alterar a conta no instalador durante a atualização, será necessário registrar novamente o Agente do Robôs. Registrar novamente um agente instalado pode interferir na configuração da instância do Robôs da sua organização.

      Para obter mais informações, consulte Alterar a conta de serviço do Agente do Robôs.

  7. Revise as informações de configuração na próxima tela e clique em Avançar.

Concluir a atualização

  1. Na página Pronto para instalar o programa, clique em Instalar.

    O Agente do Robôs é atualizado.

  2. Se um aviso que oferece a opção de instalar o Mecanismo de banco de dados do Microsoft Access for exibido, siga um destes procedimentos:

    • Clique em "Sim" para instalar o mecanismo de banco de dados caso você precise que o Agente do Robôs importe ou exporte dados usando arquivos antigos do Excel (*.xls) ou arquivos do Microsoft Access (*.mdb).

    • Clique em "Não" para excluir o mecanismo de banco de dados caso você use o Agente do Robôs apenas com a geração atual de arquivos do Excel (*.xlsx) e não utilize arquivos antigos do programa nem arquivos do Microsoft Access. O mecanismo de banco de dados pode causar problemas de compatibilidade com outros produtos Microsoft Office mais recentes. Por esse motivo, exclua o mecanismo de banco de dados, a menos que você realmente precise dele.

  3. Quando o processo de atualização estiver completo, clique em Concluir.

  4. Clique em Sim para reiniciar o servidor e concluir a atualização.

  5. No gerenciador de serviços do Windows, verifique se os dois serviços do Windows do Agente do Robôs estão sendo executados:

    • Agente do Robôs

    • Serviço de dados do Robôs

    Se necessário, inicie um ou os dois serviços.

Instalar uma instância adicional do Agente do Robôs

Use o pacote de instalação do Agente do Robôs para instalar instâncias adicionais do Agente do Robôs em servidores do Windows adicionais.

A instalação de vários agentes permite aumentar a capacidade de processamento de análise e implementar o balanceamento de carga entre os agentes. Quando você executa várias tarefas de robô simultaneamente, o processamento dos scripts de análise é automaticamente distribuído entre os vários agentes em vários servidores Windows. Esse recurso permite que você execute um número maior de tarefas em um período mais curto.

Observação

A capacidade de múltiplos agentes não está relacionada aos modos de desenvolvimento e produção no Robôs. Ao executar tarefas, ambos os modos têm acesso igual a todos os agentes.

Importante

A instalação de vários agentes requer que todos os agentes tenham a versão 15 ou superior e que todos usem a mesma codificação: todos não Unicode ou todos Unicode.

Além disso, todos os agentes precisam ter acesso ao diretório ou diretórios especificados para tabelas de saída de script na tela Gerenciamento de agente. Para cada diretório especificado, a conta de serviço que executa o agente deve ter permissões de leitura/gravação/listagem. Para obter mais informações, consulte Configuração de um Agente do Robôs local.

Observação

Você deve ter permissões locais de administrador em cada servidor Windows no qual o Agente do Robôs for instalado.

Estas instruções referem-se ao Servidor nº 1 e Servidor nº 2:

  • Servidor nº 1 O servidor do Windows no qual você instalou a primeira instância do Agente do Robôs

  • Servidor nº. 2 Um servidor do Windows adicional no qual você instala uma instância adicional do Agente do Robôs

    Observação

    Você pode repetir o processo para quantos agentes e servidores adicionais precisar.

Instalar o Agente do Robôs no Servidor nº 2

  1. No Servidor nº 2, realize o mesmo processo de instalação usado para instalar o Agente do Robôs no Servidor nº 1.

  2. Na página Pastas de destino no instalador, não selecione Copiar arquivo de registro e deixe o campo Localização do arquivo de registro do Agente do Robôs em branco.

Para saber sobre as etapas da instalação, consulte Instale o Agente do Robôs.

Recuperar nome da chave RSA do aplicativo Robôs

  1. Na página inicial do Launchpad (www.highbond.com), selecione o aplicativo Robôs para abri-lo.

    Se já tiver entrado na Diligent One, você pode usar o menu de navegação à esquerda para mudar para o aplicativo Robôs.

  2. Clique em Configurações no canto superior direito do painel.

  3. No painel esquerdo, certifique-se de que Gerenciamento de agente está selecionado.

  4. Clique em Como adicionar outros agentes.

  5. Clique em para copiar o nome da chave RSA para a área de transferência.

  6. Cole o nome da chave RSA em um arquivo de texto para armazenamento temporário.

Agrupe a chave RSA do Agente do Robôs em um arquivo

Use o utilitário EncryptionKeyCLI.exe no Servidor nº 1 para agrupar a chave RSA do Agente do Robôs em um arquivo.

Observação

Se você já instalou um Agente do Robôs adicional e criou um arquivo zip contendo a chave RSA, use o arquivo existente. Você não precisa criar outra cópia.

  1. No Servidor nº 1, abra o prompt de comando do Windows como administrador.

  2. Execute o seguinte comando para alterar o diretório de instalação do Agente do Robôs:

    cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

    Se você não instalar o Agente do Robôs no diretório padrão, especifique o caminho apropriado.

  3. Execute o seguinte comando para compactar a chave RSA do Agente do Robôs em um arquivo zip:

    EncryptionKeyCLI.exe export RSAKeyfile ACL_XXXXXXXX

    Para ACL_XXXXXXXX, substitua pelo nome da atual chave RSA que você copiou da tela Gerenciamento de agente no Robôs.

    RSAKeyfile pode ser qualquer nome de arquivo, sem espaços, que você quiser especificar. Opcionalmente, você pode especificar um caminho de arquivo para uma pasta existente no servidor. Se caminho tiver espaços, coloque todo o caminho e nome do arquivo entre aspas duplas.

  4. Se necessário, digite S para substituir um arquivo existente.

    Resultado A chave RSA é agrupada em um arquivo zip e salva no local padrão (C:\ProgramData\robots\RSAKeyfile.zip) ou no local que você especificar.

    Observação

    Se a pasta ProgramData não for exibida, poderá estar oculta. Para que a pasta fique visível, no Windows File Explorer, selecione Itens ocultos no diretório raiz C:\ (guia Exibir > Itens ocultos).

Migrar arquivo de chave RSA para o Servidor nº 2

Use o utilitário EncryptionKeyCLI.exe no Servidor nº 2 para extrair a chave RSA do Agente do Robôs do arquivo zip e importá-la para o armazenamento de chaves da Microsoft.

  1. Copie RSAKeyfile.zip do Servidor nº 1 para o diretório de instalação do Agente do Robôs no Servidor nº 2.

    O diretório de instalação padrão é: C:\Arquivo de Programas (x86)\ACL Software\Robots Agent\agent

  2. No Servidor nº 2, abra o prompt de comando do Windows como administrador.

  3. Execute o seguinte comando para alterar o diretório de instalação do Agente do Robôs:

    cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

    Se você não instalar o Agente do Robôs no diretório padrão, especifique o caminho apropriado.

  4. Execute o comando a seguir para extrair a chave RSA do Agente do Robôs do arquivo compactado e importá-la para a keystore da Microsoft no servidor nº.2:

    EncryptionKeyCLI.exe import RSAKeyfile

    Se você não usar RSAKeyfile como o nome do arquivo zip, substitua o nome do arquivo.

Copiar o arquivo de chave de registro para o Servidor nº 2

Copie o arquivo de chave de registro (registration.key) do diretório de instalação do Agente do Robôs no Servidor nº 1 para o diretório de instalação do Agente do Robôs no Servidor nº 2.

O diretório de instalação padrão é: C:\Arquivo de Programas (x86)\ACL Software\Robots Agent\agent

Reiniciar o serviço do Agente do Robôs no Servidor nº 2

No Servidor nº 2, abra o gerenciador de Serviços do Windows e reinicie (ou inicie) o serviço do Agente do Robôs.

Verifique se o agente adicional foi registrado com sucesso

No aplicativo Robôs, vá para a tela de Gerenciamento de agente e pressione F5 para recarregar a página. Se o Agente do Robôs adicional aparecer na lista com o status On-line, ele foi registrado com sucesso. O agente agora faz parte do cluster de agente usado para processamento analítico e balanceamento de carga.