マシンを管理する

Unattended ロボットのインフラストラクチャを構成するためのマシン テンプレートを Orchestrator で作成・管理します。

マシン オブジェクトは通常、管理者が無人インフラストラクチャの設定を行うために使用します。

Orchestrator 内のマシン オブジェクトについて詳しくは、こちらをご覧ください。

マシン テンプレートを追加する

マシン テンプレートを作成するには、以下の手順を実行します。

1. [テナント] > [マシン] に移動します。[マシン] ページに、そのテナントのすべてのマシン オブジェクトの一覧が表示されます。
2. [ マシン] ページで、[ マシンを追加 ] > [ マシン テンプレート] を選択します。[ マシン テンプレート ] ページが表示されます。
3. In the General details section, in the Template Name field, enter a name for your template to easily identify it.
4. [説明] フィールドに、マシンの説明を入力します。
5. In the Tags section, optionally add labels to identify your template. For details on labels and their constraints, see Adding Tags to Machine Objects.
6. In the Properties section, optionally add key-value pairs under Advanced settings. For details, see Adding Tags to Machine Objects.
7. In the Runtime details section, under Agents and Functions runtimes, enter the desired number of Agent slots and Function slots. Agent slots set how many Agent jobs can run in parallel on each connected host machine. Function slots do the same for Function and API jobs.
   重要:

   Agents and functions consume units and don't require additional licenses. If no units are available for your tenant, executions don't start even when slots are configured here.

   Unlike the RPA runtime licenses configured in the next two steps, Agent slots and Function slots aren't capped by a per-type license allowance. They reserve concurrent execution capacity directly, independent of tenant licensing. For details on how these jobs are licensed, see Agents and Functions on Local Robots.
8. In the Runtime details section, under RPA > Supported usage, specify the Process type and Process compatibility of processes the host machines can execute.

フィールド	説明
プロセスの種類	このマシン テンプレートを使用するインフラストラクチャ上で実行できる実行できるプロセスの種類を以下から選択します。 フォアグラウンドのみ - フォアグラウンド プロセスのみ バックグラウンドのみ - バックグラウンド プロセスのみ すべて - バックグラウンド プロセスとフォアグラウンド プロセスの両方
プロセスの対応 OS	このマシン テンプレートを使用するインフラストラクチャ上で実行できる実行できるプロセスの種類を以下から選択します。 Windows のみ - Windows 対応プロセスのみ クロスプラットフォームのみ - クロスプラットフォーム プロセスのみ すべて - Windows 対応プロセスとクロスプラットフォーム プロセスの両方

重要:

Orchestrator は、基になるプロセスがテンプレートの設定と一致しない場合、特定のホスト マシンでジョブを開始できないようにします。無効な設定でジョブを開始しようとすると、設定の修正方法を詳しく示したエラー メッセージが表示されます。

9. In the Runtime details section, under RPA > Runtime licenses, assign the desired number of Production (Unattended) and NonProduction runtimes to the machine. The number of runtimes represents the number of jobs you can execute simultaneously on each host machine connected to Orchestrator using this template.
   注:

   App Testing のランタイムの種類は、Test Cloud でのみ機能します。App Testing を使用して、テストと非運用環境のプロセスを実行できます。Performance Testing のランタイムの種類は、Test Cloud でのみ機能します。パフォーマンス テストを使用して、パフォーマンス シナリオを実行できます。

10. [クライアント バイナリ (Robot、Assistant、Studio) の自動更新ポリシー] フィールドで、Robot、Assistant、Studio を更新するときに従う更新ポリシーを選択します。
    • 最新のパッチ - 更新サーバーで利用可能な最新バージョンをインストールします。
    • 最新バージョン - サポートされているバージョンごとに利用可能な最新パッチをインストールします (最新の 2021.10 パッチなど)。
    • 特定のバージョン - 更新サーバーで利用可能なパッチのリストから、特定のパッチをインストールします。
