オンプレミスロボット エージェントのインストールまたはアップグレード

インストーラーのダウンロードとインストールの開始

1. プラットフォーム ホームから、次のようにしてロボット エージェントのインストール パッケージ (RobotsAgent19.exe) をダウンロードします。

   1. Diligent One (www.diligentoneplatform.com) にサインインします。

   2. Launchpad の［監査とアナリティクス］で、［アナリティクス］タイルを選択してダウンロードにアクセスします。

   3. トップ メニューで、ロボット エージェントを選択します。

   4. ［バージョン 19 のダウンロード］を選択します。

      インストール パッケージがコンピューターにダウンロードされます。必要に応じて、ロボット エージェントをインストールするサーバーにインストール パッケージをコピーします。

2. 他のすべての Windows アプリケーションを閉じます。

3. インストールパッケージをダブルクリックします。

4. セキュリティ警告のダイアログ ボックスが表示された場合は、リストされた情報を確認して、［はい］を選択します。

   ヒント

   セキュリティの警告ダイアログボックスは、開いているウィンドウの後ろに隠れている可能性があります。

5. インストールに使用する言語を選択し、［OK］を選択します。

インストールファイルを抽出

［セットアップの展開場所］ページで、インストール ファイルを展開するフォルダーを指定して、［展開］を選択します。

［参照］を選択してフォルダーを選択するか、または次のデフォルトの場所をそのまま使用します。

C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent19

セットアップファイルは指定したインストール先フォルダーに展開されます。ファイルが展開された後、インストーラーが自動的に開始されます。

必須コンポーネントをインストール（必要な場合）

必須コンポーネントをインストールするよう求められた場合は、［インストール］を選択します。必須コンポーネントがインストールされた後、インストーラーは自動的に進みます。

ソフトウェア必須コンポーネントの一覧については、「オンプレミス ロボット エージェントのシステム要件」を参照してください。

インストール プロパティを構成する

1. ［ようこそ］ページで、［次へ］を選択します。

2. ［使用許諾契約］ページで、［上記の条項に同意します］を選択して、［次へ］を選択します。

3. ［ロボット エージェントのエディションの選択］ページで、インストールするエディションを選択し、［次へ］を選択します。

   • 非 Unicode 版

   • Unicode

   注意

   インストールするエディションが、御社に合ったエディションであることを確認してください。Analytics でロボット エージェントテーブルを開くには、エディションが一致している必要があります。

   マルチエージェントクラスターを設定する場合は、クラスターのすべてのエージェントは同じエディションでなければなりません。すべてが非 Unicode またはすべてが Unicode。

   詳細については、Diligent Unicode 製品を参照してください。

4. ［機械学習を有効にする］ページで、Python エンジンをインストールしない理由がない限り、［有効化］オプションを選択したままにし、［次へ］を選択します。

   メモ

   Python エンジンをインストールしないことを選択し、機械学習のコマンドを実行するためにこれを後で使用したい場合は、ロボット エージェントをアンインストールし、また再インストールする必要があります。

5. ［ロボット エージェント サービスの設定］ページで、次のサービス アカウントの設定を完了し、［次へ］を選択します。

   • ロボット データ サービスのポート番号データ サービスのポートを指定するか、既定の 10000 を使用します。

     0 ～ 65536 で利用できるポートを指定できます。

   • ロボット エージェント サービス アカウント既存のドメイン アカウントを指定し、ロボット エージェント サービスを実行して、パスワードを提供します。

     Domain\service_account_name の形式で指定されたドメイン アカウントである必要があります。このアカウントには、Windows Server オペレーティング システムでサービスを実行する権限と、インストール時に指定するデータ フォルダへのフル アクセス権が必要になります。詳細については、オンプレミス ロボット エージェントのセキュリティを参照してください。

     メモ

     必要であれば、インストール後にロボット エージェントサービスのアカウントを変更することができます。

6. ロボット エージェントサービスのアカウントに「サービスとしてログオン」権限を付与するよう求められたら、［はい］、［OK］の順に選択します。

7. ［宛先フォルダー］ページで、次の宛先と接続の設定を完了し、［次へ］を選択します。

   • ロボット エージェントのインストール先フォルダー

     • ロボット エージェントのインストール先フォルダーを選択するか、既定の場所を使用します。

       デフォルト：C:\Program Files (x86)\ACL Software\Robots Agent\

     • データ フォルダーの場所を選択するか、既定の場所を使用します。

       デフォルト：C:\acl\robots\

       メモ

       インストール先フォルダー内、またはその反対側にデータ フォルダーを格納しないでください。そこに格納すると、ロボット エージェントのアンインストール時にデータを損失する可能性があります。

   • ロボット エージェント登録ファイルの場所

     • ［登録ファイルをコピー］を選択し、registration.key ファイルの場所を参照するか、ファイル パスを手動で入力します。

       インストーラーが実行されると、キーファイルが自動的にロボット エージェント ディレクトリ構造の正しい場所にコピーされます。

       メモ

       ロボット エージェントのインストール後にロボット エージェントサービスのアカウントを変更する場合は、［登録ファイルをコピー］は未選択のままにして、登録ファイルを指定しないでください。

インストールを完了する

1. ［プログラムをインストールする準備ができました］ページで、［インストール］を選択します。

   ロボット エージェントがインストールされます。

2. インストール処理が完了したら、［完了］を選択します。

ロボット エージェントサービスが実行されていることを確認する

ロボット エージェントがロボット アプリに接続するためには、ロボット エージェントサービスが起動している必要があります。接続がない場合、ロボット エージェントはロボットのタスクやスクリプトを処理できません。

必要に応じて、ロボット エージェントサービスの実行を確認すると同時に、ロボット エージェントサービスのアカウントを変更できます。

インストール時に指定したロボット エージェントサービスのアカウントを使用する

1. Windows サービスマネージャーを開きます。

2. ロボット エージェントの Windows サービスが 2 つとも起動していることを確認します。

   • ロボット エージェント

   • ロボットデータサービス

   必要であれば、一方または両方のサービスを開始します。

   メモ

   「ロボット エージェントサービスが起動して停止した」というエラーメッセージが表示される場合は、ロボット エージェントの登録が正常に行われていない可能性があります。

   ロボット エージェントのインストールディレクトリに登録キーファイル (registration.key) が存在することを確認してください。登録キーファイルがない場合は、キーファイルを保存した場所からインストールディレクトリに手動でコピーします。ロボット エージェントサービスを再度起動します。

   デフォルトのインストール ディレクトリーは C:\Program Files (x86)\ACL Software\Robots Agent\agent です。

3. アプリケーション ログ ファイルを確認し、ロボット エージェントがロボット アプリに正常に接続されていることを確認します。

   ログファイルの末尾に、ロボット エージェント サービスの開始日時と一致する INFO|Connected エントリがあるかどうかを確認します。

   ログ ファイルのデフォルト ロケーションは、C:\acl\robots\logs\application.log です。

4. ロボットアプリで［エージェント管理］画面に進み、［F5］を押してページを再読み込みします。

   ロボット エージェントが［オンライン］状態でが表示されていれば、正常に登録されています。

ロボット エージェントサービスのアカウントを変更する

ロボット エージェントのインストール時に［登録ファイルをコピー］が選択されていない状態で、ロボット エージェントサービスのアカウントを変更する場合は、以下の手順に従います。

登録キーファイルを手動でインストールする

1. 登録キーファイル (registration.key) を保存先からコピーします。

2. ロボット エージェントのインストール ディレクトリに移動し、agent サブフォルダに登録用キー ファイルを貼り付けます。

   デフォルトのインストール ディレクトリーは C:\Program File (x86)\ACL Software\Robots Agent\agent です。

   必要に応じて、既存のキーファイルを削除または上書きします。

ロボット エージェントサービスを別のアカウントに変更する

1. Windows サービスマネージャーを開きます。

2. ロボット エージェント サービスを右クリックし、［プロパティ］を選択します。

3. ［ログオン］タブで、［参照］を選択します。

4. ［ユーザーを選択］ダイアログボックスの ［選択するオブジェクト名を入力してください］フィールドに、使用するサービス アカウントの名前を入力し、［名前を確認］を選択します。

   フィールドにサービスアカウントが事前入力されているはずです。

5. ［OK］を選択します。

6. ［ログオン］タブで、サービス アカウントのパスワードを入力および確認し、［OK］を選択します。

7. Windows サービスマネージャーで、ロボット エージェント サービスを再起動（または起動）します。

8. 必要に応じて、ロボットデータサービスを起動します。

ロボット エージェントが正常に登録されたことを確認する

1. アプリケーション ログ ファイルを確認し、ロボット エージェントがロボット アプリに正常に接続されていることを確認します。

   ログファイルの末尾に、ロボット エージェント サービスの開始日時と一致する INFO|Connected エントリがあるかどうかを確認します。

   ログ ファイルのデフォルト ロケーションは、C:\acl\robots\logs\application.log です。

2. ロボットアプリで［エージェント管理］画面に進み、［F5］を押してページを再読み込みします。

   ロボット エージェントが［オンライン］状態でが表示されていれば、正常に登録されています。

ロボット アプリでロボット エージェントの設定を構成する

組織に該当する場合は、ロボット アプリでデフォルトの値を 2 つのロボット エージェントの構成設定用に更新します。

• 許可されたファイル アップロードクラウドでロボット エージェントからロボット アプリにアップロードされる出力結果を制御します。

• パスの設定Analytics のデータテーブルと結果テーブル向けに Windows サーバーまたはネットワークディレクトリを指定します

詳細については、「オンプレミスロボット エージェントの設定」を参照してください。

Analytics プロジェクトを作成し、テストファイルをダウンロード

1. Robots Agent test.acl という名の新しい Analytics プロジェクトを作成します。

2. 以下のリンクを右クリックし、ファイルを今作成したプロジェクトと同じフォルダーに保存します。

   Robots_Agent_test_file.txt

テストスクリプトをコピー

1. Analytics プロジェクトで、Robots_Agent_test_script という名の新しいスクリプトを作成します。

2. 以下のリンクを選択し、ブラウザーでテスト スクリプトを開きます。

   Robots_Agent_test_script.txt

3. ［Ctrl+A］を押してスクリプト全体を選択し、［Ctrl+C］を押してこれをクリップボードにコピーします。

4. そのスクリプトを Robots_Agent_test_script に貼り付け、［開いているプロジェクトを保存 ］を選択します。

スクリプトをロボットにコミットし、すぐにロボットを作成する

1. Analytics メインメニューから、［ファイル］>［スクリプトをコミット］を選択します。

2. 必要に応じて、［送信先を選択］ダイアログボックスで、該当する Diligent One インスタンスをダブルクリックします。

   ［ロボットコレクション］が、すでにロボットがある場合は、既存のロボットのリストを伴って表示されます。ロボットは、スクリプト、データ、自動化されたタスクのコンテナーです。

3. ［新しいロボット］フィールドに "ロボットをテスト" と入力し、［作成］を選択します。

   ロボットが作成され、ロボット ID が自動的に生成されます。

4. ［スクリプトをコミット］ダイアログボックスで、"テスト スクリプトをアップロード" のようにコミット メッセージを入力し、［OK］を選択します。

   スクリプトがロボットにコミットされ、直前に作成したロボットに保管されます。

