クライアント コンポーネントを自動更新する

一元化された Orchestrator の場所から Robot、Studio、UiPath Assistant のクライアントを新しいバージョンに更新します。

概要

管理者はこの機能を使用して、Orchestrator から Robot、Studio、UiPath® Assistant のクライアントを新しいバージョンに更新できます。この機能により、大規模なマシン ベースのバージョン更新を一元化された場所から容易に実行できるため、ユーザーの負担が解消され、更新プロセスが効率化されます。

注:

クライアント コンポーネントの自動更新機能は、すでにインストールされている Robot、Studio、UiPath Assistant の製品を新しいバージョンに更新する場合にのみ機能します。バージョンのダウングレードが必要な場合は、ダウングレード プロセスを手動で行うか、UiPath に依存しないツールを使用する必要があります。

前提条件

1. Orchestrator、Studio、Robot 2021.10 以降。
2. Studio または Robot 2021.10 以降 (あるいはその両方) がクライアント マシンにインストールされ、Orchestrator に接続されていること。
   注:

   Robot に対してクライアント コンポーネントの自動更新機能を有効化するには、2021.10 以降のバージョンの UiPathStudio.msi インストーラー、または 2024.10 以降のバージョンの UiPathRobot.msi インストーラーを使用して、Robot アプリケーションをインストールする必要があります。2024.10 より前のバージョンの UiPathRobot.msi インストーラーでは、クライアント コンポーネントの自動更新はサポートされていません。2024.10 より前のバージョンの UiPathRobot.msi インストーラーを使用して Robot をインストールした場合は、2024.10 以降の UiPathRobot.msi インストーラーを使用して Robot アプリケーションを手動で更新できます。

更新プロセスに含まれるコンポーネント

クライアント側

• クライアント アプリケーション:
  • Robot
  • Assistant
  • Studio
• Robot サービス
• 更新エージェント - ユーザーと更新サービス間の通信を担当する Windows プロセスです。(ユーザー モードおよび Attended ロボットのインストールの場合にのみ存在します。)
• 更新サービス - クライアント マシンと更新サーバー間の通信を提供する Windows サービスです。

サーバー側

• Orchestrator: 管理者が自動更新ポリシーを設定し、クライアント アプリケーションのバージョン ステータスを確認するための、ユーザー インターフェイスを提供します。
• 更新サーバー: 自動更新ポリシーを管理し、更新サービスを使用してクライアント マシンとの通信を維持するための、一元化されたサービスです。

動作の仕組み

管理者は、特定のマシンにデプロイする特定のバージョンを選択できます。

そのために、Studio と Robot のインストール時に、2 つの実行可能ファイル UiPath.UpdateService.Worker.exe と UiPath.UpdateService.Agent.exe もマシンに追加されます。

Studio/Robot のインストールの種類に応じて、異なる方法でインストールされます。

• Unattended ロボット: UiPath.UpdateService.Worker.exe が Windows サービスとしてインストールされ、UiPath.UpdateService.Agent.exe はインストールされません。
• Attended ロボット: UiPath.UpdateService.Worker.exe が Windows サービスとしてインストールされ、UiPath.UpdateService.Agent.exe がタスク スケジューラで LogOn タスクとしてインストールされます。
• クイック インストール (ユーザー モード): UiPath.UpdateService.Worker.exe および UiPath.UpdateService.Agent.exe が、タスク スケジューラで LogOn タスクとしてインストールされます。
  重要:

  UiPath Studio と Robot を Attended ユーザー モードでマシンにインストールする場合、更新サービスが更新サーバーに接続できるよう、設定時に Orchestrator の URL を追加するのを忘れないようにしてください。インストール時に Orchestrator の URL を追加しないと、マシン上の管理者権限を持つユーザーがマシンにログオンしてロボットを Orchestrator に接続しなければなりません。

新しいポリシーが定義または変更されると、更新サーバーはクライアント マシン上の更新サービスにコマンドを送信し、更新プロセスを開始できるかどうかクライアント アプリケーションに確認します。

更新を受け取るには、製品が「中立」ステートである必要があります。

• Studio - 実行中のプロセスやアクティブなセッションがない。
• Robot - 実行中のジョブやプロセスがない。
• Assistant - 実行中のプロセスや保留中のアクティビティ (インストールまたはダウンロード中のプロセス) がない。
  注:

  更新プロセス中、ロボットは更新が完了するまでジョブを開始しません。

