Skip to main content

Server actions in the web GUI

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​

  1. 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.

  2. Enter the group name in the New group name field.

Figure 4-21

Figure 4-21 Add Group window

note

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.

  1. 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.

warning

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:

  1. 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.

  2. 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

Figure 4-22 Import MC Package upload window

  1. 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.

  1. 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.

  2. 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

Figure 4-23 Example of MC Package import message

Export Repository​

note

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.

note

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:

  1. 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.

  2. Click the Export button

Figure 4-24

Figure 4-24 Example of MC Package import message

  1. Click the Export button to complete the export. The export preparation prompt is displayed at the bottom right corner of the screen.

  2. 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

Figure 4-25 Example of Map Layer Repository export preparation message

note

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.

  1. Locate the mcpkg file in your download folder in order to transfer it to another location.
note

Refer to Import MC Package for details on file location and naming convention of the exported mcpkg file.

Change Server Configuration​

warning

Changing server configuration parameters may hinder the proper function of the server.

  1. 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.

  2. If not visible, scroll down and click the Enable Edit options

Figure 4-26

Figure 4-26 Server Configuration window

  1. Click the OK button on the warning message that is prompted to continue.

Figure 4-27

Figure 4-27 Server configuration warning message

  1. 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 URLSuffixUrl
Memory Cache Size [in MB]MemoryCacheSize
Disk Cache Size [in MB]DiskCacheSize
Default Text Index File PathDefaultTextIndexFilePath
Security Record File NameSecurityRecordFileName
Disk Cache FolderDiskCacheFolder
Default Tiling SchemeDefaultTilingScheme
Tiling Schemes Exceptions By CRSTilingSchemesByCRS Refer additionally to Change or Add Tiling Scheme below for detailed instructions.
Intermediate Files FolderIntermediateFilesFolder
GPU Usage in Spatial QueriesGpuUsageInSpatialQueries
Map Scale FactorDefaultMaxScale Factor
Import Scans IntervalImportScanInterval
Is Client Version Earlier than 7.11.4IsClientVerPre_7_11_4
  1. Click the OK button to submit your changes and exit the window.

Change or Add Tiling Scheme​

warning

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.

  1. Within the configuration settings, in the field, Tiling Schemes By CRS, click the sideways arrow to open the Tiling Scheme window.

  2. 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

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 SchemeDefaultTilingScheme
Coordinate SystemCoordinateSystem
  1. OPTIONAL: To remove existing entries, click the Trash icon.

  2. Click the OK button to submit the change(s) and close the Tiling Scheme window.

note

Changes will only take effect after the next server reboot.

  1. Click the OK button to dismiss the confirmation message.

Figure 4-29

Figure 4-29 Confirmation message for server configuration parameter changes

Configure Preview Options​

note

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.

  1. 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.

  2. If desired, change the Map Scale Factor parameter. Refer to DefaultMaxScale Factor in Server Parameters for a detailed description of this parameter.

  3. Click the OK button to submit your change.

Figure 4-30

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.

Verified against MapCore 12.5.0