Instalação do Control Room em Microsoft Windows Server usando scripts

A instalação silenciosa do Control Room, também conhecida como instalação sem supervisão, usa um roteiro personalizado para uma configuração completa ou uma configuração de atualização. A instalação silenciosa executa todo o processo de instalação em segundo plano sem exigir a interação do usuário ou exibir mensagens.

Pré-requisitos

Para realizar a tarefa, você deve ter uma conta de administrador da Control Room com os direitos e permissões necessários.

  • Desative o Controle de Acesso do Usuário (UAC) na VM do host para Control Room.
  • Verifique Pré-requisitos do Automation 360 No local.
  • Certifique-se de ter o seguinte:
    • o arquivo de instalação da Automation Anywhere Control Room
    • Certificado TLS
    • Arquivo de licença
  • Crie um script Powershell.

    Consulte os parâmetros de instalação e os exemplos de scripts.

  • Execute o script no Powershell.
Nota: Para obter instruções sobre a execução de instalação silenciosa e configuração de Automation 360 separadamente, consulte Instalação silenciosa e configuração do Automation 360 usando scripts (login no A-People necessário).

Procedimento

  1. Revise os parâmetros e identifique as configurações necessárias.
    • Parâmetros de instalação do Control Room
      Nome da variável Descrição

      AA_CRCLUSTERCONFIG

      se AA_SETCLUSTERMODE=1, então o cluster IP é separado por vírgulas

      AA_CRDBPORT

      Porta do banco de dados Control Room. O valor padrão é 1433

      AA_CRDBSSLMODE

      Conexão SQL segura

      AA_CRFORCEHTTPSCONFIG=" "

      --

      AA_CRFORCETOHTTPS="1"

      Force traefik de HTTP para HTTPS

      AA_CRHTTPPORT

      Porta HTTP Control Room. O padrão é 5432
      AA_CRHTTPSPORT Porta HTTPS Control Room
      AA_CRLISTENPORT Porta do servidor Web. O valor padrão é 80
      AA_CRSERVICECONFIRMPASSWD se AA_CRSETLOCALSERVICECRED= 0, confirme a senha
      AA_CRSERVICEPASSWD se AA_CRSETLOCALSERVICECRED= 0, confirme a senha
      AA_CRSERVICEUSERNAME

      se AA_CRSETLOCALSERVICECRED= 0, adicionar domínio\nome de usuário

      AA_CRSETLOCALSERVICECRED
      • 1, se o serviço fizer login como System
      • 0, se o serviço fizer login como usuário específico
      AA_CRWCCERTPASSWD Senha do certificado
      AA_CRSELFSIGNCERT 1 para certificado autoassinado
      AA_CRWCCERTPATH Caminho do certificado
      AA_SDSFEATURE
      • verdadeiro=Tipo de implantação na nuvem
      • falso=Tipo de implantação no local
      AA_SETCLUSTERMODE Para conjunto de cluster 1 ou 0
      AA_SETUPTYPE Tipo de configuração personalizado ou expresso
      INSTALLDIR Diretório de instalação
      IS_SQLSERVER_AUTHENTICATION
      • 0 para autenticação do Windows
      • 1 para autenticação SQL
      • 2 para autenticação do Azure AD
      IS_SQLSERVER_DATABASE Nome do banco de dados SQL
      IS_SQLSERVER_SERVER

      Nome do servidor SQL (nome do host)

      Nota: Estes são parâmetros de serviço opcionais da Control Room que podem ser usados com base em sua necessidade:
      • AA_STARTSERVICE_AARI
      • AA_STARTSERVICE_STORAGE
      • AA_STARTSERVICE_IQBOT
      • AA_STARTSERVICE_DISCOVERYBOT
      • AA_STARTSERVICE_DISCOVERYBOTML
      Para obter informações sobre como selecionar os serviços a serem executados na inicialização, consulte Selecione serviços da Control Room para executar automaticamente na inicialização.
    • Parâmetros relacionados ao Pesquisa de elasticidade
      Parâmetro Descrição
      AA_ELASTICSEARCH_BACKUP Usado somente se estiver instalando no primeiro nó de um servidor de backup.

      Digite 1 se sim.

      Nota: O parâmetro AA_ELASTICSEARCH_BACKUP do é usado quando você instala um Control Room como servidor de backup para auditoria.
      AA_ELASTICSEARCHSYSIP Endereço IP válido
      AA_ESPASSWD Senha para Pesquisa de elasticidade
      Nota: Parâmetro adicional para confirmar que a senha não está disponível. A senha deve ter no mínimo 6 caracteres.
    • Parâmetros relacionados ao cofre de senhas
      Parâmetro Descrição
      AA_KEYVAULTTYPE Digite qualquer uma das opções a seguir:
      • NENHUM se você não quiser definir um cofre de senhas
      • AWSS para Gerenciador de Segredos do AWS
      • CARK para CyberArk
      IS_SQLSERVER_AUTHENTICATION Digite qualquer uma das opções a seguir:
      • 0 se a autenticação do servidor SQL não estiver definida
      • 1 se a autenticação do servidor SQL estiver definida
      IS_SQLSERVER_EKVAUTHENTICATION Use este parâmetro se a autenticação do servidor SQL estiver configurada para um cofre de senhas externo. Digite qualquer uma das opções a seguir:
      • 0 se a autenticação do servidor SQL não utilizar um cofre de senhas externo
      • 1 se a autenticação do servidor SQL para um cofre de senhas estiver configurada para CyberArk
      • 2 se a autenticação do servidor SQL para um cofre de senhas estiver configurada para AWS Secrets Manager
      AA_CRSERVICECREDTYPE Digite qualquer uma das opções a seguir:
      • LOCAL se o banco de dados do Control Room utiliza autenticação local.
      • SERVICE se o banco de dados do Control Room utiliza autenticação personalizada.
      • SERVICEEKV se o banco de dados do Control Room utiliza cofre de senhas externo para autenticação.
      Parâmetros do cofre de senhas do AWS Secrets Manager
      AA_AWSSREGION Região do AWS
      AA_DBAUTHAWSSECRET Segredo do sqllogin do AWS
      AA_CRSERVAWSSECRET Segredo de serviço do AWS
      Parâmetros do cofre de senhas do CyberArk
      AA_CARKAPPID ID do aplicativo CyberArk
      AA_CARKCERTIFICATE Nome completo do arquivo do certificado com caminho
      AA_CARKOPTIONALCERT Nome opcional do arquivo do certificado com caminho
      AA_CARKCERTPASSPHRASE Senha do certificado
      AA_CARKVAULTURL URL do CyberArk
      AA_DBAUTHCARKOBJECTNAME Nome do objeto de sqllogin do CyberArk
      AA_DBAUTHCARKSAFENAME Nome seguro de sqllogin do CyberArk
      AA_CRSERVCARKOBJECTNAME Credencial de serviço do CyberArk
      AA_CRSERVCARKSAFENAME Cofre de serviço do CyberArk
    • Parâmetros relacionados ao Ipv6
      Parâmetro Descrição
      AA_IPV6ENABLED Digite 1 para habilitar endereços IPv6

      Para desativar os endereços IPv6, não insira o parâmetro.

  2. Opcional: Edite o script de amostra para usar um banco de dados Microsoft SQL Server.
    Use o script para instalar o Control Room com as opções de configuração disponíveis no instalador.
    1. Valores corretos para variáveis como $service_username, $service_pwd, $db_server, $cr_port.
    2. Execute o script com um os Dados de acesso no logon do Serviço e uma conexão não segura usando autenticação Microsoft SQL Server com um novo banco de dados.
    Amostra de script :
    $cr_port=80
    
    $service_username= "domain\username" #e.g."aaspl-brd\ellie.brown"
    $service_pwd="password"
    
    #$certpath = "C:\SilentInstall\test256.pfx"
    #$certpass = "changeit"
    
    $db_server="localhost"
    $cr_db_name="CRDB-NEW-SI-3"
    $db_user="sa"
    $db_pwd="Admin@123"
    
    $elastic_password="Test@123"
    
    $installation_path="C:\Program Files\Automation Anywhere"
    
    #Install latest setup
    $static_installation_path="\Enterprise\"""""
    $silent_details=" /s ","v""" -join "/"
    $installpath_details=" /qn INSTALLDIR=\"""
    
    $deployment_details=" /AA_SDSFEATURE=true"
    
    $custom_details=" /vAA_SETUPTYPE=Custom 
                      /vAA_CUSTOMMODETYPE=1"
    
    $port_cluster_details=" /vAA_SETCLUSTERMODE=0 
                            /vAA_CRLISTENPORT=$cr_port"
    
    #$service_details=" /vAA_CRSETLOCALSERVICECRED=0 
                        /vAA_CRSERVICEUSERNAME=$service_username 
                        /vAA_CRSERVICEPASSWD=$service_pwd 
                        /vAA_CRSERVICECONFIRMPASSWD=$service_pwd"
    
    $service_details=" /vAA_CRSETLOCALSERVICECRED=1"
    
    #$service_selections (The below parameter is optional and must be used if you want to selectively install the services. To install any specific service, set the value to 1 or remove that specific service from the below parameter.)
    $service_selections=" /vAA_STARTSERVICE_IQBOT=0 /vAA_STARTSERVICE_AARI=0 /vAA_STARTSERVICE_STORAGE=0 /vAA_STARTSERVICE_DISCOVERYBOT=0 /vAA_STARTSERVICE_DISCOVERYBOTML=0"
    
    #$db_details=" /vAA_BIMETADATADBTYPE=AA_BIMETADATADBTYPE 
                   /vIS_SQLSERVER_SERVER=$db_server 
                   /vIS_SQLSERVER_DATABASE=$cr_db_name 
                   /vIS_SQLSERVER_DATABASE1=$bi_db_name"
    
    $db_details=" /vIS_SQLSERVER_SERVER=$db_server 
                  /vIS_SQLSERVER_USERNAME=$db_user 
                  /vIS_SQLSERVER_PASSWORD=$db_pwd 
                  /vIS_SQLSERVER_DATABASE=$cr_db_name 
                  /vIS_SQLSERVER_AUTHENTICATION=1"
    
    $other=" /vAA_ESPASSWD=$elastic_password 
             /vAA_CRWCHTTPPORT=80 
             /vAA_CRWCHTTPSPORT=443 
             /vAA_CRSELFSIGNCERT=1 
             /vAA_OPTIONALCACERT=0 
             /vAA_CRWCCERTPATH=$certpath 
             /vAA_CRWCCERTPASSWD=$certpass 
             /vLAUNCHPROGRAM=1 
             /v""
             /LIweamoruc! log.txt"""
    
    #Ensure that you remove the $service_selection parameter from the $final_command line if $serice_selection is not used.
    $final_commandline = -join($silent_details,
    	$installpath_details,$installation_path,
    	$static_installation_path,$custom_details,
    	$port_cluster_details,$service_details,$service_selections,
    	$db_details,$pg_details,$other)
    
    Write-Host $final_commandline
    $a=Get-ChildItem $PSScriptRoot\* -Include *.exe
    #$a = "C:\Silent\AutomationAnywhereEnterprise_A2019_<build>.exe"
    
    Write-Host $a
    Write-Host "Starting the installation wait for sometime..."
    
    $processdetail=(Start-Process -FilePath 
    	$a -ArgumentList $final_commandline 
    	 -Wait -PassThru).ExitCode
    
    Write-Host $a.Name execution is done. 
    If installation is not proper check msi logs in the temp folder.
    pause
    Nota: Ao usar a autenticação do Windows para conexão com o banco de dados do Microsoft SQL Server, as seguintes configurações deverão estar configuradas:
    • O parâmetro de instalação IS_SQLSERVER_AUTHENTICATION deve ser definido para 0

    • O usuário designado para o parâmetro $service_username deve estar ativo em Microsoft SQL Server com permissões definidas como: db_datareader, db_datawriter e db_ddladmin

    • Os valores dos parâmetros $db_user e $db_pwd devem estar desativados ou em comentários

  3. Salve o script que você editar no servidor para instalação.
  4. No servidor de instalação, com login de administrador, abra o Powershell no modo admin e execute o seguinte: Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
  5. Inicie o Powershell no modo admin e execute: .\install.ps1
    Nota: Os logs da instalação silenciosa são armazenados na pasta em que o script de instalação é executado. Por exemplo, se você executar o script em C:\Silent Install, os registros são armazenados na pasta C:\Silent Install.

Próximas etapas

Conclua a configuração e validação da Control Room.
  • Após instalar a Control Room, conclua as definições de configuração para garantir que as comunicações oportunas da Automation Anywhere sejam especificadas e confirme se os serviços da Automation Anywhere estão sendo executados.
  • Após concluir as tarefas pós-instalação, valide a configuração fazendo login na Control Room e instale uma licença. O primeiro acesso à Control Room orienta você durante a configuração do seu método de autenticação.
  • Como usuário Nuvem com permissões de administrador, você pode criar, visualizar, editar, excluir, habilitar ou desativar um usuário. A criação de etapas de usuários varia, dependendo do usuário ser ou não Active Directory, ou ser usuário de logon único (SSO) de um servidor IdP.