有人シナリオでは更新プロンプトが表示され、以下の 2 つのオプションのいずれかを選択できます。

• 今すぐ更新 - 実行中のジョブをすべて停止し、そのマシン上のすべての Studio インスタンスを閉じてから、更新を続行します。
• 後で - 通知をミュートしておいて、システム トレイで [更新を確認] のアイコンをクリックして更新プロセスを再開することができます。

ユーザーがプロンプトを確認すると、更新サービスに通知され、更新プロセスが開始されます。 最初の通知から 24 時間以内に応答がない場合、更新が自動的にインストールされます。

無人シナリオでは、更新サービスはクライアント アプリケーションのステートが「中立」であることを確認して (前述のとおり)、更新サーバーに通知します。

注:

• マシンに実行中のプロセスがある場合は、プロセスを停止するか、終了するまで待機してから更新を続行するよう促すメッセージがロボット ユーザーに表示されます。Studio セッションが開いている場合は、進行状況を保存するよう求められます。
• ロボット ユーザーが時間内に反応しない場合、Studio は終了し、その時点でのプロセスがそのまま保存されます。プロセスは更新の完了後に回復できます。
• 更新時にアクティブなロボットはすべてメンテナンス モードになり、更新が完了するまでは新しいジョブが取得されなくなります。
• ユーザー モードの Robot の場合、最大 1,440 分の待機時間が適用されます。

更新プロセスのステップ

更新プロセスは 7 段階に分かれています。

1. ダウンロードしています。
   • 更新サービスは、更新要求がないかどうかを、更新サーバーに 3 時間ごとに確認します。更新要求を受け取ると、更新プロセスはダウンロード プロセスを開始します。ダウンロード プロセスが正常に開始されると、更新要求は「ダウンロード中」ステータスで更新サーバー データベースに追加されます。
2. ダウンロード済み
   • 「ダウンロード済み」ステータスはマーカーとして機能するため、更新サービスは後処理フェーズを開始できます。このステータスは、更新ファイルが正常にダウンロードされたことを示します。
3. 処理中
   • このステップでは、ダウンロードされたファイルの後処理を行います。ファイルが確認され、エラーがなければ、インストール プロセスが開始されます。
4. インストールの準備が整う
   • 更新エージェントは、更新がインストール待ちであることをユーザーに通知して、インストールの承認を求め、クライアント アプリケーションで更新を受信する準備ができているかどうかを確認します。
5. インストールが承認される
   • 承認されたことが更新サービスに通知されると、実際のインストールが開始されます。
6. インストールしています。
   • 前のバージョンと同じ設定を保持したまま、新しいバージョンがマシンにインストールされます。
7. 成功/エラー

インストールの結果に基づいて、更新ステータスが更新サーバーに報告されます。

注:

Chrome 拡張機能がロボット端末に既にインストールされている場合、自動更新機能によって拡張機能も更新されます。そうでない場合は、拡張機能を手動でインストールする必要があります。

リトライ メカニズム

更新プロセスでは、初回のダウンロードでファイルを取得できない場合、更新サービスはあと 3 回リトライします。リトライ間隔は、初回試行の 1 時間後、最初のリトライの 2 時間後、および最後のリトライの 4 時間後です。各リトライの前に、通知システムからユーザーに通知が送信されます。

ダウンロードが試行されるたびに、Orchestrator の更新ログと、ローカルのマシン上の %localappdata%/Uipath/UpdateService/logs ファイルにログが追加されます。

プロセスはインストールの場合も同様です。最初のインストールに失敗すると、更新サービスは同じ頻度で 3 回リトライします (初回試行の 1 時間後、最初のリトライの 2 時間後、および最後のリトライの 4 時間後)。

更新サーバーは、更新を開始してから終了するまで、72 時間待機します。この期間の経過後に新規バージョンがインストールされない場合、詳細なエラーがログに追加されます。更新は、次に要求を受信したときに再試行されます。

自動更新が失敗した場合は、ボタン を使用して更新を手動でリトライすることもできます。

サービス モードおよびユーザー モードの Robot のデプロイ

サーバー側の技術的な部分に関しては、サービス モードのデプロイとユーザー モードのデプロイの両方で同じです。更新サーバーと更新サービスとの間で同じ種類の接続を使用するためです。Robot サービスがクライアント マシン上の更新サービスと通信する方法には、以下のような違いがあります。

