The command line programs write their messages to the console or the log file you specified with the -protocolfile argument, see chapter Common arguments). There is no difference between error and trace file. Exceptions are output with other log output in the file specified or on the console. The value of the key PRINT_STACKTRACE_ON_EXCEPTION in the configuration file Server_settings.properties specifies whether the stack trace of an exception is output, as well. Valid values are TRUE and FALSE, the default value is FALSE.
The specified log options (-information, -warning, -error arguments) set the log level for each module to the specified value INFO, WARN, or ERROR. The log level configured for the module in the file Server_Log_settings.properties will be considered. Due to the hierarchical log level structure, please note the following when evaluating the log options specified. The log level to be used is determined as follows:
Example 1
The default log level for the module is INFO. When running a command line program with the parameters –information yes –warning no –error yes the log level is determined as follows.
The resulting log level is INFO.
Example 2
The default log level for the module is WARN. When running a command line program with the parameter –information yes the log level is determined as follows.
The resulting log level is INFO.
Example 3
The default log level for the module is INFO. When running a command line program with the parameter -warning no the log level is determined as follows.
The resulting log level is ERROR.
Summary
Information, warnings, errors, and fatal errors are output regardless of the settings for the other log arguments or the module-specific log level.
Warnings, errors, and fatal errors are output regardless of the settings for the other log arguments.
Furthermore, information is output for modules whose module-specific log level is set to INFO.
Errors and fatal errors are output. Furthermore, information is output for modules whose module-specific log level is set to INFO, as well as warnings for modules whose module-specific log level is set to INFO or WARN.
Only fatal errors are output. No messages are output for modules whose module-specific log level is set to OFF.
Format log output
The log output format of the command line programs for console output is specified by the console appender format. The log output format of log output to a file is specified by the appender logFile.
Except for the appender styles, no further configurations are evaluated for the command line programs from the files Server_Log_settings.properties and Analysisserver_Log_settings.properties. Therefore, additional appenders for the log output of the command line programs cannot be specified.
Server log output
The command line programs runppmconfig, runppmreport, and runppmadmin output particular log messages of the client server and analysis server. These messages appear both in the server log output and the command line program log output and are indicated by the additional module name.
Example
...
I: 05.10.10 14:41:53 [IMP] Importing configuration of component "users"...
I: 05.10.10 14:41:53 [IMP] [SRV] Importing users...
I: 05.10.10 14:41:53 [IMP] [SRV] Importing groups...
I: 05.10.10 14:41:53 [IMP] [SRV] The following 0 users were added: []
I: 05.10.10 14:41:53 [IMP] The configuration of the component "users" from the file
...