Skip to main content

Install on Windows

Notes for Windows Users​

note

Treat the following as guidelines, as actual screens may vary depending on your Windows version.

Instructions for Windows Operating System​

The Windows operating system is outside the scope of this documentation. Due to the variation between different Windows version, we offer only guidelines for processes involving default Windows components.

Open the Command Prompt in Windows Operating System​

  1. On the keyboard press Windows + S to open Window’s search box.

  2. Enter the term command prompt to search for the application.

  3. Click on the search result that looks something like this:

Figure 2-3

Figure 2-3 Windows search result for the term command prompt

Start the Command Prompt as an Administrator​

  1. On the keyboard press Windows + S to open Window’s search box.

  2. Enter the term command prompt to search for the application.

  3. Right-click on the relevant search result (see Figure 2-3 above), and on the context menu, click the Run as administrator option. If prompted, click the Yes button to confirm your choice.

Figure 2-4

Figure 2-4 Run command prompt as administrator

Close the Command Prompt​

Click on the X control at the top right corner of the window.

Figure 2-5

Figure 2-5 Closing the command prompt window

Folder Paths​

Unless otherwise stated, all examples of folder paths in this documentation are displayed in Linux format (e.g., Path/folder). Paths are identical for Windows, with the exception of the direction of the folder delimiter (e.g., Path\folder).

Install Server on Windows​

  1. Save the installation file MapLayerServerSetup.exe to a local folder, right click on it, and run it as administrator. The Setup window is displayed. If prompted by a security message such as the following, click the More info link, and then click the Run anyway button.

Figure 2-6

Figure 2-6 Starting the MapCore™ Map Layer Server installation file as administrator

Figure 2-7

Figure 2-7 Permission prompt

  1. Follow the Setup wizard. If you are prompted to install the Visual C++ 2015-2022 Redistributable or the DirectX Runtime, click the Yes button; both are required.

Figure 2-8

Figure 2-8 MapLayerServer Setup, start window

  • Select Destination Location. By default, the program is installed into C:\Program Files\MapLayerServer\<version>, so that several versions may be installed side by side.

  • Select listening port. The port the server listens on. The default is 6767; choose another if 6767 is already taken on this machine.

  • Select server data location. The data repository folder, where imported layers and temporary data are written. The default is C:\ServerData (on the system drive). The folder is shared by every installed version and is kept when a version is uninstalled. It must be a full path such as D:\ServerData of at most 200 characters with no spaces or tabs, and cannot be a drive or share root, be under Program Files or Windows, or use an 8.3 short name such as PROGRA~1.

  • Select Additional Tasks. Choose whether to create Start Menu shortcuts (selected by default) and Desktop shortcuts (not selected by default), and whether to run the server as a Windows service, started automatically at boot (not selected by default; see Run the Server as a Service). Then click the Install button.

  1. Once the installation completion message is displayed, click the Finish button.

Figure 2-9

Figure 2-9 MapLayerServer Setup, installation completion

  1. Continue to Start Server on Windows.

What the Installer Sets Up​

The program is installed under Program Files, which only an administrator can change. Everything the server writes at run time is placed in C:\ProgramData\Elbit\MapLayerServer\<version>, so a standard user can run the server, add layers and export them without administrator rights:

PathContents
C:\Program Files\MapLayerServer\<version>The server executable and its libraries, ServerConfig.xsd, plugins.cfg, resources.cfg and the licenses.
C:\ProgramData\Elbit\MapLayerServer\<version>The server configuration file McMapLayersServerConfig.xml and its backup, and the MapCore log MapCore.log.
C:\ProgramData\Elbit\MapLayerServer\<version>\WWWRootThe server GUI files, and the exports the server writes.
C:\ProgramData\Elbit\MapLayerServer\<version>\CacheThe disk cache and intermediate files (DiskCacheFolder and IntermediateFilesFolder in the server configuration file).
The data folder chosen in Setup (default C:\ServerData)The data repository folder.

The installed shortcuts start the server from the installation folder with the following server execution parameters (see Server Execution Parameters):

0.0.0.0 <port> 0 "C:\ProgramData\Elbit\MapLayerServer\<version>\WWWRoot" "C:\ProgramData\Elbit\MapLayerServer\<version>" "<data folder>"

The installer also sets the same parameters, without the quotes, in the system environment variable MCLAYERSERVER_ACTIVATION_STRING, which the server reads when it runs as a service (see Server Execution Parameters on Windows When Running the Server as a Service). The variable is machine-wide: while the service is registered by another installed version, the installer leaves it as it is.

Choosing the same version's installer again keeps the server configuration file, and offers the port and data folder chosen before.

Run the Server as a Service​

When the service task is selected on the Select Additional Tasks page, the installer registers the Windows service McMapLayersService, sets it to start automatically at boot and starts it. The service runs as the LocalSystem account and takes its parameters from MCLAYERSERVER_ACTIVATION_STRING. To run as a service:

  • The program must be installed under Program Files.

  • The chosen port must be free on this machine.

  • No other installed version may hold the service: only one installation can hold McMapLayersService at a time. To move the service to another version, uninstall the version that holds it, or unregister it (see Stop and Unregister the MapCore™ Map Layer Server When Used as a Service (Windows only)), and then run the Setup of the other version with the service task.

If a condition is not met, Setup says so before installing anything. If the service cannot be registered or does not start, Setup undoes the registration, leaves the program installed without the service, and shows the reason. When the service does not start, see MapCore.log in C:\ProgramData\Elbit\MapLayerServer\<version>.

Uninstalling a version stops and removes the service if that version holds it, and removes MCLAYERSERVER_ACTIVATION_STRING if the variable still names that version's folders.

Silent Install​

Setup runs without its pages from an elevated command prompt with the standard switches /SILENT or /VERYSILENT, plus the following, which answer the pages it does not show:

SwitchMeaning
/PORT=<port>The listening port. Default 6767.
/DATADIR=<folder>The data repository folder. Default C:\ServerData.
/DIR=<folder>The installation folder. Default C:\Program Files\MapLayerServer\<version>.
/TASKS="<tasks>"The tasks to run, from startmenuicon, desktopicon and service. A task not listed is not run, so list every one you want, for example /TASKS="startmenuicon,service".

For example:

MapLayerServerSetup.exe /VERYSILENT /PORT=8080 /DATADIR=D:\ServerData /TASKS="startmenuicon,service"

The port and the data folder are checked as on the pages. Setup exits with code 0 on success, 1 or 7 when a value or a service condition is rejected and nothing is installed, and 101 when the program was installed but the service could not be set up.

Verified against MapCore 12.5.0