Skip to main content

Download and install product data files

Available with an ArcGIS Topographic Mapping license.

Product data files provide business rules and a framework for becoming productive by ensuring standardization and consistency across your operations. Preconfigured databases, cartographic templates, applications, and services help you produce high-quality authoritative content that can be used to publish maps, perform analysis, and share the results throughout your organization.

Ensure that the following prerequisites are completed before installing the Topographic Mapping product files:

Once the ArcGIS Topographic Mapping server extension is authorized, you can download and install the product data files.

Download

Do the following to download the product files:

Note:

You must have the appropriate privileges to access downloads from your My Esri account.

  1. Sign in to My Esri.

  2. Click the Downloads tab.

    A list of the latest versions for various software options appears.

  3. Click the software with the product files you want to download.

    The expanded Product components node for the software appears.

    Note:

    Downloadable content is organized by node.

  4. Locate the extension in the Data and content node, and click Download.

    Note:

    Expand the Data and content node if necessary.

    The product files installer download begins.

Install

The product data files download contains the setup program.

Do the following to complete the setup:

  1. Start the extraction program you downloaded in the previous workflow.

  2. Optionally, change the destination folder for the extraction.

  3. Click Next.

  4. Click Close.

    The Launch the setup program check box is checked by default and starts the product file installation.

    Note:

    To run the setup program later, uncheck Launch the setup program before clicking Close. Browse to the installer location to run the installer (.msi file) at a later time.

  5. Click Next.

  6. Review the license agreement and accept it if you agree.

  7. Click Next.

    The setup program Destination Folder page appears with the default installation location shown:

    C:\Users\Public\Public Documents

  8. Optionally, click Change to choose a different destination folder.

  9. Click Next.

  10. Click Install.

  11. Click Finish.

    The product files are installed to the defined location.

Install files silently

The product files can be installed by running the setup program in a Command Prompt window. To install product files in a command prompt, complete the following steps:

  1. Open a Command Prompt window as an administrator.

  2. Run the following command:

    msiexec.exe /i <path to downloaded .msi file>\<product>.msi INSTALLDIR="<path to installation location>" /qb
    
    Note:

    The /qb switch provides the basic UI of the progress status and error handling, /qr provides a reduced UI, and /qn provides no UI at all.

    Learn more about Microsoft Standard Installer command-line options

    The product files are installed.

Topographic Mapping product file folders

The ArcGIS Topographic Mapping product files installer contains product files used in data and map production, including ArcGIS Workflow Manager workflows.

The Topographic Mapping product files installer copies the following folders to the specified installation location:

<installation location>\ArcGIS Topographic Mapping\Product Files\<Version>

  • Applications

  • CTM

  • Custom

  • Generalization

  • GridTemplates

  • Mgcp

  • Muvd

  • ReferenceData

  • Tds

  • Workflows

Uninstall files silently

Complete the following steps to uninstall product files silently:

  1. Open a Command Prompt window as an administrator.

  2. Run the following command:

    msiexec.exe /x <{product code}> /qb
    

    The product codes are in your machine's registry at HKEY_LOCAL_MACHINE\SOFTWARE\ESRI.

    Note:

    For the latest product codes, review the product code list [PDF].

The product files are uninstalled.

Download

Do the following to download the product files:

Note:

You must have the appropriate privileges to access downloads from your My Esri account.

  1. Sign in to My Esri.

  2. Click the Downloads tab.

    A list of the latest versions for various software options appears.

  3. Click the software with the product files you want to download.

    The expanded Product components node for the software appears.

    Note:

    Downloadable content is organized by node.

  4. Locate the extension in the Data and content node, and click Download.

    Note:

    Expand the Data and content node if necessary.

    The compressed product files begin to download.

Install

Once the compressed files are downloaded, complete the following steps to install the product files:

  1. Sign in to the same machine that was used to install ArcGIS Server.

    Note:

    This must be the same user account that installed ArcGIS Server so that the properties from the .ESRI file included with the ArcGIS Server install are accessible.

  2. Browse to the location that contains the ArcGIS-Topographic-Mapping-Enterprise-<version>.<build number>.tar.gz setup package.

    This location also contains a Setup.sh file.

  3. Run the following command to run the Setup.sh and install the product files:

    $ ./ArcGISTopographicMapping/Setup.sh

  4. Once the installation is complete, browse to <installation location>/topographicmapping/productfiles to verify that the following contents were installed:

    • Applications

    • buildnum.txt

    • Ctm

    • Custom

    • Generalization

    • GridTemplates

    • Mgcp

    • Muvd

    • ReferenceData

    • Tds

    • uninstall_TopographicMapping.sh

    • Workflows

The product files are now installed on the machine.

Set variables

Additional configuration to your instance of ArcGIS Server is required to work with the Topographic Mapping product files. You must set environment variables for ArcGIS Server.

Note:

You will need a command-line text editor installed.

Complete the following steps to set the variables for the Topographic Mapping product files:

  1. Browse to the ArcGIS Server location:

    cd <installation location>/server/

  2. Browse to the user subfolder where the init_user_param.sh file that must be modified is located.

    cd usr

    Caution:

    Create a backup of this file before you begin to modify it.

    The following is an example command that can be used to create a backup of the file:

    cp init_user_param.sh init_user_param_BACKUP.sh

    You may need to include sudo if access to the file requires elevated permissions.

  3. Edit the init_user_param.sh file using a command-line text editor

    The following example command uses the nano command-line text editor:

    nano init_user_param.sh

    Note:

    You may need to provide your ArcGIS Server account password or include sudo if access to the file requires elevated permissions.

    The file opens.

  4. Scroll to the Modify this section to configure ArcGIS Topographic Mapping section near the end of the file and provide the following using the path to the ArcGIS Server installation location:

    #------------------------------------------------------------------------------------------
    # Modify this section to configure ArcGIS Topographic Mapping
    #
    #------------------------------------------------------------------------------------------
    export ARCGIS_TOPOGRAPHIC_MAPPING=<path_to_install>/topographicmapping/productfiles
    export TOPOGRAPHIC_MAPPING_CUSTOM_FILES=<path_to_install>/topographicmapping/productfiles/Custom
    export TOPOGRAPHIC_MAPPING_JOBS_DIR=<path_to_install>/topographicproduction
    
  5. Save your changes according to the command-line text-editor you're using and exit the file.

  6. Browse to the ArcGIS Server installation location.

  7. Stop the server.

    ./stopserver.sh

  8. Start the server.

    ./startserver.sh

The environment variables are set.

Uninstall the product files

You can run the following command while in the <installation location>/topographicmapping/productfiles location to uninstall the product files:

./uninstall_TopographicMapping.sh

Note:

Running this command removes any files that the installer included. Any items outside of the installation will remain after this uninstall command is run.