サービス モード

サービス モードのデプロイでは、Robot サービスと更新サービスの両方がローカル システム アカウント セッションで実行されます。

図 1. サービス モードのデプロイのダイアグラム

ユーザー モード

ユーザー モードのデプロイでは、Robot サービスはユーザー セッションで実行され、更新サービスはローカル システム アカウント セッションで実行されます。

重要:

ロボットと Studio がユーザー モードでデプロイされている場合、マシン上の 1 つのロボットに更新コマンドを送信すると、その特定のマシン上のすべてのユーザーに対して実行されます。

図 2. ユーザー モードのデプロイのダイアグラム

警告:

更新プロセスが完了したら、Studio と Robot を手動で起動する必要があります。

ポリシー構成レベル

Orchestrator では、自動更新ポリシーは、ユーザー、ユーザー グループ、マシンの 3 つのレベルで設定します。各レベルにより、ターゲット スコープにデプロイするバージョンを制御します。

重要:

自動更新は、Orchestrator のポリシーによって完全に制御されます。セットアップ時のインストール設定では、自動更新が動作するかどうか、またはどのように動作するかは決定 されません 。自動更新を禁止するには、インストーラーではなく Orchestrator でポリシーを設定する必要があります。

ユーザーの自動更新を設定する

特定のユーザーに対して更新ポリシーを設定すると、そのユーザーの Studio、Robot、Assistant のバージョンを制御できます。

1. [ テナント ] > [アクセス権 を管理 ] > [ アクセス ルール ] タブに移動します。
2. [ ユーザー ] タブを選択します。
3. [ ユーザーを割り当て] を選択します。[ アクセス ルールを割り当て ] ページが表示されます。
4. 目的のユーザーを検索して選択します。右側に [概要カード ] が表示され、ユーザーの現在の権限が表示されます。
5. [ 編集 ] を選択してアクセス ルールを変更します。
6. [ 設定] で、 クライアント バイナリ (Robot、Assistant、Studio) の自動更新ポリシーを見つけます。
7. そのユーザーの自動更新ポリシーを選択します。
   • なし: ポリシーは適用されていません。
   • 最新のパッチ: サポートされているバージョンごとに利用可能な最新パッチをインストールします (最新の 2022.10 パッチ、最新の 2023.4 など)パッチ)。
   • 最新のバージョン: 利用可能な最新バージョンを更新サーバーからインストールします。
   • 特定のバージョン - 更新サーバーで利用可能なリストから、特定のバージョンをインストールします。
8. [ 更新 ] を選択して変更を保存します。

重要:

Express User ライセンス (以前の Autopilot Express;レガシ割り当ての場合、更新ポリシーは編集できず、最新の Enterprise バージョンを提供するよう設定されています。現在のライセンスの機能については、「 Express User License」をご覧ください。

ユーザー グループの自動更新を構成する

ユーザー グループに更新ポリシーを設定すると、各ユーザーを個別に設定しなくても、すべてのグループ メンバーに同じポリシーを適用できます。これは、有人のユース ケースに推奨されるアプローチです。

1. [ テナント ] > [アクセス権 を管理 ] > [ アクセス ルール ] タブに移動します。
2. [グループ] タブを選択します。
3. [ グループを割り当て] を選択します。[ アクセス ルールを割り当て ] ページが表示されます。
4. 目的のグループを検索して選択します。右側に [概要カード ] が表示され、グループの現在の設定が表示されます。
5. [ 編集 ] を選択してアクセス ルールを変更します。
6. [ 設定] で、 クライアント バイナリ (Robot、Assistant、Studio) の自動更新ポリシーを見つけます。
7. そのグループの自動更新ポリシーを選択します。
   • なし: ポリシーは適用されていません。
   • 最新のパッチ: サポートされているバージョンごとに利用可能な最新パッチをインストールします (最新の 2022.10 パッチ、最新の 2023.4 など)パッチ)。
   • 最新のバージョン: 利用可能な最新バージョンを更新サーバーからインストールします。
   • 特定のバージョン - 更新サーバーで利用可能なリストから、特定のバージョンをインストールします。
8. [ 更新 ] を選択して変更を保存します。

注:

