TAPENADE training session's guide

The TAPENADE training session requires a Linux or a MacOS-X computer. It should have an up-to-date distribution of the system.

Windows environment are not supported, unless you are a Windows guru developper. We do not provide any help for Windows users.

We assume you are familiar with the Linux or MacOS development environment for compiling Fortran and C programs. The training session requires the following tools : a terminal window, gcc, gfortran, ghostview (optional), make, java, tapenade.

We describe here all the steps and tools that are needed to use TAPENADE. All these steps require an UNIX terminal and a basic knowledge of an Unix shell such as bash. To open an UNIX terminal window, click on the "Terminal" icon from the Applications menu or toolbar. The location of the icon depends on your environment. An UNIX Terminal window will then appear with a % prompt, waiting for you to start entering commands.

Verify you have all the needed commands :
% gcc --version % gfortran --version % ghostview --version % make --version

If some of these commands are not found, install them on your computer.

Installing Java Runtime Environment

You must check that an up-to-date Java Runtime Environment is installed using the following command :
% java -version

You should get something like :
java version "1.8.0_05"

If your Java Environment is not up-to-date, you can download and install the latest Java Runtime Environment (Java SE 8) from the java.sun.com site or from the Apple site.

Installing TAPENADE

Fill in the questionnaire for academic usage : http://www-sop.inria.fr/tropics/tapenade/downloading.html

Read the TAPENADE license and download tapenade3.9.tar into your chosen installation directory "install_dir"

Go to your chosen installation directory "install_dir", and extract TAPENADE from the tar file :
% tar xvfz tapenade3.9.tar

Add the following shell variable into your shell environment :
% TAPENADE_HOME="install_dir"/tapenade3.9

Moreover on Linux, depending on your distribution, TAPENADE may require you to set the shell variable JAVA_HOME to your java installation directory. It is often :
% JAVA_HOME=/usr/java/default.

For more information on the tapenade command and its arguments, type :
% $TAPENADE_HOME/bin/tapenade -?

You may add the tapenade command in your PATH environment by using :
% PATH=$TAPENADE_HOME/bin/:$PATH

Test your installation with the following command :
% $TAPENADE_HOME/bin/tapenade -version

If nothing works when calling TAPENADE

Check your JAVA_HOME and TAPENADE_HOME shell variables :
% echo $JAVA_HOME % echo $TAPENADE_HOME

You may get "kernel too old" error message if your Linux distribution is not up-to-date. Reinstall a newer Linux distribution on your computer.

You may get "java.lang.UnsupportedClassVersionError" error message if your Java Environment is not up-to-date. Reinstall a newer Java Environment.

tapenade@inria.fr

Last modified: Mon May 26 15:40:00 CEST 2014