Home    Search    Up    Reference Manuals    Return   

Gensys-2601

Installation of Gensys on a computer running on a Debian Linux based operating system. The installation file is written in deb-format.

Only the necessary steps in the below list needs to be done:
1) Can be skipped if all extra packages already are installed.
2) Can be skipped if you don't want to update the documentation and the verification examples.


TOC:

  1. Installation of extra packages
  2. Download and uncompress the documentation and the verification examples
  3. Download and install gensys from a deb-file
  4. Set search path and other initilization files
  5. Install the license file
  6. Install CONTACT v23.2.
  7. After the installation

1) Installation of extra packages

Gensys relies on a number of packages that normally are not installed be default. Please, install these packages before installing the Gensys deb-file.

To refresh the list of available packages. Open a terminal window and give the following command

sudo  apt-get update

To install the extra packages needed by Gensys. Open a terminal window and give the following command:

sudo apt-get install \
  apt-file                     \
  at                           \
  eom                          \
  evince                       \
  ffmpeg                       \
  gimp                         \
  git gitk                     \
  imagemagick                  \
  lftp                         \
  megatools                    \
  meld                         \
  octave                       \
  octave-signal                \
  octave-sockets               \
  octave-statistics            \
  gnuplot                      \
  gnuplot-x11                  \
  openssh-server               \
  openssh-client               \
  p7zip-full                   \
  pcregrep                     \
  samba                        \
  slurm-wlm munge sview        \
  tcl tk                       \
  xclip                        \
  xdotool

If you want to do development work. Please also install the following packages:

sudo apt-get install \
  gcc-14                       \
  g++-14                       \
  gfortran-14                  \
  gfortran-doc                 \
  cmake                        \
  libreadline-dev              \
  libncurses5-dev              \
  libxpm-dev                   \
  libxmu-dev                   \
  libxext-dev                  \
  libgl1-mesa-dev              \
  libglu1-mesa-dev             \
  libpcre3-dev                 \
  libvte-2.91-dev              \
  libgtk-3-dev                 \
  libgtk2.0-dev                \
  libfm-dev                    \
  libfm-gtk-dev                \
  libvte-dev                   \
  libstartup-notification0-dev \
  libgamin-dev                 \
  intltool                     \
  gamin                        \
  python3-pip                  \
  texlive                     

An explanation what the above packages do:

tcl A high-level, general-purpose programming language.
tk Toolkit for Tcl and X11

Packages that are convenient, but not necessary:

apt-file An APT package searching utility
eom Eye of mate. View image files: jpeg, bmp, png, etc.
evince View pdf-files.
ffmpeg Create videos
gimp Gnu Image Manipulation Program
imagemagick A free open-source sortware suite for the creation, modification and display of bitmap images.
meld A graphical diff viewer and merge application
pcregrep Perl-compatible regexp.
xdotool Lets you programmatically (or manually) simulate keyboard input and mouse activity, move and resize windows, etc. E.g. "xdotool getmouselocation --shell" gives mouse position.
xclip Command line interface to X selections (cc=pipe output from terminal to clipboard).

GNU Octave language for co-simulations, numerical computations, plotting,,, etc.:

octave The main package.
octave-signal Signal processing functions for Octave.
octave-sockets Communication through Internet sockets. To enable Co-simulations and Hardware-in-the-loop simulations.
octave-statistics Additional statistical functions for Octave.
gnuplot An interactive plotting program.
gnuplot-x11 A sub-package to gnuplot which generates X11-output.

Communication:

openssh-server SSH server, for secure access from remote machines.
openssh-client SSH client, for secure access to remote machines.
lftp Sophisticated command-line FTP/HTTP/BitTorrent client program.
filezilla Full-featured graphical FTP/FTPS/SFTP client with GUI.
samba Mounting and mapping shares between Windows and Linux.
megatools Command-line client for the Mega cloud storage service.
git A distributed revision control system.
gitk A tcl/tk revision tree visualizer.

Queue systems:

at Execute commands when system load levels permit.

SLURM workload manager

munge MUNGE credential encoder.
slurm-wlm Slurm Workload Manager.
sview Graphical user interface to view and modify Slurm state.

Programming tools: (only necessary if you want to write own source code)

gcc-14 C-compiler
g++-14 C++-compiler
gfortran-14 Fortran-compiler
gfortran-doc Fortran documentation
cmake A free and open-source software for build automation, testing, packaging and installation of software by using a compiler-independent method
libreadline-dev Development libraries.
libncurses5-dev   – "
libxpm-dev   – "
libxmu-dev   – "
libxext-dev   – "
libgl1-mesa-dev   – "
libglu1-mesa-dev   – "
libpcre3-dev   – "
libvte-2.91-dev   – "
libgtk-3-dev   – "
libgtk2.0-dev   – "
libfm-dev   – "
libfm-gtk-dev   – "
libvte-dev   – "
libstartup-notification0-dev   – "
libgamin-dev   – "
intltool Automatically extracts translatable strings from oaf, glade, bonobo ui, nautilus theme and other XML files into the po files.
gamin File and directory monitoring system
python3-pip The Python package installer
texlive The TeX Live software distribution offers the complete TeX system.

2) Download and uncompress the documentation and the verification examples


N.B. In this step you will create the following three directories: free_models, homepage and verif. Old versions of these directories must first be removed or renamed before you can proceed.

3) Download and install gensys from a deb-file

Gensys is now installed in directory "/opt/gensys/gensys-2601"


4) Set search path and other initilization files

Download the setup files:
gensys-2601_setup_files.sh
gensys-2601_setup_files.tgz
Move the two files to your home directory.

Make sure file gensys-2601_setup_files.sh has execute permissions:

chmod +x gensys-2601_setup_files.sh

Then launch script ./gensys-2601_setup_files.sh:

./gensys-2601_setup_files.sh

Log out an in again, to make the changes to take effect.
You should now be able to launch genfile-gtk, genfile and genterm, by double clicking on the Gensys icons in the background menu.

If the programs don't starts when you are double clicking on the icons. Please check the value of environment variable $gensys by writing:

echo $gensys
The search path to the three programs can be checked with the following commands

If the programs don't starts when you are double clicking on the icons. Please check the value of environment variable $gensys by writing:

type genfile-gtk
type genfile
type genterm


5) Install the license file


6) Install the shared objects for CONTACT


In order to use CONTACT for calculating the wheel/rail-forces, do the following steps:


7) After the installation

The installation is now finished. Please test your installation by running the tutorial examples: ../../tutorial/README.html