Rotating specified log files
Run one of the following utilities to rotate a particular log file. On Windows, set up scheduled tasks that run the utilities. On UNIX, write a
cron job that periodically runs the utilities. The behavior is the same on both Windows and UNIX, except as noted. The only way to rotate the correlator input log is to rotate all log files. See
Rotating all log files.
The following command instructs the correlator to close its status log file and start using a status log file that has the name you specify. If the name of the file contains blanks, be sure enclose it in quotation marks.
engine_management --setLogFile log-filename
engine_management --setApplicationLogFile [node=]log-filename
If you use separate log files for particular packages, monitors, or events you might want to rotate those logs at the same time that you rotate the correlator status log. This keeps your Apama log files in sync with each other. See
Rotating all log files.
On Windows, when you rotate a log file you must ensure that the new log filename is different from the name of the log file that was in use. Apama takes care of this for you if you specify ${ROTATION_TIME} and/or ${ID} in the log-filename specification. If the name is not different, the old file is overwritten. If you want to use the same log filename then you must move the file before you rotate it.
On UNIX, a log file is never overwritten. If you rotate a log file and specify the same name then Apama appends messages to the content already there.
Apama does not support automatic log file rotation based on log file size.
The only way to rotate the correlator input log is to rotate all log files. See
Rotating all log files.
