Altova MapForce Server 2023 

assignlicense (Windows only)

Home Prev Top Next

Syntax and description

The assignlicense command is available on Windows only (not on Linux or Mac systems). It uploads a license file to the Altova LicenseServer with which MapForce Server is registered (see the licenseserver command), and assigns the license to MapForce Server. It takes the path of a license file as its argument. The command also allows you to test the validity of a license.


mapforceserver assignlicense [options] FILE


The FILE argument takes the path of the license file.

The --test-only option uploads the license file to LicenseServer and validates the license, but does not assign the license to MapForce Server.


For details about licensing, see the LicenseServer documentation (



Examples of the assignlicense command:


mapforceserver assignlicense C:\licensepool\mylicensekey.altova_licenses

mapforceserver assignlicense --test-only=true C:\licensepool\mylicensekey.altova_licenses


The first command above uploads the specified license to LicenseServer and assigns it to MapForce Server.

The last command uploads the specified license to LicenseServer and validates it, without assigning it to MapForce Server.



Options are listed in short form (if available) and long form. You can use one or two dashes for both short and long forms. An option may or may not take a value. If it takes a value, it is written like this: --option=value. Values can be specified without quotes except in two cases: (i) when the value string contains spaces, or (ii) when explicitly stated in the description of the option that quotes are required. If an option takes a Boolean value and no value is specified, then the option's default value is TRUE. Use the --h, --help option to display information about the command.


© 2017-2023 Altova GmbH