Installation de Control Room sur Microsoft Windows Server à l'aide de scripts

L'installation silencieuse de la Control Room, également connue sous le nom d'installation non assistée, utilise un script personnalisé pour une configuration complète ou configuration des mises à jour. Une installation silencieuse effectue tout le processus d'installation en arrière-plan sans exiger aucune interaction de l'utilisateur ni afficher de messages.

Prérequis

Pour effectuer la tâche, vous devez être un administrateur de la Control Room et disposer des droits et autorisations requis.

  • Désactivez le contrôle d'accès utilisateur (UAC) sur la machine virtuelle hôte pour Control Room.
  • Vérifiez Conditions préalables pour Automation 360 Sur site.
  • Assurez-vous de disposer des éléments suivants :
    • Fichier d'installation de la Automation Anywhere Control Room
    • Certification TLS
    • Fichier de licence
  • Créez un script Powershell.

    Reportez-vous aux paramètres d'installation et aux exemples de scripts.

  • Exécutez le script dans Powershell.
Remarque : Pour obtenir des instructions sur l'installation silencieuse et la configuration de Automation 360 séparément, consultez la rubrique Installation et configuration silencieuses d'Automation 360 à l'aide de scripts (connexion à A-People requise).

Procédure

  1. Passez en revue les paramètres et identifiez les paramètres dont vous avez besoin.
    • Paramètres d'installation de la Control Room
      Nom de variable Description

      AA_CRCLUSTERCONFIG

      Si AA_SETCLUSTERMODE=1, alors les adresses IP du cluster séparées par des virgules

      AA_CRDBPORT

      Port de la base de données de la Control Room. La valeur par défaut est 1433

      AA_CRDBSSLMODE

      Connexion SQL sécurisée

      AA_CRFORCEHTTPSCONFIG=" "

      --

      AA_CRFORCETOHTTPS="1"

      Forcer le trafic de passer de HTTP à HTTPS

      AA_CRHTTPPORT

      Port HTTP de la Control Room La valeur par défaut est 5432
      AA_CRHTTPSPORT Port HTTPS de la Control Room
      AA_CRLISTENPORT Port du serveur Web. La valeur par défaut est 80
      AA_CRSERVICECONFIRMPASSWD Si AA_CRSETLOCALSERVICECRED= 0, alors il est nécessaire de saisir le mot de passe de confirmation
      AA_CRSERVICEPASSWD Si AA_CRSETLOCALSERVICECRED= 0, alors il est nécessaire de saisir le mot de passe de confirmation
      AA_CRSERVICEUSERNAME

      Si AA_CRSETLOCALSERVICECRED= 0, alors il est nécessaire d'ajouter le domaine\nom d'utilisateur

      AA_CRSETLOCALSERVICECRED
      • 1 si la connexion se fait en tant que Système
      • 0 si la connexion se fait en tant qu'utilisateur spécifique
      AA_CRWCCERTPASSWD Mot de passe du certificat
      AA_CRSELFSIGNCERT 1 pour certificat auto-signé
      AA_CRWCCERTPATH Chemin du certificat
      AA_SDSFEATURE
      • true=Type de déploiement cloud
      • false=Type de déploiement sur site
      AA_SETCLUSTERMODE Pour le cluster, saisissez 1, sinon 0
      AA_SETUPTYPE Le type d'installation Personnalisé ou Express
      INSTALLDIR Répertoire d'installation
      IS_SQLSERVER_AUTHENTICATION
      • 0 pour l'authentification sur Windows
      • 1 pour l'authentification SQL
      • 2 pour l'authentification Azure AD
      IS_SQLSERVER_DATABASE Nom de la base de données SQL
      IS_SQLSERVER_SERVER

      Nom du serveur SQL (nom d'hôte)

      Remarque : Les paramètres suivants sont des paramètres de service de la Control Room facultatifs que vous pouvez utiliser en fonction de vos besoins :
      • AA_STARTSERVICE_AARI
      • AA_STARTSERVICE_STORAGE
      • AA_STARTSERVICE_IQBOT
      • AA_STARTSERVICE_DISCOVERYBOT
      • AA_STARTSERVICE_DISCOVERYBOTML
      Pour en savoir plus sur la sélection des services à exécuter au démarrage, consultez la rubrique Sélection des services de la Control Room à exécuter automatiquement au démarrage.
    • Paramètres associés Elasticsearch
      Paramètre Description
      AA_ELASTICSEARCH_BACKUP Utilisé uniquement en cas d'installation sur le premier nœud d'un serveur de sauvegarde.

      Saisissez 1 si oui.

      Remarque : Le paramètre AA_ELASTICSEARCH_BACKUP est utilisé lorsque vous installez un Control Room comme serveur de sauvegarde pour l'audit.
      AA_ELASTICSEARCHSYSIP Adresse IP unique
      AA_ESPASSWD Mot de passe pour Elasticsearch
      Remarque : Le paramètre supplémentaire de confirmation du mot de passe n'est pas disponible. Le mot de passe doit comporter au moins 6 caractères.
    • Paramètres relatifs au coffre de clés
      Paramètre Description
      AA_KEYVAULTTYPE Entrez l'un des éléments suivants :
      • NONE si vous ne voulez pas définir un coffre de clés
      • AWSS pour Secret Manager AWS
      • CARK pour CyberArk
      IS_SQLSERVER_AUTHENTICATION Entrez l'un des éléments suivants :
      • 0 si l'authentification du serveur SQL n'est pas définie
      • 1 si l'authentification du serveur SQL est définie
      IS_SQLSERVER_EKVAUTHENTICATION Utilisez cette option si l'authentification du serveur SQL est configurée pour un coffre de clés externe. Entrez l'un des éléments suivants :
      • 0 si l'authentification du serveur SQL n'utilise pas de coffre de clés externe
      • 1 si l'authentification du serveur SQL pour un coffre de clés est configurée pour CyberArk
      • 2 si l'authentification du serveur SQL pour un coffre de clés est configurée pour Secret Manager AWS
      AA_CRSERVICECREDTYPE Entrez l'un des éléments suivants :
      • LOCAL si la base de données Control Room utilise l'authentification locale.
      • SERVICE si la base de données Control Room utilise une authentification personnalisée.
      • SERVICEEKV si la Control Room base de données utilise un coffre de clés externe pour l'authentification.
      Paramètres de coffre de clés d'AWS Secrets Manager
      AA_AWSSREGION Région AWS
      AA_DBAUTHAWSSECRET AWS sqllogin secret
      AA_CRSERVAWSSECRET AWS service secret
      Paramètres de coffre de clés de CyberArk
      AA_CARKAPPID ID de l'application CyberArk
      AA_CARKCERTIFICATE Nom de fichier complet du certificat avec le chemin
      AA_CARKOPTIONALCERT Nom de fichier du certificat facultatif avec le chemin
      AA_CARKCERTPASSPHRASE Phrase secrète du certificat
      AA_CARKVAULTURL URL CyberArk
      AA_DBAUTHCARKOBJECTNAME Nom de l'objet sqllogin de CyberArk
      AA_DBAUTHCARKSAFENAME Nom de sécurité sqllogin de CyberArk
      AA_CRSERVCARKOBJECTNAME Informations d'identification de service CyberArk
      AA_CRSERVCARKSAFENAME Consigne de service CyberArk
    • Paramètres liés à IPv6
      Paramètre Description
      AA_IPV6ENABLED Entrez 1 pour activer les adresses IPv6

      Pour désactiver les adresses IPv6, n'entrez pas le paramètre.

  2. Facultatif : Modifiez le script d'exemple pour utiliser une base de données Microsoft SQL Server.
    Utilisez le script pour installer la Control Room avec les options de configuration disponibles dans l'installateur.
    1. Valeurs correctes pour les variables telles que $service_username, $service_pwd, $db_server, $cr_port.
    2. Exécutez le script avec les informations d'identification utilisées lors de la connexion au service, et utilisez une connexion non sécurisée à l'aide de l'authentification Microsoft SQL Server grâce à une nouvelle base de données.
    Exemple 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
    Remarque : Lorsque vous utilisez l'authentification Windows pour vous connecter à la base de données Microsoft SQL Server, assurez-vous que les paramètres suivants sont configurés :
    • Le paramètre d'installation IS_SQLSERVER_AUTHENTICATION doit être défini sur 0

    • L'utilisateur assigné au paramètre $service_username doit être un utilisateur actif dans Microsoft SQL Server avec des autorisations définies comme : db_datareader, db_datawriter, and db_ddladmin

    • Les valeurs des paramètres $db_user et $db_pwd doivent être désactivés ou commentés

  3. Enregistrez le script que vous avez modifié sur le serveur pour l'installation.
  4. Sur le serveur d'installation, connectez-vous en tant qu'administrateur, ouvrez Powershell en mode administrateur et exécutez : Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
  5. Démarrez Powershell en mode administrateur et exécutez : .\install.ps1
    Remarque : Les journaux d'installation silencieuse sont stockés dans le dossier à partir duquel est exécuté le script d'installation. Par exemple, si vous exécutez le script à partir de C:\Silent Install, les journaux seront stockés dans le dossier C:\Silent Install.

Étapes suivantes

Terminez la configuration et la validation de la Control Room.
  • Après avoir installé la Control Room, ajustez les paramètres de configuration pour garantir que les communications Automation Anywhere sont spécifiées et confirmer que les services Automation Anywhere fonctionnent.
  • Après avoir effectué les tâches post-installation, validez la configuration en vous connectant à la Control Room et en installant une licence. Le premier accès à la Control Room vous guide dans la configuration de votre méthode d'authentification.
  • En tant qu'utilisateur Cloud disposant des autorisations d'administrateur, vous pouvez créer, afficher, modifier, supprimer et activer ou désactiver un utilisateur. La création d'étapes utilisateur varie selon si l'utilisateur est un utilisateur non-Active Directory, Active Directory, ou un utilisateur utilisant une authentification unique (SSO) à partir d'un serveur IdP.