Klemen's Blog

kl82slo.github.io

MicroStrategy - ESRI key

20 May 2021

Dificulty ★☆☆☆☆

PREREQUISITES

Before configuring cloud-based ESRI maps, obtain a free ESRI Map Key by MicroStrategy Download site
Generate_key
or by contacting MicroStrategy tehnical support (Dont forget to provide DSI)

in case of Mapbox go to https://www.mapbox.com/

MicroStrategy Version 10.6+

First go to
tomcat - tomcat/webapps/Microstrategy/plugins
or if you use IIS - C:/Program Files (x86)/MicroStrategy/Web ASPx/plugins

in it create path /ConnectorForMap/WEB-INF/xml/config
then create file mapConfig.xml
and copy the folowing. Then change the key to the one you got in PREREQUISITES stage 

<mc> 
  <ec>
    <apps>
        <key> <![CDATA[XXXXXXXXXXXXXXXXXXXXXXXXXX]]> </key>
    </apps>
  </ec>
</mc>

if you also have Mapbox or Google map key insert them like

<mc>
	<!-- ESRI map configuration -->
	<ec>
		<apps>
			<key><![CDATA[XXXXXXXXXXXXXXXXXXXXXXXXXX]]> </key>
		</apps>
	</ec>

	<!-- Google map configuration -->
  
  <gc>
    <mk isPremier=false>Google Maps API key</mk>
  </gc>

	<!-- MapBox configuration -->
	<mbc>
		<tk><![CDATA[XXXXXXXXXXXXXXXXXXXXXXXXXX]]> </key></tk>
	</mbc>
</mc>

After you have created your file make a copy into tomcat/webapps/MicroStrategyLibrary/plugins/

and restart tomcat (and IIS if you use it for web)

Aditonal read

Setup for integration with Google Maps
ESRI maps for MicroStrategy Web and MicroStrategy Library products

Errors

If you get error
‘error. com.microstrategy.utils.cache.CacheException: Connection timed out: connect’
ESRIConnectionError

or
‘com.microstrategy.utils.cache.CacheException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target.’
ESRIConnectionError1

Then most likly you are using Proxy Server and need to enter detailes in
http://localhost:8080/MicroStrategy/servlet/mstrWebAdmin
EsriProxy For more detailes read KB202342

if you are still experiencing problems make sure that there are no traffic restrictions for the following addresses:

http://www.arcgis.com/home/webmap/viewer.html?url=http://services.arcgis.com/P3ePLMYs2RVChkJx/ArcGIS/rest/services/World_Administrative_Divisions/FeatureServer/0&source=sd

http://services.arcgis.com

http://services.arcgisonline.com/arcgis/rest/services

And make sure that the following ports are open and the following addresses not blocked by a proxy/firewall: