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

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

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