Installing MapForce Server
System requirements
•Windows 10, Windows 11
•Windows Server 2012 or newer
Prerequisites
•Perform installation as a user with administrative privileges.
•From version 2021 onwards, a 32-bit version of MapForce Server cannot be installed over a 64-bit version, or a 64-bit version over a 32-bit version. You must either (i) remove the older version before installing the newer version, or (ii) upgrade to a newer version that is the same bit version as your older installation.
Installing MapForce Server
You can install MapForce Server either standalone or as part of FlowForce Server installation. To install MapForce Server under FlowForce Server management, select the respective option on the FlowForce installation wizard. The FlowForce Server installer includes the MapForce Server installer, and the FlowForce Server Advanced Edition installer includes the MapForce Server Advanced Edition installer. The installers of both FlowForce Server and MapForce Server are available for download at the Altova Download Center (https://www.altova.com/download).
To install MapForce Server standalone:
1.Download the installation file from the Altova Download Center (https://www.altova.com/download) and run it.
2.Optionally, select the installation language from the box in the lower left area of the wizard, and click Next. You can change the language later from the command line.
3.Do one of the following:
a.If you haven't installed Altova LicenseServer yet, leave the default settings as is. The wizard will install the latest version of Altova LicenseServer on the computer where you are running the wizard.
b.If you haven't installed Altova LicenseServer yet and want to install Altova LicenseServer on another computer, clear the Install Altova LicenseServer on this machine check box, and then choose Register Later. In this case, you will need to install Altova LicenseServer and register MapForce Server separately.
c.If Altova LicenseServer has already been installed on your computer but it has a lower version than the one indicated by the installation wizard, leave the default settings as is. In this case, the installation wizard will automatically upgrade your LicenseServer version with the one indicated on the dialog box. Note that the existing registration and licensing information will be preserved after the upgrade.
d.If Altova LicenseServer has already been installed on your computer or network, and if it has the same version as the one indicated by the wizard, do the following:
i.Clear the Install Altova LicenseServer on this machine check box.
ii.Under Register this product with, choose the Altova LicenseServer instance on which you want to register MapForce Server, or choose Register later. Note that you can always select Register Later if you want to ignore the LicenseServer associations and carry on with the installation of MapForce Server.
4.Click Next.
5.Follow the wizard instructions to complete the installation.
Installation on Windows Server Core
Windows Server Core is a minimal Windows installation that does not use a number of GUI features. You can install MapForce Server on a Windows Server Core machine as follows:
1.Download the MapForce Server executable from the Altova Download Center (https://www.altova.com/download). Make sure to choose the executable matching your server platform (32-bit or 64-bit).
2.On a Windows computer with a graphical user interface, open a command prompt window as Administrator and run the following command on the installer executable:
MapForceServerAdv<version>.exe /u |
3.This unpacks the .msi file(s) which you need for the next step. Copy the .msi file to the computer that runs on Windows Server Core.
4.If you are updating an earlier version of MapForce Server, shut down MapForce Server before carrying out the next step.
5.Install MapForce Server via the .msi file by using the following command:
msiexec /i MapForceServerAdvanced.msi |
To test the return value of the installation, you might want to run a script similar to the following:
start /wait msiexec /i MapForceServerAdvanced.msi /q echo %errorlevel% |
The return code of the install operation will be available in the %errorlevel% environment variable. The return code 0 indicates success.
For a silent installation with a return code and a log of the installation process, run:
start /wait msiexec /i MapForceServerAdvanced.msi /q /L*v! <pathToInstallLogFile> |
Note: | Keep the .msi files in a safe place. You will need them later to uninstall, repair or modify the installation. |
To modify the installation, run:
msiexec /m MapForceServerAdvanced.msi |
To repair the installation, run:
msiexec /r MapForceServerAdvanced.msi |
To uninstall MapForce Server, run:
msiexec /x MapForceServerAdvanced.msi |
Alternatively, the following command will uninstall MapForce Server silently and report the detailed outcome in a log file:
start /wait msiexec /x MapForceServerAdvanced.msi /q /L*v! <pathToUninstallLogFile> |
To install taxonomies, use the Taxonomy Package Manager via the command line. See the MapForce Server manual for information about how to do this.
Licensing MapForce Server
1.Ensure that the latest version of Altova LicenseServer (https://www.altova.com/licenseserver) is installed and running either on the local machine or network.
2.If you haven't done so already during installation, register MapForce Server with Altova LicenseServer. For this, you need to know either the host name or the IP address of the computer where LicenseServer runs. For example, if LicenseServer runs on 127.0.0.1, you can register it as follows:
MapForceServer.exe licenseserver 127.0.0.1 |
3.Log on to the LicenseServer administration interface and assign the license to the machine where MapForce Server runs.
For more information, refer to Altova LicenseServer documentation (https://www.altova.com/documentation).