はじめに

本記事ではUiPath製品をVDI環境にて使用する際の展開方法および留意事項について記載します。
この内容はバージョン2019.10 (LTS) に基づくものであり、将来のバージョンアップにより製品仕様が変更される可能性がありますので、予めご了承ください。

VDI製品の前提

UiPath製品は特定のVDI製品に依存することがないため、本記事では可能な限りニュートラルに記述しております。

仮想デスクトップは Windows 7 または 10 などのクライアントOS (同時に1ユーザーのデスクトップセッションのみ許可される) を前提とします。同時にマルチユーザーセッションが許可されるサーバーOSは「高密度ロボット」として利用可能ですが、本文書では対象外とします。
検証済みの製品についてはUiPath Studio/Robotのソフトウェア要件をご参照ください。

・https://studio.uipath.com/lang-ja/docs/software-requirements
・https://robot.uipath.com/lang-ja/docs/software-requirements

環境別考慮点

VDI環境およびUiPath環境の構成により、製品の展開方法および留意点が異なります。
ポイントとなる構成は下記の3点です。

1.  
2.  
3.  
4. 1.Orchestrator: 使用有無
   • Orchestrator有りの環境ではOrchestratorでライセンスが管理され、Orchestrator上であらかじめ定義されたロボットに動的にライセンスが付与されます。v2018.4以降ではStudioライセンスもOrchestratorで管理が可能となります。
   • Orchestrator無しの環境はローカルアクティベーションを行い、license.config で定義されたディレクトリ上にアクティベーション情報を保持します。
5.  
6. 2.割り当て: ユーザーとマシンの割り当てが固定(静的)かランダム(動的・流動的・プール型)か？
7. 
   
8. 
   
   • Orchestrator無しの環境は割り当ての種類による影響はありません。
   •  
   •  
   • Orchestrator有りの環境では、Orchestrator上のロボットは従来ユーザーとマシンの組み合わせで定義されています。このためユーザーとマシンの割り当てがランダムの場合には、それぞれを掛け算した数のロボットを登録する必要がありました。
     •  
     •  
     • この問題は、フローティングロボットを使用することにより、v2018.3以降はAttended ロボット、v2018.4以降はStudioを任意のマシンで使用可能となりました。
   •  
9. 3.パーシステンス: OS再起動やマスターイメージ更新した場合でもファイル変更が保持されるか？

・パーシステンス有りの環境では個々の仮想デスクトップをマスターイメージからフルクローンして作成するため、個々にファイル変更を永続的に保持することができます。

・パーシステンス無しの環境ではマスターイメージを一対多で仮想デスクトップに割り当て、個々のデスクトップでは差分情報のみを保持します。
この差分情報はOS再起動やマスターイメージ更新などの操作によりリセットされるため、個々のデスクトップでのファイル変更は破棄されます。

1. 
2.  
3. 
   
   • Orchestrator有り・パーシステンス無しの環境では、Orchestrator接続を行うための共通のマシンキーを予めマスターイメージ上で設定し、仮想デスクトップではフローティングロボットとしてAttendedロボットまたはStudioを使用することができます。ただしUnattendedロボットはマシンごとに異なるマシンキーが必要となるため使用することができません。
   •  
   •  
   • Orchestrator無しの環境では、デフォルトでローカルディスク上にアクティベーション情報が保持されますが、パーシステンスが無い場合には、再アクティベーションが求められます。
     •  
     • この問題を回避するには、ファイル共有など永続的なディスク上にアクティベーション情報を保持するように設定変更する必要があります。

それぞれの環境における留意事項一覧

留意事項の詳細

1. 1.Orchestrator有り・割り当てランダムの環境でUnattendedロボット使用の場合
2.  (パターン7) 
3. 現バージョン (v2019.10以前) ではUnattendedロボットはフローティングロボットに未対応のため、マシンとユーザーのすべての組み合わせをあらかじめ標準ロボットとして登録する必要があります。
   • すべての組み合わせが膨大になり登録することが現実的に難しい場合には、Unattendedロボットはマシンとユーザーの割り当てを固定に設定するようVDIを再構成することを推奨します。
   • この制限事項は将来のバージョンで改善される予定です。

1. 2.Orchestrator有り・割り当てランダムの環境でAttendedロボット使用の場合 
2. (パターン8, 11)
3.  v2018.3で導入されたフローティングロボット(Attended)を使用することにより、ユーザーのみをロボットとして登録し、共通のマシンキーを使用してOrchestrator接続された任意のマシンでAttendedロボットを実行することができます。
   • フローティングロボット(Attended)を使用するには次のナレッジベースをご参照ください。
   • フローティングロボットの機能と利点
4. 移動プロファイル環境でフローティングロボットを使用する際の注意点については次のナレッジベースをご参照ください。
   • 移動プロファイル環境でのプロセス実行時エラーの回避方法
