Setting Maritime Chart Service properties

The following sections describe how to configure your map service to run Maritime Chart Service.

Nota:

If you haven't already done so, make sure you have enabled Maritime Chart Service by following the steps in Configuring ArcGIS for Maritime Server.

Adding the Maritime Chart Service capability to a map service

The following steps describe how to add the Maritime Chart Service capability to your map service. These steps should be repeated for each map service you plan to use with Maritime Chart Service.

1. Restart ArcGIS Server through the Services manager in Windows, right-click the service named ArcGIS Server, and click Restart.

   This ensures that the server account has the correct permissions to the newly installed ArcGIS for Maritime: Server software.

2. Log in to ArcGIS Server Manager by opening your manager URL in a web browser.

   Your manager URL is https://gisserver.domain.com:6443.

   For more information, see Logging in to Manager.

3. Click Services on the top panel of the page.
4. Click on the map service for which you want to enable the Maritime Chart Service.

   The Maritime Chart Service works with any existing map service.

5. Click Capabilities and check the Maritime Chart Service check box.
6. Click Save or Save & Restart.

Modifying your default map service properties

The Maritime Chart Service requires that your map service has the following property settings. Your map service must be set to LOW Isolation. The only exception is if you have HIGH Isolation running with both minimum and maximum instances per node (machine) set to 1.

1. If necessary, log in to ArcGIS Server Administrator by opening your URL in a web browser.

   Your Administrator URL is https://gisserver.domain.com:6443/arcgis/admin.

   For more information, see Using the Administrator Directory.

2. Click services in the Resources list.
3. Click the map service from which you enabled Maritime Chart Service.
4. Scroll to the bottom of the page and click edit in the Supported Operations section.
5. Set your minInstancesPerNode and maxInstancesPerNode to the same value.
6. Set your instancesPerContainer to a value that is equal to or greater than the maxInstancesPerNode value.
7. Set isolationLevel to LOW.
8. Click Save Edits.

   Your map service will automatically restart.

Nota:

It is recommended that the number entered for minimum and maximum number of instances per node (machine) be no greater than the number of cores you want to allocate to the map service.

Your Maritime Chart Service configuration is complete. You are now ready to load S-57 datasets into your service as well as configure the sample viewer. You can download the sample web viewer from GitHub; it shows how to use the Maritime Chart Service capability.

• For more information on loading S-57 datasets, see Managing data for unencrypted S-57 datasets or Managing data for S-63 encrypted datasets.
• If you plan to run Maritime Chart Service on multiple map services, see Supporting multiple map services.

Modifying Maritime Chart Service capabilities properties

There are three directory paths that allow various configurations of the Maritime Chart Service: Datasets, ControlFiles, and Working directory. The directory paths and the steps to modify them are explained in detail in the following sections.

Nota:

It is highly recommended that the workingDirectory path be set to the local server to optimize draw performance. If you are setting up a second map service to run Maritime Chart Service that will be isolated from your first map service, see Setting up a second map service with Maritime Chart Service enabled.

Datasets directory

The datasetsDirectory property points to the location of your datasets folder. This location can be local to the map service or shared across a network path.

• <Installation path>:\arcgisserver\directories\maritimeserver\maritimechartservice—This location is in your datasetsDirectory property, which is defaulted to your ArcGIS Server directories location.

• datasets—This is where you put your S-57 datasets, which can include an exchange set and or individual .000, and associated update (.001…002…) and external (.txt and .tiff) files.

The datasets folder location can also be shared by more than one map service running the Maritime Chart Service. A benefit of using the datasetsDirectory property as a shared location is that it allows you to set up multiple map services with only one set of data. This allows easy maintenance while providing multiple types of services. For example, you can use your single set of S-57 datasets to publish a full coverage ENC service while also using the same S-57 datasets to publish a navigational aids only map service. There are no limits on the number of map services with which you can share S-57 datasets; see Supporting multiple map services for more examples.

ControlFiles directory

The controlFilesDirectory property points to the location of your control files. This location can be local to the map service or shared across a network path.

• <Installation path>:\arcgisserver\directories\maritimeserver\maritimechartservice—This location is in your controlFilesDirectory property, which is defaulted to your ArcGIS Server directories location.

• controlFiles—This directory contains your S-57 data dictionary information and the S-52 presentation library. When the service is started and the .senc files are created, these control files are being accessed.

You can now keep the control files local to your map service while pointing to a single set of S-57 datasets. This allows you to configure multiple services with different default configuration settings. For example, you can use your single set of S-57 datasets to publish five different map services. Each service could have a separate default color scheme or list of layers that are exposed. You can set one map service control files to only show one layer, which is your navigational aids while your other map service provides full ENC coverage.

Working directory

The workingDirectory contains two folders that the service accesses when started. The workingDirectory property path should always be local to the server running the map service.

Nota:

Mapped network drives are not supported for this setting.

• <Installation path>:\arcgisserver\directories\maritimeserver\maritimechartservice—This location is in your workingDirectory property, which is defaulted to your ArcGIS Server directories location.

• logs—Contains time-stamped log files created by the service when the map service is started or when AutoCellUpdate is used. For more information, see AutoCellUpdate.

• sencs—Contains the .senc files created by the service and the find.dat file.

Modifying the directories

1. If necessary, log in to ArcGIS Server Administrator by opening your URL in a web browser.

   Your Administrator URL is https://gisserver.domain.com:6443/arcgis/admin.

   For more information, see Using the Administrator Directory.

2. Click services in the Resources list.
3. Click the map service from which you enabled Maritime Chart Service.
4. Click Capabilities and scroll down to the Properties section.
5. Modify your controlFilesDirectory, datasetsDirectory, or workingDirectory path, if necessary.
6. Click Save or Save & Restart.