Handbook:Basic Server Configuration:Faxaddmodem

Modems are configured for use with the faxaddmodem script. This is an interactive script that walks you through the configuration and installation of a new or existing modem. Even if you have a previous version of HylaFAX or FlexFAX installed it is a good idea to run faxaddmodem to update the configuration information for your modems after installing a new distribution.

faxaddmodem may be run directly from the command line or via the faxsetup script that is used to prepare a server machine for use with HylaFAX.

It would be nice to have a properly formatted walk-through with examples and explanation of each question here - DPN.

[picked this up somewhere on the web. others can add to this....]

Enter faxaddmodem on the commandprompt and press Enter and you'll see a lot of text fly by.

Answer Yes to adding a FaxMaster alias.

For a user to received fax-related mail enter the user account you created for yourself during the Debian installation.

Four configuration parameters will be listed and you'll be prompted as to their correctness. Press Enter to accept these values.

You'll then be asked if you want to run faxaddmodem to set up the software to use the modem. Press Enter to accept the default Yes response.

Enter the correct ttyS designation for the serial port your fax-modem is connected to (ttyS0 is for COM1). You'll be prompted for quite a few values. For most you can accept the default values by pressing Enter. The values you'll want to enter are:
 * Country code (1 for US)
 * Area code
 * Phone number of fax modem
 * Local identification string (this should be something like 'My Fax Server' as it is printed on the tag line of outgoing faxes)
 * Long distance dialing prefix (1 in US)
 * International dialing prefix (011 in US)
 * Dial string rules file (accept the default)
 * Tracing during normal server operation (accept the default)
 * Tracing during send and receive operations (accept the default)
 * Protection mode for received fax - enter 0644
 * Protection mode for session logs - enter 0644
 * Protection mode for ttySx - enter 0666
 * Rings to wait before answer Note: The default is 1 but setting it to 0 establishes your server as a "Send Only" fax system
 * Modem speaker volume (valid values are OFF QUIET LOW MEDIUM HIGH (you may want to set it to HIGH for testing purposes as you can change it to OFF later)
 * Command line argumente (accept the default)
 * Pathname of Caller-ID ACL file (accept the default)
 * Tag line font file (accept the default)
 * Tag line format string (accept the default)
 * Time before purging UUCP lock (accept the default)
 * Hold UUCP lockfile during data calls (accept the default)
 * Hold UUCP lockfile during voice calls (accept the default)
 * Percent good lines to accept (accept the default)
 * Max consecutive bad lines to accept (you may want to reduce the default 5 to 3)
 * Max number of pages to accept in a received fax (you may want to increase the default value of 25)
 * Syslog facility name for ServerTracing messages (the default is daemon but you could change it to local7 if you're logging to a remote syslog server)
 * Set UID to 0 (accept default)
 * Use priority job scheduling (accept default)

You'll then be asked to confirm the values that you entered and then the utility will query to modem to determine the fax classes that it supports. Even if your modem supports both Class 1 and Class 2 you should set it to Class 1 for compatibility with all fax machines. You will then be asked for values specific to the modem. Just press Enter to accept the default values as they are a result of the modem query and the class you selected.

You'll then be prompted to confirm these values by pressing Enter. The non-default scheduler values will then be displayed with a confirmation prompt. The Area Code may not be correct. If so, answer No and correct any erroneous values. You may also want to increase the time value for "Timeout when converting PostScript documents" if you fax long documents but you can just press Enter to accept the default values for the rest of the values.

Answer No when asked if you want to configure another modem.

Accept the default Yes answer to run faxmodem on your newly configured modem to verify settings.

You'll then be returned to the shell prompt.

If you want to manually edit the file that contains these settings do so with the command:

vi /etc/hylafax/config.ttyS0 

You have to run the faxaddmodem utility to create this file first though.