スクリプトを使用して Control Room を Microsoft Windows Server にインストールする

サイレント 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 Web サーバー ポート。 デフォルト値は 80
      AA_CRLOGDATADIR データとログのパスは、このサーバーに固有です。
      AA_CRSERVICECONFIRMPASSWD AA_CRSETLOCALSERVICECRED= 0 の場合はパスワードを確認
      AA_CRSERVICEPASSWD AA_CRSETLOCALSERVICECRED= 0 の場合はパスワードを確認
      AA_CRSERVICEUSERNAME

      AA_CRSETLOCALSERVICECRED= 0 の場合は次に、ドメイン\ユーザー名を追加
      AA_CRSETLOCALSERVICECRED
      • サービスがシステムとしてログオンする場合は 1
      • サービスが特定のユーザーとしてログオンする場合は 0
      AA_CRWCCERTPASSWD 証明書のパスワード
      AA_CRSELFSIGNCERT 自己署名証明書の場合は 1
      AA_CRWCCERTPATH 証明書パス
      AA_LOCAL_IPADDRESS_COMBO このマシンに設定されている IP アドレスを選択するためのローカル IP ドロップダウン メニュー。
      AA_SDSFEATURE
      • True=クラウド デプロイ タイプ
      • False=オンプレミス デプロイ タイプ
      AA_SETCLUSTERMODE クラスターの場合は 1、それ以外の場合は 0
      AA_SETUPTYPE セットアップ タイプ [カスタム] または [エクスプレス]
      INSTALLDIR インストール ディレクトリ
      IS_SQLSERVER_AUTHENTICATION
      • Windows 認証の場合は 0
      • SQL 認証の場合は 1
      • AzureAD 認証の場合は 2
      IS_SQLSERVER_DATABASE SQL データベース名
      IS_SQLSERVER_SERVER

      SQL Server 名 (ホスト名)
      注: これらはオプションの Control Room サービス パラメーターであり、要件に応じて使用できます。
      • AA_STARTSERVICE_COPILOT
      • AA_STARTSERVICE_STORAGE
      • AA_STARTSERVICE_IQBOT
      • AA_STARTSERVICE_DISCOVERYBOT
      • AA_STARTSERVICE_DISCOVERYBOTML
      起動時に自動で実行されるサービスの選択については、「起動時に自動で実行される Control Room サービスの選択」を参照してください。
    • OpenSearch 関連パラメーター
      注: Automation 360 v.28 リリース (ビルド 17593) 以降、監査、Elasticsearch などのコア製品機能の基盤技術として、Bot Insight サービスが OpenSearch サービスに置き換わります。
      パラメーター 説明
      AA_ELASTICSEARCH_BACKUP バックアップ サーバーの最初のノードにインストールする場合にのみ使用します。

      「はい」の場合は「1」を入力してください。

      注: AA_ELASTICSEARCH_BACKUPパラメーターは、監査用のバックアップ サーバーとして Control Room をインストールするときに使用します。
      AA_ELASTICSEARCHSYSIP Control Room がインストールされるマシンの IP アドレス
      AA_ESPASSWD Elasticsearch のパスワード
      注: パスワードを確認するための追加パラメーターは使用できません。 パスワードは 6 文字以上でなければなりません。
    • キーボルトの関連パラメーター
      パラメーター 説明
      AA_KEYVAULTTYPE 以下のいずれかを入力します。
      • キー ボルトを定義しない場合は NONE
      • AWS シークレット マネージャーの 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 シークレット マネージャー用に構成されている場合は、2
      AA_CRSERVICECREDTYPE 以下のいずれかを入力します。
      • Control Room データベースがローカル認証を使用する場合は LOCAL。
      • Control Room データベースがカスタム認証を使用する場合は SERVICE。
      • Control Room データベースが認証に外部キー ボルトを使用する場合は SERVICEEKV。
      AWS シークレット マネージャー キー ボルト パラメーター
      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 Safe 名
      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_COPILOT=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_datawriter、および db_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 をインストールした後で、確実にタイムリーな オートメーション・エニウェア 通信を実現し、オートメーション・エニウェア サービスが実行するように構成設定を完了します。
  • インストール後のタスクを完了した後、Control Room にログインしてライセンスをインストールすることで、セットアップを検証します。 Control Room に最初にアクセスする際は、認証のために設定をガイドします。
  • 管理者権限を持つ クラウド ユーザーの場合、ユーザーを作成、表示、編集、削除、有効化または無効化することができます。 ユーザー作成ステップは、ユーザーが非 Active Directory ユーザー、Active Directory ユーザー、または IdP サーバーからのシングル サインオン (SSO) ユーザーのいずれであるかによって異なります。