rotate-log(1)             asadmin Utility Subcommands            rotate-log(1)

NAME
       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

Java EE 8                         12 Feb 2011                    rotate-log(1)