5. ［スクリプトのコミットが成功しました］ダイアログボックスで、2 番目のリンクを選択します。

   結果ロボットアプリが、［スクリプトバージョン］タブが選択された状態で、ブラウザーのウィンドウで開きます。Diligent One にサインインすることを求められる場合があります。直前にコミットしたスクリプトバージョンが表示されるはずです。

6. アナリティクスで、［OK］を選択し、［スクリプトのコミットが成功しました］ダイアログボックスを終了します。

テストファイルをアップロード

1. ロボットで、［入力/出力］タブを選択します。

2. ［コンピューターから選択］を選択し、Robots_Agent_test_file.txt を保存した場所を参照します。

3. ファイルを選択し、［開く］を選択します。

   結果ファイルがアップロードされ、［入力/出力］タブの［ファイル］の下に表示されます。

タスクを作成し、テストスクリプトを実行

1. ［タスク］タブを選択し、［タスクを作成］を選択します。

2. タスクに対して "タスクをテスト" という名前を入力し、［保存］を選択します。

3. ［ロボット エージェント テスト スクリプト ］を選択し、［最後にスキップ > タスクを確認し作成する］を選択します。

4. ［タスク］タブの［タスクをテスト］で［ > 今すぐ実行］を選択します。

   結果テストスクリプトを伴ってタスクが実行します。

   タスクのステータスが成功となって完了した場合は、インストールしたオンプレミスのロボットエージェントは適切に動作していることになります。

   メモ

   タスクが失敗した場合は、ロボット エージェント サービスがロボット エージェントをインストールしたサーバー上で動作していることを確認します。動作していない場合はサービスを開始し、［タスクをテスト］をもう一度実行してみます。

   タスクが引き続き失敗する場合は、Diligent サポートに連絡して支援を受けてください。

スクリプトの出力を検証

ロボットで次の場所を確認し、テストスクリプトが適切なファイルを出力していることを確認します。

ロボット エージェント Windows サービスを停止する

1. ロボットエージェントが配置されている Windows サーバーで、Windows サービスマネージャーを開きます。

2. ロボットエージェントの Windows サービスを両方とも停止します。

   • ロボット エージェント

   • ロボットデータサービス

インストーラーのダウンロードとアップグレードの開始

1. プラットフォーム ホームから、次のようにしてロボット エージェントのインストール パッケージ (RobotsAgent19.exe) をダウンロードします。

   1. Diligent One (www.diligentoneplatform.com) にサインインします。

   2. Launchpad の［監査とアナリティクス］で、［アナリティクス］タイルを選択してダウンロードにアクセスします。

   3. トップ メニューで、ロボット エージェントを選択します。

   4. ［バージョン 19 のダウンロード］を選択します。

      インストール パッケージがコンピューターにダウンロードされます。必要に応じて、ロボット エージェントをアップグレードするサーバーにインストール パッケージをコピーします。

2. 他のすべての Windows アプリケーションを閉じます。

3. インストールパッケージをダブルクリックします。

4. セキュリティ警告のダイアログ ボックスが表示された場合は、リストされた情報を確認して、［はい］を選択します。

   ヒント

   セキュリティの警告ダイアログボックスは、開いているウィンドウの後ろに隠れている可能性があります。

5. インストールに使用する言語を選択し、［OK］を選択します。

インストール ファイルを解凍してアップグレードを確認する

1. ［セットアップの展開場所］ページで、インストール ファイルを展開するフォルダーを指定して、［展開］を選択します。

   ［参照］を選択してフォルダーを選択するか、または次のデフォルトの場所をそのまま使用します。

   C:\Users\user_account_name\Downloads\ACL Installers\RobotsAgent19

   セットアップファイルは指定したインストール先フォルダーに展開されます。ファイルが展開された後、インストーラーが自動的に開始されます。

   メモ

   インストーラーが何らかの理由で起動されなかった場合は、Windows エクスプローラーを使ってセットアップファイルの展開先フォルダーに移動し、setup.exe をダブルクリックします。

