Some geographic transformations (for example, NTv2, GEOCON, and NADCON5) and vertical transformations based on geoids, quasi-geoids, or other conversion grids (for example, EGM and VERTCON) require additional coordinate system files to properly render features.
The following are the additional coordinate system files that you can use on ArcGIS Server machines:
- ArcGIS Coordinate Systems Data—Install ArcGIS Coordinate Systems Data on all machines in stand-alone and federated ArcGIS GIS Server sites, including the hosting server site.
- Coordinate System Data (Hosted Services) file—Place the Coordinate System Data (Hosted Services) file on all machines in the hosting server site.
- Third-party transformation grids—You may need to obtain transformation grids from the appropriate third-party providers and place them on machines in stand-alone and federated ArcGIS GIS Server sites, including the hosting server site.
Install ArcGIS Coordinate Systems Data
The ArcGIS Coordinate Systems Data component is required when working with very accurate geographic transformations or with 3D datasets. See the list of supported geographic and vertical transformations to find which transformations require the grid files that are installed with ArcGIS Coordinate Systems Data.
Follow the steps below to install ArcGIS Coordinate Systems Data.
- Download the ArcGIS
Coordinate Systems Data installation from My Esri.
The file name is ArcGIS_Coordinate_Systems_Data_Windows_<release_part#>.
- Place the installation file on each machine in all GIS Server sites in your deployment.
- Browse to the location where you placed the ArcGIS Coordinate Systems Data file, and double-click the ArcGIS_Coordinate_Systems_Data_Windows_<release_part#> file to start the installation process.
- Accept the destination folder to which files are extracted and placed in a folder named CoordinateSystemsData, or click Browse to select a different destination.
The default destination folder for the CoordinateSystemsData folder and files is <System Drive>\Users\<username>\Documents\ArcGIS <version>.
- Click Next.
A message indicates when the files have been successfully extracted, and the Launch the setup program check box is checked by default.
Note:
To install the software later, uncheck the Launch the setup program check box and click Close. When you're ready to install, browse to the CoordinateSystemsData folder in the destination you specified in the previous step, and double-click Setup.exe.
- Click Close.
- In the Welcome to the ArcGIS Coordinate Systems Data Setup program window, click Next.
- Review the license agreement and choose an option:
- If you agree to the terms, click the option to accept the agreement and click Next.
- If you do not agree to the terms, click Cancel to exit the installation.
- Optionally, in the Select Features window, choose the grids to exclude from the installation. Click the corresponding button in the list and choose This feature will not be available.
If you later require a feature you excluded from the original installation, you can modify the installation.
- In the same window, accept the default installation folder location, or click Change to specify a different folder.
Ensure you selected one of the features to install to enable the option to change installation folders.
- Click Next.
- Click Install.
- When the installation is complete, click Finish.
Modify or remove ArcGIS Coordinate Systems Data
If you require additional coordinate system grids that you did not install initially, you can modify the ArcGIS Coordinate Systems Data installation to install those missing files.
You can uninstall ArcGIS Coordinate Systems Data if you no longer need any of the coordinate systems it provides.
Follow these steps to modify the ArcGIS Coordinate Systems Data installation:
- Sign in to the machine as a Windows administrator and open the list of installed software.
There are multiple ways to access the list of software installed on Microsoft Windows machines, and how you access the list varies by Windows version. If you are unsure how to access the software list, consult the Microsoft documentation for the version of Windows that you are using.
- Select ArcGIS
Coordinate Systems Data from the software list.
- To uninstall all components of ArcGIS Coordinate Systems Data, click Uninstall. When prompted to confirm that you want to uninstall, click Yes.
- To alter what features are installed, click Modify or Change to access the ArcGIS Coordinate Systems Data Setup wizard, and proceed with the remaining steps.
- Ensure Modify is selected and click Next.
- Choose which set of coordinate systems data to add or remove from this machine:
- To install all coordinate system data, click the drop-down menu next to Coordinate Systems Data and choose This feature, and all subfeatures, will be installed on local hard drive.
- To install an individual coordinate systems data set, click the drop-down menu next to the set and click This feature will be installed on local hard drive.
- To remove an individual coordinate systems data set, click the drop-down menu next to the set and click This feature will not be available.
- Click Next.
- Click Install.
Update the ArcGIS Coordinate System Data (Hosted Services) file
After you install or upgrade your ArcGIS Enterprise deployment, update the coordinate system data file on the machines in the hosting server site. This file is used by hosted services.
Note:
The following workflow requires your ArcGIS Enterprise deployment to be temporarily unavailable while files are updated.
Obtain the ArcGIS Coordinate System Data (Hosted Services) file
Download and extract the file you need to place on the hosting server machines.
- Download the ArcGIS Coordinate System Data (Hosted Services) compressed file from My Esri.
- Browse to the location where you placed the ArcGIS Coordinate Systems Data (Hosted Services) file and extract the compressed file.
The extracted folder contains a single file named jpe-sdk-data.jar. This is the file you will place on the hosting server machines.
Tip:
Keep a backup copy of the jpe-sdk-data.jar file that you downloaded. If you repair the ArcGIS Server installation, this file is removed and you must replace it. The file is also removed if you uninstall the software.
Place the file on hosting server machines
Follow these steps to replace the jpe-sdk-data.jar file on each machine in the hosting server site:
- Sign in to each machine in the hosting server site using a Microsoft Windows administrator login.
- Stop the ArcGIS Server service on each machine in the hosting server.
- Browse to \ArcGIS\Server\framework\lib\shared_arcgis in the ArcGIS Server directory and rename the existing jpe-sdk-data.jar file to jpe-sdk-data.oldjar.
- Place the jpe-sdk-data.jar file you extracted from the ArcGIS Coordinate Systems Data (hosted services) download in the shared_arcgis directory.
- Start the ArcGIS Server service on each machine in the hosting server.
Add third-party transformation grids
For some grid-based geographic and vertical transformations, ArcGIS Server includes their definitions but does not distribute the grid files due to license restrictions. You must obtain these grid files directly from their third-party provider or government agency. In some cases, you may need to purchase the grid files from their provider.
Once you obtain the grid files you require and you have installed ArcGIS Coordinate Systems Data on each machine in the ArcGIS Server site, create subfolders in the CoordinateSystemsData\pedata folder in the installation location on each machine in the site. Sort files into folders by transformation method name, such as NTv2 or vertical\geoid. NTv2 files are further sorted into a country folder. For detailed instructions, contact your local distributor.