Faximum Client/Server

Release 2.3 EAP 2

Fax Software for HP-UX 11

README Updated 2001-06-19 14:59
COPYRIGHT © 2001 Faximum Software Inc. All Rights Reserved.

Faximum Software Inc.
1497 Marine Drive, Suite 300
West Vancouver, BC
Canada, V7T 1A6

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. The most current copy is always available from http://www.faximum.com/support/readme/cs-2.3-hpux11.html.

Please visit http://www.faximum.com/status for the latest news on this software release. This web page also contains information on any updates that might be released after this document was written.

Table of Contents

1. Release Notes
2. Documentation
3. Preparing to Install the Software
4. Installing the Software
5. Configuring the Software
6. Running the Fax Software
7. Removing the Software
8. Resolving Problems and Contacting Technical Support
9. Fixes Available for this Release
10. Known Problems with this Release
11. The Software Licence
12. The Software Registration Form

1. Release Notes

This package is a port of the existing Faximum Client/Server Release 2.3 product to HP-UX 11.x along with an entirely new PCL interpreter which emulates the behaviour of an HP LaserJet 4 printer (and is much more faithful to the PCL specification than the previous emulator).

This build corrects a number of problems reported with earlier BETA and EAP releases of Faximum Client/Server includes problems with:

• the fax client on certain J-class servers
• the conversion scripts for TIFF and PCL files
• the Line Printer Intercept mechanism

Please report any suspected bugs to support@faximum.com

2. Documentation

Unfortunately the on-line help system on HP-UX 11 is completely incompatible with the on-line help system on HP-UX 9 and 10. Faximum Software is still working on migrating our on-line help files to HP-UX 11.

In the interim you may access the on-line help for the Faximum Client/Server product by browsing http://www.faximum.com/manual.d/client.server.d/oview.1.html

3. Preparing to Install the Software

1. Verify that your system is running a supported version of the operation system and that the modem you plan to use is recommended for use with Faximum. (See the information below.)
2. Select the server machine.

Select one of the machines on your network which is to act as the fax server for your network. The fax server machine is the one that will be connected to the fax modems.

Faximum Client/Server is designed to allow multiple client machines access the fax services of one or more fax servers. You are permitted to install the client software on as many systems as you wish as long as (a) they are connected to a network with access to the machine that acts as the fax server and (b) the fax server machine has a properly licensed copy of the software installed.

This licence extends to Faximum Client software for other platforms. For example, if you are running a licensed copy of the Faximum Server software on HP-UX 10.0, you are permitted to install a copy of the Faximum Client software for (say) Sun Solaris and use your Sun workstation as a fax client of your HP-UX 10.0 system.

3. Make sure you have sufficient disk space on the server and client machines to install the software.

Note that currently the software must be installed in the /opt directory. (i.e. /opt/FAXserver and /opt/FAXclient). While the next release will permit installation in any directory this release must be installed in /opt. If this is a problem, create a symbolic link from /opt to the desired installation directory.

The server package requires about 15Mb of space.

The client package requires about 2Mb of space.

4. Complete the registration form (attached to the end of this file).

Note that in order to complete the configuration of the Faximum Client/Server software you will need to obtain a coded serial number and activation key from Faximum to enable your software. The registration form is also your request for an activation key. Faximum will respond within two business days with the necessary codes.

Note that in order to complete the form you will need to know the serial number for the server machine. You may obtain this by typing in the command 'uname -i' on the server machine.

Supported Hardware and Operating Systems

Note that while faxes may be submitted from character terminals, the Faximum Client requires access to a graphics console or X terminal in order to administer the product. 

Supported Fax Modems

For detailed information on the issues surrounding Fax Class 2 modems as well as Faximum's recommendations please see http://www.faximum.com/modems.

4. Installing the Software

Loading the Software by FTP

1. Obtain the software from the Faximum ftp server (ftp.faximum.com or 206.12.31.61). The current release of the software may be found in the directory /pub/software/hpux11

There will a single large (about 10Mb) tar file called something like cs-2.3-2-hpux11.tar in the directory

2. Once you have copied the cs-2.3-2-hpux11.tar file to a temporary directory, inpack it by typing:

        tar xf cs-2.3-2-hpux11.tar

3. Continue the installation with Installing the Software below.

Loading the Software From Tape

1. Insert the magnetic tape in your tape drive and change your working directory to a temporary directory with at least 25Mb of free space. For example:

        cd /tmp

