Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME trace_rotate - Rotates trace files SYNOPSIS trace_rotate trace_file AVAILABILITY SUNWsamfs DESCRIPTION The trace_rotate script rotates trace files generated by Sun QFS or SAM-QFS daemons. It is executed by sam-fsd when a daemon trace file has aged or grown beyond parameters specified in the defaults.conf file. The process of rotating trace files assumes that you want to keep no more than seven generations of a trace file in your directories at one time. When the trace files are rotated, the newest trace file is renamed trace_file.1, the next- newest trace file is renamed trace_file.2, and so on. The oldest trace file in the directory is deleted as new ones are added, so the oldest trace file in the directory at any time is always called trace_file.7. This process provides two benefits: o A given trace file never becomes so large that it is unwieldy to copy or view. o Entries are expired after a period of time. This prevents file systems from filling up due to the volume of trace entries. OPTIONS This command accepts the following arguments: trace_file The full path name of the trace file. EXAMPLES By default, trace files are rotated by the sam-fsd daemon according to parameters specified in the /etc/opt/SUNWsamfs/defaults.conf file. If no parameters are specified, the trace files are rotated when their size reaches 10 megabytes. The current parameters can be displayed by executing the /opt/SUNWsamfs/sbin/sam-fsd command. You could use the following command line to invoke the script manually: # trace_rotate /var/opt/SUNWsamfs/trace/sam-archiverd You can enable this script's trace file rotation mechanism automatically in one of the following ways: Method 1. By using the daemon_name.age=age or the daemon_name.size=size directive in the defaults.conf(4) file. For more information, see the defaults.conf(4) man page. Method 2. By setting up a crontab(1) entry to run the trace_rotate script. The following crontab(1) entry maintains eight back-up files, sam- archiverd.0 through sam-archiverd.7, plus the original: 10 3 * * 0 /opt/SUNWsamfs/sbin/trace_rotate /var/opt/SUNWsamfs/trace/sam-archiverd SEE ALSO crontab(1). sam-fsd(1M). defaults.conf(4).