Setting up Hylafax under HP-UX 10.20



HP Serial Ports
Fax Modems
Serial Ports
Software Required
Installation
faxsetup
startup script
Start hylafax
gettys
cron jobs
Test

Any questions?
please email me
Robert Colquhoun
at
rjc@trump.net.au


  1. Hardware - HP Serial Ports
  2. HP sells many models of muxes/serialports for 800 series machines. Many are not suitable for use with fax modems

    ie the J2092A and J2093A cards will not work but the J2094A card will

    Most of the EISA will work ok.

    If the card is added in after the Operating System is installed the kernel may need to be rebuilt with the correct mux/eisa driver For more details see 'Configuring HP-UX For Peripherals' chapter 2 (this is included on the HP10 Laserrom CD)

  3. Hardware - Fax Modems
  4. The faxmodem chosen is of critical importance for reliability of operation. If possible especially for a machine running a large number of lines try to get a class 2 or class 2.0 faxmodem.

    Note many of the new K56flex modems only support class 1

    Modems known to work well with Hylafax - USR Courier, most Multitech and Zyxel models

    There is a (somewhat dated) list of recommended modems at

    http://www.vix.com/hylafax/modems.html

  5. OS Setup of Serial Ports
  6. HP uses a three device scheme to represent the serial ports

    • cuaXXX - direct
    • ttyXXX - dialin
    • culXXX - dialout

    if these devices are not already created for the mux they can be instantiated as follows

    	ioscan -C tty
    
    to find the address of the mux port then

    	ioscan -d  -fn
    
    shows the device files created, if they are missing they can be created with mksf

    ie     /usr/sbin/mksf -d mux2 -I 0 -a0 -p2 -i -v
              making cua0p2 c 193 0x000201             
           /usr/sbin/mksf -d mux2 -I 0 -a1 -p2 -v   
              making cul0p2 c 193 0x000201             
           /usr/sbin/mksf -d mux2 -I 0 -a2 -p2 -v   
             making ttyd0p2 c 193 0x000202    
    
    The lssf command can then be used to view the device setup

    For use with hylafax always choose the dialout or culXXXX device.

    For more details see 'Configuring HP-UX For Peripherals' chapter 3 (this is included on the HP10 Laserrom CD)

  7. Software Required
  8. As well as the binary are a number of other components required to get hylafax going.

    The additional parts are available from the Software Porting and Archive Centre for HP-UX run by the HP-UX users group.

    http://gatekeep.cs.utah.edu/
    There are many mirrors to this site.

    Whats Needed

    Note: If you already have other versions of this software on your machine ie an older version of ghostscript please consult the hylafax documentation about setting the corrrect parameters to use this.

  9. Installation
  10. Install zlib, libpng, gs, gs-fonts, libjpeg and tiffutils using swinstall, they will install largely to the /opt directory
    	ie swinstall -s /tmp/libpng0.96-sd-10.20.depot.gz
    
    install the hylafax using swinstall(and cross fingers ;-) )

  11. faxsetup
  12. Add /opt/hylafax/bin and /opt/hylafax/sbin to your path and run faxsetup

    • when it asks to run hfaxd from inetd.conf answer 'no'
    • when it asks for a modem device to add specify the /dev/culXXXX device file
    Perhaps also run faxaddmodem at a later time to add more modems

  13. startup script
  14. A startup script 'hylafax' is provided in the /sbin/init.d directory.

    Create links to automatically start and stop hylafax:

    	ie	ln -s /sbin/init.d/hylafax /sbin/rc2.d/S95fax
    		ln -s /sbin/init.d/hylafax /sbin/rc2.d/K95fax
    

  15. Start hylafax
  16. 	/sbin/init.d/hylafax start
    

  17. gettys
  18. Add appropriate lines to /etc/inittab

    	ie	a2a1:234:respawn:/opt/hylafax/sbin/faxgetty cul2a1
    
    and 'init q' to restart init, the modems lights should flash

    Type faxstat to view the modems available

  19. cron jobs
  20. From the superusers inittab run the following two processes
    	/opt/hylafax/sbin/faxqclean
    	/opt/hylafax/sbin/faxcron
    
    faxcron typically once per day, and faxqclean say every hour(or perhaps longer if you want to keep old successsfully sent faxes)

  21. Test
  22. Try to send a fax:
    	sendfax -d 12345678 mydoc
    
    If that works - Congratulations!!! - and happy faxing.


Any questions? - please email me - Robert Colquhoun at rjc@trump.net.au