Server actions in the web GUI
Server-related Actions
The following actions are available for the MapCore™ server and are detailed below:
-
Add New Group
-
Import MC Package
-
Export Repository
-
Change Server Configuration
-
Configure Preview Options
-
View MapCore™ Server Version Number
Add New Group
-
On the Map Layer Repository bar, click the More options menu icon
, and then click the Add Group option. The Add Group window is displayed.
-
Enter the group name in the New group name field.

Figure 4-21 Add Group window
The group name must be unique. In addition to English letters, numbers, dash (-), and underscore (_), it may contain other characters, such as non-English letters.
- Click the OK button to create the new group.
Import MC Package
The MC package is the packaging of data exported from the MapCore™ Map Layer Server using its export options. Once exported, the MC package can then be imported on the same server from which it was exported or on another server. The import process restores group and layer hierarchy, including the creation of any groups that are missing in the server during import. If the package contains a layer whose layer ID already exists on the server, the import stops at that layer and an error is displayed in the Log Display; the layers that follow it in the package are not imported. Packages exported by the server include the search index data of vector layers, which is restored upon import.
Remove from Layer Backlog any layer that is about to be imported. A layer with same ID as a layer found in the Layer Backlog stops the import.
File location
In order to import the package, you must be able to locate the exported mcpkg file. By default, this file was originally exported to your browser’s download folder.
File name
By default, the exported mcpkg file name follows either of these formats:
<Layer name>_<timestamp>.mcpkg for a single exported layer, or
McPackage_<number>layers _<timestamp>.mcpkg for multiple exported layers, where:
<Layer name> is the layer’s name, <number>layers is the number of exported layers, and <timestamp> has the following structure: YYYY_MM_DD_HH_MM_SS, for example:
Raster-7_2023_11_29_14_53_45.mcpkg
Or
McPackage_2layers__2023_11_29_22_42_56.mcpkg
Import process
To import data:
-
On the Map Layer Repository bar, click the More options menu icon
, and then click the Import MC package option. The Import MC Package window is displayed.
-
Drag the folder containing the desired layer and drop it over this window or click the upload cloud icon
at the center of the window to open the file browser and navigate to the target folder where the MC Package is located. The Import MC Package window file name prompt is displayed.

Figure 4-22 Import MC Package upload window
- Click the OK button on the file name prompt. The upload process is displayed in the Action Display and the import process prompt is displayed at the bottom right corner of the screen.
-
If desired, monitor the import process in the Process Preview area. Refer to Running processes for details on options available in this area of the MapCore™ Map Layer Server GUI.
-
If desired, dismiss the export preparation prompt by clicking the X option. If no action is taken, the prompt will disappear when the preparation process is complete.
Figure 4-23 Example of MC Package import message
Export Repository
This option exports the entire Map Layer Repository. Refer to Export Group and Export Layer for instructions on exporting only some groups and layers.
Exports entire Map Layer Repository as an mcpkg file for backup purposes or future import. Group hierarchy is maintained in the exported file and will be recreated upon import. Refer to Import MC Package for detailed instructions on importing the exported file.
Depending on the size of exported data and the number of layers, the export process may be a lengthy one.
Importing this file on another server will organize the exported layers back in group formation. If groups specified in the mcpkg file do not already exist in the server, they will be created upon import.
To export entire Map Layer Repository:
-
On the Map Layer Repository bar, click the More options menu icon
, and then click the Export Repository option. The Export Repository window is displayed.
-
Click the Export button
Figure 4-24 Example of MC Package import message
-
Click the Export button to complete the export. The export preparation prompt is displayed at the bottom right corner of the screen.
-
If desired, dismiss the export preparation prompt by clicking the X option. If no action is taken, the prompt will disappear when the preparation process is complete.
Figure 4-25 Example of Map Layer Repository export preparation message
During the export process, temporary files are saved in the Export folder which is located under the server data repository folder. Refer to System Folders and Configuration Files for detailed information on MapCore™ Map Layer Server folders and their locations. When the import process is complete, the export file is moved to the downloads folder.
- Locate the mcpkg file in your download folder in order to transfer it to another location.
Refer to Import MC Package for details on file location and naming convention of the exported mcpkg file.
Change Server Configuration
Changing server configuration parameters may hinder the proper function of the server.
-
On the Map Layer Repository bar, click the More options menu icon
, and then click the Server Configuration option. The Server Configuration window is displayed.
-
If not visible, scroll down and click the Enable Edit options

Figure 4-26 Server Configuration window
- Click the OK button on the warning message that is prompted to continue.

Figure 4-27 Server configuration warning message
- Change any of the configuration parameters. Refer to Server Parameters for a detailed description of each parameter.
Table 4-10 Server configuration parameters
| Parameter (GUI name) | Description in configuration parameter…. |
|---|---|
| Suffix URL | SuffixUrl |
| Memory Cache Size [in MB] | MemoryCacheSize |
| Disk Cache Size [in MB] | DiskCacheSize |
| Default Text Index File Path | DefaultTextIndexFilePath |
| Security Record File Name | SecurityRecordFileName |
| Disk Cache Folder | DiskCacheFolder |
| Default Tiling Scheme | DefaultTilingScheme |
| Tiling Schemes Exceptions By CRS | TilingSchemesByCRS Refer additionally to Change or Add Tiling Scheme below for detailed instructions. |
| Intermediate Files Folder | IntermediateFilesFolder |
| GPU Usage in Spatial Queries | GpuUsageInSpatialQueries |
| Map Scale Factor | DefaultMaxScale Factor |
| Import Scans Interval | ImportScanInterval |
| Is Client Version Earlier than 7.11.4 | IsClientVerPre_7_11_4 |
- Click the OK button to submit your changes and exit the window.
Change or Add Tiling Scheme
Multiple layers will not be simultaneously previewed if their tiling schemes are different.
Refer to Tiling Scheme for detailed information on the tiling scheme and its relationship to the layer’s coordinate system.
Refer to Coordinate System for detailed information on the layer’s coordinate system.
-
Within the configuration settings, in the field, Tiling Schemes By CRS, click the sideways arrow to open the Tiling Scheme window.
-
OPTIONAL: Add a new entry as follows –
a. Click the + icon. The Tilting Scheme Table is displayed.
b. From the dropdown list, select a tiling scheme.
c. From the dropdown list, select a coordinate system.
d. Click the OK button to submit the change and close the window.

Figure 4-28 Adding tiling scheme exceptions
Where:
Table 4-11 Tiling scheme parameters
| Parameter (GUI name) | Click on parameter name to jump to description |
|---|---|
| Default Tiling Scheme | DefaultTilingScheme |
| Coordinate System | CoordinateSystem |
-
OPTIONAL: To remove existing entries, click the Trash icon.
-
Click the OK button to submit the change(s) and close the Tiling Scheme window.
Changes will only take effect after the next server reboot.
- Click the OK button to dismiss the confirmation message.

Figure 4-29 Confirmation message for server configuration parameter changes
Configure Preview Options
Note that this parameter differs from the Map Scale Factor that appears under the Server Configuration as it saved locally (and not to the server) and therefore pertains only to previews within the current browser on the current device.
-
On the Map Layer Repository bar, click the More options menu icon
, and then click the Preview Configuration option. The Preview Configuration window is displayed.
-
If desired, change the Map Scale Factor parameter. Refer to DefaultMaxScale Factor in Server Parameters for a detailed description of this parameter.
-
Click the OK button to submit your change.

Figure 4-30 Preview configuration parameter change
View MapCore™ Server Version Number
On the Map Layer Repository bar, click the More options menu icon , and then click the About option. The About window is displayed.