2. アップグレードのプロンプトでは［はい］を選択します。

3. ［ロボット エージェント インストーラー情報］ダイアログボックスで、記載されている条件を満たしている場合は、［OK］のみを選択してください。

   まだ、これらの要件に対応していない場合は、アップグレードを続行する前に、これらの要件に対応してください。必要であれば、まもなく実行予定のロボットのタスクを一時的に無効にしてください。

必須コンポーネントをインストール（必要な場合）

必須コンポーネントをインストールするよう求められた場合は、［インストール］を選択します。必須コンポーネントがインストールされた後、インストーラーは自動的に進みます。

ソフトウェア必須コンポーネントの一覧については、「オンプレミス ロボット エージェントのシステム要件」を参照してください。

インストール プロパティを構成する

1. ［ようこそ］ページで、［次へ］を選択します。

2. ［使用許諾契約］ページで、［上記の条項に同意します］を選択して、［次へ］を選択します。

3. ［ロボット エージェントのエディションの選択］ページで、［次へ］を選択します。

   インストーラーは、現在インストールされているロボットエージェントのエディション（非ユニコードまたはユニコード）を強制的に適用します。

   メモ

   アップグレード中にエディションを変更することはできません。エディションを変更するには、現在のロボット エージェントをアンインストールし、バージョン 19.0 をインストールする必要があります。

4. ［機械学習を有効にする］ページで、Python エンジンをインストールしない理由がない限り、［有効化］オプションを選択したままにし、［次へ］を選択します。

   メモ

   Python エンジンをインストールしないことを選択し、機械学習のコマンドを実行するためにこれを後で使用したい場合は、ロボット エージェントをアンインストールし、また再インストールする必要があります。

5. ［ロボット エージェント サービスの設定］ページで、次のサービス アカウントの設定を完了し、［次へ］を選択します。

   • ロボット データ サービスのポート番号データ サービスに指定された既存のポートを維持するか、異なるポートを指定します。

     0 ～ 65536 で利用できるポートを指定できます。

   • ロボット エージェント サービス アカウントロボット エージェント サービスを実行する既存のドメイン アカウントを維持するか、異なるアカウントを指定します。アカウントのパスワードを入力します。

     Domain\service_account_name の形式で指定されたドメイン アカウントである必要があります。このアカウントには、Windows Server オペレーティング システムでサービスを実行する権限と、既存のロボット エージェントのデータ フォルダへのフル アクセス権が必要になります。詳細については、オンプレミス ロボット エージェントのセキュリティを参照してください。

     メモ

     ロボット エージェントサービスのアカウントを変更する必要がある場合は、アップグレード後に変更することを推奨します。

     アップグレード中にインストーラーでアカウントを変更した場合、ロボット エージェントの再登録が必要です。インストール済みエージェントの再登録は、組織のロボットインスタンスの設定に影響を与える可能性があります。

     詳細については、「ロボット エージェントのサービスアカウントを変更する」を参照してください。

6. 次の画面で構成情報をレビューし、［次へ］を選択します。

アップグレードの実行

1. ［プログラムをインストールする準備ができました］ページで、［インストール］を選択します。

   ロボットエージェントがアップグレードされます。

2. アップデート処理が完了したら、［完了］を選択します。

3. ［はい］を選択してサーバーを再起動し、アップグレードを完了します。

4. Windows Services マネージャーで、ロボット エージェント Windows サービスが実行中であることを確認します。

   • ロボット エージェント

   • ロボットデータサービス

   必要であれば、一方または両方のサービスを開始します。

これらのインストールはサーバー #1 とサーバー #2 を参照しています:

• サーバー #1ロボットエージェントの最初のインスタンスをインストールした Windows サーバー

• サーバー #2ロボットエージェントの追加のインスタンスをインストールする追加の Windows サーバー

  メモ

  必要なだけ多くの追加エージェントとサーバーについてプロセスを繰り返すことができます。

