SOA client framework logging

Default logging behavior By default, all SOA client applications log every request sent to the Teamcenter server. You can change the default logging level for a SOA client by setting the TC_SOACLIENT_LOGGING environment variable in their startup script.. The value can be set to ERROR, WARN, INFO, OFF, or DEBUG. If not set, logging defaults to INFO. The SOA client framework names its log files with the application name and a timestamp of the file creation. Using a combination of environment variables and Java parameters, you can create rolling log files, change where the log files are located, and modify how many files to keep before they are deleted. Log file location When the SIEMENS_LOGGING_ROOT environment variable is set, the log files are written to: Windows:%SIEMENS_LOGGING_ROOT%\SOA\app_soa_timestamp.log Linux: $SIEMENS_LOGGING_ROOT/SOA/app_soa_timestamp.log If SIEMENS_LOGGING_ROOT is not set, the log files are written to Windows: %USERPROFILE%\Siemens\logs\SOA\app_soa_timestamp.log Linux: $HOME/Siemens/logs/SOA/app_soa_timestamp.log Following are some example SOA log file names. Copy LISHttpServer_soa_20260506025818.log LISHttpServer_soa_20260508175936.log RAC_soa_20260508181431.log ServiceMode_soa_20260506223509.log TcFtsIndexer_soa.log Worker_soa_20260506213842.log Worker_soa_20260508180646.log log4j2.properties file With Java clients, if the log4j2.properties file exists in the application's path, those settings are honored. If both the log4j2.properties file exists and TC_SOACLIENT_LOGGING is set, both logs are written to. Environment variables and system properties You can further customize logging with the following environment variables or system properties, with the value of the environment variable taking precedence. Variable Description Default TC_SOACLIENT_APP_NAME (java) Value of 'app' in the log file name 'app_soa_timestamp.log'. If not set, 'app' is the name of the Java class that constructs the Connection class. Not applicable TC_SOACLIENT_FMS_LOGGING (Java) Set to ERROR, WARN, INFO, or DEBUG to enable logging for FMS related log messages. INFO TC_SOACLIENT_HTTP_LOGGING Set to ERROR, WARN, INFO, or DEBUG to enable logging for HTTP Client related log messages. ERROR TC_SOACLIENT_LOGGING_FOLDER Set the exact folder where the log files are to be created, overriding the SIEMENS_LOGGING_ROOT locations. Not applicable TC_SOACLIENT_LOGGING_FILES_TO_KEEP Set the number of log files to keep. A new log file is created for each application run, with the name pattern 'app_soa_timestamp.log'. When the number of log files exceeds the specified number, the oldest log file is deleted. 5 TC_SOACLIENT_ROLLING_FILES_TO_KEEP (Java) Set the number of rolling files to keep. A new log file when the application is started, 'app_soa.log', each day a backup is created 'app_soa_mm-dd-yy.log'. When the number of log files exceeds the specified number, the oldest log file is deleted. 0