Upgrade an existing ArcGIS Maritime server extension installation

Available with Standard or Advanced license.

Available with Production Mapping license.

Available with ArcGIS Maritime license.

The ArcGIS Maritime server extension setup package is designed to detect and upgrade from an existing installation of Mapping and Charting Solutions on the target system. If you upgrade to ArcGIS Server 11.1, you must upgrade your previous ArcGIS Maritime or Mapping and Charting Solutions to the ArcGIS Maritime 11.1 server extension. You cannot run mismatched versions of software.

Note:

If you already have Maritime server or Mapping and Charting Solutions installed, the Maritime server extension setup automatically upgrades it to ArcGIS Maritime 11.1. After the upgrade, only the ArcGIS Maritime 11.1 server extension will appear in your list of programs.

Upgrade from an earlier version of Maritime Chart Service (10.5-10.8)

To upgrade to ArcGIS Maritime 11.1, you must complete the following steps to delete the existing Maritime server object extension (SOE).

If you are upgrading an existing 10.5 or later version to 10.8, perform the steps in the following section to upgrade from a 10.8.1 or later version of Maritime Chart Service.

Note:

You may notice maps with Maritime Chart Service enabled no longer have Maritime Chart Service listed under the map service's capabilities. This is due to the added support for the Authoring Application coming from ArcGIS Pro. Before 10.8.1, the Authoring Application supported ArcMap. Your services will be restored once the following steps are completed.

Note:

You can install a Maritime server extension Maritime Chart Service on a new machine for the first time.

1. Sign in to the machine as a user with administrative privileges.
2. Start the ArcGIS Maritime server extension setup program.
3. Click Next on the Welcome to the ArcGIS Maritime server extension Setup Program pane of the installation wizard.

   The License Agreement dialog box appears.

4. Review the license agreement and accept it or close the dialog box if you do not agree with the terms.
5. Click Next.

   The Custom Setup dialog box appears.

   Note:

   PDF Merge Support is required for Custom Chart Builder (CCB) deployments. Without this feature, PDF documents cannot be exported from the Custom Chart Builder (CCB) app.

6. The default installation location is C:\ProgramFiles\ArcGIS\MaritimeServer\Server<version>. Accept the default directory or choose a different location, and click Next.

   The Ready to install the Program dialog box appears.

7. Click Install to begin installation.

   Once the installation is complete, the InstallShield Wizard Completed dialog box appears.

8. Click Finish.
Maritime server is now installed on the local machine. To install Maritime server in a multimachine deployment, repeat the installation steps on each machine.
9. Sign in to ArcGIS Server Manager.
10. Click Services.
11. Click the Stop button next to the map service with Maritime Chart Service capabilities configured.
12. Copy the controlfiles folder from <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice to a backup location, then delete it from the maritimechartservice folder.
13. Copy the new controlfiles folder from <ArcGIS Maritime Server installation directory>\MaritimeServer\Server\maritimechartservice to <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice.

    Note:

    Consolidate any modifications from the backup control files with the new control files. For example, coordinate systems and AutoCellUpdate settings.

14. If the map service was configured to process S-63 encrypted datasets, copy the S-63 user-permit.txt file from the backup controlfiles folder to the new controlfiles folder.
15. Delete the .senc files from <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice\sencs.

    The .senc files must be rebuilt after upgrading. Deleting them improves creation performance.

16. Repeat the steps for each map service with Maritime Chart Service capabilities configured.
17. Sign in to the machine as a user with administrative privileges.
18. Click Site.
19. Click Extensions in the Server Configuration window.
20. Click the Delete button in the MaritimeServer.soe row to remove it.

    If you do not delete the existing MaritimeServer.soe file from your ArcGIS Server site, you may receive an update error when adding the new MaritimeServer.soe file.

21. Click Add Extension.
22. Click Choose File and browse to <ArcGIS Maritime Server installation directory>\MaritimeServer\Server<version>\Bin.
23. Click MaritimeServer.soe.
24. Click Add.

    The MaritimeServer.soe file is now successfully added.

25. Click the Services tab.
26. Click the map service to which you want to add Maritime Chart Service.

    Maritime Chart Service works with any existing map service.

27. In the Map Services window, click Capabilities.
28. Check the Maritime Chart Service check box.
29. Verify that the datasetsDirectory, controlFilesDirectory, and workingDirectory parameters point to the correct locations.

    Learn more about modifying the Maritime Chart Service capabilities properties

30. Click Save and Restart to make Maritime Chart Service available.

    Note:

    To confirm the Maritime Chart Service capabilities are working properly in the map service, verify that the .senc files in the sencs folder are current.

31. Repeat the previous steps for each map service with Maritime Chart Service capabilities configured.

Use sample Web AppBuilder widgets to deploy custom web apps and try the latest features available with Maritime widgets.

Learn more about what's new for ArcGIS Maritime

Note:

Once you have upgraded to the latest version of the Maritime server extension, you can deploy Custom Chart Builder (CCB).

Upgrade Maritime Chart Service (10.8.1 and later)

If you are upgrading from a 10.8 or earlier version of Maritime Chart Service, you must delete the existing MaritimeServer.soe by performing the steps in the previous section to upgrade Maritime Chart Service from version 10.5-10.8. This is due to the new support for the Authoring Application in ArcGIS Pro. Before 10.8.1, the Authoring Application supported ArcMap.

