README Updated 2000.06.14
COPYRIGHT 1994-2000 Faximum Software Inc. All Rights Reserved.
Faximum Software Inc.
1497 Marine Drive, Suite 300
West Vancouver, BC
Canada, V7T 1A6
|Phone:||1 (604) 925-3600|
|Support:||1 (604) 922-7311|
|Fax:||1 (604) 926-8182|
THIS README FILE IS A SHORTENED VERSION OF THE FULL "INSTALLATION GUIDE AND RELEASE NOTES" (IGRN) MANUAL. If you received this README file as a printed version in your software media kit it may be more current than the version on the media. Please use this version rather than the version on the CD-ROM. If you did not order a printed copy of the manuals for this product (which includes the IGRN), you may obtain a PDF (i.e. Adobe Acrobat) version of the IGRN manual either from your CD-ROM (if you obtained this software on CD-ROM) or from the Faximum Software website at www.faximum.com/support/manuals
Please visit http://www.faximum.com/status for the latest news on this software release.
Software Activation Key
Before you will able to use the software included in this distribution you will have to obtain a confidential activation key from Faximum Software. Please complete and send in the registration form at the end of the file in order to obtain your activation key. Thank you.
Important Legal Notice
This software and related documentation is covered by a licence and may only be used under the terms of that licence. A copy of the licence may be found at the end of this document. Installation of this software is evidence that you have read and agree to be bound by the terms of this licence. If you do not agree with the licence then do not install the software and return the software to your vendor or to Faximum Software Inc. within 10 days of purchase for a full refund of your purchase price.
Read This First
Please see the section Fixes Available for this Release for information on updates that are available for this software. There are fixes to enable this software to work on SCO UnixWare 7 and to address minor cosmetic problems associated with the Y2K bug.
The following features have been added to Faximum ELS/PLUS to produce the 2.2 Release:
Faximum PLUS also has a new option that enables you to fully integrate the fax server with your Web or email server for sending and receiving faxes using a Web browser or through email (for more information on this option, called the Faximum Messaging Gateway, please see http://www.faximum.com/fmg).
Persons migrating from Release 2.1 to 2.2 ought to be aware of the following changes that might affect the upwards compatibility of these two releases:
The updates to the "Faximum ELS/PLUS Reference Manual" are not complete at this time and so the product is shipping with the 2.1 version of the manual. As most of the enhancements in Version 2.2 do not affect the interfaces documented in the Reference Manual, this ought not to cause any significant problems.
To browse or download a copy of most Faximum manuals please visit www.faximum.com/support/manuals
This version of the Faximum ELS/PLUS Fax software is designed to work with IA-32 (i.e. 32-bit Intel Architecture processors such as the Intel Pentium or compatible) systems running SCO Open Server 5 or SCO UnixWare 7. While this software may run on SCO systems prior to OS5, it has not been tested on such systems and users are recommended to contact Faximum Technical Support prior to installing this software on SCO systems prior to Open Server 5.
In general, this release of the Faximum Fax software has been designed to work with any Class 2 or 2.0 (EIA-592) external fax modem. If you are uncertain whether your modem is Class 2 or 2.0, send the following command to the modem: AT+FCLASS=?
If the response contains the digit 2 then it will probably work (at least to some degree) with the Faximum software.
Note that with Class 2 and 2.0 modems much of the low-level fax protocol is handled by the firmware in the modem. This means that problems sending or receiving faxes may be caused by the modem's firmware and not by Faximum's software. If such problems are reported to Faximum Technical Support and are considered to be modem problems then the user will be asked to contact the modem manufacturer for assistance.
For a current list of modems that Faximum Software recommends, please visit http://www.faximum.com/modems
SPECIAL WARNING TO CUSTOMERS UPGRADING FROM AN EXISTING VERSION OF FAXIMUM
If you already have a copy of Faximum ELS/PLUS installed on your system you ought to make a backup copy BEFORE installing this release. While the installation script will attempt to locate your existing software and save the critical configuration files and databases, it is recommended that you make a backup in case something fails during the installation of the upgrade.
For example, if the several smaller files are named els-plus-2.21.tar-1 through els-plus-2.21.tar-6 (say), you can concatenate them together to product the single large tar file by running:
cat els-plus-2.21c.tar-* > els-plus-2.21c.tar
sum -r els-plus-2.21c.tar
(where you replace "els-plus-2.21c.tar" with the actual name of the large tar file). Compare the output you obtain with the checksums posted on the web page from which you obtained the software. If they do not match then the software has not been properly downloaded and you ought to try downloading the software again. If this persists, please contact Faximum Technical Support.
tar xvf els-plus-2.21c.tar
tar xvf /dev/rmt0 sco.plus
Note that the name of the tape drive (/dev/rmt0 in this example) may be different on your system.
mount -f ISO9660 /dev/cd0 /mntor (on UnixWare 7.x)
mount -F cdfs -o ro /dev/cdrom/cdrom1 /mnt
The output will appear similar to the following:
Faximum ELS/PLUS for SCO (and Intel) UNIX =========================================================================== Copyright (C) 1991-1997 All Rights Reserved. Software Load Faximum Software Inc. Release 2.2 =========================================================================== This program will load the Faximum ELS/PLUS software on your system. For more information on this installation process, please refer to your installation instructions (i.e. the README file or the printed "Installation Guide and Release Notes"). If you wish to proceed, please press 'y' now. Continue with software installation (y/n) ? y Where would you like to install the software [/opt]? New software will reside in /opt/faximum - looking for font server - found font server - PORT=localhost:7000 - Extracting server files into /opt/faximum... x faximum/bin/faxq, 97192 bytes, 190 tape blocks x faximum/bin/tiffcat, 148356 bytes, 290 tape blocks x faximum/bin/tiffcompress, 150748 bytes, 295 tape blocks x faximum/bin/tiffcut, 158660 bytes, 310 tape blocks x faximum/bin/tiffepsn, 136984 bytes, 268 tape blocks x faximum/bin/tiffhp, 199148 bytes, 389 tape blocks
long boring list of filenames deleted
x faximum/font/pcl/t, 11 bytes, 1 tape blocks x faximum/terminfo/a/ansi-c, 1353 bytes, 3 tape blocks x faximum/terminfo/a/ansi-m, 1329 bytes, 3 tape blocks x faximum/terminfo/w/wy50, 1369 bytes, 3 tape blocks x faximum/terminfo/w/wyse50, 1369 bytes, 3 tape blocks x faximum/terminfo/w/wy160, 1506 bytes, 3 tape blocks x faximum/terminfo/w/wyse160, 1506 bytes, 3 tape blocks x faximum/terminfo/source, 4266 bytes, 9 tape blocks - Installing /etc/faximum.conf file - Editing PCL configuration file - Creating system databases. - Installing appropriate ASCII/TIFF conversion utility for your system. - Removing unneeded font files - Installing system start-up/shutdown scripts - Editing /etc/inittab and related files. - Reconfiguring init - Installing message catalogue in /usr/lib/nls/msg/C_C.C - Editing scripts in faximum/bin directory - Modifying permissions on /var/spool/uucp - Removing installation files. - Testing permissions and modes of installed files. (The only error you ought to see is for /dev/ttyxx. If other errors are reported, please consult your installation guide.) </dev/ttyxx> ERROR: File is missing. (File cannot be recreated automatically). ********************************************* ** Faximum Software installation complete. ** ********************************************* Before trying to run the Faximum software, remember to: - edit the /etc/faximum.lic file to install your activation key - edit the /opt/faximum/dev/fax-line-1 file to specify your modem port - start the Faximum daemons (For more information on any of these steps, please consult your installation instructions.)
For your information, the install script will edit the following system configuration files (original will be copied to /tmp in case the installation fails).
Note that in order to complete the configuration of the Faximum ELS/PLUS software you will need an activation key from Faximum Software.
As part of the configuration process you will need to edit several text files. You may use any text editor you are familiar with such as vi, emacs, etc.
You must disable this port for normal logins or else the system login processes will conflict with the Faximum software.
You can do this by using the disable command.
For example, if you are connecting the fax modem to port /dev/ttya12 (and /dev/ttyA12 is the modem port), type:
Change the line that begins:
tsi =so that it contains your fax phone number. For example:
tsi = "1 604 926 8182"(Use only digits, spaces, and the + symbol.)
In order that faxes sent by Faximum properly identify their source you ought to configure your system to set your company name and related information.
Note that in some jurisdictions it may be illegal to send faxes that do not contain such identifying information.
Please edit the file /etc/faximum.conf and set the following parameter (using, of course, information appropriate for your installation):
company-name = "Flying Tigers" company-addr1 = "Hangar 123" company-addr2 = "Vancouver International Airport" company-addr3 = Richmond company-addr4 = "BC V9Z 4P6" company-fax = "(604) 224-9999" company-phone = "(604) 224-8888"
After you have configured the software, you must start the background processes which schedule the faxes and control the modem.
This will be done automatically when you reboot your system. You can also do this manually by running:
Note - if you are running on a system that does not have the X11 Font Server installed then you may see an error message of the form:
ERROR: Cannot execute fs. (Possible missing or corrupt /usr/bin/X11/fs file.)
you may ignore this message.
Should you wish to terminate the fax daemons, type:
To run the Faximum user interface software, type:
To make this easier, you may wish to:
To remove the the server software follow these steps:
cp /opt/faximum/lib/fxm.remove /tmp
cd /tmp sh fxm.remove
The output ought to be something similar to the following:
Faximum software is in /opt/faximum directory. Are you sure you wish to remove the server software? (Yes or No) Yes - Shutting down any Faximum daemons. disable: fxm1 : already disabled fxm1 terminated. - Deleting all files in /test/dir/faximum. - Removing start-up and shutdown scripts - Removing Faximum from /etc/inittab and related files. - Reconfiguring init - Removing /etc/faximum.conf - Removing /var/spool/faximum directory - Restoring permissions on /var/spool/uucp **************************************** ** Faximum Software removal complete. ** ****************************************
Should you experience any problems with this software, please visit our Technical Support web page at: http://www.faximum.com/support
Please also visit the page: http://www.faximum.com/status which contains updated information on bugs and fixes available for this release (i.e. your problem may be the result of a bug that has already been reported to Faximum).
If you are still unable to resolve your problem after following those steps, please contact the company that supplied you with this software.
If your vendor is unable to assist, please contact Faximum Technical Support by fax at (604) 926-8182, by email to support@Faximum.COM or by phone at (604) 922-7311.
Please read http://www.faximum.com/support/policy for detailed information on the options available for purchasing technical support.
Note that if you are contacting Faximum Technical Support with a question we need the following information:
There are several fixes that have been release for Faximum ELS/PLUS 2.21C. These include:
These fixes should be installed after you have already installed the Faximum ELS or PLUS product.
If you have obtained this software on CD-ROM, change into the sco.plus directory on the CD-ROM and (as root) run the following script:
./fix.installThis script will replace the necessary files.
If this fix is not on your CD-ROM or if you have downloaded the software then you can obtain a copy of these fixes by downloading the file ftp://ftp.faximum.com/pub/software/sco.plus/r221cfix1.tar.Z
After downloading the file and putting it into a temporary directory on your system you can install the fix by typing the following commands (as root):
uncompress r221cfix1.tar.Z tar xvf r221cfix1.tar.Z ./fix.install
This fix requires an additional activation key. Please contact Faximum Technical support if you have not already received this special key. Enter the two activation keys in the /etc/faximum.lic file and ensure that this file is readable by all. Go through TechNote #212 and send us the resulting trace file so that we can confirm that the activation keys are ok.
This is a list of the known deficiences in this software as of the date of this README file (see the beginning of this document).
1.The installation instructions do not yet provide information on configuring: a) the WordPerfect macro; b) the Line Printer Intercept; c) Data/Fax sharing; ord) DID/DTMF routing.
2. The Reference Manual is based on the 2.1 version of the software and the new version including the changes and new screen shots to more closely correspond to this version has not yet been completed.
If you need information on any of these four features, please contact Faximum Technical Support by sending email to firstname.lastname@example.org You can also download the latest installation guide and release notes in pdf format from http://www.faximum.com/support/manual/
Please visit http://www.faximum.com/status.d/sco.plus.2.2.html for the latest news on this software release.
Comments and suggestions regarding the software are always welcome. Please send your comments to support@Faximum.com or fax them to (604) 926-8182.
Before installing this software, you ought to read carefully all of the terms and conditions of this Licence Agreement. Installing the software indicates your acceptance of the terms and conditions of this Licence Agreement. If you do not agree with any part of this licence you must not install the software.
The terms and conditions of this Agreement apply to the Faximum Software including any copy.
Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause in DFARS 252.227-7013. Rights for non-DOD U.S. Government Departments and Agencies are as set forth in FAR 52.227-19(c) (1,2).Faximum Software Inc. 1497 Marine Drive, Suite 300 West Vancouver, BC, Canada, V7T 1A6
SPECIAL LEGAL NOTICE CONCERNING GUNZIP The gunzip utility that may be included in this distribution to uncompress the installation files is Copyright (C) 1992-1993 Jean-loup Gailly and provided under the terms of the GNU General Public License. A copy of this licence is provided in the file COPYING.gz. To read this file uncompress it first using the unzip utility.
In order to obtain your software activation key you need to visit http://www.faximum.com/register and register your product.Once you have completed the on-line form we will endeavour to get you your licence within one business hour. If you are unable to register on-line you may email or fax the following form to email@example.com (fax: +1 (604) 926-8182).
|Your Name & Title:|
|City, State, and Code:|
|How did you learn about Faximum?|
|From whom did you purchase this product?|
|UNIX Operating System Supplier and Release:|
|Computer System Manufacturer and Model:|
|Computer Systems Hardware ID:
(i.e. Serial and Node fields from the uname -X command)
|Fax Modem Manufacturer and Model:|
|Multi-Port Card Manufacturer and Model:|
|Licence Requested: (please pick one)|| ___ 30-day free evaluation licence
___ permanent ELS 2.21c licence with ____ fax line licence(s).
___ permanent PLUS 2.21c licence with ____ fax line licence(s).
|Comments and Suggestions:|
I have read the software licence form and agree to its terms and conditions. (Please add your name and the date.)