migratedb
This command copies FlowForce instance data from an older instance-data directory to a new, clean instance-data directory and upgrades the FlowForce database to the latest version if necessary. Importantly, the command fails if the old instance-data directory does not exist or if the new data directory already exists.
Running this command can be useful in the following scenarios:
•When you migrate FlowForce Server to a new machine
•When you restore the instance-data directory from a backup (see Backup and Data Restoration)
You can also migrate data via the FlowForce Server Setup Page. If you only need to upgrade the FlowForce database to the latest version, run upgradedb.
Before using the migratedb command, you must stop the FlowForce Server and FlowForce Web Server services.
Important information about in-place upgrades
Note that copying 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. 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).
Syntax
flowforceserver migratedb [options] --olddatadir=VALUE |
Note: On Linux systems, use an all-lowercase flowforceserver to call the executable. |
Options
In the command line, options can be used with one or two dashes.
Option | Description |
|---|---|
--datadir=VALUE | Optional parameter. VALUE is the path of a new instance-data directory to which you want to copy FlowForce data. The new data directory must not exist; otherwise, the command will fail.
If this option is not specified, the data directory of the current directory will be used by default. If there is no data directory in the current directory, the command will fail. |
--olddatadir=VALUE | Mandatory parameter. VALUE is the path of the old instance-data directory from which you want to copy FlowForce data. |
--integratetools | Optional parameter. Integrates the Altova RaptorXML Server functions into a new or existing FlowForce instance. Integration is also possible via the Integrate Tools button on the FlowForce Server Setup page.
Integration is carried out via .tool files. FlowForce Server uses these files to locate and configure the execution of other server applications under its management. For details, see Tool Files. |
--h, --help | Use this option to receive information about the command. |
Example
To migrate data from the instance-data directory of FlowForce Server to a new instance-data directory, run the following command:
"C:\Program Files(x86)\Altova\FlowForceServer2026\bin\FlowForceServer.exe" migratedb |