To upgrade to 10.8, you must upgrade the software, MaritimeServer.soe, and map services with Maritime Chart Service configured.

Complete the following steps to upgrade Maritime Chart Service:

1. Sign in to the machine as a user with administrative privileges.
2. Start the ArcGIS Maritime server extension setup program.
3. Click Next on the Welcome to the ArcGIS Maritime server extension Setup Program pane of the installation wizard.

   The License Agreement dialog box appears.

4. Review the license agreement and accept it or close the dialog box if you do not agree with the terms.
5. Click Next.

   The Custom Setup dialog box appears.

   Note:

   PDF Merge Support is required for Custom Chart Builder (CCB) deployments. Without this feature, PDF documents cannot be exported from the Custom Chart Builder (CCB) app.

6. The default installation location is C:\ProgramFiles\ArcGIS\MaritimeServer\Server<version>. Accept the default directory or choose a different location, and click Next.

   The Ready to install the Program dialog box appears.

7. Click Install to begin installation.

   Once the installation is complete, the InstallShield Wizard Completed dialog box appears.

8. Click Finish.
Maritime server is now installed on the local machine. To install Maritime server in a multimachine deployment, repeat the installation steps on each machine.
9. Sign in to ArcGIS Server Manager.
10. Click Services.
11. Click the Stop button next to the map service with Maritime Chart Service capabilities configured.
12. Copy the controlfiles folder from <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice to a backup location, then delete it from the maritimechartservice folder.
13. Copy the new controlfiles folder from <ArcGIS Maritime Server installation directory>\MaritimeServer\Server\maritimechartservice to <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice.

    Note:

    Consolidate any modifications from the backup control files with the new control files. For example, coordinate systems and AutoCellUpdate settings.

14. If the map service was configured to process S-63 encrypted datasets, copy the S-63 user-permit.txt file from the backup controlfiles folder to the new controlfiles folder.
15. Delete the .senc files from <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice\sencs.

    The .senc files must be rebuilt after upgrading. Deleting them improves creation performance.

16. Repeat the steps for each map service with Maritime Chart Service capabilities configured.
17. Sign in to ArcGIS Server Manager.
18. Click Site.
19. Click Extensions in the Server Configuration window.
20. Click the Edit Extension button next to MaritimeServer.soe to update the extension.
21. Click Choose File and browse to <ArcGIS Maritime Server installation directory>\MaritimeServer\Server<version>\Bin.
22. Click MaritimeServer.soe.
23. Click Add.

    The MaritimeServer.soe file is now successfully added.

24. Click the Services tab.
25. Click the map service to which you want to add Maritime Chart Service.

    Maritime Chart Service works with any existing map service.

26. In the Map Services window, click Capabilities.
27. Check the Maritime Chart Service check box.
28. Verify that the datasetsDirectory, controlFilesDirectory, and workingDirectory parameters point to the correct locations.

    Learn more about modifying the Maritime Chart Service capabilities properties

29. Click Save and Restart to make Maritime Chart Service available.

    Note:

    To confirm the Maritime Chart Service capabilities are working properly in the map service, verify that the .senc files in the sencs folder are current.

30. Repeat the previous steps for each map service with Maritime Chart Service capabilities configured.

Use sample Web AppBuilder widgets to deploy custom web apps and try the latest features available with Maritime widgets.

Learn more about what's new for ArcGIS Maritime

Note:

Once you have upgraded to the latest version of the Maritime server extension, you can deploy Custom Chart Builder (CCB).

Upgrade Custom Chart Builder (CCB)

Before starting the upgrade process, you should back up your existing Custom Chart Builder (CCB) deployment. Doing so facilitates the new deployment by preserving some of your settings. It is critical to back up your existing deployment if you made customizations to the web app or Custom Chart Builder (CCB) configuration files.

Once you have backed up your existing Custom Chart Builder (CCB) deployment, you can redeploy the new version of Custom Chart Builder (CCB). Once complete, you can merge any previous configuration changes.

Common software upgrade questions

The following are frequently asked questions about upgrading ArcGIS Maritime:

If I have a multimachine server deployment, do I need to upgrade each machine?

Yes, all machines in the multimachine deployment must be upgraded to the same version of ArcGIS Server and the Maritime server extension.

Do I need to uninstall a previous version of Mapping and Charting Solutions before installing the Maritime server extension?

No, if you already have Mapping and Charting Solutions installed, the Maritime server extension setup will automatically upgrade it to ArcGIS Maritime 11.1. After the upgrade, you will only see the ArcGIS Maritime 11.1 server extension in your list of programs.

Do I need to back up anything before installing the Maritime server extension?

Refer to the Upgrade the Maritime Chart Service (10.8.1 and later) section.

Do I need to stop my GIS services and ArcGIS Server before installing the Maritime server extension?

No, the setup restarts ArcGIS Server after the installation.

If I upgrade to ArcGIS Server 11.1, do I also need to upgrade my Mapping and Charting Solutions?

Yes, the version of the Maritime server extension must match ArcGIS Server. You cannot run mismatched versions of software. When you upgrade, you will no longer see Mapping and Charting Solutions; the ArcGIS Maritime server extension will appear in your programs list instead.