5.  

1. 3.Orchestrator有り・割り当てランダムの環境でStudio使用の場合
2.  (パターン9, 12)
   • v2018.4で導入されたフローティングロボット(Development)を使用することにより、ユーザーのみをロボットとして登録し、共通のマシンキーを使用してOrchestrator接続された任意のマシンでStudioを実行することができます。
   • フローティングロボット(Development)を使用するには次のナレッジベースをご参照ください。
     
     • フローティングロボットの機能と利点
     •  
   • v2018.3以前のStudioを使用する必要がある場合には、次の留意事項4の方法を使用します。
3. 
   4.Orchestrator無し・パーシステンス無しの環境でAttendedロボットまたはStudio使用の場合 (パターン17, 18, 23, 24) 
4.  
5.  Orchestrator無しの環境では、デフォルトでローカルディスク上にアクティベーション情報が保持されますが、パーシステンスが無い場合には再アクティベーションが求められます。
6.  
7. この問題を回避するには、次の手順により永続的なディスク上にアクティベーション情報を保持するように設定変更します。対応手順は UiPath Studio / Robot のバージョンとライセンスの種類により異なります。 
   • ・UiPath Studio/Robot v2018.4.7以降、v2019.4.5以降、v2019.10.1以降 (新ライセンスサーバー使用)
     • 　・Named User の場合、%AppData%\UiPath\LicenseInternal にアクティベーション情報 (license.dat) が保存されます。
       　　このディレクトリおよびファイルは移動プロファイル環境下であれば自動的に同期されるため、初回起動時のみアクティベーションが求められますが、2回目以降は別マシンの仮想デスクトップにログオンした場合でも再アクティベーションする必要はありません。
       　　移動プロファイルを使用していない環境は、初回アクティベーション後、ファイルサーバーにユーザーごとに license.dat を保存し、ログオンスクリプトなどでファイルサーバーから %AppData%\UiPath\LicenseInternal に license.dat をコピーする実装が必要となります。
     •  
     • 　・Node Locked の場合、%ProgramData%\UiPath\LicenseInternal にアクティベーション情報 (license.dat) が保存されます。
       　　パーシステンス無しの環境では license.dat が保持されないため、初回アクティベーション後、ファイルサーバーにマシンごとに license.dat を保存し、スタートアップスクリプトなどでファイルサーバーから %ProgramData%\UiPath\LicenseInternal に license.dat をコピーする実装が必要となります。
   • ・UiPath Studio/Robot v2018.3以前、v2018.4.1～v2018.4.6、v2019.4.1～v2019.4.4 (旧ライセンスサーバー使用)
   • 　・管理者権限を使用して、Studioインストールディレクトリ配下のlicense.configファイルをエディターで開きます。

     • 　・<WorkDir>と<LicDir>をファイルサーバーなど永続的なディレクトリ上にマシン毎にアクティベーション情報を保持するように設定変更し、保存します。

     •  

       license.config

       <WorkDir>\\fileserver\UiPath\License\%ComputerName%</WorkDir> <LicDir>\\fileserver\UiPath\License\%ComputerName%</LicDir>

   1. • 　・更にファイルサーバー側で共有アカウント設定を変更し、Studio使用時にはStudioの実行ユーザー、Attendedロボット使用時には端末のコンピューターアカウントに対して変更権限を付与します。 
   2.  

   3. ・いずれの UiPath Studio / Robot のバージョンにおいても、ログオンごとに毎回マシン名が変更される場合は、割り当てられたマシンごとに初回アクティベーションが求められます。マシン数が多いなど、この方法で実運用が難しい場合にはフローティングロボット(留意事項詳細の2および3参照)により対応が可能となりますので、Orchestrator導入をご検討ください。

5.Orchestrator有り・パーシステンス無しの環境でUnattendedロボット使用の場合 (パターン4)

  ・仮想マシンがOrchestratorと同じドメインに所属している場合には接続文字列を使用してOrchestratorに

　  自動接続し、Unattendedロボットとして使用することが可能です。
      https://docs.uipath.com/robot/lang-ja/docs/using-the-connection-string

  ・続文字列を使用してOrchestratorに自動接続するには、まずOrchestratorのweb.configファイルにて　　　

　  WindowsAuth.EnabledとWindowsAuth.Domainパラメーターを適切に変更しWindows認証を有効化します。

  ・次に仮想マシンのマスターイメージ上で次のコマンドを実行し、接続文字列を設定します。
      UiRobot.exe --connect -connectionString https://<orchestrator-url>/api/RobotsService/GetConnectionData?tenantId=1

  ・Orchestrator上のロボット作成について、マスターイメージに対しては作成せず、マスターイメージからプロビジョニングされた仮想マシンに対して作成します。つまり仮想マシンのマシン名とUnattendedロボットの実行ユーザーをOrchestrator上でロボットとして登録します。