How to install T38modem on Ubuntu 17.04

To install T38modem on Ubuntu 17.04

The T38modem is not a modem, it is a class 1 FAX modem pool with H.323 endpoint with T.38 FAX support. It is also considered to be a gateway between a fax application and an IP network. It also works with HylaFAX. This tutorial explains the installation procedure of T38modem on Ubuntu 17.04.

Installation procedure

To proceed with the installation, add the repo to the PPA by running the following command.

root@linuxhelp:~# add-apt-repository ppa:eugenesan/ppa
 This repository contains collection of customized, updated, ported and backported
packages for two last LTS releases and latest pre-LTS release.
Packages for older releases relocated to ppa:eugenesan/archive or deleted.

+-------------------------------------------------------------------------------------+
| Disclaimer:
+-------------------------------------------------------------------------------------+
* Packages in this a nd related PPAs are for personal use only.
  They developed specifically for several custom environments and may not work for you.
* Usage of packages in this PPA, in some forms, might contradict licenses of software
  packaged in this and related PPAs. End users and administrator are responsible for
  runtime licensing and possible legal consequences.
.
.
.
gpg: keybox ' /tmp/tmp_i5z4cmj/pubring.gpg'  created
gpg: /tmp/tmp_i5z4cmj/trustdb.gpg: trustdb created
gpg: key E61380B28313A596: public key " Launchpad synergy+"  imported
gpg: Total number processed: 1
gpg:               imported: 1
OK

The repositories are added successfully in the system. Update the target machine by running the apt-get update command.

root@linuxhelp:~# apt-get update 
Hit:1 http://in.archive.ubuntu.com/ubuntu zesty InRelease                   
Hit:2 http://in.archive.ubuntu.com/ubuntu zesty-updates InRelease              
Hit:3 http://security.ubuntu.com/ubuntu zesty-security InRelease               
Hit:4 http://in.archive.ubuntu.com/ubuntu zesty-backports InRelease            
Get:5 http://ppa.launchpad.net/eugenesan/ppa/ubuntu zesty InRelease [15.4 kB]  
Get:6 http://ppa.launchpad.net/eugenesan/ppa/ubuntu zesty/main i386 Packages [4,192 B]
Get:7 http://ppa.launchpad.net/eugenesan/ppa/ubuntu zesty/main amd64 Packages [4,192 B]
Get:8 http://ppa.launchpad.net/eugenesan/ppa/ubuntu zesty/main Translation-en [3,288 B]
Fetched 27.0 kB in 3s (8,335 B/s)
Reading package lists... Done

Now install the t38 modem application in the system by executing the following command.

root@linuxhelp:~# apt-get install t38modem
Reading package lists... Done
Building dependency tree       
Reading state information... Done
The following additional packages will be installed:
  libcapi20-3 libodbc1 libopal3.10.10 libpt2.10.11 libsdl1.2debian
Suggested packages:
  libmyodbc odbc-postgresql tdsodbc unixodbc-bin hylafax-server
The following NEW packages will be installed:
  libcapi20-3 libodbc1 libopal3.10.10 libpt2.10.11 libsdl1.2debian t38modem
0 upgraded, 6 newly installed, 0 to remove and 278 not upgraded.
Need to get 5,108 kB of archives.
After this operation, 25.7 MB of additional disk space will be used.
Do you want to continue? [Y/n] 
.
.
.
.
Unpacking libopal3.10.10 (3.10.10~dfsg2-2build1) ...
Selecting previously unselected package t38modem.
Preparing to unpack .../5-t38modem_2.0.0-4build3_amd64.deb ...
Unpacking t38modem (2.0.0-4build3) ...
Setting up libodbc1:amd64 (2.3.4-1) ...
Setting up libsdl1.2debian:amd64 (1.2.15+dfsg1-4) ...
Setting up libcapi20-3:amd64 (1:3.27-2) ...
Processing triggers for libc-bin (2.24-9ubuntu2) ...
Setting up libpt2.10.11 (2.10.11~dfsg-2.1) ...
Setting up libopal3.10.10 (3.10.10~dfsg2-2build1) ...
Setting up t38modem (2.0.0-4build3) ...
Processing triggers for libc-bin (2.24-9ubuntu2) ...

To use the T38modem application and to know more about the options and commands that can be used with the application, run the following command to view the options.