2. Use the tar ommand (with the appropriate arguments for your system to extract the software from the tape). For example (assuming that /dev/rmt is the name of your tape drive), type:

        tar xvf /dev/rmt hpux11

3. Change your working directory into the hpux11 directory you just unloaded from the tape:

        cd hpux11

4. Continue the installation with Installing the Software below.

Installing the Software

1. To install the server software, type:

     sh server.install

We recommend installing this software in its default location of /opt/FAXserver as suggested by the installation script. The proper operation of the software in other directories has not yet been verified.

Once you have installed the server please see the section Patches Available for this Release for information on patches that ought to be applied to your installation.

2. To install the client software, type:

     sh client.install

We recommend installing this software in its default location of /opt/FAXclient as suggested by the installation script. The proper operation of the software in other directories has not yet been verified.

If there are other machines you wish to install the client software on, copy the files that start with the word "client" to the desired machines and repeat the above instructions.

5. Configuring the Software

Server Configuration

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.

1. Create the file /etc/faximum.lic and enter the key sent to you by Faximum Software.
2. Edit the file /etc/opt/faximum/dev/fax-line-1 and change the line that begins:

        device =

to reference the serial communications port that you will be connecting the modem to. For example:

        device = /dev/ttyd0p0

The use of the direct terminal port (i.e. ttyd..) is recommended.
3. You must disable this port for normal logins or else the system login processes will conflict with the Faximum Server software. This is done by editing the /etc/inittab file.
1. Edit the file /etc/inittab using vi or other text editor.
2. Find the line(s) that refer to the ports that you plan to use for the fax modem. For example:

a0:4:respawn:/usr/sbin/getty -h ttyd0p0 9600

3. Change the field that reads respawn to read off. For example:

a0:4:off:/usr/sbin/getty -h ttyd0p0 9600

4. Then you need to tell the init process to reread the /etc/inittab file. This is done by running the following command as root:

        init q

Consult your HP-UX documentation for details.
4. Edit the file /etc/opt/faximum/dev/fax-line-1 and 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.)
5. If you wish to enable the modem to receive faxes, then you must edit the /etc/inittab file and add the following line:

        fxm1:234:respawn:/opt/FAXserver/lbin/faxgetty fax-line-1

Then you need to tell the init process to reread the /etc/inittab file. This is done by running the following command as root:

        init q

Client Configuration (Non-Server Machine)

1. Edit the file /opt/FAXclient/lib/Fax.app-defaults and change the line that reads:

        fax.server: localhost

to reference the system that will be acting as the fax server. For example:

        fax.server: manet.company.com

2. Or, if you prefer, you can define (in the /etc/hosts) an alias for the fax server. For example:

        133.45.67.23    manet.company.com  faxhost

and change the definition of fax.server: in Fax.app-defaults to reference faxhost instead of localhost
3. Edit the file /opt/FAXclient/lp/model and change the line that reads:

        FAXHOST=localhost

to define FAXHOST as either faxhost or the actual name of the fax server.
4. Note that if you are planning to use the submitfax tool it will try to connect to faxhost unless another host name is specified either by using the FAXHOST environment variable or by using the -h flag (i.e. submitfax -h server.name)

***** IMPORTANT NOTE *****

6. Running the Fax Software

Starting the Fax Daemons

This will be done automatically when you reboot your system. You can also do this manually by running:

        /sbin/init.d/faximum start

        /sbin/init.d/faximum stop

Starting the Fax Client

        /opt/FAXclient/bin/fax

1. put /opt/FAXclient/bin in the search path of those who wish to use the Faximum Client software; or
2. copy /opt/FAXclient/bin/fax to a directory that is already in your users' search path (perhaps /usr/local/bin, or /usr/bin).

7. Removing the Software

Removing the Server Software

1. Stop the Faximum daemons by typing (as root, on the machine with the Faximum server software):

        /sbin/init.d/faximum stop

2. Copy the removal script to a temporary directory. For example (as root):

        cp /opt/FAXserver/lib/server.remove /tmp

3. Run the software removal script:

        cd /tmp
        sh server.remove

Removing the Client Software

1. Copy the removal script to a temporary directory. For example (as root, on the machine with the Faximum client software):

        cp /opt/FAXclient/lib/client.remove /tmp

2. Run the software removal script:

        cd /tmp
        sh client.remove

8. Resolving Problems and Contacting Technical Support

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:

• Your Activation Key Number (emailed or faxed to you by Faximum Software when you registered the product);
• the version and release number of the software (from the media package or README file-e.g. Release 2.21C); the date on the update disk (if any);
• the type and release of your operating system; and
• the manufacturer and model of your fax modem (and if using an external fax modem, the manufacturer of the intelligent multi-port card that the modem is connected to).

