Spotfire Server: How to configure proxy settings for Maps in Spotfire Web Player

How to configure proxy settings for Maps in Spotfire Web Player.
 

Configuration to allow Internet access through the corporate proxy server for Spotfire Web Player service requires proxy settings to be present in the Web Player configuration.

If you are accessing the geoanalytics.tibco.com URL for maps and getting the below error, then follow the resolution section:

------------------------------------------
"Error when downloading map chart service list from http://geoanalytics.tibco.com/service/services-list.json" 
-------------------------------------------
 
Cause: There is no proxy section present in the Web Player section by default, so it must be added manually. Follow the steps listed below to configure the proxy settings for Maps in Spotfire versions 7.5 and above.

Step 1: Export the default Spotfire Web Player configuration settings into a file for editing: Open a Command prompt as an Administrator, change directory to <Spotfire Server Installation directory>\tomcat\spotfire-bin\ folder, and Run config.bat command with the arguments shown below:
 

cd C:\spotfire\spotfireserver\14.6.0\tomcat\spotfire-bin config.bat export-service-config --tool-password=<your Config Tool password> --capability=WEB_PLAYER --deployment-area=<your Deployment Area name> --force

This will export the default configuration files.

Step 2: Insert proxy settings into exported "Spotfire.Dxp.Worker.Host.exe.config" file: Browse to C:\spotfire\spotfireserver\14.6.0\tomcat\spotfire-bin\config\root\ and open "Spotfire.Dxp.Worker.Host.exe.config". Insert the following and save the file:

<configuration>
  ...
  <applicationSettings>
    <Spotfire.Dxp.Web.Properties.Settings>
      ...
      <setting name="ProxyUsername" serializeAs="String">
        <value>myProxyUserName</value>
      </setting>
      <setting name="ProxyPassword" serializeAs="String">
          <value>myProxyPassword</value>
      </setting>
    </Spotfire.Dxp.Web.Properties.Settings>
  </applicationSettings>
  ...
  <system.net>
    <defaultProxy>
      <proxy usesystemdefault="true" proxyaddress="myProxyAddress" scriptLocation="myPacScriptaddress" bypassonlocal="true" />
    </defaultProxy>
  </system.net>
</configuration>

Step 3: Import the edited "Spotfire.Dxp.Worker.Host.exe.config" file back into the Spotfire Server: Run this in the Command prompt as an Administrator:

config.bat import-service-config --tool-password=myConfigToolPassword --config-name=myConfigName

Step 4: Change the Web Player service configuration from Default to your newly created configuration. 

NOTE: Refer to the below knowledge base articles to get further information on the proxy setting: 

https://support.tibco.com/s/article/Using-Proxy-to-connect-outside-of-Spotfire-Environment-with-Web-Player-or-Automation-Services

https://docs.microsoft.com/en-us/dotnet/framework/configure-apps/file-schema/network/defaultproxy-element-network-settings

https://support.tibco.com/s/article/Using-Proxy-to-connect-outside-of-Spotfire-Environment-with-Web-Player-or-Automation-Services