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

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

book

Article ID: KB0076530

calendar_today

Updated On:

Products Versions
Spotfire Web Player Version: 7.5 and above

Description

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.

Issue/Introduction

How to configure proxy settings for Maps in Spotfire versions 7.5 and above.

Environment

All Supported Operating Systems

Resolution

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

Additional Information

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