O Windows Installer

O instalador UiPathOrchestrator.msi permite que você instale o Orchestrator em um ou vários nós, dependendo das suas necessidades. As seguintes seções fornecem para você os detalhes sobre como executar uma instalação bem-sucedida em ambos os ambientes de vários nós.

Serviços incluídos

Esses são os serviços incluídos na instalação do Orchestrator:

• Orchestrator
• Servidor de Identidade
• Webhooks

Instalação de Nó Único

Em instalações de um nó, a sessão é mantida na memória, pois você não precisa compartilhá-la.

1. Execute o Instalador do Windows (UiPathOrchestrator.msi). O assistente de Configuração do UiPath Orchestrator é exibido.
2. Selecione a caixa de seleção Eu aceito os termos no Contrato de Licença para concordar com os termos do contrato e clique em Instalar. A janela de seleção de Recursos do Produto é exibida:
   
   

   

   
   

   Importante: ao habilitar a funcionalidade Test Automation, um banco de dados com o nome padrão UiPathTestAutomation é criado. Você pode escolher um nome diferente passando por meio da linha de comando TA_DATABASE_NAME=<MyCustomDB>.
3. Selecione se as seguintes funcionalidades estiverem instaladas com o Orchestrator: Insights e/ou Testar Automação. Clique em Avançar, a etapa Configurações do Orchestrator IIS é exibida.
   
   

   

   
   
4. Altere as configurações do IIS conforme desejado:
   • Nome do site - o nome do site. Isso é definido como UiPath Orchestrator por padrão e não pode ser editado.
   • Nome do host - usado para identificar o dispositivo no qual o Orchestrator está instalado. Por padrão, é definido como o nome completo do computador.
   • Porta do Site — a porta que você deseja usar para habilitar a comunicação entre o computador e o Orchestrator. Por padrão, é definido como 443 para permitir que você use o HTTPS. Se outra porta for usada, certifique-se de anexá-la ao parâmetro PUBLIC_URL do Identity Server conforme detalhado abaixo.
   • Adicione as regras de firewall para esta porta - quando selecionado, adiciona automaticamente regras de firewall para esta porta, garantindo a segurança da sua máquina.
   • Certificado SSL - o assunto ou impressão digital do certificado SSL que você deseja usar para proteger as conexões com o Orchestrator. Por padrão, é preenchido com o nome completo do computador.
   • Verifique a disponibilidade de porta - se selecionado, verifica se a porta do site especificada está disponível.
5. Clique em Avançar. A etapa de Configurações do Pool de Aplicativo é exibida.
   
   

   

   
   
6. Configure as opções editáveis conforme desejado:
   • Nome - o nome do pool de aplicativos. Isso é definido como UiPath Orchestrator por padrão e não pode ser editado.

   • Identidade - permite que você escolha a identidade sob a qual o site do UiPath Orchestrator é executado. As seguintes opções estão disponíveis:

     • Identidade do pool de aplicativos - executa o site do Orchestrator sob a identidade padrão do pool de aplicativos.

     • Conta personalizada - executa o site do Orchestrator sob uma identidade já existente do Domínio ou do Windows. A seleção desta opção exibe dois campos, Nome de usuário e Senha, que permitem que você especifique a identidade sob a qual será executado.

       Para obter mais informações sobre as identidades do Pool de Aplicativos, consulte a documentação oficial da Microsoft.

   • Clique em Avançar. A etapa de Configurações do Banco de Dados do Orchestrator é exibida.

     
     

     

     
     
7. Preencha os campos com informações sobre seu SQL Server da seguinte maneira:
   • Host do SQL Server - O nome da máquina do SQL Server. Por padrão, é definido como localhost (.). Se não for a instância padrão, também mencione no formato MyMachine\MyInstance. Você também pode especificar um número de porta personalizado aqui usando uma vírgula, como MyMachine\MyInstance,800.
   • Nome do Banco de Dados — o nome do banco de dados. Por padrão, é definido como UiPath. Observe que os seguintes caracteres especiais não são compatíveis: um espaço vazio, \, /, *, : ,;, ?, ", <, >, |, o comprimento máximo é de 123 caracteres.

   • Modo de autenticação - permite que você escolha o modo de autenticação para o site do UiPath Orchestrator. As seguintes opções estão disponíveis:

     • Autenticação Integrada do Windows - Esta é a opção padrão. Se você selecioná-la, o Orchestrator se conecta ao banco de dados usando a conta do Windows do IIS Application Pool detectada e cria o banco de dados usando as credenciais do Windows com as quais você está atualmente conectado.

     • SQL Server Authentication - Se você selecionar esta opção, os campos Nome de Usuário e Senha do SQL são exibidos, os quais devem ser preenchidos com o nome de usuário e senha do SQL Server.Para obter mais informações, consulte o capítulo Pré-requisitos.

       Observação: a senha não é compatível com o uso de ponto e vírgula (;).

   • Clique em Avançar. A conexão SQL é verificada pelo instalador. Se a conexão SQL não for válida, uma caixa de diálogo é exibida. Se a conexão SQL for válida, a etapa Configurações do Identity Server é exibida.

     Observação: o Orchestrator é enviado junto com o Identity Server para habilitar a autenticação e controle de acesso UiPath em todos os produtos da UiPath.
     
     

     

     
     
     Importante: para grandes implantações, recomendamos usar um banco de dados separado para o Identity Server.
