tesserNet Software Requirements and Installation for Linux

*Compiling and Linking Applications


Installing software provided by tesserNet Systems Inc. involves these steps:

* Check that your system meets the necessary requirements (see section Requirements).
* Install licensing software. Download and install the licensing rpm (TN-LIC-1.1-0.i386.rpm) to provide necessary licensing files. This package only needs to be installed once for each machine that requires tesserNet products.
* Install software.


Before you begin, make sure your system has the following software already installed:

* RedHat Enterprise Linux operating system version 5.x.
* RTAP/Plus version 8.8 or greater.
* Open Motif 2.3 runtime environment (required only for Motif applications).
* X11R6 runtime environment (required only for Motif applications).


Any programming using the tesserNet programming libraries will require the GNU C++ compiler software to be installed.


Run rpm to install the software:

* to install for the first time:
rpm -ivh rpm_software.rpm
* to freshen (update) an already installed software package:
rpm -Fvh rpm_software.rpm

Use the --prefix command line option to rpm to specify a different root directory to install to. The default is to install to /opt/tesserNet.


The installation procedure may add files to the following directories:


Directory Description


contains the executable binaries


contains both archive and shared libraries


contains miscellaneous files, including the newconfig directory


contains RTAP/Plus point configuration files


contains include files


contains source files


contains database builder files


contains unformatted man pages for executables


contains unformatted man pages for library routines


contains on-line help files in PDF format (formatted for Letter paper size)


contains on-line help files in PDF format (formatted for A4 paper size)



If you are upgrading from a previous version, you will need to re-compile any applications you may have written using tesserNet's programming filesets.

Compiling and Linking Applications

To compile and link applications that use the tesserNet Systems Inc. libraries, the programming environment rpm must be installed.

In order to find the include files, you must provide the -I/opt/tesserNet/include option to the compiler.

In order to link in the library files, you must provide the -L/opt/tesserNet/lib option to the compiler. Link the following libraries in the following order:

For non-exception C++ applications:

-lCRtap -lCBase <RTAP/Plus libraries> <system libraries>

For exception C++ applications:

-lCRtapExcep -lCBaseExcep <RTAP/Plus libraries> <system libraries>


<RTAP/Plus libraries> = -lrtapPlus -lrtap -lrtapLic -lcrTools

<system libraries> = -lXm -lXt -lX11 (if linking a Motif application)