Upgrade an existing ArcGIS Maritime server extension installation

Disponible avec une licence Standard ou Advanced.

Disponible avec une licence Production Mapping.

Disponible avec une licence ArcGIS Maritime.

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.0, you will need to upgrade your previous Mapping and Charting Solutions to the ArcGIS Maritime 11.0 server extension. You cannot run mismatched versions of software.

Remarque :

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

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

To upgrade to ArcGIS Maritime 11.0, you will need to complete the following steps to delete your 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.

Remarque :

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 new support for 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.

Remarque :

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.

   Remarque :

   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>. If you accept the default directory, 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.
9. Repeat the previous steps for each machine in a multimachine site.
10. Sign in to ArcGIS Server Manager.
11. Click Services.
12. Click the Stop button to the right of the map service with Maritime Chart Service capabilities configured.
13. Move the controlfiles folder from <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice\controlfiles to a backup location.
14. Copy the new controlfiles folder from <ArcGIS Maritime Server install directory>\MaritimeServer\Server<version>\maritimechartservice to <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice.

    Remarque :

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

15. 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.
16. Delete the .senc files from <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice\sencs.

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

17. Repeat the steps for each map service with Maritime Chart Service capabilities configured.
18. Sign in to ArcGIS Server Manager.
19. Click Site.
20. Click Extensions in the Server Configuration window.
21. Click the Delete button to the right of MaritimeServer.soe to remove the SOE.

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

22. Click Add Extension.
23. Click Browse and browse to <ArcGIS Maritime Server install directory>\MaritimeServer\Server<version>\Bin.
24. Click MaritimeServer.soe.
25. Click Add.

    The MaritimeServer.soe is now successfully added.

26. Click the Services tab.
27. Click your map service.
28. In the Map Services window, click Capabilities.
29. Check the Maritime Chart Service check box.
30. Verify that the datasetsDirectory, controlFilesDirectory, and workingDirectory properties point to the correct locations.

    Learn how to modify the Maritime Chart Service capabilities properties

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

    Remarque :

    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.

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

Remarque :

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 version of Maritime Chart Service 10.8 or earlier, 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 Authoring Application in ArcGIS Pro. Before 10.8.1, the Authoring Application supported ArcMap.

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

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.

   Remarque :

   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>. If you accept the default directory, 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.
9. Repeat the previous steps for each machine in a multimachine site.
10. Sign in to ArcGIS Server Manager.
11. Click Services.
12. Click the Stop button to the right of the map service with Maritime Chart Service capabilities configured.
13. Move the controlfiles folder from <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice\controlfiles to a backup location.
14. Copy the new controlfiles folder from <ArcGIS Maritime Server install directory>\MaritimeServer\Server<version>\maritimechartservice to <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice.

    Remarque :

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

15. 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.
16. Delete the .senc files from <ArcGIS Server installation drive>\arcgisserver\directories\maritimeserver\maritimechartservice\sencs.

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

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

    The MaritimeServer.soe is now successfully added.

25. Click the Services tab.
26. Click your 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 properties point to the correct locations.

    Learn how to modify the Maritime Chart Service capabilities properties

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

    Remarque :

    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.

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

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.0. After the upgrade, you will only see the ArcGIS Maritime 11.0 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.0, 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.