Linux FME Flow Installation Checklist

Richard Mosley
Richard Mosley
  • Updated

FME Version

Introduction

Installing FME Flow (formerly FME Server) on Linux requires some preparation. This article will provide checklists for Online installations and silent installation options.

Please be advised that these instructions were tested with FME Flow 2024 (b24622) Express installation hosted on Ubuntu 22.04

 

Manual Online Installation

  1.  Start a bash shell session as the root user. 
  2.  Update the system packages. Example:
apt update && apt upgrade
  1.  Download and install the dependencies for the FME Flow component of the installation. Example:
sudo apt-get install zip & unzip
  1.  Download the FME Flow installer package from the FME Downloads webpage using the command wget <FMEFlowInstallerPackageLinkAddress>. Example:
wget  https://downloads.safe.com/fme/2024/ubu_22/fme-flow-2024.1.2-b24622-linux-x64~ubuntu.22.04.run
  1.  Assign execute permission to the installer package. Example:
sudo chmod +x fme-flow-2024.1.2-b24622-linux-x64~ubuntu.22.04.run
  1.  Run the Installer
./fme-flow-2024.1.2-b24622-linux-x64~ubuntu.22.04.run

 

Listing All FME Engines Dependencies Using Shell Script

Below is a sample shell script for listing all the third-party dependency packages for the installation's FME Engines component.
This script should be saved as a .sh file under the “fmeflow” folder, provided with execute permissions, and then run. You will be prompted to provide the .deb file.

Note: Although some testing has been done, our QA team has not thoroughly tested this.  It is therefore recommended that customers looking to do this ensure they have tested the reconfiguration in a non-production environment to ensure all aspects of FME Flow they require to function do so correctly.
 

#!/bin/bash

#ask user for deb file
read -p “Please_enter_the_deb_file:” file
sudo apt install postgresql -ynano tes 2>> errors.txt
sudo apt install nginx -y 2>> errors.txt
sudo apt-get install zip unzip -y 2>> errors.txt
sudo apt-get install perl -y 2>> errors.txt
#getting all package info
dpkg -I $file> package.txt
#Retrieving data after “Depends:” till end of line
awk '/Depends/' package.txt> OnlyDependencies.txt 2>> errors.txt
#Removing the word “Depends:”
sed 's/Depends://g' OnlyDependencies.txt> RemovedthewordDepends.txt 2>> errors.txt
#Splitting each dependency package name to a separate line
awk '{for(i=1;i<=NF;i++)
if(match($i,",")>0)
line=line $i"\n";
else line=line $i;
sub("^\n","",line);
print line}' RemovedthewordDepends.txt> SplitInSeperateLines.txt 2>> errors.txt
#Removed all the commas at the end of the package name
sed 's/,//g' SplitInSeperateLines.txt> RemovedCommas.txt 2>> errors.txt
#Removed all the additional info within brackets
sed 's/([^()]*)//g' RemovedCommas.txt> RemovedtheContentWithBrackets.txt 2>> errors.txt

 

Distributed Installations Checklist

Distributed installations can use the same method. However, you must ensure you can access the database and FME Flow File Share before installing it. You will need to set up the FME Flow User and create a mount for the file share. Please see this article on Linux Mounting Options
 

Silent Installation Parameter Overview

This list provides all the required Parameters for different installations and a few helpful parameters. The documentation includes information on these parameters.
 

Linux Required For Description
COREHOSTNAME Optional Host name of the machine that runs the FME Flow Core.
INSTALLDIR All The FME Flow install directory.
FMEFLOWSHAREDDATA Optional The path to the FME Flow System Share directory, where FME Flow stores Repositories and Resources files. Path names are case-sensitive.
DATABASETYPE Distributed Database The database server type that will be used for the FME Flow Database. Possible values are Default, MSSQL, Oracle, PostgreSQL. The default assumes the PostgreSQL database is included with the FME Flow installer and is located on the same machine.
DATABASEHOST Distributed Database The host on which the database is on. This should only be specified if DATABASETYPE is not Default.
DATABASEPORT Distributed Database The port to connect to the database. This should only be specified if DATABASETYPE is not Default.
INSTANCENAME MSSQL Distributed Database If DATABASETYPE is MSSQL, the SQL Server instance name to use for connecting to the database, instead of DATABASEPORT.
DATABASECONNECTIONSTRING Distributed Database / Optional The JDBC connection string for connecting to the FME Flow Database.
ORACLESID Oracle Distributed Database The SID for the Oracle database. Must be specified only if DATABASETYPE is Oracle.
JDBCDRIVER Distributed Database / Optional If your database requires a JDBC driver that Safe does not provide, specify the full path to it here, and it will be copied to the appropriate place in the install directory.jdbcdriver
DATABASEUSER Distributed Database

The FME Flow Database user account name. This property applies regardless of the value specified by DATABASETYPE.

WARNING: If DATABASETYPE is Default, do not specify postgres. This name corresponds to the PostgreSQL master user. If the corresponding passwords do not match, the database will not install.

DATABASEPASSWORD Distributed Database

The password for the FME Flow Database user name.

Note: The password for the FME Flow Database user account is encrypted in FME Flow installation files.

SERVLETTYPE Distributed Web Application The type of Application Server (servlet engine) you will use with FME Flow. Possible values are Default or Apache (Tomcat). The default installs the Apache Tomcat servlet provided by the FME Flow installer.
SERVLETPORT Distributed Web Application If SERVLETTYPE is Default, the listening port of the Apache Tomcat servlet engine host. It must be different from EXTERNALPORT.
WEBAPPSDIR Distributed Web Application If an Apache Tomcat servlet is already installed on the machine, the path to the webapps directory for the servlet engine for installing WAR files. This is a necessary property for distributed web applications.
SHAREDTOMCATLIB Distributed Web Application If an Apache Tomcat servlet is already installed on the machine, the path to the lib directory for the servlet engine, for installing JAR files. This is a necessary property for distributed web applications.
FIRSTLOGINCHANGEPASSWORD Optional If true, the user will be prompted to update the admin password upon initial login to the FME Flow Web User Interface following installation. If false, updating the admin password will not be required upon initial login.
NODENAME Engine Only If installing an FME Core or FME Engines, use this property to advertise a fully-qualified domain name (FQDN) for how other distributed components connect to this COREHOSTNAME. Specify an FQDN that resolves to the machine's IP address via DNS.
PGDATADIR Optional Express If DATABASETYPE=Default, the directory to contain the data for the FME Flow PostgreSQL database.

Was this article helpful?

Comments

0 comments

Please sign in to leave a comment.