Linux Install

From TUFLOW FV Wiki
Jump to navigation Jump to search

Introduction

TUFLOW FV is installed on Linux using the .rpm and .deb installer packages, which can be downloaded here. There's also a tar.gz archive available from the same location, which can serve as a portable application, similar to the .zip 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.

These instructions apply to TUFLOW FV 2026.0.0 and later. For TUFLOW FV versions prior to 2026.0.0 refer to Linux Install Archive. If you would like an .rpm or .deb built for commercial releases prior to 2020 please contact support@tuflow.com.

Codemeter Configuration

To 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.

TUFLOW Versioning

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

RPM Install

  • Download the .rpm for the specific TUFLOW FV build from https://www.tuflow.com/downloads/#tuflowfv
  • Save the .rpm locally. A common location is the home folder for the current user ~/
  • Run the preferred installation command. For example, if installing the TUFLOW FV 2026.0.0 release:
    sudo dnf install ~/tuflowfv-2026.0-2026.0.0-1.x86_x64.rpm
  • This installs a version-specific copy of the TUFLOW binaries and libraries under /opt/tuflow/<version>/bin and /opt/tuflow/<version>/lib.
  • There is also a launcher script in /opt/tuflow/tuflowfv-<version>/bin/tuflowfv-<version>.sh . If you need to customise this, we recommend copying it into /usr/local/bin, as your changes will be overwritten if a patch release is installed.
  • A symbolic link to the executable is created in /usr/bin, allowing the required version to be run with a versioned shortcut, e.g. tuflowfv-2026.0.
  • To uninstall run the preferred uninstaller command. For example:
    sudo dnf remove tuflowfv-2026.0
  • To return a list of previously installed versions and review the correct uninstall version use dnf list installed, or dnf list installed 'tuflowfv*'

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/tuflowfv-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 install ./tuflowfv-2026.0_2026.0.0-1_amd64.deb

To uninstall: 

 sudo apt remove tuflowfv-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 tuflowfv

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 TUFLOW FV 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 work 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 the Microsoft Windows driver.

Running a Model

For either Linux distribution TUFLOW can be run by calling tuflowfv-2026.0 (this example would the currently installed patch for version 2026.0) and by passing it a configuration file name:

tuflow-2026.0 my_run.fvc

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 
tuflowfv-2026.0 my_run.fvc

Once saved the script will need to be configured to run as an executable as follows:

chmod +x run_model.sh


Linux Install Archive

For TUFLOW FV versions prior to 2026.0.0 refer to Linux Install Archive.

Return To Home Page

Return to Wiki Home Page.

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