UxFax2 Unix Fax Server
Version 3.x
Installation Manual
Table of Contents
INTRODUCTION
These notes cover the topics necessary for
successful installation and initial configuration of UxFax2:
- Software Installation
- Minimum Configuration
- Connecting Modems to the Computer
- Sending a fax
Before You Start the Installation
or Update
Before starting with the installation you
should complete the UxFax2 Installation Worksheet. The details entered
on this work sheet will be required during the installation procedure.
An explanation of the details required on this form can be found on
the back of the Worksheet.
If you have an existing
Copy of the Software Installed
If you have an existing copy of the software
installed use the same installation procedure as for a new installation.
The installation procedure will detect this, and only update the required
files.
There are several parts of the installation procedure which can be
by-passed and these are noted and highlighted.
Also refer to Appendix A - Installation Notes - Loading over a Previous
Installation. This appendix details where copies of existing files are
saved in case you have modified any to suit your site. Note that unless
you are a system integrator it is unlikely that you would have modified
any files and the installation of the latest release will simply update
your existing installation.
Additional
Information
More comprehensive information is contained
in the Installation Appendixes located towards the end of these instructions.
These are:
- Appendix A - Installation Notes - Loading over a Previous Installation.
- Appendix B - Installation Notes - Connecting Modems to the Computer
- Appendix C - Common Site Configuration Tasks
- Appendix D - Stopping & Starting the Fax Spooler
Common
Errors Encountered
Appendix F deals with the most common problems
encountered during the installation and operation of UxFax2.
Conventions Used in these
Instructions
A couple of points to note regarding conventions
used in this document:
- References back to the UxFax2 Installation Worksheet are highlighted
with a reference number eg (1).
- If you are installing over an existing installation, procedures
which may be bypassed are highlighted with a note using the following
symbol. Updaing?
- Important notes regarding aspects of the installation are highlighted
using the following symbol. Note:
- Output that will appear on the screen is printed in courier
font.
Example:
This is output on the terminal
|
- All prompts on the
screen show the default response. This is shown in braces '[]'. To accept
the default value you can simply press the [Enter]
key, or you can enter an alternate value and then press the [Enter]
key.
Example:
Enter the installation (Utools)
directory path [/usr]:
|
By pressing the the [Enter]
key you will be accepting
the default value /usr. Alternatively you may type in a
different value and press [Enter].
SOFTWARE INSTALLATION
Introduction
All Integration Design software products
reside within a single sub-directory called Utools. Additionally, UxFax2
will create a sub-directory within the standard spooling area (/usr/spool).
You can specify the location of these two directories as part of the
installation procedure.
The software is installed by using the unix tar command to extract
files from the media into the tmp sub-directory of the filesystem that
will contain the Utools sub-directory. For example, if the software is
to be loaded into the /usr2 filesystem, you should cd into the the /usr2/tmp
directory, i.e.;
cd
/usr2
If the filesystem does not have a tmp sub-directory, it should be
created, e.g.;
mkdir
tmp
If the files are extracted into the root /tmp directory, the installation
will assume that the software is to be loaded into the /usr filesystem,
ie. /usr/Utools will be created.
The installation script will also add the following lines to /etc/profile
and /etc/cshrc if they do not already exist. i.e. If other Integration
Design products have not already been installed. This is the only modification
made to any files external to the Utools directory. Note that the actual
value of Utools will be entered during the installation session.
Note:
Utools is the second parameter on the UxFax2 Installation Worksheet.
|
In /etc/profile the following lines will be added:
Utools=/usr
PATH=$PATH:$Utools/Utools/bin
export Utools PATH
In /etc/cshrc the following lines will be added:
setenv Utools /usr
set path=($path $Utools/Utools/bin)
Extract All Files from
the Distribution Archive
To begin installing UxFax2, the installation
file-set must be extracted from the distribution media. The install script
is then run which will create directories, move the files and set the file
permissions and ownerships.
Note:
The example commands listed below are based on the software being loaded
into the /usr filesystem:
If you are loading from floppy disk then you will need to repeat the
tar command below for each disk.
(1) <media_device>
is the first parameter on the UxFax2 Installation Worksheet.
|
Login to the system as root user then:
cd /usr/tmp [Enter]
tar xvf <media_device> [Enter]
Run the Installation Script
Now that the software has been loaded
onto the system it is necessary to run the installation script.
Following is the output from a typical installation session. The script
asks a series of questions, and presents a default response in each case.
To execute the installation script, enter the following command:
./install
[Enter]
First you will be provided with a prompt asking under which directory
you want the Utools directory structure installed. Press [Enter] to accept
the default of /usr or enter the name of an alternative directory and
then press[Enter].
Note:
Utools is the second parameter on the UxFax2 Installation Worksheet.
|
If you already have other Integration Design products installed, the
$Utools variable will be set accordingly. This variable identifies the root
directory for the binary and library files, and is the first parameter asked
at installation. If this is correct, you may simply press [Enter].
Integration Design Software Installation
========================================
Enter the installation
(Utools) directory path [/usr]:
|
Next you will be prompted for the software package name before proceeding
with file installation. At this prompt, you should also press [Enter]
if you wish to proceed with the installation.
The following product(s) will be installed
under /usr
UxFax2 Unix Fax Server
Software
Is this correct? [y]:
|
The installation will now proceed to move all of the files extracted
from the distribution media into the correct places, whilst also setting
correct ownership and permissions, and creating any required directories.
Installation is now in progress, please
wait
============================================
Creating file list....................
Checking directories..................
Installing text files.................
Installing binary files...............
Checking /etc/profile
and /etc/cshrc..
Executing UxFax2_install_exec.........
|
Product Specific Software
Installation
Next you will be asked to confirm (or
nominate) the various sub-directories within the Utools directory where
the software components will reside. You can either type in your prefered
values and press [Enter], or simply press [Enter] to accept the default value.
Note:
Utools is the second parameter and the Spool directory is the third parameter
on the UxFax2 Installation Worksheet.
|
Starting installation of UxFax2
===============================
Please confirm the following
directories
========================================
Utools directory [/usr]:
Binary directory [/usr/Utools/bin]:
Library directory [/usr/Utools/lib]:
Font directory [/usr/Utools/font]:
Spool directory [/usr/spool/UxFax]:
|
You will then be asked to confirm each of the above nominated directories.
At this point you should press [Enter] to accept all the settings.
The following directories have been nominated:
Utools directory : /usr
Binary directory : /usr/Utools/bin
Library directory : /usr/Utools/lib
Font directory : /usr/Utools/font
Spool directory : /usr/spool/UxFax
Please confirm that these
are correct [y]:
|
The installation program will now proceed to install the application
specific files and create the fax spooling directory.
Installing proportional
font files, please wait
===============================================
Creating file list..................
Checking directories................
Installing font files...............
Checking the spool directory, please wait
=========================================
Creating file list....................
Checking spool directory..............
Checking directories..................
Installing config files...............
|
Install Evaluation License Key
Updating? If you are updating an existing
installation you can bypass this step by pressing [N]+[Enter] at this prompt.
You will now be asked whether you wish to install the supplied evaluation
key. These keys may be be entered at a later stage if you choose to skip
this step (by entering the command faxcmd license). Otherwise press [Enter]
and the installation will invoke UxFax2's licensing screen.
INSTALL FAX SOFTWARE EVALUATION KEY
===================================
Do you wish to install
the UxFax2 evaluation key now
[y]:
|
The licensing screen will appear with the following message displayed
within the main window of the screen:
UxFax warning [4]: Program
has not been licensed
0 product(s) installed on system/node IDmel/IDmel
|
Note:
The evaluation key is the fourth parameter on the UxFax2 Installation
Worksheet.
|
To enter a evaluation key, follow these steps:
- Press function key [F2]
or press [Esc+2].
- Enter the supplied evaluation key, using [Tab]
to move between fields. (4).
- When the key is entered, press [F1]
or [Esc+1].
- You will be prompted to confirm key installation.
- Press [Y]
to proceed, or [N]
to return to the key entry screen.
- Press function key [F4]
or press [Esc+4]
to exit the licensing screen.
Add Fax Server Call to Unix
Startup Scripts
It is possible to set-up your computer
so that the fax spooler is automatically restarted whenever the computer
is re-booted. To achieve this the following command should to be added to
the approprite "rc" script.
Utools=/usr
PATH=$PATH:$Utools/Utools/bin
export Utools PATH
$Utools/Utools/bin/faxcmd exec
SystemBootRC
On most systems this command would be added to the /etc/rc file. On
SCO Unix, this command will be added to the /etc/rc.d/8/userdef file.
Note:
If you are not loading UxFax2 on a SCO Unix or other AT&T Intel Unix
system you will automatically by-pass this step. In that case you must manually
edit the system rc scripts as shown above.
|
The Utools path in the above command must be set as per parameter
2 on the UxFax2 Installation Worksheet.
Updating?
If you are updating an existing installation you will automatically bypass
this step.
|
This prompt will ask if you want the fax server to be started when the
system boots;
AUTO START FAX SERVER ON
SYSTEM BOOT
=====================================
Do you want the fax server to automatically start on reboot [y]
|
- Press [Enter]
to add the appropriate commands to the boot scripts.
- Press [N]
then press [Enter]
to bypass this step and not add any commands to the boot scripts.
Enter the Minimum Configuration Information
Updating?
If you are updating an existing installation you can bypass this step
by pressing [N]+[Enter]
at this prompt.
|
It is now necessary to enter the miniumum configuration information.
This is the data that you will have filled out on the UxFax2 Installation
Worksheet which was mentioned in the introduction. (5,6,7,8,9).
This prompt will ask if you want to enter the Minimum Configuration
information. Press [Enter]
to proceed with the configuration.
MINIMUM CONFIGURATION INFORMATION
=================================
You will require the UxFax2 Installation Worksheet
Do you want to enter the minimum configuration information now [y]?
|
After replying 'y' to the last prompt, the installation will start
the fax server and invoke the minimum configuration menu. the following
messages will appear before the configuration menu is invoked;
Stating the fax server now..........................
Faxcmd: Request 'echo' sent Wed Feb 16 18:39:14 1999
Server: Command CMD_ECHO rcv'd from root@IDmel
The fax server is running
Standby for configuration menu...................... |
- Complete all of the fields on the screen and when complete press
[F1]
to apply the data.
- The screen will clear, while the installation restarts the fax
server to apply the configuration changes. The following messages will appear;
Shutting down the fax server..............
Faxcmd: Request 'shutdown' sent Wed Feb 16 18:39:16 1999
Server: Command CMD_SHUTDOWN rcv'd from root@IDMel
Shutting down the fax server
Restarting the fax server now.............
Faxcmd: request 'echo' sent Wed Feb 16 18:42:16 1999
Server: Command CMD_ECHO rcv'd from root@IDMel
The fax server is running
|
Software
Installation Complete
The software installation is now complete
and the following message will be displayed:
SOFTWARE INSTALLATION IS
NOW COMPLETE
=====================================
Examine the 'errlog' for any errors that
may have occured during installation. |
- Because changes have been made to the /etc/profile and /etc/cshrc
files which alter your environment, you must log out and login again to
correctly set yourenvironment before attempting to send a fax.
- All installation activity and messages were recorded in an error
log file. If any errors occured during the installation this file may be
reviewed to determine the reason for the failure. This file will be located
in the tmp directory into which you extracted the software initially. eg.
if you extracted the files in /usr/tmp the the error log file would be /usr/tmp/errlog.
Updating?
If you are updating an existing installation you have completed the task.
Any modified files will be saved in a sub-directory within Utools.
These files will also be recorded in the error log file.
Refer to "Appendix A - Installation Notes - Loading over a Previous
Installation".
|
Connecting Modems to the Computer
Finally it is necessary to connect your fax modem to the computer.
You will require the following to connect the fax modem;
- A "Class 2" compliant modem.
- A modem cable,
- Details on which physical port on the computer to connect to.
This will be the same port which is referred to by the Unix device file,
eg /dev/tty1a.
Note:
Refer to "Appendix B - Installation Notes - Connecting Modems to the Computer"
for more information.
|
Installation should be as simple as connecting the modem to the correct
computer port, and applying power to the modem.
The correct operation of the spooler can be confirmed using the following
command steps;
faxcmd
status [Enter]
The following message should be displayed;
Faxcmd: Request 'status'
sent Mon Jan 29 10:30:44 1994
Server: Command CMD_STATUS rcv'd from root@IDmel
Modem status - modem1 is waiting |
Refer to Appendix E - Common Problems if the spooler status display
does not indicate that the modem is waiting.
Note:
At this point you have completed the installation and minimum configuration
of the UxFax2 software. You may wish to test the spooler by sending a fax.
If so then the next section deals with this subject.
|
For more information about configuring the spooler refer to Appendix
C - Common Site Configuration Tasks
Sending a Fax
With the fax spooler running, you can
now attempt to send a fax. Enter the following command to access the main
menu of the fax spooler.
faxcmd
menu [Enter]
- From the main menu, select [C]
for "Create and Send".
- Select [3]
to create and send a document.
- Select "Manual Dial".
You will now be prompted to enter a document
name. You may enter your own document name, or use the following procedure
to send one of the sample files supplied with UxFax2;
- Press [F5]
to call the directory display.
- Press [F6]
to move the cursor into the "Directory" window. Use the cursor keys and
[Enter] to change directory to:
$Utools/Utools/fax/demo
- Press [F7]
to move the cursor into the "File" window.
- Select file demo.vi and press [Enter]
You will now be in the "Facsimile Control Panel" screen. This screen
allows you to modify the transmission request details. To dial a fax number
and send the fax, do the following:
- Press [F]
for file and [T]
for type to set the file type.
- Select Ascii from the list of supported file types.
- Type in the phone number that the fax is to be sent to using the
number keypad on your terminal.
- Press [D]
to delete improperly entered numbers.
- Press [S]
for send and [Y]
to send the request.
You will now be presented with the 'Command History' screen which
should display a message similar to the following:
Faxcmd: Request 'send' sent
Thu Jun 10 14:41:55 1999
Server: Command CMD_ENQUEUE rcv'd from user@IDmel
Request 0001 queued |
Press [F4]
to return to the main menu, where you can view the progress of the request
in the Queue window.
Adding a
License
Both the receive and send capabilities
of UxFax2 are separately licensed.
Entering
an Evaluation Key
The evaluation key is a 16 digit (4x4 digit) hexadecimal number. To
enter an evaluation key perform the following steps;
- Call the license screen using the command, faxcmdlicense.
- Press function key [F2]
or press [Esc]+[2].
- Enter the supplied evaluation key, using [Tab] to move between
fields.
- When the key is entered, press [F1]
or[Esc]+[1].
- You will be prompted to confirm key installation.
- Press [Y]
to proceed, or [N]
to return to the key entry screen.
- Press function key [F4]
or press [Esc]+[4]
to exit the licensing screen.
Entering
a License Key
A license key consist of a 4 part hexadecimal activation key, a 4
part serial number plus site name. The procedure to install a license is
similar to the above procedure for entering an evaluation key, except for
steps 2 & 3;
- Call the license screen using the command, faxcmdlicense.
- Press function key [F1] (or press [Esc]+[1]) instead of [F2] to
invoke the license key entry screen.
- Within this screen you will enter;
- the activation key.
- the serial number
- the site name
- When the key is entered, press [F1]
or[Esc]+[1].
- You will be prompted to confirm key installation.
- Press [Y]
to proceed, or [N]
to return to the key entry screen.
- Press function key [F4]
or press [Esc]+[4]
to exit the licensing screen.
Appendix A - Loading
over a Previous Installation.
If you are loading over a previous installation,
the existing installation will be saved and can be restored in part or full.
Saved
Directory Location
When an existing installation is detected
a directory will be created within the Utools directory. A directory will
be created called saved.yymmdd, e.g.;
/usr/Utools/saved.940219
Saved
Directory Structure
Any files replaced during installation will
be saved with their full path under the saved directory, e.g.;
/usr/Utools/bin/faxcmd
Will be saved as
/usr/Utools/saved.yymmdd/usr/Utools/bin/faxcmd
Restoring Files
Files may be individually copied back from
the saved directory. But if you wish to restore all files changed during
installation, you can execute the "restore" script which is also written into
the saved directory. e.g.;
cd $Utools/Utools/saved.yymmdd
./restore
Appendix B - Connecting
Modems to the Computer
UxFax2 supports "Class 2" compliant modems.
Unfortunately , Class 2 is not a certified international standard, but simply
a draft standard adopted by the industry. As a consequence, no two manufacturers
fax modems are identical. In addition, the terminal interface (RS232) on
Unix systems will vary from machine to machine and vendor to vendor.
As a result, simply connecting a modem will not necessarily work in the
first instance. What follows is a brief explanation of the concepts that
need to be considered when connecting a modem to a computer.
RTS/CTS vs. XON/XOFF Flow Control.
Modem Most Class 2 fax modems use CTS/RTS
for flow control. But several modems will use Xon/Xoff by default instead.
On most modems where flow control can be selected, it will be controlled
by the hayes-set command AT&K. Refer to your modem manual to determine
its flow control method.
Computer If you are using a modem that only supports RTS/CTS flow control,
it must be connected to a port on the computer which also allows RTS/CTS
flow control. Not all computers support RTS/CTS flow control, but all Unix
systems will support Xon/Xoff flow control.
RS232 Wiring.
There is a common myth that no two RS232
connectors are the same. For the purposes of this discussion, this is not
true. There are two fundamental types, they are DCE and DTE. i.e.
- DCE Data Communications Equipment. This is the modem.
- DTE Data Terminal Equipment. A terminal or computer.
When connecting a DTE to a DTE (terminal
to computer) a "crossed" cable is used. This is otherwise known as a "null
modem" cable. When connecting a DTE to a DCE (modem to computer) a"'straight
thru" cable is used. This is the sort of cable that will be required to connect
a fax modem to the computer.
This will always be the case with 'Intel' based computers (PCs). The
only time this is not true, is on some proprietry systems where the terminal
interfaces are wired as DCEs (for direct connection to terminals). But this
is quickly determined with an RS232 tester, and in such cases, the computer
vendor should be able to supply a standard modem cable.
Modem
vs Non-Modem Control.
There is a concept in Unix relating to 'modem
control' ports. These are ports that rely upon the 'Carrier Detect' or some
other signal to be asserted before the port can be opened. These ports are
typically used for in-dial modems.
UxFax2 does not, and must not, use modem control ports. Instead you must
use the non-modem control port. These will be the same physical port, but
will use different devices nodes in the /dev directory.
AT&T SVR3.2 386/486 - SCO Unix
On Intel based systems, the general rules
for connecting a fax modem are:
- Most modems use RTS/CTS flow control, but check.
- Most terminal adaptors support CTS/RTS flow control, but check.
- Use a "straight thru" RS232 cable (pin to pin on 2,3,4,5,6,7,8,
and 20).
- Use a port with the non-modem control device node.
HP9000/700
- HP-UX V8
HP-UX as delivered will have the following
device nodes:
Device Major Minor
/dev/tty00 1 0x204004
/dev/tty01 1 0x205004
To use fax modems, these ports may need to be configured with RTS/CTS
flow control. This is determined by bit 3 of the minor number, which is not
set in the above device nodes. To create the correct nodes, use the following
command:
mknod /dev/tty00m
c 1 0x20400c
mknod /dev/tty01m c 1 0x20500c
These new device nodes should be named as the fax modem device within
UxFax2.
IBM/RS6000 -
AIX
To enable RTS/CTS flow on the fax modem port,
the following command needs to be executed:
stty add rts <
[device_name]
Note that this command only needs to be executed once after boot-up,
and so it should be added to the init script /etc/rc before the call to
faxcmd. (Refer to "SOFTWARE INSTALLATION").
Supported Modems
The following is a brief list of the supported
modems, and the dialer prefix that should be applied in the modem entry screen.
- Default ATDT
- Netcomm Smartmodem AT&K9DT
- Netcomm Automodem AT&K4DT
- Dataplex DPX223/225 ATDT
- Multitech 1432 BA ATDT
- Bausch 9642 AT&C0&D0&K3DT
- Everex 2496 AT\X1\T2\K0!C0&S0&C0&D2\Q3&W0&Y0DT
Appendix C - Common
Site Configuration Tasks
As part of the initial installation a
minimum configuration was established and set-up. To further refine the
configuration to suit your site there are several aspects of the spoolers
configuration which you may want to explore further. These are dealt with
in the manuals, this Appendix serves to summarise the most commonly modified
parameters.
To invoke the menu interface, log in as 'root' and enter the following
command:
faxcmd
menu [Enter]
Detailed on the following pages are these aspects of the spooler configuration:
Define
the Available Printers
Printers are identified by name, and the
defined printers are maintained in a data base which associates a spooler
command and printer driver with the printer name. As a minimum, at least
ne printer should be defined. The procedure to do this is:
- From the main menu select the "Data Bases".
- In the "Data Bases" menu select "More ...".
- In the "Data Bases" sub-menu select "Printers".
- In the "Printers" screen press [F5]
to add a printer.
You will now be presented with the following
screen:
┌────────────────────────────────────────────────────────────────┐
│ Printer Device Entry
│
│
│
│ Printer : laser
│
│ Command :[lp -s -og -dlaser___________________________]
│
│ Driver +[LjetIII LaserJet3
(or compatible)_________] │
│ Resolution +[300 x 300 - LaserJet resolution_____________]
│
│ Paper Size +[8.26 x 11.69 - A4___________________________]
│
│ ────────────────────────────────────────────────────────────── │
│ F1 Save F2 Redraw F4 Quit
F5 (+)Options
│
└────────────────────────────────────────────────────────────────┘ |
The first two fields must have data manually entered. The "Driver"
field may be altered by using the [F5] key or space bar.
- Printer is a short
name for the printer.
- Command is the printer
spooler command. This command should include the options to send a print
job unmodified (raw mode) to the printer. In the above example "-og" sets
raw mode, "-s" suppresses the banner and "-dlaser" sets the destination.
- Driver is selected
from the list of printer drivers currently supported by the spooler. Press
[F5] to obtain a list of available printer drivers.
- Resolution is selected
from the list of printer resolutions currently supported by the spooler.
Press [F5] to choose from a list.
- Paper Size is selected
from the list of paper sizes currently supported by the spooler. Press [F5]
to choose either A4, Letter or continuous form.
When all details have been
entered, press [F1] to save them. You will now be back at the "Printer Devices"
screen. To return to the main menu, press [F4].
Note:
As part of the minimum configuration, the following printer definition
must exist. This printer driver is used for direct output to the screen:
|
- Printer : stdout
- Command : more
- Driver : stdout
- Resolution : 300 x 300
- Paper Size : unlimited
Setting User Preferences
User details are specified to define defaults
associated with the use of the fax spooler, both interactively via the menu
interface and for notification by the spooler back to the user.
The default user preferences define a users setup if they have no entry
in the user database. The user preferences define the editor that will be
used create faxes and the printer to be used to print then on, plus other
details.
On selecting this menu a summary menu is displayed. This lists in blocks
of 8 users the user alias, their group, and their full name and title as
extracted from the Name and Address database.
- From the main menu select the "Data Bases".
- In the "Data Bases" menu select "User Details".
- In the "User Preferences" screen press [F5] to add a user.
You will now be presented with the following
screen:
┌────────────────────┐┌────────────────────┐┌────────────────────┐
│ F6 User Identity ││ F7 Options
││ F8 Preferences │
│
└───────────────────────────────────────────┐
│
uid:68 │
│
User ID : default
│
│
Group ID #[other___]
│
│
Printer #[default________]
│
│ Email domain :[__________________________]
│
│
│
│ First name
:[________________________]
│
│ Last
name :[________________________]
│
│
│
│ ────────────────────────────────────────────────────────────── │
│ F1 Save F2 Redraw F3 (+#)Clear F4 Quit
F5 (+#)Options │
└────────────────────────────────────────────────────────────────┘ |
Note that each of the fields preceded by a '+' symbol may be altered by
pressing [F5] to select from a list of options, and fields preceded by a
'#' or '+' can be cleared using [F3].
This is a multi-page screen. More parameters can be accessed by pressing
[F6], [F7] or [F8] to access each screen. When all details have been entered,
press [F1] to save them.
To return to the main menu, press [F4].
Entries that can be made to specify a User entry are:
- User ID The user
ID is an alias, typically it is the login ID.
- Email Domain Is the
full domain name component of the users
- Email address.
This, along with the user name will compose the users Email address. e.g.;
- user@abc.xyz.co.au
- where; User ID = user
- Email Domain = abc.xyz.co.au
- Group ID The group
ID is the alias used when defining user groups. Press the [F5] key to display
and select from a list of defined groups.
- Printer This is the
name of a defined printer which will be the destination for all confirmation
and hardcopy printouts requested by this user. Press the [F5] key to display
and select from the list of defined printers.
- User Type This is
a definition of the user type and defines the users privileges. Press the
[F5] key to display and select from a list of defined types. The available
types of users are;
- Fax user only - allows a user to operate the fax spooler and modify
their own fax requests.
- Group Leader - Allows a user to operate the fax spooler, modify their
own fax requests and those of others in their specified group.
- System Administrator - Allows the user to operate all aspects of
the fax spooler, Unix permissions permitting.
- Group Leader & System Administrator - Provides the permissions
of group leader and System Administrator.
- Text Editor Defines
the users preferred editor, this editor will be called when a user selects
any of the create fax options under Fax on the main menu. Press the [F5]
key to display and select from a list of defined editors.
- Fax Notification Defines
the notification scheme to use when notifying confirmation of fax transmission.
Press the [F5] key to display and select from a list of defined types.
- Alter Preferences
Specifies whether a use can alter their own preferences. Normally only a
group Leader or Administrator can alter these parameters.
- User can Send Specifies
whether a use can transmit faxes. Used on sites there the use of the fax
spooler is to be restricted.
Note:
In the definition of the user default, setting the value of "User can
Send" to "No" will restrict operation of the spooler for transmission to
only defined users.
|
Users connecting with default permissions will be unable to submit faxes
for transmission.
Define
Retry Schemes
Retry schemes are used to define the retry
criteria for each fax transmission. The retry schemes are highly flexible,
and any number of schemes may be defined. But as a minimum, a "default" scheme
must be defined.
The Retry Schemes allow the number of retries, conditions and delays between
retries to be specified. An number of retry schemes can be defined and then
specified when the fax is transmitted. For example different retry schemes
would be specified for overseas faxes verses local faxes.
Selecting this option provides a summary screen which displays the retry
scheme name and it's description. Use the cursor keys to highlight the required
scheme and then the function keys to select the required action.
- From the main menu select the "Data Bases".
- In the "Data Bases" menu select "Retry schemes".
- In the "Retry schemes" screen press [F5] to add a scheme.
You will now be presented with the following
screen.
┌────────────────────────────────────────────────────────────────┐
│ Retry Scheme Entry
│
│
│
│ Retry Scheme : default
│
│ Description :[Default - 10 Unconditional
retries_____] │
│
│
│ Count
Condition
Time
│
│ 1
+[Always___________] [00:05]
│
│ 2
+[Always___________] [00:10]
│
│ 3
+[Always___________] [00:15]
│
│ 4
+[Always___________] [00:30]
│
│ 5
+[Always___________] [00:45]
│
│ 6
+[Always___________] [01:00]
│
│ 7
+[Always___________] [01:00]
│
│ 8
+[Always___________] [02:00]
│
│ 9
+[Always___________] [02:00]
│
│ 10
+[Always___________] [02:00]
│
│ ────────────────────────────────────────────────────────────── │
│ F1 Save F2 Redraw F4 Quit
F5 (+)Options
│
└────────────────────────────────────────────────────────────────┘ |
The first two fields must have data manually entered. The "Condition"
field may be altered by using the [F5] key or space bar. The "Time" fields
may have times entered using the form "HH.MM" (use a period or other seperator
between hours and minutes). e.g. 5 minutes is entered as ".5."
- Retry Scheme is
a short name for the entry.
- Description is an
arbitary description of the scheme.
Against each scheme up to 10 entries
can be specified, each entry specifies a condition and the interval to the
next retry. Available entries are;
- Condition This
specified the condition under which the retry will be executed. Options are;
- Never (or blank)
Use to specify that this entry is not required. This is the default entry.
- Busy or No Answer
Retry at the specified interval if either of these conditions apply.
- Busy Retry at
the specified interval if this condition applies.
- Always Retry at
the specified time regardless as to why the connection failed.
- Time This is the time
interval to wait if the condition is true before trying the transmission
again.
When all details have been entered,
press [F1] to save them. You will now be back at the "Retry scheme" screen.
To return to the main menu, press [F4].
Define
the Route Tables
The routing table provides a means of
automatically time scheduling faxes based on the fax number prefix, or modifying
a fax number based on prefix to use an alternate carrier.
The fax number prefix can be any sequence of numbers, and can include
as much of the number as required. For example it may be required to automatically
schedule all faxes to an area which starts with a prefix of 059 to after
11pm, however all faxes to a particular number 059-333-9999 on that area
are to be
transmitted immediately. In this case two route table entries will be
made, one for 059 specifying delayed transmission and the other for 059-333-9999
specifying immediate transmission.
- From the main menu select the "Data Bases".
- In the "Data Bases" menu select "Route Tables".
- In the "Route Tables" screen press [F5] to add a table.
You will now be presented with the following
screen.
┌────────────────────────────────────────────────────────────────────┐
│ Routing Table Entry
│
│
│
│ Outgoing Prefix : +852
│
│ Modified Prefix :[0015852_________________]
│
│ Retry Scheme #[International___]
│
│ Destination :[Hong Kong___________________]
│
│ Resolution +[Standard -
100dpi vertical__]
│
│
Tariff #[________]
│
│
│
│ Off Modified
Starts Ends
Tariff │
│ Peak Prefix
Day HH:MM Day HH:MM
Code │
│ Period 1 :[0015852_____] +[Any] [21:00] +[Any] [06:00] #[________] │
│ Period 2 :[0049852_____] +[Sat] [06:00] +[Mon] [06:00] #[________] │
│ Period 3 :[____________] +[___] [00:00] +[___] [00:00] #[________] │
│ ────────────────────────────────────────────────────────────────── │
│ F1 Save F2 Redraw F3 (+#)Clear
F4 Quit F5 (+#)Options │
└────────────────────────────────────────────────────────────────────┘ |
This screen shows that any fax numbers with the prefix +852 submitted on
any week day be detailed until 11pm (Off Peak Period 1). Any faxed submitted
between Saturday 6am to Monday 6am, will be faxed immediately and will have
their prefix modified to to use a different carrier.
When using any of the function keys to operate on a record entry a window
will be displayed at the bottom of the screen. Entries that can be made to
specify a Route Table entry are;
- Outgoing Prefix
This is the prefix of the fax number to which this table entry is to be applied.
e.g. "+852" for Hong Kong.
- Modified Prefix This
is how the prefix is to be modified for normal un-delayed transmission. e.g.
"0015852" to access Telstra fax stream service.
- Retry Scheme This
retry scheme will be applied for any transmission. This allows limited retries
for certain destinations.
- Destination This
description is information only.
- Resolution The resolution
of faxes transmitted to this destination. Options are
- 100dpi which can
be used for long distance transmissions to reduce the transmission time.
- 200dpi for high
quality and local transmissions.
In addition to the above it is possible
to define delayed transmission for up to three specified periods. For each
of the periods the following can be specified;
- Modified Prefix
This is how the prefix is to be modified for the period.
- Start The day of the
week and the time the period commenses.
- End The day of the
week and the time the period ends.
- Tariff Tariff tables
can be applied against each route.
When all details have been entered,
press [F1] to save them. You will now be back at the "Route table" screen.
To return to the main menu, press [F4].
Define
the Fax Modems
The fax modems are defined within the
user interface using the same methods used to create users. To add a modem,
do the following:
- From the main menu select the "Data Bases".
- In the "Data Bases" menu select "More ...".
- In the "Data Bases" sub- menu select "Fax Modems".
- In the "Fax Modems" screen press [F5] to add a modem.
You will now be presented with the following
screen.
┌────────────────────────────────────────────────────────────────┐
│ Fax Modem Entry
│
│
│
│ Device ID : modem1
│
│ Device :[/dev/cua0___________________________________]
│
│ Lock file :[/var/lock/LCK..modem________________________]
│
│ Remote ID :[REALTIME HOLDINGS PL]
│
│ Dial prefix :[AT&K3DT_____________________________]
│
│ Header :[REALTIME HOLDINGS PL
- UxFax2 Fax System__] │
│ Driver + Class2 - Generic Class2
fax modem
│
│ Mode + Send (no indial)
Log/debug level :[1___] │
│ ────────────────────────────────────────────────────────────── │
│ F1 Save F2 Redraw F4 Quit
F5 (+)Options
│
└────────────────────────────────────────────────────────────────┘ |
The two botton fields may be altered by using the [F5] key or space bar.
Each of the other fields must have data manually entered. The following is
a brief description of the purpose of each field:
- Device ID is a
nominal name for the modem.
- Device is the device
node file name in the /dev directory.
- Lock file is the UUCP
lock file name.
- Remote ID is the ID
sent to a remote fax machine when sending. Thus ID is often seen on the receiving
fax machines LCD.
- Dial Prefix is the
modem "AT" dialling command. (Refer to Appendix B - Connecting Modems to
the Computer)
- Header is the text
placed across the top of each sent page.
- Driver is the modem
type. Use "Class 2" if you are unsure.
- Mode should be set
to send mode.
When all details have been entered,
press [F1] to save them. You will now be back at the "Fax modem" screen.
To return to the main menu, press [F4].
Appendix D - Stopping
& Starting the Fax Spooler
These are the steps required to stop and
start the fax spooler and establish its status.
First start the spooler with the following command:
faxcmd
menu [Enter]
Starting
the Spooler
To start the spooler, perform the following
steps from the main menu:
- Select Administration
- Select S - Spooler
- Select 2 - Start Spooler
- Press Y in response to the confirmation prompt.
- The "Message Window" should display the following message:
Faxcmd: Request
'echo' sent Mon Nov 29 10:30:44 1993
Server: Command CMD_ECHO rcv'd from root@IDmel
The fax server is running
- If the server fails to start, you will get a message such as:
Faxcmd: Request
'status' sent Thu Jun 10 14:43:44 1993
Client error 8: Send request failed. Cannot open lock file
- Press [F4] to return to the main menu.
Stopping
the Spooler
To stop the spooler, perform the following
steps from the main menu:
- Select Administration
- Select S - Spooler
- Select 2 - Stop Spooler
- Press Y in response to the confirmation prompt.
- The "Message Window" should display the following message:
Faxcmd: Request
'shutdown' sent Sat Feb 12 17:05:54 1994
Server: Command CMD_SHUTDOWN rcv'd from carl@ID486
Modem driver line1 has been detached
Shutting down the fax server
- Press F4 to return to the main menu.
Confirming
Spooler Status
The correct operation of the spooler can
be confirmed using the following command steps from the main menu:
- Select Administration
- Select S - Spooler
- Select 1 - Spooler Status
- If the server is running then the "Message Window" should display the
following message:
Faxcmd: Request
'status' sent Mon Jan 29 10:30:44 1994
Server: Command CMD_STATUS rcv'd from root@IDmel
Spooler status: 1 modem(s) attached, 0 active task(s)
Modem Mode Status
modem1 Send only Waiting
- If the server is not running then the "Message Window" should display
the following message:
Faxcmd: Request
'status' sent Sat Feb 12 17:08:40 1994
Client error 8: Server is not running. Cannot open lock file
Command
Line Operation
Each of the above operations can also be
done from the command line, using the following commands.
To start the spooler
faxcmd
startup [Enter]
To stop the spooler
faxcmd shutdown [Enter]
To confirm status
faxcmd
status [Enter]