tesserNet Software Requirements and Installation for Linux

*Installing
*Requirements
*Installation
*Compiling and Linking Applications

Installing

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.

Requirements

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

[note]

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

Installation

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

/opt/tesserNet/bin

contains the executable binaries

/opt/tesserNet/lib

contains both archive and shared libraries

/opt/tesserNet/etc

contains miscellaneous files, including the newconfig directory

/opt/tesserNet/etc/RtapPtTemplates

contains RTAP/Plus point configuration files

/opt/tesserNet/include

contains include files

/opt/tesserNet/src

contains source files

/opt/tesserNet/Builder

contains database builder files

/opt/tesserNet/man/man1

contains unformatted man pages for executables

/opt/tesserNet/man/man3

contains unformatted man pages for library routines

/opt/tesserNet/doc/pdf/Letter

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

/opt/tesserNet/doc/pdf/A4

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

 

[note]

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>

Where:

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

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

-lm