MapForce Server Command Line
MapForce Server provides a command line interface that you can use for administrative tasks such as licensing, and also to run mapping execution files (.mfx). The available commands are listed below.
•accepteula: (Linux only) Accepts the end user license agreement for MapForce Server.
•assignlicense: Uploads a license to LicenseServer and assigns this license to MapForce Server.
•exportresourcestrings: Exports all application resource strings to an XML file.
•help: Displays information about the command that is submitted as argument (or about all commands if no argument is submitted).
•licenseserver: Registers MapForce Server with a LicenseServer on the local network.
•run: Runs a Mapping Execution File (.mfx) compiled with MapForce.
•setdeflang: Sets the default language of MapForce Server.
•verifylicense: Checks if current MapForce Server is licensed and, optionally, whether it is licensed with the given license key.
•version: Displays the version number of MapForce Server.
Depending on your operating system, the path to the executable varies. The default paths are shown in the table below.
OS | Path |
|---|---|
Linux | /opt/Altova/MapForceServer2026/bin |
Windows | C:\Program Files\Altova\MapForceServer2026\bin |
Note: If MapForce Server 32-bit is installed on Windows 64-bit, change C:\Program Files to C:\Program Files (x86).
For simplicity, this documentation omits the full path of the executable and refers to it by its name only, for example:
mapforceserver help |
How to run a command
To run a command, open a command prompt, then select one of the options below to access the executable.
Option 1: Use the absolute path
You can type the absolute path of the executable, which works from any directory. If the path contains spaces, enclose it in double quotation marks.
Linux
/opt/Altova/MapForceServer2026/bin/mapforceserver help |
Windows
"C:\Program Files (x86)\Altova\MapForceServer2026\bin\MapForceServer.exe" help |
Option 2: Change to the installation directory
You can change the terminal's current directory to the installation directory. Then you can run commands by typing the executable's name (without the full path) and the desired command:
Linux
cd /opt/Altova/MapForceServer2026/bin ./mapforceserver help |
Windows
cd C:\Program Files (x86)\Altova\MapForceServer2026\bin MapForceServer help |
Note: On Linux systems, the prefix ./ indicates that the executable is in the current directory.
Option 3: Add the executable’s path to PATH
You can add the directory containing the executable to the PATH environment variable. This allows you to run commands from any directory by typing the executable’s name (without the full path), followed by the desired command:
Linux
mapforceserver help |
Windows
MapForceServer help |
Tips and tricks
Below are some tips that might be useful when you work with the command-line interface.
•To find out the current directory where you command line window is, enter pwd on Linux. On Windows, enter echo %CD%.
•You can use the Tab key to quickly enter various file or directory paths, without having to type them in full. For example, if you type cd c:\prog at the command line and press Tab, you will get C:\Program Files automatically pre-filled (or some other directory under C:\ whose name begins with "Prog").
•When you enter paths that contain white space, such as C:\Program Files on Windows, enclose them within quotes.
•If you see a message similar to "This command is not recognized as an internal or external command, operable program or batch file", you have most likely mistyped a path or command.
•On Linux, ensure that you use the correct case for file and directory names. For example, typing a path such as /home/nikita/downloads will return an error if the directory name is actually /home/nikita/Downloads.
•When typing a path on Linux, use forward slashes, as opposed to back slashes on Windows.