#language en

= Matlab =

Matlab is installed on s15 and on wombat.
Fairly recent sources to install matlab on your desktop computer are usually located under
[https://s15.fluid.tuwien.ac.at/E322/Software/Matlab s15.fluid.tuwien.ac.at/home/E322/Software/Matlab].

== Installation under Linux / MacOS ==

Matlab can be installed by mounting the folder /home/E322/Software/Matlab/Linux/R202??/ to
the local machine.
{{{
sudo mkdir /mnt/s15
sudo mount.davfs "https://s15.fluid.tuwien.ac.at/E322/Software/Matlab/Linux/R2024b" /mnt/s15
# you will be asked for username and password on s15
}}}
Alternatively, copy the entire `Direct_Install` folder or the archive `lux.tar` and the files
`Read_TU.txt`, `network.lic` and `installer_input.txt` to your local machine.

Two informations are necessary for installation,
 * the File Installation Key, which is given in the file `Read_TU.txt` (it consists entirely of only ascii-characters), and
 * the path to the network license file `network.lic`, e.g., `/home/E322/Software/Matlab/Linux/R2024b/network.lic`.
Navigate to the Direct_Install folder and, if a graphical user interface
is available, execute `./install`.[[BR]]
You will be asked for your choices.
Usually, the matlab files will be installed below `/usr/share/MATLAB/R20??/`.
At the end of the installation, the symbolic links
`deploytool` `matlab` `mbuild` `mcc` and `mex` will be created in
`/usr/local/bin`.
The symbolic link `mcc` may belong to matlab or to mathematica.
By default, all toolboxes and the entire Simulink program is installed.
To save space, unselect unneeded components.

Alternatively, for a silent installation or a graphical user interface is not available,
copy the file `Direct_Install/installer_input.txt` to a location of your choice and
edit it appropriately.
An example is given on s15 in `/usr/local/share/MATLAB/R2024b/installer_input.txt`.
Symbolic links to the binaries in `/usr/local/share/MATLAB/R20??/bin/` must be created manually.

=== Installation on s15 ===

{{{
# choose the location to install matlab to
mkdir -p /usr/local/share/matlab/R2024b

# create an installer file
mkdir /tmp/m
cd /home/E322/Software/Matlab/Linux/R2024b
# embed the file installation key given in Read_TU.txt
key=`sed -n '/֎ / { s///; p; }' Read_TU.txt`
sed "/^# fileInstallationKey/ { s/^# //; s/$/$key/; }"	\
	Direct_Install/installer_input.txt >/tmp/m/installer_input.txt
cd /tmp/m
# check differences to the previous installation, adapt installation path, choose toolboxes
vimdiff /usr/local/share/MATLAB/R2022a/installer_input.txt installer_input.txt

# Install, as root
su -
/home/E322/Software/Matlab/Linux/R2024b/Direct_Install/install -inputfile installer_input.txt
mv -i installer_input.txt /usr/local/share/MATLAB/R2024b/

# Add links to binaries
cd /usr/local/bin
# move out old binaries, log whether they are used
for f in deploytool matlab mcc mex
    do mv -i $f /usr/local/libexec/22$f
    ln -s ../libexec/count 22$f
done
# add links to new binaries
for f in deploytool matlab mcc mex
    do ln -s /usr/local/share/MATLAB/R2024b/bin/$f .
done

# clean up.
rm -r /tmp/mathworks_*
exit
}}}

== Deinstallation ==

Remove the installation directory, e.g, `/usr/local/share/MATLAB/R20??`
and the symbolic links `deploytool` `matlab` `mbuild` `mcc` and `mex` in `/usr/local/bin`.