set-log-attributes

sets the logging attributes for one or more loggers

Synopsis

set-log-attributes [--help] [--target=target] 
attribute-name=attribute-value[:attribute-name=attribute-value]*

Description

The set-log-attributes subcommand sets logging attributes for one or more loggers. The attributes you can set correspond to the attributes that are available in the logging.properties file for the domain. Depending on the attributes you set, a server restart may be necessary.

This subcommand is supported in remote mode only.

Options

--help
-?: Displays the help text for the subcommand.
--target: The server domain, instance, or cluster for which logger attributes will be set. If this option is omitted, attributes are set for the default server.

Operands

target

Valid values are:

server_name - Default target is server. If no target is specified then log attributes are set for the server.
cluster_name - The name of a target cluster.
instance_name - The name of a target server instance.

attribute-name

The fully scoped name of the logging attribute. The list-log-attributes subcommand can be used to list the names of all currently defined attributes.

attribute-value

The value to apply to the specified attribute.

The attribute values that can be specified include the following. Refer to the online help and "Administering the Logging Service" in Oracle GlassFish Server Administration Guide for complete explanations of each of these values.

com.sun.enterprise.server.logging.GFFileHandler.alarms: Default is false.
com.sun.enterprise.server.logging.GFFileHandler.file: Default is ${com.sun.aas.instanceRoot}/logs/server.log.
com.sun.enterprise.server.logging.GFFileHandler.flushFrequency: Default is 1.
com.sun.enterprise.server.logging.GFFileHandler.formatter: Default is com.sun.enterprise.server.logging.UniformLogFormatter.
com.sun.enterprise.server.logging.GFFileHandler.logtoConsole: Default is false.
com.sun.enterprise.server.logging.GFFileHandler.maxHistoryFiles: Default is 0.
com.sun.enterprise.server.logging.GFFileHandler.retainErrorsStasticsForHours: Default is 0.
com.sun.enterprise.server.logging.GFFileHandler.rotationLimitInBytes: Default is 2000000.
com.sun.enterprise.server.logging.GFFileHandler.rotationTimelimitInMinutes: Default is 0.
com.sun.enterprise.server.logging.SyslogHandler.useSystemLogging: Default is false.
handlers: Default is java.util.logging.ConsoleHandler.
java.util.logging.ConsoleHandler.formatter: Default is com.sun.enterprise.server.logging.UniformLogFormatter.
java.util.logging.FileHandler.count: Default is 1.
java.util.logging.FileHandler.formatter: Default is java.util.logging.XMLFormatter.
java.util.logging.FileHandler.limit: Default is 50000.
java.util.logging.FileHandler.pattern: Default is %h/java%u.log.
log4j.logger.org.hibernate.validator.util.Version: Default is warn.

Examples

Example 1 Setting a the Maximum of Log History Files to Maintain

This example sets to 8 the maximum number of log history files for the server as a whole.

asadmin> set-log-attributes --target=server \
com.sun.enterprise.server.logging.GFFileHandler.maxHistoryFiles=8
com.sun.enterprise.server.logging.GFFileHandler.maxHistoryFiles logging 
attribute set with value 8.
These logging attributes are set for server.
Command set-log-attributes executed successfully.

Exit Status

0: subcommand executed successfully
1: error in executing the subcommand