11. マッピング方法を選択します。アカウントとマシンのマッピングについて詳しくは、こちらをご覧ください。
    • すべてのアカウントにこのマシンの使用を許可 - 特定のマッピングはありません。
    • 特定のアカウントのみをこのマシンに割り当て - 実行が許可される、特定のアカウントとマシンのペアを設定します。
12. [プロビジョニング] を選択します。 マシンが作成され、ロボットを Orchestrator に接続するために必要なクライアント ID とクライアント シークレットとともに、確認ウィンドウが表示されます。
    重要:

    • クライアント シークレットは作成直後に 1 回しか表示されません。同じシークレットを複数回使用する場合は、コピーして安全な場所に保存しておいてください。ストレージをセキュリティで保護するために、暗号化やハッシュの使用を検討してください。
    • マシン テンプレートを作成した後に、新しいクライアント シークレットを追加できます。詳しくは、「新しいクライアント シークレットを生成する」をご覧ください。
13. 完了したら [ 閉じる] を選択します。[マシン テンプレート] ウィンドウが閉じ、[マシン] ページに、作成したものを含む、テナント内のすべてのマシン オブジェクトのリストが表示されます。

マシンを削除する

マシンを削除するには、次の手順を実行します。

1. マシンの [その他のアクション] を選択し、[削除] を選択します。または、グリッドから 1 つまたは複数のマシンを選択して、[削除] を選択します。
2. マシンの削除ダイアログが表示されたら、[削除の確定] フィールドに確認のテキスト文字列を入力し、[はい] を選択します。
   注:

   • 現在実行中のジョブ、停止中のジョブ、または終了中のジョブがあるマシンは削除できません。
   • 保留中のジョブまたはトリガーがアタッチされているマシンを削除しようとすると、保留中のジョブの数と、影響を受ける各マシンにアタッチされているトリガーの数と種類が確認ダイアログに表示されます。
   • タイム トリガーまたはキュー トリガーがアタッチされているマシンの場合は、以下のシナリオが監査ログに記録され、通知が表示されます。

   • マシンを削除すると、有効化されているトリガーはどのマシンにも割り当てられていない状態になります。この場合、トリガーは無効化され、「トリガーが自動的に無効化されました」という通知が表示されます。
   • マシンを削除すると、有効化されているトリガーは、そのトリガーが割り当てられている一部 (すべてではない) のマシンから割り当て解除されるか、無効化されているトリガーがどのマシンにも割り当てられていない状態になります。この場合、「トリガーの設定が変更されました」という通知が送信されます。

   • 削除されたマシンに関連付けられていた保留中のジョブ、再開されたジョブ、または中断されたジョブは、最終ステート [エラー] に送られます。

マシンのログを表示する

特定のマシンのログを表示するには、該当の [その他のアクション] ボタンをクリックし、[インストール済みのバージョンとログを表示] をクリックします。

マシンのロボットのバージョンを表示する

[マシン] ページでは、[インストールされたバージョン] 列でロボットのバージョンを確認することもできます。標準ロボットのバージョンは、 UiRobotSvc サービスが起動または再起動されるときに取得されます。フローティング ロボットのバージョンは、UiPath® Robot が Orchestrator に接続されるときに取得されます。

特定のマシンに接続されている各 Robot のバージョンをすべて確認するには、[その他のアクション] ボタンをクリックし、次に [インストール済みのバージョンとログを表示] をクリックします。

[マシン] ページの [インストールされたバージョン] 列は、シナリオに応じて、作成されたロボットのバージョンに関する累積した情報を表示します。

1. ロボット接続なし
   • マシンにまだロボットがプロビジョニングされていません
2. 不明
   • 1 台以上のロボットが作成されていますが、いずれも接続されていません
   • ロボットと Orchestrator 間の接続が確立した後に、1 台以上のロボットが作成されました
3. インストールされたバージョン
   • 18.2.0 よりも新しいバージョンの Robot 1 台が登録され、接続されています。
   • 18.2.0 以降のバージョンのロボットを多く含む(同じもの)がプロビジョニングされ、すべて接続されています。たとえば、18.2.4Robot が接続されている場合は、 18.2.4 が表示されます。18.3.0ロボット (たとえば 11 台) がすべて接続されている場合、 18.3.0 と表示されます。
