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

Tosca Distribution (DEX) Server の動作を設定できます。

テスト実行中は構成を行わないでください。現在実行中のテストおよびキューに入っているすべてのテストが失われます。

失われた場合は、Tosca Serverを再起動して再びトリガーする必要があります。

一般的なサーバー構成

次の構成を、Automation Object Service つきの Tosca Distributed Execution で、および AOS なしの Tosca Distributed Execution に利用できます。

AOSを使用したTosca Distributed Execution のためのサーバー設定

以下の設定は、 AOSを使用したTosca Distributed Execution のみに利用可能です。

AOSを使用して、複数のリポジトリで動作するTosca Distributed Execution を設定することも可能です。詳細は、 see chapter "複数のリポジトリを使用したDistributed Execution with AOS" をご参照ください。

同期間隔を変更する

同期間隔は、 Tosca Distribution AgentTosca Distribution(DEX)サーバーにExecutionListsを実行するために要求する頻度を決定します。

デフォルトで、 DEX ServerAgent は 5 秒ごとに同期します。

同期間隔が短いほど、Agent アイドルモードで過ごす時間が少なくなりますが、ネットワークトラフィックは増加します。

期間隔を変更し、 し、して、異なるを設定するには、以下の手順に従います。

  1. Tricentisを開きます。DistributionServerService.exe.config ファイルを開きます。デフォルトで、このファイルはC:\Program File(x86)\TRICENTIS\Tosca Server\DEXServer にあります。

  2. applicationSettingslog4net セクションに移動します。

  3. 異なるAgentSynchronisationInterval に設定します。

  4. その他の一般的なコンフィギュレーションを変更したい場合は、今すぐ変更できます。

  5. コンフィギュレーションが完了したら、次のアクションを実行します。

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

    • Tricentis サービスを再起動します。 です。

例:10秒の同期間隔

<applicationSettings>
    <DistributionServer.Properties.Settings>
        ...
        <setting name="AgentSynchronisationInterval" serializeAs="String">
            <value>00:00:10</value>
        </setting>
    </DistributionServer.Properties.Settings>
</applicationSettings>

Agent の同期タイムアウトを変更する

Agent の同期タイムアウト間隔は、切断が発生した場合に DEXサーバーAgent の再接続を待つ時間を決定します。

デフォルトで、 DEXサーバーは残りのアイテムの実行に失敗するまで5分間待機します。

同 するには、以下の手順に従います。

  1. Tricentisを開きます。DistributionServerService.exe.config ファイルを開きます。デフォルトで、このファイルはC:\Program File(x86)\TRICENTIS\Tosca Server\DEXServer にあります。

  2. applicationSettingslog4net セクションに移動します。

  3. AgentSynchronisationTimeout の設定を探します。お客様の TricentisDistributionServerService.exe.config ファイル内で見つけることができない場合は、最後の手順に従っている例で説明されているように、それを含めます。

  4. 異なるAgentSynchronisationTimeout に設定します。

  5. その他の一般的なコンフィギュレーションを変更したい場合は、今すぐ変更できます。

  6. コンフィギュレーションが完了したら、次のアクションを実行します。

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

    • Tricentis サービスを再起動します。 です。

例:8分30秒の Agent 同期タイムアウト間隔

<applicationSettings>
    <DistributionServer.Properties.Settings>
        ...
        <setting name="AgentSynchronisationTimeout" serializeAs="String">
            <value>00:08:30</value>
        </setting>
        ...
    </DistributionServer.Properties.Settings>
</applicationSettings>

ドメインをホワイトリスト

ドメインをホワイトリストに登録した場合、 DEXサーバーはこれらのドメインからのエージェントまたは Tosca CIClient のみを受け入れます。

Agent または CIClientDEXサーバーに接続すると、サーバーは Agent または CIClient を起動したユーザーのドメインがリスト上のドメインと一致するかどうかを確認します。

同 するには、以下の手順に従います。

  1. Tricentisを開きます。DistributionServerService.exe.config ファイルを開きます。デフォルトで、このファイルはC:\Program File(x86)\TRICENTIS\Tosca Server\DEXServer にあります。

  2. applicationSettingslog4net セクションに移動します。

  3. UseAgentLdapAuthorizationTRUE に設定します。

  4. AgentLdapValidDomainsとして、ユーザードメインを入力します。

    • 複数のドメインをセミコロン区切りで入力できます。

    • ワイルドカードも使用できます。例: tricentis* あるいは tri*.com

    UseAgentLdapAuthorizationTRUE に設定しても、ドメインを入力しないと、ユーザーがTestCaseを実行しようとする際にエラーが表示されます。

  5. その他の一般的なコンフィギュレーションを変更したい場合は、今すぐ変更できます。

  6. コンフィギュレーションが完了したら、次のアクションを実行します。

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

    • Tricentis サービスを再起動します。 です。

例:ホワイトリストに登録された二つのドメイン

<applicationSettings>
    <DistributionServer.Properties.Settings>
        ...
        <setting name="UseAgentLdapAuthorization" serializeAs="String">
            <value>True</value>
        </setting>
        <setting name="AgentLdapValidDomains" serializeAs="String">
            <value>tricentis.com;google.*</value>
        </setting>
    </DistributionServer.Properties.Settings>
</applicationSettings>

ログファイルのパスを変更する

ToscaDistributionServer.log ファイルは、例えばエージェントがサーバーに登録したときや、TestEventが配信されたときなど、 DEXサーバーのすべての活動を記録します。

