Personal tools
HylaFAX The world's most advanced open source fax server

Difference between revisions of "Handbook:Basic Server Configuration:Faxaddmodem"

(added editing config.ttyS0)
(minor format edits)
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
Modems are configured for use with the <tt>faxaddmodem script</tt>. 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.
+
Modems are configured for use with the <tt>faxaddmodem script</tt>. 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 <b>faxaddmodem</b> 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.
+
<b>faxaddmodem</b> 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.''
 
''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.
+
[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.  
+
Enter <b>faxaddmodem</b> on the commandprompt and press <b>Enter</b> and you'll see a lot of text fly by.  
  
Answer Yes to adding a FaxMaster alias.  
+
Answer <b>Yes</b> 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.  
 
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.  
 
Four configuration parameters will be listed and you'll be prompted as to their correctness.  
Press Enter to accept these values.  
+
Press <b>Enter</b> to accept these values.  
  
 
You'll then be asked if you want to run faxaddmodem to set up the software to use the modem.  
 
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.  
+
Press <b>Enter</b> to accept the default <b>Yes</b> response.  
  
Enter the correct ttyS designation for the serial port your fax-modem is connected to (ttyS0 is for COM1).  
+
Enter the correct <b>ttyS</b> 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.  
+
You'll be prompted for quite a few values. For most you can accept the default values by pressing <b>Enter</b>.  
 
The values you'll want to enter are:  
 
The values you'll want to enter are:  
 
* Country code (1 for US)  
 
* Country code (1 for US)  
Line 31: Line 31:
 
* Tracing during normal server operation (accept the default)  
 
* Tracing during normal server operation (accept the default)  
 
* Tracing during send and receive operations (accept the default)  
 
* Tracing during send and receive operations (accept the default)  
* Protection mode for received fax - enter 0644  
+
* Protection mode for received fax - enter <b>0644</b>
* Protection mode for session logs - enter 0644  
+
* Protection mode for session logs - enter <b>0644</b>
* Protection mode for ttySx - enter 0666  
+
* Protection mode for ttySx - enter <b>0666</b>
* Rings to wait before answer Note: The default is 1 but setting it to 0 establishes your server as a "Send Only" fax system  
+
* Rings to wait before answer Note: The default is <b>1</b> but setting it to <b>0</b> 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)  
+
* Modem speaker volume (valid values are <b>OFF QUIET LOW MEDIUM HIGH</b> (you may want to set it to <b>HIGH</b> for testing purposes as you can change it to <b>OFF</b> later)  
* Command line arguments for getty (accept the default)
+
* Command line argumente (accept the default)  
* Pathname of TSI ACL file (accept the default)  
 
 
* Pathname of Caller-ID ACL file (accept the default)  
 
* Pathname of Caller-ID ACL file (accept the default)  
 
* Tag line font file (accept the default)  
 
* Tag line font file (accept the default)  
Line 45: Line 44:
 
* Hold UUCP lockfile during voice calls (accept the default)  
 
* Hold UUCP lockfile during voice calls (accept the default)  
 
* Percent good lines to accept (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 consecutive bad lines to accept (you may want to reduce the default <b>5</b> to <b>3</b>)  
* Max number of pages to accept in a received fax (you may want to increase the default value of 25)  
+
* Max number of pages to accept in a received fax (you may want to increase the default value of <b>25</b>)  
* 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)  
+
* Syslog facility name for ServerTracing messages (the default is <b>daemon</b> but you could change it to <b>local7</b> if you're logging to a remote syslog server)  
 
* Set UID to 0 (accept default)  
 
* Set UID to 0 (accept default)  
 
* Use priority job scheduling (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.  
 
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.  
+
Even if your modem supports both Class 1 and Class 2 you should set it to <b>Class 1</b> 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 will then be asked for values specific to the modem. Just press <b>Enter</b> 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.  
+
You'll then be prompted to confirm these values by pressing <b>Enter</b>.  
 
The non-default scheduler values will then be displayed with a confirmation prompt.  
 
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.  
+
The Area Code may not be correct. If so, answer <b>No</b> 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.  
+
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 <b>Enter</b> to accept the default values for the rest of the values.  
  
Answer No when asked if you want to configure another modem.  
+
Answer <b>No</b> 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.  
+
Accept the default <b>Yes</b> answer to run faxmodem on your newly configured modem to verify settings.  
  
 
You'll then be returned to the shell prompt.  
 
You'll then be returned to the shell prompt.  
Line 68: Line 67:
 
If you want to manually edit the file that contains these settings do so with the command:
 
If you want to manually edit the file that contains these settings do so with the command:
  
 
+
<b>vi /etc/hylafax/config.ttyS0 </b>
vi /etc/hylafax/config.ttyS0
 
  
 
You have to run the faxaddmodem utility to create this file first though.
 
You have to run the faxaddmodem utility to create this file first though.

Latest revision as of 03:27, 7 April 2009

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.


This page was last edited on 7 April 2009, at 03:27.

Powered by MediaWiki
Attribution-ShareAlike 2.5

Project hosted by iFAX Solutions