Technical information

SERVER MAINTENANCE

141

Important note

Regardless of the platform you are using, you must make sure that the VSI-FAX user has enough rights to

access the above directories. If this user is unable to read or write files in these directories, the VSI-

FAX scheduler will not be able to run.

Debug log files

Debug files are created each time the scheduler is restarted. These files are self-maintaining, and they will not

become unreasonably large if the scheduler is restarted periodically. We recommend that the scheduler be restarted

once a day to ensure that, along with maintaining the debug log files, any defunct/runaway processes can be

managed. This also ensures that the shared memory segments and resources used by VSI-FAX are reset and

cleaned, which will help to ensure smooth VSI-FAX operation.

The log file names are numerically incremented each time the scheduler is started, up to the number of files set in the

$VSIFAX/lib/vsisrv.ini file, using the max-debug-log entry. The current debug files do not have a number

designation (fax1). However, as new debug files are created, they will be incremented (fax1-0, fax1-1, fax1-2, etc.)

until the maximum number of files are reached.

If the debug option is turned on, the debug log files continue to expand until the scheduler is restarted.

Archiving faxes and maintaining user's inboxes

If you are using VSI-FAX to receive and route inbound faxes, each client user will have an inbox identified by their

user name or user ID. All faxes received for a particular user will be routed to that user's inbox, located in the

$VSIFAX/faxq/<user ID> directory. Every user can save, copy, or delete faxes from their inbox. Faxes that are

not routed to individual inboxes are routed to the inbox of user vsifax.

To maintain manageable levels of faxes in user inboxes, the VSI-FAX administrator should set up a monthly

maintenance cycle or script that checks each user's directory, including user vsifax, and deletes any files older than

a specified date.

Scheduling periodic fax server maintenance

VSI-FAX provides a mechanism for automatically scheduling periodic fax server maintenance (e.g., database

rebuilds, log file purges, etc.). Each periodic event is scripted via an entry in $VSIFAX/lib/crontab.lst.

This scripting mechanism is based on the Unix cron function and employs syntax similar to that used in crontab.lst.