Data Migration
You can migrate FlowForce data by means of the migratedb command or via the FlowForce Server Setup Page. In both cases, the following will happen:
•Data from the existing instance-data directory will be copied to a new location.
•The FlowForce database will be upgraded if necessary.
•The existing instance directory will not be modified.
For details about migration, see the subtopics below.
Important information about instance-data directory
Starting with 2024 R2, the default path to the instance-data directory has changed and no longer contains a year. This is the new recommended naming convention because in-place upgrades are safer and faster. An in-place upgrade means that a piece of software is upgraded directly in its existing location, replacing the old version with the new one, rather than installing the new version in a separate location (e.g., in a year-based directory).
2024 R2 has also introduced a new way of installing server instances: via the Setup page as opposed to the installation wizard. The new method provides more control over the location of your instance data. For more information, see Configuration via Setup Page.
Note that migrating an existing instance to a new directory might take some time and disk space. Therefore, an in-place upgrade is recommended when you install a new version of FlowForce Server. If you only need to upgrade the FlowForce database to the latest version, run upgradedb.
Data migration via the FlowForce Setup page (any OS)
To migrate data via the Setup page, take the steps below:
2.Navigate to the instance you wish to migrate.
3.Stop the FlowForce Server and the FlowForce Web Server services.
4.Click the Migrate Instance Directory button.
5.In the dialog that opens, select a location to which you want to migrate the data, then click Migrate Instance. The Setup page will display a new instance. The Actions Log of the new instance will inform you about the migration process.
6.As soon as the migration is complete, install the FlowForce Server Web and the FlowForce Server services and start them if they have not started automatically.
7.Click Finish Setup on the Setup page. This will redirect you to the login page.
Data migration via the command line
You can also migrate data on Windows and Linux via the command line.
Windows
To migrate FlowForce data on Windows via the command line, follow the instructions below:
1.Stop the FlowForce Server and the FlowForce Web Server services.
2.Run the migratedb command, for example:
"C:\Program Files(x86)\Altova\FlowForceServer2026\bin\FlowForceServer.exe" migratedb
--olddatadir=C:\ProgramData\Altova\FlowForceServer\data
--datadir=C:\ProgramData\Altova\FlowForceServer_New
Note that the new data directory must not exist; otherwise, the command will fail.
3.Install the FlowForce Server Web and the FlowForce Server services.
4.Start the FlowForce Server Web and the FlowForce Server services.
Linux
To migrate data on Linux via the command line, follow the instructions below:
1.If you want to migrate to a new version, uninstall the previous version of FlowForce Server, then install FlowForce Server 2026. Note that deinstallation does not remove the instance-data directory.
2.Stop the FlowForce Server service:
sudo systemctl stop flowforceserver
3.Stop the FlowForce Web Server service:
sudo systemctl stop flowforcewebserver
4.Run the migratedb command. For example:
sudo /opt/Altova/FlowForceServer2026/bin/flowforceserver migratedb
--olddatadir=/var/opt/Altova/FlowForceServer/data
--datadir=/var/opt/Altova_FlowForceServer_Data_New
Note that the new data directory must not exist; otherwise, the command will fail.
5.Start the FlowForce Server service:
sudo systemctl start flowforceserver
6.Start the FlowForce Web Server service:
sudo systemctl start flowforcewebserver