|
|
Automation script to reduce the installation time
|
|
FAXSETUP(8) System Manager's Manual FAXSETUP(8) NAME
faxsetup - setup a machine for use with HylaFAX SYNOPSIS
/usr/sbin/faxsetup [ -client ] [ -server ] [ -with-VAR[=value] ] DESCRIPTION
faxsetup is an interactive shell script that does the necessary setup work to configure a client or server machine for the HylaFAX soft- ware. faxsetup must be run on every HylaFAX server machine before the software will function-if a HylaFAX server program or script is invoked before faxsetup is run, the command will abort with a message that says to run faxsetup. faxsetup may optionally be run on a HylaFAX client machine to verify the configuration of the software. By default faxsetup checks a machine for use both as a HylaFAX client and server. Client-specific checks include: o the installation of client programs and data, o the installation of the Adobe Font Metric (AFM) information files used by the HylaFAX text formatting support. Server-specific checks include: o the installation of server programs and data, o the existence of the UUCP lock file directory, o the installation of the TIFF software tools, o the configuration of the getty programs invoked for data and voice calls, o the pathnames for various system programs used by server shell scripts, o proper support for FIFO special files, o proper installation of a POSTSCRIPT RIP, o definition of a ``fax'' user, o definitions for the ``hylafax'' and ``snpp'' services, o startup of the HylaFAX server processes: faxq(8) and hfaxd(8), o definition of a ``FaxMaster'' mail alias for reporting server problems. For server machines faxsetup also creates two files that are required by the HylaFAX command scripts. One file contains master configura- tion parameters and the other contains various definitions used by scripts such as faxaddmodem(8) that communicate with modems. OPTIONS
-client Do client-specific consistency checks. -server Do server-specific consistency checks. -with-VAR[=value] Override the default definition for the configuration parameter named VAR; optionally specifying a new value (if no value is specified then ``yes'' is used). This option is especially useful to override the default settings for the POSTSCRIPT inter- preter package to use (e.g. ``-with-PS=dps''), the spooling directory (``-with-DIR_SPOOL=/mumble''), the directory where the tool applications of TIFF software distribution are located (``-with-TIFFBIN=/usr/freeware''), etc. A complete list of the possible parameters can be found by looking at the contents of the faxsetup shell script; many of these configuration parameters are also described in the online documentation -help Print a help message and terminate. -quiet Do not print verbose messages to the terminal. -verbose Print informative messages to the terminal (default). BUGS
faxsetup does not query a modem to find out its capabilities when invoking the faxmodem program to setup a server in a send-only configura- tion; it may be necessary to run faxmodem manually. FILES
/var/spool/hylafax/etc/setup.cache master configuration parameters /var/spool/hylafax/etc/setup.modem modem-related configuration support Consult hylafax-server(5) for a complete discussion of the structure and content of the spooling area. SEE ALSO
hylafax-server(5), hylafax-config(5), faxq(8), faxgetty(8), faxmodem(8), faxconfig(8), faxsend(8) August 26, 1996 FAXSETUP(8)
