Starting a Matcher Server - trillium_quality - Latest

Trillium Director Guide

Product type
Software
Portfolio
Verify
Product family
Trillium
Product
Trillium > Trillium Quality
Version
Latest
Language
English
Product name
Trillium Quality
Title
Trillium Director Guide
Copyright
2024
First publish date
2008
Last updated
2024-10-18
Published on
2024-10-18T15:24:10.895371

The matcher server runs as a service under Windows and as a daemon under Linux.

Syntax
TSQRMatcher         -d name -f filename -h hostname
                    -i ServerId -l filename
                    -n name -o processingLevel
                    -p port -s SystemId
                    -t filename
                    -H matcher_hostname -cl
                    -P matcher_port
                    -j project_path
                    [-UnregServer|-Service|-RegServer]

Parameters

-d name

Service display name. The default is TS Matcher Server.

-f filename

Path and name of the Configuration file. See Identifying Configuration and Settings Files for more information.

-h hostname

Name of the Director host or IP address (in dotted decimal format) of the node where the Director is running. If this argument is omitted, the server uses the value of the environment variable TRILLDIRADDR.

-i ServerId

Name by which the server is known to the Director, containing from 1 to 8 characters and beginning with an R, r, M, or m. The default is RMatcher.

Note: Whenever a client requests a server from the Director it must specify a Server ID and System ID to identify the type of server required.

Server ID + System ID = Server Name 

-l filename

Path and name of the file that the server uses to log various startup, informational, and error messages.

Note: This file is only used if the server is registered as a local server. Windows messages are sent to the system’s Application Event Log.

-n name

Internal Service name. The default is TS Quality Matcher.

-o processingLevel

The processing level options are:

Minimum - Requests will be placed in a queue; no threads will be spawned. Note that the network queue limits the number of attach requests that can be waiting.

Default -One thread will be actively cleansing; another thread will be listening for requests on the network. Other requests will wait.

High - Eight threads will be actively cleansing. Other requests will wait.

Maximum - A thread will be created for each incoming request. 

At all levels, the maximum number of concurrent attaches is 128.

-p port

Port on which the Director listens for incoming requests. If this argument is omitted, the value of the environment variable TRILLDIRPORTis used.

-s SystemId

System ID by which the server is known to the Director. The maximum length is 1. Default is S.

Note: Whenever a client requests a server connection from the Director, it must specify a Server ID and System ID to identify the type of server required.

Server ID + System ID = Server Name

-t filename

Path and name of the trace file used by the server to record network trace information. Use the Director System Manager to activate the trace function.

-H matcher_hostname

The name of the host or IP address (in dotted decimal format) of the node that the matcher uses to register with the Director. This node is used by clients to communicate with the matcher. Setting this switch allows the use of an IP address that is different than the default IP address. This might be used if the default IP address is incorrect due to use of VPN (Virtual Private Network) software, or if a Tunneling protocol is required.

-cl

(Windows) Start a matcher that has not been registered as a service with Windows.

-P matcher_port

Port on which the matcher will listen for service requests from the client. If this argument is omitted, a random port is assigned when the service is started.

-j project_path

(Optional) The path to the project. If not specified, the matcher will use the path specified with the -f parameter.

-UnregServer

(Optional) Unregisters the server. (Windows only.)

-RegServer

(Optional) Registers the server as a local server. (Windows only.)

-Service

(Optional) Registers the server as a service. (Windows only.)