8. Preencha os campos com informações sobre seu Identity Server da seguinte maneira:
   • Nome do Banco de Dados — o nome do banco de dados. Por padrão, esse é o nome do banco de dados do Orchestrator, mas pode ser alterado. Observe que os seguintes caracteres especiais não são suportados: um espaço vazio, \, /, *, :, ?, ", <, >, | e o comprimento máximo é de 123 caracteres.

   • URL público do Orchestrator - o URL do Orchestrator à qual o Identity Server se conecta. Em um cenário de vários nós, esta é a URL do balanceador de carga por meio da qual o usuário chama a instalação do Orchestrator (por exemplo, https://orchestrator.mydomain.local).

     Por padrão, a URL pública do Orchestrator é definida como https://<host name>. Observe que isso se aplica apenas se você usar a porta padrão do site: 443. Se você optar por uma porta personalizada, a URL pública do Orchestrator é https://<host name>:<custom port>. Por exemplo, se a porta do site estiver definida como 444, a URL pública do Orchestrator é https://<host name>:444.
   • Certificado de assinatura - o assunto ou impressão digital do certificado usado para assinar os tokens de acesso usados para a autenticação entre o Orchestrator e o Identity Server.
9. Clique em Avançar. A etapa Configurações de Log do Elasticsearch é exibida.
   
   

   

   
   
10. (Opcional) Preencha os campos com informações sobre sua instância do Elasticsearch da seguinte maneira:
    • URL - A URL do Elasticsearch na qual você deseja registrar informações.

    • Requer autenticação - Permite que você indique se sua instância do Elasticsearch requer autenticação. Se selecionado, os campos Nome de usuário e Senha são exibidos.

      • Nome de usuário - O nome de usuário do Elasticsearch.

      • Senha - A senha do Elasticsearch.

        Observação: se você não quiser usar o Elasticsearch para registrar em log, deixe o campo URL vazio.

    • Clique em Avançar. A etapa de Configurações de Autenticação do Orchestrator é exibida.

      
      

      

      
      
11. Preencha os campos da seguinte maneira:
    • Senha do host - Defina uma senha personalizada para o administrador do host. Observe que as senhas devem ter pelo menos 8 caracteres, pelo menos um caractere minúsculo e pelo menos um número.
    • Confirmar senha - Confirme a senha do administrador do host.
    • Redefinição no primeiro login - Permite que você imponha uma redefinição de senha no primeiro login para o administrador do host. Isso também é chamado de senha de uso único.
    • Senha padrão do tenant - Defina uma senha personalizada para o administrador padrão do tenant. Observe que as senhas devem ter pelo menos 8 caracteres, pelo menos um caractere minúsculo e pelo menos um número.
    • Confirmar senha - Confirme a senha de administrador do tenant padrão.
    • Redefinição no primeiro login - Permite que você imponha uma redefinição de senha no primeiro login para o administrador do tenant padrão. Isso também é chamado de senha de uso único.

    • Habilitar Autenticação do Windows - Se selecionado, habilita a Autenticação do Windows no Orchestrator e exibe o campo de domínio do Active Directory.

      • Domínio do Active Directory - o domínio do Active Directory que você deseja usar no Orchestrator e a partir do qual os usuários serão adicionados.

    • Clique em Avançar. Se a funcionalidade de Insights estiver selecionada, a etapa do Insights é exibida.

      
      

      

      
      
12. Preencha os campos com informações sobre sua instância do Insights da seguinte maneira:
    • Host do SQL Server - o nome da máquina do Insights do SQL Server. Por padrão, é definido como localhost (.). Se não for a instância padrão, também mencione no formato MyMachine\MyInstance. Você também pode especificar um número de porta personalizado aqui usando uma vírgula, como MyMachine\MyInstance,800.
    • Nome do Banco de Dados — o nome do banco de dados. Por padrão, é definido como UiPath. Observe que os seguintes caracteres especiais não são compatíveis: um espaço vazio, \, /, *, : ,;, ?, ", <, >, |, o comprimento máximo é de 123 caracteres.

    • Modo de autenticação - permite que você escolha o modo de autenticação para o site do UiPath Orchestrator. As seguintes opções estão disponíveis:

      • Autenticação Integrada do Windows - Esta é a opção padrão. Se você selecioná-la, o Orchestrator se conecta ao banco de dados usando a conta do Windows do IIS Application Pool detectada e cria o banco de dados usando as credenciais do Windows com as quais você está atualmente conectado.
      • Autenticação do SQL Server - Se você selecionar esta opção, os campos Nome de Usuário e Senha SQL são exibidos, os quais devem ser preenchidos com o nome de usuário e senha do SQL Server.

    • Clique em Avançar. Se a funcionalidade Testar Automação estiver selecionada, a etapa de Testar Automação é exibida.

      
      

      

      
      
13. Preencha os campos com informações sobre sua instância de Testar Automação da seguinte maneira:
    • Host do SQL Server - o nome da máquina do TA SQL Server. Por padrão, é definido como localhost (.). Se não for a instância padrão, também mencione no formato MyMachine\MyInstance. Você também pode especificar um número de porta personalizado aqui usando uma vírgula, como MyMachine\MyInstance,800.
    • Nome do Banco de Dados — o nome do banco de dados. Observe que os seguintes caracteres especiais não são compatíveis: um espaço vazio, \, /, *, : ,;, ?, ", <, >, |, o comprimento máximo é de 123 caracteres.

    • Modo de autenticação - permite que você escolha o modo de autenticação para o site do UiPath Orchestrator. As seguintes opções estão disponíveis:

      • Autenticação Integrada do Windows - Esta é a opção padrão. Se você selecioná-la, o Orchestrator se conecta ao banco de dados usando a conta do Windows do IIS Application Pool detectada e cria o banco de dados usando as credenciais do Windows com as quais você está atualmente conectado.

      • Autenticação do SQL Server - Se você selecionar esta opção, os campos Nome de Usuário e Senha SQL são exibidos, os quais devem ser preenchidos com o nome de usuário e senha do SQL Server.

        Observação: a senha não é compatível com o uso de ponto e vírgula (;).

    • Clique em Avançar. A etapa de Configurações de Armazenamento do Orchestrator é exibida.

      
      

      

      
      
14. Insira o Local de Armazenamento e Tipo de Armazenamento desejados. Consulte aqui para mais detalhes.
15. Clique em Avançar. A etapa Pronto para instalar a UiPath é exibida.
16. Clique em Instalar. O processo de instalação é iniciado. Observe que o Orchestrator está instalado no seguinte local: C:\Program Files (x86)\UiPath\Orchestrator.
    Importante: Verifique duas vezes o caminho de instalação selecionado. Não é possível mover uma instalação de um local para outro pós-instalação.
17. Navegue para o Gerenciador do IIS.
18. Selecione o servidor do Orchestrator. A Exibição de Recursos é atualizada de acordo.
19. Clique duas vezes em Delegação de Funcionalidades. A tela de Delegação de funcionalidade é exibida.
20. Clique com o botão direito do mouse em Autenticação - Windows e clique em Ler/Escrever.
21. Inicie o site. Agora você pode usar o Orchestrator.
    Observação: Para fazer login como administrador do host, use as credenciais fornecidas por nossas equipes ao comprar licença e escreva host no campo Tenant Name. Consulte os detalhes aqui.

Instalação de vários nós

Importante:

As implantações do Orchestrator de vários nós usam o RESP (Protocolo de Serialização do REdis) para a comunicação, e, assim, podem ser configuradas usando qualquer solução que implemente esse protocolo.

As implantações de alta disponibilidade com o Orchestrator de vários nós são compatíveis com a UiPath apenas se o Suplemento de Alta Disponibilidade da UiPath for usado.

Importante: para instalações de vários nós, os parâmetros CERTIFICATE_SUBJECTe IS_CERTIFICATE_SUBJECT são obrigatórios. A integração do Servidor do Orchestrator-Identity não funciona se forem usadas certificações diferentes para Identity. Seu valor no arquivo de parâmetros usado deve ser um valor comum para todos os nós. Isso pode ser realizado usando:

• Um certificado curinga (subject=*.domain.local); ou
• Um certificado do Nome Alternativo de Assunto (SAN) que contém os nomes do DNS de todos os nós e do balanceador de carga, ao criar os certificados ou editando o valor no arquivo de parâmetros antes de prosseguir com a instalação de nó secundário(s).

Os certificados podem ser inseridos por assunto ou impressão digital.

Instalação MSI

1. No nó primário:, instale o Orchestrator a partir de um prompt de comando elevado usando a seguinte linha de comando : UiPathOrchestrator.msi OUTPUT_PARAMETERS_FILE=install.json REDIS_HOST=redis.corp.local REDIS_PASSWORD=secretPass STORAGE_TYPE=FileSystem STORAGE_LOCATION="RootPath=\\fileserver\Share" QUARTZ_CLUSTERED=1 PUBLIC_URL=<Orchestrator_LoadBalancer_URL> CERTIFICATE_SUBJECT=*.domain.local IS_CERTIFICATE_SUBJECT=*.domain.local.

   Veja aqui os detalhes dos parâmetros disponíveis.

   Observação: você também pode especificar uma porta para a solução do RESP (Protocolo de Serialização do Redis) instalada usando o parâmetro REDIS_PORT se você não quiser usar a porta padrão (6379).

   O HAA usa a porta 10000.

   Importante: para implantações que incluem Insights, conclua a instalação do Insights antes de prosseguir com a instalação do nó secundário do Orchestrator.
2. Em todos os nós secundários, instale o Orchestrator usando UiPathOrchestrator.msi com argumentos de linha de comando, certifique-se de fornecer o SECONDARY_NODE arâmetro definido como true e o arquivo de parâmetros gerado durante a instalação do nó primário. Também recomendamos usar o parâmetro /passive, pois uma instalação passiva exibe a barra de progresso e os popups de erros. Abra para o modo silencioso, especificando o parâmetro /Q, apenas para instalações não assistidas.

Por exemplo: UiPathOrchestrator.msi SECONDARY_NODE=1 PARAMETERS_FILE=install.json /Q.

O Pool de Aplicativos é iniciado e você pode começar a usar sua instância do Orchestrator.

O banco de dados é inicializado ao instalar o nó primário. Ao configurar os nós secundários, a etapa de inicialização do banco de dados não é mais necessária.

Instalação do UiPathPlatformInstaller.exe

Uma instância do Orchestrator de vários nós também pode ser instalada usando o instalador UiPathPlatformInstaller.exe da seguinte maneira:

1. Instale o Orchestrator selecionando Instalar Instância de Vários Nós, depois Instalar Nó Primário e siga as instruções para concluir a instalação.
2. Quando a instalação estiver concluída, você recebe um caminho local para um arquivo de parâmetros gerado. Salve este caminho ou copie o arquivo de configuração onde desejar para uso na instalação de nó(s) secundário(s).
   Importante: para implantações que incluem Insights, conclua a instalação do Insights antes de prosseguir com a instalação do nó secundário do Orchestrator.
3. No(s) nó(s) secundário(s), inicie o instalador e selecione Instalar Instância de Vários Nós e a opção Instalar nó secundário.
4. Insira o caminho para o arquivo de configuração gerado a partir da instalação do nó primário.
5. Após a instalação ser concluída, o Pool de Aplicativos é iniciado e você pode usar sua instância do Orchestrator.

Adicionando nós ao Orchestrator de Vários nós

Onde os métodos acima supõem a instalação e a configuração dos nós primários e secundários durante a implantação inicial, também é possível gerar um arquivo de parâmetros a partir de qualquer nó existente para ser usado na instalação de qualquer nó adicional nó(s).

Isso é feito usando o script Generate-ParametersFile.ps1, encontrado na subpasta Tools do diretório de instalação do Orchestrator:

1. Abra a subpasta Tools do diretório de instalação do Orchestrator e execute Generate-ParametersFile.ps1.
   Observação: a appPoolsenha de usuário personalizada deve ser passada, a menos que appPoolIdentityseja usada para a autenticação.
2. Um arquivo JSON é gerado com base nos arquivos de configuração e ambiente do Orchestrator existente.
3. Usando esse arquivo, conclua a instalação do nó secundário (etapa 2 nas instalações do MSI e da Plataforma acima).

Considerações de armazenamento de pacotes

A metadata (definição) de todos os pacotes - atividades, fluxos de trabalho e bibliotecas - é mantida no banco de dados do SQL para obter pesquisa e filtragem mais rápidos.

Além disso, é possível manter os arquivos e a mídia de execução reais no FileSystem ou um armazenamento de blobs da sua escolha - Azure, Amazon S3 ou Minio. Essa funcionalidade permite uma sincronização de arquivo com melhor desempenho, especialmente em ambientes do Orchestrator de vários nós complexos.

Leve em consideração que, independentemente do armazenamento que você usa para guardar seus pacotes, o tamanho máximo do arquivo por upload é de 28,6 MB - limitação dada pelo IIS. Para ver como alterar isso para Amazon, Minio, FileSystem e Azure, visite esta página.