権限和集合モデルでは、ユーザーはグループから設定を継承しますが、ユーザーが明示的なポリシーを構成している場合は、そのポリシーがグループ ポリシーよりも優先されます。ポリシー グループ内のユーザーが更新を受信できないようにするには、ユーザーをグループから削除するか、そのユーザーに対して明示的なポリシーを、現在インストールされているバージョンに設定します。

マシンの自動更新を構成する

マシンの更新ポリシーを設定すると、ユーザー ID ではなくマシン ID に基づいて、Unattended または Attended フリート全体のバージョンを管理できます。これは、無人のユース ケースに推奨されるアプローチです。

1. [ テナント] > [マシン] に移動します。[ マシン] ウィンドウが表示されます。
2. 目的のマシン オブジェクトを見つけて選択し、[ 編集] を選択します。[ マシンを編集 ] ウィンドウが表示されます。
3. [ メンテナンス] タブを選択します。[ 自動更新 ] 設定メニューが表示されます。
4. そのマシンの自動更新ポリシーを選択します。
   • なし — ポリシーは適用されていません。
   • 最新のパッチ — サポートされているバージョンごとに利用可能な最新パッチをインストールします。
   • 最新のバージョン — 利用可能な最新バージョンを更新サーバーからインストールします。
   • 特定のバージョン — 更新サーバーで利用可能なリストから、特定のバージョンをインストールします。
5. [保存] を選択します。

自動更新のスケジュール設定

[ メンテナンス] タブでは、メンテナンス ウィンドウに合わせて更新が開始されるタイミングをスケジュールすることもできます。

1. [ 自動更新 ] 設定メニューで、開始日時を指定します。
2. 必要に応じて、メンテナンス ウィンドウの期間を設定します。
3. [保存] を選択します。

更新が完了する前にメンテナンス ウィンドウが経過した場合、更新は次に利用可能なウィンドウに再スケジュールされます。

注:

同じマシン キーを使用するマシンの場合、ポリシーはそのキーで接続されているすべてのマシンに適用されます。

ポリシーの優先度を理解する

複数のポリシーが同じロボットを対象としている場合、それらすべてが同じように適用されるとは限りません。Orchestrator は厳密な優先順位を使用して競合を解決します。

優先順位 (高い順から低い順へ):

1. ユーザーレベルのポリシー
2. グループレベルのポリシー
3. マシンレベルのポリシー

異なるレベルのポリシーを比較する場合、優先順位が適用されます。ユーザーレベルのポリシーとグループレベルのポリシーでは、優先度に関係なく、新しいバージョンが優先されます。ユーザー ポリシーまたはグループ ポリシーのいずれかが設定されている場合 (マシン レベルのポリシーとは異なる場合)、マシン レベルのポリシーが上書きされます。

ポリシーの競合の例

例 1: ユーザー ポリシーによってマシン ポリシーが上書きされる

マシンに Robot v2023.4.0 がインストールされているとします。マシンレベルのポリシーは 2023.4.12 に設定されていますが、そのマシンにログインするユーザーのユーザー レベルのポリシーは 2024.10.1 に設定されています。Robot が 2024.10.1 に更新されます (ユーザー ポリシーが優先されます)。

例 2: ユーザーがポリシーを持っていない場合にグループ ポリシーが適用される

ユーザーは個別のポリシーを持っていません ( [なし] に設定されています)が、[ 最新のパッチ ] ポリシーを持つグループに属している。ユーザーの Robot が、インストールされているメジャー バージョンで利用可能な最新のパッチに更新されます (グループ ポリシーが適用)。

例 3: ユーザーとグループの間で新しいバージョンが優先されます

マシンに Robot v2023.4.0 がインストールされているとします。ユーザーのポリシーが 2023.4.12 に設定され、グループのポリシーが 2024.10.1 に設定されています。Robot は 2024.10.1 に更新されます。これは新しいバージョンであるためです (技術的にはユーザー レベルのポリシーの方が優先度が高いにもかかわらず、グループの新しいバージョンが選択されます)。

注:

ロボット アカウント (Unattended ロボット) を使用する場合、更新の処理にはユーザー ポリシーではなくマシンレベルのポリシーが使用されます。

更新ログ

Orchestrator のユーザー インターフェイスでは、失敗および成功した更新についての更新ログを利用できます。

マシンの更新ログを表示するには、テナント コンテキストで [マシン] に移動し、目的のマシンの [その他のアクション] を選択します。[その他のアクション] メニューで、[インストール済みのバージョンとログを表示] を選択します。[インストール済みのバージョンとログ] グリッドで、目的のエントリの [自動更新のログを表示] を選択します。

