Skip to content

PTMService

chenlu0616 edited this page Jun 13, 2022 · 7 revisions

PTMService

PTMService is a cross-platform, web-based application for managing and running Windows protocol test suites. It replaces the old, .NET Framework based Protocol Test Manager application.

Install

  • Download and install .NET 6.0 for your platform.

  • Download PTMService.zip/PTMService.tar.gz from the Releases page and extract the archive.

  • Optionally, if you want to add a desktop icon shortcut for PTMService on Windows and install PTMService into a different directory, you may run the install.ps1 powershell script:

powershell .\install.ps1

Running

We recommend running PTMService in-place. On Windows and macOS, you may need to set up .NET dev certificates first:

dotnet dev-certs https
dotnet dev-certs https --trust

Launch your shell in the extracted PTMService folder (by default is C:\PTMService) and run

dotnet PTMService.dll

to start the service.

Open your browser (Internet Explorer 11 is not supported) and go to https://localhost:5001/ to access PTMService. Ignore any certificate errors that may occur.

Usage

  • Go to the Management tab. PTMService Management tab

  • Upload a test suite. You could either download released test suite zips from the Releases page or compile the test suite from source.

  • Go to the Run TestSuite tab and select the test suite you just added. Select the test suite to run

  • Add a configuration for the test suite. A configuration contains the metadata required for a test run, e.g. hostnames, credentials, test cases selected, etc. Add a configuration

  • Edit the configuration. There are three ways to initialize a configuration: by auto-detection using PTMService itself, by manual configuration, or by loading a pre-existing profile.

  • Run the test suite using the configuration that you've just created.