Transfer Traces: transfer-traces

The transfer-traces command is used to convert a multi-configuration environment into a Federated Tracing solution.

It requires each configuration to have the FederatedTraceServer config option to reference the GUID of the one configuration which will store all the traces.

This command should be run once for each participating configuration, the target always pointing to the federated trace configuration. The command moves each cross configuration trace it discovers over to the federated configuration.

Syntax

The syntax for this command is:

stcmd transfer-traces -s "Source Server" -t "Target Server" [-q] [-ofp outputfilepath}
Parameter
Description
-s

Identifies the StarTeam Server. The full syntax is: -s "userName:password@host:portNumber"

For example: -s "JMarsh:password@orion:49201"

If the user name is omitted, the current user name is used. The user name in the example is “JMarsh”.

If the password is omitted, the user is prompted to enter the password. The password in the example is “password”. If the host name is omitted, the default is localhost. The host name in the example is “orion”.

The port number is required. The default port number, 49201, is used in the example.

-t

Represents the federated trace server to be written to.

-q
Enables quiet mode. The -q option is retained for backward compatibility with the old command line. If -q is specified, then -pf cannot be specified. The command will return no results.
-ofp

Provides a file name with a fully qualified path into which to write the command output. By default, a "|" character separates each column in the output. A new line separates each row. The first row is the command name. The second row has the property names. All subsequent rows contain the data. If the file already exists, the output is appended to the end of the file.

It is possible to override the "|" character separator by specifying separator = fieldSeparator as a parameter to the connect command.

For example, separator = ;; specifies two adjacent semicolons ( ; ) as the column separator.

-q and -ofp are mutually exclusive.

Example

stcmd transfer-traces -s "Administrator:Administrator@bel-151traces:49201" -t "bel-151traces:49203" [-q] [-ofp c:/temp/transferred.txt}