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

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

Configuration to allow Internet access through the corporate proxy server for Spotfire Server 7.5 and above 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 TIBCO 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 >> bin folder, and Run config.bat command with the arguments shown below. (This example uses directories for Spotfire 7.6.)

1) cd C:\tibco\tss\7.6.0\tomcat\bin
2) config.bat export-service-config --tool-password=myConfigToolPassword --capability=WEB_PLAYER --deployment-area=myDeploymentAreaName --force
This will export out the default config files.

Step 2: Insert the proxy settings into the exported "Spotfire.Dxp.Worker.Host.exe.config" file.
Browse to C:\tibco\tss\7.6.0\tomcat\bin\config\root and open the "Spotfire.Dxp.Worker.Host.exe.config" file. 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 article 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