Linux Install

From Tuflow
Revision as of 17:10, 27 March 2026 by Tor.veimo (talk | contribs) (Installation instructions for TUFLOW on Linux)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Introduction

TUFLOW is installed on Linux using the .rpm and .deb installer packages, which can be downloaded here. There's also a tar.gz archive which can be downloaded from the same location.

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 TUFLOW on Linux install and configure CodeMeter User Runtime Package for Linux (.rpm or .deb options are available) https://www.wibu.com/support/user/user-software.html.

TUFLOW Versioning

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 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
  • Patch releases are bug fixes only and increment the patch version number, e.g. 2026.0.1

RPM Install

  1. Download the .rpm for the specific TUFLOW build from https://www.tuflow.com/downloads/#tuflow
  2. Save the .rpm locally. A common location is the home folder for the current user ~/
  3. Run the preferred installation command. For example, if installing the TUFLOW 2026.0.0 release:
    4. sudo rpm -ivh ~/tuflow-2026.0-2026.0.0-1.x86_64.rpm or sudo yum install ~/tuflow-2026.0-2026.0.0-1.x86_64.rpm.
  1. This installs a version-specific copy of the TUFLOW binaries and libraries under /opt/tuflow/<version>/bin and /opt/tuflow/<version>/lib. The executable is symlinked to /usr/bin, allowing the required version to be run directly from the command line. There is also a launcher script in /opt/tuflow/tuflow-<version>/bin/tuflow-<version>-idp.sh (or -isp for single precision) that one cane use in case some environment variables needs to be set before execution. We recommend copying these launch scripts into /usr/local/bin if you need to do modifications, as the they might otherwise be overwritten if a patch release is installed.
  2. To uninstall run the preferred uninstaller command. For example:
    3. 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

Note: Major and minor releases are installed with a new directory under /opt/tuflow. For example, TUFLOW 2026.0.0 is installed under /opt/tuflow/tuflow-2026.0. 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

The process for .deb is essentially the same as the .rpm steps 2-5. For steps 3 and 5, the install and uninstall command examples below are for Debian derivatives. For example (assuming TUFLOW 2026.0.0, modify for the specific version required):

To install: 

 sudo apt-get install ./tuflow-2026.0_2026.0.0-1_amd64.deb

To uninstall: 

 sudo apt remove tuflow-2026.0

If unsure about which versions you have previously installed you can return a list of all the installed versions via: 

 apt list --installed | grep tuflow

Note: Major and minor releases are installed with a new directory under /opt/tuflow. For example, TUFLOW 2026.0.0 is installed under /opt/tuflow/tuflow-2026.0. 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.

Notes For Running Linux Under WSL

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 in WSL: 

 export LD_LIBRARY_PATH=/usr/lib/wsl/lib:$LD_LIBRARY_PATH

In that folder there's a utility /usr/lib/wsl/lib/nvidia-smi which will indicate if the Linux installation can connect to the NVIDIA hardware otherwise managed by Microsoft Windows.

Running A Model

For either Linux distribution TUFLOW can be run by calling tuflow-2026.0-isp (replace with the required version and precision) or by passing it a configuration file name:

tuflow-2026.0-isp my_run.tcf

Model-specific commands such as the export OMP_NUM_THREADS 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:

#!/bin/bash export OMP_NUM_THREADS=8 tuflow-2026.0-idp my_run.tfc

Once saved the script 'run_model.sh' will need to be configured to run as an executable as follows: chmod +x run_model.sh

Return To Home Page

Return to Wiki Home Page.

Retrieved from "https://wiki.tuflow.com/w/index.php?title=Linux_Install&oldid=45665"