Skip To Content

Setting Maritime Chart Service properties

In this topic

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

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 for 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 http://<server name>:6080/arcgis/manager. 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.

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

    Your manager URL is http://<server name>:6080/arcgis/manager. For more information, see Logging in to Manager.

  2. Click Services on the top panel of the page.
  3. Click the map service from which you selected the Maritime Chart Service.
  4. Click Pooling and enter the same number for your minimum and maximum number of instances per machine.
    Note:

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

  5. Click Processes and set your Run instances of this configuration to low isolation.
  6. Click Save or Save & Restart.

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.

Modifying your HOSTNAME map service property for HTTPS

The Maritime Chart Service supports HTTP by default. If your environment requires HTTPS support, you will need to modify the Maritime Chart Service HOSTNAME property.

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

    Your manager URL is http://<server name>:6080/arcgis/manager. For more information, see Logging in to Manager.

  2. Click Services on the top panel of the page.
  3. Click the map service from which you selected the Maritime Chart Service.
  4. Click Capabilities and in the Properties section, scroll down to hostname.
  5. Modify your hostname property to include https.

    For example, https://<hostname>

  6. Click Save or Save & Restart.

Modifying your HOSTNAME map service property for WMS

The Maritime Chart Service supports port 80 for WMS by default. If you require a different port number, you will need to modify the Maritime Chart Service HOSTNAME property.

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

    Your manager URL is http://<server name>:6080/arcgis/manager. For more information, see Logging in to Manager.

  2. Click Services on the top panel of the page.
  3. Click the map service from which you selected the Maritime Chart Service.
  4. Click Capabilities and in the Properties section, scroll down to hostname.
  5. Modify your hostname property to include the new port number.

    For example, <hostname>:6080. If you are also supporting HTTPS your hostname property would be https://<hostname>:6443

  6. Click Save or Save & Restart.

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.

Note:

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. If not local to the server, the draw performance will not be optimized.

  • <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 Manager by opening your manager URL in a web browser.

    Your manager URL is http://<server name>:6080/arcgis/manager. For more information, see Logging in to Manager.

  2. Click Services on the top panel of the page.
  3. Click the map service from which you selected the 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.