The fix package previously released for the Faximum Client/Server HP-UX 11 package (hpux11fix20010327.tar.Z) has been incorporated into this package and need not be installed with this release.

No fix package is currently available or needed for this release.

10. Known Problems with this Release

Other problems still being worked on by Faximum:

1. On-line help does not work.

2. The labels and fields on some fax client displays are not aligned

11. The Software Licence Agreement

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.

1. DEFINITIONS
   1. "Faximum Software" means programs, data files, and related documentation supplied herewith.
   2. "Faximum Server Software" means (a) those parts of the Faximum Client/Server software product that are labelled "server" or "FAXserver"; (b) all of the parts associated with the software products "Faximum ELS", "Faximum PLUS", "Faximum MFax", and "Faximum TIFF Utilities"; and (c) those parts of the Faximum Messaging Server or Faximum Messaging Gateway products intended to be installed on the UNIX or Linux system.
   3. "Faximum Client Software" means (a) those parts of the "Faximum Software" that are labelled "client" or "FAXclient" and (b) those parts of the "Faximum Software" intended to be installed on Microsoft Windows.
   4. "software activation key" is a sequence of characters intended to be loaded into a file on a computer in order to enable the software to functions.

2. GRANT OF LICENCE
   1. Faximum Software Inc. hereby grants you a personal, non-transferable, and non-exclusive right to use the "Faximum Software".
3. LIMITATIONS ON USE
   1. You may only use the "Faximum Software" if you have been granted a "software activation key" by Faximum Software Inc.
   2. You may only install the "Faximum Server Software" on the machine identified with the activation key provided to you by Faximum Software Inc.
   3. You may install the "Faximum Client Software" on as many machines as you wish as long as these machines (a) are owned, controlled, or normally used by the same people or organisation as the system hosting the "Faximum Server Software", and (b) are able to communicate with the system hosting the "Faximum Server Software".
   4. If you wish to install the "Faximum Server Software" on another machine, you must either remove the "Faximum Software" from the machine on which it has previously been installed or you must purchase an additional copy of "Faximum Software" for each additional machine.
   5. You may make a reasonable number of copies of the "Faximum Software" solely for your own archival back-up purposes.
4. NON PERMITTED USES
   1. You may not reverse engineer, disassemble, reverse translate, or in any way derive from the "Faximum Software" any source code form.
   2. You may not tamper or otherwise attempt to change the "software activation key" or other identifying information stored within the "Faximum Software" or divulge to others your "Faximum Software" activation key.
   3. You may not use the "Faximum Software" on any machine after the expiration date given with your "software activation key" unless you have been issued a replacement "software activation key" with a later expiry date.
   4. You may not use the "Faximum Client Software" unless the machine on which the software is installed can communicate using TCP/IP with a machine that has installed a copy of the "Faximum Server Software" that you are licenced to use.
   5. If you have been granted a "personal non-commercial" software activation key then you must not use the software for any commercial or educational purposes nor permit it to be used by anyone other than yourself for any purposes whatsoever.
5. TERM
   1. This Licence Agreement is effective until terminated.
   2. You may terminate this Licence Agreement by destroying the "Faximum Software" and all copies thereof.
   3. This Licence Agreement will terminate if you fail to comply with any term or condition of this Agreement.
   4. Upon notification from Faximum Software Inc. that this Agreement has terminated, you will destroy all copies of the "Faximum Software" and you will certify to "Faximum Software" in writing that you have done so.
   5. Upon termination, there will be no refund of any monies or other consideration paid by you.
6. LIMITED WARRANTY
   1. YOU ACKNOWLEDGE AND AGREE THAT "FAXIMUM SOFTWARE" IS PROVIDED TO YOU "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE, ALL OF WHICH ARE WAIVED BY YOU.
   2. YOU ACKNOWLEDGE AND AGREE THAT FAXIMUM SOFTWARE INC. DOES NOT WARRANT THAT THE FUNCTIONS OF THE "FAXIMUM SOFTWARE" WILL BE ERROR-FREE OR UNINTERRUPTED.
   3. YOU ASSUME THE RISK OF ANY AND ALL DAMAGE OR LOSS FROM USE OR INABILITY TO USE THE "FAXIMUM SOFTWARE".
   4. THE WARRANTIES HEREIN CONTAINED EXTEND ONLY TO YOU AND SHALL NOT BE APPLICABLE TO ANY OTHER PERSON OR ENTITY.
