オンプレミスロボット エージェントのインストールまたはアップグレード
ロボット エージェントは、ロボット アプリでスケジュールされたタスクを実行します。エージェントは、会社のセキュアなローカル Windows サーバー上でデータ ソースの近くにあるネットワークの保護された境界内でタスクを実行します。
メモ
このトピックの情報は、オンプレミスのロボットエージェントを使用して、ACL ロボットで ACLスクリプトを実行する組織にのみ適用されます。
ACL Robotics Professional Edition を有する個人および組織にはオンプレミスロボット エージェントがありません。HighBond ロボットとワークフロー ロボットの Python/HCL スクリプトはロボット エージェントを使用しません。
一般情報
ロボットエージェントのインストールパッケージをダウンロードし、それを使って Windows サーバーにロボットエージェントをインストールします。また、このインストールパッケージを利用して、既存のロボットエージェントをアップグレードすることもできます。
キーファイル
インストール時に、登録キーファイル(registration.key)を用いてロボット エージェントを登録します。ロボット アプリでキーファイルを生成し、ロボット エージェントがインストールされている Windows サーバーにダウンロードします。
登録キーファイルは、ロボット エージェントとロボット アプリの間の初回接続時の認証に使用されます。以降の接続やデータの流れは、暗号化キー(RSA 公開キーと秘密キーのペア)で保護されます。RSA キーペアは、ロボット エージェントサービスの起動時に自動生成されます。
登録キーファイルと暗号化キーは、登録と接続の異なる段階で使用される別のオブジェクトです。
ロボット エージェントをアップグレードする場合、登録キーファイルは関係ないので、registration.key の新しいインスタンスを生成する必要はありません。
複数のエージェント
アナリティクスの処理能力を向上させ、負荷分散を実装するために、追加の Woindows サーバー上にロボットエージェントの追加インスタンスをインストールするオプションが用意されています。
ロボット エージェントの Windows サービスとアカウント
ロボット エージェントは、インストールされると、サーバーに 2 つの Windows サービスを展開します。
- ロボット エージェントは、スケジュールされたタスクと臨時のロボットのタスクを実行します
- ロボット データ サービスは、ユーザーが Analytics でロボット エージェント テーブルを開けるようにする接続を提供します
これらのサービスのいずれかが実行されない場合、提供される機能を利用できません。
ヒント
ロボットでタスクが長時間キューに残っていて、スキップされたか失敗した場合は、ロボット エージェント サービスが実行していることを確認してください。
Analytics でロボット エージェント テーブルを開こうとすると接続エラーが発生した場合は、ロボット データ サービスが実行していることを確認します。
サービス アカウントとポート
サービス アカウントを使用して、2 つのロボット エージェントの Windows サービスを実行します。アカウントに必要なログオン権限とアクセス権の詳細については、オンプレミス ロボット エージェントのセキュリティを参照してください。
メモ
ロボット エージェント をインストール後に Windows サービスのいずれかのプロパティを変更した場合は、その変更が反映されるようサービスを再起動する必要があります。
Windows サービス | サービスを実行するアカウント | ポート |
---|---|---|
ロボット エージェント サービス |
インストール中、またはインストール後に指定されるドメインアカウント |
443 アウトバウンド通信のみ |
ロボットデータサービス | ローカル システム | 既定では 10000 ですが、インストール中とその後に設定可能 |
ロボットエージェントが認証局に接続できることを確認する
ロボットエージェントは、その真正性と完全性を検証するためにデジタル証明書を使用します。証明書は、検証できるように、サードパーティの認証局である DigiCert へのインターネット接続が必要です。ネットワークファイアウォールの背後にロボットエージェントをインストールする場合、ファイアウォールが DigiCert への証明書の接続を許可するように設定されている必要があります。必要な接続がない場合、ロボットエージェントは動作しません。
必要な場合は、組織の IT 部門と協力して、証明書と DigiCert の接続を許可するネットワークファイアウォールまたはプロキシサーバーを設定してください。ロボットエージェントの電子証明書は、以下の URL で DigiCert の証明書取り消しリストと OCSP サーバーに接続します。
- http://cacerts.digicert.com
- http://crl3.digicert.com
- http://crl4.digicert.com
- http://ocsp.digicert.com
より詳細な URL 情報については、インストール済みの証明書を検査できます。
インストール済みの証明書を確認する
ロボットエージェントのインストール後、インストールされた証明書を検査し、認証局の URL を確認します。
- ロボット エージェント インストール ディレクトリで、Agent.exe を右クリックして、[プロパティ]を選択します。
デフォルトのインストールディレクトリは C:\Program Files (x86)\ACL Software\Robots Agent\agent です。
- [Agent.exe プロパティ]ダイアログボックスで[デジタル署名]タブを選択します。
- [署名リスト]リストで Diligent Corporation をダブルクリックし、[証明書の表示]をクリックします。
- [証明書]ダイアログボックスの[詳細]タブで、次の各フィールドを選択します。
- CRL 配布ポイント
- 認証局情報アクセス
各フィールドで、URL は、ダイアログボックスの下部にある表示領域に表示されます。
- [証明書]ダイアログボックスの[証明書パス]タブで、以下を実行します。
- 次の証明書パスの各項目を選択します。
- DigiCert Trusted Root G4
- DigiCert Trusted G4 コードが署名中です...
- 各項目について、[証明書の表示]をクリックします。
- [詳細] タブで、これらの各フィールドを選択します。
- 認証局情報アクセス
- CRL 配布ポイント
各フィールドで、URL は、ダイアログボックスの下部にある表示領域に表示されます。
- 次の証明書パスの各項目を選択します。
ロボット エージェント登録キーファイルを生成する
新規ユーザーとして初めてロボット エージェントをインストールする場合には、登録キー(registration.key)を生成する必要があります。登録キーファイルは、ロボット エージェントとロボット アプリの間の初回接続時の認証に使用されます。
既存のユーザーで、既にロボット エージェントをインストールして使用しているのであれば、ほとんどの場合、新しい登録キーファイルを生成する必要はありません。新しいファイルを生成することは、たいていは不要であり、組織のロボットインスタンスの設定に影響を与える可能性があります。
ロボット エージェントのステータス | 登録キーファイルの生成 |
---|---|
ロボット エージェントのフレッシュインストール、シングルエージェントインストール | はい |
マルチエージェントクラスターでのロボット エージェントの追加インスタンスのフレッシュインストール |
いいえ 既存の登録キーファイルのコピー 詳細については、「ロボットエージェントの追加インスタンスをインストール」を参照してください。 |
現在インストールされているロボット エージェントのアップグレード |
いいえ 登録キーファイルはアップグレードに関係ない |
既存の登録キーファイルに問題があり、ロボット エージェントがロボット アプリに接続できない | はい |
現在インストールされているロボット エージェントを実行している Windows アカウントの変更 |
いいえ 登録キーファイルはアカウントの変更に関係ない 詳細については、「ロボット エージェントのサービスアカウントを変更する」を参照してください。 |
メモ
ロボット エージェント登録キーファイルを生成するには、エージェントの管理アクセス権が必要です。詳細については、「ロボット アプリのアクセス許可」を参照してください。
- Diligent One(www.highbond.com) にサインインします。
- Launchpad ホームページの[監査とアナリティクス]の下で、ロボット アプリをクリックします。
- ダッシュボードの右上隅で[設定]をクリックします。
- 左側のペインで、[エージェント管理]が選択されていることを確認します。
- ロボットのインスタンスが現在クラウドベースのロボットエージェントを使用している場合は、以下を実行します。
- [クラウド エージェントを交換する]をクリックします。
- [エージェントを登録し、キーを生成する]をクリックします。
- ロボットのインスタンスが現在オンプレミスのロボットエージェントを使用している場合、またはロボットエージェントが指定されていない場合は、以下を実行します。
- [新しい登録キーを生成する]をクリックします。
表示される警告ダイアログボックスは、1 つ以上の既存のオンプレミスエージェントがすでにインストールされている場合に適用されます。
[新しい登録キーを生成する]をクリックします。
- [新しい登録キーを生成する]をクリックします。
- [キーファイルをダウンロードして、閉じる]をクリックします。
注意
鍵ファイルをダウンロードするまで、ブラウザ ウィンドウを閉じないでください。
- ダウンロードしたキーファイルを、ロボット エージェントがインストールされている Windows サーバーの安全な場所に保存してください。
メモ
キーファイルの生成は、ロボットエージェントを登録する最初の部分です。ロボット エージェントのディレクトリ構成の適切な場所にキーファイルを格納して、ロボット エージェント サービスを起動または再起動し、ロボット アプリに正常に接続すると、登録プロセスは完了となります。
ロボット エージェントをインストールする
ロボット エージェントのインストール パッケージを使い、ロボット エージェントの最新のインストールを実行します。
メモ
インストールを完了するには、Windows サーバーのローカル管理者権限が必要です。
ロボット エージェントのインストールとロボット エージェントサービスの実行に異なる Windows アカウントを使用する場合、インストールを開始する前にロボット エージェントサービスのアカウントのパスワードを確認してください。
インストールパッケージをダウンロードする
- Launchpad から、ロボットエージェントのインストールパッケージ (RobotsAgent17.exe) をダウンロードします:
- Diligent One(www.highbond.com) にサインインします。
- Launchpad の[監査とアナリティクス]で、[アナリティクス]タイルをクリックしてダウンロードにアクセスします。
- トップメニューで、[ロボット エージェント]をクリックします。
- [バージョン 17 をダウンロード]をクリックします。
- ダウンロードしたインストールパッケージが Windows サーバーにある状態で、インストールパッケージをダブルクリックします。
-
セキュリティ警告のダイアログ ボックスが表示された場合は、リストされた情報を確認して、[はい]をクリックします。
ヒント
セキュリティの警告ダイアログボックスは、開いているウィンドウの後ろに隠れている可能性があります。
インストーラの抽出と実行
- インストールに使用する言語を選択し、[OK]をクリックします。
- [セットアップの展開場所]ページで、インストールファイルを展開するフォルダーを指定して、[展開]をクリックします。
[参照] をクリックして、フォルダーを選択するか、デフォルトの場所を選択します(
C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent17
)。セットアップファイルは、指定したフォルダーに解凍されます。ファイルが展開された後、インストーラーが自動的に開始されます。
メモ
インストーラーが何らかの理由で起動されなかった場合は、Windows エクスプローラーを使ってセットアップ ファイルの展開先フォルダーに移動し、setup.exe をダブルクリックします。
必須コンポーネントのインストール(必要な場合)
必須コンポーネントをインストールするよう求められた場合は、[インストール]をクリックします。
必須コンポーネントがインストールされた後、インストーラーは自動的に進みます。
ソフトウェア必須コンポーネントの一覧については、オンプレミス ロボット エージェントのシステム要件を参照してください。
インストール プロパティを構成する
- [ウェルカム]ページで、[次へ]をクリックします。
- [使用許諾契約]ページで、[上記の条項に同意します]を選択して、[次へ]をクリックします。
- [ロボット エージェントのエディションの選択]ページで、インストールするエディションを選択し、[次へ]をクリックします。
- 非 Unicode
- Unicode
注意
インストールするエディションが、会社に適切なエディションであることを確認してください。Analytics でロボット エージェントテーブルを開くには、エディションが一致している必要があります。
マルチエージェントクラスターを設定する場合は、クラスターのすべてのエージェントは同じエディションでなければなりません。すべてが非 Unicode またはすべてが Unicode。
詳細については、Diligent Unicode 製品を参照してください。
- [任意の Analytics データ コネクター]ページで、オプションのコネクターをインストールしいない理由がない限り、[インストール]オプションを選択したままにし、[次へ]をクリックします。
メモ
オプションのコネクターをインストールしないことを選択し、これらのいずれかを後で使用したい場合は、ロボット エージェントをアンインストールし、また再インストールする必要があります。
- [機械学習を有効にする]ページで、Python エンジンをインストールしない理由がない限り、[有効化]オプションを選択したままにし、[次へ]をクリックします。
メモ
Python エンジンをインストールしないことを選択し、機械学習のコマンドを実行するためにこれを後で使用したい場合は、ロボット エージェントをアンインストールし、また再インストールする必要があります。
- [ロボット エージェント サービスの設定]ページで、次のサービス アカウントの設定を完了し、[次へ]をクリックします。
- ロボット データ サービスのポート番号 データ サービスのポートを指定するか、既定の 10000 を使用します。
0 ~ 65536 で利用できるポートを指定できます。
- ロボット エージェントサービスのアカウント 既存のドメインアカウントを指定し、ロボット エージェントサービスを実行して、パスワードを提供します。
Domain\service_account の形式で指定されたドメイン アカウントである必要があります。このアカウントには、Windows Server オペレーティング システムでサービスを実行する権限と、インストール時に指定するデータ フォルダへのフル アクセス権が必要になります。詳細については、「オンプレミス ロボット エージェントのセキュリティ」を参照してください。
メモ
必要であれば、インストール後にロボット エージェントサービスのアカウントを変更することができます。
- ロボット データ サービスのポート番号 データ サービスのポートを指定するか、既定の 10000 を使用します。
-
ロボット エージェントサービスのアカウントに「サービスとしてログオン」権限を付与するよう求められたら、[はい]、[OK]の順にクリックします。
- [宛先フォルダー]ページで、次の宛先と接続の設定を完了し、[次へ]をクリックします。
- ロボット エージェントのインストール先フォルダ
- ロボット エージェントのインストール先フォルダを選択するか、既定の場所を使用します。
既定: C:\Program Files(x86)\ACL Software\Robots Agent\
- データ フォルダの場所を選択するか、既定の場所を使用します。
既定: C:\acl\robots\
メモ
インストール先フォルダ内、またはその反対側にデータ フォルダを格納しないでください。そこに格納すると、ロボット エージェントのアンインストール時にデータを損失する可能性があります。
- ロボット エージェントのインストール先フォルダを選択するか、既定の場所を使用します。
- ロボット エージェント登録ファイルの場所
- [登録ファイルをコピー]を選択し、registration.key ファイルの場所を参照するか、ファイル パスを手動で入力します。
インストーラーが実行されると、キーファイルが自動的にロボット エージェント ディレクトリ構造の正しい場所にコピーされます。
メモ
ロボット エージェントのインストール後にロボット エージェントサービスのアカウントを変更する場合は、[登録ファイルをコピー]は未選択のままにして、登録ファイルを指定しないでください。
- [登録ファイルをコピー]を選択し、registration.key ファイルの場所を参照するか、ファイル パスを手動で入力します。
- ロボット エージェントのインストール先フォルダ
インストールを完了する
- [プログラムをインストールする準備ができました]ページでは、[インストール]をクリックします。
ロボット エージェントがインストールされます。
- Microsoft Access データベースエンジンのインストールを選択するプロンプトが表示された場合は、次のいずれかを実行してください。
- ロボットエージェントが古い Excel ファイル (*.xls) や Microsoft Access ファイル (*.mdb) からインポートまたはエクスポートする必要がある場合は、「はい」をクリックしてデータベースエンジンをインストールしてください。
- ロボットエージェントを現在の世代の Excel ファイル (*.xlsx) のみで使用し、古い Excel ファイルや Microsoft Access ファイルを使用しない場合は、[いいえ]をクリックしてデータベースエンジンを除外してください。データベースエンジンは、他の新しい Microsoft Office 製品との互換性の問題を引き起こす可能性があります。このため、データベースエンジンは、実際に必要な場合を除き、除外する必要があります。
- インストール処理が完了したら、[完了]をクリックします。
ロボット エージェントサービスが実行されていることを確認する
ロボット エージェントがロボット アプリに接続するためには、ロボット エージェントサービスが起動している必要があります。接続がない場合、ロボット エージェントはロボットのタスクやスクリプトを処理できません。
必要に応じて、ロボット エージェントサービスの実行を確認すると同時に、ロボット エージェントサービスのアカウントを変更できます。
インストール時に指定したロボット エージェントサービスのアカウントを使用する
- Windows サービスマネージャーを開きます。
-
ロボット エージェントの Windows サービスが 2 つとも起動していることを確認します。
- ロボット エージェント**
- ロボットデータサービス
必要であれば、一方または両方のサービスを開始します。
メモ
「ロボット エージェントサービスが起動して停止した」というエラーメッセージが表示される場合は、ロボット エージェントの登録が正常に行われていない可能性があります。
ロボット エージェントのインストールディレクトリに登録キーファイル(registration.key)が存在することを確認してください。登録キーファイルがない場合は、キーファイルを保存した場所からインストールディレクトリに手動でコピーします。ロボット エージェントサービスを再度起動します。
デフォルトのインストールディレクトリは C:\Program Files (x86)\ACL Software\Robots Agent\agent です。
- アプリケーション ログ ファイルを確認し、ロボット エージェントがロボット アプリに正常に接続されていることを確認します。
ログファイルの末尾に、ロボット エージェントサービスの開始日時と一致する INFO|Connected エントリがあるかどうかを確認します。
ログファイルのデフォルトの場所は、次のとおりです。C:\acl\robots\logs\application.log
- ロボットアプリで[エージェント管理]画面に進み、[F5]を押してページを再読み込みします。
ロボット エージェントが[オンライン]状態でが表示されていれば、正常に登録されています。
ロボット エージェントサービスのアカウントを変更する
ロボット エージェントのインストール時に[登録ファイルをコピー]が選択されていない状態で、ロボット エージェントサービスのアカウントを変更する場合は、以下の手順に従います。
登録キーファイルを手動でインストールする
- 登録キーファイル(registration.key)を保存先からコピーします。
- ロボット エージェントのインストール ディレクトリに移動し、エージェント サブフォルダに登録用キーファイルを貼り付けます。
デフォルトのインストール先ディレクトリは、C:\Program File (x86)\ACL Software\Robots Agent\agent
です。必要に応じて、既存のキーファイルを削除または上書きしてください。
ロボット エージェントサービスを別のアカウントに変更する
- Windows サービスマネージャーを開きます。
- ロボット エージェント サービスを右クリックし、[プロパティ]を選択します。
- [ログオン]タブで、[参照]をクリックします。
- [ユーザーを選択]ダイアログボックスの [選択するオブジェクト名を入力してください]フィールドに、使用するサービスアカウントの名前を入力し、[名前を確認]をクリックします。
フィールドにサービスアカウントが事前入力されているはずです。
- [OK]をクリックします。
- [ログオン]タブで、サービスアカウントのパスワードを入力および確認し、[OK]をクリックします。
- Windows サービスマネージャーで、ロボット エージェント サービスを再起動(または起動)します。
- 必要に応じて、ロボットデータサービスを起動します。
ロボット エージェントが正常に登録されたことを確認する
- アプリケーション ログ ファイルを確認し、ロボット エージェントがロボット アプリに正常に接続されていることを確認します。
ログファイルの末尾に、ロボット エージェントサービスの開始日時と一致する INFO|Connected エントリがあるかどうかを確認します。
ログファイルのデフォルトの場所は、次のとおりです。C:\acl\robots\logs\application.log
- ロボットアプリで[エージェント管理]画面に進み、[F5]を押してページを再読み込みします。
ロボット エージェントが[オンライン]状態でが表示されていれば、正常に登録されています。
ロボット アプリでロボット エージェントの設定を構成する
組織に該当する場合は、ロボット アプリでデフォルトの値を 2 つのロボット エージェントの構成設定用に更新します。
- 許可されたファイル アップロードは、出力結果がクラウドのロボットエージェントからロボットアプリにアップロードされるかどうかを制御します:
- パスの設定は、Analytics のデータテーブルと結果テーブル向けに Windows サーバーまたはネットワークディレクトリを指定します
詳細については、「オンプレミスロボット エージェントの設定」を参照してください。
ロボットエージェントをテスト
ロボットエージェントをインストールしたら、シンプルなスクリプトをコミットして実行し、ロボットエージェントが適切に動作していることをテストできます。
メモ
このテストでは、ロボットへのファイルのアップロードが許可されている必要があります。必要に応じて、一時的にテスト用にファイルのアップロードを有効にします。詳細については、「オンプレミスロボット エージェントの設定」を参照してください。
Analytics プロジェクトを作成し、テストファイルをダウンロード
- Robots Agent test.acl という名の新しい Analytics プロジェクトを作成します。
- 以下のリンクを右クリックし、今作成したプロジェクト、 として、そのファイルを同じフォルダに保存します。
テストスクリプトをコピー
- Analytics プロジェクトで、Robots_Agent_test_script という名の新しいスクリプトを作成します。
- 以下のリンクをクリックし、ブラウザでテストスクリプト、 を開きます。
- [Ctrl+A]を押してスクリプト全体を選択し、[Ctrl+C]を押してこれをクリップボードにコピーします。
- そのスクリプトを Robots_Agent_test_script に貼り付け、[開いているプロジェクトを保存 ]をクリックします。.
スクリプトをロボットにコミットし、すぐにロボットを作成する
- Analytics メインメニューから、[ファイル]>[スクリプトをコミット]を選択します。
- 必要に応じて、[送信先を選択]ダイアログボックスで、該当する Diligent One インスタンスをダブルクリックします。
[ロボットコレクション]が、すでにロボットがある場合は、既存のロボットのリストを伴って表示されます。ロボットは、スクリプト、データ、自動化されたタスクのコンテナーです。
- [新しいロボット]フィールドに "ロボットをテスト" と入力し、[作成]をクリックします。.
ロボットが作成され、ロボット ID が自動的に生成されます。
- [スクリプトをコミット]ダイアログボックスで、 "テストスクリプトをアップロード" のようにコミットメッセージを入力し、[OK]をクリックします。
スクリプトがロボットにコミットされ、直前に作成したロボットに保管されます。
- スクリプトのコミットが成功しました]ダイアログボックスで、2 番目のリンクをクリックします。
結果 ロボット アプリが、[スクリプトバージョン]タブが選択された状態で、ブラウザのウィンドウで開きます。Diligent One にサインインすることを求められる場合があります。直前にコミットしたスクリプトバージョンが表示されるはずです。
- Analytics で、[OK]をクリックし、[スクリプトのコミットが成功しました]ダイアログボックスを終了します。
テストファイルをアップロード
- ロボットで、[入力/出力]タブを選択します。
- コンピューターから選択]をクリックし、Robots_Agent_test_file.txt を保存した場所を参照します。
- ファイルを選択し、[開く]をクリックします。
結果 ファイルがアップロードされ、[入力/出力]タブの[ファイル]の下に表示されます。
タスクを作成し、テストスクリプトを実行
- [タスク]タブを選択し、[タスクを作成]をクリックします。
- タスクに対して "タスクをテスト" という名前を入力し、[保存]をクリックします。
- [ロボットエージェントテストスクリプト ]を選択し、[最後にスキップ > タスクを確認し作成する]をクリックします。
- [タスク]タブの [タスクをテスト]で [ > 今すぐ実行]をクリックします。
結果 テストスクリプトを伴ってタスクが実行します。
タスクのステータスが "成功" となって完了した場合は、インストールしたオンプレミスのロボットエージェントは適切に動作していることになります。
メモ
タスクが失敗した場合は、ロボット エージェントサービスがロボット エージェントをインストールしたサーバー上で動作していることを確認します。動作していない場合はサービスを開始し、[タスクをテスト]をもう一度実行してみます。
タスクが引き続き失敗する場合は、Diligent サポートに連絡して支援を受けてください。
スクリプトの出力を検証
ロボットで次の場所を確認し、テストスクリプトが適切なファイルを出力していることを確認します。
ロボットの場所 | ファイルがテストスクリプトごと出力 |
---|---|
[タスクの実行]タブ [タスクをテスト]エントリを選択します。 |
[タスク実行の詳細]サイドパネルの[出力:
|
[入力/出力]タブ Robots_Agent_test_file エントリを選択します。 |
[その他のテーブル]セクション:
Robots_Agent_test_file を選択します。[テーブルの詳細]サイドパネルの[フィールド]: これらのフィールドの[名前]、[タイプ]、[サイズ](長さ) 情報が表示されるはずです:
|
ロボット エージェントをアップグレードする
ロボット エージェントのインストールパッケージを使用して、既存のロボット エージェントのインストールをバージョン 17.0 にアップグレードしてください。
アップグレードを実行する前に、ロボットのタスクが実行中である、キューに追加される、または間もなく実行するようスケジュールされていることがないようにしてください。
メモ
アップグレードを完了するには、Windows サーバーのローカル管理者権限が必要です。
ロボット エージェント Windows サービスを停止する
- ロボットエージェントが配置されている Windows サーバーで、Windows サービスマネージャーを開きます。
- ロボットエージェントの Windows サービスを両方とも停止します。
- ロボット エージェント**
- ロボットデータサービス
インストールパッケージをダウンロードする
- Launchpad から、ロボットエージェントのインストールパッケージ (RobotsAgent17.exe) をダウンロードします:
- Launchpad (www.highbond.com) にサインインします。
- [リソース]の下にある[ダウンロード]をクリックします。
- トップメニューで、[ロボット エージェント]をクリックします。
- [バージョン 17 をダウンロード]をクリックします。
- ダウンロードしたインストールパッケージが Windows サーバーにある状態で、インストールパッケージをダブルクリックします。
-
セキュリティ警告のダイアログ ボックスが表示された場合は、リストされた情報を確認して、[はい]をクリックします。
ヒント
セキュリティの警告ダイアログボックスは、開いているウィンドウの後ろに隠れている可能性があります。
インストーラの抽出と実行
- インストールに使用する言語を選択し、[OK]をクリックします。
- [セットアップの展開場所]ページで、インストールファイルを展開するフォルダーを指定して、[展開]をクリックします。
[参照] をクリックして、フォルダーを選択するか、デフォルトの場所を選択します(
C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent17
)。セットアップファイルは、指定したフォルダーに解凍されます。ファイルが展開された後、インストーラーが自動的に開始されます。
メモ
インストーラーが何らかの理由で起動されなかった場合は、Windows エクスプローラーを使ってセットアップ ファイルの展開先フォルダーに移動し、setup.exe をダブルクリックします。
- アップグレードのプロンプトでは[はい]をクリックします。
- [ロボットエージェントインストーラー情報]ダイアログボックスで、記載されている条件を満たしている場合は、[OK]のみをクリックしてください。
まだ、これらの要件に対応していない場合は、アップグレードを続行する前に、これらの要件に対応してください。必要であれば、まもなく実行予定のロボットのタスクを一時的に無効にしてください。
必須コンポーネントのインストール(必要な場合)
必須コンポーネントをインストールするよう求められた場合は、[インストール]をクリックします。
必須コンポーネントがインストールされた後、インストーラーは自動的に進みます。
ソフトウェア必須コンポーネントの一覧については、オンプレミス ロボット エージェントのシステム要件を参照してください。
インストール プロパティを構成する
- [ウェルカム]ページで、[次へ]をクリックします。
- [使用許諾契約]ページで、[上記の条項に同意します]を選択して、[次へ]をクリックします。
- [ロボット エージェントのエディションの選択]ページで、[次へ]をクリックします。
インストーラーは、現在インストールされているロボットエージェントのエディション (非ユニコードまたはユニコード) を強制的に適用します。
メモ
アップグレード中にエディションを変更することはできません。エディションを変更するには、現在のロボット エージェントをアンインストールし、バージョン 17.0 をインストールする必要があります。
- [任意の Analytics データ コネクター]ページで、オプションのコネクターをインストールしいない理由がない限り、[インストール]オプションを選択したままにし、[次へ]をクリックします。
メモ
オプションのコネクターをインストールしないことを選択し、これらのいずれかを後で使用したい場合は、ロボット エージェントをアンインストールし、また再インストールする必要があります。
- [機械学習を有効にする]ページで、Python エンジンをインストールしない理由がない限り、[有効化]オプションを選択したままにし、[次へ]をクリックします。
メモ
Python エンジンをインストールしないことを選択し、機械学習のコマンドを実行するためにこれを後で使用したい場合は、ロボット エージェントをアンインストールし、また再インストールする必要があります。
- [ロボット エージェント サービスの設定]ページで、次のサービス アカウントの設定を完了し、[次へ]をクリックします。
- ロボット データ サービスのポート番号 データ サービスに指定された既存のポートを維持するか、異なるポートを指定します。
0 ~ 65536 で利用できるポートを指定できます。
- ロボット エージェントサービスのアカウント ロボット エージェントサービスを実行する既存のドメインアカウントを維持するか、異なるアカウントを指定します。アカウントのパスワードを入力します。
Domain\service_account の形式で指定されたドメイン アカウントである必要があります。このアカウントには、Windows Server オペレーティング システムでサービスを実行する権限と、既存のロボット エージェントのデータ フォルダへのフル アクセス権が必要になります。詳細については、「オンプレミス ロボット エージェントのセキュリティ」を参照してください。
メモ
ロボット エージェントサービスのアカウントを変更する必要がある場合は、アップグレード後に変更することを推奨します。
アップグレード中にインストーラーでアカウントを変更した場合、ロボット エージェントの再登録が必要です。インストール済みエージェントの再登録は、組織のロボットインスタンスの設定に影響を与える可能性があります。
詳細については、「ロボット エージェントのサービスアカウントを変更する」を参照してください。
- ロボット データ サービスのポート番号 データ サービスに指定された既存のポートを維持するか、異なるポートを指定します。
- 次の画面で構成情報をレビューし、[次へ]をクリックします。
アップグレードの実行
- [プログラムをインストールする準備ができました]ページでは、[インストール]をクリックします。
ロボットエージェントがアップグレードされます。
- Microsoft Access データベースエンジンのインストールを選択するプロンプトが表示された場合は、次のいずれかを実行してください。
- ロボットエージェントが古い Excel ファイル (*.xls) や Microsoft Access ファイル (*.mdb) からインポートまたはエクスポートする必要がある場合は、「はい」をクリックしてデータベースエンジンをインストールしてください。
- ロボットエージェントを現在の世代の Excel ファイル (*.xlsx) のみで使用し、古い Excel ファイルや Microsoft Access ファイルを使用しない場合は、[いいえ]をクリックしてデータベースエンジンを除外してください。データベースエンジンは、他の新しい Microsoft Office 製品との互換性の問題を引き起こす可能性があります。このため、データベースエンジンは、実際に必要な場合を除き、除外する必要があります。
- アップデート処理が完了したら、[完了]をクリックします。
- [はい]をクリックしてサーバーを再起動し、アップグレードを完了します。
-
Windows Services マネージャーで、ロボット エージェント Windows サービスが実行中であることを確認します。
- ロボット エージェント
- ロボット データ サービス
必要に応じて、いずれかまたは両方のサービスを開始します。
ロボットエージェントの追加インスタンスをインストール
ロボットエージェントのインストールパッケージを使用し、追加のWindows サーバー上にロボットエージェントの追加インスタンスをインストールします。
複数のエージェントをインストールすると、アナリティクスの処理能力が向上し、エージェント全体に負荷分散を実装できます。複数のロボットのタスクを同時に実行する場合、アナリティクススクリプトの処理は、複数の Wiindows サーバー上の複数のエージェント間で自動的に分配されます。この機能により、より短期間により多くの数のタスクを実行できます。
メモ
複数のエージェント機能は、ロボットの開発モードと本稼働モードとは関係がありません。タスクを実行する際は、どちらのモードでもすべてのエージェントに同等にアクセスできます。
重要
複数のエージェントをインストールするには、すべてのエージェントがバージョン15以上であり、またすべてが同じエンコード (すべてが非 Unicode、またはすべてが unicode) を使用している必要があります。
すべてのエージェントは、[エージェント管理]画面でスクリプト出力テーブルに指定したディレクトリにもアクセスできる必要があります。指定したディレクトリごとに、エージェントを実行するサービス アカウントに対して読み取り/書き込み/リスト権限を付与する必要があります。詳細については、「オンプレミスロボット エージェントの設定」を参照してください。
メモ
ロボットエージェントをインストールする各 Windows サーバーには、ローカルの管理者権限が必要です。
これらのインストールはサーバー #1 とサーバー #2 を参照しています:
- サーバー #1 ロボットエージェントの最初のインスタンスをインストールした Windows サーバー
- サーバー #2 ロボットエージェントの追加のインスタンスをインストールする追加の Windows サーバー
メモ
必要なだけ多くの追加エージェントとサーバーについてプロセスを繰り返すことができます。
サーバー #2 にロボットエージェントをインストール
- サーバー #2 では、サーバー #1 にロボットエージェントをインストールするために使用したものと同じインストールプロセスを実行します。
-
インストーラーの [インストール先フォルダー]ページで、[登録ファイルをコピー]を選択せず、[ロボット エージェントの登録ファイルの場所]フィールドを空白にします。
インストール手順については、ロボット エージェントをインストールするを参照してください。
ロボット アプリから RSA キーの名前を取得
- Diligent One(www.highbond.com) にサインインします。
- Launchpad ホームページの[監査とアナリティクス]の下で、ロボット アプリをクリックします。
- ダッシュボードの右上隅で[設定]をクリックします。
- 左側のペインで、[エージェント管理]が選択されていることを確認します。
- [その他のエージェントを追加する方法]をクリックします。
- []をクリックすると、RSA キーの名前がクリップボードにコピーされます。
- RSA キーの名前を一時的なストレージのテキストファイルに貼り付けます。
ファイルでロボットエージェント RSA キーをバンドルする
サーバー #1 で EncryptionKeyCLI.exe ユーティリティを使用し、ファイルでロボットエージェント RSA キーをバンドルします。
メモ
追加のロボットエージェントをすでにインストールし、RSA キーを含む zip ファイルを作成している場合は、既存のファイルを使用します。もう一つコピーを作成する必要はありません。
- サーバー #1 では、管理者として Windows コマンドプロンプトを開きます。
- 次のコマンドを実行し、ロボットエージェントのインストールディレクトリに変更します:
cd C:\Program Files (x86)\ACL Software\Robots Agent\agent
デフォルトのディレクトリにロボットエージェントをインストールしなかった場合は、適切なパスを指定します。
- 次のコマンドを実行して、zip ファイルにロボット エージェント RSA キーをバンドルします。
EncryptionKeyCLI.exe export RSAKeyfile ACL_XXXXXXXX
ACL_XXXXXXXX には、ロボットの[エージェント管理]画面からコピーした実際の RSA キーの名前に置き換えます。
RSAKeyfile は、指定したいファイル名にします (スペースは入れません)。任意で、サーバー上の既存のフォルダーへのファイル パスを指定できます。パスにスペースが含まれている場合は、パス全体とファイル名を二重引用符で囲みます。
- 必要に応じて、Y と入力して既存のファイルを上書きします。
結果 RSA キーは、zip ファイルにバンドルされ、デフォルトの場所(C:\ProgramData\robots\RSAKeyfile.zip)または指定した場所に保存されます。
メモ
ProgramData フォルダーが表示されない場合は、非表示になっていることがあります。フォルダーを表示するには、Windows ファイル エクスプローラーで C:\ ルート ディレクトリの[非表示の項目]を選択します([表示]タブ > [非表示の項目])。
RSA キーファイルをサーバー #2 に移行
サーバー #2 の EncryptionKeyCLI.exe ユーティリティを使用し、zip ファイルからロボットエージェント RSA キーを抽出し、これを Microsoft キーストアにインポートします。
- サーバー #1 から、サーバー #2 のロボットエージェントインストールディレクトリに RSAKeyfile.zip をコピーします。
デフォルトのインストールディレクトリは C:\Program Files (x86)\ACL Software\Robots Agent\agent です。
- サーバー #2 では、管理者として Windows コマンドプロンプトを開きます。
- 次のコマンドを実行し、ロボットエージェントのインストールディレクトリに変更します:
cd C:\Program Files (x86)\ACL Software\Robots Agent\agent
デフォルトのディレクトリにロボットエージェントをインストールしなかった場合は、適切なパスを指定します。
- 次のコマンドを実行し、zip ファイルからロボットエージェント RSA キーを抽出し、これをサーバー #2 の Microsoft キーストアにインポートします:
EncryptionKeyCLI.exe import RSAKeyfile
zip ファイル名を RSAKeyfile にしなかった場合は、使用した名前を代用します。
登録キーファイルをサーバー #2 にコピー
登録キーファイル (registration.key) を、サーバー #1 のロボットエージェントインストールディレクトリから、サーバー #2 のロボットエージェントインストールディレクトリにコピーします。
デフォルトのインストールディレクトリは C:\Program Files (x86)\ACL Software\Robots Agent\agent です。
サーバー #2 でロボットエージェントサービスを再起動
サーバー #2 では、Windows サービスマネージャーを開き、ロボット エージェント サービスを再起動します。
追加のエージェントが正常に登録されていることを確認
ロボットアプリで[エージェント管理]画面に進み、[F5]を押してページを再読み込みします。"オンライン" というステータスのリストに追加のロボットエージェントが表示されていれば、正常に登録されています。このエージェントは、アナリティクスの処理と負荷分散に使用されるエージェントクラスターの一部になっています。