Bootstrap.xml file

The bootstrap configuration file contains the basic information that Spotfire Server requires to bootstrap itself so that it can connect to the Spotfire database and retrieve its configuration.

The bootstrap configuration file is created by running the bootstrap command (or using the configuration tool) . The file must be created in the <installation dir>\tomcat\webapps\spotfire\WEB-INF directory (Windows) or the <installation dir>/tomcat/webapps/spotfire/WEB-INF directory (Unix). When specifying an alternative bootstrap configuration file path to the bootstrap command, the generated file must be manually copied to this directory before it can be accessed by the server. The file must also be named bootstrap.xml.

This is the format of the bootstrap configuration file:
<bootstrap>
  <server-name>...</server-name>
  <server>
    <driver-class>...</driver-class>
    <database-url>...</database-url>
    <username>...</username>
    <password>...</password>
  </server>
  <config-tool>
    <driver-class>...</driver-class>
    <database-url>...</database-url>
    <username>...</username>
    <password>...</password>
  </config-tool>
  <server-name>...</server-name>
  <encryption-password>...</encryption-password>
</bootstrap>
  • The <config-tool> section

    This section is optional and not required for running the server itself. It is only required for using the configuration commands to access the database. If the commands are not to be used on a specific server, they can easily be disabled by removing this section.

    The database password stored in this section is protected by a special configuration tool password that is specified when creating the bootstrap.xml file. This tool password must be specified whenever running a command that accesses the database.
    Note: The tool password is not related to any administrator user account within the server application itself.
  • The <server-name> section

    This section contains the server name, which is used for identifying the server, for example when specifying server-specific configuration.

  • The <encryption-password> section
    This section is optional. If specified, it contains a password to be used for encrypting other passwords that are stored in the database. If not set, a static password is used.
    Note: The same password must be configured for all servers in a cluster.
Related reference