Hexagon Geospatial


WebGIS enables powerful geospatial web applications and services that securely share your organization’s rich geospatial data, and provides tools to deeply examine spatial data and create value added products, on demand.
Showing results for 
Search instead for 
Do you mean 

How to migrate WebGIS installation from test to production environment?

by Technical Evangelist on ‎06-05-2018 01:42 AM - edited a week ago (371 Views)


How do I perform WebMap services and Geospatial Portals migration from a test environment to production? Or the only way to do it is re-creating all instances manually?


Please follow the lists below based on the service / application used.

WebMap services

  1. Re-create service instances on the PROD via AdminConsole to automate IIS applications and AppPools creation.
  2. Migrate customizations of the service instances:
    • The web.config modifications are crucial for the services.
    • The XML template files with metadata information are usually modified as well.
  3. Manually copy service sources:
    • folders: WebMap Publisher Projects, WebMap Publisher Data
    • registry: HKLM\SOFTWARE\WOW6432Node\Intergraph\GeoMedia WebMap Publisher\Services
  4. Make sure that all database connections are valid and data files are accessible from the production server.
    • A simple test is to open the service source in GeoMedia and try the command Populate the GeoWorkspace from Metadata from WebMap Publisher Administrator. If there are no connection errors, you should be fine.
    • Try to Initialize the service source via Service Source Configuration Utility tool.
  5. (optional) Make sure that those folders have the same CSF files between the servers:
    • C:\Program Files (x86)\Hexagon\GeoMedia WebMap\program\EPSG
    • C:\Program Files (x86)\Common Files\Intergraph\GeoMedia\Program\EPSG
    • C:\Program Files (x86)\Common Files\Intergraph\Coordinate Systems\3.0\EPSG

Geospatial Portal

  1. Create copies of Portal instances through AdminConsole on the PROD to automate IIS applications and AppPools creation.
  2. Migrate and merge web.config's.
  3. (optional) Migrate C:\Program Files\Common Files\Hexagon\Services\Instances\<Portal>\App_Data\Maps if the registered users and their maps are desired to be available on the PROD
  4. Migrate Portal configuration (C:\Program Files\Common Files\Hexagon\Services\Instances\<Portal>\App_Data\Configuration)
    • This one points to proper starting workspace assigned to the Portal
  5. Make sure that the related registry keys are the same (HKLM\SOFTWARE\Wow6432Node\Intergraph\Geospatial Server\Instances) between TEST and PROD.
  6. Migrate (copy) AdminPortal maps from C:\ProgramData\Hexagon\Geospatial Server\Admin Portal\Maps
  7. Migrate (copy) AdminPortal maps from C:\Program Files\Common Files\Hexagon\Services\AdminInstances\AdminPortal\App_Data\Maps
  8. If other files were modified, copy (or merge) those as well:
    • or search for "Geospatial Portal Components Location in the System"



Consumer Portal

  1. Create copies of Consumer Portal instances through AdminConsole on the PROD to automate IIS applications and AppPools creation.
  2. (if not done previously) Migrate (copy) AdminPortal maps from C:\ProgramData\Hexagon\Geospatial Server\Admin Portal\Maps
  3. Migrate (copy) map files:
    • C:\Program Files\Common Files\Hexagon\Services\Instances\<Consumer_Portal>\data
  4. Migrate (copy) customization files
    • C:\Program Files\Common Files\Hexagon\Services\Instances\<Consumer_Portal>\resources
  5. Web.config file isn't usually touched, only make sure it's identical between TEST and PROD

Search Configuration

  1. Copy from TEST to PROD content of the folders:
    • C:\ProgramData\Hexagon\Geospatial Server\Backend (Oracle searches)
    • C:\ProgramData\Search (WMPS searches)