7. LIMITATION OF REMEDIES
   1. YOU ACKNOWLEDGE AND AGREE THAT YOUR SOLE AND EXCLUSIVE REMEDY AGAINST FAXIMUM SOFTWARE INC., ITS AFFILIATES, CONTRACTORS, SUPPLIERS, AND AGENTS FOR LOSS OR DAMAGE ARISING DIRECTLY OR INDIRECTLY FROM THE MANUFACTURE, SALE, OR SUPPLY OF THE "FAXIMUM SOFTWARE" OR ANY DEFECT OR FAILURE THEREOF REGARDLESS OF THE FORM OF ACTION, WHETHER IN CONTRACT, TORT, OR OTHERWISE (INCLUDING WITHOUT LIMITATION, NEGLIGENCE, AND STRICT LIABILITY), SHALL BE REPLACEMENT OF THE "FAXIMUM SOFTWARE", PROVIDED THAT THE "FAXIMUM SOFTWARE" IS RETURNED TO FAXIMUM SOFTWARE INC. WITH A COPY OF YOUR SALES RECEIPT.
   2. NEITHER FAXIMUM NOR ITS AFFILIATES, CONTRACTORS, SUPPLIERS, OR AGENTS SHALL BE LIABLE FOR ANY INDIRECT, INCIDENTAL, OF CONSEQUENTIAL DAMAGES (INCLUDING LOST PROFITS) SUSTAINED OR INCURRED BY YOU OR ANY OTHER PERSON IN CONNECTION WITH THE USE, OPERATION, OR INABILITY TO USE THE "FAXIMUM SOFTWARE".
   3. NO SUPPLIER, REPRESENTATIVE, OR AGENT OF FAXIMUM SOFTWARE INC. IS ENTITLED TO OFFER TO YOU ANY REPRESENTATIONS, WARRANTIES, OR INDEMNITIES WHICH ARE NOT EXPRESSLY CONTAINED IN THIS LICENCE AGREEMENT; THE LIABILITY OF FAXIMUM SOFTWARE INC. SHALL BE LIMITED AS STATED ABOVE NOTWITHSTANDING THAT FAXIMUM SOFTWARE INC. OR ANY AUTHORIZED REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF DAMAGES OR POTENTIAL FOR DAMAGES.
8. MISCELLANEOUS
   1. This Licence Agreement shall be governed by and construed in accordance with the laws of the Province of British Columbia (Canada).
   2. You agree that any disputes with respect to the "Faximum Software" or this Licence Agreement shall be brought in the courts of the Province of British Columbia.
   3. If any provision hereof shall be deemed by any court to be invalid, legality and enforceability of the remaining provisions hereof shall not be affected or impaired.
   4. This Agreement enures to the benefit of and shall be binding upon you, your successors, heirs, and assigns and Faximum Software Inc., its successors, and assigns.
   5. All provisions of this Licence are also intended for the benefit of Faximum Software Inc., and its suppliers who can enforce this Agreement without requiring your prior consent.
   6. Some jurisdictions do not allow the exclusion of implied warranties; if so, only those limitations of warranty which are specifically prohibited by law notwithstanding contractual provisions to the contrary will not apply to you.
9. ACKNOWLEDGEMENT
   1. BY INSTALLING ANY PART OF THE "FAXIMUM SOFTWARE" YOU ACKNOWLEDGE THAT YOU HAVE READ THIS AGREEMENT, UNDERSTAND IT, AND AGREE TO BE BOUND BY ITS TERMS AND CONDITIONS. YOU ALSO AGREE THAT THIS AGREEMENT SUPERSEDES ALL PRIOR AGREEMENTS AND UNDERSTANDINGS BETWEEN YOU AND FAXIMUM SOFTWARE INC. RELATING TO THE "FAXIMUM SOFTWARE" AND IS THE COMPLETE AND EXCLUSIVE STATEMENT OF THE TERMS AND CONDITIONS OF YOUR AGREEMENT WITH FAXIMUM SOFTWARE INC.

RESTRICTED RIGHTS LEGEND

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).

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.

12. The Software Registration Form

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 support@faximum.com (fax: +1 (604) 926-8182).

Registration for Faximum Client/Server 2.3-3 (2001.06.19)
for HP-UX 11

I have read the software licence form and agree to its terms and conditions. (Please add your name and the date.)

Name:

Date:

[Client/Server 2.3-3 HP-UX 11 2001.06.19]