Linux Install: Difference between revisions

Browse history interactively

← Older edit

Content deleted Content added

VisualWikitext

Revision as of 17:23, 27 March 2026 view source Tor.veimo (talk \| contribs) Bureaucrats, Administrators 5 edits mNo edit summary Tag: Visual edit: Switched ← Older edit		Latest revision as of 13:19, 30 March 2026 view source Tor.veimo (talk \| contribs) Bureaucrats, Administrators 5 edits m Grammar Tag: Visual edit
(6 intermediate revisions by 2 users not shown)
Line 1: == Introduction == TUFLOW is installed on Linux using the <code>.rpm</code> and <code>.deb</code> installer packages, which can be [https://www.tuflow.com/downloads/#tuflow downloaded here]. There's also a tar.gz archive available from the same location, which can beserve ~~downloaded~~as ~~from~~a portable application, similar to the ~~same~~.zip ~~location~~archive available for Windows. The installers have been tested on Rocky Linux 9 and Ubuntu 22.04, but should work on other modern Red Hat and Debian distributions. == Codemeter Configuration == To ~~license~~provide licenses to TUFLOW on Linux install and configure the CodeMeter User Runtime Package for Linux (.rpm or .deb options are available) https://www.wibu.com/support/user/user-software.html. * If using a hardware based usb dongle (either network or local licenses) please follow the instructions within [[Installing_Wibu_CodeMeter_Linux \| Installing Wibu Codemeter Linux]]. Line 13: TUFLOW uses a year.minor.patch versioning convention as follows. * The year corresponds to the major version number e.g. 2026.0.0. Major releases are the only releases that will admit the possibility of breaking changes, ~~(changing~~which are changes in defaults or features that may change model results between versions). There is one major release per year * Minor releases contain new features and bug fixes, but no breaking changes and increment the minor version number, e.g. 2026.1.0 Line 19: == RPM Install == <olul> <li> Download the <code>.rpm</code> for the specific TUFLOW build from https://www.tuflow.com/downloads/#tuflow <li> Save the <code>.rpm</code> locally. A common location is the home folder for the current user <code>~/</code> <li> Run the preferred installation command. For example, if installing the TUFLOW 2026.0.0 release:<~~/li~~syntaxhighlight lang="bash"> sudo ~~rpm~~dnf ~~-ivh~~install ~/tuflow-2026.0-2026.0.0-1.~~x86_64~~x86_x64.rpm </syntaxhighlight></li></ul> or <olul>▼ ~~sudo yum install ~/tuflow-2026.0-2026.0.0-1.x86_64.rpm.~~ <li>This installs a version-specific copy of the TUFLOW binaries and libraries under <code>/opt/tuflow/<version>/bin</code> and <code>/opt/tuflow/<version>/lib</code>. ~~The~~A symbolic link to the executable is ~~symlinked~~created in to <code>/usr/bin</code>, allowing the required version to be run ~~directly~~with ~~from~~a ~~the~~versioned ~~command~~shortcut, ~~line~~e.g. <code>tuflow-2026.0-isp</code>.▼ ~~</ol>~~ <li>There is also a launcher script in <code>/opt/tuflow/tuflow-<version>/bin/tuflow-<version>-idp.sh</code> for use cases where some environment variables needs to be set before execution. If you need to edit these, we recommend copying these into <code>/usr/local/bin</code>, as they will be overwritten if a patch release is installed.▼ ▲<ol> <li>To uninstall run the preferred uninstaller command. For example:<~~/li~~syntaxhighlight lang="bash">▼ ▲<li>This installs a version-specific copy of the TUFLOW binaries and libraries under <code>/opt/tuflow/<version>/bin</code> and <code>/opt/tuflow/<version>/lib</code>. The executable is symlinked to <code>/usr/bin</code>, allowing the required version to be run directly from the command line. sudo ~~yum~~dnf remove tuflow-2026.0~~-2026.0.0-1.x86_64~~▼ ▲<li>There is also a launcher script in <code>/opt/tuflow/tuflow-<version>/bin/tuflow-<version>-idp.sh</code> for use cases where some environment variables needs to be set before execution. If you need to edit these, we recommend copying these into /usr/local/bin, as they will be overwritten if a patch release is installed. </olsyntaxhighlight></li><li>To return a list of previously installed versions and review the correct uninstall version use <code>dnf list installed</code>'', or <code>dnf list installed 'tuflow*'</code>''</li></ul>''Note: Major and minor releases are installed with a new directory under <code>/opt/tuflow</code>. For example, TUFLOW 2026.0.0 is installed under <code>/opt/tuflow/tuflow-2026.0</code>. Patch releases overwrite the existing installation that shares the same major and minor release number. For example, TUFLOW 2026.0.1 will update 2026.0.0 if present.'' ▼ ▲<li>To uninstall run the preferred uninstaller command. For example:</li> ~~sudo rpm -e tuflow-2026.0-2026.0.0-1.x86_64~~ or ▲ sudo yum remove tuflow-2026.0-2026.0.0-1.x86_64 ~~To return a list of previously installed versions and review the correct uninstall version run:~~ ~~rpm -qa \| grep tuflow~~ or ~~yum list installed \| grep tuflow~~ ▲</ol>''Note: Major and minor releases are installed with a new directory under <code>/opt/tuflow</code>. For example, TUFLOW 2026.0.0 is installed under <code>/opt/tuflow/tuflow-2026.0</code>. Patch releases overwrite the existing installation that shares the same major and minor release number. For example, TUFLOW 2026.0.1 will update 2026.0.0 if present.'' == DEB Install == Line 44 ⟶ 36: To install: sudo apt~~-get~~ install ./tuflow-2026.0_2026.0.0-1_amd64.deb To uninstall: Line 52 ⟶ 44: ''Note: Major and minor releases are installed with a new directory under <code>/opt/tuflow</code>. For example, TUFLOW 2026.0.0 is installed under <code>/opt/tuflow/tuflow-2026.0</code>. Patch releases overwrite the existing installation that shares the same major and minor release number. For example, TUFLOW 2026.0.1 will update 2026.0.0 if present.'' == <span>Notes ~~For~~for Running ~~Linux~~TUFLOW Under WSL</span> == If you are running a Linux installation with Microsoft Windows under WSL (Windows Subsystem for Linux), things should run as expected. If you want to use NVIDIA hardware with CUDA support with TUFLOW under WSL, you need to add the correct folder to the LD_LIBRARY_PATH environment variable, so that TUFLOW can find the correct CUDA shared libraries that ~~works~~work in WSL: export LD_LIBRARY_PATH=/usr/lib/wsl/lib:$LD_LIBRARY_PATH In that folder there's a utility <code>/usr/lib/wsl/lib/nvidia-smi</code> which will indicate if the Linux installation can connect to the NVIDIA hardware otherwise managed by the Microsoft Windows driver. == Running A Model ==▼ For either Linux distribution TUFLOW can be run by calling <code>tuflow-2026.0-isp</code> (replace with the required version and precision) or by passing it a configuration file name:▼ ▲== Running Aa Model == ▲For either Linux distribution TUFLOW can be run by calling <code>tuflow-2026.0-isp</code> (~~replace~~this ~~with~~example would the ~~required~~currently installed patch for version 2026.0 and single precision) orand by passing it a configuration file name:<syntaxhighlight lang="bash"> tuflow-2026.0-isp my_run.tcf </syntaxhighlight>Model-specific commands such as the <code>export OMP_NUM_THREADS</code> environment variable can either be added via the command line, or in your own custom run script that calls the configuration file name, for example ''<code>run_model.sh</code>'':<syntaxhighlight lang="bash">▼ #!/bin/bash ▲Model-specific commands such as the <code>export OMP_NUM_THREADS</code> environment variable can either be added via the command line, or in your own custom run script that calls the configuration file name, for example run_model.sh: export OMP_NUM_THREADS=8 ▼ ~~<nowiki>#</nowiki>!/bin/bash~~ ▲export OMP_NUM_THREADS=8 tuflow-2026.0-idp my_run.tfc </syntaxhighlight>Once saved the script ~~'run_model.sh'~~ will need to be configured to run as an executable as follows:<syntaxhighlight lang="bash"> chmod +x run_model.sh </syntaxhighlight> == Notes on ULIMIT == The stack size limit is set to the highest allowed limit specified in the shell that TUFLOW is run in (usually unlimited). Thus it's no longer necessary to set the limit in a launcher shell script. This behaviour can be disabled by passing the <code>-nua</code> command line flag, causing TUFLOW to revert to the old behaviour. == Return Toto Home Page == Return to [[Main_Page \| Wiki Home Page]].