オプションの Tosca Distribution Agent の設定

ほとんどの Agent 設定は、 Tosca DistributionMonitor (see chapter "Tosca Distributed Execution Monitor でエージェントを監視、復旧、設定する") で変更できます。

さらに、構成ファイルでは以下の設定を変更することができます。

ワークスペースログの詳細変更

Tosca Distributed Execution は、 Agent 自体に関係するすべてのアクティビティを Agent ログに書き込みます。このログは、 Tosca DistributionMonitor (see chapter "「Logging 」タブ") で設定できます。

AOSを使用せにTosca Distributed Execution を利用する場合は、追加のログとしてワークスペースログがあります。ワークスペースログは Agent のすべてのワークスペースアクティビティを記録します。

ワークスペースフォルダー内に、ログファイル Log_<date_number>.txt があります。

ワークスペースログの利用可能な詳細範囲は 4 から 12 までです。値を 4 にすると、最も詳細度の低いログが表示され、値を 12 にすると、すべての更新の詳細なログが表示されます。

デフォルトでは、値は 4 に設定されています。

ワークスペースのログレベルしてタイムフレームを変更するには、次の手順に従います。

  1. Agent を停止します。

  2. エージェントマシンで、ファイルを開きます。デフォルトでは、このファイルは C:\Program Files(x86)\TRICENTIS\Tosca Testsuite\:\Program Files(x86)\TRICENRIS\Tosca Testsuite\DistributedExecution\Rdp にあります。

  3. userSettingsのセクションで、 LogLevel新しいを入力してください

  4. RDPタイムアウト 設定も変更したい場合は、ここで行うことができます。

  5. 構成を完了したら、次のアクションを実行します。

    • ファイルを保存して閉じます。

    • Agent起動します。

例: ログレベル6

<userSettings>
  <Tricentis.DistributionServer.Properties.Settings>
  ...
    <setting name="LogLevel" serializeAs="String">
      <value>6</value>
    </setting>
  ...
  </Tricentis.DistributionServer.Properties.Settings>
</userSettings>

カスタムRDPポートを設定する

Agent には、RDP 接続用の受信ポートが必要です。Windowsのリモートデスクトップのデフォルトのポートは 3389 です。

Windowsのリモートデスクトップに別のポートを指定してある場合は、エージェント構成でこのポートも変更する必要があります。Windowsのリモートデスクトップに異なるポートを設定したすべてのエージェントマシンでこれを行う必要があります。

するには、次の手順に従います。

  1. Agent を停止します。

  2. エージェントマシンで、 ファイルを開きます。デフォルトでは、このファイルは にあります。

  3. アプリケーション設定のセクションで、 RdpListeningPort新しいを入力してください

  4. 設定も変更したい場合は、ここで行うことができます。

  5. 新しいポート番号を使用して、ConsulとOcelotの構成ファイルを更新します。

  6. 構成を完了したら、次のアクションを実行します。

    • ファイルを保存して閉じます。

    • Agent起動します。

例: ポート4444を設定する

<applicationSettings>
    <Tricentis.RdpServer.Properties.Settings>
        [...]
        <setting name="RdpListeningPort" serializeAs="String">
            <value>4444</value>
        </setting>
        [...]
    </Tricentis.RdpServer.Properties.Settings>
</applicationSettings>

RDP接続タイムアウトを定義する

ランタイムに、 Agent は30000ミリ秒 (30秒) 間RDP 接続を確立しようとします。そのタイムフレーム内に成功しなかった場合、 Agent は中断します。

タイムフレームは変更することができます。異なるタイムフレームが必要なすべてのエージェントマシンでこれを行う必要があることにご注意ください。

するには、次の手順に従います。

  1. Agent を停止します。

  2. エージェントマシンで、ファイルを開きます。デフォルトでは、このファイルは C:\Program Files(x86)\TRICENTIS\Tosca Testsuite\:\Program Files(x86)\TRICENRIS\Tosca Testsuite\DistributedExecution\Rdp にあります。

  3. userSettingsのセクションで、 EstablishRdpConnectionTimeoutMilliseconds新しいを入力してください

  4. ワークスペースのログレベル 設定も変更したい場合は、ここで行うことができます。

  5. 構成を完了したら、次のアクションを実行します。

    • ファイルを保存して閉じます。

    • Agent起動します。

例:40秒のタイムアウト間隔

<userSettings>
    [...]
    <setting name="EstablishRdpConnectionTimeoutMilliseconds" serializeAs="String">
        <value>40000</value>
    </setting>
    [...]
</userSettings>

RDP接続の再試行を定義する

デフォルトでは、RDP接続が失われた場合に、 Agent は接続の再確立を試みません。

実行中の Agent にログインすると、実行が停止し、再開することはできません。リスクを最小限に抑えるために、 Agent が失われた接続の再確立を試みるように指定することができます。再接続を試みるべきすべてのエージェントマシンでこれを行う必要があることにご注意ください。

するには、次の手順に従います。

  1. Agent を停止します。

  2. エージェントマシンで、 ファイルを開きます。デフォルトでは、このファイルは にあります。

  3. アプリケーション設定のセクションで、 新しいを入力してください

    • MaxConnectionRetries: 再試行の最大回数を入力します。

    • WaitBetweenRetriesMilliseconds: Agent が試行の間に待機すべきミリ秒数を指定してください。

  4. 接続再試行 設定も変更したい場合は、ここで行うことができます。

  5. 構成を完了したら、次のアクションを実行します。

    • ファイルを保存して閉じます。

    • Agent起動します。

再試行中、システムはアクティブなユーザーをログアウトします。

したがって、RDP接続を再確立しようとしている Agent にログインすると、システムはその後すぐにログアウトさせます。

例: 3回の再試行と最大20秒の待機時間

<applicationSettings>
    <Tricentis.RdpServer.Properties.Settings>
        [...]
        <setting name="MaxConnectionRetries" serializeAs="String">
            <value>3</value>
        </setting>
        <setting name="WaitBetweenRetriesMilliseconds" serializeAs="String">
            <value>20000</value>
        </setting>
        [...]
    </Tricentis.RdpServer.Properties.Settings>
</applicationSettings>

Consulと Ocelotの構成

RDPサーバーのデフォルトのポートまたはエンドポイントアドレスを変更する場合は、Consul構成ファイルおよびOcelot構成ファイルを更新する必要があります。以下のセクションでは、これらのファイルの場所と関連するプロパティの更新方法について詳しく説明します。

Consul構成ファイルを更新する

サービスのConsul設定ファイルで、以下のプロパティ値を更新します。このファイルは、 C:\Program Files (x86)\TRICENTIS\Tosca Server\Gateway\Consul\config\RdpService.json にあります。

プロパティ

説明

ポート

RDPサーバーのアドレス指定に使用するポートを入力します。

http

RDPサーバーで使用されるポートを含む完全なアドレスを入力します: <http or https>://<name of host>:<port>

Ocelot構成ファイルを更新する

RDP Server のOcelot構成ファイルを更新するには、次の手順に従ってください。

  1. C:\Program Files (x86)\TRICENTIS\Tosca Server\Gateway にある ocelot.json ファイルを開きます。

  2. ServiceId値が RdpService の つ2 つの要素を探します。

  3. これこれらの要素中にある以下のプロパティの値を更新します。

プロパティ

説明

DownstreamScheme

選択したバインディングに応じて、 http または https のいずれかを入力します。

ポート

RDPサーバーポートを入力します。

変更を適用する

次のサービスを再起動し、変更を適用する。

  • Tricentis.RdpService

  • Tricentis.GatewayService

  • ConsulService