Skip to content

Run File Server Test Suite over QUIC

Jump to bottom
Angela Namikoye edited this page Jul 8, 2025 · 1 revision

QUIC Configuration

Selecting QUIC as the transport protocol is a configuration step. It can be changed using the Protocol Test Manager Web Service or manually, via the ptfconfig file associated to the test suite.

Configure using Protocol Test Manager Web Service

Protocol Test Manager (PTM) is a User Interface (UI)-based tool that helps you configure and run test cases. It is currently shipped as a web service downloadable from the Releases page. For instructions on how to install PTMService and run a test suite, refer to the PTMService Wiki.

To change the underlying transport layer:

  • Download the FileServer-TestSuite-ServerEP archive from the Releases page and install it using PTMService. Detailed instructions can be found within this Lab Tutorial (Section 3.2) if completely new to PTM Service
  • Follow the test suite setup steps until you get to Configure Test Cases step.

Configure test cases

  • The configurations are grouped according to supported sub test suites and contain some common settings shared across the board. We're interested in the Common properties, through which we can change the Underlying Transport protocol.

Underlying Transport Choices

  • Select Quic and proceed to run the configured test cases. It will use QUIC as the underlying transport protocol.

Configure Manually

The File Server Protocol Family Test Suite is installed with default configuration settings. However, you have the option to modify these settings according to your specific test environment needs. To change the underlying transport layer:

  • Download the FileServer-TestSuite-ServerEP archive from the Releases page and extract the archive.
  • Navigate to FileServer-TestSuite-ServerEP\Bin\ where you will find a number of configuration files (\*.deployment.ptfconfig). The data in these files is invoked whenever you run test cases with the use of either batch scripts or the Protocol Test Manager.
  • Edit CommonTestSuite.deployment.ptfconfig. This contains the common settings shared by all the sub test suites within the File Server suite. The configuration files contain <Description> tags that describe the purpose of configurable items.
  • Look for a property named UnderlyingTransport and update the value to the desired transport you'd like to use - Quic in this case.
    <Property name="UnderlyingTransport" value="Quic">
        <Choice>Tcp, NetBios, Quic</Choice>
        <Description>
            The underlying transport of SMB2 protocol
        </Description>
    </Property>
  • Save your changes and run the test suites as you normally would, using either batch scripts or the Protocol Test Manager.
Clone this wiki locally