FME Flow: 2024.2

Provide a Database Server

FME Flow uses its own database to manage jobs and workspace information. It is not a source or destination data source for FME workspaces.

To ensure the FME Flow Database remains available in a failover scenario, provide a machine on which to install the database that is physically separate from the machines on which the FME Flows are installed. In addition to being physically separate, the database server should, by itself, be configured for fault tolerance.

You can choose to install a PostgreSQL database that is included with the FME Flow installer, or you can configure the FME Flow Database on your own database server. If you use your own database server, keep in mind the following:

  • PostgreSQL (recommended), Oracle, and SQL Server are supported. The following versions are recommended:
    • Note  PostgreSQL is the recommended database server with FME Flow, offering enhanced performance and stability through targeted optimizations.
    • PostgreSQL: 16.1 or later.
    • Oracle: 19c or later.
    • SQL Server: 2016 or later.
  • When you install the FME Flows, the database server must be running and you must know the connection information.

  • If using an Oracle database server, you must obtain the Oracle Database JDBC driver and place it in the following directory:

    • Windows:
      • <FME FlowDir>\FMEFlow\Utilities\jdbc
    • Linux:
      • /opt/fmeflow/Utilities/jdbc

    Driver versions recommended: 12.1 (ojdbc7.jar), 12.2 (ojdbc8.jar), 18.3 (ojdbc8.jar), 19.3 (ojdbc8.jar), 19.3, 19.6, 19.7 (ojdbc8.jar).

    Driver versions not recommended: All ojdbc10.jar versions.

    For more information, see https://www.oracle.com/technetwork/database/application-development/jdbc/downloads/index.html.

  • Following installation, you must be able to create a new database on the server using SQL scripts.

For information about acquiring a fault-tolerant database server, consult your IT department.

Updating the FME Flow Database Password

If you choose to install a PostgreSQL database that is included with the FME Flow installer, and want to update the password for the database user account, follow these instructions:

  1. Download pgAdmin or DBeaver.
  2. Start pgAdmin. If this is your first time starting pgAdmin, it will prompt you to set a master password. Choose something you will remember.
  3. Add a new server for the FME Flow Database:
    1. Right-click on Servers and Select Create > Server....
    2. In the General tab of the Create - Server dialog, specify the Name for the server connection. This can be anything, such as fmeflow.
    3. In the Connection tab of the Create - Server dialog, specify the server properties, using the Database Connection details in the fmeDatabaseConfig configuration file, for DB_TYPE=postgresql, as follows:

      4. Property

      Value from fmeDatabaseConfig.txt
      Host name/address DB_JDBC_URL=jdbc:postgresql://<hostname>:<port>/<database_name>
      Port DB_JDBC_URL=jdbc:postgresql://<hostname>:<port>/<database_name>
      Maintenance database DB_JDBC_URL=jdbc:postgresql://<hostname>:<port>/<database_name>
      Username DB_USERNAME=<username>
      Password DB_PASSWORD=<password>
    4. Click Save.
  4. In the Object browser, select the FME Flow Database server, and locate and expand Login/Group Roles.
  5. Right-click the fmeserver database user account and select Properties. Under Definition, change the Password and click Save.
  6. In the fmeDatabaseConfig configuration file, update the value of the DB_PASSWORD parameter that corresponds to DB_TYPE=postgresql with the new password specified above.

    7. When finished, save the file.

  7. (Recommended) Encrypt the FME Flow Database password.
  8. Restart FME Flow.
  1. Open a command prompt and change to the following directory:

    2. <FMEFlowDir>/Utilities/pgsql/bin

  2. Run the following command to connect to the FME Flow Database:

    3. ./psql -d <databaseName> -p <port> -U <username>

    To confirm the settings, check the Database Connection details in the fmeDatabaseConfig configuration file, for DB_TYPE=postgresql, as follows:

    Property

    Value from fmeDatabaseConfig.txt
    -d DB_JDBC_URL=jdbc:postgresql://<hostname>:<port>/<database_name>
    -h DB_JDBC_URL=jdbc:postgresql://<hostname>:<port>/<database_name>
    -p DB_JDBC_URL=jdbc:postgresql://<hostname>:<port>/<database_name>
    -U DB_USERNAME=<username>
    Password ( when prompted) DB_PASSWORD=<password>
  3. Once connected, enter the following command to change the password for your user:

    4. \password

  4. Use \q to quit psql.

  5. In the the fmeDatabaseConfig configuration file, update the value of the DB_PASSWORD parameter that corresponds to DB_TYPE=postgresql with the new password specified above, and save the file.
  6. (Recommended) Encrypt the FME Flow Database password.
  7. Restart FME Flow.