Spotfire Server and Environment - Quick Start

Changing the default location of the Web Player or Automation Services temporary files

By default the Web Player service and Automation Services store temporary files, paging, and caching data (scheduled updates caching and Spotfire Binary Data File (SBDF) caching) in the Temp directory inside the service installation directory. If you need to change the location for either or both services, or if Spotfire Support suggests that you change it, follow this procedure.

Procedure

  1. On the computer running Spotfire Server, open a command line as an administrator and change the directory to the path of the config.bat file (config.sh on Linux).
    The default file path is <server installation dir>/tomcat/spotfire-bin.
  2. Export the service configuration by using the export-service-config command, specifying which capability for which you want to change the location.
    Example for Web Player service:
    config export-service-config --tool-password=mypassword --capability=WEB_PLAYER --deployment-area=Production
    Example for Automation Services:
    config export-service-config --tool-password=mypassword --capability=AUTOMATION_SERVICES --deployment-area=Production
  3. Open the Spotfire.Dxp.Worker.Host.exe.config file (Spotfire.Dxp.Worker.Host.dll.config file for services installations on Linux) in a text editor or XML editor and locate the following section. By default, the exported configuration files are saved to the <server installation dir>/tomcat/spotfire-bin/config/root directory.
    <Spotfire.Dxp.Internal.Properties.Settings>
          <setting name="TempFolder" serializeAs="String">
            <value>Temp</value>
          </setting>
  4. Replace the value Temp with the path to the new Temp directory.
    Important: The Temp directory should be located on a local disk.
    Example:
    <Spotfire.Dxp.Internal.Properties.Settings>
          <setting name="TempFolder" serializeAs="String">
            <value>C:\NewTemp</value>
          </setting>
  5. Save and close the configuration file.
  6. Return to the command line and import the custom configuration using the import-service-config command.
    Example:
    config import-service-config --tool-password=mypassword --config-name=SampleConfig
  7. Apply the custom configuration to specific services by using the set-service-config command.
    Example:
    config set-service-config --tool-password=mypassword --service-id="VALUE" --config-name=SampleConfig
    Tip: Use the list-services command to get the service ID.

Results

The configuration setting for the indicated service is displayed in Nodes & Services, and the temporary files should be written as specified.