root@linuxhelp:~# t38modem --help
T38Modem Version 2.0.0
 (OPAL-3.10.10/3.10.10 (svn:29150), PTLIB-2.10.11/2.10.11 (svn:30295)) by Vyacheslav Frolov on Unix Linux (4.10.0-19-generic-x86_64)

2017/09/22 10:50:55.573                   T38Modem        Version 2.0.0 by Vyacheslav Frolov on Unix Linux (4.10.0-19-generic-x86_64) with PTLib (v2.10.11 (svn:30295)) at 2017/9/22 10:50:55.573
Usage:
  T38Modem [options]

Options:
  -t --trace                : Enable trace, use multiple times for more detail.
  -o --output file          : File for trace output, default is stderr.
     --save                 : Save arguments in configuration file and exit.
  -v --version              : Display version.
  -h --help                 : Display this help message.

Common options:
  --ports T:B-M[,...]       : For (T)ype set (B)ase and (M)ax ports to use.
                              T is ' udp' , ' rtp'  or ' tcp' . B and M are numbers.
  --route pat=dst[ option[=value][ ...]]
                            : Route the calls with incoming destination address
                              matching the regexp pat to the outgoing
                              destination address dst.
                              All ' < dn> '  meta-strings found in dst or in
                              following route options will be replaced by all
                              valid consecutive E.164 digits from the incoming
                              destination address. To strip N first digits use
                              ' < dn!N> '  meta-string.
                              If the specification is of the form @filename,
                              then the file is read with each line consisting
                              of a pat=dst[ ...] route specification.
  -u --username str         : Set the default username to str.
  --displayname str         : Set the default display name to str.
                              Can be overridden by route option
                                OPAL-Calling-Display-Name=str
  --stun server             : Set STUN server.
  --fake-audio [!]wildcard[,[!]...]
                            : Register the fake audio format(s) matching the
                              wildcard(s). The ' *'  character match any
                              substring. The leading ' !'  character indicates
                              a negative test.
                              May be used multiple times.

H.323 options:
  --no-h323                 : Disable H.323 protocol.
  --h323-audio str          : Use OPAL-Enable-Audio=str route option by
                              default. May be used multiple times.
  --h323-audio-list         : Display available audio formats.
  --h323-disable-t38-mode   : Use OPAL-Disable-T38-Mode=true route option by
                              default.
  --h323-t38-udptl-redundancy str
                            : Use OPAL-T38-UDPTL-Redundancy=str route option by
                              default.
  --h323-t38-udptl-keep-alive-interval ms
                            : Use OPAL-T38-UDPTL-Keep-Alive-Interval=ms route
                              option by default.
  -F --fastenable           : Enable fast start.
  -T --h245tunneldisable    : Disable H245 tunnelling.
  --h323-listen iface       : Interface/port(s) to listen for H.323 requests
                            : ' *'  is all interfaces, (default tcp$*:1720).
  --h323-no-listen          : Disable listen for incoming calls.
  -g --gatekeeper host      : Specify gatekeeper host.
  -n --no-gatekeeper        : Disable gatekeeper discovery.
  --require-gatekeeper      : Exit if gatekeeper discovery fails.
  --h323-bearer-capability str
                            : Use OPAL-Bearer-Capability=str route option by
                              default.

H.323 route options:
  OPAL-Enable-Audio=[!]wildcard[,[!]...]
    Enable the audio format(s) matching the wildcard(s). The ' *'  character
    match any substring. The leading ' !'  character indicates a negative test.
    Default: G.711-uLaw-64k,G.711-ALaw-64k.
  OPAL-Disable-T38-Mode={true|false}
    Enable or disable T.38 fax mode.
    Default: false (enable T.38 fax mode).
  OPAL-T38-UDPTL-Redundancy=[maxsize:redundancy[,maxsize:redundancy...]]
    Set error recovery redundancy for IFP packets dependent from their size.
    For example the string ' 2:I,9:L,32767:H'  (where I, L and H are numbers)
    sets redundancy for (I)ndication, (L)ow speed and (H)igh speed IFP packets.
    Default: empty string (no redundancy).
  OPAL-T38-UDPTL-Redundancy-Interval=ms
    Continuously resend last UDPTL packet each ms milliseconds on idle till it
    contains IFP packets not sent redundancy times.
    Default: 50.
  OPAL-T38-UDPTL-Keep-Alive-Interval=ms
    Continuously resend last UDPTL packet each ms milliseconds on idle.
    Default: 0 (no resend).
  OPAL-T38-UDPTL-Optimise-On-Retransmit={true|false}
    Optimize UDPTL packets on resending in accordance with required redundancy
    (exclude redundancy IFP packets sent redundancy times).
    Default: true (optimize).
  OPAL-Bearer-Capability=S:C:R:P
    Set bearer capability information element (Q.931) with
      S - coding standard (0-3)
      C - information transfer capability (0-31)
      R - information transfer rate (1-127)
      P - user information layer 1 protocol (2-5).