4. < 18.2.0
   • 18.2.0 より前のバージョンの Robot 1 台が登録され、接続されています。
   • 18.2.0 より前のバージョンのロボットがさらにプロビジョニングされ、すべて接続されています。たとえば、18.1 の Robot を 1 台プロビジョニングして接続している場合は、 <18.2.0 と表示されます。同様に、17.1.0および 18.2.0ロボット (たとえば 9 と 5) がすべて接続されている場合は、 <18.2.0 と表示されます。
5. [異なるバージョン番号]
   • 異なるバージョンの Robot 2 台以上が登録され、すべて接続されています。 たとえば、合計 14 台の Robot (18.3.0 の Robot 10 台、18.2.4 の Robot 2 台、18.2.0 より前の Robot 2 台) をプロビジョニングしたとします。この場合、3 つのバージョンが表示されます。

この列の値にカーソルを合わせると、ヒントとして詳細が表示されます。

図 1. [インストールされたバージョン] のツールチップ

下の表は、さまざまなシナリオに応じて [インストールされたバージョン] 列に表示される値と、各値のヒントとして表示される詳細情報をまとめたものです。

シナリオ	[インストールされたバージョン] 列	ヒントとして表示される詳細情報の例
マシン上でロボットが作成されていません	ロボット接続なし	ロボット接続なし
4 台のロボットを作成しましたが、いずれも接続されていません	不明	不明: 4 台のロボット
18.3.0 のロボットを複数 (11 台) プロビジョニングし、すべて接続しています	18.3.0	18.3.0: 11 robot(s) (ロボット)
17.1.0 と 18.2.0 のロボットを複数 (それぞれ 9 台と 5 台) プロビジョニングし、すべて接続しています	<18.2.0	<18.2.0: 14 robot(s) (ロボット)
合計 14 台のロボット (18.3.0 のロボット 10 台、18.2.4 のロボット 2 台、18.2.0 より前のロボット 2 台) をプロビジョニングしました	3 versions (バージョン)	18.3.0: 10 台のロボット 18.2.4: 2 台のロボット <18.2.0: 2 台のロボット 合計: 14 台のロボット

マシンに接続されているロボットを表示する

特定のマシンに接続されているロボットを確認するには、[その他のアクション] ボタンをクリックし、[ロボットを表示] をクリックします。[ロボット] ページに自動的にリダイレクトされます。このページでは、該当のマシンに接続されているすべてのロボットが表示されます。

マシンを有効化/無効化する

Unattended、NonProduction、Testing、App Testing、App Test Robot、および Performance Testing ライセンスが適用されるマシンでのみ使用できます。ライセンスが即座に消費されることを防ぐため、対応するライセンス ページからマシンを無効化します。

1. [ ライセンス ] ページで、目的のライセンスの入力で [ 詳細を確認 ] を選択します。該当するページが表示されます。
2. [アクティブ] 列でトグルをオフにします。マシンを無効化するかどうかを確認するダイアログが表示されます。
3. [ はい] を選択します。マシンは無効化されています。
4. マシンを有効化するには、トグルをオンにします。

マシン上でロボットが実行中である限り、それらのロボットがあるフォルダーにかかわらず、そのマシンを無効化することはできません。

フォルダーにマシンを割り当てる

マシンをフォルダーに割り当てると、さまざまな影響があります。詳しくは、「フォルダーにマシン オブジェクトを割り当てる」をご覧ください。

マシン オブジェクトにタグを追加する

注:

マシン オブジェクトに既存のタグを追加するには、マシンに対する [編集] 権限とタグに対する [表示] 権限が必要です。 マシン オブジェクトに新しいタグを追加するには、マシンに対する [編集] 権限とタグに対する [作成] 権限が必要です。

注:

