Command line programs

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:

  1. In the order of the -information, -warning, -error arguments specified the last no parameter found is determined.
  2. In the order of the -information, -warning, -error arguments specified the first yes parameter found is determined.
  3. From the "no" value found last in the first step and based on the module-specific default log level, the more restrictive log level is determined. If no "no" value is specified the default log level applies.
  4. From the "no" value found first in the second step and based on the log level determined in the third step, the log level with the least restrictive log level is determined.

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

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

...