Configure ArcGIS Maritime

Available with Standard or Advanced license.

Available with Production Mapping license.

Available with ArcGIS Maritime license.

ArcGIS Maritime uses a server object extension (SOE). You must add the SOE to your ArcGIS Server Manager site to enable Maritime Chart Service functionality for a map service.

Review the following system requirement information before you set up your service:

• Mapped network drives are not recommended for the workspaceDirectories property setting due to potential performance issues. It is recommended that the .senc files be stored on the physical server.
• Maritime Chart Service can only be enabled on a dedicated instance type. Shared instance pools are not supported.
• You will exceed a URL length of 2,048 characters if you use display properties in your GET request. POST is not necessarily supported in all third-party apps. If you cannot support POST in your apps, it is recommended that you increase your allowable URL length using a web.config.xml file.
• It is recommended that you increase your map service's javaHeapSize value from the default 128 MB to 2048 MB or greater, depending on your system resources and the number of datasets in your service. The queryDataset operation can exceed this default limit.
• By default at ArcGIS Enterprise 11.0, new map services with a dedicated instance pool will have the minimum and maximum number of instances per machine set to zero. It is highly recommended that the minimum and maximum number of instances per machine be set to 1. This will ensure that when your map service with Maritime Chart Service (MCS) enabled is started, the cataloging process will automatically start. This was the default setting in previous versions of ArcGIS Enterprise. Without this minimum setting of 1, a request will need to be made to the one of the Maritime Chart Service endpoints to start the cataloging process and could cause delays in response time. The cataloging process is when MCS scans the datasets folder and builds the necessary .senc files. For more information on changing instance setting, refer to Configure service instance settings.

Enable Maritime Chart Service

Complete the following steps to enable Maritime Chart Service:

1. Create a folder named maritimeserver in the ArcGIS Server site at <ArcGIS Server installation drive>/usr/directories/.

   Note:

   If this location doesn't exist, verify that your ArcGIS Server site has been created.

   Learn more about creating an ArcGIS Server site

2. Copy the maritimechartservice folder from <ArcGIS Server installation directory>/MaritimeServer folder to the maritimeserver folder.

   Note:

   The setup steps provide a default location and name to deploy the configuration files. The name of the maritime chart service folder and location may differ depending on your organization's requirements.

3. Sign in to ArcGIS Server Manager.
4. Click Site.
5. In the Server Configuration window, click Extensions.
6. Click Add Extension.
7. Click Choose File and browse to <ArcGIS Server installation directory>/MaritimeServer/Bin.
8. Click MaritimeServer.soe.
9. Click Add.

   The MaritimeServer.soe file is added.

10. Click the Services tab.
11. Click the map service to which you want to add Maritime Chart Service.

    Maritime Chart Service works with any existing map service.

12. Click Capabilities and check the Maritime Chart Service check box.
13. Verify that the Maritime Chart Service properties are configured correctly.

    Note:

    The MaritimeServer.soe has default values set to populate the Maritime Chart Service capabilities properties. You will need to modify these values based on your setup.

14. Click Save and Restart to restart the map service.

    Maritime Chart Service capabilities are now enabled.

You are now ready to load S-57 and S-63 datasets to your map service.

Note:

Default configuration settings can be modified.

Troubleshoot the Maritime server extension configuration

Use the following frequently asked questions to troubleshoot configuration issues:

My Maritime Chart Service does not display or disappears after changing my display properties

Determine whether you exceeded the server URL length of 2,048 characters when using display parameters. If so, increase the allowable URL length in the web.config.xml file.

I received an error for failure to enable HTTPS on the web server

Verify you have enabled HTTPS on your web server.