LIBPF^® Linux Installation manual

This document is the installation manual for LIBPF^® (LIBrary for Process Flowsheeting) models version 1.1 on desktop and laptop computers running a Linux operating system.

It addresses model users: people who want to install the user interface (UIPF) to interact with models developed by others.

For more information see:

• the LIBPF^® Activation Guide for the rationale and the mechanisms of the activation system;

• the LIBPF^® User Manual for how to use models developed with LIBPF^® and the LIBPF^® user interface.

Prerequisites

The following has been tested on Debian 12 (bookworm). It should be possible to get it to work also on older Debian version (11 bullseye or 10 buster), or another up-to-date Debian-derivative distribution, by adapting the instructions below.

Install the requirements:

sudo apt install postgresql wget gpg sudo

Configure the simevo public PPA is at https://libpf.com/debs/public/:

wget -q -O - https://libpf.com/debs/public/libpf.gpg.key | sudo apt-key add -
# ignore the Warning: apt-key is deprecated. ...
echo "deb https://libpf.com/debs/public/ bookworm main" | sudo sh -c "cat > /etc/apt/sources.list.d/libpf-public.list"
sudo apt update

Installation

Make sure the PostgreSQL DB service is up:

sudo systemctl start postgresql

NOTE: if you are on a system without systemd (such as inside a container) use: pg_ctlcluster 15 main start.

Then install the desired LIBPF^® kernel, i.e. for cogeneration demo:

sudo apt install libpf-kernel-cogeneration

If you install more than one calculation kernel, the last one will be set as default. You can override this setting on a user basis using the Select kernel command in the settings menu of the LIBPF^® user interface; see the matching section in the LIBPF^® User manual.

Uninstallation

To uninstall:

sudo apt remove libpf-runtime libpf-ui libpf-kernel-cogeneration

This will leave behind:

• the postgresql package

• the system configuration file: /etc/xdg/libpf.com/LIBPF.conf

• the (optional) user configuration files: ~/.config/libpf.com/LIBPF.conf

• the persistency database and the associated libpf postgresql user

To really clear everything, replace remove with purge above.