• 各マシン オブジェクトには、最大 100 万個のキー/値のペアを設定できます。
• ラベルおよびキー/値のプロパティに使用できる文字数は、最大 256 文字です。
• タグ名に使用できない文字は、<、>、%、&、\、?、/、: です。

マシンへのタグの適用は、マシンの作成時または既存のマシンの編集時に行うことができます。マシンの編集時にマシンにタグを追加するには、以下の手順に従います。

1. [ マシン] ページで、目的のマシン オブジェクトの横にある [ その他のアクション ] > [ 編集 ] を選択します。マシン オブジェクトが編集用に開きます。
2. [ラベル] フィールドで、ラベル名の入力を開始します。既存のラベルを選択するか、新しいラベルを作成することができます。
3. [ プロパティ (キーと値のペア)] フィールドで、[ 新規追加] を選択します。
4. 新しいキーと値を追加します。既存のキーまたは値を選択するか、新しいキーまたは値を作成することができます。
5. 完了したら、[ 更新] を選択します。マシン オブジェクトが更新され、新しく作成されたタグ (ある場合) が他のオブジェクトで利用できるようになります。

マシン オブジェクトからタグを削除する

オブジェクトからタグを削除するには、以下の手順に従います。

1. [ マシン] ページで、目的のマシン オブジェクトの横にある [ その他のアクション ] > [ 編集 ] を選択します。マシン オブジェクトが編集用に開きます。
2. [ ラベル] フィールドで、ラベルの名前の横にある [X ] を選択して削除します。ラベルが削除されます。
3. [プロパティ (キーと値のペア)] フィールドで、キーや値の横にある X を選択して削除します。キーや値が削除されます。
4. キーと値のペアを削除するには、次の手順を実行します。 そのエントリに対応する [削除 ] アイコンを選択します。キーと値のペアが削除されます。
5. 完了したら、[ 更新] を選択します。マシンが更新され、タグが削除されます。

マシン テンプレートを使用して無人インフラストラクチャを最適化する

マシンを特定のプロセスの実行に特化することで、無人オートメーションのワークロードを既存のインフラストラクチャに分散し、効率を最大限に高めてインフラストラクチャのコストを削減します。

詳しくは、「 マシン テンプレートを使用して無人インフラストラクチャを最適化する 」をご覧ください。

マシンのメンテナンスを有効化する

マシンのメンテナンスを実行するときには、いつでもそのマシンをオフラインにできます。この機能は、テナント レベルの [ 監視 ] ページの [ 無人セッション ] セクションで [ メンテナンス ] 列のトグルを [オン] に切り替えることで有効化されます。

図 2. マシンのメンテナンスの有効化

このトグルを有効化すると、以下を実行するかどうかを確認するウィンドウが表示されます。

• ジョブの実行が完了するまで待機してからメンテナンスを開始 (これは既定のオプションです)。
  • メンテナンス モードのマシンは、新しいジョブを受け入れられません。メンテナンス モードを有効化してこのオプションを選択すると、実行中のジョブはすべて完了しますが、その間に新しいジョブは検出されません。
  • このオプションは、すべてのジョブが完了するのを待機し、停止コマンドは発行しません。
• 実行中のすべてのジョブを停止し、完了するまで待機します。
  注:

  ジョブが正常にシャットダウンできるのは、基になるオートメーションが、適切な正常停止ロジックを実装して停止要求を処理するように設計されている場合のみです。この動作は、オートメーションの構築方法によっても異なります。

• 実行中のすべてのジョブを今すぐ強制終了

[確認] をクリックするとメンテナンス モードが有効化され、[キャンセル] ではメンテナンス モードに入るためのリクエストが取り消されます。

備考

• 保留中のジョブは、利用可能な別のマシン、またはオンラインに戻った同じマシンに取り込まれるのを待機している間、ジョブのステータスを維持します。
• メンテナンス モードはセッション (マシン + ホスト名) ごとに設定されるため、仮想/物理マシンでメンテナンスを実行できます。セッションに複数のランタイムが関連付けられている場合、それらのランタイムはすべて既定で選択されます。