Technical information

INSTALLATION AND ADMINISTRATION GUIDE
140
Sample scripts for maintaining databases and files
Scripts can be used nightly, weekly, or once per month depending on the number of faxes being sent and received by
your fax server. These scripts are intended for use on Unix servers or with the MKS Toolkit.
Tip
If you are running VSI-FAX on a Windows server without the MKS Toolkit, the scripts can be modified to run
correctly by changing each $VSIFAX to %VSIFAX%.
Important
These scripts are examples. They must be modified according to your specific configuration and needs.
Nightly purge script
#!/bin/sh
# This example script purges all three logs,
# It retains any information that is 7 days old or less
. /etc/vsifax.sh
vfxpurge -o7
Weekly or monthly purge/rebuild script
#!/bin/sh
. /etc/vsifax.sh
# Stop the scheduler
vfxsched stop
# Purge the data older than 7 days from the database
vfxpurge -o7
# Rebuild the databases
vfxdb -vf ologatt ologreg ologgrp ologtag ologofn
or
vdbtool rebuild -vf ologatt ologreg ologgrp ologtag ologofn
# Restart the Scheduler
vfxsched start
Maintaining VSI-FAX directories
The fax server uses directories to store inbound and outbound faxes and temporary files. Over time, faxes left in
these directories will eventually consume excessive amounts of space.
Therefore, we recommend that you check the following directories on a regular basis:
When the scheduler is idle (no jobs pending), the $VSIFAX/spool/in directory should be empty. If TIFF
files are found in this directory, a problem occurred while routing an inbound fax to a specified inbox and
caused the fax to remain in the in folder. Use vfxstat to determine if the scheduler is idle, then remove any
files in the directory.
VSI-FAX uses a temporary directory for various operations, such as storage of pending TIFF files. The
directory should be empty when the scheduler is idle. If this directory is not empty, use vfxstat to determine
if the scheduler is idle, then remove any files in the directory. The location of this directory depends on the
operating system of your VSI-FAX server:
• On Windows platforms, the temporary directory used by VSI-FAX is $VSIFAX/spool/temp. If this
directory does not exist on the server, the $TMP directory will be used instead.
• On UNIX platforms, the temporary directory used by VSI-FAX is /tmp. You can override this setting
and select another directory by setting a value for the $VSITEMP environment variable.