!!LOG ARCHIVER: 05/04/1999 19:33:09 Log successfully archived for WebSTAR Web server
Log Archiving allows you to save separate log files covering specified periods of time, such as every day, every week on Thursday, or monthly. The log files are automatically created at the time you set, filled by the server, then closed, moved and the next one is created.
The automated archiving saves a copy of your log file at a specified interval, with the date and time in the file name. This keeps the log file from getting too big and makes it easy to locate a specific time period. By default, log archiving is off . You should enable it if your server is at all busy.
When it archives a log, the WebSTAR server will temporarily suspend logging, transfer the log file to the specified location, then create a new log file in the Logs folder (or the location you specified in the Logging Options part of the panel).
The file will be named by the day and time that it is created. For example, a mail log archive made at 1 PM on February 6 is named WebSTAR Mail 1999.02.06.13.log .
The archived log file name specifies when the archived period ended , not the when the archive period began . While this is slightly confusing, it more accurately reflects the contents of the file, particularly if you switch from one schedule to another.
WebSTAR follows certain automated procedures when the scheduled log archiving time arrives. This allows the servers to continue handling requests while copying the log information and clearing the main log file.
Make sure that you are copying logs to the same volume. It takes much longer to copy them to another volume than to move a file on the same volume.
When the Log Archiver moves a log file, it reports it in the Web Monitor and Status window:
If there's an error, it will report it as well.
Log file analysis programs will ignore lines starting with !! .
When you start the WebSTAR application, the status of the archiving is displayed in the Status window and stored in the Web Log file, like this:
!!LOG ARCHIVER: and will next occur on 06/01/1999 at 06:00 PM.
!!LOG ARCHIVER: Log archiving for WebSTAR Proxy server is disabled.
!!LOG ARCHIVER: Log archiving for WebSTAR Mail server is scheduled to run hourly
!!LOG ARCHIVER: and will next occur on 06/01/1999 at 06:00 PM.
When you launch the WebSTAR application and the server was down during the time when the log was to be moved, you'll see a message like this:
!!LOG ARCHIVER: It has been re-scheduled to occur in 3 minutes.
!!LOG ARCHIVER: The WebSTAR Web server log will then be archived hourly, as configured.
!!LOG ARCHIVER: 06/01/1999 17:06:47 Log successfully archived for WebSTAR Web server
Each server settings section of the WebSTAR Admin allows you to specify the log archive status, schedule and location.
There are several radio buttons for specifying the archive schedule to copy the mail log to an archive file:
This specifies the hour for archive copying in a 24-hour clock, so "17" is 5 PM. The hour can range from 1 (1 AM) to 24 (12 midnight).
The field is enabled except when the Hourly archiving is selected.
This popup menu lets you choose the day of the week for archive copying. It is only enabled when Weekly archiving is selected.
This field lets you specify the day of the month, from 1 to 31, on which to copy the log to the archive. It is enabled when you are archiving Monthly.
This field lets you specify the folder to store archive log files. Press the Choose button, and choose the folder from the server disk or type a file path.
The default value is the archived_logs folder in the Logs folder in the WebSTAR folder. You can download the archived logs by FTP or view them as text files in your web browser. These can also be imported into FileMaker Pro or Excel, or analyzed with a third-party product such as Funnel Web.
The archived files will be named according to their server, date and time, except for the Web server log. For historical compatibility, it is just called "WebSTAR". Example log names are:
WebSTAR FTP 1999.02.06.14.log
WebSTAR 1999.02.06.15.log
WebSTAR Proxy 1999.02.06.16.log
Be sure to store everything on the same hard drive as the server. Do not designate a remote volume, which may be inaccessible when needed.
Archiving on the same hard drive is much faster, because the server can move the file rather than copying it.
The Log Archiver will provide periodic status reports in the Web server monitor window. For example:
!!LOG ARCHIVER: LOG ARCHIVER STATUS REPORT:
!!LOG ARCHIVER: No logs are currently being archived
!!LOG ARCHIVER: ============================