twstrace

Changes the trace level on the dynamic agent and, at the same time, the same trace level on the job manager gateway, without having to stop and restart the agent.

Note: On Windows 2012, the command is not supported on Windows PowerShell.

Authorization

You must login with the credentials of the user which installed the dynamic agent. You can also use any authorization higher than the user which installed the dynamic agent.

Syntax

twstrace -u | -V | -enable | -disable [-level value] [-maxFilesfiles_number ] [-maxFileBytes bytes_number] [-getLogs [-zipFile zip_file_name] [-hosthostname ] [-protocol {http|https}] [-port port number] [-inifile ini_filename]]

Arguments

enable

Enables tracing to the maximum level. The maximum level is 3000. By default, traces are disabled.

disable

Disables tracing.

level value

The level of detail for the traces:

1000: Error, warning, and informational messages are traced.
2000: Error and warning messages are traced.
3000: Error messages are traced.

maxFiles files_number

The maximum number of the trace files you want to create.

maxFileBytes bytes_number

The maximum size in bytes that the trace file can reach. The default is 1024000 bytes.

getLogs

To collect the trace files, the message files and the configuration files in a compressed file.

zipfile zip_file_name

The name of the compressed file that contains all the information, that is logs, traces, and configuration files (ita.ini and jobManager.ini) for the agent. The default is logs.zip.

host hostname

The host name or the IP address of the agent for which you want to collect the traces. The default is localhost.

protocol http|https

The protocol of the agent for which you are collecting the traces. The default is the protocol specified in the .ini file of the agent.

port port number

The port of the agent. The default is the port number of the agent where you are running the command line.

inifile ini_filename

The name of the .ini file that contains the SSL configuration of the agent for which you want to collect the traces. The default is the .ini file of the local agent. If you are collecting the tracing for a remote agent for which you customized the security certificates, you must import the certificate on the local agent and specify the name of the .ini file that contains the configuration. To do this, perform the following actions:

Extract the certificate from the keystore of the remote agent.
Import the certificate in a local agent keystore. You can create an ad hoc keystore whose name must be TWSClientKeyStore.kdb.
Create a .ini file in which you specify:
- 0 in the tcp_port property as follows:
```
tcp_port=0
```
- The port of the remote agent in the ssl_port property as follows:
```
ssl_port=<ssl_port>
```
- The path to the keystore you created in step 2. in the key_repository_path property as follows:
```
key_repository_path=<local_agent_keystore_path>
```

u

Displays the command usage.

V

Displays the version of the product.

Examples

To set the trace level to record error and warning messages, run the following command:

 twstrace -enable -level 2000

To retrieve the information about the trace level, run the following command:

 twstrace -level -maxFiles -maxFileBytes

 AWSITA1761 The trace properties are: level="1000",
maxFiles="3", file size="1024000"