Please enable JavaScript to view this site.

Altova FlowForce Server 2020 Advanced Edition

When MapForce Server mappings or StyleVision Server stylesheets run under FlowForce Server management (as jobs), they may require environment variables to be set (for example, the CLASSPATH, in order to specify the location of the JDBC drivers when connecting to a database).

 

To set environment variables required by MapForce Server mappings or StyleVision Server transformations, edit the .tool file of the respective Altova server product. To edit the .tool file, first check if it already exists in the DATADIR\tools directory, where DATADIR is the application's data directory.

FlowForce Server application data directory (DATADIR)

Linux

/var/opt/Altova/FlowForceServer2020/data

macOS

/var/Altova/FlowForceServer2020/data

Windows

C:\ProgramData\Altova\FlowForceServer2020\data

 

If the .tool file does not exist in DATADIR\tools, copy it from the INSTALLDIR\tools directory of FlowForce Server, where INSTALLDIR is the application's installation directory.

FlowForce Server installation directory (INSTALLDIR)

Linux

/opt/Altova/FlowForceServer2020/

macOS

/usr/local/Altova/FlowForceServer2020/

Windows

C:\Program Files\Altova\FlowForceServer2020\

C:\Program Files (x86)\Altova\FlowForceServer2020\

 

You will find .tool files in the INSTALLDIR\tools directory only if MapForce Server or StyleVision Server were installed after FlowForce Server. If the .tool file exists neither in the FlowForce application data directory nor in the FlowForce installation directory, it is likely that FlowForce Server was installed after MapForce Server or StyleVision Server. In this case, you can find the .tool file in the etc directory relative to the MapForce Server or StyleVision Server installation directory.

 

Make sure to copy the .tool file to the FlowForce Server application data directory (NOT the installation directory) before editing it. The .tool file in the FlowForce Server application data directory above takes precedence over the .tool file existing in other directories.

 

Warning: If you run the migratedb command during upgrade to a new major version of FlowForce, any .tool files from the application data directory of the previous version will be copied over to the application directory of the new version. This may have unwanted consequences; therefore, ensure that you keep in the application data directory only the .tool files that you actually need.

 

You can add the required environment variables under the [Environment] section within the .tool file. For example, a .tool file which sets the CLASSPATH variable looks as follows:

 

[Environment]

CLASSPATH=.:/usr/local/jdbc/oracle/ojdbc6.jar

Sample .tool file (Linux)

Environment variables set in the .tool file override environment variables defined by other means.

 

For information about executing shell commands or scripts as FlowForce Server jobs, see the /system/shell/commandline function.

© 2020 Altova GmbH