HylaFAX Facsimile Software For AIX RS6000 Systems Version v4.0pl2 (read ``Version 4.0 patch level 2'') Installation Directions Last updated: Sun Mar 22 13:20:32 MST 1998 This BINARY release has been put together by Steve Williams (steve@genie96.com) Any problems or questions relating to the INSTALLATION of this binary distribution should be directed to myself. If it is a general usage question, please direct the question to the hylafax mailing list ( flexfax@sgi.com ) Please see below for the appropriate Copyright for the actual software. The format for this document is based largely on Sam's Installation directions for IRIX. This binary has been compiled using gcc 2.7.2, under AIX 3.2.5. It has been installed & tested under AIX 3.2.5, AIX 4.1.4. It has been used in production under AIX 3.2.5 and AIX 4.1.4. The following features have been used in a production environment: - outgoing fax - outgoing data - uucp, ppp, interactive - incoming data - uucp & interactive Incoming fax has only been tested. This file contains instructions on how to get started installing HylaFAX from the binary distribution for AIX. This document is incomplete; the remaining materials are part of the standard documentation that comes with the software. This documentation is included in the distribution proper and on the WWW through the HylaFAX page at http://www.vix.com/hylafax. If you don't have an Internet connection that you can use to read the documentation then install the HTML materials included in the binary distribution to obtain the necessary documentation. There are also pre-formatted versions of these materials available by public FTP from the host ftp.sgi.com in the directory ~ftp/sgi/fax/doc. Installation ------------ This AIX binary distribution comes as a gzip'd cpio file. The reason for the cpio rather than tar is for the proper creation of empty directories, as well as a PIPE device, both of which tar has a problem with. There is only one binary available, but testing has indicated that it will run under AIX 4 as well. It is completly untested on version of AIX prior to AIX 3.2.5. hylafax-aix3.2.5-v4.0pl2.cpio.gz sum hylafax-aix3.2.5-v4.0pl2.cpio.gz = 48031 3334 md5 hylafax-aix3.2.5-v4.0pl2.cpio.gz = 3eca1a83f90c55abf5f6abf1d480e461 There was sufficient demand for binary versions of ghostscript that I have included a SEPERATE tar file containing three different versions of Ghostscript. Please retrieve gs-aix3.2.5.tar.gz if you want a binary version of Ghostscript. This tar file contains gs3.53, gs4.03, gs5.10. They all have been used with HylaFax, and contain the necessary drivers. gs-aix3.2.5.tar.gz sum gs-aix3.2.5.tar.gz = 09891 1703 md5 gs-aix3.2.5.tar.gz = 969808cc94617d0e05ed6124f908e945 If you DO need a binary, then rename the one that you want to use to be "gs", and delete the other ones. None of these gs binaries have Xwindows drivers compiled in, as I do not have X under AIX 3.2.5. Other than that, they are pretty loaded with drivers. The Ghostscript software is only needed as far as I know. If you have X running on your system, you may have access to the Adobe Postscript, but I don't have any experience at this. Again, please let me know one way or the other to update these notes. You may or may not require the fonts for ghostscript. The fonts ARE NOT included in this distribution, and can be retrieved from: http://www.cs.wisc.edu/~ghost/index.html All files in this distribution are placed into the distribution RELATIVE ( no leading / ). This is so that you can easily play if you do not like the location of files. All files are placed in the default directories for the hylafax source distribution. SOME of the directories are: /usr/local/bin /usr/local/sbin /usr/local/man /usr/local/lib /var/spool/fax /var/httpd/ /usr/local/lib/ghostscript To install this distribution in it's default location, 1. log in as root 2. cd / 3. gunzip < [path_to_file]/hylafax-aix3.2.5-v4.0pl1.cpio.gz | cpio -iudvcm This will install all the files with proper permissions ( hopefully ). Note that there are two separate packages in the HylaFAX distribution: HylaFAX and the TIFF software. HylaFAX requires the TIFF software for operation; it must be installed to use the HylaFAX client or server software. The TIFF software required for hylafax will be installed by the above process. Please note, this is ONLY the "tools" package of the TIFF software. It does not include the libraries for development. ------------------------------------------------------------------------------ **** AIX Hints **** ------------------------------------------------------------------------------ - Hardware flow control MIGHT NOT WORK under AIX 4.2. I only have 1 machine at 4.2, and I am not sure if the serial port is functioning properly. It is a Model 220, & I have never used the serial port before. It could be the serial port OR the version of AIX. Hardware Flow control DOES work under AIX 3.2.5 & AIX 4.1.4. - Make sure you have a tty configured via smit where the modem is attached. - Make sure the port is NOT enabled for login ( don't just pdisable it, that only lasts until the next reboot ). chdev -l ttyXXX -a login=disable - If faxaddmodem ( or faxsetup ) hanges at " Probing for best speed to talk to modem: Make sure that your modem has verbose result codes enabled. If that is not sufficient to make it work, try setting Carrier Dectect to be forced on. ( Typically &C0 ). This is not necessary under all versions of AIX, but I did find it necessary some times. - Do not update the inetd.conf when prompted during faxsetup. You can, IF you know exactly what the ramifications of this are. Otherwise, just run the fax stuff from /etc/rc.local. - Gettyargs for AIX should be "/dev/%l". THAT's IT. In SMIT, make sure that the baud rate of the TTY ( even though the port is disabled ) is set to the same speed that the modem config file is set for. - There is a "hack" required to get dial in support to work nicely. - If you do not have an /etc/rc.local, you should probably add one to your /etc/inittab. This gets into scary territory, because you are editing things that may make your system UNBOOTABLE. I won't include directions here, because if you don't know how to do this, you probably shouldn't be. If you really want to do this, send me email & I'll help you out. - I have included a "snippit" of my /etc/rc.local. Paste it into yours if you so desire, WITH APPROPRIATE MODIFICATIONS TO THE chitab LINE - Sample portion of /etc/rc.local # Start up the Fax Daemon # do a ps first, to see if there is one running. The PS includes # the PS process, so we need to subtract 1 to get the math correct num_faxd=`ps -ef | grep faxq | wc -l` if [ $num_faxd -eq 1 ]; then /usr/local/sbin/faxq > /dev/console 2>&1 # start fax fi num_hfaxd=`ps -ef | grep hfaxd | wc -l` if [ $num_hfaxd -eq 1 ]; then /usr/local/sbin/hfaxd -i hylafax -o fax > /dev/console 2>&1 fi # Hack to get faxgetty into inittab num_faxgetty=`ps -ef | grep faxgetty | wc -l` if [ $num_faxgetty -eq 1 ]; then /etc/chitab "tty1:2:respawn:/usr/local/sbin/faxgetty /dev/tty1" ^^^^ ****** Change ******** sleep 2 ; telinit q fi - The "hack" to get faxgetty into the inittab is necessary since the inittab is rebuilt on every reboot, with information from the ODM ( read SMIT ). SMIT doesn't ( yet ) let you put other programs in it to run instead of getty, so the hack is necessary. It works totally reliably. I can't take credit for this, I received this tip from someone on the flexfax mailing list ( sorry I can't give you credit, I have lost any reference ) HTML Documentation ------------------ HylaFAX documentation is distributed as HTML suitable for viewing with a browser application such as netscape, mosaic, lynx, etc. You will need to read this documentation to complete the installation of HylaFAX. You have two choices: if your system is directly connected to the Internet you can view the documentation online at the main WWW site at http://www.vix.com/hylafax; or you can install the HTML documentation locally by installing the hylafax.html.* images. The HTML documentation is configured for installation in the directories /var/httpd/htdocs/hylafax (documents) and /var/httpd/cgi-bin (CGI scripts); you may need to add symbolic links to these directories if your HTTP server is configured with a different document root (or add entries to the HTTP server's configuration files). Note that if you do not have an HTTP server on the machine where you want to install the HTML materials you can view the documentation locally using your favorite World Wide Web browser; e.g. hyla% netscape /var/httpd/htdocs/hylafax OR hyla% lynx /var/httpd/htdocs/hylafax Beware however that if the materials are viewed without an intervening HTTP server then the CGI scripts will not be functional and you will not, for example, be able to follow links to manual pages. What Next? ---------- Once the appropriate materials have been installed; you complete the installation procedure by following the directions in the chapter on setting up a server. This chapter is available locally as: /var/httpd/htdocs/hylafax/setup.html if you install the HTML materials or online at: http://www.vix.com/hylafax/setup.html. Troubleshooting and Problems ---------------------------- The documentation is extensive and almost certainly has the answer to any question you might have; or it tells you how to obtain the information that you need to deal with a problem. In particular, before asking any questions read the HTML documentation. There is an annotated table of contents and an extensive chapter on troubleshooting problems. The UNIX manual pages have been carefully written and should be consulted for reference questions. If you are overwhelmed by a problem you can ask for help on the flexfax mailing list. If it is a problem with the BINARY distribution, the please contact steve@genie96.com Consult the HTML documentation for information on how to join this list and for guidelines on submitting questions. Remember that when asking for help you need to provide enough information for someone to understand your problem. If you ask a vague question or describe a problem instead of providing the exact diagnostic message or a trace log that clearly identifies your problem then you likely will not receive any replies. The troubleshooting chapter of the HTML documentation gives instructions on how to collect the information you need to include in a posting to the mailing list. Copyright --------- Copyright (c) 1994-1996 Sam Leffler Copyright (c) 1994-1996 Silicon Graphics, Inc. HylaFAX is a trademark of Silicon Graphics, Inc. Permission to use, copy, modify, distribute, and sell this software and its documentation for any purpose is hereby granted without fee, provided that (i) the above copyright notices and this permission notice appear in all copies of the software and related documentation, and (ii) the names of Sam Leffler and Silicon Graphics may not be used in any advertising or publicity relating to the software without the specific, prior written permission of Sam Leffler and Silicon Graphics. THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.