SIP options:
  --no-sip                  : Disable SIP protocol.
  --sip-audio str           : Use OPAL-Enable-Audio=str route option by
                              default. May be used multiple times.
  --sip-audio-list          : Display available audio formats.
  --sip-disable-t38-mode    : Use OPAL-Disable-T38-Mode=true route option by
                              default.
  --sip-t38-udptl-redundancy str
                            : Use OPAL-T38-UDPTL-Redundancy=str route option by
                              default.
  --sip-t38-udptl-keep-alive-interval ms
                            : Use OPAL-T38-UDPTL-Keep-Alive-Interval=ms route
                              option by default.
  --sip-proxy [user:[pwd]@]host
                            : Proxy information.
  --sip-register [user@]registrar[,pwd[,contact[,realm[,authID]]]]
                            : Registration information. Can be used multiple
                              times.
  --sip-listen iface        : Interface/port(s) to listen for SIP requests
                            : ' *'  is all interfaces (default tcp$*:5060 and
                            : udp$*:5060).
  --sip-no-listen           : Disable listen for incoming calls.

SIP route options:
  OPAL-Enable-Audio=[!]wildcard[,[!]...]
    Enable the audio format(s) matching the wildcard(s). The ' *'  character
    match any substring. The leading ' !'  character indicates a negative test.
    Default: G.711-uLaw-64k,G.711-ALaw-64k.
  OPAL-Disable-T38-Mode={true|false}
    Enable or disable T.38 fax mode.
    Default: false (enable T.38 fax mode).
  OPAL-T38-UDPTL-Redundancy=[maxsize:redundancy[,maxsize:redundancy...]]
    Set error recovery redundancy for IFP packets dependent from their size.
    For example the string ' 2:I,9:L,32767:H'  (where I, L and H are numbers)
    sets redundancy for (I)ndication, (L)ow speed and (H)igh speed IFP packets.
    Default: empty string (no redundancy).
  OPAL-T38-UDPTL-Redundancy-Interval=ms
    Continuously resend last UDPTL packet each ms milliseconds on idle till it
    contains IFP packets not sent redundancy times.
    Default: 50.
  OPAL-T38-UDPTL-Keep-Alive-Interval=ms
    Continuously resend last UDPTL packet each ms milliseconds on idle.
    Default: 0 (no resend).
  OPAL-T38-UDPTL-Optimise-On-Retransmit={true|false}
    Optimize UDPTL packets on resending in accordance with required redundancy
    (exclude redundancy IFP packets sent redundancy times).
    Default: true (optimize).

Modem options:
  --no-modem                : Disable MODEM protocol.
  -p --ptty [num@]tty[,...] : Pseudo ttys. Can be used multiple times.
                              If tty prefixed by num@ then tty will
                              accept incoming calls only
                              for numbers with prefix num.
                              Use none@tty to disable incoming calls.
                              See Modem drivers section for tty format.
  --force-fax-mode          : Use OPAL-Force-Fax-Mode=true route option by
                              default.
  --no-force-t38-mode       : Use OPAL-No-Force-T38-Mode=true route option by
                              default.
Modem route options:
  OPAL-Set-Up-Phase-Timeout=secs
    Set timeout for outgoing call Set-Up phase to secs seconds.
  OPAL-Try-Next=dst
    Set alternate incoming destination address for outgoing calls to dst. This
    address will be used to re-route if outgoing call Set-Up phase fails.
  OPAL-Force-Fax-Mode={true|false}
    Enable or disable forcing fax mode (T.38 or G.711 pass-trough).
  OPAL-No-Force-T38-Mode={true|false}
    Not enable or not disable forcing T.38 mode.
Modem drivers:
  PTY
    Uses pseudo-tty (pty) devices to communicate with a fax application.
    For Unix98 ptys the tty should match to the regexp
      ' ^+.+$' 
    (the first character ' +'  will be replaced by a base directory).
    Options:
      --pts-dir dir         : Set a base directory for Unix98 scheme,
                              default is empty.

The installation procedure of t38modem on Ubuntu 17.04 is done without any glitches.