Log File Transfer

The system logs contain important information for debugging and maintaining the switch. After the current log file reaches the configured maximum size, the system creates a new log file for logging. The system transfers old log files to a remote host. You can configure up to 10 remote hosts, which creates long-term backup storage of your system log files.

Of the 10 configured remote hosts, 1 is the primary host and the other 9 are redundant. Upon initiating a transfer, system messaging attempts to use host 1 first. If host 1 is not reachable, system messaging tries hosts 2 to 10.

If log file transfer is unsuccessful, the system keeps the old log files on internal flash. The system attempts to transfer old log files after the new log file reaches the configured maximum size. The system also attempts to transfer old log files periodically (once in one hundred log writes) if the disk space on the flash is more than 75% full.

You can log system log messages to external system log hosts with both IPv4 and IPv6 addresses with no difference in functionality or configuration.

With enhanced secure mode enabled, authorized users can use SFTP to transfer files to a remote server with the content encrypted.

You can specify the following information to configure the transfer criteria:

Be aware of the following restrictions to transfer log files to a remote host:

Note

Note

The maximum number of log files is 1,000. The maximum size of one log file is 1,024 KB. You cannot configure the log file parameters on 5320 Series or 5420 Series. On these platforms, the number of log files is restricted to 145 and the size of a log file is restricted to 126 KB.

The internal flash must be less than 75% full for the system to log a file. If the internal flash is more than 75% full, logging to a file stops to prevent exhausting disk space.

Log file transfer using a wildcard filename

File transfers using SFTP require file permissions.

Use the command attribute WORD<1-99> [+/-] R to change the permissions of a file.

To change permissions for all log files, use the wildcard filename log.*. Using the command in the wildcard form attribute log.* [+/-]R changes permissions for log files with names that begin with the characters “log.”.

Important

Important

You cannot use a wildcard pattern other than log.* for this command.