サーバー #2 にロボットエージェントをインストール

1. サーバー #2 では、サーバー #1 にロボットエージェントをインストールするために使用したものと同じインストールプロセスを実行します。

2. インストーラーの ［インストール先フォルダー］ページで、［登録ファイルをコピー］を選択せず、［ロボット エージェントの登録ファイルの場所］フィールドを空白にします。

インストール手順については、「 」を参照してください

ロボットアプリから RSA キーの名前を取得

1. プラットフォーム ホーム ページ (www.diligentoneplatform.com) から、ロボット アプリを選択して開きます。

   すでに Diligent One を使用している場合は、左側のナビゲーション メニューを使用してロボット アプリに切り替えることができます。

2. ダッシュボードの右上隅で［設定］を選択します。

3. 左側のペインで、［エージェント管理］が選択されていることを確認します。

4. ［その他のエージェントを追加する方法］を選択します。

5. ［］を選択すると、RSA キーの名前がクリップボードにコピーされます。

6. RSA キーの名前を一時的なストレージのテキストファイルに貼り付けます。

ファイルでロボットエージェント RSA キーをバンドルする

サーバー #1 で EncryptionKeyCLI.exe ユーティリティを使用し、ファイルでロボットエージェント RSA キーをバンドルします。

1. サーバー #1 では、管理者として Windows コマンドプロンプトを開きます。

2. 次のコマンドを実行して、ロボット エージェントのインストール ディレクトリに移動します。

   cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

   デフォルトのディレクトリにロボット エージェントをインストールしなかった場合は、適切なパスを指定してください。

3. 次のコマンドを実行して、zip ファイルにロボットエージェント RSA キーをバンドルします。

   EncryptionKeyCLI.exe export RSAKeyfile ACL_XXXXXXXX

   ACL_XXXXXXXX については、ロボットの［エージェント管理］画面からコピーした実際の RSA キーの名前を代用します。

   RSAKeyfile は、指定したいファイル名にします (スペースは入れません)。任意で、サーバー上の既存のフォルダーへのファイル パスを指定できます。パスにスペースが含まれている場合は、パス全体とファイル名を二重引用符で囲みます。

4. 必要に応じて、Y と入力して既存のファイルを上書きします。

   結果RSA キーは、zip ファイルにバンドルされ、デフォルトの場所 (C:\ProgramData\robots\RSAKeyfile.zip) または指定した場所に保存されます。

   メモ

   ProgramData フォルダーが表示されない場合は、非表示になっていることがあります。フォルダーを表示するには、Windows ファイル エクスプローラーで C:\ ルート ディレクトリの［非表示の項目］を選択します（［表示］タブ > ［非表示の項目］）。

RSA キーファイルをサーバー #2 に移行

サーバー #2 の EncryptionKeyCLI.exe ユーティリティを使用し、zip ファイルからロボットエージェント RSA キーを抽出し、これを Microsoft キーストアにインポートします。

1. サーバー #1 から、サーバー #2 のロボットエージェントインストールディレクトリに RSAKeyfile.zip をコピーします。

   デフォルトのインストール ディレクトリーは C:\Program Files (x86)\ACL Software\Robots Agent\agent です。

2. サーバー #2 では、管理者として Windows コマンドプロンプトを開きます。

3. 次のコマンドを実行して、ロボット エージェントのインストール ディレクトリに移動します。

   cd C:\Program Files (x86)\ACL Software\Robots Agent\agent

   デフォルトのディレクトリにロボット エージェントをインストールしなかった場合は、適切なパスを指定してください。

4. 次のコマンドを実行し、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］を押してページを再読み込みします。"オンライン" というステータスのリストに追加のロボットエージェントが表示されていれば、正常に登録されています。このエージェントは、アナリティクスの処理と負荷分散に使用されるエージェントクラスターの一部になっています。