AnT 4.669 (Release 4a) Installation guide

— Compiling and linking the AnT 4.669 software package —

This document covers building and installing the graphical user interface AnT-gui and the AnT computation engine AnT on UNIX and UNIX-like systems such as Linux. Compiling and linking on Microsoft Windows platforms is different and more difficult, because the tools required by the build mechanism aren't included with the operating system. Therefore we provided binaries for this platforms which you may install without any compiling and linking.

The source package of the AnT 4.669 software is distributed as tar.gz file, containing all the neccessary files for the build process. You can unpack these files into a directory using the GNU tar utility as follows:

      tar -xvzf AnT-core-4.669-R4.1.x_src.tar.gz

In the toplevel directory AnT-core-4.669-R4a_src that is created, there will be a shell script called configure which you then run to take the template makefiles called Makefile.in in the package and create makefiles customized for your operating system. The configure script can be passed several command line arguments to determine how the package is built and installed. The most important argument is the --prefix argument, which determines in which directory the package will be installed in. For instance, to install the AnT 4.669 software package in the directory $HOME/local, you would run configure as:

      ./configure --prefix=$HOME/local

A full list of options can be found by running configure with the --help argument. In general, the defaults are right and should not be changed.

The default value for the --prefix argument is /usr/local, hence running the configure script without any command line arguments requires root privileges.

After you've run configure, you then run the GNU make command to build the package and install it.

      make
      make install

If you don't have permission to write into the directory you are installing in (for instance /usr/local as an ordinary user), you may have to change to root temporarily before running make install or you have to run configure again giving the --prefix argument a directory where you have write permission.

After you've succesfully installed the AnT 4.669 software package on your system, please make sure that the environment variable PATH contains the directory where the binaries AnT-gui and AnT are installed in. For instance, if you installed the AnT 4.669 software package in the directory /home/user/AnT by running the configure as mentioned above, then you have to set your environment variable PATH as follows:

      export PATH="$HOME/local/bin:$PATH" (bash)
      setenv PATH "$HOME/local/bin:$PATH" (csh, tcsh)

After you've done all the steps above you should be able to run the graphical user interface AnT-gui. and the AnT computation engine AnT If you run AnT-gui, the main window of the graphical user interface should appear on your screen and if you run AnT with the --help argument, you should see the following output in your window:


--//------------/-------------------------------
// AnT 4.669 / Release 4a, (c) 1999-2008
//------------/---------------------------------

usage: AnT <systemname> [{-i | -I | --initialization} <configfile>] [{-m | -M | --mode} <runmode>] [{-s | -S | --server} <server name>] [{-p | -P | --port} <portnumber>] [{-n | -N | --points} <scanpoints>] [{-t | -T | --time} <seconds>] [{-v | -V | --version}] [{-v | -V | --log}] [{-h | -H | --help}]

    complete path and filename (without extension)
    of the shared library containing at least the system
    function for the dynamical system to be simulated.

Options:
{-i | -I | --initialization} <initialization file>
    complete path and filename of the initialization file
{-m | -M | --mode} <runmode>
    where runmode is one of 'standalone',
    'server' or 'client'. Default is 'standalone'.
{-s | -S | --server} <server name>
    for runmodes 'server' and 'client' only.
    Default is the standard hostname of the current system.
{-p | -P | --port} <portnumber>
    for runmodes 'server' and 'client' only.
    The default port is 12345.
{-n | -N | --points} <scanpoints>
    for runmode 'client' only.
    The number of scanpoints the client
    should fetch from the server. Default is 50.
{-t | -T | --time} <seconds>
    for runmode 'client' only. The (approximate) number
    of seconds the client should be busy before asking
    for new scan points from the server.
    This option overrides the '-n' option.
{-v | -V | --version}
{-l | -L | --log} write the log-file 'transitions.log'
    which shows the internal structure of the current
    simulator instantiation.
{-h | -H | --help}
UP
Last modified: 2008-02-04    Contact: AnT