237/461

## rotate-log

rotates the log file

Synopsis

    rotate-log [--help]

Description

The `rotate-log` subcommand rotates the server log by renaming the file with a timestamp name in the format `server.log_`date-and-time, and creating a new log file. Changes take effect dynamically, that is, server restart is not required.

The size of the log queue is configurable through the `logging.properties` file. Log rotation is based on file size or elapsed time since the last log rotation. In some circumstances, the queue might fill up, especially if the log level is set to `FINEST` and there is heavy activity on the server. In this case, the `rotate-log` subcommand can be used to rotate the server log immediately. This subcommand is also useful in creating scripts for rotating the log at convenient times.

This subcommand is supported in remote mode only.

Options

`--help`
`-?`

  Displays the help text for the subcommand.

`--target`

  The server, cluster, or server instance for which logs will be rotated. If this option is omitted, logs are rotated for the default server.

Operands

target

  Valid values are:

  - server_name - Default target is `server`. If no target is specified then logs are rotated for the server.

  - cluster_name - The name of a target cluster.

  - instance_name - The name of a target server instance.

Examples

Example 1 Rotating the Server Log

  This example rotates the server log.

      asadmin> rotate-log
      Command rotate-log executed successfully.

Exit Status

0

  subcommand executed successfully

1

  error in executing the subcommand

See Also

collect-log-files(1), list-log-attributes(1), list-log-levels(1), set-log-attributes(1), set-log-levels(1)

asadmin(1M)

"Administering the Logging Service" in Oracle GlassFish Server Administration Guide