Logging Command Line Options (Troubleshooting Sun Java System Portal Server Secure Remote Access 7)

Troubleshooting Sun Java System Portal Server Secure Remote Access 7

Logging Command Line Options

The following three commands are used for logging files for Secure Remote Access components:

list-loggers — Lists all the loggers.
set-logger — Sets the level for the logger and also the separate file for the logger.
reset-logger — Resets the log level and log file to root logger.

Psadmin List-Loggers Command Options

Use this table to review the options available for the list-loggers command.

Table 5 List-Loggers Command Line Options List


Option	Description
`--adminuser -u` `userName`	Specify the name of the administrator.
`--passwordfile` `-f password-filename`	Specify the administrator password in the password file.
`--component -m component-type`	Specify the component type. The valid values are `portal`, `search`, `pas`, `gateway`, `nlproxy`, and `rwproxy`.
`--portal \| -p portal-ID`	Specify the portal ID. This is required only if the component type is `portal`.
`--instance \| -i` `portal-instance-name`	Specify the portal server instance. This is required only if the component-type is `portal`.
`--searchserver -s search-server-ID`	Specify the search server ID. This is required only if the component type is `search`.
`--sra-instance` `sra-instance`	Specify the SRA instance name. This is required only if the component type is either `gateway`, `nlproxy`, or `rwproxy`.
`--detail`	Displays detailed information about loggers listed. It includes level, handler information, filename, and filehandler.

Psadmin Set-Logger Command Options

Table 6 Set-Logger Command Line Options List


Option	Description
`--adminuser -u` `userName`	Specify the name of the administrator.
`--passwordfile` `-f password-filename`	Specify the administrator password in the password file.
`--component \| -m` `component-type`	Specify the component type. The valid values are `portal`, `search`, `pas`, `gateway`, `nlproxy`, and `rwproxy`.
`--logger \| -O` `loggerName`	Specify the name of the logger.
`--level -L level`	Specify the level.
`--portal -p` `portal-ID`	Specify the portal ID. This is required only if the component-type is `portal`.
`--instance -i` `portal-instance-name`	Specify the portal server instance. This is required only if the component type is `portal`.
`--searchserver -s search-server-ID`	Specify the search server ID. This is required only if the component type is `search`.
`--sra-instancesra-instance-name`	Specify the SRA instance name. This is required only if the component type is either `gateway`, `nlproxy`, or `rwproxy`.
`--file -F`	Specify if the logger is to be logged to a separate file.
`--stack-trace -T`	This option can be specified only if --file option is specified. Specifies whether the stack trace should be printed in the log file. If this option is specified, the `--parent` option cannot be specified. The default is `false`. If you specify `true`, then the stack trace is printed in the log file.
`--parent -P`	This option can be specified only if `--file` option is specified. Specifies whether the log data should be printed in the parent log file of the current logger. If this option is specified, `--stack-trace` option cannot be specified. The default is `false`, if you do not specify the option, the log data is printed only in the current logger's log file. If you specify `true`, the log data is printed in the parent log file and also in the current logger's log file.

Psadmin Reset-Logger Command Options

Table 7 Reset-Logger Command Line Options List


Option	Description
`--adminuser -u` `userName`	Specify the administrators name.
`--passwordfile` `-f password-filename`	Specify the administrator password in the password file.
`--component \| -m` `component-type`	Specify the component type. The valid values are `portal`, `search`, `pas`, `gateway`, `nlproxy`, and `rwproxy`.
`--logger \| -O` `loggerName`	Specify the name of the logger.
`--portal -p` `portal-ID`	Specify the portal ID. This is required only if the component-type is `portal`.
`--instance -i` `portal-instance-name`	Specify the portal server instance. This is required only if the component type is `portal`.
`--searchserver -s search-server-ID`	Specify the search server ID. This is required only if the component type is `search`.
`--sra-instancesra-instance-name`	Specify the SRA instance name. This is required only if the component type is either `gateway`, `nlproxy`, or `rwproxy`.