Microsoft Windows Server에 스크립트를 활용한 Control Room 설치

Control Room 자동 설치(무인 설치)는 전체 설치 또는 업데이트 설치에 사용자 지정 스크립트를 사용합니다. 자동 설치는 사용자 상호작용이나 메시지 표시 없이 백그라운드에서 전체 설치 프로세스를 실행합니다.

전제 조건

태스크를 수행하려면 필요한 권한을 가진 Control Room 관리자 계정이 있어야 합니다.

  • Control Room용 호스트 VM에서 UAC(사용자 액세스 제어)를 비활성화합니다.
  • Automation 360 온프레미스 선행조건 확인.
  • 다음이 있는지 확인합니다.
    • Automation Anywhere Control Room 설치 파일
    • TLS 인증서
    • 라이선스 파일
  • Powershell 스크립트를 생성합니다.

    설치 매개변수와 샘플 스크립트를 확인합니다.

  • Powershell에서 스크립트를 실행합니다.
주: 별도로 Automation 360의 자동 설치 및 구성을 수행하는 방법에 대한 지침은 Silent installation and configuration of Automation 360 using scripts (A-People login required) 항목을 참조하십시오.

프로시저

  1. 매개변수를 검토하고 필요한 설정을 식별합니다.
    • Control Room 설치 매개변수
      변수 이름 설명

      AA_CRCLUSTERCONFIG

      AA_SETCLUSTERMODE=1일 경우 클러스터 IP가 쉼표로 분리됨

      AA_CRDBPORT

      Control Room 데이터베이스 포트. 기본값은 1433입니다.

      AA_CRDBSSLMODE

      보안 SQL 연결

      AA_CRFORCEHTTPSCONFIG=" "

      --

      AA_CRFORCETOHTTPS="1"

      트래픽을 HTTP에서 HTTPS로 강제 전환

      AA_CRHTTPPORT

      Control Room HTTP 포트. 기본값 5432
      AA_CRHTTPSPORT Control Room HTTPS 포트
      AA_CRLISTENPORT 웹 서버 포트. 기본값은 80입니다.
      AA_CRSERVICECONFIRMPASSWD AA_CRSETLOCALSERVICECRED= 0인 경우 비밀번호 확인
      AA_CRSERVICEPASSWD AA_CRSETLOCALSERVICECRED= 0인 경우 비밀번호 확인
      AA_CRSERVICEUSERNAME

      AA_CRSETLOCALSERVICECRED= 0인 경우 domain\user name 추가

      AA_CRSETLOCALSERVICECRED
      • 1 - 서비스가 시스템으로 로그인하는 경우
      • 0 - 서비스가 특정 사용자로 로그인하는 경우
      AA_CRWCCERTPASSWD 인증서 비밀번호
      AA_CRSELFSIGNCERT 자체 서명 인증서는 1
      AA_CRWCCERTPATH 인증서 경로
      AA_SDSFEATURE
      • true=클라우드 배포 유형
      • false=온프레미스 배포 유형
      AA_SETCLUSTERMODE 클러스터는 1로 설정, 그렇지 않으면 0으로 설정
      AA_SETUPTYPE 사용자 지정 또는 익스프레스 설치 유형
      INSTALLDIR 설치 디렉터리
      IS_SQLSERVER_AUTHENTICATION
      • Windows 인증은 0
      • SQL 인증은 1
      • Azure AD 인증은 2
      IS_SQLSERVER_DATABASE SQL 데이터베이스 이름
      IS_SQLSERVER_SERVER

      SQL Server 이름(호스트 이름)

      주: 다음은 요구사항에 따라 사용할 수 있는 Control Room 서비스 매개변수(선택 사항)입니다.
      • AA_STARTSERVICE_AARI
      • AA_STARTSERVICE_STORAGE
      • AA_STARTSERVICE_IQBOT
      • AA_STARTSERVICE_DISCOVERYBOT
      • AA_STARTSERVICE_DISCOVERYBOTML
      시작 시 실행할 서비스를 선택하는 방법에 대한 자세한 내용은 시작 시 자동으로 실행할 Control Room 서비스 선택 항목을 참조하십시오.
    • Elasticsearch 관련 매개변수
      매개변수 설명
      AA_ELASTICSEARCH_BACKUP 백업 서버의 첫 번째 노드에 설치하는 경우에만 사용됩니다.

      '예'인 경우 1을 입력하십시오.

      주: AA_ELASTICSEARCH_BACKUP 매개변수는 감사를 위해 Control Room을 백업 서버로 설치할 때 사용됩니다.
      AA_ELASTICSEARCHSYSIP 유효한 IP 주소
      AA_ESPASSWD Elasticsearch 비밀번호
      주: 비밀번호 확인을 위한 추가 매개변수를 사용할 수 없습니다. 비밀번호는 최소 6자 이상이어야 합니다.
    • 키-값 관련 매개변수
      매개변수 설명
      AA_KEYVAULTTYPE 다음 중 하나를 입력합니다.
      • 키 저장소를 정의하지 않으려면 NONE
      • AWS Secrets Manager의 경우 AWSS
      • CyberArk의 경우 CARK
      IS_SQLSERVER_AUTHENTICATION 다음 중 하나를 입력합니다.
      • SQL Server 인증이 설정되지 않은 경우 0
      • SQL Server 인증이 설정된 경우 1
      IS_SQLSERVER_EKVAUTHENTICATION 외부 키 저장소에 대해 SQL Server 인증이 구성된 경우 이를 사용합니다. 다음 중 하나를 입력합니다.
      • SQL Server 인증에서 외부 키 저장소를 사용하지 않는 경우 0
      • 키 저장소에 대한 SQL Server 인증이 CyberArk에 대해 구성된 경우 1
      • 키 저장소에 대한 SQL Server 인증이 AWS Secrets Manager에 대해 구성된 경우 2
      AA_CRSERVICECREDTYPE 다음 중 하나를 입력합니다.
      • Control Room 데이터베이스에서 로컬 인증을 사용하는 경우 LOCAL
      • Control Room 데이터베이스에서 사용자 지정 인증을 사용하는 경우 SERVICE
      • Control Room 데이터베이스가 인증을 위해 외부 키 저장소를 사용하는 경우 SERVICEEKV
      AWS Secrets Manager 키 저장소 매개변수
      AA_AWSSREGION AWS 리전
      AA_DBAUTHAWSSECRET AWS sqllogin 비밀
      AA_CRSERVAWSSECRET AWS 서비스 비밀
      CyberArk 키 저장소 매개변수
      AA_CARKAPPID CyberArk 앱 ID
      AA_CARKCERTIFICATE 경로를 포함한 전체 인증서 파일 이름
      AA_CARKOPTIONALCERT 경로를 포함한 선택적 인증서 파일 이름
      AA_CARKCERTPASSPHRASE 인증서 암호
      AA_CARKVAULTURL CyberArk URL
      AA_DBAUTHCARKOBJECTNAME CyberArk sqllogin 객체 이름
      AA_DBAUTHCARKSAFENAME CyberArk sqllogin 금고 이름
      AA_CRSERVCARKOBJECTNAME CyberArk 서비스 자격증명
      AA_CRSERVCARKSAFENAME CyberArk 서비스 로커
    • IPv6 관련 매개변수
      매개변수 설명
      AA_IPV6ENABLED IPv6 주소를 활성화하려면 1을 입력합니다.

      IPv6 주소를 비활성화하려면 매개변수를 입력하지 마십시오.

  2. 옵션: 샘플 스크립트를 편집하여 Microsoft SQL Server 데이터베이스를 사용합니다.
    스크립트를 사용하여 설치 프로그램에서 사용 가능한 구성 옵션으로 Control Room을 설치합니다.
    1. $service_username, $service_pwd, $db_server, $cr_port와 같은 변수의 올바른 값.
    2. 서비스 로그인 상의 자격증명과 새로운 데이터베이스에서 Microsoft SQL Server 인증을 사용한 비보안 연결로 스크립트를 실행합니다.
    샘플 스크립트:
    $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
    주: Microsoft SQL Server 데이터베이스에 연결하기 위해 Windows 인증을 사용하는 경우 다음 설정이 구성되어 있는지 확인하십시오.
    • IS_SQLSERVER_AUTHENTICATION 설치 매개변수는 0으로 설정해야 합니다.

    • $service_username 매개변수에 할당된 사용자는 Microsoft SQL Server에서 db_datareader, db_datawriterdb_ddladmin으로 설정된 권한을 가진 활성 사용자여야 합니다.

    • $db_user$db_pwd 매개변수 값을 비활성화하거나 코멘트 처리해야 합니다.

  3. 설치를 위해 편집한 스크립트를 서버에 저장합니다.
  4. 설치 서버에서 관리자로 로그인한 후 관리 모드에서 Powershell을 열고 다음을 실행합니다. Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
  5. 관리자 모드에서 Powershell을 시작하고 다음을 실행합니다. .\install.ps1
    주: 설치 스크립트가 실행되는 폴더에 자동 설치 로그가 저장됩니다. 예를 들어 스크립트를 C:\Silent Install에서 실행한 경우 로그가 C:\Silent Install 폴더에 저장됩니다.

다음 단계

Control Room 구성 및 검증 완료.
  • Control Room 설치 후 구성 설정을 완료하여 적절한 시간 내에 Automation Anywhere 통신이 지정되도록 하고 Automation Anywhere 서비스의 실행 여부를 확인합니다.
  • 설치 후 태스크를 완료한 후, Control Room에 로그인하고 라이선스를 설치하여 설정을 검증합니다. Control Room에 처음으로 액세스하면 인증 방법 구성에 대한 설명이 제공됩니다.
  • 관리자 권한이 있는 클라우드 사용자는 사용자를 생성, 보기, 편집, 삭제, 활성화 또는 비활성화할 수 있습니다. 사용자 생성 단계는 사용자가 비활성 디렉터리, Active Directory 또는 IdP 서버의 싱글 사인온(SSO) 사용자인지에 따라 다릅니다.