News Rel.2401

Gensys-2401

Installation of extra packages

Before the installation of extra packages. Fetch the latest version of the package list, by running this command:

sudo  apt-get update

In a standard installation, only the most common packages will follow. However, Gensys needs some extra packages in order to work well. These packages can be installed with 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-10                       \
  g++-10                       \
  gfortran-10                  \
  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).

Packages that require configurations:

unison	A file-synchronization tool
unison-gtk	A GUI-tool for unison.

After installation of unison write the following in a terminal:

mkdir ~/.unison
echo "
# Unison preferences file

perms=0
merge= Name * -> meld CURRENT1 CURRENT2
#iff = /usr/bin/meld CURRENT1 CURRENT2
diff = opdiff CURRENT1 CURRENT2
confirmmerge= true

ignore= Name *~

ignore= Path .unison" > ~/.unison/default.prf

GNU Octave language for numerical computations (mostly MATLAB compatible):

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-12	C-compiler
g++-12	C++-compiler
gfortran-12	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.

Download and install gensys from a deb-file

Download the deb-file:
Depending your C library version, you must chose the deb-file that fits to your system. To see your C library version, please write:
ldd --version

Curently there is only one deb-file to choose, and this version is compiled for C library version 2.35 gensys-2401_240221_2.35_amd64.deb
(If you have problems with downloading the file. Please check the following:
- Make sure that no firewall prevents you from downloading files from the Internet.
- Try different web-browsers, including modern versions of Firefox and Chrome.)

If the file has been successfully downloaded:
The size of the deb-files should be:

 Bytes:         File:          
 69339088       gensys-2401_240221_2.35_amd64.deb

The sha256sum message digest of the deb-files should be:

sha256sum *.deb                 
b48fa4bdd9db8f6ef3a44188cae413b53d894952404adfe2358163c349878fc0  gensys-2401_240221_2.35_amd64.deb

Unpack the deb-files with command:
```
sudo gdebi gensys-2401_240221_2.35_amd64.deb 2>&1 | tee -a /tmp/gdebi.out
```
Gensys is now installed in directory "/opt/gensys/gensys-2401"

Set search path and other initilization files

Download the setup files:
gensys_setup_files.sh
gensys_setup_files.tgz
Move the two files to your home directory.

Make sure file gensys_setup_files.sh has execute permissions:

chmod +x gensys_setup_files.sh

Then launch script ./gensys_setup_files.sh:

./gensys_setup_files.sh

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

Install the license file

Start a webbrowser (Preferable firefox, because not all webbrowsers permitts downloading files from the Internet)
Enter the link you have got from info@gensys.se
Download the file to your HOME-directory.

Start a terminal and write the following five commands:

Rename the old license file:

sudo mv $gensys/bin/gen_processor_ID_check $gensys/bin/gen_processor_ID_check.$(datum)

Go to your HOME directory:

cd $HOME

Move the new license file to $gensys/bin:

sudo mv gen_processor_ID_check $gensys/bin

Add execute permissions to the license file:

sudo chmod +x $gensys/bin/gen_processor_ID_check

Test the new license file:

gen_processor_ID_check

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. If you have old versions of these directories, they will be overritten.
If you want to keep your old versions of free_models, homepage and verif, you can skip this part. Alternatively you can uncompress these files in another directory, and compare them with your old existing directories using script opdiff_dir.

Create a directory where you want to keep Gensys documentation files and verification examples. E.g.; "~/gensys"
In the newly created work directory. Also create a directory where you want to keep your own work files.
E.g.: "~/gensys/analyse"

In directory "~/gensys" download the following files:

free_models-2401.7z    = Free vehicle models
homepage-2401.7z       = Documentation and tutorials
verif-2401.7z          = Verification directory

Webpage mega.nz requires a webbrowser that handles HTML5 and allows JavaScript to create and write to files. Currently Chrome and Firefox works best.
Also make sure that no firewall prevents you from downloading files from the Internet.

The SHA256 message digest algorithm should give you the following output:

bbab303b5850ecc14ddfbbef7290ffbdce860c4dcd470dedcbeef9eff7c1e179  free_models-2401.7z
1a7e37843763b732ad8ba7fc29a69fdf62df4f1cba32f7bd25e8c50b6f6fb07d  homepage-2401.7z
47d96ec4b9043078d6ecd24228e72872fd878cbd71e5227941712244165b6234  verif-2401.7z

The above output can be created with the following commands:

UNIX:	sha256sum [a-z]*7z
Windows:	certutil.exe -hashfile free_models-2301.7z SHA256 certutil.exe -hashfile homepage-2301.7z SHA256 certutil.exe -hashfile verif-2301.7z SHA256

Move the downloaded files to the location which you created under item 1 above.
Uncompress the files with program "7z" with the following commands:
```
7z x free_models-2301.7z
7z x homepage-2301.7z
7z x verif-2301.7z
```
Program "7z" can be found in package "p7zip-full".
File ~/.profile_gensys defines two environment variables: $genhomepage and $genverif.
Environment variable $genhomepage shall point to the location where the Gensys documentation "homepage" is located.
Environment variable $genverif shall point to the location where the verification examples "verif" are located.
The directory free_models can be stored anywhere. Use this directory to copy examples from.
The three files free_models-2301.7z, homepage-2301.7z and verif-2301.7z can now be removed.