更新の完全なログは、マシン上の次の場所でも確認できます。

• サービス モードの場合: %ProgramData%\UiPath\UpdateService\Logs
• ユーザー モードの場合: %LocalAppData%\UiPath\UpdateService\Logs
  警告:

  マシンが複製されている仮想環境にロボットをデプロイすると、マシン名、GUID、ドライブ ID、mac アドレスは同じになります。これにより、競合が発生することがあります。Orchestrator は同じ ID を持つ複数のマシンから異なる更新ステータスを受け取るためです。 このシナリオでは、Orchestrator の更新ステータスは、接続した最後のマシンに基づいて表示されます。 このことは、Orchestrator のログにも影響を与える場合があります。複数のマシンが同じ ID を持つため、重複するログが表示される可能性があります。

バージョンのステータス

[バージョンのステータス] 列では、マシンの Robot のバージョンのステータスを関連付けられたポリシーと照合できます。

次の値を使用できます。

• ポリシーなし - ポリシーが定義されていません。
• 更新が進行中 - マシン上で更新プロセスが進行中の場合、このステータスが表示されます。
• 準拠 – マシン上の Robot のバージョンが更新ポリシーと一致しています。
• 非準拠 - マシン上の Robot のバージョンが、ポリシーで設定されたバージョンと異なっています (例: Robot のバージョンが 2021.10.3 で、ポリシーでは 2021.10.1 に設定されている)。
• 更新に失敗 - このステータスは、更新プロセスが失敗した場合に表示されます。詳しくは、更新ログをご覧ください。
• N/A - このステータスは、非アクティブなマシンを除外する設定がオンになっていて、ロボットがしばらくの間接続されていない場合、またはマシンの種類が自動更新プロセスに対応していない場合に表示されます。

マシンのバージョンのステータス

Orchestrator の [マシン] タブの [バージョンのステータス] 列では、マシンの Robot のバージョンのステータスを関連付けられたポリシーと照合できます。

重要:

Linux ロボットは、自動更新機能と互換性がありません。これらのロボットについては、バージョンのステータスが N/A となり、ツールチップに「この種類のマシンには、自動更新は適用されません。」と表示されます。

非アクティブなマシンを除外する

複数のマシンが同じキーを使用して Orchestrator に接続されており、その 1 つが非アクティブな場合、マシン テンプレートのバージョンのステータスは「非準拠」になります。こうした状況は、マシン テンプレートが同じマシン キーを使用して更新サーバーと通信しているときに、接続されているマシンの 1 つが更新を受信できず、マシン テンプレートの全体的なステータスに影響する場合に発生します。

これを回避するには、テナントのコンテキストで [設定] メニューの [全般] セクションにアクセスし、クライアント バイナリのチェック ボックスをオンにして非アクティビティ間隔を設定します。これにより、非アクティブなマシンが更新プロセスから除外され、更新ステータスの報告時に考慮されなくなります。

ユーザーのバージョンのステータス

[監視] ウィンドウの [ユーザー セッション] タブの [バージョンのステータス] 列では、ユーザーのクライアント コンポーネントのバージョンのステータスを関連付けられているポリシーと照合できます。

プロキシ構成

ロボットがプロキシの背後にある場合、自動更新機能を動作させるには、さらに設定が必要になる場合があります。インストールの種類に応じて、プロキシの構成はユーザー レベルのプロキシ設定から継承できる場合と、 構成ファイルを編集して手動で設定できる場合があります。

インストールの種類	ロボットのデプロイ	更新サービス	エージェントを更新	プロキシ設定
Unattended ロボット	Windows サービス	Windows サービス	N/A 1	uipath.config ファイルより
Attended ロボット	ユーザー レベルの実行可能ファイル	Windows サービス	ユーザー レベルの実行可能ファイル	uipath.config ファイルより
クイック インストール	ユーザー レベルの実行可能ファイル	ユーザー レベルの実行可能ファイル	ユーザー レベルの実行可能ファイル	ユーザー レベルのプロキシ設定より

1 ロボットが無人モードでインストールされている場合、マシンには更新エージェントが追加されません。

エラー ログを収集する

更新に失敗した場合は、 診断ツールを使用して ログを収集できます。このログは、特定のエラーについての詳細な調査の目的でサポート チームに送信できます。