デフォルトで、システムはこのファイルを C:\ProgramData\TRICENTIS\ToscaServer\DistributionServer\logs に保存します。

このディレクトリに書き込みアクセスがある場合は、別のパスを指定することができます。

同 するには、以下の手順に従います。

  1. Tricentisを開きます。DistributionServerService.exe.config ファイルを開きます。デフォルトで、このファイルはC:\Program File(x86)\TRICENTIS\Tosca Server\DEXServer にあります。

  2. セクションに移動します。

  3. LogFileAppenderに別のパスを入力します。

  4. その他の一般的なコンフィギュレーションを変更したい場合は、今すぐ変更できます。

  5. コンフィギュレーションが完了したら、次のアクションを実行します。

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

    • Tricentis サービスを再起動します。 です。

例:ログファイルへのカスタムパス

<log4net>
    [...]
    <appender name="LogFileAppender" type="log4net.Appender.RollingFileAppender">
        <param name="File" value="C:\ProgramData\CustomPath"></param>
        <param name="AppendToFile" value="true"></param>
        <rollingStyle value="Size"></rollingStyle>
        <maxSizeRollBackups value="10"></maxSizeRollBackups>
        <maximumFileSize value="10MB"></maximumFileSize>
        <staticLogFileName value="true"></staticLogFileName>
        <layout type="log4net.Layout.PatternLayout">
            <param name="ConversionPattern" value="%date [%thread] %-5level %logger - %message%newline"></param>
        </layout>
    </appender>
</log4net>

ワークスペースのリトライ間隔を設定する

このオプションは、 AOSを使用したTosca Distributed Execution にのみ利用可能です。

Tosca Commander でTestEventを実行した後、 Automation Object Service(AOS)はワークスペースにアクセスします。失敗した場合は、90000ミリ秒(90秒)後に再試行します。

同 するには、以下の手順に従います。

  1. Windowsタスクマネージャーで、 Tricentisというサービスがあるかご確認ください。ToscaAutomationObjectService が実行中です。実行中の場合は停止させる。

    これには少し時間がかかる可能性があります。Windowsタスクマネージャーのプロセスタブをダブルチェックし、 Tricentisにリストされないようにします。ToscaAutomationObjectService.TcApiExecutor.exe です。

  2. Tricentisファイルを開きます。ToscaAutomationObjectService. です。TcApiExecutor.dll.configデフォルトで、ファイルは C:\Program Files(x86)\TRICENTIS\Tosca Server\AutomationObjectService にあります。

  3. applicationSettingslog4net セクションに移動します。

  4. の新しいをミリ秒単位で入力します。

  5. その他のやAOSコンフィギュレーションを変更したい場合は、今すぐ変更できます。

  6. コンフィギュレーションが完了したら、次のアクションを実行します。

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

    • Tricentis TricentisのDistributedExecutionServiceです。WindowsタスクマネージャーのToscaAutomationObjectService です。

例:10000msの再試行間隔

<Tricentis.TcApiExecutor.Properties.Settings>
    <setting name="WaitTimeInMsForOpenWsRetry" serializeAs="String">
        <value>10000</value>
    </setting>
    [...]
</Tricentis.TcApiExecutor.Properties.Settings>

カスタム DEXサーバーポート を設定する

デフォルトで、 DEX Server はポート 5007 で実行します。別のポートを使用するには、以下の手順に従ってください:

  1. TricentisDistributionServerService.exe.config ファイルを開きます。デフォルトでは、このファイルは C:\Program Files(x86)\Tricentis\Tosca Server\DEXServer にあります。

  2. 4つの各 baseAddresses のポート番号を、別のポート番号に変更します。

新しい DEX Server のポート番号を選択する

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

  2. HTTPSバインディングがある場合は、HTTPS証明書を新しいポートで使用するように設定してください。そのためには、管理者権限で次のコマンドを実行してください。

    cd C:\Program Files (x86)\TRICENTIS\Tosca Server\DEXServer\

    _SetHttpsCertificate.cmd <certificate thumbprint> <desired port>

    <certificate thumbprint> フィールドと <desired port> フィールドには、それぞれの値を入力します。

  3. Tricentisサービスを再起動します。WindowsタスクマネージャーのDistributedExecutionServiceです。

  4. appConfig.json ファイルを開いてください。デフォルトでは、このファイルは C :\Program Files (x86)\Tricentis\Tosca Server\DexMonitor にあります。

  5. baseUrl のポート番号を別のポート番号に変更します。

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

  7. Tricentisサービスを再起動します。WindowsタスクマネージャーのDistributedExecutionMonitorです。

  8. エージェントを設定し、新しいポートを使用できるようにします。このプロセスは、セットアップの種類によって異なります。:

  9. 新しいポートを使用するようにTricentis Toscaを設定する。そのためには、プロジェクト->; 設定->Commander->分散実行 ->; サーバに移動し、 EndpointAddress の設定を適宜更新してください。

  10. Automation Object Serviceを使用する場合は、 Tricentis Service ConfigurationAutomation Object Service タブの新しいポート番号で Distributionサーバアドレスを更新します。

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

Consulと Ocelotの構成

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

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

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

プロパティ

説明

ポート

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

http

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

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

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

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

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

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

プロパティ

説明

DownstreamScheme

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

ポート

DEXサーバーを入力します。

変更を適用する

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

  • Tricentis.DistributedExecutionService

  • Tricentis.GatewayService

  • ConsulService